Class DatasourceFactory

java.lang.Object

io.micronaut.jdbc.BaseDatasourceFactory

io.micronaut.configuration.jdbc.ucp.DatasourceFactory

All Implemented Interfaces:

io.micronaut.context.event.ApplicationEventListener<io.micronaut.runtime.context.scope.refresh.RefreshEvent>, io.micronaut.context.event.BeanDestroyedEventListener<DataSource>, io.micronaut.core.order.Ordered, io.micronaut.runtime.context.scope.refresh.RefreshEventListener, AutoCloseable, EventListener

@Factory
public class DatasourceFactory
extends BaseDatasourceFactory
implements AutoCloseable, io.micronaut.context.event.BeanDestroyedEventListener<DataSource>

Creates an ucp data source for each configuration bean.

Since:

2.0.1

Author:

toddsharp

Nested Class Summary

Nested classes/interfaces inherited from class BaseDatasourceFactory

BaseDatasourceFactory.DataSourceCredentials

Field Summary

Fields inherited from class BaseDatasourceFactory

applicationContext

Fields inherited from interface io.micronaut.core.order.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Fields inherited from interface io.micronaut.runtime.context.scope.refresh.RefreshEventListener

DEFAULT_POSITION

Constructor Summary

Constructors

Constructor	Description
DatasourceFactory(@Nullable DataSourceResolver dataSourceResolver, io.micronaut.context.ApplicationContext applicationContext)	Default constructor.

Method Summary

Modifier and Type	Method	Description
void	close()
oracle.ucp.jdbc.PoolDataSource	dataSource(DatasourceConfiguration datasourceConfiguration)	Method to get a PoolDataSource from the DatasourceConfiguration.
protected void	dataSourceCredentialsChanged(String dataSourceName, BaseDatasourceFactory.DataSourceCredentials dataSourceCredentials)	Called when the datasource credentials have changed.
void	onDestroyed(io.micronaut.context.event.BeanDestroyedEvent<DataSource> event)	Closes the pool of a data source once its bean is destroyed, after the beans that depend on it, such as a JPA SessionFactory that drops the schema on close.
@Nullable OracleUcpDataSourcePoolMetadata	ucpDataSourcePoolMetadata(DataSource dataSource)	Method to create a metadata object that allows pool value lookup for each datasource object.

Methods inherited from class BaseDatasourceFactory

findDataSourceName, getObservedConfigurationPrefixes, onApplicationEvent

Methods inherited from class Object

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

Methods inherited from interface io.micronaut.runtime.context.scope.refresh.RefreshEventListener

getOrder, supports

Constructor Details

DatasourceFactory

public DatasourceFactory(@Nullable DataSourceResolver dataSourceResolver,
 io.micronaut.context.ApplicationContext applicationContext)

Default constructor.

Parameters:

dataSourceResolver - The data source resolver

applicationContext - The application context

Method Details

dataSource

@Context
@EachBean(DatasourceConfiguration.class)
@Requires(condition=JdbcDataSourceEnabled.class)
public oracle.ucp.jdbc.PoolDataSource dataSource(DatasourceConfiguration datasourceConfiguration)

Method to get a PoolDataSource from the DatasourceConfiguration.

Parameters:

datasourceConfiguration - A DatasourceConfiguration

Returns:

A PoolDataSource

ucpDataSourcePoolMetadata

@EachBean(DataSource.class)
@Requires(beans=DatasourceConfiguration.class)
public @Nullable OracleUcpDataSourcePoolMetadata ucpDataSourcePoolMetadata(DataSource dataSource)

Method to create a metadata object that allows pool value lookup for each datasource object.

Parameters:

dataSource - The actual datasource

Returns:

a OracleUcpDataSourcePoolMetadata

onDestroyed

public void onDestroyed(io.micronaut.context.event.BeanDestroyedEvent<DataSource> event)

Closes the pool of a data source once its bean is destroyed, after the beans that depend on it, such as a JPA SessionFactory that drops the schema on close. The remaining pools are closed by close().

Specified by:

onDestroyed in interface io.micronaut.context.event.BeanDestroyedEventListener<DataSource>

Parameters:

event - The bean destroyed event

close

@PreDestroy
public void close()

Specified by:

close in interface AutoCloseable

dataSourceCredentialsChanged

protected void dataSourceCredentialsChanged(String dataSourceName,
 BaseDatasourceFactory.DataSourceCredentials dataSourceCredentials)

Description copied from class: BaseDatasourceFactory

Called when the datasource credentials have changed.

Subclasses must implement this method to handle the updated credentials.

Specified by:

dataSourceCredentialsChanged in class BaseDatasourceFactory

Parameters:

dataSourceName - the name of the datasource

dataSourceCredentials - the updated datasource credentials