upnphostingservice.java

国外的j2me播放器软件

package no.auc.one.portableplayer.communication.upnphosting;

import java.util.Hashtable;

public interface UPnPHostingService {
    /**
     * Major version of the UPnP Device Architecture supported.
     *
     * @return Major version
     */
    byte specVersionMajor();

    /**
     * Minor version of the UPnP Device Architecture supported.
     *
     * @return Minor version
     */
    byte specVersionMinor();

    /**
     * UPnP service type.
     *
     * Must not contain a hash character (#, 23 Hex in UTF-8). For standard 
     * service types defined by a UPnP Forum working committee, must begin 
     * with urn:schemas-upnp-org:service: followed by a service type suffix, 
     * colon, and an integer service version (as shown in the listing above). 
     * 
     * For non-standard service types specified by UPnP vendors, must begin 
     * with urn:, followed by an ICANN domain name owned by the vendor, 
     * followed by :service:, followed by a service type suffix, colon, and 
     * an integer service version, i.e., 
     * urn:domain-name:service:serviceType:v. 
     *
     * The service type suffix defined by a UPnP Forum working committee or 
     * specified by a UPnP vendor must be <= 64 characters, not counting 
     * the version suffix and separating colon. Single URI.
     */
    String serviceType();

    /**
     * Service identifier.
     *
     * Must be unique within this device description.
     *
     * For standard services defined by a UPnP Forum working committee, must 
     * begin with urn:upnp-org:serviceId: followed by a service ID suffix 
     * (as shown in the listing above). (Note that upnp-org is used instead 
     * of schemas-upnp-org in this case because an XML schema is not defined 
     * for each service ID.) 
     *
     * For non-standard services specified by UPnP vendors, must begin with 
     * urn:, followed by an ICANN domain name owned by the vendor, followed 
     * by :serviceId:, followed by a service ID suffix, i.e., 
     * urn:domain-name:serviceId:serviceID. 
     * 
     * The service ID suffix defined by a UPnP Forum working committee or 
     * specified by a UPnP vendor must be <= 64 characters. Single URI. 
     */
    String serviceId();

    /**
     * List of actions of this service.
     *
     * Required if and only if the service has actions. (Each service may have >= 0 actions.).
     *
     * @return A hashtable with keys = action name and values = actions. If 
     *         the service contains no actions then this method must return 
     *         null.
     */
    Hashtable actionTable();

    /**
     * List of state variables of this service.
     *
     * Each service must have > 0 state variables.
     */
    UPnPStateVariable[] stateVariableList();
}