IJPL-797 intellij.platform.jps.model review internal API

Hide some code from JPS Model to simplify migration to the new implementation (IJPL-409).

GitOrigin-RevId: f8aa89460b37ee5115b9a30ed101bbe90b5757e2

jps/model-api/api-dump-unreviewed.txt

@@ -23,17 +23,6 @@ com.intellij.openapi.fileTypes.FileNameMatcher
 a:com.intellij.openapi.fileTypes.FileNameMatcherEx
 - com.intellij.openapi.fileTypes.FileNameMatcher
 - <init>():V
-com.intellij.platform.jps.model.resolver.JpsDependencyResolverConfiguration
-- org.jetbrains.jps.model.JpsElement
-- a:isBindRepositoryEnabled():Z
-- a:isSha256ChecksumVerificationEnabled():Z
-- a:setBindRepositoryEnabled(Z):V
-- a:setSha256ChecksumVerificationEnabled(Z):V
-a:com.intellij.platform.jps.model.resolver.JpsDependencyResolverConfigurationService
-- <init>():V
-- a:getDependencyResolverConfiguration(org.jetbrains.jps.model.JpsProject):com.intellij.platform.jps.model.resolver.JpsDependencyResolverConfiguration
-- s:getInstance():com.intellij.platform.jps.model.resolver.JpsDependencyResolverConfigurationService
-- a:getOrCreateDependencyResolverConfiguration(org.jetbrains.jps.model.JpsProject):com.intellij.platform.jps.model.resolver.JpsDependencyResolverConfiguration
 org.jetbrains.jps.model.JpsCompositeElement
 - org.jetbrains.jps.model.JpsElement
 - a:getContainer():org.jetbrains.jps.model.JpsElementContainer
@@ -68,16 +57,8 @@ org.jetbrains.jps.model.JpsElementCreator
 a:org.jetbrains.jps.model.JpsElementFactory
 - <init>():V
 - a:createDummyElement():org.jetbrains.jps.model.JpsDummyElement
-- a:createGlobalReference():org.jetbrains.jps.model.JpsElementReference
-- a:createLibrary(java.lang.String,org.jetbrains.jps.model.library.JpsLibraryType,org.jetbrains.jps.model.JpsElement):org.jetbrains.jps.model.library.JpsTypedLibrary
 - a:createLibraryReference(java.lang.String,org.jetbrains.jps.model.JpsElementReference):org.jetbrains.jps.model.library.JpsLibraryReference
-- a:createModel():org.jetbrains.jps.model.JpsModel
-- a:createModule(java.lang.String,org.jetbrains.jps.model.module.JpsModuleType,org.jetbrains.jps.model.JpsElement):org.jetbrains.jps.model.module.JpsModule
 - a:createModuleReference(java.lang.String):org.jetbrains.jps.model.module.JpsModuleReference
-- a:createModuleSourceRoot(java.lang.String,org.jetbrains.jps.model.module.JpsModuleSourceRootType,org.jetbrains.jps.model.JpsElement):org.jetbrains.jps.model.module.JpsModuleSourceRoot
-- a:createProjectReference():org.jetbrains.jps.model.JpsElementReference
-- a:createSdk(java.lang.String,java.lang.String,java.lang.String,org.jetbrains.jps.model.library.sdk.JpsSdkType,org.jetbrains.jps.model.JpsElement):org.jetbrains.jps.model.library.JpsTypedLibrary
-- a:createSdkReference(java.lang.String,org.jetbrains.jps.model.library.sdk.JpsSdkType):org.jetbrains.jps.model.library.sdk.JpsSdkReference
 - a:createSimpleElement(java.lang.Object):org.jetbrains.jps.model.JpsSimpleElement
 - s:getInstance():org.jetbrains.jps.model.JpsElementFactory
 org.jetbrains.jps.model.JpsElementParameterizedCreator
@@ -336,20 +317,6 @@ a:org.jetbrains.jps.model.fileTypes.FileNameMatcherFactory
 - <init>():V
 - a:createMatcher(java.lang.String):com.intellij.openapi.fileTypes.FileNameMatcher
 - s:getInstance():org.jetbrains.jps.model.fileTypes.FileNameMatcherFactory
-org.jetbrains.jps.model.jarRepository.JpsRemoteRepositoriesConfiguration
-- org.jetbrains.jps.model.JpsElement
-- a:getRepositories():java.util.List
-- a:setRepositories(java.util.List):V
-c:org.jetbrains.jps.model.jarRepository.JpsRemoteRepositoryDescription
-- <init>(java.lang.String,java.lang.String,java.lang.String):V
-- getId():java.lang.String
-- getName():java.lang.String
-- getUrl():java.lang.String
-a:org.jetbrains.jps.model.jarRepository.JpsRemoteRepositoryService
-- <init>():V
-- s:getInstance():org.jetbrains.jps.model.jarRepository.JpsRemoteRepositoryService
-- a:getOrCreateRemoteRepositoriesConfiguration(org.jetbrains.jps.model.JpsProject):org.jetbrains.jps.model.jarRepository.JpsRemoteRepositoriesConfiguration
-- a:getRemoteRepositoriesConfiguration(org.jetbrains.jps.model.JpsProject):org.jetbrains.jps.model.jarRepository.JpsRemoteRepositoriesConfiguration
 org.jetbrains.jps.model.java.ExplodedDirectoryModuleExtension
 - org.jetbrains.jps.model.JpsElement
 - a:getExplodedUrl():java.lang.String
@@ -966,12 +933,6 @@ org.jetbrains.jps.model.runConfiguration.JpsTypedRunConfiguration
 org.jetbrains.jps.model.serialization.JpsPathMapper
 - sf:IDENTITY:org.jetbrains.jps.model.serialization.JpsPathMapper
 - a:mapUrl(java.lang.String):java.lang.String
-f:org.jetbrains.jps.model.serialization.SerializationConstants
-- sf:EXTERNAL_SYSTEM_ID_ATTRIBUTE:java.lang.String
-- sf:EXTERNAL_SYSTEM_ID_IN_INTERNAL_STORAGE_ATTRIBUTE:java.lang.String
-- sf:IS_MAVEN_MODULE_IML_ATTRIBUTE:java.lang.String
-- sf:MAVEN_EXTERNAL_SOURCE_ID:java.lang.String
-- <init>():V
 a:org.jetbrains.jps.service.JpsServiceManager
 - <init>():V
 - a:getExtensions(java.lang.Class):java.lang.Iterable

jps/model-api/src/com/intellij/platform/jps/model/resolver/package-info.java

@@ -0,0 +1,5 @@
+// Copyright 2000-2024 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
+@Internal
+package com.intellij.platform.jps.model.resolver;
+
+import org.jetbrains.annotations.ApiStatus.Internal;

jps/model-api/src/org/jetbrains/jps/model/JpsElementFactory.java

@@ -15,6 +15,7 @@
  */
 package org.jetbrains.jps.model;
 
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 import org.jetbrains.jps.model.library.JpsLibraryReference;
@@ -31,15 +32,40 @@ public abstract class JpsElementFactory {
     return JpsServiceManager.getInstance().getService(JpsElementFactory.class);
   }
 
+  /**
+   * JpsModel API isn't supposed to be used for creating model from scratch, use 
+   * {@link org.jetbrains.jps.model.serialization.JpsSerializationManager} to load the model from .idea directory.
+   */
+  @ApiStatus.Internal
   public abstract JpsModel createModel();
 
+  /**
+   * JpsModel API isn't supposed to be used for creating model from scratch, use
+   * {@link org.jetbrains.jps.model.serialization.JpsSerializationManager} to load the model from .idea directory.
+   */
+  @ApiStatus.Internal
   public abstract <P extends JpsElement> JpsModule createModule(@NotNull String name, @NotNull JpsModuleType<P> type, @NotNull P properties);
 
+  /**
+   * JpsModel API isn't supposed to be used for creating model from scratch, use
+   * {@link org.jetbrains.jps.model.serialization.JpsSerializationManager} to load the model from .idea directory.
+   */
+  @ApiStatus.Internal
   public abstract <P extends JpsElement> JpsTypedLibrary<P> createLibrary(@NotNull String name, @NotNull JpsLibraryType<P> type, @NotNull P properties);
 
+  /**
+   * JpsModel API isn't supposed to be used for creating model from scratch, use
+   * {@link org.jetbrains.jps.model.serialization.JpsSerializationManager} to load the model from .idea directory.
+   */
+  @ApiStatus.Internal
   public abstract <P extends JpsElement> JpsTypedLibrary<JpsSdk<P>> createSdk(@NotNull String name, @Nullable String homePath, @Nullable String versionString,
                                                                               @NotNull JpsSdkType<P> type, @NotNull P properties);
 
+  /**
+   * JpsModel API isn't supposed to be used for creating model from scratch, use
+   * {@link org.jetbrains.jps.model.serialization.JpsSerializationManager} to load the model from .idea directory.
+   */
+  @ApiStatus.Internal
   @NotNull
   public abstract <P extends JpsElement> JpsModuleSourceRoot createModuleSourceRoot(@NotNull String url, @NotNull JpsModuleSourceRootType<P> type, @NotNull P properties);
 
@@ -50,13 +76,28 @@ public abstract class JpsElementFactory {
   public abstract JpsLibraryReference createLibraryReference(@NotNull String libraryName,
                                                              @NotNull JpsElementReference<? extends JpsCompositeElement> parentReference);
 
+  /**
+   * JpsModel API isn't supposed to be used for creating model from scratch, use
+   * {@link org.jetbrains.jps.model.serialization.JpsSerializationManager} to load the model from .idea directory.
+   */
+  @ApiStatus.Internal
   @NotNull
   public abstract <P extends JpsElement> JpsSdkReference<P> createSdkReference(@NotNull String sdkName,
                                                                                                 @NotNull JpsSdkType<P> sdkType);
 
+  /**
+   * JpsModel API isn't supposed to be used for creating model from scratch, use
+   * {@link org.jetbrains.jps.model.serialization.JpsSerializationManager} to load the model from .idea directory.
+   */
+  @ApiStatus.Internal
   @NotNull
   public abstract JpsElementReference<JpsProject> createProjectReference();
 
+  /**
+   * JpsModel API isn't supposed to be used for creating model from scratch, use
+   * {@link org.jetbrains.jps.model.serialization.JpsSerializationManager} to load the model from .idea directory.
+   */
+  @ApiStatus.Internal
   @NotNull
   public abstract JpsElementReference<JpsGlobal> createGlobalReference();
 

jps/model-api/src/org/jetbrains/jps/model/jarRepository/package-info.java

@@ -0,0 +1,5 @@
+// Copyright 2000-2024 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
+@Internal
+package org.jetbrains.jps.model.jarRepository;
+
+import org.jetbrains.annotations.ApiStatus.Internal;

jps/model-api/src/org/jetbrains/jps/model/serialization/SerializationConstants.java

@@ -1,6 +1,9 @@
 // Copyright 2000-2020 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 org.jetbrains.jps.model.serialization;
 
+import org.jetbrains.annotations.ApiStatus;
+
+@ApiStatus.Internal
 public final class SerializationConstants {
   /**
    * Specifies where an entity is imported from in configuration files stored under external_build_system directory