您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

Eclipse Equinox OSGi Web 應用配置完整指南

編輯：Java 相關知識

環境需求

Eclipse 3.3.1+ (3.2.0 以上均可)
目標：建立支援靜態資源、Servlet、JSP 的 OSGi Web 應用

一、支援靜態頁面與 Servlet

1. 建立 Plug-in 專案

專案名：net.bjzhanghao.osgi.test
勾選 This plug-in is targeted to run with Eclipse
下一步勾選 Generate an activator

2. 配置 MANIFEST.MF 依賴

Require-Bundle: org.eclipse.equinox.http.jetty,
 org.eclipse.equinox.http.servlet,
 org.mortbay.jetty,
 org.apache.commons.logging,
 javax.servlet,
 org.eclipse.equinox.http.registry

3. 建立 Web 資源目錄

專案根目錄下建立 web_files/，放入 index.html。

4. 定義 plugin.xml 擴展點

<?xml version="1.0" encoding="UTF-8"?>
<plugin>
    <extension point="org.eclipse.equinox.http.registry.resources">
        <resource alias="/web" base-name="/web_files"/>
    </extension>
</plugin>

若 MANIFEST.MF 報錯，在 Bundle-SymbolicName 後加 ;singleton:=true。

5. 啟動配置

Run → Open Run Dialog → OSGi Framework 新建配置
點 Deselect All 清空
勾選 Workspace 下的專案
點 Add Required Bundles 自動解析依賴
Debug 啟動

6. 驗證

瀏覽器訪問 https://localhost/web/index.html 應顯示靜態頁面。

二、支援 Servlet

7. 建立 Servlet 類

public class ExampleServlet extends HttpServlet {
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) 
            throws ServletException, IOException {
        resp.getWriter().println("Hello from OSGi Servlet!");
    }
}

8. plugin.xml 註冊 Servlet

<extension point="org.eclipse.equinox.http.registry.servlets">
    <servlet alias="/exampleServlet" 
             class="net.bjzhanghao.osgi.example.servlet.ExampleServlet"/>
</extension>

9. 重啟驗證

訪問 https://localhost/exampleServlet 應看到輸出。

三、支援 JSP（關鍵步驟）

10. 建立 JSP 檔案

在 web_files/ 下建立 index.jsp。

11. 新增 JSP 相關依賴

Require-Bundle: org.eclipse.equinox.jsp.jasper,
 org.apache.jasper,
 org.eclipse.equinox.jsp.jasper.registry,
 javax.servlet.jsp,
 org.apache.commons.el,
 org.eclipse.equinox.http.helper,
 org.eclipse.osgi,
 org.eclipse.osgi.services

注意：org.eclipse.equinox.http.helper 需從 CVS (/cvsroot/eclipse/equinox-incubator) 取得，非標準發布包內含。

12. 修改 Activator 註冊 JSP Servlet

public class Activator implements BundleActivator {
    private ServiceTracker httpServiceTracker;
    private static final String JSP_CONTEXT = "/jsps";
    private static final String JSP_FOLDER = "/web_files";

    public void start(BundleContext context) throws Exception {
        httpServiceTracker = new HttpServiceTracker(context);
        httpServiceTracker.open();
    }

    public void stop(BundleContext context) throws Exception {
        httpServiceTracker.close(); // 原文有誤，應為 close()
    }

    private class HttpServiceTracker extends ServiceTracker {
        public HttpServiceTracker(BundleContext context) {
            super(context, HttpService.class.getName(), null);
        }

        public Object addingService(ServiceReference reference) {
            HttpService httpService = (HttpService) context.getService(reference);
            try {
                HttpContext commonContext = new BundleEntryHttpContext(context.getBundle(), JSP_FOLDER);
                httpService.registerResources(JSP_CONTEXT, "/", commonContext);

                Servlet adaptedJspServlet = new ContextPathServletAdaptor(
                    new JspServlet(context.getBundle(), JSP_FOLDER), JSP_CONTEXT);
                httpService.registerServlet(JSP_CONTEXT + "/*.jsp", adaptedJspServlet, null, commonContext);
            } catch (Exception e) {
                e.printStackTrace();
            }
            return httpService;
        }

        public void removedService(ServiceReference reference, Object service) {
            HttpService httpService = (HttpService) service;
            httpService.unregister(JSP_CONTEXT);
            httpService.unregister(JSP_CONTEXT + "/*.jsp");
            super.removedService(reference, service);
        }
    }
}