org.licas.service.resource.info

Class InfoBinary

java.lang.Object

org.licas.service.resource.Resource

org.licas.service.resource.info.InfoBinary

public class InfoBinary
extends Resource

This is used by the InformationService to store any binary Object directly. It might be used particularly for binary files, for example.

Author:

Kieran Greer

Field Summary

Fields inherited from class org.licas.service.resource.Resource

dataType, INFOANYTYPE, INFOBINARYTYPE, INFOHTMLTYPE, INFOSTREAMXMLTYPE, INFOSTRINGTYPE, INFOTEXTTYPE, INFOURLTYPE, INFOXMLTYPE, LISTCONTAINERTYPE, QUERYCONTAINERTYPE, RANDOMCONTAINERTYPE, uuid

Constructor Summary

Constructors

Constructor and Description
InfoBinary(java.lang.String theDataType, org.licas_xml.abs.Element dataXml) Create a new instance of InfoBinary.

Method Summary

Modifier and Type	Method and Description
org.licas_xml.abs.Element	getInfo(org.licas_xml.abs.Element infoDescr) Get the currently loaded source information wrapped in an XML element.
java.lang.Object	getValue(org.licas_xml.abs.Element infoDescr) Get the value itself and not a wrapped description.
boolean	parseInfo(org.licas_xml.abs.Element dataXml) Parse the data description in the data description document to create the data object.

Methods inherited from class org.licas.service.resource.Resource

createResource, dataFromResourceType, getDataType, getUUID, parseValueElem, resourceTypeForDataType, setUUID, setUUID

Methods inherited from class java.lang.Object

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

Constructor Detail

InfoBinary

public InfoBinary(java.lang.String theDataType,
                  org.licas_xml.abs.Element dataXml)
           throws java.lang.Exception

Create a new instance of InfoBinary.

Parameters:

theDataType - the resource data type.

dataXml - a description of the initialisation parameters. Can be null.

Throws:

java.lang.Exception - any error.

Method Detail

parseInfo

public boolean parseInfo(org.licas_xml.abs.Element dataXml)
                  throws java.lang.Exception

Parse the data description in the data description document to create the data object. This version should read a file path. It can then either load in the contents or reference it dynamically.

Specified by:

parseInfo in class Resource

Parameters:

dataXml - the outermost element is not checked for, but might be a DATA or DATASET element. This should include a Const.VALUE element that stores a String-based file path description and possibly an ACTION element that can define if the data is stored in the resource or dynamically retrieved upon request through <Data><Value>file path</Value><Action>the action</Action></Data>. The action (AiConst.LOADREMOTE) stores the file path to dynamically retrieve the data upon request. Anything else, including no action, loads the data into the resource as binary contents.

Returns:

true if the file was successfully loaded, false otherwise.

Throws:

java.lang.Exception - any error.

getInfo

public org.licas_xml.abs.Element getInfo(org.licas_xml.abs.Element infoDescr)
                                  throws java.lang.Exception

Get the currently loaded source information wrapped in an XML element. This is still Base64 encoded.

Specified by:

getInfo in class Resource

Parameters:

infoDescr - a description of the info resource value that should be retrieved. Can be null as not used in this version.

Returns:

the value of the resource info as an XML element. This format is consistent with adding a Data element through an admin document. The binary data is stored as a ByteArray tokenised String and not a byte[]. It can be converted into a byte[] for display, by using the ByteArray toBytes method.

Throws:

java.lang.Exception - any error.

getValue

public java.lang.Object getValue(org.licas_xml.abs.Element infoDescr)
                          throws java.lang.Exception

Get the value itself and not a wrapped description. This is still Base64 encoded.

Specified by:

getValue in class Resource

Parameters:

infoDescr - a description of the info resource value that should be retrieved. Can be null as not used in this version.

Returns:

the info value.

Throws:

java.lang.Exception - any error.