Package Torello.HTML

Class ReplaceableOutOfBoundsException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

Torello.HTML.ReplaceableException

Torello.HTML.ReplaceableOutOfBoundsException

All Implemented Interfaces:

java.io.Serializable

public class ReplaceableOutOfBoundsException
extends ReplaceableException

Thrown during a Replaceable HTML-Vector update operation when a Replaceable instance is not within the bounds of that HTML-Vector.

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/ReplaceableOutOfBoundsException.java
• Open New Browser-Tab: Torello/HTML/ReplaceableOutOfBoundsException.java

File Size: 1,768 Bytes Line Count: 58 '\n' Characters Found

Field Summary

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

Constructor Summary

Constructors

Constructor
ReplaceableOutOfBoundsException(String message, Replaceable r)
ReplaceableOutOfBoundsException(Replaceable r)

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;

r

🡅 🡇 ⇈ ⮫

public final Replaceable r

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 Replaceable which caused this exception to throw

Code:

Exact Field Declaration Expression:

 public final Replaceable r;

Constructor Detail

ReplaceableOutOfBoundsException

🡅 🡇 ⇈ ⮫

public ReplaceableOutOfBoundsException(Replaceable r)

Constructs a ReplaceableOutOfBoundsException with no detail message.

Parameters:

r - A reference to the 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.

ReplaceableOutOfBoundsException

🡅 ⇈ ⮫

public ReplaceableOutOfBoundsException(java.lang.String message,
                                       Replaceable r)

Constructs a ReplaceableOutOfBoundsException with the specified detail message.

Parameters:

message - the detail message.

r - A reference to the 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.