org.sonarsource.sonarlint.ls.SkippedPluginsNotifier Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of sonarlint-language-server Show documentation
SonarLint Language Server
There is a newer version: 3.12.0.75621
Show newest version
/*
 * SonarLint Language Server
 * Copyright (C) 2009-2024 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.sonarsource.sonarlint.ls;

import java.util.HashSet;
import java.util.List;
import java.util.Objects;
import java.util.Set;
import javax.annotation.Nullable;
import org.eclipse.lsp4j.MessageActionItem;
import org.eclipse.lsp4j.MessageType;
import org.eclipse.lsp4j.ShowMessageRequestParams;
import org.sonarsource.sonarlint.core.plugin.commons.api.SkipReason;
import org.sonarsource.sonarlint.core.rpc.protocol.client.plugin.DidSkipLoadingPluginParams;
import org.sonarsource.sonarlint.core.rpc.protocol.common.Language;
import org.sonarsource.sonarlint.ls.domain.LSLanguage;
import org.sonarsource.sonarlint.ls.log.LanguageClientLogger;

import static org.sonarsource.sonarlint.core.plugin.commons.api.SkipReason.UnsatisfiedRuntimeRequirement.RuntimeRequirement.JRE;
import static org.sonarsource.sonarlint.core.plugin.commons.api.SkipReason.UnsatisfiedRuntimeRequirement.RuntimeRequirement.NODEJS;

public class SkippedPluginsNotifier {

  private final Set displayedMessages = new HashSet<>();

  public static final MessageActionItem ACTION_OPEN_SETTINGS = new MessageActionItem("Open Settings");
  public static final MessageActionItem ACTION_DONT_SHOW_AGAIN = new MessageActionItem("Don't Show Again");

  private final SonarLintExtendedLanguageClient client;
  private final LanguageClientLogger globalLogOutput;

  public SkippedPluginsNotifier(SonarLintExtendedLanguageClient client, LanguageClientLogger globalLogOutput) {
    this.client = client;
    this.globalLogOutput = globalLogOutput;
  }

  public void notifyOnceForSkippedPlugins(Language language, DidSkipLoadingPluginParams.SkipReason reason, String minVersion, @Nullable String currentVersion) {
    final var title = String.format("SonarQube for VS Code failed to analyze %s code", LSLanguage.valueOf(language.name()).getLabel());
    if (reason == DidSkipLoadingPluginParams.SkipReason.UNSATISFIED_JRE) {
      handleMissingJRERequirement(minVersion, Objects.requireNonNull(currentVersion), title);
    } else if (reason == DidSkipLoadingPluginParams.SkipReason.UNSATISFIED_NODE_JS) {
      handleMissingNodeRuntimeRequirement(minVersion, currentVersion, title);
    }
  }

  private void handleMissingJRERequirement(String minVersion, String currentVersion, String title) {
    var content = String.format(
      "Java runtime version %s or later is required. Current version is %s.", minVersion, currentVersion);
    globalLogOutput.warn(content);
    showMessageWithOpenSettingsAction(client, formatMessage(title, content), JRE,
      client::openJavaHomeSettings);
  }

  private void handleMissingNodeRuntimeRequirement(String minVersion, @Nullable String currentVersion, String title) {
    var content = String.format(
      "Node.js runtime version %s or later is required.", minVersion);
    if (currentVersion != null) {
      content += String.format(" Current version is %s.", currentVersion);
    }
    var isNotificationAllowed = client.canShowMissingRequirementsNotification().join();
    globalLogOutput.warn(content);
    if (Boolean.TRUE.equals(isNotificationAllowed)) {
      showMessageWithOpenSettingsAction(client, formatMessage(title, content), NODEJS,
        client::openPathToNodeSettings);
    }
  }

  private void showMessageWithOpenSettingsAction(SonarLintExtendedLanguageClient client, String message,
    SkipReason.UnsatisfiedRuntimeRequirement.RuntimeRequirement requirementType, Runnable callback) {
    if (displayedMessages.add(message)) {
      var params = requirementType == NODEJS ?
        new ShowMessageRequestParams(List.of(ACTION_OPEN_SETTINGS, ACTION_DONT_SHOW_AGAIN))
        : new ShowMessageRequestParams(List.of(ACTION_OPEN_SETTINGS));
      params.setType(MessageType.Error);
      params.setMessage(message);
      client.showMessageRequest(params).thenAccept(action -> {
        if (ACTION_OPEN_SETTINGS.equals(action)) {
          callback.run();
        } else if (ACTION_DONT_SHOW_AGAIN.equals(action)) {
          client.doNotShowMissingRequirementsMessageAgain();
        }
      });
    }
  }

  /*
   * The LSP specification does not mention anything about how the message part of "showMessage(Request)" will be rendered.
   * The current VSCode implementation uses it to set a DOM node's textContent attribute, which retains only... text content,
   * as specified by the HTML recommendation.
   *
   * See:
   * - https://github.com/microsoft/vscode/blob/7ce60506a9b5df9ef05ac51f8c94e1085a464d17/src/vs/editor/contrib/message/messageController.ts#
   * L155
   * - https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent
   */
  private static String formatMessage(String title, String content) {
    return String.format("%s: %s", title, content);
  }

}