Module io.helidon.integrations.datasource.ucp.cdi

Package io.helidon.integrations.datasource.ucp.cdi

Class UCPBackedDataSourceExtension

java.lang.Object

io.helidon.integrations.datasource.cdi.AbstractDataSourceExtension

io.helidon.integrations.datasource.ucp.cdi.UCPBackedDataSourceExtension

All Implemented Interfaces:

Extension

public class UCPBackedDataSourceExtension
extends AbstractDataSourceExtension

An Extension that arranges for named DataSource injection points to be satisfied by the Oracle Universal Connection Pool.

In accordance with the CDI specification, instances of this class are not necessarily safe for concurrent use by multiple threads.

Constructor Summary

Constructors

Constructor	Description
UCPBackedDataSourceExtension()	Creates a new UCPBackedDataSourceExtension.

Method Summary

Modifier and Type	Method	Description
protected final void	addBean(BeanConfigurator<DataSource> beanConfigurator, Named dataSourceName, Properties dataSourceProperties)	Called to permit subclasses to add a DataSource-typed bean using the supplied BeanConfigurator.
protected final String	getDataSourceName(Matcher dataSourcePropertyPatternMatcher)	Given a Matcher that has been produced by the AbstractDataSourceExtension.getDataSourcePropertyPatternMatcher(String) method, returns the relevant data source name.
protected final String	getDataSourcePropertyName(Matcher dataSourcePropertyPatternMatcher)	Given a Matcher that has been produced by the AbstractDataSourceExtension.getDataSourcePropertyPatternMatcher(String) method, returns the relevant data source property name.
protected final Matcher	getDataSourcePropertyPatternMatcher(String configPropertyName)	Returns a Matcher for a property name.

Methods inherited from class io.helidon.integrations.datasource.cdi.AbstractDataSourceExtension

getConfig, getDataSourceNames, getPropertyNames, initializeMasterProperties, putDataSourceProperties

Methods inherited from class java.lang.Object

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

Constructor Details

UCPBackedDataSourceExtension

public UCPBackedDataSourceExtension()

Creates a new UCPBackedDataSourceExtension.

Method Details

getDataSourcePropertyPatternMatcher

protected final Matcher getDataSourcePropertyPatternMatcher(String configPropertyName)

Description copied from class: AbstractDataSourceExtension

Returns a Matcher for a property name.

Implementations of this method must not return null.

Given a String like javax.sql.DataSource.dataSourceName.dataSourcePropertyName, any implementation of this method should return a non- null Matcher that is capable of being supplied to the AbstractDataSourceExtension.getDataSourceName(Matcher) and AbstractDataSourceExtension.getDataSourcePropertyName(Matcher) methods.

Specified by:

getDataSourcePropertyPatternMatcher in class AbstractDataSourceExtension

Parameters:

configPropertyName - the name of a configuration property that logically contains a data source name and a data source property name; must not be null

Returns:

a non-null Matcher

See Also:

• AbstractDataSourceExtension.getDataSourceName(Matcher)
• AbstractDataSourceExtension.getDataSourcePropertyName(Matcher)

getDataSourceName

protected final String getDataSourceName(Matcher dataSourcePropertyPatternMatcher)

Description copied from class: AbstractDataSourceExtension

Given a Matcher that has been produced by the AbstractDataSourceExtension.getDataSourcePropertyPatternMatcher(String) method, returns the relevant data source name.

Implementations of this method may return null.

Specified by:

getDataSourceName in class AbstractDataSourceExtension

Parameters:

dataSourcePropertyPatternMatcher - a Matcher produced by the AbstractDataSourceExtension.getDataSourcePropertyPatternMatcher(String) method; must not be null

Returns:

a data source name, or null

See Also:

• AbstractDataSourceExtension.getDataSourcePropertyPatternMatcher(String)

getDataSourcePropertyName

protected final String getDataSourcePropertyName(Matcher dataSourcePropertyPatternMatcher)

Description copied from class: AbstractDataSourceExtension

Given a Matcher that has been produced by the AbstractDataSourceExtension.getDataSourcePropertyPatternMatcher(String) method, returns the relevant data source property name.

Implementations of this method may return null.

Specified by:

getDataSourcePropertyName in class AbstractDataSourceExtension

Parameters:

dataSourcePropertyPatternMatcher - a Matcher produced by the AbstractDataSourceExtension.getDataSourcePropertyPatternMatcher(String) method; must not be null

Returns:

a data source property name, or null

See Also:

• AbstractDataSourceExtension.getDataSourcePropertyPatternMatcher(String)

addBean

protected final void addBean(BeanConfigurator<DataSource> beanConfigurator,
 Named dataSourceName,
 Properties dataSourceProperties)

Description copied from class: AbstractDataSourceExtension

Called to permit subclasses to add a DataSource-typed bean using the supplied BeanConfigurator.

Implementations of this method will be called from an observer method that is observing the AfterBeanDiscovery container lifecycle event.

Specified by:

addBean in class AbstractDataSourceExtension

Parameters:

beanConfigurator - the BeanConfigurator to use to actually add a new bean; must not be null

dataSourceName - a Named instance qualifying the DataSource-typed bean to be added; may be null

dataSourceProperties - a Properties instance containing properties relevant to the data source; must not be null