{@linkorg.gjt.cuspy.Rethrown}

Throw a checked exception, unchecked exception, or error, without losing information contained in an earlier exception.
(similar: {@linkorg.gjt.jem.utils.exceptions.WrapperedException})

{@linkorg.gjt.cuspy.Interned}

Like String.intern() but for any object, so you can use == instead of equals().

{@linkorg.gjt.cuspy.ByteString}

For reliable general file processing or line/character based net protocols where non-Unicode platforms are involved.

{@linkorg.gjt.cuspy.JarX}

Self-extracting jars that also safely convert extracted text files to the receiver's encoding and newline conventions.

These classes (with any inner classes they include) may be treated as units of distribution; in fact, each one (will have) a jar file available for download (as soon as I can make that work on GJT). If you develop for the Java 1.2 runtime environment, you can treat these jars as extensions: they can be placed in the jre/lib/ext directory of the runtime system if heavily used, and any that are not so installed can be automatically downloaded with your app.

Here are some more notes on the classes:

{@linkorg.gjt.cuspy.Rethrown}

API requirements sometimes call for catching an exception and throwing one of a different type. With this class you can do that and not lose invaluable debugging information, and the level of detail shown can be changed without access to the source or recompiling, so mysterious problems can be tracked down in the field. Java 1.1 or 1.2.

{@linkorg.gjt.cuspy.Interned}

Requires Java 1.2 because it uses WeakReferences to allow intern map space to be reclaimed when the objects are unreachable (like a WeakHashMap, but this is concerned with when the objects themselves are released, where WeakHashMap is concerned with the keys).

{@linkorg.gjt.cuspy.ByteString}

If you do any programming involving line/character-based network protocols, or general-purpose file processing and your OS isn't something like Plan9 that's Unicode from the ground up, please at least read the rationale in this class API doc, and avoid writing unreliable, unsafe code! Depending on your application, you may find this class convenient. Needs Java 1.2 because it uses Interned.

{@linkorg.gjt.cuspy.JarX}

Works with Java 1.1 and later.

Downloads

• JAR Archive
• Download the package JAR file.
• ZIP Archives
• Download the complete package.
• Download the documentation.
• Download the class files.
• Download the source code.
• UNIX GZIP-ed TAR Archives
• Download the complete package.
• Download the documentation.
• Download the class files.
• Download the source code.