/* * SonarQube * Copyright (C) 2009-2017 SonarSource SA * mailto:info AT sonarsource DOT com * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 3 of the License, or (at your option) any later version. * * This program 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this program; if not, write to the Free Software Foundation, * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ package org.sonar.server.plugins; import com.google.common.collect.ArrayListMultimap; import com.google.common.collect.ListMultimap; import java.lang.annotation.Annotation; import java.util.Map; import org.sonar.api.ExtensionProvider; import org.sonar.api.Plugin; import org.sonar.api.SonarRuntime; import org.sonar.api.utils.AnnotationUtils; import org.sonar.core.platform.ComponentContainer; import org.sonar.core.platform.PluginInfo; import org.sonar.core.platform.PluginRepository; import static java.util.Objects.requireNonNull; /** * Loads the plugins server extensions and injects them to DI container */ public abstract class ServerExtensionInstaller { private final SonarRuntime sonarRuntime; private final PluginRepository pluginRepository; private final Class<? extends Annotation>[] supportedAnnotationTypes; protected ServerExtensionInstaller(SonarRuntime sonarRuntime, PluginRepository pluginRepository, Class<? extends Annotation>... supportedAnnotationTypes) { requireNonNull(supportedAnnotationTypes, "At least one supported annotation type must be specified"); this.sonarRuntime = sonarRuntime; this.pluginRepository = pluginRepository; this.supportedAnnotationTypes = supportedAnnotationTypes; } public void installExtensions(ComponentContainer container) { ListMultimap<PluginInfo, Object> installedExtensionsByPlugin = ArrayListMultimap.create(); for (PluginInfo pluginInfo : pluginRepository.getPluginInfos()) { try { String pluginKey = pluginInfo.getKey(); Plugin plugin = pluginRepository.getPluginInstance(pluginKey); container.addExtension(pluginInfo, plugin); Plugin.Context context = new Plugin.Context(sonarRuntime); plugin.define(context); for (Object extension : context.getExtensions()) { if (installExtension(container, pluginInfo, extension, true) != null) { installedExtensionsByPlugin.put(pluginInfo, extension); } else { container.declareExtension(pluginInfo, extension); } } } catch (Throwable e) { // catch Throwable because we want to catch Error too (IncompatibleClassChangeError, ...) throw new IllegalStateException(String.format("Fail to load plugin %s [%s]", pluginInfo.getName(), pluginInfo.getKey()), e); } } for (Map.Entry<PluginInfo, Object> entry : installedExtensionsByPlugin.entries()) { PluginInfo pluginInfo = entry.getKey(); try { Object extension = entry.getValue(); if (isExtensionProvider(extension)) { ExtensionProvider provider = (ExtensionProvider) container.getComponentByKey(extension); installProvider(container, pluginInfo, provider); } } catch (Throwable e) { // catch Throwable because we want to catch Error too (IncompatibleClassChangeError, ...) throw new IllegalStateException(String.format("Fail to load plugin %s [%s]", pluginInfo.getName(), pluginInfo.getKey()), e); } } } private void installProvider(ComponentContainer container, PluginInfo pluginInfo, ExtensionProvider provider) { Object obj = provider.provide(); if (obj != null) { if (obj instanceof Iterable) { for (Object ext : (Iterable) obj) { installExtension(container, pluginInfo, ext, false); } } else { installExtension(container, pluginInfo, obj, false); } } } Object installExtension(ComponentContainer container, PluginInfo pluginInfo, Object extension, boolean acceptProvider) { for (Class<? extends Annotation> supportedAnnotationType : supportedAnnotationTypes) { if (AnnotationUtils.getAnnotation(extension, supportedAnnotationType) != null) { if (!acceptProvider && isExtensionProvider(extension)) { throw new IllegalStateException("ExtensionProvider can not include providers itself: " + extension); } container.addExtension(pluginInfo, extension); return extension; } } return null; } static boolean isExtensionProvider(Object extension) { return isType(extension, ExtensionProvider.class) || extension instanceof ExtensionProvider; } static boolean isType(Object extension, Class extensionClass) { Class clazz = extension instanceof Class ? (Class) extension : extension.getClass(); return extensionClass.isAssignableFrom(clazz); } }