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>

其中 reference 元素会创建一个参考管理器，它在 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 “客户端类” 的 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 类定义 getter 和 setter 方法，用于 helloWorldSvc bean 属性，它允许它通过注入来接收对 Hello World 服务的引用。init （） 方法在 bean 初始化阶段调用，在属性注入后调用，这意味着通常在此方法范围内调用 Hello World 服务。

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