在OSGI容器Equinox中嵌入HttpServer

原文地址：https://liugang594.iteye.com/blog/1328050

简单介绍一下如何在一个osgi的bundle中内嵌使用http服务

一、基础

首先看看在OSGI中怎么启动内嵌的jetty容器。看下图：

其实简单的只选中"org.eclipse.osgi"和"org.eclipse.equinox.http.jetty"，然后点击"Add Required Bundles"即可。

默认的Jetty监听的端口为80，可又通过指定运行参数 org.osgi.service.http.port 来修改围住端口，例如要想使用8080端口，可又切换到 "Arguments"页：

完成配置又后，点运行即可：

如果得到又上结果，说明运行成功，可以访问一下启动的jetty了：

二、添加页面

上面介绍了怎么在Eclipse的OSGI容器里启动Jetty服务，不过从结果看来，这个jetty里还没有什么内容。这一节我们就要加一点内容。

首先，先创建一个简单的osgi的bundle，过程如下：

New --> Other --> Plug-in Project，点 “Next”
填写“Project name”；
"Target Platform"一栏，选择“an OSGI framework" --> "standard"，点 "Next", "Next"

不选任何模板，直接Finish

OK，一个基本OSGI的bundle project就创建完成。要结合使用http服务，需要添加以下依赖包：

javax.servlet
javax.servlet.http
org.osgi.service.http

OK，配置部分就已经完成，下面就开始填写内容。

三、背景知识

Eclipse内嵌有一个HttpService的实现，它位于包"org.osgi.service.http"下，一旦这个service所在的osgi bundle启动了，就会有一个内嵌的http容器被启动，这个service就会被注册，默认地址是http://localhost，端口为80，可以通过指定参数“org.osgi.service.http.port”参数在运行的时候修改默认端口（参见上上节）。（注：不应该试图自己去启动他那HttpService服务，那样可能达不到目的；另外应避免启动多个HttpService服务，又节省资源）

要想提供我们自己定义的http服务，就需要将我们的服务（servlet或者是其他html页面）注册到这个HttpService中去，这里主要是用到HttpService的两个注册方法：

registerResources(String alias, String name, HttpContext context)

用来注册诸如表态页面等等

registerServlet(String alias, Servlet servlet, Dictionary initparams, HttpContext context)

用来注册servlet类

所以要想提供我自己的webservice实现，我们就需要：

取得httpService对象
提供Servlet和Web Page的实现
将Servlet和Web Page注册到HttpService服务中
访问

四、实现

我这里提供一个很简单的例子：一个页面，用户可又输入名字，然后点提交，将输入的信息提交到后台的servlet；servlet得到提交的名字，如果不为空，就将它打印出来，否则就提示用户需要输入一个名字。

1、准备页面

提交页面的内容如下：

<html>

<title>测试OSGI和HTTP</title>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

<body>

<form action="print" method="get">

请输入名字：

  <input type="text" name="name" />

  <input type="submit" value="提交" />

</form>

</body>

</html>

在src目录下他那一个目录web，然后将该文件保存为submit.html

2、Servlet类

package testhttp.servlets;  

import java.io.BufferedWriter;

import java.io.IOException;

import java.io.OutputStreamWriter;  

import javax.servlet.ServletException;

import javax.servlet.http.HttpServlet;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;  

import org.osgi.framework.BundleContext;  

public class PrintNameServlet extends HttpServlet{  

    private static final long serialVersionUID = -9080875068147052401L;  

    private BundleContext context;  

    public PrintNameServlet(BundleContext context) {

        super();

        this.context = context;

    }  

    @Override

    protected void doPost(HttpServletRequest req, HttpServletResponse resp)

            throws ServletException, IOException {

        doGet(req, resp);

    }  

    @Override

    protected void doGet(HttpServletRequest req, HttpServletResponse resp)

            throws ServletException, IOException {  

        resp.setCharacterEncoding("UTF-8");  

        String name = req.getParameter("name");

        System.out.println(name);  

        String s = "";

        if(name==null||"".equals(name.trim())){

            s = "你没有输入名字";

        }else{

            s = "你输入的名字是："+name.trim();

        }

        StringBuilder sb = new StringBuilder();

        sb.append("<html><title>Response</title><meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />");

        sb.append("<body>");

        sb.append(s);

        sb.append("</body></html>");  

        BufferedWriter bw = new BufferedWriter(new OutputStreamWriter(resp.getOutputStream(),"UTF-8"));

        bw.write(sb.toString());

        bw.flush();

        bw.close();

    }  

}

3、注册

页面也有了，servlet类也有了，下面就是将他们注册入HttpService里了。假如在我们的bundle一运行，这些http页面就可用，那么，我们可又在Activator里注册服务。

取得HttpService对象

private HttpService service;

public void start(BundleContext bundleContext) throws Exception {

    Activator.context = bundleContext;

    ServiceReference serviceReference = bundleContext.getServiceReference(HttpService.class.getName());

    service = (HttpService) bundleContext.getService(serviceReference);

}

这是一个例行公事般的步骤，一般取得一个特定服务的代码都可又这么实现。

注册页面和Servlet

有了HttpService对象，然后就是注册资源和servlet到这个HttpService对象:

public void start(BundleContext bundleContext) throws Exception {

    Activator.context = bundleContext;

    ServiceReference serviceReference = bundleContext.getServiceReference(HttpService.class.getName());

    service = (HttpService) bundleContext.getService(serviceReference);  

               //register

    HttpContext httpContext = service.createDefaultHttpContext();  

    service.registerResources("/osgi", "/web", httpContext); //设置别名，所有对"/osgi"映射到"web"目录

    service.registerServlet("/osgi/print", new PrintNameServlet(bundleContext)

    , null, httpContext);   //设置servlet别名，'/osgi/print"映射到servlet的实现

}

退出时移除别名

public void stop(BundleContext bundleContext) throws Exception {

    service.unregister("/osgi/print");

    service.unregister("/osgi");

    Activator.context = null;

}

启动bundle

示例bundle已经准备好，最后就是启动这个bundle了，只需要在第一节的bundle列表中把这个bundle添加进去就可又了：

如果没有意外，访问 http://localhost:8080/osgi/submit.html

如果能看到这个页面，那基本就是成功了，输入"刘刚"，提交后，返回结果为：