org.universAAL.middleware.ui.rdf
Class ChoiceList

Package class diagram package ChoiceList
java.lang.Object
  extended by org.universAAL.middleware.rdf.Resource
      extended by org.universAAL.middleware.rdf.FinalizedResource
          extended by org.universAAL.middleware.ui.rdf.FormElement
              extended by org.universAAL.middleware.ui.rdf.Label
                  extended by org.universAAL.middleware.ui.rdf.ChoiceList

public class ChoiceList
extends Label

A special case of labels accepting other choice items and lists as its children and hence serving as an inner node in a hierarchy of possible choices. Selecting the label of a choice list must make its children accessible.

Author:
mtazari, Carsten Stockloew

Field Summary
static String MY_URI
           
static String PROP_CHILDREN
          Property for accessing the list of items and sublists contained in a choice list.
 
Fields inherited from class org.universAAL.middleware.ui.rdf.Label
PROP_ICON_URL
 
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
ChoiceList()
          For use by de-serializers only.
ChoiceList(String labelText, String iconURL)
          Constructs a new choice list.
 
Method Summary
 void addChild(ChoiceItem item)
          Adds an item to this choice list.
 void addChild(ChoiceList sublist)
          Adds a sublist to this choice list.
 Label[] getChildren()
          Returns the items and sublists contained in this choice list in the order of their addition to the list.
 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.
 
Methods inherited from class org.universAAL.middleware.ui.rdf.Label
getIconURL, getText, toString
 
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_CHILDREN

public static final String PROP_CHILDREN
Property for accessing the list of items and sublists contained in a choice list.

See Also:
Constant Field Values
Constructor Detail

ChoiceList

public ChoiceList()
For use by de-serializers only.


ChoiceList

public ChoiceList(String labelText,
                  String iconURL)
Constructs a new choice list.

Parameters:
labelText - see Label.Label(String, String)
iconURL - see Label.Label(String, String)
Method Detail

addChild

public void addChild(ChoiceItem item)
Adds an item to this choice list.

Parameters:
item - The item to be added to this choice list.

addChild

public void addChild(ChoiceList sublist)
Adds a sublist to this choice list.

Parameters:
sublist - The sublist to be added to this choice list.

getChildren

public Label[] getChildren()
Returns the items and sublists contained in this choice list in the order of their addition to the list.


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 Label
Returns:
true if the property changed as a result of the call
See Also:
Resource.setProperty(String, Object)


Copyright © 2014 universAAL Consortium. All Rights Reserved.