12.5. 访问 OSGi 服务

本节介绍如何在 OSGi 容器中生成、构建和部署简单的 OSGi 客户端。客户端在 OSGi 注册表中找到一个简单的 Hello World 服务，并调用它上的 sayHello（） 方法。

要使用 Maven Quickstart archetype 生成项目，您必须满足以下条件：

maven-archetype- Quickstart archetype 创建一个通用 Maven 项目，然后您可以根据您需要的任何用途进行自定义。要使用协调( org.fusesource.example:osgi-client )生成 Maven 项目，请输入以下命令：

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

此命令的结果是目录 ProjectDir/osgi-client，其中包含生成的项目的文件。

您必须自定义 POM 文件才能生成 OSGi 捆绑包，如下所示：

要将 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 “用于导入服务的蓝图文件” 添加 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>

其中 参考 元素会创建一个参考管理器，该管理器在 OSGi 注册表中找到 HelloWorldSvc 类型的服务。bean 元素会创建一个 Client 类的实例，并注入服务引用作为 bean 属性 helloWorldSvc。此外，init-method 属性指定在 bean 初始化阶段调用 Client.init（） 方法（即，在服务引用注入客户端 bean 后）。

在 ProjectDir/osgi-client/src/main/java/org/fusesource/example/client 目录下，使用您首选的文本编辑器创建文件 Client.java，并从 例 12.7 “Client Class” 添加 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 类为 helloWorldS vcan 属性定义一个 getter 和 setter 方法，它可以通过注入来接收 Hello World 服务的引用。init（） 方法在 bean 初始化阶段调用，在属性注入后，这通常可以在此方法范围内调用 Hello World 服务。

要安装并运行 osgi-client 项目，请执行以下步骤：