ORBUtility (GlassFish Corba ORB 4.2.1 API)

java.lang.Object
- com.sun.corba.ee.impl.misc.ORBUtility

```
public final class ORBUtility
extends Object
```
Handy class full of static functions that don't belong in util.Utility for pure ORB reasons.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static int`	`bytesToInt(byte[] array, int offset)` Unmarshal a byte array to an integer.
`static byte`	`chooseEncodingVersion(ORB orb, IOR ior, GIOPVersion gv)`
`static String`	`classNameOf(String repositoryId)` Get the class name corresponding to a particular repository Id.
`static int`	`compareVersion(int[] v1, int[] v2)` Compare two version arrays.
`static int`	`compareVersion(String v1, String v2)` Compare two version strings.
`static String[]`	`concatenateStringArrays(String[] arr1, String[] arr2)`
`static ValueHandler`	`createValueHandler()` Gets the ValueHandler from Util.createValueHandler.
`static ValueHandler`	`createValueHandler(ORB orb)` Creates the correct ValueHandler.
`static void`	`dprint(Object obj, String msg)`
`static void`	`dprint(Object caller, String msg, Throwable t)`
`void`	`dprint(String msg)`
`static void`	`dprint(String className, String msg)`
`static void`	`dprintTrace(Object obj, String msg)`
`static String`	`dumpBinary(byte[] data)`
`static SystemException`	`extractSystemException(Any any)`
`static String`	`formatStringArray(String[] a)`
`static byte[]`	`getBuffer(String[] data)` Given some hex data, extract it and put it into a byte buffer.
`static byte[]`	`getByteBufferArray(ByteBuffer byteBuffer)`
`static String`	`getClassSecurityInfo(Class cl)`
`static byte`	`getEncodingVersion()`
`static byte`	`getMaxStreamFormatVersion()` Returns the maximum stream format version supported by our ValueHandler.
`static String`	`getThreadName(Thread thr)`
`static int`	`hexOf(char x)` Converts an Ascii Character into Hexadecimal digit
`static void`	`insertSystemException(SystemException ex, Any any)` Static method for writing a CORBA standard exception to an Any.
`static void`	`intToBytes(int value, byte[] array, int offset)` Marshal an integer to a byte array.
`static boolean`	`isForeignORB(ORB orb)` Returns true if it was accurately determined that the remote ORB is a foreign (non-JavaSoft) ORB.
`static boolean`	`isPrintable(char c)`
`static boolean`	`isSystemException(String repositoryId)` Return true if this repositoryId is a SystemException.
`static ClientDelegate`	`makeClientDelegate(IOR ior)`
`static Object`	`makeObjectReference(IOR ior)` This method is used to create untyped object references.
`static SocketChannel`	`openSocketChannel(SocketAddress sa)` Utility method for working around leak in SocketChannel.open( SocketAddress ) method.
`static String`	`operationNameAndRequestId(MessageMediator m)`
`static int[]`	`parseVersion(String version)` Parse a version string such as "1.1.6" or "jdk1.2fcs" into a version array of integers {1, 1, 6} or {1, 2}.
`static void`	`popEncVersionFromThreadLocalState()`
`static void`	`printBuffer(String msg, ByteBuffer buffer, PrintStream ps)` Print the contents of the buffer out to the PrintStream in hex and ASCII.
`static void`	`pushEncVersionToThreadLocalState(byte value)`
`static SystemException`	`readSystemException(InputStream strm)` Static method for reading a CORBA standard exception from a stream.
`static String`	`repositoryIdOf(String name)` Get the repository id corresponding to a particular class.
`static void`	`setDaemon(Thread thread)`
`static void`	`throwNotSerializableForCorba(String className)` Throws the CORBA equivalent of a java.io.NotSerializableException Duplicated from util/Utility for Pure ORB reasons.
`static void`	`writeSystemException(SystemException ex, OutputStream strm)` Static method for writing a CORBA standard exception to a stream.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - openSocketChannel
```
public static SocketChannel openSocketChannel(SocketAddress sa)
                                       throws IOException
```
    Utility method for working around leak in SocketChannel.open( SocketAddress ) method.
    
    Throws:
    
    IOException
  - pushEncVersionToThreadLocalState
```
public static void pushEncVersionToThreadLocalState(byte value)
```
  - popEncVersionFromThreadLocalState
```
public static void popEncVersionFromThreadLocalState()
```
  - getEncodingVersion
```
public static byte getEncodingVersion()
```
  - getByteBufferArray
```
public static byte[] getByteBufferArray(ByteBuffer byteBuffer)
```
  - chooseEncodingVersion
```
public static byte chooseEncodingVersion(ORB orb,
                                         IOR ior,
                                         GIOPVersion gv)
```
    Returns:
    
    the Java serialization encoding version.
  - insertSystemException
```
public static void insertSystemException(SystemException ex,
                                         Any any)
```
    Static method for writing a CORBA standard exception to an Any.
    
    Parameters:
    
    any - The Any to write the SystemException into.
  - extractSystemException
```
public static SystemException extractSystemException(Any any)
```
  - createValueHandler
```
public static ValueHandler createValueHandler()
```
    Gets the ValueHandler from Util.createValueHandler.
  - createValueHandler
```
public static ValueHandler createValueHandler(ORB orb)
```
    Creates the correct ValueHandler. The parameter is ignored
  - isForeignORB
```
public static boolean isForeignORB(ORB orb)
```
    Returns true if it was accurately determined that the remote ORB is a foreign (non-JavaSoft) ORB. Note: If passed the ORBSingleton, this will return false.
  - 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.
  - hexOf
```
public static int hexOf(char x)
```
    Converts an Ascii Character into Hexadecimal digit
  - writeSystemException
```
public static void writeSystemException(SystemException ex,
                                        OutputStream strm)
```
    Static method for writing a CORBA standard exception to a stream.
    
    Parameters:
    
    strm - The OutputStream to use for marshaling.
  - readSystemException
```
public static SystemException readSystemException(InputStream strm)
```
    Static method for reading a CORBA standard exception from a stream.
    
    Parameters:
    
    strm - The InputStream to use for unmarshaling.
  - classNameOf
```
public static String classNameOf(String repositoryId)
```
    Get the class name corresponding to a particular repository Id. This is used by the system to unmarshal (instantiate) the appropriate exception class for an marshaled as the value of its repository Id.
    
    Parameters:
    
    repositoryId - The repository Id for which we want a class name.
  - isSystemException
```
public static boolean isSystemException(String repositoryId)
```
    Return true if this repositoryId is a SystemException.
    
    Parameters:
    
    repositoryId - The repository Id to check.
  - repositoryIdOf
```
public static String repositoryIdOf(String name)
```
    Get the repository id corresponding to a particular class. This is used by the system to write the appropriate repository id for a system exception.
    
    Parameters:
    
    name - The class name of the system exception.
  - parseVersion
```
public static int[] parseVersion(String version)
```
    Parse a version string such as "1.1.6" or "jdk1.2fcs" into a version array of integers {1, 1, 6} or {1, 2}. A string of "n." or "n..m" is equivalent to "n.0" or "n.0.m" respectively.
  - compareVersion
```
public static int compareVersion(int[] v1,
                                 int[] v2)
```
    Compare two version arrays. Return 1, 0 or -1 if v1 is greater than, equal to, or less than v2.
  - compareVersion
```
public static int compareVersion(String v1,
                                 String v2)
```
    Compare two version strings. Return 1, 0 or -1 if v1 is greater than, equal to, or less than v2.
  - getThreadName
```
public static String getThreadName(Thread thr)
```
  - dprint
```
public static void dprint(Object obj,
                          String msg)
```
  - dprint
```
public static void dprint(String className,
                          String msg)
```
  - dprint
```
public void dprint(String msg)
```
  - dprintTrace
```
public static void dprintTrace(Object obj,
                               String msg)
```
  - dprint
```
public static void dprint(Object caller,
                          String msg,
                          Throwable t)
```
  - concatenateStringArrays
```
public static String[] concatenateStringArrays(String[] arr1,
                                               String[] arr2)
```
  - throwNotSerializableForCorba
```
public static void throwNotSerializableForCorba(String className)
```
    Throws the CORBA equivalent of a java.io.NotSerializableException Duplicated from util/Utility for Pure ORB reasons. There are two reasons for this: 1) We can't introduce dependencies on the util version from outside of the io/util packages since it will not exist in the pure ORB build running on JDK 1.3.x. 2) We need to pick up the correct minor code from OMGSystemException.
  - getMaxStreamFormatVersion
```
public static byte getMaxStreamFormatVersion()
```
    Returns the maximum stream format version supported by our ValueHandler.
  - makeClientDelegate
```
public static ClientDelegate makeClientDelegate(IOR ior)
```
  - makeObjectReference
```
public static Object makeObjectReference(IOR ior)
```
    This method is used to create untyped object references.
  - setDaemon
```
public static void setDaemon(Thread thread)
```
  - operationNameAndRequestId
```
public static String operationNameAndRequestId(MessageMediator m)
```
  - isPrintable
```
public static boolean isPrintable(char c)
```
  - getBuffer
```
public static byte[] getBuffer(String[] data)
```
    Given some hex data, extract it and put it into a byte buffer. The data must follow the following structure:
    1. All characters in a line after a "#" are ignored.
    2. All non-whitespace characters before a "#" are treated as hex data.
    3. All whitespace is ignored.
    4. Only whitespace and 0-9a-fA-F may occur before a "#" in any line.
    5. Each data line must contain an even number of non-whitespace characters.
  - dumpBinary
```
public static String dumpBinary(byte[] data)
```
  - printBuffer
```
public static void printBuffer(String msg,
                               ByteBuffer buffer,
                               PrintStream ps)
```
    Print the contents of the buffer out to the PrintStream in hex and ASCII.
    
    Parameters:
    
    msg - The message to use as the header for this display
    
    buffer - The ByteBuffer containing the data. The contents from 0 to buffer.position() are printed out. Remember to set position!
    
    ps - The PrintStream to use for the display.
  - getClassSecurityInfo
```
public static String getClassSecurityInfo(Class cl)
```
  - formatStringArray
```
public static String formatStringArray(String[] a)
```

Class ORBUtility

Method Summary

Methods inherited from class java.lang.Object

Method Detail

openSocketChannel

pushEncVersionToThreadLocalState

popEncVersionFromThreadLocalState

getEncodingVersion

getByteBufferArray

chooseEncodingVersion

insertSystemException

extractSystemException

createValueHandler

createValueHandler

isForeignORB

bytesToInt

intToBytes

hexOf

writeSystemException

readSystemException

classNameOf

isSystemException

repositoryIdOf

parseVersion

compareVersion

compareVersion

getThreadName

dprint

dprint

dprint

dprintTrace

dprint

concatenateStringArrays

throwNotSerializableForCorba

getMaxStreamFormatVersion

makeClientDelegate

makeObjectReference

setDaemon

operationNameAndRequestId

isPrintable

getBuffer

dumpBinary

printBuffer

getClassSecurityInfo

formatStringArray