org.ws4d.java.util

Class Toolkit

java.lang.Object

org.ws4d.java.util.Toolkit

Direct Known Subclasses:

LocalToolkit

public abstract class Toolkit
extends java.lang.Object

This utility class includes a collection of methods, which are specific to different Java Editions.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Toolkit()

Method Summary

Modifier and Type	Method and Description
abstract java.io.InputStream	buffer(java.io.InputStream stream) Ensures the returned InputStream is a BufferedInputStream.
abstract SimpleStringBuilder	createSimpleStringBuilder()
abstract SimpleStringBuilder	createSimpleStringBuilder(int capacity)
abstract SimpleStringBuilder	createSimpleStringBuilder(java.lang.String str)
static Toolkit	getInstance()
int	getJavaVersionDigit1()
int	getJavaVersionDigit2()
int	getJavaVersionDigit3()
int	getJavaVersionUpdateNumber() Deprecated.
abstract java.lang.String[]	getStackTrace(java.lang.Throwable t) Returns the Java VM stack trace if possible.
static boolean	onCldcLibrary() checks whether the current framework instance is running on top of the CLDC library.
abstract void	printStackTrace(java.io.PrintStream err, java.lang.Throwable t) Implementation of the stack trace logging.
abstract void	writeBufferToStream(java.io.ByteArrayOutputStream source, java.io.OutputStream target) Writes the complete contents of the byte array output stream to the target output stream like source.writeTo(target) of the SE version of ByteArrayOutputStream would do.

Methods inherited from class java.lang.Object

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

Constructor Detail

Toolkit

protected Toolkit()

Method Detail

onCldcLibrary

public static boolean onCldcLibrary()

checks whether the current framework instance is running on top of the CLDC library. Returns true if this is the case.

Returns:

in case the framework runs on top of the Java CLDC configuration

getInstance

public static Toolkit getInstance()

getJavaVersionDigit1

public int getJavaVersionDigit1()

Returns:

first digit of the java version

getJavaVersionDigit2

public int getJavaVersionDigit2()

Returns:

second digit of the java version

getJavaVersionDigit3

public int getJavaVersionDigit3()

Returns:

third digit of the java version

getJavaVersionUpdateNumber

public int getJavaVersionUpdateNumber()

Deprecated.

Returns:

update number of the java version

printStackTrace

public abstract void printStackTrace(java.io.PrintStream err,
                                     java.lang.Throwable t)

Implementation of the stack trace logging.

Parameters:

err - Stream to, if possible, print the stack trace on.

t - Throwable to print.

getStackTrace

public abstract java.lang.String[] getStackTrace(java.lang.Throwable t)

Returns the Java VM stack trace if possible.

Can return null if the platform does not support access to the stack trace!

Parameters:

t - stack trace

Returns:

stack trace as array of String.

writeBufferToStream

public abstract void writeBufferToStream(java.io.ByteArrayOutputStream source,
                                         java.io.OutputStream target)
                                  throws java.io.IOException

Writes the complete contents of the byte array output stream to the target output stream like source.writeTo(target) of the SE version of ByteArrayOutputStream would do.

Parameters:

source - the byte array output stream whose buffer should be written

target - the output stream to which to write the data.

Throws:

java.io.IOException - if an I/O error occurs.

buffer

public abstract java.io.InputStream buffer(java.io.InputStream stream)

Ensures the returned InputStream is a BufferedInputStream. This method will avoid double buffering.

Parameters:

stream -

Returns:

a BufferedInputStream wrapping stream

createSimpleStringBuilder

public abstract SimpleStringBuilder createSimpleStringBuilder()

createSimpleStringBuilder

public abstract SimpleStringBuilder createSimpleStringBuilder(int capacity)

createSimpleStringBuilder

public abstract SimpleStringBuilder createSimpleStringBuilder(java.lang.String str)