org.hibernate.boot.registry

Class BootstrapServiceRegistryBuilder

java.lang.Object

org.hibernate.boot.registry.BootstrapServiceRegistryBuilder

Direct Known Subclasses:

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

Methods

Modifier and Type	Method and Description
BootstrapServiceRegistry	build() Build the bootstrap 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) Adds a provided ClassLoader for use in class-loading and resource-lookup.
BootstrapServiceRegistryBuilder	with(ClassLoaderService classLoaderService) Adds a provided ClassLoaderService for use in class-loading and resource-lookup.
BootstrapServiceRegistryBuilder	with(Integrator integrator) Add an Integrator to be applied to the bootstrap registry.
BootstrapServiceRegistryBuilder	withApplicationClassLoader(ClassLoader classLoader) Deprecated. Use with(ClassLoader) instead
BootstrapServiceRegistryBuilder	withEnvironmentClassLoader(ClassLoader classLoader) Deprecated. Use with(ClassLoader) instead
BootstrapServiceRegistryBuilder	withHibernateClassLoader(ClassLoader classLoader) Deprecated. Use with(ClassLoader) instead
BootstrapServiceRegistryBuilder	withResourceClassLoader(ClassLoader classLoader) Deprecated. Use with(ClassLoader) instead
<T> BootstrapServiceRegistryBuilder	withStrategySelector(Class<T> strategy, String name, Class<? extends T> implementation) Applies a named strategy implementation to the bootstrap registry.
BootstrapServiceRegistryBuilder	withStrategySelectors(StrategyRegistrationProvider strategyRegistrationProvider) Applies one or more strategy selectors announced as available by the passed announcer.

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

public BootstrapServiceRegistryBuilder with(Integrator integrator)

Add an Integrator to be applied to the bootstrap registry.

Parameters:

integrator - The integrator to add.

Returns:

this, for method chaining

with

public BootstrapServiceRegistryBuilder with(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

with

public BootstrapServiceRegistryBuilder with(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

withApplicationClassLoader

@Deprecated
public BootstrapServiceRegistryBuilder withApplicationClassLoader(ClassLoader classLoader)

Deprecated. Use with(ClassLoader) instead

Applies the specified ClassLoader as the application class loader for the bootstrap registry.

Parameters:

classLoader - The class loader to use

Returns:

this, for method chaining

withResourceClassLoader

@Deprecated
public BootstrapServiceRegistryBuilder withResourceClassLoader(ClassLoader classLoader)

Deprecated. Use with(ClassLoader) instead

Applies the specified ClassLoader as the resource class loader for the bootstrap registry.

Parameters:

classLoader - The class loader to use

Returns:

this, for method chaining

withHibernateClassLoader

@Deprecated
public BootstrapServiceRegistryBuilder withHibernateClassLoader(ClassLoader classLoader)

Deprecated. Use with(ClassLoader) instead

Applies the specified ClassLoader as the Hibernate class loader for the bootstrap registry.

Parameters:

classLoader - The class loader to use

Returns:

this, for method chaining

withEnvironmentClassLoader

@Deprecated
public BootstrapServiceRegistryBuilder withEnvironmentClassLoader(ClassLoader classLoader)

Deprecated. Use with(ClassLoader) instead

Applies the specified ClassLoader as the environment (or system) class loader for the bootstrap registry.

Parameters:

classLoader - The class loader to use

Returns:

this, for method chaining

withStrategySelector

public <T> BootstrapServiceRegistryBuilder withStrategySelector(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

public BootstrapServiceRegistryBuilder withStrategySelectors(StrategyRegistrationProvider strategyRegistrationProvider)

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

Parameters:

strategyRegistrationProvider - An 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.

Some applications that explicitly build "shared registries" may want to circumvent that behavior.

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