org.openorb.iiop
Class CodeSet

java.lang.Object
  |
  +--org.openorb.iiop.CodeSet

public final class CodeSet

extends java.lang.Object

This class represents an entry in the codeset database. The primary key ist the codeset id. Attached to this key are information like name, canonical name, description, array of, charset ids number of bytes, maximum number of bytes, and a flag whether this is a server side or a client side entry.

Author:

Michael Rumpf

Constructor Summary

CodeSet(java.lang.String description, int id, short[] charsets, int maxSize, java.lang.String canonical, java.lang.String name, int alignment, boolean server)
Constructor.

Method Summary

static boolean	compatible(CodeSet entryA, CodeSet entryB) Returns true if two codesets are compatible.
static boolean	compatible(int csA, int csB) Returns true if two codesets are compatible.
boolean	forServer() Return whether the codeset is to be used in server profiles or not.
int	getAlignment() Return the alignment for this codeset.
java.lang.String	getCanonicalName() Returns the canonical Java name for the codeset.
short[]	getCharsets() Return the array of charsets covered by this codeset.
java.lang.String	getDescription() Return the description of this codeset.
int	getId() Return the id of this codeset.
int	getMaxSize() Return the maximum number of bytes used by this codeset.
java.lang.String	getName() Return the name of this codeset.
boolean	isCompatibleTo(CodeSet to_comp) Compare this codeset to the specified one.
java.lang.String	toString() This method is used to create a stringified representation of an entry.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

CodeSet

public CodeSet(java.lang.String description,
               int id,
               short[] charsets,
               int maxSize,
               java.lang.String canonical,
               java.lang.String name,
               int alignment,
               boolean server)

Constructor. This constructor populates all the fields of this class.

Method Detail

getId

public int getId()

Return the id of this codeset. The id is an unsigned 32bit integer from the OSF charset and codeset registry.

getCanonicalName

public java.lang.String getCanonicalName()

Returns the canonical Java name for the codeset.

getName

public java.lang.String getName()

Return the name of this codeset. This is not the canonical Java name of the codeset. This name has been entered during the first/last run of the CodeSetDatabase.main() method and has not been changed since then. This name is canonicalized before it is used in the Java environment. The reason why this name isn't changed to the canonical name per default is that there are several codesets mapped on to the same Java name. For example the several UCS Level 1-3 and the UTF-16BE codesets. In Java all of them are mapped to UnicodeBigUnmarked. When object references are printed to the command line we want the names as defined in the OSF codeset registry and not the Java canonical name, because it will be no longer comparable to object references from e.g. C/C++ environments where the Java canonical name isn't known.

getDescription

public java.lang.String getDescription()

Return the description of this codeset. The description from the OSF charset and codeset registry.

getCharsets

public short[] getCharsets()

Return the array of charsets covered by this codeset. A charset registry entry is represented by an unsigned 16bit short value as defined in the OSF charset and codeset registry.

getMaxSize

public int getMaxSize()

Return the maximum number of bytes used by this codeset. There are two main types of codesets: byte-oriented and non-byte-oriented. The byte-oriented have another two sub-categories: single-byte and multi-byte. This makes three different types regarding to the length in bytes: single-byte, variable-length multi-byte, and fixed-length multi-byte.

getAlignment

public int getAlignment()

Return the alignment for this codeset. This value has been supplied by the first run of the CodeSetDatabaseInitializer.main() method and is reused each time the CodeSetDatabase class is regenerated. The reason why the CodeSetDatabase.getAlignmentFromId returns another value than this method is currently unknown.

Returns:

The aligment for the specified codeset

forServer

public boolean forServer()

Return whether the codeset is to be used in server profiles or not. This flag can be specified in the interactive mode when creating the CodeSetDatabase file. The reason why some codesets are marked for client use only is currently unknown.

toString

public java.lang.String toString()

This method is used to create a stringified representation of an entry.

Overrides:

toString in class java.lang.Object

isCompatibleTo

public boolean isCompatibleTo(CodeSet to_comp)

Compare this codeset to the specified one.

Parameters:

to_comp - The codest to compare this one to.

Returns:

True if the codesets are compatible, false otherwise.

compatible

public static boolean compatible(int csA,
                                 int csB)

Returns true if two codesets are compatible.

Parameters:

csA - codeset id for codeset A.

csB - codeset id for codeset B.

Returns:

True when codeset B is compatible to codeset A. False otherwise.

compatible

public static boolean compatible(CodeSet entryA,
                                 CodeSet entryB)

Returns true if two codesets are compatible. For example, when codeset A maps 3 charsets and codeset B only 2 then they are not compatible, because codeset A can represent more charsets than codeset B and a comparison of the character sets doesn't matter. When codeset A maps 3 charsets and codeset B 3 or more, then the charsets are compatible when all one charset from codeset A and one charset from codeset B match. CORBA 2.5 chapter 13.10.5.1: Compatibility is determined with respect to two code sets by examining their entries in the registry, paying special attention to the character sets encoded by each code set. For each of the two code sets, an attempt is made to see if there is at least one (fuzzy-defined) character set in common, and if such a character set is found, then the assumption is made that these code sets are compatible. Obviously, applications which exploit parts of a character set not properly encoded in this scheme will suffer information loss when communicating with another application in this fuzzy scheme.

Parameters:

codesetA - Codeset A.

codesetB - Codeset B.

Returns:

True when codeset B is compatible to codeset A. False otherwise.