如何创建Restful服务并部署OSGi容器？

Question

我的目标是使用 Eclipse 创建一个 Restful 服务 Maven 项目。然后将其打包为捆绑包并将其部署到 Fuse ESB karaf OSGi 容器。到目前为止我所知道的是如何使用JAX-RS API注释，@Path @GET:

package com.restfultest;

import javax.ws.rs.GET;
import javax.ws.rs.Path;

@Path("/example")
public class ExampleService {

@GET
public String sayHello() {
    return "Hello Restful service";
 }
}

我的问题是： 1.我应该使用什么maven原型？ maven-archetype-webapp 还是快速入门？

2.Activator如何实现？像这样吗？

public class Activator implements BundleActivator {

private ServiceRegistration<?> registration;

public void start(BundleContext context) throws Exception {
    // TODO Auto-generated method stub
    ExampleService exampleService = new ExampleService();
    registration = context.registerService( ExampleService.class.getName(), exampleService, null );
}

public void stop(BundleContext context) throws Exception {
    // TODO Auto-generated method stub
    registration.unregister();
}

}

3.如何注册和发布服务（比如如何配置Endpoint地址和端口）？

我是 osgi 新手。有谁可以给我一些资源或详细教程吗？

Answer 1

1. 您可以使用Maven捆绑插件
2. 和 3. Apache CXF DOSGi 帮助您将 OSGi 服务发布为 WS/REST。

Answer 2

这是我的 5 美分：

1. 您应该使用什么 Maven 原型？

---

• 我使用了OSGI HTTP服务（快速入门），查看this示例，我认为它更自然。

2. 如何实现Activator？

---

• 继续使用示例的Activator，它对我有用。
• 如果您使用它，您还需要实现 Application 和 Rest Service

3. 如何注册和发布服务？

---

• 我建议您下载最新的 jersey-ALL-bundle 并将其安装在您的 OSGI 上。

• 然后，在我的特定情况下，我使用 Maven Bundle Plugin 来处理运行时和打包上的导入，因此，我的 pom.xml 看起来像这样（请注意依赖项）：

    ...
    <packaging>bundle</packaging>
    <build>
        <plugins>
            <!--+
                + OSGi Bundle-Manifiest Generator.
                + -->
            <plugin>
                <groupId>org.apache.felix</groupId>
                <artifactId>maven-bundle-plugin</artifactId>
                <version>2.3.7</version>
                <extensions>true</extensions>
                <configuration>
                    <instructions>
                        <Import-Package>javax.servlet.*;version="[2.4,4.0)",*</Import-Package>
                        <Bundle-Activator>com.sample.api.Activator</Bundle-Activator>
                        <Implementation-Title>jersey-osgi-http-service-bundle</Implementation-Title>
                        <Implementation-Version>${project.version}</Implementation-Version>
                    </instructions>
                    <unpackBundle>true</unpackBundle>
                </configuration>
            </plugin>
        </plugins>
    </build>
  
    <dependencies>
        <!--+======================+-->
        <!--+ REST Dependencies    +-->
        <!--+======================+-->
        <dependency>
            <groupId>org.glassfish.jersey.containers</groupId>
            <artifactId>jersey-container-servlet-core</artifactId>
            <version>2.22.1</version>
        </dependency>
        <dependency>
            <groupId>org.apache.felix</groupId>
            <artifactId>org.apache.felix.http.bundle</artifactId>
            <version>2.2.0</version>
        </dependency>
        <!--+=========================================+-->
        <!--+ Apache Felix Framework (OSGi framework) +-->
        <!--+=========================================+-->
        <dependency>
            <groupId>org.apache.felix</groupId>
            <artifactId>org.apache.felix.framework</artifactId>
            <version>4.6.0</version>
        </dependency>
    </dependencies>
  

• 在我的具体情况下，我还安装了WebConsole，然后我的包看起来像这样：

     0|Active     |    0|System Bundle (4.6.0)
     1|Active     |    1|Apache Felix Bundle Repository (2.0.2)
     2|Active     |    1|Apache Felix Gogo Command (0.14.0)
     3|Active     |    1|Apache Felix Gogo Runtime (0.12.1)
     4|Active     |    1|Apache Felix Gogo Shell (0.10.0)
     5|Active     |    1|com.sample-api (1.3.0.SNAPSHOT)
     6|Active     |    1|jersey-all (2.22.1)
     7|Active     |    1|Apache Felix Log Service (1.0.0)
     8|Active     |    1|Apache Felix Configuration Admin Service (1.2.4)
     9|Active     |    1|Apache Felix Shell Service (1.4.2)    
    10|Active     |    1|Apache Felix Http Bundle (2.0.4)    
    11|Active     |    1|HTTP Service (1.0.0)    
    12|Active     |    1|Apache Felix Web Management Console (3.1.2)
  

• 对于休息来说，拥有 6、10 和 11 包非常重要。

• 只需执行以下操作即可在 OSGI（我使用 Felix）的“config.properties”中配置端口：

    org.osgi.service.http.port=28370
  

• 然后，要访问该服务，只需使用以下路径：

    http://localhost:28370/jersey-http-service/status
  

Answer 3

1. 您需要创建一个 OSGI 包。有一些创建 Maven 项目的原型：

   • http://mojo.codehaus.org/mojo-archetypes/osgi-archetype/
   • http://www.sonatype.com/books/mcookbook/reference/sect-osgi-generate-project.html

2. 您的激活器看起来正确。

3. 这个问题我无法回答，但看起来这个项目可以满足您的需求：https://github.com/hstaudacher/osgi-jax-rs-connector

总的来说，我建议您自己阅读 OSGI 规范，这是一本很好的读物，并且解释了很多事情。