/*
* Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package jdk.tools.jlink.internal;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import java.util.ServiceLoader;
import jdk.tools.jlink.plugin.Plugin;
import jdk.tools.jlink.plugin.PluginException;
Plugin Providers repository. Plugin Providers are
retrieved thanks to the ServiceLoader mechanism.
/**
*
* Plugin Providers repository. Plugin Providers are
* retrieved thanks to the ServiceLoader mechanism.
*/
public final class PluginRepository {
private PluginRepository() {
}
private static final Map<String, Plugin> registeredPlugins = new HashMap<>();
Retrieves the plugin associated to the passed name. If multiple providers
exist for the same name,
then an exception is thrown.
Params: - name – The plugin provider name.
- pluginsLayer –
Returns: A provider or null if not found.
/**
* Retrieves the plugin associated to the passed name. If multiple providers
* exist for the same name,
* then an exception is thrown.
* @param name The plugin provider name.
* @param pluginsLayer
* @return A provider or null if not found.
*/
public static Plugin getPlugin(String name,
ModuleLayer pluginsLayer) {
return getPlugin(Plugin.class, name, pluginsLayer);
}
Build plugin for the passed name.
Params: - config – Optional config.
- name – Non null name.
- pluginsLayer –
Returns: A plugin or null if no plugin found.
/**
* Build plugin for the passed name.
*
* @param config Optional config.
* @param name Non null name.
* @param pluginsLayer
* @return A plugin or null if no plugin found.
*/
public static Plugin newPlugin(Map<String, String> config, String name,
ModuleLayer pluginsLayer) {
Objects.requireNonNull(name);
Objects.requireNonNull(pluginsLayer);
Plugin plugin = getPlugin(name, pluginsLayer);
if (plugin != null) {
try {
plugin.configure(config);
} catch (IllegalArgumentException e) {
if (JlinkTask.DEBUG) {
System.err.println("Plugin " + plugin.getName() + " threw exception with config: " + config);
e.printStackTrace();
}
throw e;
}
}
return plugin;
}
Explicit registration of a plugin in the repository. Used by unit tests
Params: - plugin – The plugin to register.
/**
* Explicit registration of a plugin in the repository. Used by unit tests
* @param plugin The plugin to register.
*/
public synchronized static void registerPlugin(Plugin plugin) {
Objects.requireNonNull(plugin);
registeredPlugins.put(plugin.getName(), plugin);
}
Explicit unregistration of a plugin in the repository. Used by unit
tests
Params: - name – Plugin name
/**
* Explicit unregistration of a plugin in the repository. Used by unit
* tests
*
* @param name Plugin name
*/
public synchronized static void unregisterPlugin(String name) {
Objects.requireNonNull(name);
registeredPlugins.remove(name);
}
public static List<Plugin> getPlugins(ModuleLayer pluginsLayer) {
return getPlugins(Plugin.class, pluginsLayer);
}
private static <T extends Plugin> T getPlugin(Class<T> clazz, String name,
ModuleLayer pluginsLayer) {
Objects.requireNonNull(name);
Objects.requireNonNull(pluginsLayer);
@SuppressWarnings("unchecked")
T provider = null;
List<T> javaProviders = getPlugins(clazz, pluginsLayer);
for(T factory : javaProviders) {
if (factory.getName().equals(name)) {
if (provider != null) {
throw new PluginException("Multiple plugin "
+ "for the name " + name);
}
provider = factory;
}
}
return provider;
}
The plugins accessible in the current context.
Params: - pluginsLayer –
Returns: The list of plugins.
/**
* The plugins accessible in the current context.
*
* @param pluginsLayer
* @return The list of plugins.
*/
private static <T extends Plugin> List<T> getPlugins(Class<T> clazz, ModuleLayer pluginsLayer) {
Objects.requireNonNull(pluginsLayer);
List<T> factories = new ArrayList<>();
try {
Iterator<T> providers
= ServiceLoader.load(pluginsLayer, clazz).iterator();
while (providers.hasNext()) {
factories.add(providers.next());
}
registeredPlugins.values().stream().forEach((fact) -> {
if (clazz.isInstance(fact)) {
@SuppressWarnings("unchecked")
T trans = (T) fact;
factories.add(trans);
}
});
return factories;
} catch (Exception ex) {
throw new PluginException(ex);
}
}
}