org.apache.derby.iapi.types
Interface BooleanDataValue

All Superinterfaces:
DataValueDescriptor, java.io.Externalizable, Formatable, Orderable, java.io.Serializable, Storable, TypedFormat
All Known Implementing Classes:
SQLBoolean

public interface BooleanDataValue
extends DataValueDescriptor


Field Summary
 
Fields inherited from interface org.apache.derby.iapi.types.Orderable
ORDER_OP_EQUALS, ORDER_OP_GREATEROREQUALS, ORDER_OP_GREATERTHAN, ORDER_OP_LESSOREQUALS, ORDER_OP_LESSTHAN
 
Method Summary
 BooleanDataValue and(BooleanDataValue otherValue)
          The SQL AND operator.
 boolean equals(boolean value)
          Tell whether a BooleanDataValue has the given value.
 boolean getBoolean()
          Gets the value in the data value descriptor as a boolean.
 BooleanDataValue is(BooleanDataValue otherValue)
          The SQL IS operator - consult any standard SQL reference for an explanation.
 BooleanDataValue isNot(BooleanDataValue otherValue)
          Implements NOT IS.
 BooleanDataValue or(BooleanDataValue otherValue)
          The SQL OR operator.
 void setValue(java.lang.Boolean theValue)
          Set the value of this BooleanDataValue.
 BooleanDataValue throwExceptionIfFalse(java.lang.String SQLState, java.lang.String tableName, java.lang.String constraintName)
          Throw an exception with the given SQLState if this BooleanDataValue is false.
 
Methods inherited from interface org.apache.derby.iapi.types.DataValueDescriptor
checkHostVariable, coalesce, compare, compare, equals, estimateMemoryUsage, getByte, getBytes, getClone, getDate, getDouble, getFloat, getInt, getLength, getLong, getNewNull, getObject, getShort, getStream, getString, getTime, getTimestamp, getTypeName, greaterOrEquals, greaterThan, in, isNotNull, isNullOp, lessOrEquals, lessThan, normalize, notEquals, readExternalFromArray, setBigDecimal, setInto, setInto, setObjectForCast, setToNull, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValueFromResultSet, typePrecedence, typeToBigDecimal
 
Methods inherited from interface org.apache.derby.iapi.services.io.Storable
isNull, restoreToNull
 
Methods inherited from interface java.io.Externalizable
readExternal, writeExternal
 
Methods inherited from interface org.apache.derby.iapi.services.io.TypedFormat
getTypeFormatId
 

Method Detail

getBoolean

public boolean getBoolean()
Description copied from interface: DataValueDescriptor
Gets the value in the data value descriptor as a boolean. Throws an exception if the data value is not a boolean. For DataValueDescriptor, this is the preferred interface for BIT, but for this no-casting interface, it isn't, because BIT is stored internally as a Bit, not as a Boolean.

Specified by:
getBoolean in interface DataValueDescriptor
Returns:
The data value as a boolean.

and

public BooleanDataValue and(BooleanDataValue otherValue)
The SQL AND operator. This provides SQL semantics for AND with unknown truth values - consult any standard SQL reference for an explanation.

Parameters:
otherValue - The other BooleanDataValue to AND with this one
Returns:
this AND otherValue

or

public BooleanDataValue or(BooleanDataValue otherValue)
The SQL OR operator. This provides SQL semantics for OR with unknown truth values - consult any standard SQL reference for an explanation.

Parameters:
otherValue - The other BooleanDataValue to OR with this one
Returns:
this OR otherValue

is

public BooleanDataValue is(BooleanDataValue otherValue)
The SQL IS operator - consult any standard SQL reference for an explanation. Implements the following truth table: otherValue | TRUE | FALSE | UNKNOWN this |---------------------------- | TRUE | TRUE | FALSE | FALSE FALSE | FALSE | TRUE | FALSE UNKNOWN | FALSE | FALSE | TRUE

Parameters:
otherValue - BooleanDataValue to compare to. May be TRUE, FALSE, or UNKNOWN.
Returns:
whether this IS otherValue

isNot

public BooleanDataValue isNot(BooleanDataValue otherValue)
Implements NOT IS. This reverses the sense of the is() call.

Parameters:
otherValue - BooleanDataValue to compare to. May be TRUE, FALSE, or UNKNOWN.
Returns:
NOT( this IS otherValue )

throwExceptionIfFalse

public BooleanDataValue throwExceptionIfFalse(java.lang.String SQLState,
                                              java.lang.String tableName,
                                              java.lang.String constraintName)
                                       throws StandardException
Throw an exception with the given SQLState if this BooleanDataValue is false. This method is useful for evaluating constraints.

Parameters:
SQLState - The SQLState of the exception to throw if this SQLBoolean is false.
tableName - The name of the table to include in the exception message.
constraintName - The name of the failed constraint to include in the exception message.
Returns:
this
Throws:
StandardException - Thrown if this BooleanDataValue is false.

setValue

public void setValue(java.lang.Boolean theValue)
Set the value of this BooleanDataValue.

Parameters:
theValue - Contains the boolean value to set this BooleanDataValue to. Null means set this BooleanDataValue to null.
Returns:
This BooleanDataValue

equals

public boolean equals(boolean value)
Tell whether a BooleanDataValue has the given value. This is useful for short-circuiting.

Parameters:
value - The value to look for
Returns:
true if the BooleanDataValue contains the given value.

Built on Tue 2006-10-10 19:23:47+0200, from revision exported

Apache Derby V10.1 Engine Documentation - Copyright © 1997,2005 The Apache Software Foundation or its licensors, as applicable.