org.universAAL.middleware.ui.rdf
Class Label

java.lang.Object
  org.universAAL.middleware.rdf.Resource
      org.universAAL.middleware.rdf.FinalizedResource
          org.universAAL.middleware.ui.rdf.FormElement
              org.universAAL.middleware.ui.rdf.Label

Direct Known Subclasses:

ChoiceItem, ChoiceList

public class Label
extends FormElement

The type of possible values for FormControl.PROP_CONTROL_LABEL. A label reveals the intent of the corresponding form control for human users primarily as a string. This string is stored using the standard property rdfs:label (see Resource.getResourceLabel() and Resource.setResourceLabel(String)).

Author:

mtazari, Carsten Stockloew

See Also:

RDFS specification

Field Summary

static String	MY_URI
static String	PROP_ICON_URL The URL of media objects that can be used as an audio / visual icon equivalent to the meaning borne by the text label.

Fields inherited from class org.universAAL.middleware.ui.rdf.FormElement

PROP_APPEARANCE

Fields inherited from class org.universAAL.middleware.rdf.Resource

ANON_URI_PREFIX, blockAddingTypes, isXMLLiteral, ns_delim_index, PROP_RDF_FIRST, PROP_RDF_REST, PROP_RDF_TYPE, PROP_RDFS_COMMENT, PROP_RDFS_LABEL, PROP_SERIALIZATION_FULL, PROP_SERIALIZATION_OPTIONAL, PROP_SERIALIZATION_REDUCED, PROP_SERIALIZATION_UNDEFINED, PROP_uAAL_INVOLVED_HUMAN_USER, props, RDF_EMPTY_LIST, RDF_NAMESPACE, RDFS_NAMESPACE, TYPE_RDF_LIST, TYPE_RDFS_CLASS, uAAL_NAMESPACE_PREFIX, uAAL_SERVICE_NAMESPACE, uAAL_VOCABULARY_NAMESPACE, uri

Constructor Summary

Label()
For use by de-serializers only.

Label(String labelText, String iconURL)
Constructs a new label.

Method Summary

String	getIconURL()
String	getText() Returns the label string.
boolean	setProperty(String propURI, Object value) Adds a statement with this resource as the subject, the given propURI as the predicate and the given value as the object.
String	toString() Overrides Resource.toString() in order to return the label string; only if this is an empty string, the default implementation is used.

Methods inherited from class org.universAAL.middleware.ui.rdf.FormElement

addAppearanceRecommendation, getAppearanceRecommendations

Methods inherited from class org.universAAL.middleware.rdf.FinalizedResource

addType, getLocalName, getNamespace, getProperty, getPropertyURIs, getType, getTypes, getURI, hasQualifiedName, isAnon, numberOfProperties

Methods inherited from class org.universAAL.middleware.rdf.Resource

addMultiLangProp, asList, asList, asRDFList, changeProperty, copy, deepCopy, equals, generateAnonURI, getDefaultLang, getFilename, getMultiLangProp, getOrConstructLabel, getPropSerializationType, getResource, getResourceComment, getResourceLabel, getStaticFieldValue, hashCode, hasProperty, isAnon, isBlockingAddingTypes, isClosedCollection, isQualifiedName, isWellFormed, literal, representsQualifiedURI, serializesAsXMLLiteral, setPropertyPath, setPropertyPath, setPropertyPathFromOffset, setResourceComment, setResourceLabel, toStringRecursive, toStringRecursive, unliteral

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

MY_URI

public static final String MY_URI

See Also:

Constant Field Values

PROP_ICON_URL

public static final String PROP_ICON_URL

The URL of media objects that can be used as an audio / visual icon equivalent to the meaning borne by the text label.

See Also:

Constant Field Values

Constructor Detail

Label

public Label()

For use by de-serializers only.

Label

public Label(String labelText,
             String iconURL)

Constructs a new label.

Parameters:

labelText - Mandatory string bearing the intent of the corresponding form control for human users and stored using the standard property rdfs:label.

iconURL - See PROP_ICON_URL; optional.

See Also:

RDFS specification

Method Detail

getIconURL

public String getIconURL()

See Also:

PROP_ICON_URL

getText

public String getText()

Returns the label string.

See Also:

Resource.getResourceLabel()

setProperty

public boolean setProperty(String propURI,
                           Object value)

Description copied from class: Resource

Adds a statement with this resource as the subject, the given propURI as the predicate and the given value as the object. Subclasses must override this in order to decide if the statement to be added fits the general class constraints. If not, the call of this method should be ignored. For each property only one single call may be made to this method, unless subsequent calls to this method for setting the value of the same property are treated as an update for an update-able property. Multi-valued properties must be set using an instance of List. The differentiation, if a such list should be treated as an rdf:List, can be made with the help of Resource.isClosedCollection(String). The default implementation here accepts all property-value pairs blindly except for rdf:type which is handled if the value is a type URI, a Resource or a java.util.List of them.

Note: The setting of the property rdf:type is being handled by this class via the final methods Resource.addType(String, boolean), Resource.getType(), and Resource.getTypes(). Although these methods give the view of handling type URIs as strings, but in reality the types are stored as direct instances of this class. So, the subclasses should ignore calls for setting rdf:type; if not, then the subclass must pay attention that the value should be a List of direct instances of this class so that (1) the Resource.toString() method returns just the URI and (2) the serializers get no problems with the value. Also, settings via subclasses may be overwritten by this class if a subsequent call to Resource.addType(String, boolean) is made.

Overrides:

setProperty in class Resource

Returns:

true if the property changed as a result of the call

See Also:

Resource.setProperty(String, Object)

toString

public String toString()

Overrides Resource.toString() in order to return the label string; only if this is an empty string, the default implementation is used.

Overrides:

toString in class Resource