org.w3c.ddr.simple
Interface PropertyValues

public interface PropertyValues

Represents a collection of PropertyValue instances.

Author:

Jo Rabin (dotMobi),
Jose Manuel Cantera Fonseca (Telefonica I+D),
Rotan Hanrahan (MobileAware),
Ignacio Marin (Fundacion CTIC)
Copyright © 2008 W3C^® (MIT, ERCIM, Keio), All Rights Reserved.
W3C liability, trademark and document use rules apply.

Method Summary

PropertyValue[]	getAll() Obtain all of the PropertyValue instances as an array.
PropertyValue	getValue(PropertyRef prop) Obtain an identified PropertyValue instance from the collection, using a PropertyRef as the identifier.

Method Detail

getAll

PropertyValue[] getAll()

Obtain all of the PropertyValue instances as an array. The order of the array is implementation-specific.

Returns:

An array of PropertyValue instances, some of which may not have values.

getValue

PropertyValue getValue(PropertyRef prop)
                       throws NameException

Obtain an identified PropertyValue instance from the collection, using a PropertyRef as the identifier. It is not guaranteed that the returned PropertyValue will have a usable value associated with it. To test if a usable value is available, use the exists() method of PropertyValue.

Parameters:

prop - A non-null identifier of the PropertyValue to be returned.

Returns:

The identified PropertyValue.

Throws:

NameException - MUST be thrown if the prop parameter is null, or if the name data in the prop instance is invalid.