クラスBase64.Encoder

java.lang.Object

java.util.Base64.Encoder

含まれているクラス:

Base64

public static class Base64.Encoder extends Object

このクラスは、RFC 4648およびRFC 2045に指定されているBase64エンコーディング・スキー� を使用してバイト・データをエンコードするためのエンコーダを実装します。

Base64.Encoderクラスのインスタンスは、複数のスレッドで並行して使用できます。

特に指定がないかぎり、null引数をこのクラスのメソッドに渡すと、NullPointerExceptionがスローされます。

必要なサイズのエンコードされたバイト出力を割り当てることができない� �合、このクラスのエンコード・メソッドによってOutOfMemoryErrorがスローされます。

導入されたバージョン:

1.8

関連� �目:

• Base64.Decoder

メソッドのサマリー

修飾子と型	メソッド	説明
byte[]	encode(byte[] src)	Base64エンコーディング・スキー� を使用して、指定されたバイト配列からのすべてのバイトをエンコードし、新しく割り当てられたバイト配列に書き込みます。
int	encode(byte[] src, byte[] dst)	Base64エンコーディング・スキー� を使用して、指定されたバイト配列からのすべてのバイトをエンコードし、結果となるバイトを指定された出力バイト配列のオフセット0から書き込みます。
ByteBuffer	encode(ByteBuffer buffer)	Base64エンコーディング方式を使用して、指定されたByteBufferからの残りのすべてのバイトを新しく割り当てられたByteBufferにエンコードします。
String	encodeToString(byte[] src)	Base64エンコーディング・スキー� を使用して、指定されたバイト配列をStringにエンコードします。
Base64.Encoder	withoutPadding()	これと同じ方法� が、エンコードされたバイト・データの末尾にパディング文字を追� せずにエンコードするエンコーダ・インスタンスを返します。
OutputStream	wrap(OutputStream os)	Base64エンコーディング・スキー� を使用してバイト・データをエンコードするための出力ストリー� をラップします。

クラスjava.lang.Objectで宣言されたメソッド

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

メソッドの詳細

encode

public byte[] encode(byte[] src)

Base64エンコーディング・スキー� を使用して、指定されたバイト配列からのすべてのバイトをエンコードし、新しく割り当てられたバイト配列に書き込みます。 返されるバイト配列の長さは、結果となるバイトの長さになります。

パラメータ:

src - エンコードするバイト配列

戻り値:

結果となるエンコードされたバイトを� �納する、新しく割り当てられたバイト配列。

encode

public int encode(byte[] src, byte[] dst)

Base64エンコーディング・スキー� を使用して、指定されたバイト配列からのすべてのバイトをエンコードし、結果となるバイトを指定された出力バイト配列のオフセット0から書き込みます。

出力バイト配列dstに、入力バイト配列からのすべてのバイトをエンコードできる� けの十分な� �域があることを確認するのは、このメソッドの呼出し側の責任です。 出力バイト配列に十分な大きさがない� �合、その出力バイト配列にバイトは書き込まれません。

パラメータ:

src - エンコードするバイト配列

dst - 出力バイト配列

戻り値:

出力バイト配列に書き込まれるバイト数

スロー:

IllegalArgumentException - dstに、すべての入力バイトをエンコードできる� けの十分な� �域がない� �合。

encodeToString

public String encodeToString(byte[] src)

Base64エンコーディング・スキー� を使用して、指定されたバイト配列をStringにエンコードします。

このメソッドはまず、すべての入力バイトをエンコードして、base64でエンコードされたバイト配列に� �納し、次にそのエンコードされたバイト配列およびISO-8859-1文字セットを使用して新しいStringを構築します。

つまり、このメソッドの呼出しには、new String(encode(src), StandardCharsets.ISO_8859_1)を呼び出すのとまったく同じ効果があります。

パラメータ:

src - エンコードするバイト配列

戻り値:

結果となるBase64でエンコードされた文字を� �納するString

encode

public ByteBuffer encode(ByteBuffer buffer)

Base64エンコーディング方式を使用して、指定されたByteBufferからの残りのすべてのバイトを新しく割り当てられたByteBufferにエンコードします。 復帰時に、ソース・バッファの位置はそのリミットに更新されますが、リミットは変更されません。 返される出力バッファの位置はゼロになり、そのリミットは結果となるエンコードされたバイトの数になります。

パラメータ:

buffer - エンコードするソースByteBuffer

戻り値:

エンコードされたバイトを� �納する、新しく割り当てられたバイト・バッファ。

wrap

public OutputStream wrap(OutputStream os)

Base64エンコーディング・スキー� を使用してバイト・データをエンコードするための出力ストリー� をラップします。

使用後は返された出力ストリー� をた� ちに閉じることをお薦めします。使用中は、残りのすべてのバイトがベースとなる出力ストリー� にフラッシュされます。 返された出力ストリー� を閉じると、ベースとなる出力ストリー� が閉じます。

パラメータ:

os - 出力ストリー� 。

戻り値:

バイト・データをエンコードして指定されたBase64エンコード形式にするための出力ストリー�

withoutPadding

public Base64.Encoder withoutPadding()

これと同じ方法� が、エンコードされたバイト・データの末尾にパディング文字を追� せずにエンコードするエンコーダ・インスタンスを返します。

このエンコーダ・インスタンスのエンコーディング・スキー� は、この呼出しの影響を受けません。 返されたエンコーダ・インスタンスは、パディングのないエンコード操作に使用するようにしてく� さい。

戻り値:

末尾にパディング文字を追� しないでエンコードする同等のエンコーダ