这篇文档是用Sun JDK 1.4.2 , Eclipse 3.1, MyEclipse 4.0,和JBoss 3.2.5 应用服务器。所有的截屏都是基于默认的用户接口,基于Eclipse, MyEclipse 企业版本和Windows XP的设置的。如果你对这篇文档的操作感到困难,请查看User Feedback 部分,如何给MyEclipse文档小组的提供反馈。
这个快速手册展现用MyEclipse EJB工具来迅速开始开发J2EE企业级Java Beans(EJB)的基础功能、概念、和技术。
特别的,这篇文档说明:
- 创建一个 MyEclipse EJB 项目
- 创建一个 Session EJB
- 配置一个 EJB 项目 通过使用 XDoclet 面向属性编程的能力attribute-oriented programming (可选的, 被推荐的)
- 使用 XDoclet 的代码生成去创建EJB和Home接口,lookup 功能, 和 J2EE 和应用程序服务特殊部署描述符
- 打包和发布一个EJB
下边列出了本文档演示的程序所要复制的软件:
寻求安装Eclipse 和MyEclipse 的帮助请查看Installing/Uninstalling Quickstart.
在我们开始之前,这有一个关于MyEclipse EJB Projects和工具的短言。首先,什么是MyEclipse EJB 项目和为什么它很重要?
一个MyEclipse EJB 项目是:
一个基础的Eclipse Java项目包含一个META-INF文件夹和附加的 MyEclipse EJB工具所需要的元数据,例如EJB 创建向导和MyEclipse发布服务。因此标准的第3版的Eclipse Java工具或许用在一个MyEclipse EJB项目上。
你可以区别MyEclipse EJB项目同其他工程类型通过工程图标
。图一描述一个我们载本文档中即将创建的EJB 工程的例子的结构。图中标注着 META-INF 的文件夹位于src文件夹下面和元数据的信息。META-INF是一个特殊的J2EE文件夹,它包含着Java MANIFEST.MF文件, 标准的EJB 部署描述符(ejb-jar.xml) 和程序服务特殊部署描述符如 jboss.xml。MyEclipse 新建EJB工程向导创建了META-INF文件夹作为Java源文件夹的子路经使它能发布在你所喜欢的支持EJB容器的应用服务器上
Figure 1. Example EJB Project
在图一中也描述了工程的元数据文件。注释的这些文件在默认的Eclipse视图中被隐藏,因为默认的.* 文件名过滤器来隐藏以点开头的文件。文件.project 和 .classpath是标准的Eclipse工程信息文件。文件.mymetadata 和 .xdoclet是MyEclipse 元数据文件,它们被MyEclipse工具需要来完成适当使用。不要删除或修改这些文件。并且如果你的工程由源代码管理工具如CVS来管理,确定包含所有的这些文件作为工程的一部分。
在图一中也描述了工程的元数据文件。注释的这些文件在默认的Eclipse视图中被隐藏,因为默认的.* 文件名过滤器来隐藏以点开头的文件。文件.project 和 .classpath是标准的Eclipse工程信息文件。文件.mymetadata 和 .xdoclet是MyEclipse 元数据文件,它们被MyEclipse工具需要来完成适当使用。不要删除或修改这些文件。并且如果你的工程由源代码管理工具如CVS来管理,确定包含所有的这些文件作为工程的一部分。
MyEclipse EJB 开发工具包括:
- EJB 创建向导
- EJB XDoclet 面向属性编程的环境
- 功能争强的Java 编辑器来支持XDoclet 注释和J2EE APIs的代码补全功能
- 自动生成 EJB 和 Home 接口和 lookup 功效
- ejb-jar.xml 和程序服务特殊部署描述符的程程
- 为编辑部署描述而定制的XML 编辑器
- EJB 部署服务
一个特殊的注释是关于面向属性编程和Xdoclet技术:
MyEclipse 提供成熟的用XDoclet技术的面向属性编程的支持和工具(查看References)。MyEclipse EJB 工具,例如EJB向导和代码生成功能,这些操作大量的依赖于XDoclet。例如, EJB创建向导生成XDoclet 1.2来适应Session, Entity, 和Messaged-driven EJB的EJB bean的类。XDoclet是被雇用于制动生成和维护bean 的Home 和 Remote 接口同时维护ejb-jar.xml部署描述符
当你不需要在你的开发过程中使用MyEclipse XDoclet能力时,我们相信计数属性所获得的生产力远远超过使用属性。我们拥护我们的推荐,使用属性注释来注释:1)原生属性支持最近定义到最新版本的Java SDK,和2)属性注释作为主要机制的即将到来的EJB 3.0中将极大的简化EJB定义和维护效果将被预先使用。