org.hibernate.boot.registry

Class BootstrapServiceRegistryBuilder

java.lang.Object

org.hibernate.boot.registry.BootstrapServiceRegistryBuilder

public class BootstrapServiceRegistryBuilder
extends Object

Builder for BootstrapServiceRegistry instances. Provides registry for services needed for most operations. This includes Integrator handling and ClassLoader handling.

Additionally responsible for building and managing the StrategySelector

See Also:

StandardServiceRegistryBuilder

Constructor Summary

Constructors

Constructor and Description
BootstrapServiceRegistryBuilder()

Method Summary

Modifier and Type	Method and Description
BootstrapServiceRegistryBuilder	applyClassLoader(ClassLoader classLoader) Adds a provided ClassLoader for use in class-loading and resource-lookup.
BootstrapServiceRegistryBuilder	applyClassLoaderService(ClassLoaderService classLoaderService) Adds a provided ClassLoaderService for use in class-loading and resource-lookup.
BootstrapServiceRegistryBuilder	applyIntegrator(Integrator integrator) Add an Integrator to be applied to the bootstrap registry.
<T> BootstrapServiceRegistryBuilder	applyStrategySelector(Class<T> strategy, String name, Class<? extends T> implementation) Applies a named strategy implementation to the bootstrap registry.
BootstrapServiceRegistryBuilder	applyStrategySelectors(StrategyRegistrationProvider strategyRegistrationProvider) Applies one or more strategy selectors announced as available by the passed announcer.
void	applyTcclLookupPrecedence(org.hibernate.boot.registry.classloading.internal.TcclLookupPrecedence precedence) Defines when the lookup in the thread context ClassLoader is done
BootstrapServiceRegistry	build() Build the bootstrap registry.
static void	destroy(ServiceRegistry serviceRegistry) Destroy a service registry.
BootstrapServiceRegistryBuilder	disableAutoClose() By default, when a ServiceRegistry is no longer referenced by any other registries as a parent it will be closed.
BootstrapServiceRegistryBuilder	enableAutoClose() See the discussion on disableAutoClose().
BootstrapServiceRegistryBuilder	with(ClassLoader classLoader) Deprecated. Use applyClassLoader(java.lang.ClassLoader) instead
BootstrapServiceRegistryBuilder	with(ClassLoaderService classLoaderService) Deprecated. Use applyClassLoaderService(org.hibernate.boot.registry.classloading.spi.ClassLoaderService) instead
BootstrapServiceRegistryBuilder	with(Integrator integrator) Deprecated. Use applyIntegrator(org.hibernate.integrator.spi.Integrator) instead
<T> BootstrapServiceRegistryBuilder	withStrategySelector(Class<T> strategy, String name, Class<? extends T> implementation) Deprecated. Use applyStrategySelector(java.lang.Class<T>, java.lang.String, java.lang.Class<? extends T>) instead
BootstrapServiceRegistryBuilder	withStrategySelectors(StrategyRegistrationProvider strategyRegistrationProvider) Deprecated. Use applyStrategySelectors(org.hibernate.boot.registry.selector.StrategyRegistrationProvider) instead

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BootstrapServiceRegistryBuilder

public BootstrapServiceRegistryBuilder()

Method Detail

with

@Deprecated
public BootstrapServiceRegistryBuilder with(Integrator integrator)

Deprecated. Use applyIntegrator(org.hibernate.integrator.spi.Integrator) instead

applyIntegrator

public BootstrapServiceRegistryBuilder applyIntegrator(Integrator integrator)

Add an Integrator to be applied to the bootstrap registry.

Parameters:

integrator - The integrator to add.

Returns:

this, for method chaining

with

@Deprecated
public BootstrapServiceRegistryBuilder with(ClassLoader classLoader)

Deprecated. Use applyClassLoader(java.lang.ClassLoader) instead

applyClassLoader

public BootstrapServiceRegistryBuilder applyClassLoader(ClassLoader classLoader)

Adds a provided ClassLoader for use in class-loading and resource-lookup.

Parameters:

classLoader - The class loader to use

Returns:

this, for method chaining

applyTcclLookupPrecedence

public void applyTcclLookupPrecedence(org.hibernate.boot.registry.classloading.internal.TcclLookupPrecedence precedence)

Defines when the lookup in the thread context ClassLoader is done

Parameters:

precedence - The lookup precedence

with

@Deprecated
public BootstrapServiceRegistryBuilder with(ClassLoaderService classLoaderService)

Deprecated. Use applyClassLoaderService(org.hibernate.boot.registry.classloading.spi.ClassLoaderService) instead

applyClassLoaderService

public BootstrapServiceRegistryBuilder applyClassLoaderService(ClassLoaderService classLoaderService)

Adds a provided ClassLoaderService for use in class-loading and resource-lookup.

Parameters:

classLoaderService - The class loader service to use

Returns:

this, for method chaining

withStrategySelector

@Deprecated
public <T> BootstrapServiceRegistryBuilder withStrategySelector(Class<T> strategy,
                                                                            String name,
                                                                            Class<? extends T> implementation)

Deprecated. Use applyStrategySelector(java.lang.Class<T>, java.lang.String, java.lang.Class<? extends T>) instead

applyStrategySelector

public <T> BootstrapServiceRegistryBuilder applyStrategySelector(Class<T> strategy,
                                                                 String name,
                                                                 Class<? extends T> implementation)

Applies a named strategy implementation to the bootstrap registry.

Type Parameters:

T - Defines the strategy type and makes sure that the strategy and implementation are of compatible types.

Parameters:

strategy - The strategy

name - The registered name

implementation - The strategy implementation Class

Returns:

this, for method chaining

See Also:

StrategySelector.registerStrategyImplementor(Class, String, Class)

withStrategySelectors

@Deprecated
public BootstrapServiceRegistryBuilder withStrategySelectors(StrategyRegistrationProvider strategyRegistrationProvider)

Deprecated. Use applyStrategySelectors(org.hibernate.boot.registry.selector.StrategyRegistrationProvider) instead

applyStrategySelectors

public BootstrapServiceRegistryBuilder applyStrategySelectors(StrategyRegistrationProvider strategyRegistrationProvider)

Applies one or more strategy selectors announced as available by the passed announcer.

Parameters:

strategyRegistrationProvider - A provider for one or more available selectors

Returns:

this, for method chaining

See Also:

StrategySelector.registerStrategyImplementor(Class, String, Class)

disableAutoClose

public BootstrapServiceRegistryBuilder disableAutoClose()

By default, when a ServiceRegistry is no longer referenced by any other registries as a parent it will be closed. <p/> Some applications that explicitly build "shared registries" may want to circumvent that behavior. <p/> This method indicates that the registry being built should not be automatically closed. The caller agrees to take responsibility to close it themselves.

Returns:

this, for method chaining

enableAutoClose

public BootstrapServiceRegistryBuilder enableAutoClose()

See the discussion on disableAutoClose(). This method enables the auto-closing.

Returns:

this, for method chaining

build

public BootstrapServiceRegistry build()

Build the bootstrap registry.

Returns:

The built bootstrap registry

destroy

public static void destroy(ServiceRegistry serviceRegistry)

Destroy a service registry. Applications should only destroy registries they have explicitly created.

Parameters:

serviceRegistry - The registry to be closed.