com.ibm.able.data
Class AbleBooleanVariable

java.lang.Object
  com.ibm.able.data.AbleLhs
      com.ibm.able.data.AbleVariable
          com.ibm.able.data.AbleTypedVariable
              com.ibm.able.data.AbleBooleanVariable

All Implemented Interfaces:

AbleClearable, AbleRd, AbleWr, java.io.Serializable

public class AbleBooleanVariable

extends AbleTypedVariable

implements java.io.Serializable

This class wraps a value of the primitive type boolean in an object. An object of type AbleBooleanVariable contains a single, mutable field whose type is boolean. Instances of AbleBooleanVariable are used by the Able rules classes in clauses and expressions. In addition, this class provides methods for converting a boolean to other datatypes, setting a boolean value using other datatypes, as well as other logical comparison and math operator methods useful when dealing with a boolean.

See Also:

Serialized Form

Field Summary

protected boolean

myValue The current value of the variable.

Fields inherited from class com.ibm.able.data.AbleTypedVariable

myDataTypeClass, myDataTypeClassName, myDataTypeName, myInitialParms

Fields inherited from class com.ibm.able.data.AbleVariable

myBoundFlag, myChgSupport, myComment, myContext, myDataType, myGlobalFlag, myId, myName, myPrompt, myReferences, myStaticFlag, myTemplateFlag, myValueInitial

Constructor Summary

AbleBooleanVariable(java.lang.String theName, boolean theInitialValue)
Create a new boolean variable with the specified initial value.

AbleBooleanVariable(java.lang.String theName, boolean theStaticFlag, boolean theGlobalFlag)
Create a new boolean variable with a null (unbound) initial value.

AbleBooleanVariable(java.lang.String theName, boolean theStaticFlag, boolean theGlobalFlag, boolean theInitialValue)
Create a new boolean variable with the specified initial value.

Method Summary

java.lang.String	arlDclString() Return a formal ARL "declaration" string that describes this data object.
java.lang.String	armlDclString() Return a formal XML "declaration" string that describes this data object.
void	asgnEq(AbleRd theRhs) Assignment: assign the current value of theRhs to this data object.
AbleLiteral	bitwiseXOR(AbleRd theRhs) Logical XOR: exclusive OR the current value of this data object with the current value of theRhs.
boolean	cmpEq(AbleRd theRhs) Comparison, equal to: compare the current value of this data object to the current value of theRhs.
boolean	cmpNeq(AbleRd theRhs) Comparison, not equal to: compare the current value of this data object to the current value of theRhs.
boolean	getBooleanValue() Retrieve the value of this data object as a boolean value.
java.lang.Class	getDataTypeClass() Retrieve the actual class of this object's underlying data type.
java.lang.String	getDataTypeClassName() Retrieve the name of the class of this object's underlying data type.
java.lang.String	getDataTypeName() Retrieve the data type name.
AbleFuzzySet	getFuzzyValue() Retrieve the value of this data object as a fuzzy value.
java.lang.Object	getGenericValue() Retrieve the value of this data object as an Object.
java.lang.Class	getLiteralClass() Retrieve the class of this variable's related AbleLiteral data type.
double	getNumericValue() Retrieve the value of this data object as a numeric value.
java.lang.String	getStringValue() Retrieve the value of this data object as a string value.
AbleLiteral	getValue() Retrieve the value of this data object as a literal.
java.lang.String	getValueString() Retrieve the variable's current value as a string.
void	init() Init the variable to its initial state.
boolean	logicalAND(AbleRd theRhs) Logical AND the current value of this data object with the current value of theRhs.
boolean	logicalNOT(AbleRd theRhs) Logical NOT: complement the current value of this data object.
boolean	logicalOR(AbleRd theRhs) Logical OR the current value of this data object with the current value of theRhs.
void	reset() Reset the variable to its initial state.
void	setBooleanValue(boolean theNewValue) Set the value of this data object from a boolean value.
void	setFuzzyValue(AbleFuzzySet theNewValue) Set the value of this data object from a fuzzy value.
void	setGenericValue(java.lang.Object theNewValue) Set the value of this data object from an object.
void	setNumericValue(double theNewValue) Set the value of this data object from a numeric value.
void	setStringValue(java.lang.String theNewValue) Set the value of this data object from a string value.
void	setValue(AbleLiteral theNewValue) Set the value of this data object from a literal object.
void	setValueString(java.lang.String theNewValue) Set the variable's current value from a string.
java.lang.String	toString() Retrieve a string describing (the contents of) the object.
java.lang.String	traceString(int theTraceStringFlavor) Retrieve a string describing (the contents of) the object.
java.lang.String	xmlDclString() Return a formal XML "declaration" string that describes this data object.

Methods inherited from class com.ibm.able.data.AbleTypedVariable

clear, cmpGt, cmpGtEq, cmpIs, cmpLt, cmpLtEq, compDivide, compMinus, compMultiply, compPlus, compUnaryMinus, replaceValues

Methods inherited from class com.ibm.able.data.AbleVariable

arlCRdString, arlInitializerString, armlCRdString, armlInitializerString, getArlComment, getChgSupport, getComment, getContext, getDataType, getDataTypeAsString, getId, getName, getPrompt, getPromptString, getReferences, getReferent, getReferents, getTemplateString, isBound, isConstant, isGlobal, isLocal, isStatic, isTemplate, notStatic, setChgSupport, setComment, setContext, setId, setInitialValue, setPrompt, setReferences, setStatic, setTemplate, xmlCRdString, xmlCWrString, xmlInitializerString

Methods inherited from class com.ibm.able.data.AbleLhs

asgnIs, asgnIs, bitwiseAND, bitwiseNOT, bitwiseOR, bitwiseShiftLeft, bitwiseShiftRight, bitwiseShiftRightZeroFill, compModulo

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

myValue

protected boolean myValue

The current value of the variable.

Constructor Detail

AbleBooleanVariable

public AbleBooleanVariable(java.lang.String theName,
                           boolean theInitialValue)

Create a new boolean variable with the specified initial value.

Parameters:

theName - The unique name of the variable.

theInitialValue - The value to which this variable is initially set.

AbleBooleanVariable

public AbleBooleanVariable(java.lang.String theName,
                           boolean theStaticFlag,
                           boolean theGlobalFlag,
                           boolean theInitialValue)

Create a new boolean variable with the specified initial value.

Parameters:

theName - The unique name of the variable.

theStaticFlag - Use true if this variable is to be marked as static, which means that it will ignore future reset requests; use false if the variable can be reset to its initial value when requested.

theGlobalFlag - Use true if this variable is to be considered global; use false if the variable is to be considered local.

theInitialValue - The value to which this variable is initially set.

AbleBooleanVariable

public AbleBooleanVariable(java.lang.String theName,
                           boolean theStaticFlag,
                           boolean theGlobalFlag)

Create a new boolean variable with a null (unbound) initial value. Note: A false value will be returned if the value of this variable is not explicitly set during inferencing.

Parameters:

theName - The unique name of the variable.

theStaticFlag - Use true if this variable is to be marked as static, which means that it will ignore future reset requests; use false if the variable can be reset to its initial value when requested.

theGlobalFlag - Use true if this variable is to be considered global; use false if the variable is to be considered local.

Method Detail

getBooleanValue

public boolean getBooleanValue()
                        throws AbleDataException

Retrieve the value of this data object as a boolean value.

Specified by:

getBooleanValue in interface AbleRd

Overrides:

getBooleanValue in class AbleTypedVariable

Returns:

A boolean, if the value of this object can be represented as a boolean value.

Throws:

AbleDataException - If the value of this object cannot be represented as a boolean value.

getFuzzyValue

public AbleFuzzySet getFuzzyValue()
                           throws AbleDataException

Retrieve the value of this data object as a fuzzy value.

Specified by:

getFuzzyValue in interface AbleRd

Overrides:

getFuzzyValue in class AbleTypedVariable

Returns:

A fuzzy set, if the value of this object can be represented as a fuzzy value. This method always throws an exception.

Throws:

AbleDataException - If the value of this object cannot be represented as a fuzzy value.

getGenericValue

public java.lang.Object getGenericValue()
                                 throws AbleDataException

Retrieve the value of this data object as an Object.

Specified by:

getGenericValue in interface AbleRd

Overrides:

getGenericValue in class AbleTypedVariable

Returns:

A Boolean object.

Throws:

AbleDataException - If the value of this object cannot be represented as an Object.

getNumericValue

public double getNumericValue()
                       throws AbleDataException

Retrieve the value of this data object as a numeric value.

Specified by:

getNumericValue in interface AbleRd

Overrides:

getNumericValue in class AbleTypedVariable

Returns:

A double, if the value of this object can be represented as a numeric value. If the current value is true, 1.0 is returned; otherwise 0.0 is returned.

Throws:

AbleDataException - If the value of this object cannot be represented as a numeric value.

getStringValue

public java.lang.String getStringValue()
                                throws AbleDataException

Retrieve the value of this data object as a string value.

Specified by:

getStringValue in interface AbleRd

Overrides:

getStringValue in class AbleTypedVariable

Returns:

A String, if the value of this object can be represented as a string value. If the current value is true, "True" is returned; otherwise "False" is returned.

Throws:

AbleDataException - If the value of this object cannot be represented as a string value.

getValue

public AbleLiteral getValue()
                     throws AbleDataException

Retrieve the value of this data object as a literal.

Specified by:

getValue in interface AbleRd

Overrides:

getValue in class AbleTypedVariable

Returns:

An AbleBooleanLiteral object.

Throws:

AbleDataException - If the value of this object cannot be represented as a literal.

asgnEq

public void asgnEq(AbleRd theRhs)
            throws AbleDataException

Assignment: assign the current value of theRhs to this data object.

Specified by:

asgnEq in interface AbleWr

Overrides:

asgnEq in class AbleTypedVariable

Parameters:

theRhs - The right-hand, or source, side of the assignment.

Throws:

AbleDataException - If the right-hand side cannot be converted (if necessary) and assigned to this data object.

cmpEq

public boolean cmpEq(AbleRd theRhs)
              throws AbleDataException

Comparison, equal to: compare the current value of this data object to the current value of theRhs.

"==" is used for numeric and boolean compares; equals() is used for Object compares; and Collator.equals() is used for String compares.

Specified by:

cmpEq in interface AbleRd

Overrides:

cmpEq in class AbleTypedVariable

Parameters:

theRhs - The right-hand side of the comparison.

Returns:

true, if this data object is equal to theRhs; false, otherwise.

Throws:

AbleDataException - If the right-hand side cannot be converted (if necessary) and compared to this data object.

cmpNeq

public boolean cmpNeq(AbleRd theRhs)
               throws AbleDataException

Comparison, not equal to: compare the current value of this data object to the current value of theRhs.

"!=" is used for numeric and boolean compares; ! equals() is used for Object compares; and ! Collator.equals() is used for String compares.

Specified by:

cmpNeq in interface AbleRd

Overrides:

cmpNeq in class AbleTypedVariable

Parameters:

theRhs - The right-hand side of the comparison.

Returns:

true, if this data object is not equal to theRhs; false, otherwise.

Throws:

AbleDataException - If the right-hand side cannot be converted (if necessary) and compared to this data object.

logicalAND

public boolean logicalAND(AbleRd theRhs)
                   throws AbleDataException

Logical AND the current value of this data object with the current value of theRhs.

"&&" is used for boolean AND.

Specified by:

logicalAND in interface AbleRd

Overrides:

logicalAND in class AbleLhs

Parameters:

theRhs - The right-hand side of the comparison.

Returns:

The result of the logical AND operation.

Throws:

AbleDataException - If the right-hand side cannot be converted (if necessary) and compared to this data object.

logicalOR

public boolean logicalOR(AbleRd theRhs)
                  throws AbleDataException

Logical OR the current value of this data object with the current value of theRhs.

"||" is used for boolean OR.

Specified by:

logicalOR in interface AbleRd

Overrides:

logicalOR in class AbleLhs

Parameters:

theRhs - The right-hand side of the comparison.

Returns:

The result of the logical OR operation.

Throws:

AbleDataException - If the right-hand side cannot be converted (if necessary) and compared to this data object.

logicalNOT

public boolean logicalNOT(AbleRd theRhs)
                   throws AbleDataException

Logical NOT: complement the current value of this data object.

"!" is used for boolean NOT.

Specified by:

logicalNOT in interface AbleRd

Overrides:

logicalNOT in class AbleLhs

Parameters:

theRhs - The right-hand side of the comparison.

Returns:

The result of the boolean NOT operation.

Throws:

AbleDataException - If the right-hand side cannot be converted (if necessary) and compared to this data object.

bitwiseXOR

public AbleLiteral bitwiseXOR(AbleRd theRhs)
                       throws AbleDataException

Logical XOR: exclusive OR the current value of this data object with the current value of theRhs.

"^" is used for bitwise or logical XOR.

Specified by:

bitwiseXOR in interface AbleRd

Overrides:

bitwiseXOR in class AbleLhs

Parameters:

theRhs - The right-hand side of the operation.

Returns:

The result of the logical XOR operation.

Throws:

AbleDataException - If the right-hand side cannot be converted (if necessary) and compared to this data object.

setBooleanValue

public void setBooleanValue(boolean theNewValue)
                     throws AbleDataException

Set the value of this data object from a boolean value.

Specified by:

setBooleanValue in interface AbleWr

Overrides:

setBooleanValue in class AbleTypedVariable

Parameters:

theNewValue - A boolean value.

Throws:

AbleDataException - If the value of this object cannot be represented as a boolean value.

setFuzzyValue

public void setFuzzyValue(AbleFuzzySet theNewValue)
                   throws AbleDataException

Set the value of this data object from a fuzzy value. This method always throws an exception.

Specified by:

setFuzzyValue in interface AbleWr

Overrides:

setFuzzyValue in class AbleTypedVariable

Parameters:

theNewValue - A fuzzy set.

Throws:

AbleDataException - If the value of this object cannot be represented as a fuzzy value.

setGenericValue

public void setGenericValue(java.lang.Object theNewValue)
                     throws AbleDataException

Set the value of this data object from an object.

Specified by:

setGenericValue in interface AbleWr

Overrides:

setGenericValue in class AbleTypedVariable

Parameters:

theNewValue - Any type of Object.

Throws:

AbleDataException - If the value of this object cannot be derived from the specified Object.

setNumericValue

public void setNumericValue(double theNewValue)
                     throws AbleDataException

Set the value of this data object from a numeric value.

Specified by:

setNumericValue in interface AbleWr

Overrides:

setNumericValue in class AbleTypedVariable

Parameters:

theNewValue - Any number. If the number is 0.0, the variable is set to false; any other number sets the variable to true.

Throws:

AbleDataException - If the value of this object cannot be represented as a numeric value.

setStringValue

public void setStringValue(java.lang.String theNewValue)
                    throws AbleDataException

Set the value of this data object from a string value.

Specified by:

setStringValue in interface AbleWr

Overrides:

setStringValue in class AbleTypedVariable

Parameters:

theNewValue - A string. If the string is "true" (case insensitive), the variable is set to true; if the string is "false", the variable is set to false; any other string causes an exception.

Throws:

AbleDataException - If the value of this object cannot be represented as a string value.

setValue

public void setValue(AbleLiteral theNewValue)
              throws AbleDataException

Set the value of this data object from a literal object.

Specified by:

setValue in interface AbleWr

Overrides:

setValue in class AbleTypedVariable

Parameters:

theNewValue - An Able literal of any type. An attempt is made to convert the literal to an appropriate type before assigning it to this "writable" object.

Throws:

AbleDataException - If the value of this object cannot be determined from the literal object.

arlDclString

public java.lang.String arlDclString()

Return a formal ARL "declaration" string that describes this data object.

Specified by:

arlDclString in interface AbleWr

Overrides:

arlDclString in class AbleTypedVariable

Returns:

A String describing the data object in formal rule language.

xmlDclString

public java.lang.String xmlDclString()

Return a formal XML "declaration" string that describes this data object.

Specified by:

xmlDclString in interface AbleWr

Overrides:

xmlDclString in class AbleTypedVariable

Returns:

A String describing the data object in XML.

armlDclString

public java.lang.String armlDclString()

Return a formal XML "declaration" string that describes this data object.

Overrides:

armlDclString in class AbleTypedVariable

Returns:

A String describing the data object in XML.

setValueString

public void setValueString(java.lang.String theNewValue)
                    throws AbleDataException

Set the variable's current value from a string. Note: This method is provided for the use of a rule language parser.

Overrides:

setValueString in class AbleTypedVariable

Throws:

AbleDataException

getValueString

public java.lang.String getValueString()

Retrieve the variable's current value as a string. Note: This method is provided for the use of a rule language parser.

Overrides:

getValueString in class AbleTypedVariable

reset

public void reset()
           throws AbleDataException

Reset the variable to its initial state.

Overrides:

reset in class AbleTypedVariable

Throws:

AbleDataException

init

public void init()
          throws AbleDataException

Init the variable to its initial state.

Overrides:

init in class AbleTypedVariable

Throws:

AbleDataException

getDataTypeClass

public java.lang.Class getDataTypeClass()

Description copied from class: AbleLhs

Retrieve the actual class of this object's underlying data type.

Specified by:

getDataTypeClass in interface AbleRd

Overrides:

getDataTypeClass in class AbleTypedVariable

getDataTypeClassName

public java.lang.String getDataTypeClassName()

Description copied from class: AbleLhs

Retrieve the name of the class of this object's underlying data type.

Specified by:

getDataTypeClassName in interface AbleRd

Overrides:

getDataTypeClassName in class AbleTypedVariable

getDataTypeName

public java.lang.String getDataTypeName()

Retrieve the data type name. This is the name used in the ABLE Rule Set, for example, Integer, Customer, etc.

Overrides:

getDataTypeName in class AbleTypedVariable

getLiteralClass

public java.lang.Class getLiteralClass()

Retrieve the class of this variable's related AbleLiteral data type.

Overrides:

getLiteralClass in class AbleTypedVariable

Returns:

The class of the literal data type.

toString

public java.lang.String toString()

Retrieve a string describing (the contents of) the object.

Overrides:

toString in class AbleTypedVariable

Returns:

A String containing the current contents of the object.

traceString

public java.lang.String traceString(int theTraceStringFlavor)

Retrieve a string describing (the contents of) the object.

Specified by:

traceString in interface AbleRd

Overrides:

traceString in class AbleTypedVariable

Parameters:

theTraceStringFlavor - An Able.TraceStringFlavor value.

Returns:

A String containing the current contents of the object.