com.sun.enterprise.util
Class Utility

java.lang.Object
  com.sun.enterprise.util.Utility

public final class Utility
extends java.lang.Object

Handy class full of static functions.

Constructor Summary

Utility()

Method Summary

static int	bytesToInt(byte[] array, int offset) Unmarshal a byte array to an integer.
static long	bytesToLong(byte[] array, int offset) Unmarshal a byte array to an long.
static void	checkJVMVersion()
static char[]	convertByteArrayToCharArray(byte[] byteArray, java.lang.String charset) Convert the byte array to char array with respect to given charset.
static byte[]	convertCharArrayToByteArray(char[] charArray, java.lang.String strCharset) Convert the char array to byte array with respect to given charset.
static java.lang.ClassLoader	getClassLoader() Get the current thread's context class loader which is set to the CommonClassLoader by ApplicationServer
static java.lang.String	getEnvOrProp(java.lang.String name) Return the value for a given name from the System Properties or the Environmental Variables.
static java.lang.String	getLocalAddress() Return the hostname of the local machine.
static java.lang.String	getLocalHost() Return the hostname of the local machine.
static java.util.Properties	getPropertiesFromFile(java.lang.String file)
static void	intToBytes(int value, byte[] array, int offset) Marshal an integer to a byte array.
static short	intToShort(int value)
static void	invokeApplicationMain(java.lang.Class mainClass, java.lang.String[] args) Verify and invoke main if present in the specified class.
static void	invokeSetMethod(java.lang.Object obj, java.lang.String prop, java.lang.String value)
static void	invokeSetMethodCaseInsensitive(java.lang.Object obj, java.lang.String prop, java.lang.String value)
static java.lang.Class	loadClass(java.lang.String className) Loads the class with the common class loader.
static void	longToBytes(long value, byte[] array, int offset) Marshal an long to a byte array.
static java.rmi.Remote	lookupObject(java.lang.String publishedName, java.lang.Class anInterface) This is a convenience method to lookup a remote object by name within the naming context.
static java.lang.ClassLoader	setContextClassLoader(java.lang.ClassLoader newClassLoader) Utility routine for setting the context class loader.
static void	setEnvironment()
static int	shortToInt(short value)

Methods inherited from class java.lang.Object

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

Constructor Detail

Utility

public Utility()

Method Detail

checkJVMVersion

public static void checkJVMVersion()

getPropertiesFromFile

public static java.util.Properties getPropertiesFromFile(java.lang.String file)
                                                  throws java.io.IOException

Throws:

java.io.IOException

getLocalHost

public static java.lang.String getLocalHost()

Return the hostname of the local machine.

getLocalAddress

public static java.lang.String getLocalAddress()

Return the hostname of the local machine.

lookupObject

public static java.rmi.Remote lookupObject(java.lang.String publishedName,
                                           java.lang.Class anInterface)
                                    throws javax.naming.NamingException

This is a convenience method to lookup a remote object by name within the naming context.

Throws:

javax.naming.NamingException - if the object with that name could not be found.

bytesToInt

public static int bytesToInt(byte[] array,
                             int offset)

Unmarshal a byte array to an integer. Assume the bytes are in BIGENDIAN order. i.e. array[offset] is the most-significant-byte and array[offset+3] is the least-significant-byte.

Parameters:

array - The array of bytes.

offset - The offset from which to start unmarshalling.

intToBytes

public static void intToBytes(int value,
                              byte[] array,
                              int offset)

Marshal an integer to a byte array. The bytes are in BIGENDIAN order. i.e. array[offset] is the most-significant-byte and array[offset+3] is the least-significant-byte.

Parameters:

array - The array of bytes.

offset - The offset from which to start marshalling.

bytesToLong

public static long bytesToLong(byte[] array,
                               int offset)

Unmarshal a byte array to an long. Assume the bytes are in BIGENDIAN order. i.e. array[offset] is the most-significant-byte and array[offset+7] is the least-significant-byte.

Parameters:

array - The array of bytes.

offset - The offset from which to start unmarshalling.

longToBytes

public static void longToBytes(long value,
                               byte[] array,
                               int offset)

Marshal an long to a byte array. The bytes are in BIGENDIAN order. i.e. array[offset] is the most-significant-byte and array[offset+7] is the least-significant-byte.

Parameters:

array - The array of bytes.

offset - The offset from which to start marshalling.

invokeApplicationMain

public static void invokeApplicationMain(java.lang.Class mainClass,
                                         java.lang.String[] args)
                                  throws java.lang.reflect.InvocationTargetException,
                                         java.lang.IllegalAccessException,
                                         java.lang.ClassNotFoundException

Verify and invoke main if present in the specified class.

Throws:

java.lang.reflect.InvocationTargetException

java.lang.IllegalAccessException

java.lang.ClassNotFoundException

invokeSetMethod

public static void invokeSetMethod(java.lang.Object obj,
                                   java.lang.String prop,
                                   java.lang.String value)
                            throws java.lang.NoSuchMethodException,
                                   java.lang.reflect.InvocationTargetException,
                                   java.lang.IllegalAccessException

Throws:

java.lang.NoSuchMethodException

java.lang.reflect.InvocationTargetException

java.lang.IllegalAccessException

invokeSetMethodCaseInsensitive

public static void invokeSetMethodCaseInsensitive(java.lang.Object obj,
                                                  java.lang.String prop,
                                                  java.lang.String value)
                                           throws java.lang.NoSuchMethodException,
                                                  java.lang.reflect.InvocationTargetException,
                                                  java.lang.IllegalAccessException

Throws:

java.lang.NoSuchMethodException

java.lang.reflect.InvocationTargetException

java.lang.IllegalAccessException

intToShort

public static short intToShort(int value)

shortToInt

public static int shortToInt(short value)

getClassLoader

public static java.lang.ClassLoader getClassLoader()

Get the current thread's context class loader which is set to the CommonClassLoader by ApplicationServer

Returns:

the thread's context classloader if it exists; else the system class loader.

loadClass

public static java.lang.Class loadClass(java.lang.String className)
                                 throws java.lang.ClassNotFoundException

Loads the class with the common class loader.

Parameters:

className - the class name

Returns:

the loaded class

Throws:

if - the class is not found.

java.lang.ClassNotFoundException

setContextClassLoader

public static java.lang.ClassLoader setContextClassLoader(java.lang.ClassLoader newClassLoader)

Utility routine for setting the context class loader. Returns previous class loader.

setEnvironment

public static void setEnvironment()

getEnvOrProp

public static java.lang.String getEnvOrProp(java.lang.String name)

Return the value for a given name from the System Properties or the Environmental Variables. The former overrides the latter.

Parameters:

name - - the name of the System Property or Environmental Variable

Returns:

the value of the variable or null if it was not found

convertByteArrayToCharArray

public static char[] convertByteArrayToCharArray(byte[] byteArray,
                                                 java.lang.String charset)
                                          throws java.nio.charset.CharacterCodingException

Convert the byte array to char array with respect to given charset.

Parameters:

byteArray -

charset - null or "" means default charset

Throws:

java.nio.charset.CharacterCodingException

convertCharArrayToByteArray

public static byte[] convertCharArrayToByteArray(char[] charArray,
                                                 java.lang.String strCharset)
                                          throws java.nio.charset.CharacterCodingException

Convert the char array to byte array with respect to given charset.

Parameters:

charArray -

strCharset - null or "" means default charset

Throws:

java.nio.charset.CharacterCodingException