Javaの文字コード指定について

Question

Javaで文字コードを指定してファイル出力をする際に以下のようなプログラムを書くかと思います。

			OutputStreamWriter osw = new OutputStreamWriter(new FileOutputStream("sample.txt"), "SHIFT-JIS");
			BufferedWriter bf = new BufferedWriter(osw);
			
	        bf.write("hello world");

BufferedWriterの役割は理解しているつもりなのですが、FileOutputStreamとOutputStreamWriterの役割がいまいちわかっていません。
以下、質問です。
①FileOutputStreamとOutputStreamWriterそれぞれがどのような役割か詳しく教えて頂きたいです。
②FileOutputStreamはバイトコードの書き込みと調べました。通常テキストファイルはFileWriterを使うものと認識していますが、どちらを使用してもよいのでしょうか。

ちなみに自分の認識は以下の通りです。
・FileOutputStream : 文字ストリームからバイトストリームへの変換を担っている？
・OutputStreamWriter : 変換したバイトストリームを、指定した文字コードでのバイトストリームに変換？

Comments

[maisumakun]

何か参考に読んだものなどはありますか？

Answer 1

apiの解説に大体そのまま書いてありますが、

①
・OutputStreamWriter
文字ストリームからバイト・ストリームへの橋渡しの役目を持っています。
文字コードを指定して書き出したい時に内部的にバイトコードの変換をしないといけないので、
その役割を持ったクラスというところでしょうか。

・FileOutputStream
バイト・ストリーム形式の情報をファイルに書き込む時に使用します。
画像ファイルなどのバイナリ形式の物や
前述のOutputStreamWriterクラスでエンコードされたバイトコードが対象になります。

・FileWriter
文字をデフォルトエンコードでそのままファイルに書き出す時に使います。
このクラスのコンストラクタには文字コードが指定できません。

②
①である程度説明してますが、FileWriterクラスで書き込めるのはデフォルトエンコードでの文字に限られます。
バイナリ形式の物や、エンコードを指定したい場合はFileOutputStreamを使うことになります。

Comments

[kobe2018]

説明頂き、ありがとうございます。
自分もAPIリファレンスは読んだのですが、それだけだといまいちイメージがつきませんでした。

＞・OutputStreamWriter
＞文字ストリームからバイト・ストリームへの橋渡しの役目を持っています。
＞文字コードを指定して書き出したい時に内部的にバイトコードの変換をしないといけないので、
＞その役割を持ったクラスというところでしょうか。

2行目はAPIリファレンスにとても近い表現だと思います。
そしてそこが疑問点でした。
OutputStreamWriterはコンストラクタの引数にFileOutputStreamを持ちます。
FileOutputStreamはバイトストリーム形式の情報を書き込むときに使用するとあります。
となると、OutputStreamWriterはバイトストリーム形式の情報を受け取っていると考えられます。
なのでバイトストリーム→文字ストリームの変換ではないのかなと思いました。
（APIリファレンスでは文字ストリーム→バイトストリームの変換ですよね）

＞・FileOutputStream
＞バイト・ストリーム形式の情報をファイルに書き込む時に使用します。
＞画像ファイルなどのバイナリ形式の物や
＞前述のOutputStreamWriterクラスでエンコードされたバイトコードが対象になります。

OutputStreamWriterはFileOutputStreamを引数に持つため、FileOutputStreamがOutputStreamWriterでエンコードされたバイトコードを読み込むことはないのではと感じました。

初心者のため、誤りがあったら申し訳ないです。

[ironya]

`OutputStreamWriter` のコンストラクタに渡す `OutputStream` 型の仮引数は、Javadoc で仮引数名 `out` が示す通り(下の抜粋参照)、`OutputStreamWriter` が書き出す先であって、読み込むことはありません。

もしこの仮引数に渡す `OutputStream` オブジェクトが書き出す先でないとした場合、`OutputStreamWriter` が書き込む先がどこになるのか指定していないことになります。
しかし実際には、 `FileOutputSteram` オブジェクトを作成する際に指定したファイルに対して書きこまれているはずです。このことからも、`OutputStreamWriter` のコンストラクタに渡したオブジェクトを通して書き出していると理解して問題ないでしょう。

Java SE 8 の Javadoc より抜粋
> OutputStreamWriter(OutputStream out, String charsetName)
> 指定された文字セットを使うOutputStreamWriterを作成します。