public class DefaultConfiguration extends Object implements Configuration
DSLContext
, if no
custom configuration was supplied to DSL.using(Configuration)
.
The DefaultConfiguration
Constructor and Description |
---|
DefaultConfiguration()
Create a new "empty" configuration object.
|
Modifier and Type | Method and Description |
---|---|
ConnectionProvider |
connectionProvider()
Get this configuration's underlying connection provider.
|
ConcurrentHashMap<Object,Object> |
data()
Get all custom data from this
Configuration . |
Object |
data(Object key)
Get some custom data from this
Configuration . |
Object |
data(Object key,
Object value)
Set some custom data to this
Configuration . |
Configuration |
derive()
Create a derived configuration from this one, without changing any
properties.
|
Configuration |
derive(ConnectionProvider newConnectionProvider)
Create a derived configuration from this one, with a new connection
provider.
|
Configuration |
derive(ExecuteListenerProvider... newExecuteListenerProviders)
Create a derived configuration from this one, with a new execute listener
providers.
|
Configuration |
derive(Settings newSettings)
Create a derived configuration from this one, with new settings.
|
Configuration |
derive(SQLDialect newDialect)
Create a derived configuration from this one, with a new dialect.
|
SQLDialect |
dialect()
Retrieve the configured dialect.
|
ExecuteListenerProvider[] |
executeListenerProviders()
Get the configured
ExecuteListenerProvider from this
configuration. |
SchemaMapping |
schemaMapping()
Deprecated.
|
Configuration |
set(ConnectionProvider newConnectionProvider)
Change this configuration to hold a new connection provider.
|
Configuration |
set(ExecuteListenerProvider... newExecuteListenerProviders)
Change this configuration to hold a new execute listener providers.
|
Configuration |
set(Settings newSettings)
Change this configuration to hold a new settings.
|
Configuration |
set(SQLDialect newDialect)
Change this configuration to hold a new dialect.
|
Settings |
settings()
Retrieve the runtime configuration settings.
|
String |
toString() |
public DefaultConfiguration()
This can be used as is, as a "dummy" configuration object, or as a base
implementation for creating more sophisticated "derived" configurations
through the various derive()
or set()
methods.
public final Configuration derive()
derive
in interface Configuration
public final Configuration derive(SQLDialect newDialect)
derive
in interface Configuration
newDialect
- The new dialect to be contained in the derived
configuration.public final Configuration derive(ConnectionProvider newConnectionProvider)
derive
in interface Configuration
newConnectionProvider
- The new connection provider to be contained
in the derived configuration.public final Configuration derive(Settings newSettings)
derive
in interface Configuration
newSettings
- The new settings to be contained in the derived
configuration.public final Configuration derive(ExecuteListenerProvider... newExecuteListenerProviders)
derive
in interface Configuration
newExecuteListenerProviders
- The new execute listener providers to
be contained in the derived configuration.public final Configuration set(SQLDialect newDialect)
Configuration
This method is not thread-safe and should not be used in globally
available Configuration
objects.
set
in interface Configuration
newDialect
- The new dialect to be contained in the changed
configuration.public final Configuration set(ConnectionProvider newConnectionProvider)
Configuration
This method is not thread-safe and should not be used in globally
available Configuration
objects.
set
in interface Configuration
newConnectionProvider
- The new connection provider to be contained
in the changed configuration.public final Configuration set(Settings newSettings)
Configuration
This method is not thread-safe and should not be used in globally
available Configuration
objects.
set
in interface Configuration
newSettings
- The new settings to be contained in the changed
configuration.public final Configuration set(ExecuteListenerProvider... newExecuteListenerProviders)
Configuration
This method is not thread-safe and should not be used in globally
available Configuration
objects.
set
in interface Configuration
newExecuteListenerProviders
- The new execute listener providers to
be contained in the changed configuration.public final SQLDialect dialect()
dialect
in interface Configuration
public final ConnectionProvider connectionProvider()
connectionProvider
in interface Configuration
@Deprecated public final SchemaMapping schemaMapping()
schemaMapping
in interface Configuration
public final Settings settings()
settings
in interface Configuration
public final ConcurrentHashMap<Object,Object> data()
Configuration
.
This is custom data that was previously set to the configuration using
Configuration.data(Object, Object)
. Use custom data if you want to pass data
to your custom QueryPart
or ExecuteListener
objects to be
made available at render, bind, execution, fetch time.
See ExecuteListener
for more details.
data
in interface Configuration
null
ExecuteListener
public final Object data(Object key)
Configuration
.
This is custom data that was previously set to the configuration using
Configuration.data(Object, Object)
. Use custom data if you want to pass data
to your custom QueryPart
or ExecuteListener
objects to be
made available at render, bind, execution, fetch time.
See ExecuteListener
for more details.
data
in interface Configuration
key
- A key to identify the custom datanull
if no such data is contained
in this Configuration
ExecuteListener
public final Object data(Object key, Object value)
Configuration
.
Use custom data if you want to pass data to your custom QueryPart
or ExecuteListener
objects to be made available at render, bind,
execution, fetch time.
Be sure that your custom data implements Serializable
if you want
to serialise this Configuration
or objects referencing this
Configuration
, e.g. your Record
types.
See ExecuteListener
for more details.
data
in interface Configuration
key
- A key to identify the custom datavalue
- The custom data or null
to unset the custom
datanull
if no data
was previously set for the given keyExecuteListener
public final ExecuteListenerProvider[] executeListenerProviders()
ExecuteListenerProvider
from this
configuration.
This method allows for retrieving the configured
ExecuteListenerProvider
from this configuration. The
provider will provide jOOQ with ExecuteListener
instances. These
instances receive execution lifecycle notification events every time jOOQ
executes queries. jOOQ makes no assumptions about the internal state of
these listeners, i.e. listener instances may
Configuration
's lifecycle (i.e. that of a
JDBC Connection
, or that of a transaction)ExecuteContext
(i.e. that of a
single query execution)
Note, depending on your Settings.isExecuteLogging()
, some
additional listeners may be prepended to this list, internally. Those
listeners will never be exposed through this method, though.
executeListenerProviders
in interface Configuration
ExecuteListenerProvider
,
ExecuteListener
,
ExecuteContext
Copyright © 2013. All Rights Reserved.