トラシスラボ 技術ブログでタグ「Commons Digester」が付けられているもの

Commons Digester は XML を Java bean にマッピングするツール。Apache Commons で提供されている。

具体的な使い方は こちらのサイト　が詳しい。これを使って Yahoo! 検索 API を実装した。

Eclipse プロジェクトの作成

次のファイルをダウンロードし、Eclipse 3.3 でインポートする。
sample-yahoo-api.zip

Digester オブジェクトの作成

Yahoo! Web 検索 API は、検索結果を xml で返す。
Commons Digester を使えば、簡単に Java beans に変換できる。

次のように digester オブジェクトを作成する。 Digester digester = new Digester(); digester.setValidating(false); // ResultSet がきたら ResultSet オブジェクトを作成する。 digester.addObjectCreate("ResultSet", "jp.trasis.search.yahoo.api.ResultSet"); // resultSet.setXXX(*)する digester.addSetProperties("ResultSet"); // ResultSet/Result がきたら Result オブジェクトを作成する。 digester.addObjectCreate("ResultSet/Result", "jp.trasis.search.yahoo.api.Result"); // resultSet.addResult(result) で追加。 digester.addSetNext("ResultSet/Result", "addResult"); // result.setXXX(*)する digester.addSetProperties("ResultSet/Result"); // <Title> タグで囲まれた文字列を result.setTitle() する。以下同じ。 digester.addCallMethod("ResultSet/Result/Title", "setTitle", 0); digester.addCallMethod("ResultSet/Result/Summary", "setSummary", 0); digester.addCallMethod("ResultSet/Result/Url", "setUrl", 0); digester.addCallMethod("ResultSet/Result/ClickUrl", "setClickURL", 0); digester.addCallMethod("ResultSet/Result/ModificationDate", "setModificationDate", 0); digester.addCallMethod("ResultSet/Result/MimeType", "setMimeType", 0); digester.addObjectCreate("ResultSet/Result/Cache", "jp.trasis.search.yahoo.api.Cache"); digester.addSetNext("ResultSet/Result/Cache", "setCache"); digester.addSetProperties("ResultSet/Result/Cache"); digester.addCallMethod("ResultSet/Result/Cache/Url", "setUrl", 0); digester.addCallMethod("ResultSet/Result/Cache/Size", "setSize", 0);

利用方法

Digesteｒ のえらいところは、URL を与えて直接 Java beans を生成できること。Yahoo! 検索 web API のように xml データを返す REST型 API を、より少ないコードで実装できる。 /* * 次の URL にアクセスし、アプリケーションID を取得し、ここに設定する。 * http://developer.yahoo.co.jp/search/web/V1/webSearch.html */ String appid = "XXXX"; // 検索する文字列 String query = "java"; StringBuilder sb = new StringBuilder(); sb.append("http://api.search.yahoo.co.jp/WebSearchService/V1/webSearch?appid="); sb.append(appid); sb.append("&query="); sb.append(URLEncoder.encode(query, "UTF-8")); String href = sb.toString(); ResultSet resultSet = (ResultSet) digester.parse(href); System.out.println(resultSet.getResults());