package org.w3c.ddr.simple;
import org.w3c.ddr.simple.exception.NameException;
/**
* Represents a collection of PropertyValue instances.
*
* @author Jo Rabin (dotMobi)
* @author
Jose Manuel Cantera Fonseca (Telefonica I+D)
* @author
Rotan Hanrahan (MobileAware)
* @author
Ignacio Marin (Fundacion CTIC)
* Copyright
* © 2008 W3C®
* (MIT,
* ERCIM,
* Keio), All Rights Reserved.
* W3C liability,
* trademark
* and document use rules apply.
*
*/
public interface PropertyValues {
/**
* Obtain all of the PropertyValue instances as an array.
* The order of the array is implementation-specific.
*
* @return An array of PropertyValue instances, some of which may not have values.
*/
public PropertyValue[] getAll();
/**
* 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 {@link PropertyValue}.
*
* @param prop A non-null identifier of the PropertyValue to be returned.
* @return The identified PropertyValue.
* @throws org.w3c.ddr.simple.exception.NameException MUST be thrown if the prop parameter is null, or if the name data in the prop instance is invalid.
*/
public PropertyValue getValue(PropertyRef prop) throws NameException;
}