Some comments and notes for StandardServiceInitiators

hibernate-core/src/main/java/org/hibernate/service/StandardServiceInitiators.java

@@ -55,51 +55,104 @@ public final class StandardServiceInitiators {
 	public static final List<StandardServiceInitiator<?>> LIST = buildStandardServiceInitiatorList();
 
 	private static List<StandardServiceInitiator<?>> buildStandardServiceInitiatorList() {
+
+		// Please do not rearrange - it's useful to maintain this particular order
+		// so to simplify comparisons with custom initiator lists in other projects;
+		// for example we customize this list in Hibernate Reactive and Quarkus.
+
 		final ArrayList<StandardServiceInitiator<?>> serviceInitiators = new ArrayList<>();
 
+		// SessionFactoryBuilderService
 		serviceInitiators.add( DefaultSessionFactoryBuilderInitiator.INSTANCE );
 
+		// IdentifierGeneratorFactory
 		serviceInitiators.add( StandardIdentifierGeneratorFactoryInitiator.INSTANCE );
 
+		// BytecodeProvider
 		serviceInitiators.add( BytecodeProviderInitiator.INSTANCE );
+
+		// ProxyFactoryFactory
 		serviceInitiators.add( ProxyFactoryFactoryInitiator.INSTANCE );
 
+		// CfgXmlAccessService
 		serviceInitiators.add( CfgXmlAccessServiceInitiator.INSTANCE );
+
+		// ConfigurationService
 		serviceInitiators.add( ConfigurationServiceInitiator.INSTANCE );
+
+		// PropertyAccessStrategyResolver
 		serviceInitiators.add( PropertyAccessStrategyResolverInitiator.INSTANCE );
 
+		// SqlScriptCommandExtractor
 		serviceInitiators.add( SqlScriptExtractorInitiator.INSTANCE );
+
+		// SchemaManagementTool
 		serviceInitiators.add( SchemaManagementToolInitiator.INSTANCE );
 
+		// JdbcEnvironment
 		serviceInitiators.add( JdbcEnvironmentInitiator.INSTANCE );
+
+		// JndiService
 		serviceInitiators.add( JndiServiceInitiator.INSTANCE );
 
+		// PersisterClassResolver
 		serviceInitiators.add( PersisterClassResolverInitiator.INSTANCE );
+
+		// PersisterFactory
 		serviceInitiators.add( PersisterFactoryInitiator.INSTANCE );
 
+		// ConnectionProvider
 		serviceInitiators.add( ConnectionProviderInitiator.INSTANCE );
+
+		// MultiTenantConnectionProvider
 		serviceInitiators.add( MultiTenantConnectionProviderInitiator.INSTANCE );
+
+		// DialectResolver
 		serviceInitiators.add( DialectResolverInitiator.INSTANCE );
+
+		// DialectFactory
 		serviceInitiators.add( DialectFactoryInitiator.INSTANCE );
+
+		// MutationExecutorService
 		serviceInitiators.add( MutationExecutorServiceInitiator.INSTANCE );
+
+		// BatchBuilder
 		serviceInitiators.add( BatchBuilderInitiator.INSTANCE );
+
+		// JdbcServices
 		serviceInitiators.add( JdbcServicesInitiator.INSTANCE );
+
+		// RefCursorSupport
 		serviceInitiators.add( RefCursorSupportInitiator.INSTANCE );
 
+		// JtaPlatformResolver
 		serviceInitiators.add( JtaPlatformResolverInitiator.INSTANCE );
+
+		// JtaPlatform
 		serviceInitiators.add( JtaPlatformInitiator.INSTANCE );
 
+		// SessionFactoryServiceRegistryFactory
 		serviceInitiators.add( SessionFactoryServiceRegistryFactoryInitiator.INSTANCE );
 
+		// RegionFactory
 		serviceInitiators.add( RegionFactoryInitiator.INSTANCE );
 
+		// TransactionCoordinatorBuilder
 		serviceInitiators.add( TransactionCoordinatorBuilderInitiator.INSTANCE );
 
+		// ManagedBeanRegistry
 		serviceInitiators.add( ManagedBeanRegistryInitiator.INSTANCE );
+
+		// EntityCopyObserverFactory
 		serviceInitiators.add( EntityCopyObserverFactoryInitiator.INSTANCE );
 
+		// JdbcValuesMappingProducerProvider
 		serviceInitiators.add( JdbcValuesMappingProducerProviderInitiator.INSTANCE );
+
+		// SqmMultiTableMutationStrategyProvider
 		serviceInitiators.add( SqmMultiTableMutationStrategyProviderInitiator.INSTANCE );
+
+		// JdbcParameterRenderer
 		serviceInitiators.add( JdbcParameterRendererInitiator.INSTANCE );
 
 		serviceInitiators.trimToSize();