Package Torello.HTML

Class ReplaceablesUnsortedException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

Torello.HTML.ReplaceableException

Torello.HTML.ReplaceablesUnsortedException

All Implemented Interfaces:

java.io.Serializable

public class ReplaceablesUnsortedException
extends ReplaceableException

Thrown during a Replaceable HTML-Vector update operation when two consecutive Replaceable instances appear to be out of order.

Class ReplaceNodes method r(Vector, Iterable, boolean) is currently the primary means offered for efficiently modifying an HTML-Vector. It is inside that method where this exception may be thrown by the standard features of Java HTML JAR Library.

The two methods below practice code re-use, and they are wrappers for the above mentioned method. However, since the Replaceable Iterable's are automatically built inside that method, unless there are unforseen errors in the Java-HTML JAR Library, these methods really should not cause this exception to throw.

• listLI(Vector, DotPair, ObjIntConsumer)
• tableTR(Vector, DotPair, ObjIntConsumer)

See Also:

Serialized Form

Hi-Lited Source-Code:

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

File Size: 2,841 Bytes Line Count: 88 '\n' Characters Found

Field Summary

Serializable ID
Modifier and Type	Field
static long	serialVersionUID
'final' Exception Convenience Fields
Modifier and Type	Field
Replaceable	r1
Replaceable	r2

Constructor Summary

Constructors

Constructor
ReplaceablesUnsortedException(String message, Replaceable r1, Replaceable r2)
ReplaceablesUnsortedException(Replaceable r1, Replaceable r2)

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;

r1

🡅 🡇 ⇈ ⮫

public final Replaceable r1

This field is provided to the user as a matter of convenience. All instantiations of this Exception are should guarantee to enforce and ensure that when an instance of this exception is thrown, the convenience field is not set null. If this package is extended, it is up to the programmer/user to make sure not to leave this field null when using one of these constructors.

IMPORTANT: All this is really trying to explain is that, when debugging your code, if in the analysis of a particular Exception, that analysis causes another exception throw (NullPointerException) - BECAUSE THIS CONVENIENCE FIELD WAS LEFT NULL - would be an unnecessary source of headache. A reference to the first Replaceable which caused this exception to throw

Code:

Exact Field Declaration Expression:

 public final Replaceable r1;

r2

🡅 🡇 ⇈ ⮫

public final Replaceable r2

This field is provided to the user as a matter of convenience. All instantiations of this Exception are should guarantee to enforce and ensure that when an instance of this exception is thrown, the convenience field is not set null. If this package is extended, it is up to the programmer/user to make sure not to leave this field null when using one of these constructors.

IMPORTANT: All this is really trying to explain is that, when debugging your code, if in the analysis of a particular Exception, that analysis causes another exception throw (NullPointerException) - BECAUSE THIS CONVENIENCE FIELD WAS LEFT NULL - would be an unnecessary source of headache. A reference to the second Replaceable which caused this exception to throw

Code:

Exact Field Declaration Expression:

 public final Replaceable r2;

Constructor Detail

ReplaceablesUnsortedException

🡅 🡇 ⇈ ⮫

public ReplaceablesUnsortedException(Replaceable r1,
                                     Replaceable r2)

Constructs a ReplaceablesUnsortedException with no detail message.

Parameters:

r1 - A reference to the first Replaceable which caused this exception to throw

This parameter should not be left null. If it were accidentally left null, this could force exception-handling code to to throw an exception itself - while checking exceptions! Note that checking the input to this constructor does occur, and if this parameter is passed a null value, an instance of Torello.Java.ExceptionCheckError will throw.

r2 - A reference to the second Replaceable which caused this exception to throw

This parameter should not be left null. If it were accidentally left null, this could force exception-handling code to to throw an exception itself - while checking exceptions! Note that checking the input to this constructor does occur, and if this parameter is passed a null value, an instance of Torello.Java.ExceptionCheckError will throw.

ReplaceablesUnsortedException

🡅 ⇈ ⮫

public ReplaceablesUnsortedException(java.lang.String message,
                                     Replaceable r1,
                                     Replaceable r2)

Constructs a ReplaceablesUnsortedException with the specified detail message.

Parameters:

message - the detail message.

r1 - A reference to the first Replaceable which caused this exception to throw

This parameter should not be left null. If it were accidentally left null, this could force exception-handling code to to throw an exception itself - while checking exceptions! Note that checking the input to this constructor does occur, and if this parameter is passed a null value, an instance of Torello.Java.ExceptionCheckError will throw.

r2 - A reference to the second Replaceable which caused this exception to throw

This parameter should not be left null. If it were accidentally left null, this could force exception-handling code to to throw an exception itself - while checking exceptions! Note that checking the input to this constructor does occur, and if this parameter is passed a null value, an instance of Torello.Java.ExceptionCheckError will throw.