/* * Copyright 2013 Red Hat, Inc. and/or its affiliates. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.jbpm.process.core.impl; import java.util.List; import java.util.Map; import java.util.concurrent.ConcurrentHashMap; import javax.script.ScriptEngineFactory; import javax.script.ScriptEngineManager; import org.jbpm.process.core.transformation.JavaScriptingDataTransformer; import org.jbpm.process.core.transformation.MVELDataTransformer; import org.kie.api.runtime.process.DataTransformer; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Registry for all available on runtime <code>DataTransformer</code>s for performing * data input and output transformation. Be default it discovers and registers all * available JSR 223 compliant scripting languages wrapped with * <code>JavaScriptingDataTransformer</code>.<br/> * Discovery is based on <code>ScriptEngineManager.getEngineFactories()</code> thus * any scripting engines should follow instructions for Java Scripting.<br/> * Each Java Scripting engine will get dedicated instance of <code>JavaScriptingDataTransformer</code> * which will be registered under one or more key in the registry. The key will be built as follows> * <ul> * <li>constant prefix for URI like syntax : http://www.java.com/</li> * <li>names provided by given ScriptEngineFactory - JavaScript, js,....</li> * </ul> * For example default JavaScript scripting engine will be registered under following keys: * <ul> * <li>http://www.java.com/js</li> * <li>http://www.java.com/rhino</li> * <li>http://www.java.com/JavaScript</li> * <li>http://www.java.com/javascript</li> * <li>http://www.java.com/ECMAScript</li> * <li>http://www.java.com/ecmascript</li> * </ul> * when defining the language for transformation that of data input/output the complete key should be provided. * <code> * <dataInputAssociation><br/> *   <sourceRef>s</sourceRef><br/> *   <targetRef>_2_param</targetRef><br/> *   <transformation language="http://www.java.com/javascript">s.toUpperCase()</transformation><br/> * </dataInputAssociation><br/> * </code> * <br/> * Besides JSR 223 scripting engine, there is MVEL based transformer available out of the box that is registered under * <code>http://www.mvel.org/2.0</code> key. * <br/> * Custom implementations can be provided and if they are compliant with JSR 223 then follows above registration approach * otherwise they need to be registered manually with <code>register</code> method. * @see JavaScriptingDataTransformer */ public class DataTransformerRegistry { private static final Logger logger = LoggerFactory.getLogger(DataTransformerRegistry.class); private static final DataTransformerRegistry INSTANCE = new DataTransformerRegistry(); private Map<String, DataTransformer> registry; protected DataTransformerRegistry() { this.registry = new ConcurrentHashMap<String, DataTransformer>(); this.registry.put("http://www.mvel.org/2.0", new MVELDataTransformer()); ScriptEngineManager manager = new ScriptEngineManager(); List<ScriptEngineFactory> factories = manager.getEngineFactories(); for (ScriptEngineFactory factory : factories) { DataTransformer transformer = new JavaScriptingDataTransformer(factory); for (String name : factory.getNames()) { String key = "http://www.java.com/"+name; registry.put(key, transformer); logger.debug("Registered scripting language {} with instance {}", key, transformer); } } } public static DataTransformerRegistry get() { return INSTANCE; } public synchronized void register(String language, DataTransformer transformer) { this.registry.put(language, transformer); logger.debug("Manual registration of scripting language {} with instance {}", language, transformer); } public DataTransformer find(String languge) { return this.registry.get(languge); } }