weblogic.wtc.jatmi

Class MBEncoding

java.lang.Object

weblogic.wtc.jatmi.MBEncoding

All Implemented Interfaces:

java.io.Serializable

public final class MBEncoding
extends java.lang.Object
implements java.io.Serializable

This class provides the utilities for handling the encoding name for MBSTRING data. Since the encoding names for the same character set often differ between Java and Tuxedo(iconv), the encoding name mapping between Java and Tuxedo is necessary when a MBSTRING data is sent to or received from the Tuxedo server. With the methods of this class, the WTC application which uses the MBSTRING data need to setup the appropriate mapping information between Java and Tuxedo encoding name. In addition, the default Tuxedo encoding name to which the MBSTRING data is converted when it is sent to the Tuxedo server can be specified.

See Also:

Serialized Form

Excluded in public API Reference.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	MBEncoding.MapEntry

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.Hashtable	default_j2tmap
private static java.lang.String	default_mbencoding
private static java.util.Hashtable	default_t2jmap
private static MBEncoding.MapEntry[]	defaultEntries
private static java.util.Hashtable	j2tmap
private static java.lang.String	MBENCODINGMAPPROPERTY
private static java.lang.String	MBENCODINGPROPERTY
private static long	serialVersionUID
private static java.util.Hashtable	t2jmap

Constructor Summary

Constructors

Constructor and Description
MBEncoding()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	checkMBEncoding(java.lang.String tuxedoEncoding) Check if the specified Tuxedo encoding name is valid.
static java.lang.String	getDefaultMBEncoding() Get the default Tuxedo encoding name to which the MBSTRING data sent to the Tuxedo server is converted.
static java.lang.String	mapJavaToTuxedo(java.lang.String javaEncoding) Map the Java encoding name to the corresponding Tuxedo encoding name.
static java.lang.String	mapTuxedoToJava(java.lang.String tuxedoEncoding) Map the Tuxedo encoding name to the corresponding Java encoding name.
static void	setDefaultMBEncoding(java.lang.String tuxedoEncoding) Set the default Tuxedo encoding name to which the MBSTRING data sent to the Tuxedo server is converted.
static void	setMBEncodingMapFile(java.lang.String mapfile) Set the map file path used for mapping between Java and Tuxedo encoding name.

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

MBENCODINGPROPERTY

private static final java.lang.String MBENCODINGPROPERTY

See Also:

Constant Field Values

MBENCODINGMAPPROPERTY

private static final java.lang.String MBENCODINGMAPPROPERTY

See Also:

Constant Field Values

defaultEntries

private static MBEncoding.MapEntry[] defaultEntries

default_t2jmap

private static java.util.Hashtable default_t2jmap

default_j2tmap

private static java.util.Hashtable default_j2tmap

t2jmap

private static java.util.Hashtable t2jmap

j2tmap

private static java.util.Hashtable j2tmap

default_mbencoding

private static java.lang.String default_mbencoding

Constructor Detail

MBEncoding

public MBEncoding()

Method Detail

setMBEncodingMapFile

public static void setMBEncodingMapFile(java.lang.String mapfile)

Set the map file path used for mapping between Java and Tuxedo encoding name. The mapfile path set by this method overrides the mapfile path specified by the weblogic.wtc.mbencodingmap system property. The default map file path is "WL_HOME/server/lib/mbencmap".

Parameters:

mapfile - The map file path.

mapTuxedoToJava

public static java.lang.String mapTuxedoToJava(java.lang.String tuxedoEncoding)

Map the Tuxedo encoding name to the corresponding Java encoding name. If mapping for the specified Tuxedo encoding name is not defined, the Tuxedo encoding name itself is returned.

Parameters:

tuxedoEncoding - The Tuxedo encoding name.

Returns:

The corresponding Java encoding name.

mapJavaToTuxedo

public static java.lang.String mapJavaToTuxedo(java.lang.String javaEncoding)

Map the Java encoding name to the corresponding Tuxedo encoding name. If mapping for the specified Java encoding name is not defined, the Java encoding name itself is returned.

Parameters:

javaEncoding - The Java encoding name.

Returns:

The corresponding Tuxedo encoding name.

setDefaultMBEncoding

public static void setDefaultMBEncoding(java.lang.String tuxedoEncoding)

Set the default Tuxedo encoding name to which the MBSTRING data sent to the Tuxedo server is converted. The encoding name set by this method overrides the encoding name specified by the weblogic.wtc.mbencoding system property.

Parameters:

tuxedoEncoding - The default Tuxedo encoding name used for MBSTRING conversion.

getDefaultMBEncoding

public static java.lang.String getDefaultMBEncoding()

Get the default Tuxedo encoding name to which the MBSTRING data sent to the Tuxedo server is converted. This encoding name is set by the weblogic.wtc.mbencoding system propertyset or the setDefaultMBEncoding method. If the Tuxedo encoding name is not specified by the system property nor the setDefaultMBEncoding method, the default charset name of Java is mapped to the Tuxedo encoding name and used.

Returns:

The default Tuxedo encoding name used for MBSTRING conversion.

checkMBEncoding

public static java.lang.String checkMBEncoding(java.lang.String tuxedoEncoding)

Check if the specified Tuxedo encoding name is valid. If it is valid, the Tuxedo encoding name itself is returned. If it is invalid, null is returned.

Parameters:

tuxedoEncoding - The Tuxedo encoding name checked for validation.

Returns:

The Tuxedo encoding name if it is valid. Null if it is invalid.