org.fourthline.cling.protocol.RetrieveRemoteDescriptors Class Reference

Retrieves all remote device XML descriptors, parses them, creates an immutable device and service metadata graph. More...

Inheritance diagram for org.fourthline.cling.protocol.RetrieveRemoteDescriptors:

Collaboration diagram for org.fourthline.cling.protocol.RetrieveRemoteDescriptors:

Public Member Functions
	RetrieveRemoteDescriptors (UpnpService upnpService, RemoteDevice rd)
UpnpService	getUpnpService ()
void	run ()

Protected Member Functions
void	describe () throws RouterException
void	describe (String descriptorXML) throws RouterException
RemoteDevice	describeServices (RemoteDevice currentDevice) throws RouterException, DescriptorBindingException, ValidationException
RemoteService	describeService (RemoteService service) throws RouterException, DescriptorBindingException, ValidationException
List< RemoteService >	filterExclusiveServices (RemoteService[] services)

Protected Attributes
List< UDN >	errorsAlreadyLogged = new ArrayList<>()

Detailed Description

Retrieves all remote device XML descriptors, parses them, creates an immutable device and service metadata graph.

This implementation encapsulates all steps which are necessary to create a fully usable and populated device metadata graph of a particular UPnP device. It starts with an unhydrated and typically just discovered org.fourthline.cling.model.meta.RemoteDevice, the only property that has to be available is its org.fourthline.cling.model.meta.RemoteDeviceIdentity.

This protocol implementation will then retrieve the device's XML descriptor, parse it, and retrieve and parse all service descriptors until all device and service metadata has been retrieved. The fully hydrated device is then added to the org.fourthline.cling.registry.Registry.

Any descriptor retrieval, parsing, or validation error of the metadata will abort this protocol with a warning message in the log.

Author

Christian Bauer

---

The documentation for this class was generated from the following file:

• /github/workspace/yaacc/src/main/java/org/fourthline/cling/protocol/RetrieveRemoteDescriptors.java