com.j256.ormlite.field.types

Class StringBytesType

java.lang.Object

com.j256.ormlite.field.BaseFieldConverter

com.j256.ormlite.field.types.BaseDataType

com.j256.ormlite.field.types.StringBytesType

All Implemented Interfaces:

DataPersister, FieldConverter

public class StringBytesType
extends BaseDataType

Type that persists a String as a byte array.

Author:

graywatson

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	StringBytesType(SqlType sqlType, Class<?>[] classes) Here for others to subclass.

Method Summary

Modifier and Type	Method and Description
Class<?>	getPrimaryClass() Return the class most associated with this persister or null if none.
static StringBytesType	getSingleton()
boolean	isArgumentHolderRequired() Must use ArgumentHolder when querying for values of this type.
Object	javaToSqlArg(FieldType fieldType, Object javaObject) Convert a Java object and return the appropriate argument to a SQL insert or update statement.
Object	parseDefaultString(FieldType fieldType, String defaultStr) Convert a default string object and return the appropriate argument to a SQL insert or update statement.
Object	resultStringToJava(FieldType fieldType, String stringValue, int columnPos) Convert a string result value to the related Java field.
Object	resultToSqlArg(FieldType fieldType, DatabaseResults results, int columnPos) Return the SQL argument object extracted from the results associated with column in position columnPos.
Object	sqlArgToJava(FieldType fieldType, Object sqlArg, int columnPos) Return the object converted from the SQL arg to java.

Methods inherited from class com.j256.ormlite.field.types.BaseDataType

convertIdNumber, dataIsEqual, generateId, getAssociatedClasses, getAssociatedClassNames, getDefaultWidth, getSqlOtherType, getSqlType, isAppropriateId, isComparable, isEscapedDefaultValue, isEscapedValue, isPrimitive, isSelfGeneratedId, isValidForField, isValidForVersion, isValidGeneratedType, moveToNextValue

Methods inherited from class com.j256.ormlite.field.BaseFieldConverter

isStreamType, makeConfigObject, resultToJava

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.j256.ormlite.field.FieldConverter

isStreamType, makeConfigObject, resultToJava

Constructor Detail

StringBytesType

protected StringBytesType(SqlType sqlType,
                          Class<?>[] classes)

Here for others to subclass.

Method Detail

getSingleton

public static StringBytesType getSingleton()

parseDefaultString

public Object parseDefaultString(FieldType fieldType,
                                 String defaultStr)
                          throws SQLException

Description copied from interface: FieldConverter

Convert a default string object and return the appropriate argument to a SQL insert or update statement.

Returns:

Result object to insert if the field is not specified or null if none.

Throws:

SQLException

resultToSqlArg

public Object resultToSqlArg(FieldType fieldType,
                             DatabaseResults results,
                             int columnPos)
                      throws SQLException

Description copied from interface: FieldConverter

Return the SQL argument object extracted from the results associated with column in position columnPos. For example, if the type is a date-long then this will return a long value or null.

Parameters:

fieldType - Associated FieldType which may be null.

Throws:

SQLException - If there is a problem accessing the results data.

sqlArgToJava

public Object sqlArgToJava(FieldType fieldType,
                           Object sqlArg,
                           int columnPos)
                    throws SQLException

Description copied from interface: FieldConverter

Return the object converted from the SQL arg to java. This takes the database representation and converts it into a Java object. For example, if the type is a date-long then this will take a long which is stored in the database and return a Date.

Specified by:

sqlArgToJava in interface FieldConverter

Overrides:

sqlArgToJava in class BaseFieldConverter

Parameters:

fieldType - Associated FieldType which may be null.

sqlArg - SQL argument converted with FieldConverter.resultToSqlArg(FieldType, DatabaseResults, int) which will not be null.

Throws:

SQLException - If there are problems with the conversion.

javaToSqlArg

public Object javaToSqlArg(FieldType fieldType,
                           Object javaObject)
                    throws SQLException

Description copied from interface: FieldConverter

Convert a Java object and return the appropriate argument to a SQL insert or update statement.

Specified by:

javaToSqlArg in interface FieldConverter

Overrides:

javaToSqlArg in class BaseFieldConverter

Throws:

SQLException - If there are problems with the conversion.

isArgumentHolderRequired

public boolean isArgumentHolderRequired()

Description copied from interface: DataPersister

Must use ArgumentHolder when querying for values of this type.

Specified by:

isArgumentHolderRequired in interface DataPersister

Overrides:

isArgumentHolderRequired in class BaseDataType

resultStringToJava

public Object resultStringToJava(FieldType fieldType,
                                 String stringValue,
                                 int columnPos)
                          throws SQLException

Description copied from interface: FieldConverter

Convert a string result value to the related Java field.

Specified by:

resultStringToJava in interface FieldConverter

Overrides:

resultStringToJava in class BaseDataType

Throws:

SQLException

getPrimaryClass

public Class<?> getPrimaryClass()

Description copied from interface: DataPersister

Return the class most associated with this persister or null if none.

Specified by:

getPrimaryClass in interface DataPersister

Overrides:

getPrimaryClass in class BaseDataType