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 aReplaceable
HTML-Vector
update operation when two consecutiveReplaceable
instances appear to be out of order.
ClassReplaceNodes
methodr(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 theReplaceable
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.
- 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,839 Bytes Line Count: 88 '\n' Characters Found
-
-
Field Summary
Serializable ID Modifier and Type Field static long
serialVersionUID
'final'
Exception Convenience FieldsModifier and Type Field Replaceable
r1
Replaceable
r2
-
Constructor Summary
Constructors Constructor Description ReplaceablesUnsortedException(String message, Replaceable r1, Replaceable r2)
Constructs aReplaceablesUnsortedException
with the specified detail message.ReplaceablesUnsortedException(Replaceable r1, Replaceable r2)
Constructs aReplaceablesUnsortedException
with no detail message.
-
-
-
Field Detail
-
serialVersionUID
public static final long serialVersionUID
This fulfils the SerialVersion UID requirement for all classes that implement Java'sinterface java.io.Serializable
. Using theSerializable
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'sjava.lang.Exception
andjava.lang.Error
classes implement theSerializable 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 instances of thisException
ought to guarantee that when an instance is thrown - any & all "Convenience Fields" have been properly set.
If this package is extended, or if this exception is used elsewhere, try to remember to not to accidentally leave this field null when using this class' constructors.
In Summary:
All this is really trying to explain is that, when debugging your code, if in the analysis of a particularException
, that analysis causes another exception throw (NullPointerException
) - BECAUSE THIS CONVENIENCE FIELD WAS LEFT NULL - you would likely get pretty angry. A reference to the firstReplaceable
which caused this exception to throw
-
r2
public final Replaceable r2
This field is provided to the user as a matter of convenience. All instances of thisException
ought to guarantee that when an instance is thrown - any & all "Convenience Fields" have been properly set.
If this package is extended, or if this exception is used elsewhere, try to remember to not to accidentally leave this field null when using this class' constructors.
In Summary:
All this is really trying to explain is that, when debugging your code, if in the analysis of a particularException
, that analysis causes another exception throw (NullPointerException
) - BECAUSE THIS CONVENIENCE FIELD WAS LEFT NULL - you would likely get pretty angry. A reference to the secondReplaceable
which caused this exception to throw
-
-
Constructor Detail
-
ReplaceablesUnsortedException
public ReplaceablesUnsortedException(Replaceable r1, Replaceable r2)
Constructs aReplaceablesUnsortedException
with no detail message.- Parameters:
r1
- A reference to the firstReplaceable
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 ofTorello.Java.ExceptionCheckError
will throw.r2
- A reference to the secondReplaceable
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 ofTorello.Java.ExceptionCheckError
will throw.
-
ReplaceablesUnsortedException
public ReplaceablesUnsortedException(java.lang.String message, Replaceable r1, Replaceable r2)
Constructs aReplaceablesUnsortedException
with the specified detail message.- Parameters:
message
- the detail message.r1
- A reference to the firstReplaceable
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 ofTorello.Java.ExceptionCheckError
will throw.r2
- A reference to the secondReplaceable
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 ofTorello.Java.ExceptionCheckError
will throw.
-
-