最近,JBoss 发布了 JBoss 开发者框架(JDF)的 1.0 版本,不同于软件版本使用名称和版本号,JSF 其实是 Jboss 及 JBoss AS 所有相关技术的文档中心。此项举措使开发者使用不同技术时不用再四处查找文档(例如,之前 Hibernate 和 Seam 指南不存在一处)而只需关注一份文档。
JDF 的重点是向开发者展示所有层面(例如:用户界面和持久化层)上的软件的使用。 当用户仅仅使用 JBoss 的某项技术(例如 Hibernate)时。用户可以很容易找到它的相关文档(例如 Hibernate 指南)。但是很难直接从官方站点找到如何在开发运行程序时纵览全局的权威信息。
为此,JDF 包含了以 Maven 项目形式呈现了 50 个快速入门,有趣的是大多“快速入门”都涵盖多个软件层次(使用了相应的 JBoss 技术)。这些可以作为开发更复杂项目的基础或指南。 一些“快速入门”如下:
- ejb-in-war 快速入门,使用了 JSF 、 EJB
- greeter 快速入门,使用了 EJB、 JPA 、JSF、 JTA , CDI
- helloworld-html5 快速入门,使用了 HTML5 、 JAX-RS 、CDI
- wicket-ear 快速入门,使用了 JPA、 Apache Wicket
- kitchensink 快速入门,使用了 Validation 、EJB、JAX-RS、JPA、JPA、JSF、CDI
“快速入门”清晰地划分成三类:初级、中级和高级。除了依赖 Maven,还需要 JBoss Developer Studio (或 Eclipse 插件 JBoss Tools )。毫无疑问,部署是要依赖 Jboss AS 的。部分安装指导可参考 RedHat/Jboss 的 PaaS OpenShift 。目前所有“快速入门”源文件放在 GitHub 上。
快速入门给用户提供了一个很好的起点,但是它们都不是一个带有完整功能的应用程序。为此 JDF 提供了一个称为 TickerMonster 的项目及细节作为真实案例。它使用了最新 Java EE6 技术(用 Jboss 相关技术实现),包含的模块不局限于单一架构视角,使用了不同的技术,例如:
Jboss 给企业应用开发推荐的平台是 Java EE 6。所以 JDF 的一部分文档解释了 Spring 、 Seam 和 Java EE5 用户的项目迁移路径。 Seam 使用的路径很重要,因为现在已经不做基于它的新开发。目前,用户已被明确告知 Seam3 将废弃,必须将相关项目迁移到 CDI/ DeltaSpike 上。同时 JDF 鼓励用户分享一些项目迁移的故事。
JDF 最后一部分包含了一套 Maven BOM 文件(材料清单)用来定义基于JBoss AS 的完整应用程序套件。Maven 的BOM 文件是一种特殊的POM 文件,包含了所有的依赖,通过Maven2.0.9 引入的"import" scope 应用在项目中。“JBoss stacks”分组下的BOM 文件定义了你所选择技术实现(例如Errai/GWT 应用程序)的推荐项目结构的需要依赖。Jboss AS 的BOM 可以自由下载,但是Jboss EAP 的BOM 下载要先有一个Redhat 帐号。 JDF 现在放在 GitHub 上,虽然现在有了正式的发布路线图,但也接受外部贡献。交流支持可以通过两个讨论版及IRC 聊天进行。
查看英文原文: JBoss Developer Framework: A Documentation Hub For JBoss Technologies
感谢贾国清对本文的审校。
给InfoQ 中文站投稿或者参与内容翻译工作,请邮件至 editors@cn.infoq.com 。也欢迎大家通过新浪微博( @InfoQ )或者腾讯微博( @InfoQ )关注我们,并与我们的编辑和其他读者朋友交流。
评论