org.apache.derby.impl.drda
Class CcsidManager

java.lang.Object
  org.apache.derby.impl.drda.CcsidManager

Direct Known Subclasses:

EbcdicCcsidManager, Utf8CcsidManager

abstract class CcsidManager
extends java.lang.Object

Field Summary

(package private) byte	dot
(package private) byte[]	numToCharRepresentation
(package private) byte	space
static int	UTF8_CCSID

Constructor Summary

CcsidManager(byte space, byte dot, byte[] numToCharRepresentation)

Method Summary

(package private) abstract byte[]	convertFromJavaString(java.lang.String sourceString)
(package private) abstract void	convertFromJavaString(java.lang.String sourceString, java.nio.ByteBuffer buffer) Convert a Java String into bytes for a particular ccsid.
(package private) abstract java.lang.String	convertToJavaString(byte[] sourceBytes)
(package private) abstract java.lang.String	convertToJavaString(byte[] sourceBytes, int offset, int numToConvert) Convert a byte array representing characters in a particular ccsid into a Java String.
(package private) abstract int	getByteLength(java.lang.String str) Returns the length in bytes for the String str using a particular ccsid.

Methods inherited from class java.lang.Object

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

Field Detail

space

byte space

dot

byte dot

numToCharRepresentation

byte[] numToCharRepresentation

UTF8_CCSID

public static final int UTF8_CCSID

See Also:

Constant Field Values

Constructor Detail

CcsidManager

CcsidManager(byte space,
             byte dot,
             byte[] numToCharRepresentation)

Method Detail

getByteLength

abstract int getByteLength(java.lang.String str)

Returns the length in bytes for the String str using a particular ccsid.

Parameters:

str - The Java String from which to obtain the length.

Returns:

The length in bytes of the String str.

convertFromJavaString

abstract byte[] convertFromJavaString(java.lang.String sourceString)

convertFromJavaString

abstract void convertFromJavaString(java.lang.String sourceString,
                                    java.nio.ByteBuffer buffer)

Convert a Java String into bytes for a particular ccsid. The String is converted into a buffer provided by the caller.

Parameters:

sourceString - A Java String to convert.

buffer - The buffer to convert the String into.

convertToJavaString

abstract java.lang.String convertToJavaString(byte[] sourceBytes)

convertToJavaString

abstract java.lang.String convertToJavaString(byte[] sourceBytes,
                                              int offset,
                                              int numToConvert)

Convert a byte array representing characters in a particular ccsid into a Java String. Mind the fact that for certain encodings (e.g. UTF8), the offset and numToConvert actually represent characters and 1 character does not always equal to 1 byte.

Parameters:

sourceBytes - An array of bytes to be converted.

offset - An offset indicating first byte to convert.

numToConvert - The number of bytes to be converted.

Returns:

A new Java String Object created after conversion.