構造がわからない

Question

import javax.xml.parsers.;
import org.w3c.dom.;
import java.io.*;
public class Main {
public static void main(String[]args)throws Exception{
InputStream is=new FileInputStream("~~~~.xml");
Document doc=DocumentBuilderFactory.newInstance().newDocumentBuilder().parse(is);

最後の文が理解できません。DocumentBuilderFactory.newInstance()でDocumentBuilderFactoryをインスタンスを取得した後、何をしているんですか。
教えてください。

Answer 1

説明が多くなりすぎてうまくまとめられませんでした、話が長くなってしまいますが、
興味があればおつきあいください。

最後の文が理解できません。DocumentBuilderFactory.newInstance()でDocumentBuilderFactoryをインスタンスを取得した後、何をしているんですか。

ご質問のコードは、以下のような定型的な処理を、分かりきった部分をまとめて簡略した記述です
（「~~~~.xml」というファイル名は、ちょっと奇抜すぎたので「a.xml」に代えさせて頂きました。）

import javax.xml.parsers.*;
import org.w3c.dom.*;
import java.io.*;

public class Main {
	public static void main(String[] args) throws Exception {
		// "a.xml" を入力ストリーム is として開く
		InputStream is = new FileInputStream("a.xml");
		
		// DocumentBuilder クラスのインスタンスを生成する DocumentBuilderFactory のインスタンスを生成する
		DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); 
	
		// DocumentBuilderFactory のインスタンスを使って、DocumentBuilderのインスタンスを生成する
		DocumentBuilder builder = factory.newDocumentBuilder();
		
		// DocumentBuilde のインスタンスを使って入力ストリーム is を読み込んで解析し、
		// Documentのインスタンス（をルートとした）HTMLの要素構造の解析結果インスタンスの集合体）
		// を得る
		Document doc = builder.parse(is);
	}
}

「構造がわからない」というタイトルでしたので、この処理に関する構造図（クラス図）を以下に示します。

これらのクラスを使って以下のように必要なインスタンスの取得を行っているのが
このプログラムでしていることの概略です

builder.parse(is) の処理

上の説明では、builder.parse(is) と doc インスタンスの説明を省いているので、
以下にこの点についてもう少し詳しく説明します。
この処理がご質問のコードの本来の目的で、それ以前の処理は準備をしているに過ぎません。

parse という言葉はコンピュータの世界では「構文解析」という意味で使われます。
操作対象がなんらかの人工言語であった場合、ほぼ間違いなくそういう意味です。

ですから、

builder.parse(is)

は is で指定された XML を構文解析して、 doc インスタンスに変換しています。
具体的な例を示して説明します。

XML の内容が以下のようなものであったとします。

<?xml version="1.0" encoding="Shift-Jis" ?>
<root>
	<child01>child1 text</child01>
	<child02>child2 text</child02>
</root>

これに対して以下のようなプログラムを実行したとします。
（上のプログラムに、 doc の内容を表示する処理を追加したものです）

import java.io.FileInputStream;
import java.io.InputStream;

import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;

import org.w3c.dom.Document;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;

public class Main {
	public static void main(String[] args) throws Exception {
		// "a.xml" を入力ストリーム is として開く
		InputStream is = new FileInputStream("a.xml");
		
		// DocumentBuilder クラスのインスタンスを生成する DocumentBuilderFactory のインスタンスを生成する
		DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); 
	
		// DocumentBuilderFactory のインスタンスを使って、DocumentBuilderのインスタンスを生成する
		DocumentBuilder builder = factory.newDocumentBuilder();
		
		// DocumentBuilde のインスタンスを使って入力ストリーム is を読み込んで解析し、
		// Documentのインスタンス（をルートとした）HTMLの要素構造の解析結果インスタンスの集合体）
		// を得る
		Document doc = builder.parse(is);

		
		// doc の中身を見る
		printNodeTypes(doc, "0" );
	}

	private static void printNodeTypes(Node doc, String number_str ) {

		NodeList list = doc.getChildNodes();
		for ( int i = 0; i < list.getLength(); ++i ) {
			Node node = list.item(i);
			System.out.printf("[%s-%d] - [%s]:[%s]\n", number_str, i , node.getNodeName(), node.getNodeValue() );
			printNodeTypes(node, number_str + "-" + Integer.toString(i) );
		}
	}
}

この出力結果は以下のようになります。

[0-0] - [root]:[null]
[0-0-0] - [#text]:[
	]
[0-0-1] - [child01]:[null]
[0-0-1-0] - [#text]:[child1 text]
[0-0-2] - [#text]:[
	]
[0-0-3] - [child02]:[null]
[0-0-3-0] - [#text]:[child2 text]
[0-0-4] - [#text]:[
]

この出力から paser が返した、doc インスタンスの内容を推測しておおまかなオブジェクト図を描くと以下のようになります。

このように、XML を読み込んで解析し、Java のプログラムで扱いやすい Node インターフェースを使ったツリー構造に変換している。

というのが、

最後の文が理解できません。DocumentBuilderFactory.newInstance()でDocumentBuilderFactoryをインスタンスを取得した後、何をしているんですか。

の最終的な答えです。

Answer 2

Document doc=DocumentBuilderFactory.newInstance().newDocumentBuilder().parse(is);

DocumentBuilderFactory.newInstance()でDocumentBuilderFactoryをインスタンスを取得した後、そのDocumentBuilderFactoryから新しいドキュメントビルダーを生成し、その生成したドキュメントビルダーでisのxmlファイルを構文解析してDOMドキュメントを作成し、Document型の変数docに格納していますね。

ざっくりいえば、"~~~~.xml"をDOM Documentに変換して変数docに入れてる文かと思います。

Comments

[sk2938]

ありがとうございました。