Interface FbBatchConfig
- 
- All Known Implementing Classes:
- FbBatchConfig.Immutable
 
 public interface FbBatchConfigConfiguration for a Firebird 4+ batch.- Since:
- 5
- Author:
- Mark Rotteveel
 
- 
- 
Nested Class SummaryNested Classes Modifier and Type Interface Description static classFbBatchConfig.ImmutableClass to provide an immutable copy of a batch config.
 - 
Field SummaryFields Modifier and Type Field Description static booleanCONTINUE_ON_ERRORmultiError()value to signal to continue execution on errors.static booleanHALT_AT_FIRST_ERRORmultiError()value to signal to halt execution at first error.static booleanNO_UPDATE_COUNTSupdateCounts()value to signal to no supply update counts.static intSERVER_DEFAULT_BUFFER_SIZEbatchBufferSize()value to signal to use server default batch buffer size.static intSERVER_DEFAULT_DETAILED_ERRORSdetailedErrors()value to signal to use server default detailed errors.static intSERVER_MAXIMUM_BUFFER_SIZEbatchBufferSize()value to signal to use server maximum batch buffer size.static booleanUPDATE_COUNTSupdateCounts()value to signal to supply update counts.
 - 
Method SummaryAll Methods Static Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description intbatchBufferSize()Server-side batch buffer size in bytes.intdetailedErrors()Number of detailed errors to return.default FbBatchConfigimmutable()booleanmultiError()Multi-error behaviour.static FbBatchConfigof(boolean multiError, boolean updateCounts, int detailedErrors, int batchBufferSize)Creates an immutable batch config.default voidpopulateBatchParameterBuffer(BatchParameterBuffer batchPb)Populates the provided batch parameter buffer with the configuration.booleanupdateCounts()Report update counts per element (called "record counts" in Firebird).
 
- 
- 
- 
Field Detail- 
CONTINUE_ON_ERRORstatic final boolean CONTINUE_ON_ERROR multiError()value to signal to continue execution on errors.- See Also:
- Constant Field Values
 
 - 
HALT_AT_FIRST_ERRORstatic final boolean HALT_AT_FIRST_ERROR multiError()value to signal to halt execution at first error.- See Also:
- Constant Field Values
 
 - 
UPDATE_COUNTSstatic final boolean UPDATE_COUNTS updateCounts()value to signal to supply update counts.- See Also:
- Constant Field Values
 
 - 
NO_UPDATE_COUNTSstatic final boolean NO_UPDATE_COUNTS updateCounts()value to signal to no supply update counts.- See Also:
- Constant Field Values
 
 - 
SERVER_DEFAULT_DETAILED_ERRORSstatic final int SERVER_DEFAULT_DETAILED_ERRORS detailedErrors()value to signal to use server default detailed errors.NOTE: all negative values signal this. If you want to use this to check against a value, use <= SERVER_DEFAULT_DETAILED_ERRORS.- See Also:
- Constant Field Values
 
 - 
SERVER_MAXIMUM_BUFFER_SIZEstatic final int SERVER_MAXIMUM_BUFFER_SIZE batchBufferSize()value to signal to use server maximum batch buffer size.- See Also:
- Constant Field Values
 
 - 
SERVER_DEFAULT_BUFFER_SIZEstatic final int SERVER_DEFAULT_BUFFER_SIZE batchBufferSize()value to signal to use server default batch buffer size.NOTE: all negative values signal this. If you want to use this constant to check against a value, use <= SERVER_DEFAULT_BUFFER_SIZE.- See Also:
- Constant Field Values
 
 
- 
 - 
Method Detail- 
multiErrorboolean multiError() Multi-error behaviour.- Returns:
- truerequest multi-error (continue on failure), or- falseto halt execution on first error
 
 - 
updateCountsboolean updateCounts() Report update counts per element (called "record counts" in Firebird).- Returns:
- truereport update counts,- falsedo not report update counts
 
 - 
detailedErrorsint detailedErrors() Number of detailed errors to return.A value of 0disables detailed errors. When a value< 0is returned, the server-side default is used (64 as of Firebird 4). Requesting detailed errors exceeding the maximum (256 as of Firebird 4) will be silently set to the server maximum.- Returns:
- number of detailed errors, 0to disable detailed errors,< 0for server default
 
 - 
batchBufferSizeint batchBufferSize() Server-side batch buffer size in bytes.When a value < 0is returned, the server-side default (16MB as of Firebird 4) will be used. When a value of0is returned , the server-side maximum will be used. Requesting buffer sizes exceeding the maximum (256MB as of Firebird 4) will be silently set to the server maximum.- Returns:
- maximum batch buffer size, return < 0to use server-side default (16MB as of Firebird 4),0for the server-side maximum (256MB as of Firebird 4)
 
 - 
immutabledefault FbBatchConfig immutable() - Returns:
- immutable, frozen copy of this batch config
 
 - 
ofstatic FbBatchConfig of(boolean multiError, boolean updateCounts, int detailedErrors, int batchBufferSize) Creates an immutable batch config.- Returns:
- an immutable batch config with the specified configuration
 
 - 
populateBatchParameterBufferdefault void populateBatchParameterBuffer(BatchParameterBuffer batchPb) Populates the provided batch parameter buffer with the configuration.This method will remove previously set items which are managed by this method. Items not managed by this method are untouched. At minimum this method manages items TAG_MULTIERROR,TAG_RECORD_COUNTS,TAG_DETAILED_ERRORS, andTAG_BUFFER_BYTES_SIZE.- Parameters:
- batchPb- batch parameter buffer to populate.
 
 
- 
 
-