1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
package Torello.Browser;

/**
 * Used to indicate that a field within a CDP type or event has been constructed is a string field,
 * and has a pre-defined & pre-specified enumeration of valid strings, but whose value does not
 * actually equal one of the listed, pre-defined strings.
 * 
 * <BR /><BR /><DIV CLASS=JDHint>
 * Enumeration Lists in the Browser's API are not actually "reified" into standard Java
 * {@code enum's}.  In this way, if a "suprise return string" from a Browser isn't actually a valid
 * element within the {@code enum's} string list, an exception thrown at the transport web-sockets
 * layer can easily be avoided.  Instead, if the user needs to check the validity of an event or 
 * domain class, he may simply invoke the {@link BaseType#enumStrValidate()} or the 
 * {@link BaseType#enumStrValidateThrow()} methods.
 * </DIV>
 * 
 * @see BaseType#enumStrValidate()
 * @see BaseType#enumStrValidateThrow()
 * @see NestedHelper#enumStrValidate(BaseType)
 */
public class InvalidEnumStrException extends DataIntegrityException
{
    /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUIDEX>  */
    public static final long serialVersionUID = 1;

    /** Constructs a {@code InvalidEnumStrException} with no detail message. */
    public InvalidEnumStrException()
    { super(); }

    /**
     * Constructs a {@code InvalidEnumStrException} with the specified detail message.
     * @param message the detail message.
     */
    public InvalidEnumStrException(String message)
    { super(message); }
}