Klasse Namespace

java.lang.Object
org.jupnp.model.Namespace

public class Namespace extends Object
Enforces path conventions for all locally offered resources (descriptors, icons, etc.)

Every descriptor, icon, event callback, or action message is send to a URL. This namespace defines how the path of this URL will look like and it will build the path for a given resource.

By default, the namespace is organized as follows:


 http://host:port/dev/<udn>/desc.xml
 http://host:port/dev/<udn>/svc/<svcIdNamespace>/<svcId>/desc.xml
 http://host:port/dev/<udn>/svc/<svcIdNamespace>/<svcId>/action
 http://host:port/dev/<udn>/svc/<svcIdNamespace>/<svcId>/event
 http://host:port/dev/<ThisIsEitherRootUDN>/svc/<svcIdNamespace>/<svcId>/event/cb.xml
 http://host:port/dev/<OrEvenAnEmbeddedDevicesUDN>/svc/<svcIdNamespace>/<svcId>/action
 ...
 

The namespace is also used to discover and create all Resources given a Device's metadata. This procedure is typically invoked once, when the device is added to the Registry.

Autor:
Christian Bauer
  • Felddetails

  • Konstruktordetails

    • Namespace

      public Namespace()
    • Namespace

      public Namespace(String basePath)
    • Namespace

      public Namespace(URI basePath)
  • Methodendetails

    • getBasePath

      public URI getBasePath()
    • getPath

      public URI getPath(Device device)
    • getPath

      public URI getPath(Service service)
    • getDescriptorPath

      public URI getDescriptorPath(Device device)
    • getDescriptorPathString

      public String getDescriptorPathString(Device device)
      Performance optimization, avoids URI manipulation.
    • getDescriptorPath

      public URI getDescriptorPath(Service service)
    • getControlPath

      public URI getControlPath(Service service)
    • getIconPath

      public URI getIconPath(Icon icon)
    • getEventSubscriptionPath

      public URI getEventSubscriptionPath(Service service)
    • getEventCallbackPath

      public URI getEventCallbackPath(Service service)
    • getEventCallbackPathString

      public String getEventCallbackPathString(Service service)
      Performance optimization, avoids URI manipulation.
    • prefixIfRelative

      public URI prefixIfRelative(Device device, URI uri)
    • isControlPath

      public boolean isControlPath(URI uri)
    • isEventSubscriptionPath

      public boolean isEventSubscriptionPath(URI uri)
    • isEventCallbackPath

      public boolean isEventCallbackPath(URI uri)
    • getResources

      public Resource[] getResources(Device device) throws ValidationException
      Löst aus:
      ValidationException
    • appendPathToBaseURI

      protected URI appendPathToBaseURI(String path)
    • getDevicePath

      protected String getDevicePath(Device device)
    • getServicePath

      protected String getServicePath(Service service)