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.
 void setValue(java.lang.Byte theValue)
          Set the value of this BooleanDataValue to the given Byte value
 void setValue(java.lang.Double theValue)
          Set the value of this BooleanDataValue to the given double value
 void setValue(java.lang.Float theValue)
          Set the value of this BooleanDataValue to the given float value
 void setValue(java.lang.Integer theValue)
          Set the value of this BooleanDataValue to the given int value
 void setValue(java.lang.Long theValue)
          Set the value of this BooleanDataValue to the given long value
 void setValue(java.lang.Short theValue)
          Set the value of this BooleanDataValue to the given short value
 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, getBigDecimal, 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, setInto, setInto, setObjectForCast, setToNull, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValueFromResultSet, typePrecedence
 
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

setValue

public void setValue(java.lang.Integer theValue)
Set the value of this BooleanDataValue to the given int value

Parameters:
theValue - The value to set this BooleanDataValue to
Returns:
This BooleanDataValue

setValue

public void setValue(java.lang.Double theValue)
Set the value of this BooleanDataValue to the given double value

Parameters:
theValue - The value to set this BooleanDataValue to
Returns:
This BooleanDataValue

setValue

public void setValue(java.lang.Float theValue)
Set the value of this BooleanDataValue to the given float value

Parameters:
theValue - The value to set this BooleanDataValue to
Returns:
This BooleanDataValue

setValue

public void setValue(java.lang.Short theValue)
Set the value of this BooleanDataValue to the given short value

Parameters:
theValue - The value to set this BooleanDataValue to
Returns:
This BooleanDataValue

setValue

public void setValue(java.lang.Long theValue)
Set the value of this BooleanDataValue to the given long value

Parameters:
theValue - The value to set this BooleanDataValue to
Returns:
This BooleanDataValue

setValue

public void setValue(java.lang.Byte theValue)
Set the value of this BooleanDataValue to the given Byte value

Parameters:
theValue - The value to set this BooleanDataValue to
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.


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