/* * Licensed to Elasticsearch under one or more contributor * license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright * ownership. Elasticsearch licenses this file to you 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.elasticsearch.script; import com.google.common.collect.ImmutableCollection; import com.google.common.collect.ImmutableMap; import com.google.common.collect.ImmutableSet; import com.google.common.collect.Maps; import java.util.Collection; import java.util.HashMap; import java.util.Map; /** * Registry for operations that use scripts as part of their execution. Can be standard operations of custom defined ones (via plugin). * Allows plugins to register custom operations that they use scripts for, via {@link ScriptModule#registerScriptContext(org.elasticsearch.script.ScriptContext.Plugin)}. * Scripts can be enabled/disabled via fine-grained settings for each single registered operation. */ public final class ScriptContextRegistry { static final ImmutableSet<String> RESERVED_SCRIPT_CONTEXTS = reservedScriptContexts(); private final ImmutableMap<String, ScriptContext> scriptContexts; public ScriptContextRegistry(Iterable<ScriptContext.Plugin> customScriptContexts) { Map<String, ScriptContext> scriptContexts = Maps.newHashMap(); for (ScriptContext.Standard scriptContext : ScriptContext.Standard.values()) { scriptContexts.put(scriptContext.getKey(), scriptContext); } for (ScriptContext.Plugin customScriptContext : customScriptContexts) { validateScriptContext(customScriptContext); ScriptContext previousContext = scriptContexts.put(customScriptContext.getKey(), customScriptContext); if (previousContext != null) { throw new IllegalArgumentException("script context [" + customScriptContext.getKey() + "] cannot be registered twice"); } } this.scriptContexts = ImmutableMap.copyOf(scriptContexts); } /** * @return a list that contains all the supported {@link ScriptContext}s, both standard ones and registered via plugins */ ImmutableCollection<ScriptContext> scriptContexts() { return scriptContexts.values(); } /** * @return <tt>true</tt> if the provided {@link ScriptContext} is supported, <tt>false</tt> otherwise */ boolean isSupportedContext(ScriptContext scriptContext) { return scriptContexts.containsKey(scriptContext.getKey()); } //script contexts can be used in fine-grained settings, we need to be careful with what we allow here private void validateScriptContext(ScriptContext.Plugin scriptContext) { if (RESERVED_SCRIPT_CONTEXTS.contains(scriptContext.getPluginName())) { throw new IllegalArgumentException("[" + scriptContext.getPluginName() + "] is a reserved name, it cannot be registered as a custom script context"); } if (RESERVED_SCRIPT_CONTEXTS.contains(scriptContext.getOperation())) { throw new IllegalArgumentException("[" + scriptContext.getOperation() + "] is a reserved name, it cannot be registered as a custom script context"); } } private static ImmutableSet<String> reservedScriptContexts() { ImmutableSet.Builder<String> builder = ImmutableSet.builder(); for (ScriptService.ScriptType scriptType : ScriptService.ScriptType.values()) { builder.add(scriptType.toString()); } for (ScriptContext.Standard scriptContext : ScriptContext.Standard.values()) { builder.add(scriptContext.getKey()); } builder.add("script").add("engine"); return builder.build(); } }