Documentation for JSR223 cache preset

[J-N-K]

Related to openhab/openhab-core#2887

Signed-off-by: Jan N. Klug github@klug.nrw

[netlify]

✅ Thanks for your pull request to the openHAB documentation! The result can be previewed at the URL below (this comment and the preview will be updated if you add more commits).

Name	Link
🔨 Latest commit	a304004
🔍 Latest deploy log	https://app.netlify.com/sites/openhab-docs-preview/deploys/638b147fe9385400080b45e2
😎 Deploy Preview	https://deploy-preview-1937--openhab-docs-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site settings.

[rkoshak]

Does it make sense to include a Nashorn example? I think it'll be the same as Groovy/Jython.

scriptExtension.importPreset("cache")

I can see both ways since we really should encourage users to avoid Nashorn, but it's there now and we have the add-on on the marketplace to continue support when we move to Java 17.

@jimtng, jRuby's import should be similar too, right? I personally would really like to see jRuby represented also.

[J-N-K]

I can add it if someone confirms it's working. I don't have a JDK 11 installed, so can't test Nashorn.

[rkoshak]

I can add it if someone confirms it's working. I don't have a JDK 11 installed, so can't test Nashorn.

Actually, I wonder if it's a better test if it's tested with the Nashorn add-on on the marketplace.

I need to update my OH before I can test it and I'm just about out of time for the day. If I don't see anything I can try the test tomorrow.

[Confectrician]

Just one small remark.

From the discussion it would be best to wait until you have clarified the example?

[J-N-K]

The Nashorn example is already there. We can wait for the ruby example.

[wborn]

We can wait for the ruby example.

Maybe @ccutrer can provide it after finishing ccutrer/openhab-jrubyscripting#83

[ccutrer]

Yeah, don't wait in Ruby to get this merged. I'll make sure we get a Ruby example in in another PR.

[florian-h05]

Do we also want to provide a JS Scripting (GraalJS) example?

If yes, in which way? As this is one the JSR223 page, it would make sense to document the raw access without using the helper libray. If we want to document it using the helper library, this addition is something for a follow up PR, as I currently don't have the new cache implemented in the library.

[J-N-K]

@florian-h05 I don‘t think that is necessary since the helper libraries are always installed, correct?

[florian-h05]

The helper libraries are always installed.

I'm not sure what you refer to with

I don‘t think that is necessary

[J-N-K]

An example without the helper libraries. There is already an example for JS Scripting. I can add „GraalJS“ to the tab-title if you want.

[florian-h05]

There is already an example for JS Scripting.

I've just checked it, looks fine 👍

I can add „GraalJS“ to the tab-title if you want.

Not needed.

[Confectrician]

Nothing left from my side and alle examplers are available.

Anything left to wait for from your side?
If not please give a short ping and i will merge.

[J-N-K]

IMO you can merge.