使用javadoc,如何能自定义tag

iq199 2005-10-12 10:47:44

我想加入一个自定义tag : history
用来记录类的修改记录

我知道用jbuilder可以实现,但我现在使用eclipse

...全文

408 8 打赏收藏转发到动态举报

写回复

8 条回复

切换为时间正序

请发表友善的回复…

发表回复

perfervid 2005-11-28

打赏
举报

回复

楼主可以参考一下这篇文章：

http://www.graphics.net.cn/article/java/javadoc.asp

iq199 2005-10-20

打赏
举报

回复

myth822(枫红一刀) ( ) 信誉：105 2005-10-13 08:49:00 得分: 0
也可以添加@history,然后在window-preferences-java-code style-code templates-comments-types
里面添加
－－－－－－－－－－－－－－－
你还是没有明白我的意图，我是要和javadoc集成，实现我的@history和javadoc的内置tag(如@see)，在产生文档时，具有同样或类似的效果。
而不是在编辑时的自动添加、突出显示等

myth822 2005-10-13

打赏
举报

回复

也可以添加@history,然后在window-preferences-java-code style-code templates-comments-types
里面添加

醉梦书生 2005-10-12

打赏
举报

回复

呵呵，关注...

iq199 2005-10-12

打赏
举报

回复

是这样写注释吗

/**
* 这是类的说明
*
* <history>这里是修改历史记录</history>
*
* @see hello.ant.HelloAnt
*
* @author xyz
*/

测试了一下，没有任何效果
生成的文档中
“这里是修改历史记录”紧跟着“这是类的说明”
我是想要类似@see @author那样的效果

myth822 2005-10-12

打赏
举报

回复

添加完后,在你的代码注释中使用<history>,生成的文档当然就包含了

iq199 2005-10-12

打赏
举报

回复

我是要使用javadoc生成文档

就是在生成的文档中,也包含我加入tag

刚查了查,可以通过修改doclet实现,不过比较麻烦

想找一种简单的办法

myth822 2005-10-12

打赏
举报

回复

window-preferences-java-editor-templates

在下面添加

框架说白了就是JAVA工作者多年以来总结出的一些开发标准。让我们可以以成功的经验模式来开发我们自已的系统，一般使用框架的好处是 ·在好的框架下，开发者只需要写一些必须的代码；他们不需要直接接触底层的API。这一点很重要。 ·经过良好设计的框架可以为程序提供清晰的结构并且提高程序的内聚性。好清晰的结构使得其他人可以更容易加入项目。 ·一个容易使用的框架可以通过一些例子和文档为用户提供最佳实践。 ·采用成功的框架的代码比自己的代码容易测试 J2EE本身提供了一些框架。比如， Enterprise Java-Beans (EJB) container或者 Servlet engine 而这些框架一般在中小工程中我们都不会使用，会让我们把大量的时间浪费在开发框架上。而现在比较流行开源框架,主要是struts,hibernate,spring等比如struts是在原有mvc基础上实现在代码分离等功能，非常好用。而hibernate可以把我们的关系型数据库转换成我们在JAVA中的面像对像来使用。从而让我们在开发时不需要直接写SQL语句，比如database.getName();就可以直接把数据库中的用户名取出来。 Spring J2EE框架被大规模地运用到项目中，而项目总要负责这些框架以及自己业务代码的连接，使之真正融合到一起。Spring就是专注于这个问题的，它和Hibernate融合的很好。这三种框架在一起并不冲突，所以现在最常用的框架就是 struts+hibernate+spring就像我们盖房子一样，先把框架搭好，我们在在上面写代码就很规范。 Struts框架介绍 : Struts只是一个MVC框架（Framework）,用于快速开发Java Web应用。Struts实现的重点在C(Controller)，包括ActionServlet/RequestProcessor和我们定制的 Action,也为V(View)提供了一系列定制标签（Custom Tag）。但Struts几乎没有涉及M(Model),所以Struts可以采用JAVA实现的任何形式的商业逻辑。 Spring是一个轻型容器(light-weight container)，其核心是Bean工厂(Bean Factory)，用以构造我们所需要的M(Model)。在此基础之上，Spring提供了AOP（Aspect-Oriented Programming, 面向层面的编程）的实现，用它来提供非管理环境下申明方式的事务、安全等服务；对Bean工厂的扩展ApplicationContext更加方便我们实现J2EE的应用；DAO/ORM的实现方便我们进行数据库的开发；Web MVC和Spring Web提供了Java Web应用的框架或与其他流行的Web框架进行集成。就是说可将两者一起使用，达到将两者自身的特点进行互补。 spring 框架介绍 : 它关注的领域是其他许多流行的Framework未曾关注的。Spring要提供的是一种管理你的业务对象的方法。 Spring既是全面的又是模块化的。Spring有分层的体系结构，这意味着你能选择仅仅使用它任何一个独立的部分，而它的架构又是内部一致。因此你能从你的学习中，得到最大的价值。例如，你可能选择仅仅使用Spring来简单化JDBC的使用，或用来管理所有的业务对象。它的设计从一开始就是要帮助你编写易于测试的代码。Spring是使用测试驱动开发的工程的理想框架。 Spring不会给你的工程添加对其他的框架依赖。Spring也许称得上是个一站式解决方案，提供了一个典型应用所需要的大部分基础架构。它还涉及到了其他framework没有考虑到的内容。尽管它仅仅是一个从2003年2月才开始的开源项目，但Spring有深厚的历史根基。 Spring架构上的好处在我们进入细节之前，让我们来看看Spring能够给工程带来的种种好处： Spring能有效地组织你的中间层对象，不管你是否选择使用了EJB。如果你仅仅使用了Struts或其他为J2EE的 API特制的framework，Spring致力于解决剩下的问题。 Spring能消除在许多工程中常见的对Singleton的过多使用。根据我的经验，这是一个很大的问题，它降低了系统的可测试性和面向对象的程度。通过一种在不同应用程序和项目间一致的方法来处理配置文件，Spring能消除各种各样自定义格式的属性文件的需要。曾经对某个类要寻找的是哪个魔法般的属性项或系统属性感到不解，为此不得不去读Javadoc甚至源编码？有了Spring，你仅仅需要看看类的JavaBean属性

XDoclet是扩展的Javadoc Doclet引擎。这是一个通用的Java工具，可让您创建自定义Javadoc @tag，并使用提供的模板引擎基于这些@tag生成源代码或其他文件（例如xml-ish部署描述符）。

目前网站开发主要是php和Java两种, 其中因为Java有基于JakartaEE（JavaEE）行业规范的设计，可靠性和安全性更高。Java还有丰富第三方库，包括静态语言级别的代码检查库，多样性的单元测试框架，完整的性能调优工具，清晰的API Javadoc文档，高性能的并发库。而PHP这些都没有，没有代码检查，单元测试很少很难用，没有线程做不了CPU密集型计算，文档和库的命名很混乱，可以是说PHP除了用在开发网站没别的用处了，而Java是通用型语言，还能用来开发微服务，Android，鸿蒙，桌面软件(使用GraalVM编译成本地程序)。所以，使用Java开发Web是性价比最高的，学到的知识还能用在别的领域。这个课程主要是介绍使用国内的快速开发框架JFinal来开发单体应用，这个轻量级框架开发快，运行快，知识点很快可以掌握。

转自：http://www.blogjava.net/lishunli/archive/2010/01/12/309218.html Technorati 标记: tools 关键词个性化地生成Javadoc文档，svn eclipse 设置属性 svn:keywords -TortoiseSVN，李顺利， Javadoc 自定义标记，javadoc tag，javadoc versio

maven javadoc 新增自定义标签

62,614

社区成员

307,326

社区内容

发帖

与我相关

我的任务

社区管理员

加入社区

近7日
近30日
至今

加载中

查看更多榜单

社区公告

暂无公告

试试用AI创作助手写篇文章吧

+ 用AI写文章