You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
299 lines
9.3 KiB
299 lines
9.3 KiB
/*
|
|
* ============================================================================
|
|
* The Apache Software License, Version 1.1
|
|
* ============================================================================
|
|
*
|
|
* Copyright (C) 2002 The Apache Software Foundation. All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without modifica-
|
|
* tion, are permitted provided that the following conditions are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
*
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
*
|
|
* 3. The end-user documentation included with the redistribution, if any, must
|
|
* include the following acknowledgment: "This product includes software
|
|
* developed by SuperBonBon Industries (http://www.sbbi.net/)."
|
|
* Alternately, this acknowledgment may appear in the software itself, if
|
|
* and wherever such third-party acknowledgments normally appear.
|
|
*
|
|
* 4. The names "UPNPLib" and "SuperBonBon Industries" must not be
|
|
* used to endorse or promote products derived from this software without
|
|
* prior written permission. For written permission, please contact
|
|
* info@sbbi.net.
|
|
*
|
|
* 5. Products derived from this software may not be called
|
|
* "SuperBonBon Industries", nor may "SBBI" appear in their name,
|
|
* without prior written permission of SuperBonBon Industries.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
|
|
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
|
|
* FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
* APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
|
|
* INDIRECT,INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU-
|
|
* DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
|
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
|
|
* ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
* This software consists of voluntary contributions made by many individuals
|
|
* on behalf of SuperBonBon Industries. For more information on
|
|
* SuperBonBon Industries, please see <http://www.sbbi.net/>.
|
|
*/
|
|
package net.sbbi.upnp.devices;
|
|
|
|
import net.sbbi.upnp.services.*;
|
|
|
|
import java.util.*;
|
|
import java.net.*;
|
|
|
|
import org.apache.commons.logging.Log;
|
|
import org.apache.commons.logging.LogFactory;
|
|
|
|
/**
|
|
* This class represents an UPNP device, this device contains a set of services
|
|
* that will be needed to access the device functionalities.
|
|
* @author <a href="mailto:superbonbon@sbbi.net">SuperBonBon</a>
|
|
* @version 1.0
|
|
*/
|
|
@SuppressWarnings("unchecked")
|
|
public class UPNPDevice {
|
|
|
|
private final static Log log = LogFactory.getLog( UPNPDevice.class );
|
|
|
|
protected String deviceType;
|
|
protected String friendlyName;
|
|
protected String manufacturer;
|
|
protected URL manufacturerURL;
|
|
protected URL presentationURL;
|
|
protected String modelDescription;
|
|
protected String modelName;
|
|
protected String modelNumber;
|
|
protected String modelURL;
|
|
protected String serialNumber;
|
|
protected String UDN;
|
|
protected String USN;
|
|
protected long UPC;
|
|
|
|
protected List deviceIcons;
|
|
protected List services;
|
|
protected List childDevices;
|
|
|
|
protected UPNPDevice parent;
|
|
|
|
public URL getManufacturerURL() {
|
|
return manufacturerURL;
|
|
}
|
|
|
|
/**
|
|
* Presentation URL
|
|
* @return URL the presenation URL, or null if the device does not provide
|
|
* such information
|
|
*/
|
|
public URL getPresentationURL() {
|
|
return presentationURL;
|
|
}
|
|
|
|
public String getModelDescription() {
|
|
return modelDescription;
|
|
}
|
|
|
|
public String getModelName() {
|
|
return modelName;
|
|
}
|
|
|
|
public String getModelNumber() {
|
|
return modelNumber;
|
|
}
|
|
|
|
public String getModelURL() {
|
|
return modelURL;
|
|
}
|
|
|
|
public String getSerialNumber() {
|
|
return serialNumber;
|
|
}
|
|
|
|
public String getUDN() {
|
|
return UDN;
|
|
}
|
|
|
|
public String getUSN(){
|
|
return USN;
|
|
}
|
|
|
|
public long getUPC() {
|
|
return UPC;
|
|
}
|
|
|
|
public String getDeviceType() {
|
|
return deviceType;
|
|
}
|
|
|
|
public String getFriendlyName() {
|
|
return friendlyName;
|
|
}
|
|
|
|
public String getManufacturer() {
|
|
return manufacturer;
|
|
}
|
|
|
|
public boolean isRootDevice() {
|
|
return this instanceof UPNPRootDevice;
|
|
}
|
|
|
|
/**
|
|
* Access to the device icons definitions
|
|
* @return a list containing DeviceIcon objects or null if no icons defined
|
|
*/
|
|
public List getDeviceIcons() {
|
|
return deviceIcons;
|
|
}
|
|
|
|
/**
|
|
* Generates a list of all the child ( not only top level, full childrens hierarchy included )
|
|
* UPNPDevice objects for this device.
|
|
* @return the generated list or null if no child devices bound
|
|
*/
|
|
public List getChildDevices() {
|
|
if ( childDevices == null ) return null;
|
|
List rtrVal = new ArrayList();
|
|
for ( Iterator itr = childDevices.iterator(); itr.hasNext(); ) {
|
|
UPNPDevice device = (UPNPDevice)itr.next();
|
|
rtrVal.add( device );
|
|
List found = device.getChildDevices();
|
|
if ( found != null ) {
|
|
rtrVal.addAll( found );
|
|
}
|
|
}
|
|
return rtrVal;
|
|
|
|
}
|
|
|
|
/**
|
|
* Generates a list of all the child ( only top level )
|
|
* UPNPDevice objects for this device.
|
|
* @return the generated list or null if no child devices bound
|
|
*/
|
|
public List getTopLevelChildDevices() {
|
|
if ( childDevices == null ) return null;
|
|
List rtrVal = new ArrayList();
|
|
for ( Iterator itr = childDevices.iterator(); itr.hasNext(); ) {
|
|
UPNPDevice device = (UPNPDevice)itr.next();
|
|
rtrVal.add( device );
|
|
}
|
|
return rtrVal;
|
|
}
|
|
|
|
/**
|
|
* Return the parent UPNPDevice, null if the device is an UPNPRootDevice
|
|
* @return the parent device instance
|
|
*/
|
|
public UPNPDevice getDirectParent() {
|
|
return parent;
|
|
}
|
|
|
|
/**
|
|
* Looks for a child UPNP device definition file,
|
|
* the whole devices tree will be searched, starting from the current
|
|
* device node.
|
|
* @param deviceURI the device URI to search
|
|
* @return An UPNPDevice if anything matches or null
|
|
*/
|
|
public UPNPDevice getChildDevice( String deviceURI ) {
|
|
if ( log.isDebugEnabled() ) log.debug( "searching for device URI:" + deviceURI );
|
|
if ( getDeviceType().equals( deviceURI ) ) return this;
|
|
if ( childDevices == null ) return null;
|
|
for ( Iterator itr = childDevices.iterator(); itr.hasNext(); ) {
|
|
UPNPDevice device = (UPNPDevice)itr.next();
|
|
UPNPDevice found = device.getChildDevice( deviceURI );
|
|
if ( found != null ) {
|
|
return found;
|
|
}
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Looks for all UPNP device service definitions objects
|
|
* @return A list of all device services
|
|
*/
|
|
public List getServices() {
|
|
if ( services == null ) return null;
|
|
List rtrVal = new ArrayList();
|
|
rtrVal.addAll( services );
|
|
return rtrVal;
|
|
}
|
|
|
|
/**
|
|
* Looks for a UPNP device service definition object for the given service URI (Type)
|
|
* @param serviceURI the URI of the service
|
|
* @return A matching UPNPService object or null
|
|
*/
|
|
public UPNPService getService( String serviceURI ) {
|
|
if ( services == null ) return null;
|
|
if ( log.isDebugEnabled() ) log.debug( "searching for service URI:" + serviceURI );
|
|
for ( Iterator itr = services.iterator(); itr.hasNext(); ) {
|
|
UPNPService service = (UPNPService)itr.next();
|
|
if ( service.getServiceType().equals( serviceURI ) ) {
|
|
return service;
|
|
}
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Looks for a UPNP device service definition object for the given service ID
|
|
* @param serviceURI the ID of the service
|
|
* @return A matching UPNPService object or null
|
|
*/
|
|
public UPNPService getServiceByID( String serviceID ) {
|
|
if ( services == null ) return null;
|
|
if ( log.isDebugEnabled() ) log.debug( "searching for service ID:" + serviceID );
|
|
for ( Iterator itr = services.iterator(); itr.hasNext(); ) {
|
|
UPNPService service = (UPNPService)itr.next();
|
|
if ( service.getServiceId().equals( serviceID ) ) {
|
|
return service;
|
|
}
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Looks for the all the UPNP device service definition object for the current
|
|
* UPNP device object. This method can be used to retreive multiple same kind
|
|
* ( same service type ) of services with different services id on a device
|
|
* @param serviceURI the URI of the service
|
|
* @return A matching List of UPNPService objects or null
|
|
*/
|
|
public List getServices( String serviceURI ) {
|
|
if ( services == null ) return null;
|
|
List rtrVal = new ArrayList();
|
|
if ( log.isDebugEnabled() ) log.debug( "searching for services URI:" + serviceURI );
|
|
for ( Iterator itr = services.iterator(); itr.hasNext(); ) {
|
|
UPNPService service = (UPNPService)itr.next();
|
|
if ( service.getServiceType().equals( serviceURI ) ) {
|
|
rtrVal.add( service );
|
|
}
|
|
}
|
|
if ( rtrVal.size() == 0 ) {
|
|
return null;
|
|
}
|
|
return rtrVal;
|
|
}
|
|
|
|
/**
|
|
* The toString return the device type
|
|
* @return the device type
|
|
*/
|
|
public String toString() {
|
|
return getDeviceType();
|
|
}
|
|
|
|
}
|