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

使用Equinox建立服务器端应用

原文地址: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.

 

建议新的plug-in project

 

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

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

 


一步步使用equinox建立服务器端应用(osgi)_第1张图片
 

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

 
一步步使用equinox建立服务器端应用(osgi)_第2张图片
 

太多依赖

 

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

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

 

为plug-in项目配置依赖

 

 

 

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

 
一步步使用equinox建立服务器端应用(osgi)_第3张图片
 
保存配置

依赖图

 

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

一步步使用equinox建立服务器端应用(osgi)_第4张图片
 

建立servlet 作为项目扩展

 

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

 
一步步使用equinox建立服务器端应用(osgi)_第5张图片
 

 

 

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


一步步使用equinox建立服务器端应用(osgi)_第6张图片
 
对应的plugin.xml文件
<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

 

 
一步步使用equinox建立服务器端应用(osgi)_第7张图片
 

 

override doGet方法,代码如下:

 
一步步使用equinox建立服务器端应用(osgi)_第8张图片

运行和测试Servlet

 

 

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

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

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

 
一步步使用equinox建立服务器端应用(osgi)_第9张图片
 

 

 

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

 
一步步使用equinox建立服务器端应用(osgi)_第10张图片
 

 

 
一步步使用equinox建立服务器端应用(osgi)_第11张图片
 

 

如果你是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

 
一步步使用equinox建立服务器端应用(osgi)_第12张图片
 

 

 

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

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

 

 

 

 

你可能感兴趣的:(eclipse,应用服务器,servlet,配置管理,osgi)