JAWJAW: Java Wrapper for Japanese WordNet

JAWJAW (JAva Wrapper for JApanese Wordnet) は日本語 WordNet データベースの Java API で、単語の上位語、下位語、定義、訳などの言語知識が簡単に取得できます。

日本語 WordNet のウェブサイトで配布されているデータベースに対し、プログラムがデータベースを意識しなくてもデータにアクセスできるようなAPIです。一般的な Java プログラマー用のシンプルな API と、自然言語処理アプリケーション開発者用の API の両方を提供しています。

ファサードクラスを呼び出すだけでOK。メソッド一覧はこちらをご覧ください。

サンプルコード：

public class SimpleDemo {
	private static void run( String word, POS pos ) {
		// ファサードから日本語 WordNet にアクセス
		Set<String> hypernyms = JAWJAW.findHypernyms(word, pos);
		Set<String> hyponyms = JAWJAW.findHyponyms(word, pos);
		Set<String> consequents = JAWJAW.findEntailments(word, pos);
		Set<String> translations = JAWJAW.findTranslations(word, pos);
		Set<String> definitions = JAWJAW.findDefinitions(word, pos);
		// 結果表示（多義語はごっちゃになっています）
		System.out.println( "hypernyms of "+word+" : \t"+ hypernyms );
		System.out.println( "hyponyms of "+word+" : \t"+ hyponyms );
		System.out.println( word+" entails : \t\t"+ consequents );
		System.out.println( "translations of "+word+" : \t"+ translations );
		System.out.println( "definitions of "+word+" : \t"+ definitions );		
	}
	public static void main(String[] args) {
		// "買収"(動詞)という単語から得られる関係の一部をデモします
		SimpleDemo.run( "買収", POS.v );
	}
}

出力：
hypernyms of 買収 : [支辨, 払出す, 会計, 払いだす, 払い出す, 出費, 支出, 出金, 支払う, 払いこむ, 支弁, 精算, 得る, 手に入れる, 入手, 買い上げる, 買いつける, 買求める, 召す, 買取り, 買収, 買いあげる, 買いもとめる, 買上げる, 買い入れる, 買込む, 購う, 購買, 買い付ける, 購入, 購求, 買う, 買いとる, 買入れる, 買いいれる, 買い求める, 買い取り, 買い取る, 買い受ける, 買い出し, 買いこむ, 買取, 買取る, 買い込む] hyponyms of 買収 : [買いうける, 買い上げる, 譲りうける, 買収, 買受ける, 買い取る, 譲受ける, 買取る] 買収 entails : [支辨, 払出す, 会計, 払いだす, 払い出す, 出費, 支出, 出金, 支払う, 払いこむ, 支弁, 精算, 採択, 択む, 選む, 選考, 選分, 選び取る, より取る, 選りわける, 選取, 選定, 選りすぐる, 択る, チョイス, 択ぶ, 選りどる, 選る, 選取る, 選り分ける, 選り抜く, より分ける, セレクト, 選抜, 選する, 精選, 選り取る, 選び出す, 選抜く, より抜く, 簡抜, 選択, 選り出す, 選分ける, 選りぬく, 選出す, より出す, 選りだす, 選ぶ] translations of 買収 : [corrupt, buy, bribe, grease_one's_palms, purchase, buy_out, take_over, buy_up] definitions of 買収 : [make illegal payments to in exchange for favors or influence; "This judge can be bought", obtain by purchase; acquire by means of a financial transaction; "The family purchased a new car"; "The conglomerate acquired a new company"; "She buys for the big department store", take over ownership of; of corporations and companies]

DAO (データアクセスオブジェクト)を使って直接データベースの内容にアクセスすることもできます。

データモデル：
日本語 WordNet の DB スキーマから起こしたドメインモデルです。本 API ではそれぞれのデータオブジェクトとその DAO を提供しています。また、pos と link と lang 属性は Enum クラスとして実装しました。

利用可能な概念関係：
日本語 WordNet v0.9 の synlink テーブルに登録されている link の種類と数をまとめました。


また、登録されている概念や語数は以下の通り。

• 49,190 概念 (synsets)
• 85,966 語
• 156,684 語義 (synsetと単語のペア)

サンプルコード：

public class AdvancedDemo {
	private static void run( String word, POS pos ) {
		// 日本語 WordNet に直接アクセスし、生データを処理
		List<Word> words = WordDAO.findWordsByLemmaAndPos(word, pos);
		List<Sense> senses = SenseDAO.findSensesByWordid( words.get(0).getWordid() );
		String synsetId = senses.get(0).getSynset();
		Synset synset = SynsetDAO.findSynsetBySynset( synsetId );
		SynsetDef synsetDef = SynsetDefDAO.findSynsetDefBySynsetAndLang(synsetId, Lang.eng);
		List<Synlink> synlinks = SynlinkDAO.findSynlinksBySynset( synsetId );
		// 結果表示
		System.out.println( words.get(0) );
		System.out.println( senses.get(0) );
		System.out.println( synset );
		System.out.println( synsetDef );
		System.out.println( synlinks.get(0) );
	}
	public static void main(String[] args) {
		// "自然言語処理"(名詞)という単語から得られる関係の一部をデモします
		AdvancedDemo.run( "自然言語処理", POS.n ); 
	}
}

出力：
{ "wordid":"201821", "lang":"jpn", "lemma":"自然言語処理", "pron":"null", "pos":"n" } { "synset":"06142412-n", "wordid":"201821", "lang":"jpn", "rank":"0", "lexid":"0", "freq":"0", "src":"mlsn" } { "synset":"06142412-n", "pos":"n", "name":"human_language_technology", "src":"eng30" } { "synset":"06142412-n", "lang":"eng", "def":"the branch of information science that deals with natural language information", "sid":"0" } { "synset1":"06142412-n", "synset2":"06142118-n", "link":"hype", "src":"eng30" }

こちらをご覧ください。

こちらから、jar ファイルをダウンロードしてください。（ライセンス： Apache License, Version 2.0）

データベースを別途日本語 WordNet のウェブサイトからダウンロードし、"src/main/resources/wnjpn.db" (元ファイルがwnjpn-0.9.dbのようにバージョンを含む場合は要リネーム)というように src/main/resources ディレクトリに設置してください。JDK5以上で動作します。コンパイルおよびライブラリ（sqlite-jdbc-3.7.2.jar, junit-4.7.jar）の取得は Maven2 のご利用をお勧めします。pom.xml が含まれていますので、"mvn compile"でライブラリ依存解決とコンパイル、"mvn test"でテストが実行できます。

• 単語間の意味の近さを測るメソッド → 2011年10月にWS4J(WordNet Similarity for Java)を公開しました。
• コマンドラインインターフェイス
• ウェブインターフェイス

カーネギーメロン大学 嶋英樹
Email: hideki at cs.cmu.edu