Package Torello.Browser

Class DataIntegrityException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

Torello.Browser.DataIntegrityException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

InvalidEnumStrException, NullNonOptionalException

public abstract class DataIntegrityException
extends java.lang.RuntimeException

Abstract ancestor exception class for exceptions which check the integrity of instances of both CDP types and CDP events.

Of significant note, when the Browser transmits an object type or event to the Torello.Browser packages, the Web-Sockets layer parses the Json, and performs a "best efforts" attempt at constructing an object.

Because throwing exceptions from within the Web-Sockets processing classes and code would cause an unacceptable level of complexity, and and all classes received from Google's or a compatible Web-Browser are not checked for integrity, but rather constructed and returned to the user "as is.".

Data Integrity consists of two separate requirements:

• All type and event class fields which have not been declared optional must have a value assigned to their fields, and contain 'TRUE' within their respective BaseType.isPresent() list.
• Any type or event class fields which have been assigned to a type which has a correlated Enumerated String List must contain a string that is listed among the elements of the specified list.

See Also:

BaseType.optionalsValidate(), BaseType.optionalsValidateThrow(), BaseType.isPresent(), BaseType.enumStrValidate(), BaseType.enumStrValidateThrow(), NestedHelper.enumStrValidate(BaseType), Serialized Form

Hi-Lited Source-Code:

• View Here: Torello/Browser/DataIntegrityException.java
• Open New Browser-Tab: Torello/Browser/DataIntegrityException.java

File Size: 3,698 Bytes Line Count: 92 '\n' Characters Found

Field Summary

Serializable ID
Modifier and Type	Field
static long	serialVersionUID

Constructor Summary

Constructors

Modifier	Constructor
protected	DataIntegrityException()
protected	DataIntegrityException(String message)
protected	DataIntegrityException(String message, Throwable cause)
protected	DataIntegrityException(Throwable cause)

Method Summary

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

🡇 ⇈ ⮫ 🗕 🗗 🗖

public static final long serialVersionUID

This fulfils the SerialVersion UID requirement for all classes that implement Java's interface java.io.Serializable. Using the Serializable Implementation offered by java is very easy, and can make saving program state when debugging a lot easier. It can also be used in place of more complicated systems like "hibernate" to store data as well.

Note that Java's java.lang.Exception and java.lang.Error classes implement the Serializable interface, and a warning-free build expects this field be defined here.

See Also:

Constant Field Values

Code:

Exact Field Declaration Expression:

 public static final long serialVersionUID = 1;

Constructor Detail

DataIntegrityException

🡅 🡇 ⇈ ⮫ 🗕 🗗 🗖

protected DataIntegrityException()

Constructs a DataIntegrityException with no detail message.

DataIntegrityException

🡅 🡇 ⇈ ⮫ 🗕 🗗 🗖

protected DataIntegrityException(java.lang.String message)

Constructs a DataIntegrityException with the specified detail message.

Parameters:

message - the detail message.

DataIntegrityException

🡅 🡇 ⇈ ⮫ 🗕 🗗 🗖

protected DataIntegrityException(java.lang.String message,
                                 java.lang.Throwable cause)

Constructs a new DataIntegrityException with the specified detail message and cause.

Note: The detail message associated with cause is not automatically incorporated into this exception's detail message.

Parameters:

message - The detail message (which is saved for later retrieval by the Throwable.getMessage() method).

cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown).

DataIntegrityException

🡅 ⇈ ⮫ 🗕 🗗 🗖

protected DataIntegrityException(java.lang.Throwable cause)

Constructs a new DataIntegrityException with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause).

This constructor is useful for exceptions that are little more than wrappers for other throwables.

Parameters:

cause - The cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown).