Package org.jupnp.binding.xml

Klasse RecoveringUDA10DeviceDescriptorBinderImpl

java.lang.Object

org.jupnp.binding.xml.UDA10DeviceDescriptorBinderImpl

org.jupnp.binding.xml.RecoveringUDA10DeviceDescriptorBinderImpl

Alle implementierten Schnittstellen:

DeviceDescriptorBinder, ErrorHandler

public class RecoveringUDA10DeviceDescriptorBinderImpl
extends UDA10DeviceDescriptorBinderImpl

Autor:

Michael Pujos, Kai Kreuzer - added faulty descriptors as found by Belkin WeMo, Roland Edelhoff - avoid description of Sonos group devices, Jochen Hiller - use SpecificationViolationReporter, change logger to be final

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
RecoveringUDA10DeviceDescriptorBinderImpl()

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
<D extends Device> D	describe(D undescribedDevice, String descriptorXml)
protected String	fixGarbageTrailingChars(String descriptorXml, DescriptorBindingException e)
protected String	fixMimeTypes(String descriptorXml)
protected String	fixMissingNamespaces(String descriptorXml, DescriptorBindingException e)
protected String	fixWemoMakerUDN(String descriptorXml)
protected String	fixWrongNamespaces(String descriptorXml)
protected void	handleInvalidDescriptor(String xml, DescriptorBindingException exception)	Handle processing errors while reading XML descriptors.
protected <D extends Device> D	handleInvalidDevice(String xml, D device, ValidationException exception)	Handle processing errors while binding XML descriptors.

Von Klasse geerbte Methoden org.jupnp.binding.xml.UDA10DeviceDescriptorBinderImpl

buildDOM, buildInstance, describe, error, fatalError, generate, generateDevice, generateDeviceList, generateIconList, generateRoot, generateServiceList, generateSpecVersion, hydrateDevice, hydrateDeviceList, hydrateIconList, hydrateRoot, hydrateServiceList, hydrateSpecVersion, parseURI, warning

Von Klasse geerbte Methoden java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Konstruktordetails

RecoveringUDA10DeviceDescriptorBinderImpl

public RecoveringUDA10DeviceDescriptorBinderImpl()

Methodendetails

describe

public <D extends Device> D describe(D undescribedDevice,
 String descriptorXml)
                              throws DescriptorBindingException,
ValidationException

Angegeben von:

describe in Schnittstelle DeviceDescriptorBinder

Setzt außer Kraft:

describe in Klasse UDA10DeviceDescriptorBinderImpl

Löst aus:

DescriptorBindingException

ValidationException

fixGarbageTrailingChars

protected String fixGarbageTrailingChars(String descriptorXml,
 DescriptorBindingException e)

fixMimeTypes

protected String fixMimeTypes(String descriptorXml)

fixWrongNamespaces

protected String fixWrongNamespaces(String descriptorXml)

fixMissingNamespaces

protected String fixMissingNamespaces(String descriptorXml,
 DescriptorBindingException e)

fixWemoMakerUDN

protected String fixWemoMakerUDN(String descriptorXml)

handleInvalidDescriptor

protected void handleInvalidDescriptor(String xml,
 DescriptorBindingException exception)
                                throws DescriptorBindingException

Handle processing errors while reading XML descriptors.

Typically you want to log this problem or create an error report, and in any case, throw a DescriptorBindingException to notify the caller of the binder of this failure. The default implementation simply rethrows the given exception.

Parameter:

xml - The original XML causing the parsing failure.

exception - The original exception while parsing the XML.

Löst aus:

DescriptorBindingException

handleInvalidDevice

protected <D extends Device> D handleInvalidDevice(String xml,
 D device,
 ValidationException exception)
                                            throws ValidationException

Handle processing errors while binding XML descriptors.

Typically you want to log this problem or create an error report. You should throw a ValidationException to notify the caller of the binder of failure. The default implementation simply rethrows the given exception.

This method gives you a final chance to fix the problem, instead of throwing an exception, you could try to create valid Device model and return it.

Parameter:

xml - The original XML causing the binding failure.

device - The unfinished Device that failed validation

exception - The errors found when validating the Device model.

Gibt zurück:

Device A "fixed" Device model, instead of throwing an exception.

Löst aus:

ValidationException