OptionsOverride (com.github.susom:database 3.2 API)

java.lang.Object
- com.github.susom.database.OptionsOverride

All Implemented Interfaces:

Options
```
public class OptionsOverride
extends Object
implements Options
```
Base class for selectively overriding another Options object.

Author:

garricko

Constructor Summary

Constructors
Constructor and Description
`OptionsOverride()` Defer to OptionsDefault for anything that is not specified, and use postgresql flavor.
`OptionsOverride(Flavor flavor)` Defer to OptionsDefault for anything that is not specified, using the specified flavor.
`OptionsOverride(Options parent)` Wrap another `Options` and defer to it for anything we choose not to override.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`allowConnectionAccess()` Control whether the Database object will allow calls to underlyingConnection().
`boolean`	`allowTransactionControl()` Control whether the Database object will allow calls to commitNow() and rollbackNow().
`Calendar`	`calendarForTimestamps()` This calendar will be used for conversions when storing and retrieving timestamps from the database.
`Date`	`currentDate()` The value returned by this method will be used for argDateNowPerApp() calls.
`Flavor`	`flavor()` Access compatibility information for the underlying database.
`String`	`generateErrorCode()` In cases where exceptions are thrown, use this method to provide a common code that will be included in the exception message and the log message so they can be searched and correlated later.
`boolean`	`ignoreTransactionControl()` Useful for testing code that explicitly controls transactions, and you don't really want it to commit/rollback.
`boolean`	`isDetailedExceptions()` If true, text of the SQL and possibly parameter values (depending on @{#isLogParameters()}) will be included in exception messages.
`boolean`	`isLogParameters()` If this is false, log messages will look something like:
`int`	`maxStringLengthParam()` The maximum number of characters to print in debug SQL for a given String type insert/update/query parameter.
`void`	`setParent(Options parent)`
`boolean`	`useBytesForBlob()` Indicate whether to use the Blob functionality of the underlying database driver, or whether to use setBytes() methods instead.
`boolean`	`useDatePerAppOnly()` Wherever argDateNowPerDb() is specified, use argDateNowPerApp() instead.
`boolean`	`useStringForClob()` Indicate whether to use the Clob functionality of the underlying database driver, or whether to use setString() methods instead.
`OptionsOverride`	`withParent(Options parent)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - OptionsOverride
```
public OptionsOverride(Options parent)
```
    Wrap another Options and defer to it for anything we choose not to override.
  - OptionsOverride
```
public OptionsOverride()
```
    Defer to OptionsDefault for anything that is not specified, and use postgresql flavor.
  - OptionsOverride
```
public OptionsOverride(Flavor flavor)
```
    Defer to OptionsDefault for anything that is not specified, using the specified flavor.
- Method Detail
  - setParent
```
public void setParent(Options parent)
```
  - withParent
```
public OptionsOverride withParent(Options parent)
```
  - allowTransactionControl
```
public boolean allowTransactionControl()
```
    Description copied from interface: Options
    
    Control whether the Database object will allow calls to commitNow() and rollbackNow(). By default it will throw exceptions if you try to call those.
    
    Specified by:
    
    allowTransactionControl in interface Options
  - ignoreTransactionControl
```
public boolean ignoreTransactionControl()
```
    Description copied from interface: Options
    
    Useful for testing code that explicitly controls transactions, and you don't really want it to commit/rollback. Disabled by default, meaning calls will be allowed or throw exceptions depending on allowTransctionControl(). The value of allowTranscationControl() has no affect if this returns true.
    
    Specified by:
    
    ignoreTransactionControl in interface Options
  - allowConnectionAccess
```
public boolean allowConnectionAccess()
```
    Description copied from interface: Options
    
    Control whether the Database object will allow calls to underlyingConnection(). By default that method will throw an exception.
    
    Specified by:
    
    allowConnectionAccess in interface Options
  - isLogParameters
```
public boolean isLogParameters()
```
    Description copied from interface: Options
    If this is false, log messages will look something like:
```
   ...select a from b where c=?
 
```
    If this is true, log messages will look something like:
```
   ...select a from b where c=?|select a from b where c='abc'
 
```
    Specified by:
    
    isLogParameters in interface Options
    
    Returns:
    
    true if parameter values should be logged along with SQL, false otherwise
  - isDetailedExceptions
```
public boolean isDetailedExceptions()
```
    Description copied from interface: Options
    
    If true, text of the SQL and possibly parameter values (depending on @{#isLogParameters()}) will be included in exception messages. This can be very helpful for debugging, but poses some disclosure risks.
    
    Specified by:
    
    isDetailedExceptions in interface Options
    
    Returns:
    
    true to add possibly sensitive data in exception messages, false otherwise
  - generateErrorCode
```
public String generateErrorCode()
```
    Description copied from interface: Options
    
    In cases where exceptions are thrown, use this method to provide a common code that will be included in the exception message and the log message so they can be searched and correlated later.
    
    Specified by:
    
    generateErrorCode in interface Options
    
    Returns:
    
    an arbitrary, fairly unique, speakable over the phone, without whitespace
  - useBytesForBlob
```
public boolean useBytesForBlob()
```
    Description copied from interface: Options
    
    Indicate whether to use the Blob functionality of the underlying database driver, or whether to use setBytes() methods instead. Using Blobs is preferred, but is not supported by all drivers.
    The default behavior of this method is to delegate to flavor().useBytesForBlob(), but it is provided on this interface so the behavior can be controlled.
    
    Specified by:
    
    useBytesForBlob in interface Options
    
    Returns:
    
    true to avoid using Blob functionality, false otherwise
  - useStringForClob
```
public boolean useStringForClob()
```
    Description copied from interface: Options
    
    Indicate whether to use the Clob functionality of the underlying database driver, or whether to use setString() methods instead. Using Clobs is preferred, but is not supported by all drivers.
    The default behavior of this method is to delegate to flavor().useStringForClob(), but it is provided on this interface so the behavior can be controlled.
    
    Specified by:
    
    useStringForClob in interface Options
    
    Returns:
    
    true to avoid using Clob functionality, false otherwise
  - flavor
```
public Flavor flavor()
```
    Description copied from interface: Options
    
    Access compatibility information for the underlying database. The Flavor class enumerates the known databases and tries to smooth over some of the variations in features and syntax.
    
    Specified by:
    
    flavor in interface Options
  - currentDate
```
public Date currentDate()
```
    Description copied from interface: Options
    
    The value returned by this method will be used for argDateNowPerApp() calls. It may also be used for argDateNowPerDb() calls if you have enabled that.
    
    Specified by:
    
    currentDate in interface Options
  - useDatePerAppOnly
```
public boolean useDatePerAppOnly()
```
    Description copied from interface: Options
    
    Wherever argDateNowPerDb() is specified, use argDateNowPerApp() instead. This is useful for testing purposes as you can use OptionsOverride to provide your own system clock that will be used for time travel.
    
    Specified by:
    
    useDatePerAppOnly in interface Options
  - calendarForTimestamps
```
public Calendar calendarForTimestamps()
```
    Description copied from interface: Options
    
    This calendar will be used for conversions when storing and retrieving timestamps from the database. By default this is the JVM default with TimeZone explicitly set to GMT (so timestamps will be stored in the database as GMT).
    It is strongly recommended to always run your database in GMT timezone, and leave this set to the default.
    
    Behavior in releases 1.3 and prior was to use the JVM default TimeZone, and this was not configurable.
    
    Specified by:
    
    calendarForTimestamps in interface Options
  - maxStringLengthParam
```
public int maxStringLengthParam()
```
    Description copied from interface: Options
    
    The maximum number of characters to print in debug SQL for a given String type insert/update/query parameter. If it exceeds this length, the parameter value will be truncated at the max and a "..." will be appended. Note this affects both argString() and argClobString() methods.
    
    Specified by:
    
    maxStringLengthParam in interface Options

Class OptionsOverride

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

OptionsOverride

OptionsOverride

OptionsOverride

Method Detail

setParent

withParent

allowTransactionControl

ignoreTransactionControl

allowConnectionAccess

isLogParameters

isDetailedExceptions

generateErrorCode

useBytesForBlob

useStringForClob

flavor

currentDate

useDatePerAppOnly

calendarForTimestamps

maxStringLengthParam