一步步使用equinox建立服务器端应用(osgi)

原文地址：http://www.eclipse.org/equinox-portal/tutorials/server-side/

 

自己随便翻译一下主要为了练练英语，如果不对的欢迎指正。

 

使用eclipse equinox建立服务器端应用相对比较容易，建立一个非常简单的基于java servlets的应用是认识equinox建立服务端应用潜力的第一步。这个一步步建立服务端应用的向导，仅仅是使用equinox一种建立服务端应用的一个使用java servlets的一个例子。

Bundle or Plug-in?

 

从技术上讲，bundle 和 plug-in 是相同的。bundle 是一系列有逻辑关系的代码、图片、配置、等资料的集合。bundles 包含 metadata(在MANIFEST.MF文件中建立，提供了名称、建立者、版本基础信息)和bundle之间交互的信息。例如manifest 列出了bundle 间的互相依赖以及需要暴露的服务。

plugin-in 更趋向于在eclipse中使用，也就是说，plug-ins 是扩展eclipse 框架的bundle.

 

步骤

     1.为RCP/plug-in 开发安装配置eclipse。

     2.建立新的 plug-in 项目

     3. 配置 plug-in 项目依赖。

     4.建立一个servlet 作为扩展。

     5.建立配置，运行测试servlet.

 

视频向导

[Click to view demonstration]

为RCP/plug-in 开发安装配置eclipse。

 

为RCP/plug-in 开发安装配置eclipse。

Ganymede M5 或者之后的版本都可以运行本实例，你可以下载 EPP Ganymede Milestone Package Builds page.

 

帮助信息在 Eclipse for RCP/Plug-in Developers page.

 

 

 

运行eclipse,建立一个新的plug-in 项目(File > New > Project > Plug-in Project).

如下的向导页面，输入项目名称"org.eclipse.examples.servlet"，"Target Platform"选eclipse3.4.

 

 

第二页不要选择plugin-in options ,避免我们后面配置一些不需要的示例。

 

 

太多依赖

 

打开一些选项可能增加一些项目不需要的依赖，一般来说，我们应该让plug-in项目保持尽可能少的依赖关系。运行时，equinox会为你的bundle解决依赖关系。

最糟糕的情况是，你的部属可能没有包含必须的依赖，如果equinox无法处理，将不能转载你的bundle.?????

 

 

 

 

新项目建立后，在Manifest 编辑器里，打开"Dependencies"页面，加入org.eclipse.equinox.http.registry和 javax.servlet

 

 
保存配置

依赖图

 

新的bundle 只有两个直接依赖，但是bundles 还有他们自己的依赖，依赖图似乎有些复杂，不过感谢equinox已经可以帮我们管理这些复杂的关系。 

 

 

 

进入"Extensions"页面增加扩展org.eclipse.equinox.http.registry.servlets.(但是在我的galieo版本不是如下显示，建议直接编辑plugin.xml文件)

 

 

 

 

在"Extension Details" area，填入类名org.eclipse.examples.servlets.HelloServlet和你访问servlet的别名; 例如 "http://localhost/hello", 我们使用的别名"/hello"

 

对应的plugin.xml文件

<plugin>
   <extension point="org.eclipse.equinox.http.registry.servlets">
     <servlet
       alias="/login"
       class="org.eclipse.examples.servlets.HelloServlet"/>
</extension>
</plugin>

<plugin>
   <extension point="org.eclipse.equinox.http.registry.servlets">  
     <servlet  
       alias="/login"  
       class="org.eclipse.examples.servlets.HelloServlet"/>  
</extension>  
</plugin>

 

什么是Extension

扩展是一种机制，bundle开发者可以用来hook into eclipse框架，org.eclipse.equinox.http.registry提供 org.eclipse.equinox.http.registry.servlets 扩展点，提供了一个hook可以让开发者添加sevlet到框架。

各种bundle提供了各种各样的扩展点，例如你可以建立扩展添加自己的视图，编辑器，菜单等到eclipse.

 

建立一个class,取名HelloServlet,继承从javax.servlet.http.HttpServlet

 

 

 

 

override doGet方法，代码如下：

 

 

 

 

下面我们来运行它，你可以右键项目 "Run As... > OSGi Framework"，当你运行你的bundle时，默认的机制会加载很多不需要的bundle。

当你在eclipse里运行程序时，经常需要配置launch configuration ，很多时候eclipse是自动配置的，所以很多人不一定用到。

建立一个launch configuration是比较容易的，点击‘Run--Configurations’

 

 

 

 

在Run Configurations对话框，如图配置，确定选中的bundle:org.eclipse.examples.servlet, org.eclipse.equinox.http.jetty,然后点击“ Add Required Bundles”添加传递的依赖。然后按'Run'

 

 

 

 

 

 

如果你是linux下开发，可能会有权限限制你使用1024以下的端口，这里默认为80，所以你可以修改端口。

 

 

如果没有log诊断问题是个很大的挑战，当你运行一个equinox应用，log文件存放在 [workspace]/.metadata/.plugins/org.eclipse.pde.core/Equinox Servlet 目录，你也可以在你的launch configration的 "Program Arguments" 添加-consoleLog 参数，在控制台打出log.

org.mortbay.util.MultiException[java.net.BindException: Permission denied] 输出的日志表明了http server 没有权限绑定需要的端口。

 

端口设置方法如图：

-Dorg.eclipse.equinox.http.jetty.http.port=8080

 

 

 

 

开始运行后，你可以访问servlet，"http://localhost:8080/hello".

你可能会看到日志org.mortbay.util.MultiException[java.net.BindException: Address already in use]，表明你的端口被占用了，你需要换一个。

运行和测试Servlet

建立servlet 作为项目扩展

为plug-in项目配置依赖

 

建议新的plug-in project