JBoss JCA - IronJacamar 简介

  IronJacamar 是 JBoss 项目组里 JCA 1.6 的实现。 有关 JCA 的介绍, 请看文章: JCA Overview 。

  IronJacamar 官方网址为: http://www.jboss.org/ironjacamar , 当前版本为 1.1.0.Beta2, Beta3 计划在 11.28 日发布。 它的 1.0 branch 下最新版本为 1.0.13.Final, 该分支集成在 JBoss Enterprise Application Platform(EAP)6 环境下。 

  IronJacamar 使用 Ant + Ivy 作为 build 脚本。source code 的 地址为:

http://anonsvn.jboss.org/repos/jbossas/projects/jboss-jca/trunk/
 

  IronJacamar 源代码的根目录结构为:

../
|-- adapters              # jdbc resource adapter
|-- api                        # jca 的 api
|-- arquillian               # 基于 arquillian 的测试支持
|-- as                          # 用于对 jboss 老版本的移植, 还有一些工具。
|-- build.xml                # 主要的 build 脚本
|-- codegenerator       # 提供 code generator 工具
|-- common                 # jca 的 metadata 解析
|-- core                        # jca 运行时
|-- deployers                # 提供 rar 的部署
|-- doc                          # 文档
|-- eclipse                     # eclipse 插件
|-- eis                            # 测试用 EIS
|-- embedded                # embedded jca, 用于测试环境
|-- ivy.settings.xml        # ivy 的配置
|-- ivy.xml                      # ivy 里指定依赖
|-- README.txt               # 说明文件
|-- sjc                             # 提供 standalone 环境
|-- tools                         # build 过程中使用到的工具和模板
|-- validator                    # validate rar是否有效
`-- web                          # web console, 运行在 sjc 下

IronJacamar 提供了很多有助于 Resource Adapter 开发的工具, 例如: code generator, Eclipse plugin, validator, rar information tool ,另外还提供了 standalone 的运行环境,用于测试和调试。

Standalone 运行环境


  在根目录下,运行

ant sjc
 

  后, 会在 target 目录下产生一个 sjc 的目录, 切换目录到 sjc/bin 下, 运行 ./run.sh:

cd target/sjc/bin
./run.sh

  将会启动 IronJacamar 的 standalone 环境。 打开浏览器,输入地址:

http://127.0.0.1:8080/console/

 ,你将看到 sjc 的控制台。 这个 standalone 环境目前支持 Resource Adapter 和 .war web 程序的部署,只需要把 .rar 或者 .war 文件丢到 sjc/deploy/ 目录下, 启动 sjc 即可。另外,它还与 IronJacamar 的 Eclipse plugin 集成, 使得可以远程热部署。 

Code generator

  code generator 提供了命令行的界面快速生成一个 Resource Adapter 的工程

  切换到 target/sjc/doc/codegenerator 目录下, 运行 ./codegenerator.sh,然后根据提示一步步生成代码。

cd target/sjc/doc/codegenerator
./codegenerator.sh
 

Eclipse plugin

  eclipse plugin 的编译需要用户本地的 eclipse 环境才可以, 假设你的 eclipse 安装目录为: /opt/eclipse, 那么编译 eclipse plugin 需要运行:

ant -Declipse.home=/opt/eclipse eclipse

 之后, 在 target 目录下会产生 ironjacamar-eclipse.jar 文件, 把该文件 copy 到你的 eclipse 目录下的 plugins 子目录, 重启 eclipse, plugin 就安装好了。

cp target/ironjacamar-eclipse.jar /opt/eclipse/plugins/
 

  Eclipse plugin 使用 code generator 工具的功能,提供了 GUI 的界面, 快速生成 Resource Adapter 的 eclipse 工程。

  我们将会在接下来的版本适时发布 update link, 以便 Eclipse 用户安装。

Validator tool

  validator tool 可以验证你编写的 Resource Adapter 是否符合 JCA 规范。它还提供了 ant 的 task 和 maven 的 mojo, 你可以很方便的把 Resource Adapter 的验证集成到你的 build 环境中去。

  切换目录到 target/sjc/doc/validator 下,运行:

cd target/sjc/doc/validator
./validator.sh <RAR 文件地址>
 

Rar information tool

  如果你希望知道第三方开发的 Resource Adapter 里有哪些 JCA 的声明, rar information tool 会帮你很大的忙。 

  切换目录到 target/sjc/doc/as, 运行:

cd target/sjc/doc/as
./rar-info.sh <RAR 文件地址>

  将会在 RAR 文件所在目录下生成相应的 report 文件。 

  目前 rar information tool 还不支持 annotation, 我们将在接下来的版本里加入支持。

  更多 IronJacamar 相关的文档, 请参考官方的 E 文: http://docs.jboss.org/ironjacamar/userguide/1.0/en-US/html/

猜你喜欢

转载自aoingl.iteye.com/blog/1716825
JCA