git.basschouten.com Git - openhab-addons.git/blob

   1 /**
   2  * Copyright (c) 2010-2022 Contributors to the openHAB project
   3  *
   4  * See the NOTICE file(s) distributed with this work for additional
   5  * information.
   6  *
   7  * This program and the accompanying materials are made available under the
   8  * terms of the Eclipse Public License 2.0 which is available at
   9  * http://www.eclipse.org/legal/epl-2.0
  10  *
  11  * SPDX-License-Identifier: EPL-2.0
  12  */
  13 package org.openhab.automation.jsscripting.internal;
  14
  15 import java.util.List;
  16 import java.util.Map;
  17
  18 import javax.script.ScriptEngine;
  19
  20 import org.eclipse.jdt.annotation.NonNullByDefault;
  21 import org.eclipse.jdt.annotation.Nullable;
  22 import org.openhab.automation.jsscripting.internal.fs.watch.JSDependencyTracker;
  23 import org.openhab.core.automation.module.script.ScriptDependencyTracker;
  24 import org.openhab.core.automation.module.script.ScriptEngineFactory;
  25 import org.openhab.core.config.core.ConfigurableService;
  26 import org.osgi.framework.Constants;
  27 import org.osgi.service.component.annotations.Activate;
  28 import org.osgi.service.component.annotations.Component;
  29 import org.osgi.service.component.annotations.Modified;
  30 import org.osgi.service.component.annotations.Reference;
  31
  32 /**
  33  * An implementation of {@link ScriptEngineFactory} with customizations for GraalJS ScriptEngines.
  34  *
  35  * @author Jonathan Gilbert - Initial contribution
  36  * @author Dan Cunningham - Script injections
  37  */
  38 @Component(service = ScriptEngineFactory.class, configurationPid = "org.openhab.jsscripting", property = Constants.SERVICE_PID
  39         + "=org.openhab.jsscripting")
  40 @ConfigurableService(category = "automation", label = "JS Scripting", description_uri = "automation:jsscripting")
  41 @NonNullByDefault
  42 public final class GraalJSScriptEngineFactory implements ScriptEngineFactory {
  43     private static final String CFG_INJECTION_ENABLED = "injectionEnabled";
  44     private static final String INJECTION_CODE = "Object.assign(this, require('openhab'));";
  45     private boolean injectionEnabled = true;
  46
  47     /*
  48      * Whilst we run in parallel with Nashorn, we use a custom mime-type to avoid
  49      * disrupting Nashorn scripts. When Nashorn is removed, we take over the standard
  50      * JS runtime.
  51      */
  52
  53     // GraalJSEngineFactory graalJSEngineFactory = new GraalJSEngineFactory();
  54     //
  55     // scriptTypes.addAll(graalJSEngineFactory.getMimeTypes());
  56     // scriptTypes.addAll(graalJSEngineFactory.getExtensions());
  57
  58     public static final String MIME_TYPE = "application/javascript;version=ECMAScript-2021";
  59     private static final String ALT_MIME_TYPE = "text/javascript;version=ECMAScript-2021";
  60     private static final String ALIAS = "graaljs";
  61     private static final List<String> SCRIPT_TYPES = List.of(MIME_TYPE, ALT_MIME_TYPE, ALIAS);
  62
  63     private final JSScriptServiceUtil jsScriptServiceUtil;
  64     private final JSDependencyTracker jsDependencyTracker;
  65
  66     @Activate
  67     public GraalJSScriptEngineFactory(final @Reference JSScriptServiceUtil jsScriptServiceUtil,
  68             final @Reference JSDependencyTracker jsDependencyTracker, Map<String, Object> config) {
  69         this.jsDependencyTracker = jsDependencyTracker;
  70         this.jsScriptServiceUtil = jsScriptServiceUtil;
  71         modified(config);
  72     }
  73
  74     @Override
  75     public List<String> getScriptTypes() {
  76         return SCRIPT_TYPES;
  77     }
  78
  79     @Override
  80     public void scopeValues(ScriptEngine scriptEngine, Map<String, Object> scopeValues) {
  81         // noop; they are retrieved via modules, not injected
  82     }
  83
  84     @Override
  85     public @Nullable ScriptEngine createScriptEngine(String scriptType) {
  86         if (!SCRIPT_TYPES.contains(scriptType)) {
  87             return null;
  88         }
  89         return new DebuggingGraalScriptEngine<>(
  90                 new OpenhabGraalJSScriptEngine(injectionEnabled ? INJECTION_CODE : null, jsScriptServiceUtil));
  91     }
  92
  93     @Override
  94     public @Nullable ScriptDependencyTracker getDependencyTracker() {
  95         return jsDependencyTracker;
  96     }
  97
  98     @Modified
  99     protected void modified(Map<String, ?> config) {
 100         Object injectionEnabled = config.get(CFG_INJECTION_ENABLED);
 101         this.injectionEnabled = injectionEnabled == null || (Boolean) injectionEnabled;
 102     }
 103 }