12.5. OSGi サービスへのアクセス

このセクションでは、OSGi コンテナーで単純な OSGi クライアントの生成、構築、およびデプロイ方法を説明します。クライアントは、OSGi レジストリーで単純な Hello World サービスを見つけ、そのサービスで sayHello() メソッドを呼び出します。

Maven クイックスタートアーキタイプを使用してプロジェクトを生成するには、次の前提条件を満たす必要があります。

maven-archetype-quickstart アーキタイプは汎用の Maven プロジェクトを作成し、それを目的に合わせてカスタマイズできます。コーディネート org.fusesource.example:osgi-client を使用して Maven プロジェクトを生成するには、次のコマンドを入力します。

mvn archetype:create
-DarchetypeArtifactId=maven-archetype-quickstart
-DgroupId=org.fusesource.example
-DartifactId=osgi-client

このコマンドの結果は、生成されたプロジェクトのファイルを含むディレクトリー ProjectDir/osgi-client です。

OSGi バンドルを生成するには、次のように POM ファイルをカスタマイズする必要があります。

Blueprint ファイルをクライアントプロジェクトに追加するには、最初に次のサブディレクトリーを作成します。

ProjectDir/osgi-client/src/main/resources
ProjectDir/osgi-client/src/main/resources/OSGI-INF
ProjectDir/osgi-client/src/main/resources/OSGI-INF/blueprint

ProjectDir/osgi-client/src/main/resources/OSGI-INF/blueprint ディレクトリーの下で、お気に入りのテキストエディターを使用して config.xml ファイルを作成し、例12.6「サービスをインポートするための Blueprint ファイル」から XML コードを追加します。

<?xml version="1.0" encoding="UTF-8"?>
<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0">

  <reference id="helloWorld"
        interface="org.fusesource.example.service.HelloWorldSvc"/>

  <bean id="client"
        class="org.fusesource.example.client.Client"
        init-method="init">
    <property name="helloWorldSvc" ref="helloWorld"/>
  </bean>

</blueprint>

reference 要素は、OSGi レジストリーで HelloWorldSvc タイプのサービスを見つける参照マネージャーを作成します。bean 要素は Client クラスのインスタンスを作成し、サービス参照を Bean プロパティー helloWorldSvc として注入します。さらに、init-method 属性は、Bean の初期化フェーズ中 (つまり、サービス参照がクライアント Bean に注入された後) に Client.init() メソッドが呼び出されるように指定します。

ProjectDir/osgi-client/src/main/java/org/fusesource/example/client ディレクトリーの下で、お気に入りのテキストエディターを使用して Client.java ファイルを作成し、例12.7「クライアントクラス」から Java コードを追加します。

package org.fusesource.example.client;

import org.fusesource.example.service.HelloWorldSvc;

public class Client {
    HelloWorldSvc helloWorldSvc;

    // Bean properties
    public HelloWorldSvc getHelloWorldSvc() {
        return helloWorldSvc;
    }

    public void setHelloWorldSvc(HelloWorldSvc helloWorldSvc) {
        this.helloWorldSvc = helloWorldSvc;
    }

    public void init() {
        System.out.println("OSGi client started.");
        if (helloWorldSvc != null) {
            System.out.println("Calling sayHello()");
            helloWorldSvc.sayHello();  // Invoke the OSGi service!
        }
    }

}

Client クラスは helloWorldSvc Bean プロパティーの getter メソッドおよび setter メソッドを定義します。これによりインジェクションによる Hello World サービスへの参照を受け取ることができます。init() メソッドは、プロパティーインジェクションの後に Bean 初期化フェーズ中に呼び出されます。つまり、通常、このメソッドのスコープ内で Hello World サービスを呼び出すことができます。

osgi-client プロジェクトをインストールおよび実行するには、以下の手順を実行します。