Package org.jupnp.registry

Klasse DefaultRegistryListener

java.lang.Object
org.jupnp.registry.DefaultRegistryListener
Alle implementierten Schnittstellen:
RegistryListener
public class DefaultRegistryListener extends Object implements RegistryListener
Convenience class, provides empty implementations of all methods.

Also unifies local and remote device additions and removals with deviceAdded(Registry, org.jupnp.model.meta.Device) and deviceRemoved(Registry, org.jupnp.model.meta.Device) methods.

Autor:
Christian Bauer

  • Konstruktordetails

    • DefaultRegistryListener

      public DefaultRegistryListener()

  • Methodendetails

    • remoteDeviceDiscoveryStarted

      public void remoteDeviceDiscoveryStarted(Registry registry, RemoteDevice device)
      Beschreibung aus Schnittstelle kopiert: RegistryListener
      Called as soon as possible after a device has been discovered.

      This method will be called after SSDP notification datagrams of a new alive UPnP device have been received and processed. The announced device XML descriptor will be retrieved and parsed. The given RemoteDevice metadata is validated and partial Service metadata is available. The services are unhydrated, they have no actions or state variable metadata because the service descriptors of the device model have not been retrieved at this point.

      You typically do not use this method on a regular machine, this is an optimization for slower UPnP hosts (such as Android handsets).

      Angegeben von:
      remoteDeviceDiscoveryStarted in Schnittstelle RegistryListener
      Parameter:
      registry - The jUPnP registry of all devices and services know to the local UPnP stack.
      device - A validated and hydrated device metadata graph, with anemic service metadata.

    • remoteDeviceDiscoveryFailed

      public void remoteDeviceDiscoveryFailed(Registry registry, RemoteDevice device, Exception e)
      Beschreibung aus Schnittstelle kopiert: RegistryListener
      Called when service metadata couldn't be initialized.

      If you override the RegistryListener.remoteDeviceDiscoveryStarted(Registry, org.jupnp.model.meta.RemoteDevice) method, you might want to override this method as well.

      Angegeben von:
      remoteDeviceDiscoveryFailed in Schnittstelle RegistryListener
      Parameter:
      registry - The jUPnP registry of all devices and services know to the local UPnP stack.
      device - A validated and hydrated device metadata graph, with anemic service metadata.
      e - The reason why service metadata could not be initialized, or null if service descriptors couldn't be retrieved at all.

    • remoteDeviceAdded

      public void remoteDeviceAdded(Registry registry, RemoteDevice device)
      Calls the deviceAdded(Registry, org.jupnp.model.meta.Device) method.
      Angegeben von:
      remoteDeviceAdded in Schnittstelle RegistryListener
      Parameter:
      registry - The jUPnP registry of all devices and services know to the local UPnP stack.
      device - A validated and hydrated device metadata graph, with complete service metadata.

    • remoteDeviceUpdated

      public void remoteDeviceUpdated(Registry registry, RemoteDevice device)
      Beschreibung aus Schnittstelle kopiert: RegistryListener
      Called when a discovered device's expiration timestamp is updated.

      This is a signal that a device is still alive and you typically don't have to react to this event. You will be notified when a device disappears through timeout.

      Angegeben von:
      remoteDeviceUpdated in Schnittstelle RegistryListener
      Parameter:
      registry - The jUPnP registry of all devices and services know to the local UPnP stack.
      device - A validated and hydrated device metadata graph, with complete service metadata.

    • remoteDeviceRemoved

      public void remoteDeviceRemoved(Registry registry, RemoteDevice device)
      Calls the deviceRemoved(Registry, org.jupnp.model.meta.Device) method.
      Angegeben von:
      remoteDeviceRemoved in Schnittstelle RegistryListener
      Parameter:
      registry - The jUPnP registry of all devices and services know to the local UPnP stack.
      device - A validated and hydrated device metadata graph, with complete service metadata.

    • localDeviceAdded

      public void localDeviceAdded(Registry registry, LocalDevice device)
      Calls the deviceAdded(Registry, org.jupnp.model.meta.Device) method.
      Angegeben von:
      localDeviceAdded in Schnittstelle RegistryListener
      Parameter:
      registry - The jUPnP registry of all devices and services know to the local UPnP stack.
      device - The local device added to the Registry.

    • localDeviceRemoved

      public void localDeviceRemoved(Registry registry, LocalDevice device)
      Calls the deviceRemoved(Registry, org.jupnp.model.meta.Device) method.
      Angegeben von:
      localDeviceRemoved in Schnittstelle RegistryListener
      Parameter:
      registry - The jUPnP registry of all devices and services know to the local UPnP stack.
      device - The local device removed from the Registry.

    • deviceAdded

      public void deviceAdded(Registry registry, Device device)

    • deviceRemoved

      public void deviceRemoved(Registry registry, Device device)

    • beforeShutdown

      public void beforeShutdown(Registry registry)
      Beschreibung aus Schnittstelle kopiert: RegistryListener
      Called after registry maintenance stops but before the registry is cleared.

      This method should typically not block, it executes in the thread that shuts down the UPnP stack.

      Angegeben von:
      beforeShutdown in Schnittstelle RegistryListener
      Parameter:
      registry - The jUPnP registry of all devices and services know to the local UPnP stack.

    • afterShutdown

      public void afterShutdown()
      Beschreibung aus Schnittstelle kopiert: RegistryListener
      Called after the registry has been cleared on shutdown.

      This method should typically not block, it executes in the thread that shuts down the UPnP stack.

      Angegeben von:
      afterShutdown in Schnittstelle RegistryListener