intra-mart(R)
5.1

jp.co.intra_mart.foundation.utility.charset
クラス CharacterEncoder

java.lang.Object
  拡張jp.co.intra_mart.foundation.utility.charset.CharacterEncoder

推奨されていません。 jp.co.intra_mart.common.aid.jdk.util.charset.CharacterEncoder クラスを使用してください。

public class CharacterEncoder
extends java.lang.Object

このクラスは、文字エンコードの機能を提供します。

このクラスは、Java runtime が提供する通常の文字コード変換において 文字のマッピング定義の相違に起因して文字化けしてしまう現象を解決するための 一つの方法となります。 実際には、定義ファイルに設定されている文字をネイティブコードへ変換する前に 他の文字へ変更する事により、文字化けを防ぎます。

例えば、EUC_JP における文字「〜」は、 Unicode へ変換した際 0x301C(Wave Dash) にマッピングされます。 これに対して、SJIS では文字「〜」は、 Unicode の 0xFF5E(Fullwidth Tilde) にマッピングされています。 このため、相互に文字コード変換をすると、 文字「?」に置き換わると言う現象(いわゆる文字化け)が発生します。
このクラスでは、Unicode から SJIS へ変換する際に Unicode の文字 0x301C(Wave Dash) を 0xFF5E(Fullwidth Tilde) へ変更してから 文字コード変換を行います。

定義ファイルは、クラスローダを利用して検索および読み込まれます。 したがって、定義ファイルはクラスパスに設定されているディレクトリまたは アーカイブファイル内に配置する必要があります。
各文字エンコーディングと文字の変換テーブルの関連については、 定義ファイル jp/co/intra_mart/resources/charset/encoding/mapping.xml に記載されています。

導入されたバージョン:
version4.3
関連項目:
CharacterEncoder, ResourceNotFoundException, ResourceFormatException

コンストラクタの概要
CharacterEncoder(java.lang.String enc)
          推奨されていません。 文字コード変換のためのエンコーダを作成します。
 
メソッドの概要
 byte[] encode(char c)
          推奨されていません。 指定の文字を getCharacterEncoding() で表される文字コードへ エンコードします。
 byte[] encode(char[] c)
          推奨されていません。 指定の文字を getCharacterEncoding() で表される文字コードへ エンコードします。
 byte[] encode(java.lang.String str)
          推奨されていません。 指定の文字列を getCharacterEncoding() で表される文字コードへ エンコードします。
 java.lang.String getCharacterEncoding()
          推奨されていません。 このオブジェクトが対象としている文字エンコーディング名を返します。
 java.lang.String newString(char[] c)
          推奨されていません。 getCharacterEncoding() で表される文字コードに対応した 新しい文字列を作成します。
 java.lang.String newString(java.lang.String str)
          推奨されていません。 getCharacterEncoding() で表される文字コードに対応した 新しい文字列を作成します。
protected  void setCharacterEncoding(java.lang.String enc)
          推奨されていません。 このオブジェクトが対象とする文字エンコーディングを設定します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

CharacterEncoder

public CharacterEncoder(java.lang.String enc)
                 throws ResourceNotFoundException,
                        ResourceFormatException,
                        java.io.IOException
推奨されていません。 
文字コード変換のためのエンコーダを作成します。

パラメータ:
enc - エンコーディング名
例外:
java.lang.NullPointerException - 引数が null の場合
ResourceNotFoundException - 設定が見つからなかった場合
ResourceFormatException - 設定情報が不適切だった場合
java.io.IOException - 入出力エラー
メソッドの詳細

getCharacterEncoding

public java.lang.String getCharacterEncoding()
推奨されていません。 
このオブジェクトが対象としている文字エンコーディング名を返します。

戻り値:
文字エンコーディング名

setCharacterEncoding

protected void setCharacterEncoding(java.lang.String enc)
                             throws ResourceFormatException,
                                    ResourceNotFoundException,
                                    java.io.IOException
推奨されていません。 
このオブジェクトが対象とする文字エンコーディングを設定します。

パラメータ:
enc - エンコーディング名
例外:
java.lang.NullPointerException - 引数が null の場合
ResourceNotFoundException - 設定が見つからなかった場合
ResourceFormatException - 設定情報が不適切だった場合
java.io.IOException - 入出力エラー

encode

public byte[] encode(char c)
              throws java.io.UnsupportedEncodingException,
                     java.io.IOException
推奨されていません。 
指定の文字を getCharacterEncoding() で表される文字コードへ エンコードします。

パラメータ:
c - 文字
戻り値:
エンコードされたバイト列
例外:
java.io.UnsupportedEncodingException
java.io.IOException

encode

public byte[] encode(char[] c)
              throws java.io.UnsupportedEncodingException,
                     java.io.IOException
推奨されていません。 
指定の文字を getCharacterEncoding() で表される文字コードへ エンコードします。

パラメータ:
c - 文字配列
戻り値:
エンコードされたバイト列
例外:
java.io.UnsupportedEncodingException
java.io.IOException

encode

public byte[] encode(java.lang.String str)
              throws java.io.UnsupportedEncodingException,
                     java.io.IOException
推奨されていません。 
指定の文字列を getCharacterEncoding() で表される文字コードへ エンコードします。

パラメータ:
str - 文字列
戻り値:
エンコードされたバイト列
例外:
java.io.UnsupportedEncodingException
java.io.IOException

newString

public java.lang.String newString(java.lang.String str)
推奨されていません。 
getCharacterEncoding() で表される文字コードに対応した 新しい文字列を作成します。

返される文字列は、引数 str のマッピングを修正した 新しい文字列です。

パラメータ:
str - 文字列
戻り値:
マッピングを修正された新しい文字列

newString

public java.lang.String newString(char[] c)
推奨されていません。 
getCharacterEncoding() で表される文字コードに対応した 新しい文字列を作成します。

返される文字列は、引数 c のマッピングを修正した 新しい文字列です。
引数の配列 c は変化しません。

パラメータ:
c - 文字配列
戻り値:
新しい文字列

intra-mart(R)
5.1

Copyright © 2000-2006 NTT DATA INTRAMART CO.,LTD. All Rights Reserved.