[java] API cleanup: mark for removal and as internal deprecated API without external usages (IJPL-190638)

APIs, which were marked as deprecated in 251 or earlier and don't have external usages, are marked as internal. Also, if there are no internal usages, it's also marked for removal. GitOrigin-RevId: ffd772fc41738cdf3bcf5a122756936383184866
2026-09-27 10:03:11 +07:00 · 2025-10-03 23:44:30 +00:00
parent 2d1c5f3960
commit 093d3214f4
14 changed files with 34 additions and 11 deletions
@@ -5,6 +5,7 @@ import com.intellij.openapi.fileTypes.FileType;
 import com.intellij.openapi.vfs.VirtualFile;
 import com.intellij.psi.search.GlobalSearchScope;
 import com.intellij.util.indexing.StorageException;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 import org.jetbrains.jps.backwardRefs.CompilerRef;
@@ -29,7 +30,8 @@ public abstract class CompilerReferenceReader<Index extends CompilerReferenceInd
   * @deprecated Use {@link #CompilerReferenceReader(Path, CompilerReferenceIndex)}
   */
  @SuppressWarnings("IO_FILE_USAGE")
-  @Deprecated
+  @ApiStatus.Internal
+  @Deprecated(forRemoval = true)
  public CompilerReferenceReader(@NotNull File buildDir, Index index) {
    myIndex = index;
    this.buildDir = buildDir.toPath();
@@ -53,6 +53,7 @@ import com.sun.jdi.request.EventRequestManager;
 import com.sun.jdi.request.InvalidRequestStateException;
 import one.util.streamex.StreamEx;
 import org.jdom.Element;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NonNls;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
@@ -253,6 +254,7 @@ public class BreakpointManager {
  /**
   * @deprecated use {@link #addExceptionBreakpoint(String)}
   */
+  @ApiStatus.Internal
  @Deprecated(forRemoval = true)
  public @Nullable ExceptionBreakpoint addExceptionBreakpoint(final @NotNull String exceptionClassName, final String packageName) {
    return addExceptionBreakpoint(exceptionClassName);
@@ -25,7 +25,8 @@ private const val DEFAULT_TEMPLATE_WITH_ONBOARDING_TIPS_NAME_INSTANCE_MAIN = "Sa
 private const val DEFAULT_TEMPLATE_WITH_RENDERED_ONBOARDING_TIPS_NAME_INSTANCE_MAIN = "SampleCodeWithRenderedOnboardingTipsInstanceMain.java"

 object AssetsJava {
-
+  @ApiStatus.Internal
+  @ApiStatus.ScheduledForRemoval
  @Deprecated("The onboarding tips generated unconditionally")
  fun getJavaSampleTemplateName(generateOnboardingTips: Boolean): String =
    getJavaSampleTemplateName()
@@ -71,6 +72,8 @@ object AssetsJava {
  }
 }

+@ApiStatus.Internal
+@ApiStatus.ScheduledForRemoval
@Deprecated("The onboarding tips generated unconditionally")
 fun AssetsNewProjectWizardStep.withJavaSampleCodeAsset(sourceRootPath: String, packageName: String?, generateOnboardingTips: Boolean) {
  val templateName = AssetsJava.getJavaSampleTemplateName()
@@ -78,6 +81,8 @@ fun AssetsNewProjectWizardStep.withJavaSampleCodeAsset(sourceRootPath: String, p
  withJavaSampleCodeAsset(sourcePath, packageName, templateName)
 }

+@ApiStatus.Internal
+@ApiStatus.ScheduledForRemoval
@Deprecated("The onboarding tips generated unconditionally")
 fun AssetsNewProjectWizardStep.withJavaSampleCodeAsset(sourcePath: String, templateName: String, packageName: String?, generateOnboardingTips: Boolean): Unit =
  withJavaSampleCodeAsset(sourcePath, packageName, templateName)
@@ -138,6 +143,8 @@ private fun AssetsNewProjectWizardStep.withJavaSampleCodeAsset(
  addFilesToOpen(sourcePath)
 }

+@ApiStatus.Internal
+@ApiStatus.ScheduledForRemoval
@Deprecated("The onboarding tips are prepared in the withJavaSampleCodeAsset function")
 fun AssetsNewProjectWizardStep.prepareJavaSampleOnboardingTips(project: Project): Unit =
  AssetsJava.prepareJavaSampleOnboardingTips(project, DEFAULT_FILE_NAME)
@@ -28,6 +28,8 @@ object AssetsOnboardingTips {
    return Registry.`is`("doc.onboarding.tips.render")
  }

+  @ApiStatus.Internal
+  @ApiStatus.ScheduledForRemoval
  @Deprecated("The onboarding tips generated unconditionally")
  fun proposeToGenerateOnboardingTipsByDefault(): Boolean {
    return RecentProjectsManagerBase.getInstanceEx().getRecentPaths().isEmpty()
@@ -42,6 +44,8 @@ object AssetsOnboardingTips {
  }
 }

+@ApiStatus.Internal
+@ApiStatus.ScheduledForRemoval
@Deprecated("Use AssetsOnboardingTips#prepareOnboardingTips instead")
 fun AssetsNewProjectWizardStep.prepareOnboardingTips(project: Project, fileName: String, breakpointSelector: (CharSequence) -> Int?): Unit =
  AssetsOnboardingTips.prepareOnboardingTips(project, fileName, breakpointSelector)
@@ -3,8 +3,11 @@ package com.intellij.ide.projectWizard.generators

 import com.intellij.ide.wizard.NewProjectWizardStep
 import com.intellij.openapi.project.Project
+import org.jetbrains.annotations.ApiStatus
 import com.intellij.ide.projectWizard.generators.prepareOnboardingTips as prepareOnboardingTipsImpl

+@ApiStatus.Internal
+@ApiStatus.ScheduledForRemoval
@Deprecated("Use AssetsOnboardingTips util instead")
 abstract class AssetsOnboardingTipsProjectWizardStep(parent: NewProjectWizardStep) : AssetsNewProjectWizardStep(parent) {
  protected fun rawShortcut(shortcut: String) = AssetsOnboardingTips.rawShortcut(shortcut)
@@ -28,10 +28,7 @@ import com.intellij.psi.PsiFile;
 import com.intellij.util.ArrayUtil;
 import com.intellij.util.ReflectionUtil;
 import org.jdom.Element;
-import org.jetbrains.annotations.Nls;
-import org.jetbrains.annotations.NonNls;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
+import org.jetbrains.annotations.*;

 import java.util.List;

@@ -156,6 +153,7 @@ public abstract class BaseInspection extends AbstractBaseJavaLocalInspectionTool
   *
   * @deprecated use {@link #isAvailableForFile(PsiFile)} or {@link #requiredFeatures()}
   */
+  @ApiStatus.Internal
  @Deprecated
  public boolean shouldInspect(@NotNull PsiFile file) {
    return true;
@@ -9,8 +9,8 @@ import org.jetbrains.annotations.ApiStatus;
 /**
 * @deprecated Use the direct comparison.
 */
-@Deprecated
-@ApiStatus.ScheduledForRemoval
+@ApiStatus.Internal
+@Deprecated(forRemoval = true)
 public interface BaseJavaJspElementType {
  ParentAwareTokenSet WHITE_SPACE_BIT_SET = ParentAwareTokenSet.orSet(
    ParentAwareTokenSet.create(TokenSet.WHITE_SPACE),
@@ -14,7 +14,7 @@ import org.jetbrains.annotations.ApiStatus;
 */
@Deprecated
@ApiStatus.ScheduledForRemoval
-@ApiStatus.Experimental
+@ApiStatus.Internal
 public abstract class AbstractBasicJavaDocElementTypeFactory {
  public static final class JavaDocElementTypeContainer {
    public final IElementType DOC_TAG;
@@ -13,7 +13,7 @@ import org.jetbrains.annotations.ApiStatus;
 */
@Deprecated
@ApiStatus.ScheduledForRemoval
-@ApiStatus.Experimental
+@ApiStatus.Internal
 public abstract class AbstractBasicJavaElementTypeFactory {

  public static class JavaElementTypeContainer {
@@ -7,6 +7,7 @@ import com.intellij.jarRepository.RemoteRepositoryDescription;
 import com.intellij.jarRepository.RepositoryArtifactDescription;
 import com.intellij.util.ThrowableConsumer;
 import com.intellij.util.io.HttpRequests;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

@@ -35,6 +36,7 @@ import static java.util.Collections.emptyList;
 /**
 * @deprecated since Bintray service is scheduled for sunsetting in May 2021
 */
+@ApiStatus.Internal
@Deprecated(forRemoval = true)
 public class BintrayEndpoint {

@@ -1,6 +1,7 @@
 // Copyright 2000-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license that can be found in the LICENSE file.
 package com.intellij.jarRepository.services.bintray;

+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

@@ -9,6 +10,7 @@ import java.util.List;
 /**
 * @deprecated since Bintray service is scheduled for sunsetting in May 2021
 */
+@ApiStatus.Internal
@Deprecated(forRemoval = true)
 public class BintrayModel {

@@ -5,6 +5,7 @@ import com.intellij.jarRepository.RemoteRepositoryDescription;
 import com.intellij.jarRepository.RepositoryArtifactDescription;
 import com.intellij.jarRepository.services.MavenRepositoryService;
 import com.intellij.util.containers.ContainerUtil;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 import org.jetbrains.annotations.Unmodifiable;
@@ -20,6 +21,7 @@ import static java.util.Collections.emptyList;
 /**
 * @deprecated since Bintray service is scheduled for sunsetting in May 2021
 */
+@ApiStatus.Internal
@SuppressWarnings("DeprecatedIsStillUsed") // allow to use it in 2021.1
@Deprecated(forRemoval = true)
 public class BintrayRepositoryService extends MavenRepositoryService {
@@ -702,6 +702,7 @@ public class AnnotationUtil {
    {"NotNull", "Nullable", "NonNls", "PropertyKey", "TestOnly", "Language", "Identifier", "Pattern", "PrintFormat", "RegExp", "Subst"};

  /** @deprecated simple name is not enough for reliable identification */
+  @ApiStatus.Internal
  @ApiStatus.ScheduledForRemoval
  @Deprecated
  public static boolean isJetbrainsAnnotation(@NotNull String simpleName) {
@@ -9,7 +9,6 @@ import com.intellij.openapi.project.Project;
 import com.intellij.openapi.roots.FileIndexFacade;
 import com.intellij.openapi.util.Key;
 import com.intellij.openapi.vfs.VirtualFile;
-import com.intellij.psi.impl.PsiManagerImpl;
 import com.intellij.psi.impl.compiled.ClsFileImpl;
 import com.intellij.psi.impl.file.PsiBinaryFileImpl;
 import org.jetbrains.annotations.ApiStatus;
@@ -61,6 +60,7 @@ public class ClassFileViewProvider extends SingleRootFileViewProvider {
  /**
   * @deprecated use {@link #isInnerClass(VirtualFile)} or {@link #isInnerClass(VirtualFile, ClassReader)} 
   */
+  @ApiStatus.Internal
  @ApiStatus.ScheduledForRemoval
  @Deprecated
  public static boolean isInnerClass(@NotNull VirtualFile file, byte @NotNull [] content) {