org.javarosa.core.model.data

Class UncastData

java.lang.Object

org.javarosa.core.model.data.UncastData

All Implemented Interfaces:

IAnswerData, Externalizable

public class UncastData
extends Object
implements IAnswerData

Uncast data values are those which are not assigned a particular data type. This is relevant when data is read before a datatype is available, or when it must be pulled from external instances. In general, Uncast data should be used when a value is available in string form, and no adequate assumption can be made about the type of data being represented. This is preferable to making the assumption that data is a StringData object, since that will cause issues when select choices or other typed values are expected.

Author:

ctsims

Constructor Summary

Constructors

Constructor and Description
UncastData()
UncastData(String value)

Method Summary

Modifier and Type	Method and Description
UncastData	cast(UncastData data) Casts the provided data into this data type.
IAnswerData	clone()
String	getDisplayText()
String	getString()
Object	getValue()
void	readExternal(DataInputStream in, PrototypeFactory pf)
void	setValue(Object o)
UncastData	uncast() Data types can be uncast if they are expected to be used in different contexts.
void	writeExternal(DataOutputStream out)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.javarosa.core.model.data.IAnswerData

wrapData

Constructor Detail

UncastData

public UncastData()

UncastData

public UncastData(String value)

Method Detail

clone

public IAnswerData clone()

Specified by:

clone in interface IAnswerData

Overrides:

clone in class Object

getDisplayText

public String getDisplayText()

Specified by:

getDisplayText in interface IAnswerData

Returns:

Gets a string representation of this answer

getValue

@NotNull
public Object getValue()

Specified by:

getValue in interface IAnswerData

Returns:

The value of this answer, will never be null

setValue

public void setValue(Object o)

Specified by:

setValue in interface IAnswerData

Parameters:

o - the value of this answerdata object. Cannot be null. Null Data will not overwrite existing values.

getString

public String getString()

Returns:

The string representation of this data. This value should be castable into its appropriate data type.

readExternal

public void readExternal(DataInputStream in,
                         PrototypeFactory pf)
                  throws IOException

Specified by:

readExternal in interface Externalizable

Throws:

IOException

writeExternal

public void writeExternal(DataOutputStream out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

uncast

public UncastData uncast()

Description copied from interface: IAnswerData

Data types can be uncast if they are expected to be used in different contexts. This allows, for instance, select values to be generated by casting other types or vic-a-versa.

Specified by:

uncast in interface IAnswerData

Returns:

An uncast representation of this answer which can be used in a different context.

cast

public UncastData cast(UncastData data)

Description copied from interface: IAnswerData

Casts the provided data into this data type.

Specified by:

cast in interface IAnswerData

Parameters:

data - An uncast data value which is compatible with this data type

Returns:

An instance of the instance's data type which contains that value