Configuration (jOOQ 3.0.1 API)

All Superinterfaces:

Serializable

All Known Implementing Classes:

DefaultConfiguration
```
public interface Configuration
extends Serializable
```
A Configuration configures a DSLContext, providing it with information for query construction, rendering and execution.
A Configuration wraps all information elements that are needed...
- by a DSLContext to construct Query objects
- by a RenderContext to render Query objects and QueryParts
- by a BindContext to bind values to Query objects and QueryParts
- by a Query or Routine object to execute itself
The simplest usage of a Configuration instance is to use it exactly for a single Query execution, disposing it immediately. This will make it very simple to implement thread-safe behaviour.
At the same time, jOOQ does not require Configuration instances to be that short-lived. Thread-safety will then be delegated to component objects, such as the ConnectionProvider, the ExecuteListener list, etc.
Author:

Lukas Eder

Method Summary

Methods
Modifier and Type	Method and Description
`ConnectionProvider`	`connectionProvider()` Get this configuration's underlying connection provider.
`Map<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. - 2.0.5 - Use `settings()` instead
`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.

- Method Detail
  - dialect
```
SQLDialect dialect()
```
    Retrieve the configured dialect.
  - connectionProvider
```
ConnectionProvider connectionProvider()
```
    Get this configuration's underlying connection provider.
  - schemaMapping
```
@Deprecated
SchemaMapping schemaMapping()
```
    Deprecated. - 2.0.5 - Use settings() instead
    
    Retrieve the configured schema mapping.
  - settings
```
Settings settings()
```
    Retrieve the runtime configuration settings.
  - data
```
Map<Object,Object> data()
```
    Get all custom data from this Configuration.
    This is custom data that was previously set to the configuration using 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.
    
    Returns:
    The custom data. This is never null
    See Also:
    ExecuteListener
  - data
```
Object data(Object key)
```
    Get some custom data from this Configuration.
    This is custom data that was previously set to the configuration using 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.
    
    Parameters:
    key - A key to identify the custom data
    
    Returns:
    The custom data or null if no such data is contained in this Configuration
    See Also:
    ExecuteListener
  - data
```
Object data(Object key,
          Object value)
```
    Set some custom data to this 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.
    
    Parameters:
    key - A key to identify the custom data
    value - The custom data or null to unset the custom data
    
    Returns:
    The previously set custom data or null if no data was previously set for the given key
    See Also:
    ExecuteListener
  - executeListenerProviders
```
ExecuteListenerProvider[] executeListenerProviders()
```
    Get the configured 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
    - share this Configuration's lifecycle (i.e. that of a JDBC Connection, or that of a transaction)
    - share the lifecycle of an ExecuteContext (i.e. that of a single query execution)
    - follow an entirely different lifecycle.
    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.
    Returns:
    The configured set of execute listeners.
    See Also:
    ExecuteListenerProvider, ExecuteListener, ExecuteContext
  - derive
```
Configuration derive()
```
    Create a derived configuration from this one, without changing any properties.
    
    Returns:
    The derived configuration.
  - derive
```
Configuration derive(SQLDialect newDialect)
```
    Create a derived configuration from this one, with a new dialect.
    
    Parameters:
    newDialect - The new dialect to be contained in the derived configuration.
    
    Returns:
    The derived configuration.
  - derive
```
Configuration derive(ConnectionProvider newConnectionProvider)
```
    Create a derived configuration from this one, with a new connection provider.
    
    Parameters:
    newConnectionProvider - The new connection provider to be contained in the derived configuration.
    
    Returns:
    The derived configuration.
  - derive
```
Configuration derive(Settings newSettings)
```
    Create a derived configuration from this one, with new settings.
    
    Parameters:
    newSettings - The new settings to be contained in the derived configuration.
    
    Returns:
    The derived configuration.
  - derive
```
Configuration derive(ExecuteListenerProvider... newExecuteListenerProviders)
```
    Create a derived configuration from this one, with a new execute listener providers.
    
    Parameters:
    newExecuteListenerProviders - The new execute listener providers to be contained in the derived configuration.
    
    Returns:
    The derived configuration.
  - set
```
Configuration set(SQLDialect newDialect)
```
    Change this configuration to hold a new dialect.
    This method is not thread-safe and should not be used in globally available Configuration objects.
    
    Parameters:
    newDialect - The new dialect to be contained in the changed configuration.
    
    Returns:
    The changed configuration.
  - set
```
Configuration set(ConnectionProvider newConnectionProvider)
```
    Change this configuration to hold a new connection provider.
    This method is not thread-safe and should not be used in globally available Configuration objects.
    
    Parameters:
    newConnectionProvider - The new connection provider to be contained in the changed configuration.
    
    Returns:
    The changed configuration.
  - set
```
Configuration set(Settings newSettings)
```
    Change this configuration to hold a new settings.
    This method is not thread-safe and should not be used in globally available Configuration objects.
    
    Parameters:
    newSettings - The new settings to be contained in the changed configuration.
    
    Returns:
    The changed configuration.
  - set
```
Configuration set(ExecuteListenerProvider... newExecuteListenerProviders)
```
    Change this configuration to hold a new execute listener providers.
    This method is not thread-safe and should not be used in globally available Configuration objects.
    
    Parameters:
    newExecuteListenerProviders - The new execute listener providers to be contained in the changed configuration.
    
    Returns:
    The changed configuration.

Interface Configuration

Method Summary

Method Detail

dialect

connectionProvider

schemaMapping

settings

data

data

data

executeListenerProviders

derive

derive

derive

derive

derive

set

set

set

set