Package db
Class StringField
java.lang.Object
db.Field
db.StringField
- All Implemented Interfaces:
Comparable<Field>
StringField
provides a wrapper for variable length String data which is read or
written to a Record. Strings are always encoded as UTF-8.-
Nested Class Summary
Nested classes/interfaces inherited from class db.Field
Field.UnsupportedFieldException
-
Field Summary
Modifier and TypeFieldDescriptionstatic final StringField
static final StringField
Null string field valueFields inherited from class db.Field
EMPTY_ARRAY
-
Constructor Summary
ConstructorDescriptionConstruct a String field with an initial value of null.StringField
(String str) Construct a String field with an initial value of s. -
Method Summary
Modifier and TypeMethodDescriptionint
Compares this Field with another Field for order.Create new instance of this field with the same value.boolean
Determine if the specified Object is another Field which has the same type and value as this Field.byte[]
Get data as a byte array.Get field as a String value.Get field value as a formatted stringint
hashCode()
boolean
isNull()
Determine if the field has been set to a null-state or value.boolean
newField()
Create new instance of this field type.void
setBinaryData
(byte[] bytes) Set data from binary byte array.void
Set field's String value.toString()
Methods inherited from class db.Field
canIndex, getBooleanValue, getByteValue, getIntValue, getLongValue, getShortValue, isSameType, setBooleanValue, setByteValue, setIntValue, setLongValue, setShortValue
-
Field Details
-
NULL_VALUE
Null string field value -
INSTANCE
-
-
Constructor Details
-
StringField
public StringField()Construct a String field with an initial value of null. -
StringField
Construct a String field with an initial value of s.- Parameters:
str
- initial string value or null
-
-
Method Details
-
isNull
public boolean isNull()Description copied from class:Field
Determine if the field has been set to a null-state or value. -
getString
Description copied from class:Field
Get field as a String value. -
setString
Description copied from class:Field
Set field's String value. -
isVariableLength
public boolean isVariableLength()- Overrides:
isVariableLength
in classField
- Returns:
- true if a Field instance is variable length, else false.
-
toString
-
getValueAsString
Description copied from class:Field
Get field value as a formatted string- Specified by:
getValueAsString
in classField
- Returns:
- field value string
-
equals
Description copied from class:Field
Determine if the specified Object is another Field which has the same type and value as this Field. When comparing aPrimitiveField
, with a null state, a value of zero (0) is used. -
getBinaryData
public byte[] getBinaryData()Description copied from class:Field
Get data as a byte array.- Specified by:
getBinaryData
in classField
- Returns:
- byte[]
-
setBinaryData
public void setBinaryData(byte[] bytes) Description copied from class:Field
Set data from binary byte array. All variable-length fields must implement this method.- Specified by:
setBinaryData
in classField
- Parameters:
bytes
- field data
-
compareTo
Description copied from class:Field
Compares this Field with another Field for order. Returns a negative integer, zero, or a positive integer as this object is less than, equal to, or greater than the specified Field.
NOTE: Field objects do not fully comply with the Comparable interface. Only the same Field implementations may be compared. In addition, the null state is not considered when comparingPrimitiveField
s which have a zero (0) value.- Specified by:
compareTo
in interfaceComparable<Field>
- Specified by:
compareTo
in classField
- Parameters:
o
- another Field which is the same type as this Field- Returns:
- field comparison result (see
Comparable.compareTo(Object)
).
-
copyField
Description copied from class:Field
Create new instance of this field with the same value. -
newField
Description copied from class:Field
Create new instance of this field type. -
hashCode
public int hashCode()
-