MarkLogicのデータベースにアクセスし、文字列の入ったドキュメントを作成するサンプルと、そのドキュメントから文字列を取得してくるサンプルです。今回は一番単純な例として、単純なテキスト文書を読み込むTextDocumentManagerと、単純な文字列として処理するStringHandleを使いました。

参考:
http://docs.marklogic.com/guide/java/intro

MarkLogicのユーザーの作成

アプリケーションで使うユーザを事前に作成しておきます。

MarkLogicサーバーの管理コンソール( http://localhost:8001/ )に行き、右側のツリーからConfigure -> Security -> Users を選択
左側でCreateタブを選択し、以下の内容でユーザーを作成します。

ユーザー名	パスワード	必要なRole
aaa	pass	rest-reader, rest-writer

Javaプロジェクトの作成

普通のJavaプロジェクトまたはMavenプロジェクトを作成します。

MarkLogic Java APIライブラリのダウンロード

入手方法は２通りあります。好みで。

Mavenでダウンロード

pom.xml

<dependency>
    <groupId>com.marklogic</groupId>
    <artifactId>java-client-api</artifactId>
    <version>RELEASE</version>
</dependency>

MarkLogicのサイトからダウンロード
- http://developer.marklogic.com/products/java
- lib/の中のライブラリを全部クラスパスに追加

データベースに書き込むクラス

適当な名前でクラスを作成し、以下の内容でmainメソッドを書きます。

WriterSample.java

    public static void main(String[] args) {

        // データベースクライアントの取得
        DatabaseClient client = DatabaseClientFactory.newClient(
                "localhost", 8000, "aaa", "pass", DatabaseClientFactory.Authentication.DIGEST
        );

        // DocumentManagerの取得
        TextDocumentManager textMgr = client.newTextDocumentManager();

        // Handleの取得
        StringHandle handle = new StringHandle();

        // 文字列を設定
        handle.set("Hello");

        // 指定したURLに書き込む
        textMgr.write("/example/text.txt", handle);

        // データベースクライアントの解放
        client.release();

    }

実行

JDK1.7以降でビルドして実行します。

15:59:04.685 [main] DEBUG c.m.client.DatabaseClientFactory - Creating new database client for server at localhost:8000
15:59:04.705 [main] DEBUG c.m.client.impl.JerseyServices - Connecting to localhost at 8000 as aaa
15:59:05.001 [main] INFO  c.m.client.impl.DocumentManagerImpl - Writing content for /example/text.txt
15:59:05.004 [main] DEBUG c.m.client.impl.JerseyServices - Sending /example/text.txt document in transaction null
15:59:05.155 [main] INFO  c.m.client.impl.DatabaseClientImpl - Releasing connection
15:59:05.155 [main] DEBUG c.m.client.impl.JerseyServices - Releasing connection

クエリコンソールで、Exploreボタンをクリックします。
http://localhost:8000/qconsole/

/example/text.txtというドキュメントが増えています。

ドキュメントのリンクをクリックすると、設定した文字列が表示されます。

データベースから読み込むクラス

適当な名前でクラスを作成し、以下の内容でmainメソッドを書きます。

ReadSample.java

    public static void main(String[] args) {

        // データベースクライアントの取得
        DatabaseClient client = DatabaseClientFactory.newClient(
                "localhost", 8000, "aaa", "pass", DatabaseClientFactory.Authentication.DIGEST
        );

        // DocumentManagerの取得
        TextDocumentManager textMgr = client.newTextDocumentManager();

        // Handleの取得
        StringHandle handle = new StringHandle();

        // 指定されたURLから読み込む
        textMgr.read("/example/text.txt", handle);

        // 文字列を読み出し
        String str = handle.get();

        // 内容を出力
        System.out.println("String: " + str);

        // データベースクライアントの解放
        client.release();

    }

実行

ビルドして実行します。

16:10:33.240 [main] DEBUG c.m.client.DatabaseClientFactory - Creating new database client for server at localhost:8000
16:10:33.266 [main] DEBUG c.m.client.impl.JerseyServices - Connecting to localhost at 8000 as aaa
16:10:33.620 [main] INFO  c.m.client.impl.DocumentManagerImpl - Reading metadata and content for /example/text.txt
16:10:33.621 [main] DEBUG c.m.client.impl.JerseyServices - Getting /example/text.txt in transaction null
String: Hello
16:10:34.543 [main] INFO  c.m.client.impl.DatabaseClientImpl - Releasing connection
16:10:34.543 [main] DEBUG c.m.client.impl.JerseyServices - Releasing connection

ドキュメントに入っている文字列が、コンソールに表示されます。