upnppresenceadvertisementhandler.java

国外的j2me播放器软件

package no.auc.one.portableplayer.communication;

/**
 * Implementations of this interface are used together with the 
 * UPnPPresenceAdvertisementHandling class to handle a specific UPnP device.
 *
 * The kind of device(s) handled are based on the NT header value.
 */
public interface UPnPPresenceAdvertisementHandler {
    /**
     * This method is called when a new UPnP device with the same NT value 
     * supported by an implementation of this class becomes available 
     * (ssdp:alive).
     *
     * @param pi Information about the device available
     */
    public void deviceAvailable(UPnPPresenceInformation pi);

    /**
     * This method is called when a new UPnP device with the same NT value 
     * supported by an implementation of this class becomes unavailable 
     * (ssdp:bye-bye).
     *
     * @param pi Information about the device available
     */
    public void deviceUnavailable(UPnPPresenceInformation pi);
    
    /**
     * Tells which kind of NT value this implementation can handle.
     * 
     * @return Value of NT handled.
     */
    public String getHandledNT();
}