XDoclet 说明

原创 2004年07月07日 09:48:00

XDoclet 说明


XDoclet是一个扩展的Javadoc Doclet引擎。它是一种通用的java工具,可以让你创建自己的javadoc @tags进而利用XDoclet中的Templet enging基于这些@tags生成源代码或其他文件(例如xml的deployment descriptors)。XDoclet已经支持一些常见的任务了,例如生成web.xml和ejb-jar.xml等,用户可以创建其他templets和@tags,以增加对其他技术的支持

更宏伟的目标,是让你可以在基于组件的开发工程中可以实现“持续集成”(Continuous Integration)。要点是在你编写每一个组件代码的同时,指定它们的“原数据”(meta-data),也就是设定每个组件的配布属性(deployment meta-data)。你不必担心这些配布属性会过时,因为你可以接触代码,这些配布属性和代码同时被修改。这样就做到了持续集成,整个过程很自然的就是round-trip了。我们称之为“持续再配置”(Continuous Reconfiguation)。 XDoclet很适合成为Apache-Ant这样的build过程的一部分。

整个系统是可以扩展的。如果需要,你可以为你的特定任务写特别的templet(如支持新的App Server,为Toplink等定义OR Mapping schema, 甚至将servlet当作组件来使用)。XDoclet已经支持一些预先写好的Templet和@tags,例如为EJB关联的东西提供的,为自动生成web.xml提供的等等。

XDoclet基于以下几个部分:

  • Apache Ant Task: 和就是这种任务的例子。在你的build.xml文件中,在编译代码的taget之前定义。
  • task的嵌套元素: 这是定义对于源代码需要执行的子任务的地方。例如 和。每一个子任务都可以单独配置。
  • Template文件: 子任务可以基于template文件生成输出。template可以是包含类似于 <?XML:NAMESPACE PREFIX = XDOCLET />的xml元素的文本文件。Template文件类似于JSP文件,类似于JSP tags, 实际的实现位于子任务类中,一个基类定义了一些共通的tag
  • 特别的JavaDoc @tags: 通过使用特别的JavaDoc @tags, 给每个组件定义设定。例如在SimpleServlet.java中定义一个 @web:servlet name="The Simple Servlet",让 子任务知道SimpleServlet.java包含一个servlet的定义,这样就可以利用@web:servlet tag中的信息生成相应的web.xml描述。
  • The mege system: 为了避免过多的tags, XDoclet同时也可以使用一种merge system。例如,为了避免在EJBean源代码中写@jboss:table-name account,可以定义一个 jaws-db-setting-Accoutn.xml文件,这个文件包含实际的XML代码,可以被子任务合并到最终生成的jaws.xml文件中

实际的例子,可以参见sample code和sample build.xml文件

XDoclet是EJBDoclet的后继者,而EJBDoclet是由Rickard Oberg -- 世界上最好的程序员之一,开放源代码的先锋 -- 发起的项目,在这个项目的开发过程中,逐渐发现不仅仅可以用于EJB,于是开始了一个新的项目,一开始就以一个更宽广的应用作为目标。

You can download it from http://sourceforge.net/projects/xdoclet.

XDoclet的使用攻略

XDoclet的使用攻略
  • jianxin1009
  • jianxin1009
  • 2013-08-06 10:09:44
  • 3322

Eclipse完美支持XDoclet(新)

  • 2009年04月14日 11:51
  • 527KB
  • 下载

Missing library: xdoclet-1.2.1.jar.如何解决?

去这里下载xdoclet-bin-1.2.1.ziphttp://sourceforge.net/projects/xdoclet/files/xdoclet/1.2.1/ 解压出来,比如解压到C:...
  • zhengbo0
  • zhengbo0
  • 2014-03-26 17:15:13
  • 4452

Eclipse使用xdoclet1.2.3 生成hibernate配置文件和映射文件

用ant和xdoclet生成hibernate配置文件可以为我们省去很多配置的操作,废话不多说,直接给栗子: eclipse:Eclipse Java EE IDE for Web Developer...
  • Unseenblade
  • Unseenblade
  • 2016-10-30 13:20:39
  • 1591

XDoclet

Rick Hightower2003年8月關於本技術教學本技術教學的目的 本技術教學為 J2EE 開發人員講述如何使用 XDoclet 來加速開發。XDoclet 使用屬性導向程式化來簡化元件之間的連...
  • Tangyongkang
  • Tangyongkang
  • 2005-05-05 20:04:00
  • 2352

Xdoclet入门教程

  • 2009年01月02日 16:02
  • 55KB
  • 下载

Xdoclet + Ant自动生成Hibernate配置文件

在使用Hibernate的时候,过多的Hibernate配置文件是一个让人头疼的问题。最近接触了Xdoclet这个工具。它实际上就是一个自动代码生成的工具,Xdoclet不能单独运行,必须搭配其他工具...
  • lishehe
  • lishehe
  • 2014-07-11 11:01:26
  • 2054

快速上手XDoclet 1 -- Servlet简单实例

     XDoclet是一个扩展的Javadoc Doclet引擎。它是一种通用的java工具,可以让你创建自己的javadoc @tags进而利用XDoclet中的Templet enging基于...
  • javamxj
  • javamxj
  • 2005-01-11 12:06:00
  • 11200

Xdoclet是什么?

作者:zming转载注明出处:http://blog.csdn.net/zmxj/archive/2005/06/17/396913.aspx本文的目的是让你用最短的时间了解xdoclet技术,本人并...
  • zmxj
  • zmxj
  • 2005-06-17 18:34:00
  • 3849

Eclipse导入工程后,XDoclet错误:Missing library: xdoclet-1.2.1.jar. Select the home directory for XDoclet. 1.

这几天在使用Open Health Tools的OpenXDS工程,在导入Eclipse后,出现下面的错误: 遂google之,在网上找到了答案。答案网址为http://blog.v...
  • YY_LOVE_MY
  • YY_LOVE_MY
  • 2014-11-25 16:55:57
  • 1580
收藏助手
不良信息举报
您举报文章:XDoclet 说明
举报原因:
原因补充:

(最多只允许输入30个字)