jp.co.nec.WebOTX.convert.CodeConverter
|
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
java.lang.Object
Unicodeの文字列をEUC、JIPS、JIPS(E)、SJISの文字列に変換する機能および、EUC、JIPS、JIPS(E)、SJISの文字列をUnicodeの文字列に変換する機能を提供します。
変換前の文字列をコンストラクタ・setStringメソッド・setBytesメソッドの引数で指定し、Stringを構築します。
引数の型がbyte[]の場合は、引数で指定した文字エンコーディングを使用して、Unicodeに変換しStringに構築します。
引数の型がStringの場合は、変換前のデータがUnicodeのときに使用するためのメソッドで、引数で指定した値をそのままStringに構築します。
構築したStringを以降「Unicode文字列」と表記します。
変換後の文字列は、変換前の文字列を設定しているオブジェクトのgetStringメソッド・getBytesメソッドの戻り値または引数で取得します。
String unicode = "あA";
CodeConverter cc = new CodeConverter();
cc.setString(unicode);
cc.setEncoding("JIPSE");
cc.setJISType(CodeConverter.JISX0208_1978);
byte[] jipse = cc.getBytes(CodeConverter.MIXTYPE_MIX);
byte[] jipse = new byte[] {(byte)0x3F, (byte)0x75, (byte)0xE0, (byte)0x7F, (byte)0x3F, (byte)0x76, (byte)0xC1};
CodeConverter cc = new CodeConverter();
cc.setEncoding("JIPSE");
cc.setJISType(CodeConverter.JISX0208_1978);
cc.setBytes(jipse, CodeConverter.MIXTYPE_MIX);
String unicode = cc.getString();
| フィールドの概要 | |
static int |
ALIGN_LEFT
配置位置は「左詰め」です。 |
static int |
ALIGN_RIGHT
配置位置は「右詰め」です。 |
static int |
INVALIDCHARPROCESSTYPE_EXCEPTION
コード変換後の文字コードに不正文字が存在した場合の処理種別はExceptionをスローします。 |
static int |
INVALIDCHARPROCESSTYPE_REPLACE
コード変換後の文字コードに不正文字が存在した場合の処理種別は指定されている不正文字に置き換えて返します。 |
static int |
JISX0208_1978
JIS年度種別は「JIS X 0208-1978」です。 |
static int |
JISX0208_1983
JIS年度種別は「JIS X 0208-1983」です。 |
static int |
JISX0208_1990
JIS年度種別は「JIS X 0208-1990」です。 |
static java.lang.String |
LINESEPARATOR
システムプロパティの "line.separator"「行区切り文字」です。 |
static int |
MIXTYPE_2BYTE
混在種別は「2バイトのみ」です。 |
static int |
MIXTYPE_ANK
混在種別は「ANKのみ」です。 |
static int |
MIXTYPE_MIX
混在種別は「混在」です。 |
static int |
PADDINGAREALACKPROCESSTYPE_CANCEL
コード変換後のデータを格納する領域が不足した場合の処理種別は格納する領域に設定可能なデータまでを設定し、残りのデータは破棄します。 |
static int |
PADDINGAREALACKPROCESSTYPE_EXCEPTION
コード変換後のデータを格納する領域が不足した場合の処理種別はExceptionをスローします。 |
| コンストラクタの概要 | |
CodeConverter()
空文字の新しい Stringを構築し、Unicode文字列を作成します。 |
|
CodeConverter(byte[] inBytes,
int offset,
int length,
java.lang.String enc,
int jisType,
int mix)
指定した文字エンコーディングを使用して、指定したバイト部分配列を変換することによって、新しい Stringを構築し、Unicode文字列を作成します。 |
|
CodeConverter(byte[] inBytes,
java.lang.String enc,
int jisType,
int mix)
指定した文字エンコーディングを使用して、指定したバイト配列の変換を行うことによって、新しい Stringを構築し、Unicode文字列を作成します。 |
|
CodeConverter(char[] value)
指定した文字配列の新しい Stringを構築し、Unicode文字列を作成します。 |
|
CodeConverter(java.lang.String value)
指定した文字列の新しい Stringを構築し、Unicode文字列を作成します。 |
|
| メソッドの概要 | |
void |
getBytes(byte[] outBytes,
int mix,
int align)
Unicode文字列を指定した文字エンコーディングに従ってバイトに変換し、結果を指定した結果のバイト配列を格納する領域に設定します。 |
void |
getBytes(byte[] outBytes,
int offset,
int length,
int mix,
int align)
Unicode文字列を指定した文字エンコーディングに従ってバイトに変換し、結果を指定した部分のバイトデータを指定した結果のバイト配列を格納する領域に設定します。 |
byte[] |
getBytes(int mix)
Unicode文字列を指定した文字エンコーディングに従ってバイトに変換し、結果をバイト配列で返します。 |
java.lang.String |
getEncoding()
文字エンコーディングの名前を返します。 |
int |
getGetBytesMixSpareLength()
混在種別が「混在」で、Unicodeの文字列をEUC、JIPS、JIPS(E)、SJISの文字列に変換する場合に、変換結果のバイト配列の予備の領域の長さを返します。 |
int |
getInvalidCharProcessType()
コード変換後の文字コードに不正文字が存在した場合の処理種別を返します。 |
int |
getJISType()
JIS年度種別を返します。 |
int |
getPaddingAreaLackProcessType()
コード変換後のデータを格納する領域が不足した場合の処理種別を返します。 |
char |
getPaddingChar1()
1バイトのパディング文字を返します。 |
char |
getPaddingChar2()
2バイトのパディング文字を返します。 |
char |
getReplaceInvalidChar1()
不正文字が存在した場合の1バイトの置き換え文字を返します。 |
char |
getReplaceInvalidChar2()
不正文字が存在した場合の2バイトの置き換え文字を返します。 |
java.lang.String |
getString()
Unicode文字列を返します。 |
static void |
initialize(java.lang.String enc,
int jisType)
事前に変換テーブルをメモリにロードします。 |
int |
length()
Unicode文字列の長さを返します。 |
void |
setBytes(byte[] inBytes,
int mix)
指定した文字エンコーディングを使用して、指定したバイト配列の変換を行うことによって、Unicode文字列を設定します。 |
void |
setBytes(byte[] inBytes,
int offset,
int length,
int mix)
指定した文字エンコーディングを使用して、指定したバイト部分配列を変換することによって、Unicode文字列を設定します。 |
void |
setChars(char[] value)
指定した文字配列のUnicode文字列を設定します。 |
void |
setEncoding(java.lang.String value)
文字エンコーディングの名前を設定します。 |
void |
setGetBytesMixSpareLength(int value)
混在種別が「混在」で、Unicodeの文字列をEUC、JIPS、JIPS(E)、SJISの文字列に変換する場合に、変換結果のバイト配列の予備の領域の長さを設定します。 |
void |
setInvalidCharProcessType(int value)
コード変換後の文字コードに不正文字が存在した場合の処理種別を設定します。 |
void |
setJISType(int value)
JIS年度種別を設定します。 |
void |
setPaddingAreaLackProcessType(int value)
コード変換後のデータを格納する領域が不足した場合の処理種別を設定します。 |
void |
setPaddingChar1(char value)
1バイトのパディング文字を設定します。 |
void |
setPaddingChar2(char value)
2バイトのパディング文字を設定します。 |
void |
setReplaceInvalidChar1(char value)
不正文字が存在した場合の1バイトの置き換え文字を設定します。 |
void |
setReplaceInvalidChar2(char value)
不正文字が存在した場合の2バイトの置き換え文字を設定します。 |
void |
setString(java.lang.String value)
Unicode文字列を設定します。 |
java.lang.String |
toString()
Unicode文字列を返します。 |
| クラス java.lang.Object から継承したメソッド |
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| フィールドの詳細 |
public static final java.lang.String LINESEPARATOR
"line.separator"「行区切り文字」です。
public static final int JISX0208_1978
public static final int JISX0208_1983
public static final int JISX0208_1990
public static final int MIXTYPE_ANK
public static final int MIXTYPE_2BYTE
public static final int MIXTYPE_MIX
public static final int ALIGN_LEFT
public static final int ALIGN_RIGHT
public static final int INVALIDCHARPROCESSTYPE_EXCEPTION
public static final int INVALIDCHARPROCESSTYPE_REPLACE
public static final int PADDINGAREALACKPROCESSTYPE_EXCEPTION
public static final int PADDINGAREALACKPROCESSTYPE_CANCEL
| コンストラクタの詳細 |
public CodeConverter()
throws CodeConverterException
Stringを構築し、Unicode文字列を作成します。
CodeConverterException - 次のいずれかの場合
public CodeConverter(java.lang.String value)
throws CodeConverterException
Stringを構築し、Unicode文字列を作成します。
value - 文字列
CodeConverterException - 次のいずれかの場合
nullの場合
public CodeConverter(char[] value)
throws CodeConverterException
Stringを構築し、Unicode文字列を作成します。
value - 文字配列
CodeConverterException - 次のいずれかの場合
nullの場合
public CodeConverter(byte[] inBytes,
java.lang.String enc,
int jisType,
int mix)
throws CodeConverterException
Stringを構築し、Unicode文字列を作成します。
inBytes - Unicode文字列に変換するバイト配列enc - サポートする文字エンコーディングの名前
| 指定値 | 内容 |
|---|---|
"EUC" | EUC |
"JIPS" | JIPS |
"JIPSE" | JIPS(E) |
"SJIS" | SJIS |
jisType - サポートするJIS年度種別
| 指定値 | 内容 |
|---|---|
JISX0208_1978 | JIS X 0208-1978 |
JISX0208_1983 | JIS X 0208-1983 |
JISX0208_1990 | JIS X 0208-1990 |
mix - サポートする混在種別
| 指定値 | 内容 |
|---|---|
MIXTYPE_ANK | ANKのみ |
MIXTYPE_2BYTE | 2バイトのみ |
MIXTYPE_MIX | 混在 |
CodeConverterException - 次のいずれかの場合
nullの場合
public CodeConverter(byte[] inBytes,
int offset,
int length,
java.lang.String enc,
int jisType,
int mix)
throws CodeConverterException
Stringを構築し、Unicode文字列を作成します。
inBytes - Unicode文字列に変換するバイト配列offset - 変換を行う先頭のバイトのインデックスlength - 変換を行うバイト数enc - サポートする文字エンコーディングの名前
| 指定値 | 内容 |
|---|---|
"EUC" | EUC |
"JIPS" | JIPS |
"JIPSE" | JIPS(E) |
"SJIS" | SJIS |
jisType - サポートするJIS年度種別
| 指定値 | 内容 |
|---|---|
JISX0208_1978 | JIS X 0208-1978 |
JISX0208_1983 | JIS X 0208-1983 |
JISX0208_1990 | JIS X 0208-1990 |
mix - サポートする混在種別
| 指定値 | 内容 |
|---|---|
MIXTYPE_ANK | ANKのみ |
MIXTYPE_2BYTE | 2バイトのみ |
MIXTYPE_MIX | 混在 |
CodeConverterException - 次のいずれかの場合
nullの場合offset引数およびlength引数のインデックスによる文字列がinBytes配列の範囲外となる場合| メソッドの詳細 |
public static void initialize(java.lang.String enc,
int jisType)
throws CodeConverterException
enc - サポートする文字エンコーディングの名前
| 指定値 | 内容 |
|---|---|
"EUC" | EUC |
"JIPS" | JIPS |
"JIPSE" | JIPS(E) |
"SJIS" | SJIS |
jisType - サポートするJIS年度種別
| 指定値 | 内容 |
|---|---|
JISX0208_1978 | JIS X 0208-1978 |
JISX0208_1983 | JIS X 0208-1983 |
JISX0208_1990 | JIS X 0208-1990 |
CodeConverterException - 次のいずれかの場合
public int length()
public void setString(java.lang.String value)
throws CodeConverterException
value - 文字列
CodeConverterException - 次のいずれかの場合
nullの場合
public java.lang.String getString()
throws CodeConverterException
CodeConverterExceptionpublic java.lang.String toString()
public void setChars(char[] value)
throws CodeConverterException
value - 文字配列
CodeConverterException - 次のいずれかの場合
nullの場合
public void setBytes(byte[] inBytes,
int mix)
throws CodeConverterException
inBytes - Unicode文字列に変換するバイト配列mix - サポートする混在種別
| 指定値 | 内容 |
|---|---|
MIXTYPE_ANK | ANKのみ |
MIXTYPE_2BYTE | 2バイトのみ |
MIXTYPE_MIX | 混在 |
CodeConverterException - 次のいずれかの場合
nullの場合
public void setBytes(byte[] inBytes,
int offset,
int length,
int mix)
throws CodeConverterException
inBytes - Unicode文字列に変換するバイト配列offset - 変換を行う先頭のバイトのインデックスlength - 変換を行うバイト数mix - サポートする混在種別
| 指定値 | 内容 |
|---|---|
MIXTYPE_ANK | ANKのみ |
MIXTYPE_2BYTE | 2バイトのみ |
MIXTYPE_MIX | 混在 |
CodeConverterException - 次のいずれかの場合
nullの場合offset引数およびlength引数のインデックスによる文字列がinBytes配列の範囲外となる場合
public byte[] getBytes(int mix)
throws CodeConverterException
mix - サポートする混在種別
| 指定値 | 内容 |
|---|---|
MIXTYPE_ANK | ANKのみ |
MIXTYPE_2BYTE | 2バイトのみ |
MIXTYPE_MIX | 混在 |
CodeConverterException - 次のいずれかの場合
public void getBytes(byte[] outBytes,
int mix,
int align)
throws CodeConverterException
outBytes - 結果のバイト配列を格納する領域mix - サポートする混在種別
| 指定値 | 内容 |
|---|---|
MIXTYPE_ANK | ANKのみ |
MIXTYPE_2BYTE | 2バイトのみ |
MIXTYPE_MIX | 混在 |
align - サポートする配置位置
| 指定値 | 内容 |
|---|---|
ALIGN_LEFT | コード変換後のデータを左詰めで設定し、残りはパディング文字を設定します。 |
ALIGN_RIGHT | コード変換後のデータを右詰めで設定し、残りはパディング文字を設定します。 |
CodeConverterException - 次のいずれかの場合
nullの場合
public void getBytes(byte[] outBytes,
int offset,
int length,
int mix,
int align)
throws CodeConverterException
outBytes - 結果のバイト配列を格納する領域offset - 変換後のデータを格納する先頭のバイトのインデックスlength - 変換後のデータを格納するバイト数mix - サポートする混在種別
| 指定値 | 内容 |
|---|---|
MIXTYPE_ANK | ANKのみ |
MIXTYPE_2BYTE | 2バイトのみ |
MIXTYPE_MIX | 混在 |
align - サポートする配置位置
| 指定値 | 内容 |
|---|---|
ALIGN_LEFT | コード変換後のデータを左詰めで設定し、残りはパディング文字を設定します。 |
ALIGN_RIGHT | コード変換後のデータを右詰めで設定し、残りはパディング文字を設定します。 |
CodeConverterException - 次のいずれかの場合
nullの場合offset引数およびlength引数のインデックスによる文字列が変換したバイト配列の範囲外となる場合public void setEncoding(java.lang.String value)
value - サポートする文字エンコーディングの名前
| 指定値 | 内容 |
|---|---|
"EUC" | EUC |
"JIPS" | JIPS |
"JIPSE" | JIPS(E)（既定値） |
"SJIS" | SJIS |
public java.lang.String getEncoding()
setEncoding(String value)public void setJISType(int value)
value - サポートするJIS年度種別
| 指定値 | 内容 |
|---|---|
JISX0208_1978 | JIS X 0208-1978（既定値） |
JISX0208_1983 | JIS X 0208-1983 |
JISX0208_1990 | JIS X 0208-1990 |
public int getJISType()
setJISType(int value)
public void setInvalidCharProcessType(int value)
throws CodeConverterException
value - サポートする処理種別
| 指定値 | 内容 |
|---|---|
INVALIDCHARPROCESSTYPE_EXCEPTION | Exceptionをスローします。（既定値） |
INVALIDCHARPROCESSTYPE_REPLACE | 指定されている不正文字に置き換えて返します。 |
CodeConverterException - 次のいずれかの場合
public int getInvalidCharProcessType()
setInvalidCharProcessType(int value)public void setReplaceInvalidChar1(char value)
char型の文字は第1バイトが0x00であるかなど、文字のチェックは行いません。
指定する文字は1バイトの文字を設定してください。'?'です。
value - 1バイトの置き換え文字public char getReplaceInvalidChar1()
setReplaceInvalidChar1(char value)public void setReplaceInvalidChar2(char value)
char型の文字は第1バイトが0x00であるかなど、文字のチェックは行いません。
指定する文字は2バイトの文字を設定してください。'？'です。
value - 2バイトの置き換え文字public char getReplaceInvalidChar2()
setReplaceInvalidChar2(char value)
public void setPaddingAreaLackProcessType(int value)
throws CodeConverterException
value - サポートする処理種別
| 指定値 | 内容 |
|---|---|
PADDINGAREALACKPROCESSTYPE_EXCEPTION | Exceptionをスローします。（既定値） |
PADDINGAREALACKPROCESSTYPE_CANCEL | 格納する領域に設定可能なデータまでを設定し、残りのデータは破棄します。 |
CodeConverterException - 次のいずれかの場合
public int getPaddingAreaLackProcessType()
setPaddingAreaLackProcessType(int value)public void setPaddingChar1(char value)
char型の文字は第1バイトが0x00であるかなど、文字のチェックは行いません。
指定する文字は1バイトの文字を設定してください。
value - 1バイトのパディング文字public char getPaddingChar1()
setPaddingChar1(char value)public void setPaddingChar2(char value)
char型の文字は第1バイトが0x00であるかなど、文字のチェックは行いません。
指定する文字は2バイトの文字を設定してください。
value - 2バイトのパディング文字public char getPaddingChar2()
setPaddingChar2(char value)
public void setGetBytesMixSpareLength(int value)
throws CodeConverterException
value - 変換結果のバイト配列の予備の領域の長さ
CodeConverterException - 次のいずれかの場合
public int getGetBytesMixSpareLength()
setGetBytesMixSpareLength(int value)
|
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||