123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154 |
- /*
- * SonarQube
- * Copyright (C) 2009-2023 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.ws;
-
- import com.google.common.io.Resources;
- import java.util.LinkedList;
- import java.util.List;
- import java.util.Map;
- import java.util.Objects;
- import java.util.SortedSet;
- import java.util.function.Function;
- import java.util.stream.Collectors;
- import javax.annotation.Nullable;
- import org.sonar.api.server.ws.Change;
- import org.sonar.api.server.ws.Request;
- import org.sonar.api.server.ws.Response;
- import org.sonar.api.server.ws.WebService;
- import org.sonar.core.platform.PluginInfo;
- import org.sonar.core.plugin.PluginType;
- import org.sonar.db.DbClient;
- import org.sonar.db.DbSession;
- import org.sonar.db.permission.GlobalPermission;
- import org.sonar.db.plugin.PluginDto;
- import org.sonar.db.plugin.PluginDto.Type;
- import org.sonar.server.plugins.ServerPlugin;
- import org.sonar.server.plugins.ServerPluginRepository;
- import org.sonar.server.plugins.UpdateCenterMatrixFactory;
- import org.sonar.server.user.UserSession;
- import org.sonar.updatecenter.common.Plugin;
- import org.sonarqube.ws.Plugins.InstalledPluginsWsResponse;
- import org.sonarqube.ws.Plugins.PluginDetails;
-
- import static com.google.common.collect.ImmutableSortedSet.copyOf;
- import static java.lang.String.format;
- import static java.util.Collections.emptyMap;
- import static java.util.Collections.singleton;
- import static java.util.stream.Collectors.toMap;
- import static org.sonar.server.plugins.ws.PluginWSCommons.NAME_KEY_COMPARATOR;
- import static org.sonar.server.plugins.ws.PluginWSCommons.buildPluginDetails;
- import static org.sonar.server.plugins.ws.PluginWSCommons.compatiblePluginsByKey;
- import static org.sonar.server.user.AbstractUserSession.insufficientPrivilegesException;
- import static org.sonar.server.ws.WsUtils.writeProtobuf;
-
- /**
- * Implementation of the {@code installed} action for the Plugins WebService.
- */
- public class InstalledAction implements PluginsWsAction {
- private static final String FIELD_CATEGORY = "category";
- private static final String PARAM_TYPE = "type";
-
- private final UserSession userSession;
- private final ServerPluginRepository serverPluginRepository;
- private final UpdateCenterMatrixFactory updateCenterMatrixFactory;
- private final DbClient dbClient;
-
- public InstalledAction(ServerPluginRepository serverPluginRepository, UserSession userSession, UpdateCenterMatrixFactory updateCenterMatrixFactory, DbClient dbClient) {
- this.userSession = userSession;
- this.serverPluginRepository = serverPluginRepository;
- this.updateCenterMatrixFactory = updateCenterMatrixFactory;
- this.dbClient = dbClient;
- }
-
- @Override
- public void define(WebService.NewController controller) {
- WebService.NewAction action = controller.createAction("installed")
- .setDescription("Get the list of all the plugins installed on the SonarQube instance, sorted by plugin name.<br/>" +
- "Requires authentication.")
- .setSince("5.2")
- .setChangelog(
- new Change("10.4", "The response field 'requiredForLanguages' is added for plugins that support it"),
- new Change("9.8", "The 'documentationPath' field is deprecated"),
- new Change("9.7", "Authentication check added"),
- new Change("8.0", "The 'documentationPath' field is added"),
- new Change("7.0", "The fields 'compressedHash' and 'compressedFilename' are added"),
- new Change("6.6", "The 'filename' field is added"),
- new Change("6.6", "The 'fileHash' field is added"),
- new Change("6.6", "The 'sonarLintSupported' field is added"),
- new Change("6.6", "The 'updatedAt' field is added"))
- .setHandler(this)
- .setResponseExample(Resources.getResource(this.getClass(), "example-installed_plugins.json"));
-
- action.createFieldsParam(singleton("category"))
- .setDescription(format("Comma-separated list of the additional fields to be returned in response. No additional field is returned by default. Possible values are:" +
- "<ul>" +
- "<li>%s - category as defined in the Update Center. A connection to the Update Center is needed</li>" +
- "</ul>", FIELD_CATEGORY))
- .setSince("5.6");
-
- action.createParam(PARAM_TYPE)
- .setInternal(true)
- .setSince("8.5")
- .setPossibleValues(Type.values())
- .setDescription("Allows to filter plugins by type");
- }
-
- @Override
- public void handle(Request request, Response response) throws Exception {
- if (!userSession.isLoggedIn() && !userSession.hasPermission(GlobalPermission.SCAN)) {
- throw insufficientPrivilegesException();
- }
-
- String typeParam = request.param(PARAM_TYPE);
- SortedSet<ServerPlugin> installedPlugins = loadInstalledPlugins(typeParam);
- Map<String, PluginDto> dtosByKey;
- try (DbSession dbSession = dbClient.openSession(false)) {
- dtosByKey = dbClient.pluginDao().selectAll(dbSession).stream().collect(toMap(PluginDto::getKee, Function.identity()));
- }
-
- List<String> additionalFields = request.paramAsStrings(WebService.Param.FIELDS);
- Map<String, Plugin> updateCenterPlugins = (additionalFields == null || additionalFields.isEmpty()) ? emptyMap() : compatiblePluginsByKey(updateCenterMatrixFactory);
-
- List<PluginDetails> pluginList = new LinkedList<>();
-
- for (ServerPlugin installedPlugin : installedPlugins) {
- PluginInfo pluginInfo = installedPlugin.getPluginInfo();
- PluginDto pluginDto = dtosByKey.get(pluginInfo.getKey());
- Objects.requireNonNull(pluginDto, () -> format("Plugin %s is installed but not in DB", pluginInfo.getKey()));
- Plugin updateCenterPlugin = updateCenterPlugins.get(pluginInfo.getKey());
-
- pluginList.add(buildPluginDetails(installedPlugin, pluginInfo, pluginDto, updateCenterPlugin));
- }
-
- InstalledPluginsWsResponse wsResponse = InstalledPluginsWsResponse.newBuilder()
- .addAllPlugins(pluginList)
- .build();
- writeProtobuf(wsResponse, request, response);
- }
-
- private SortedSet<ServerPlugin> loadInstalledPlugins(@Nullable String typeParam) {
- if (typeParam != null) {
- return copyOf(NAME_KEY_COMPARATOR, serverPluginRepository.getPlugins().stream()
- .filter(serverPlugin -> serverPlugin.getType().equals(PluginType.valueOf(typeParam)))
- .collect(Collectors.toSet()));
- }
- return copyOf(NAME_KEY_COMPARATOR, serverPluginRepository.getPlugins());
- }
- }
|