java.lang.Object
java.lang.Throwable
java.lang.Exception
org.cybergarage.upnp.device.InvalidDescriptionException
All Implemented Interfaces:
Serializable
public class InvalidDescriptionExceptionextends Exception
Exception thrown when UPnP device description is invalid or cannot be parsed.

This exception is thrown during device description processing when the XML description is malformed, missing required elements, or contains invalid data that prevents proper device initialization.

Key features:

  • Multiple constructor options for different error scenarios
  • File context inclusion for description errors
  • Exception chaining support
  • Detailed error message handling

This exception is used by UPnP device parsing components to indicate failures in loading or interpreting device description documents, helping developers identify and resolve description format issues.

See Also:

  • Constructor Details

    • InvalidDescriptionException

      public InvalidDescriptionException()
      Creates a description exception with no detail message.

    • InvalidDescriptionException

      public InvalidDescriptionException(String s)
      Creates a description exception carrying a detail message.
      Parameters:
      s - the detail message describing why the description is invalid

    • InvalidDescriptionException

      public InvalidDescriptionException(String s, File file)
      Creates a description exception naming the offending file.
      Parameters:
      s - the detail message describing why the description is invalid
      file - the description file whose contents failed to parse, appended to the message

    • InvalidDescriptionException

      public InvalidDescriptionException(Exception e)
      Creates a description exception reusing a parse failure's message.
      Parameters:
      e - the parse failure whose message is reused as the detail message