Topic: 有没有办法获得Java的注释值

  Print this page
1.有没有办法获得Java的注释值 Copy to clipboard
Posted by: jianhua23
Posted on: 2003-08-27 10:08

有没有办法获得Java的注释值
类似于 XDoclet
我现在有这么一段代码
public class Calculator(){
/**
* Description:除法,默认为小数点后取四位
* @param x 参数
* @param y 参数
* @return double 结果值
*/
public static double div(double x, double y) {
BigDecimal _x = new BigDecimal( x );
BigDecimal _y = new BigDecimal( y );
return _x.divide(_y, 4, BigDecimal.ROUND_HALF_EVEN).doubleValue();
}
}

我现在需要通过reflection机制获得注释中的 Description,@param 和 @return
有什么办法吗？！Sad
2.Re:有没有办法获得Java的注释值 [Re: jianhua23] Copy to clipboard
Posted by: nothing
Posted on: 2003-08-27 10:24

关注中....
3.Re:有没有办法获得Java的注释值 [Re: nothing] Copy to clipboard
Posted by: ditty
Posted on: 2003-08-27 10:53

可以看一下BEA 的 WLI 8.1 的相关代码，最新版本的wrokshop中的workflow实现就是通过将配置文件写在程序中实现的，可以参考一下。
4.Re:有没有办法获得Java的注释值 [Re: jianhua23] Copy to clipboard
Posted by: dapan
Posted on: 2003-08-27 10:54

自己写一个？

^_^
5.Re:有没有办法获得Java的注释值 [Re: dapan] Copy to clipboard
Posted by: jianhua23
Posted on: 2003-08-27 11:27

好像不是太容易，有谁了解过 XDoclet 的源代码?!
它好像实现了，我下午看看
6.Re:有没有办法获得Java的注释值 [Re: jianhua23] Copy to clipboard
Posted by: floater
Posted on: 2003-08-28 12:36

up
7.Re:有没有办法获得Java的注释值 [Re: jianhua23] Copy to clipboard
Posted by: dog72
Posted on: 2003-08-28 16:31

搞错没。编译后的bytecode是不可能取到注释的，通过reflection机制就更是万万不能了。
唯一的方法是parse源代码，这需要用到编译原理。感兴趣的话，去看看antlr(www.antlr.org)，很不错的递归下降分析工具。
只是国内几乎没有人真正搞过商业产品的编译，可以问的人很少呀。
8.Re:有没有办法获得Java的注释值 [Re: dog72] Copy to clipboard
Posted by: mazalet
Posted on: 2003-08-28 16:58

dog72 wrote:
搞错没。编译后的bytecode是不可能取到注释的，通过reflection机制就更是万万不能了。
唯一的方法是parse源代码，这需要用到编译原理。感兴趣的话，去看看antlr(www.antlr.org)，很不错的递归下降分析工具。
只是国内几乎没有人真正搞过商业产品的编译，可以问的人很少呀。


难道在jdk编译的时候没有去掉注释？？？？？？？？？？
我认为不可能。
所以这种方式是不可行的。
9.Re:有没有办法获得Java的注释值 [Re: dog72] Copy to clipboard
Posted by: think
Posted on: 2003-08-28 18:41

是啊。class中是不可能存在这种信息的。
而且XDoclet也不是这样用的。

这种情况好象只有.Net中Attribute可以满足要求。
10.Re:有没有办法获得Java的注释值 [Re: jianhua23] Copy to clipboard
Posted by: hwx
Posted on: 2003-08-28 22:28

编译的时候会去掉注释的。
你可以打开一个类文件观察一下，没有注释信息。
11.Re:有没有办法获得Java的注释值 [Re: hwx] Copy to clipboard
Posted by: jianhua23
Posted on: 2003-08-29 08:46

XDoclet 好像使用java.io来读取源文件来获得相应的注释值的!!!
哎，但是这样作为代码生成器使没问题(类似于javaCC)。但在运行期性能就太差了( 而且好像可能不可行Sad )。这条路好像走不通 !!!!
12.Re:有没有办法获得Java的注释值 [Re: jianhua23] Copy to clipboard
Posted by: javaben
Posted on: 2003-08-29 13:40

关注中
13.拿不到注释的 [Re: jianhua23] Copy to clipboard
Posted by: liuzhehz
Posted on: 2003-09-03 08:23

因为在编译的文件中根本没有这种信息
14.Re:有没有办法获得Java的注释值 [Re: jianhua23] Copy to clipboard
Posted by: struggle
Posted on: 2003-09-03 16:15

不知有没有帮助，胡乱贴一篇：

Java平台最“体贴”的工具--javadoc
（王鸿　2001年11月05日 16:34）
在软件项目管理过程中，如何保证程序代码与软件技术文档一致可以说是最令人头疼的一件事情了。不管是先修改代码，还是先修改文档，对各种记录的管理都是一件麻烦事。而且，二者在改动上的一致性、实时性还很难得到保证。令人高兴的是Java平台的设计者充分考虑到了这一点，他们十分"体贴"地为Java开发者们带来一个文档管理工具--javadoc。
javadoc利用Java编译程序javac对程序代码源文件中的声明和文档注释进行语法分析，并在默认情况下生成一组HTML文档来描述类、内部类、接口、构造函数、方法和域。不过在运行过程中，它也使用了Java平台的环境变量classpath来确定类查找路径。这样当涉及类和内部类的有关描述时，是否正确地设置了classpath变量可能会影响到javadoc命令是否可以完全成功执行。
javadoc产生的默认文件列表如下：

基本页面文件：
calssname.html 类或者接口描述文件，一个文件对应一个类或者接口
package-summary.html 包摘要文件，一个文件对应一个包
overview-summary.html 总的摘要文件

交叉引用页面文件：
overview-tree.html 所有包的类层次页面
package-tree.html 某个包的类层次页面
package-use.html 包用法页面
class-use\classname.html 类用法页面
deprecated-list.html 不鼓励使用的方法的页面
serialized-form.html 序列化页面
index-*.html 索引文件

支持文件：
help-doc.html 帮助文件
index.html 引导页面，是整个文档的入口
*-frame.html 框架文件
stylesheet.css 样式表文件
doc-files目录 保存与HTML相关的一些杂文件。例如图片文件等。

javadoc的命令行语法如下：
javadoc [ options ] [ packagenames ] [ sourcefiles ] [ @files ]
参数可以按照任意顺序排列。下面分别就这些参数和相关的一些内容进行说明：
Packagenames 包列表。这个选项可以是一系列的包名（用空格隔开），例如java.lang java.lang.reflect java.awt。不过，因为javadoc不递归作用于子包，不允许对包名使用通配符；所以你必须显示地列出希望建立文档的每一个包。
Sourcefiles 源文件列表。这个选项可以是一系列的源文件名（用空格隔开），可以使用通配符。javadoc允许四种源文件：类源代码文件、包描述文件、总体概述文件、其他杂文件。
◇ 类源代码文件：类或者接口的源代码文件。
◇ 包描述文件：每一个包都可以有自己的包描述文件。包描述文件的名称必须是"package.html"，与包的.java文件放置在一起。包描述文件的内容通常是使用HTML标记写的文档。javadoc执行时将自动寻找包描述文件。如果找到，javadoc将首先对描述文件中<body></body>之间的内容进行处理，然后把处理结果放到该包的Package Summary页面中，最后把包描述文件的第一句（紧靠<body>）放到输出的Overview summary页面中，并在语句前面加上该包的包名。
◇ 总体概述文件：javadoc可以创建一个总体概述文件描述整个应用或者所有包。总体概述文件可以被任意命名，也可以放置到任意位置。-overview选项可以指示总体概述文件的路径和名称。总体概述文件的内容是使用HTML标记写的文档。javadoc在执行的时候，如果发现-overview选项，那么它将首先对文件中<body></body>之间的内容进行处理；然后把处理后的结果放到输出的Overview summary 页面的底部；最后把总体概述文件中的第一句放到输出的Overview summary页面的顶部。
◇ 其他杂文件：这些文件通常是指与javadoc输出的HTML文件相关的一些图片文件、Java源代码文件（.java）、Java程序（.class）、Java小程序（Applets）、HTML文件。这些文件必须放在doc-files目录中。每一个包都可以有自己的doc-files目录。举个例子，你希望在java.awt.Button的HTML文档中使用一幅按钮的图片（Button.gif）。首先，你必须把图片文件放到C:\user\src\java\awt\doc-files\中；然后在Button.java文件中加入下面注释
/**
* This button looks like this:
* <img src="doc-files/Button.gif">
*/
@files 包含文件。为了简化javadoc命令，你可以把需要建立文档的文件名和包名放在一个或多个文本文件中。例如，为了简化下面命令：
javadoc -d apidoc com.mypackage1 com.mypackage2 com.mypackage3
你可以建立一个名称为mypackage.txt的文件，其内容如下：
com.mypackage1
com.mypackage2
com.mypackage3
然后执行下面命令即可：
javadoc -d apidoc @mypackage.txt
options 命令行选项。javadoc使用doclets（doclets是指用doclet API编写的程序。）来确定输出的内容和格式。命令行选项中一部分是可用于所有doclet的通用选项，一部分是由默认的标准doclet提供的专用的选项。下面对各自一些常用的选项分别进行介绍：
通用选项：
◇ -1.1 生成具有javadoc 1.1版本生成的文档的外观和功能的文档。不是所有的选项都可以用于-1.1选项，具体可以使用javadoc -1.1 -help察看。
◇ -help 显示联机帮助。
◇ -bootclasspath classpathlist 指定"根类"（通常是Java平台自带的一些类。例如java.awt.*等）的路径。
◇ -sourcepath sourcepathlist 指定包的源文件搜索路径。但是必须注意，只有在javadoc命令中指定了包名的时候才可以使用-sourcepath选项。如果指定了包名，而省略了-sourcepath，那么javadoc使用类路径查找源文件。举例说明：假定你打算为com.mypackage建立文档，其源文件的位置是C:\user\src。那么你可以使用下面的命令：
javadoc -sourcepath c:\user\src com.mypackage
◇ -classpath classpathlist 指定javadoc查找"引用类"的路径。引用类是指带文档的类加上它们引用的任何类。javadoc将搜索指定路径的所有子目录。Classpathlist可以包含多个路径（使用;隔开）。如果省略-classpath，则javadoc使用-sourcepath查找源文件和类文件。举例说明：假定你打算为com.mypackage建立文档，其源文件的位置是C:\user\src，包依赖C:\user\lib中的库。那么你可以使用下面的命令：
javadoc -classpath c:\user\lib -sourcepath c:\user\src com.mypackage
◇ -overview path\filename 告诉javadoc从path\filename所指定的文件中获取概述文档，并且把它放到输出的概述页面（overview-summary.html）中。其中path\filename是相对于-sourcepath的相对路径。
◇ -public 只显示公共类以及成员。
◇ -protected 只显示受保护的和公共的类以及成员。缺省选项。
◇ -package只显示包、受保护的和公共的类以及成员。
◇ -private 显示所有类和成员。
◇ -doclet class 指定javadoc产生输出内容的自定义doclet类。如果忽略这个选项，javadoc将使用默认的doclet产生一系列HTML文档。
◇ -docletpath classpathlist 与- doclet选项相关，制定自定义的doclet类文件的路径。Classpathlist可以包含多条路径（用;隔开）。
◇ -verbose 在javadoc运行时提供更详细的信息。
标准doclet专用选项：
◇ -author 在生成的文档中包含"作者"项。
◇ - d directory 指定javadoc保存生成的HTML文件的目录。省略该选项将把文件保存在当前目录。Directory可以是绝对目录，也可以是相对当前目录的相对目录。
◇ -version 在生成的文档中包含"版本"项。
◇ -use 为类和包生成"use"（用法）页面。这些页面描述了该类和包在javadoc命令涉及的文件中被使用的情况。例如：对于给定的类C，在C的用法页面中将包含C的子类，类型为C的域，返回变量类型为C的方法以及在参数中有变量类型为C的方法和构造器。
◇ -splitindex 把索引文件按照字母顺序分为多个文件。每一个文件对应一个字母。
◇ -windowtitle title 指定输出的HTML文档的标题。
◇ -header header 指定输出的HTML文档的页眉文本。
◇ -footer footer 指定输出的HTML文档的脚注文本。
◇ -bottom text 指定输出的HTML文档底部的文本。
◇ - group groupheading packagepatten;packagepatten;… 在总体概述页面中按照命令的指定方式分隔各个包。例如执行下面命令：
javadoc -group "Core Packages" "java.lang*:java.util"
-group "Extension Packages" "javax.*"
java.lang java.lang.reflect java.util javax.servlet java.new
在页面中将有如下结果：
Core Packages
java.lang
java.lang.reflect
java.util
Extension Packages
javax.servlet
Other Packages
java.new
◇ - noindex 不输出索引文件。
◇ - help 在文件的导航条中忽略help链接。
◇ - helpfile path\filename 指定导航条中的help链接所指向的帮助文件。忽略该选项，javadoc将生成缺省的帮助文件。
◇ -stylesheetfile path\filename 指定javadoc的HTML样式表文件的路径。忽略该选项，javadoc将自动产生一个样式表文件stylesheet.css。
通过上面的介绍，我们了解了javadoc的命令行语法，下面开始介绍javadoc文档注释方法。
javadoc注释以"/**"开始，以"*/"结束，里面可以包含普通文本、HTML标记和javadoc标记。javadoc只处理源文件中在类/接口定义、方法、域、构造器之前的注释，忽略位于其他地方的注释。举例如下：
/**
*我的第一个程序--<b>Helloworld</b>
*@author 王鸿
*@version 1.0 2001/10/15
*/
public class myHelloworld
{
/**
*在main( )方法中使用的显示用字符串
*@see #main(java.lang.String[])
*/
static String SDisplay;
/**
*显示HelloWorld
*@param args 从命令行中带入的字符串
*@return 无
*/
public static void main(String args[])
{
SDisplay = "Hello World " ;
System.out.println( SDisplay );
}
}

使用下面命令：
javadoc -private -d doc -author -version myHelloworld.java
即可以生成漂亮的关于myHelloworld.java的API文档了。
上面例子中以@开头的标记就是javadoc标记。在Java程序中正确使用javadoc标记是一个良好的注释习惯，将非常有助于javadoc自动从源代码文件生成完整的格式化API文档。下面就对各种标记进行详细说明。
◇ @author name-text 指定生成文档中的"作者"项，从JDK/SDK 1.0开始引入。name-text可以指定多个名字（使用","隔开）。文档注释可以包含多个类。
◇ {@docroot} 代表产生文档的根路径，从JDK/SDK 1.3开始引入。用法举例如下
/**
*see the <a href={@docroot}/copyright.html>copyright</a>
*/
假定生成文档的根目录是doc，上面注释所在的文件最后生成的文件是doc\utility\utl.html，那么"copyright"的链接会指向..\copyright.html。
◇ @deprecated deprecated-text 添加注释，表明不推荐使用该API。
◇ @exception class-name description @throw的同义标记，从JDK/SDK 1.0开始引入。
◇ {@link package.class#member label} 插入指向package.class#member的内嵌链接，从JDK/SDK 1.2开始引入。举例说明，假定注释中有如下文档：
/** Use the {@link #getComponentAt(int, int) getComponentAt} method. */
那么javadoc最终生成的HTML页面中将有如下内容
Use the <a href = "Component.html#getComponentAt(int,int)" > getComponentAt </a> method.
◇ @param parameter-name description 描述参数，从JDK/SDK 1.0开始引入。
◇ @return description 描述返回值，从JDK/SDK 1.0开始引入。
◇ @see reference 添加"参见"标题，其中有指向reference的链接或者文本项，从JDK/SDK 1.0开始引入。@see标记有三种形式，下面分别说明：
（1）、@see "string" 为"string"添加文本项，不产生链接。
（2）、@see <a href="URL#value">Label</a> 使用HTML标记产生链接
（3）、@see package.class#member Label 使用Java语言的名字package.class #member产生链接。
◇ @serial field-description 用于缺省可序列化域的注释，从JDK/SDK 1.2开始引入。
◇ @serialField field-name field-type field-description 建立Serializable类的serialPersistentFields成员的ObjectStreamField组件的文档，从JDK/SDK 1.2开始引入。
◇ @serialData data-description data-description建立数据序列和类型的文档，从JDK/SDK 1.2开始引入。
◇ @since since-text 利用since-text内容为文档增加"since"标题，从JDK/SDK 1.1开始引入。
◇ @throws class-name description 与@exception同义。用class-name和description为输出文档添加"抛出"标题，从JDK/SDK 1.2开始引入。
◇ @version version-text 添加"版权"标题，从JDK/SDK 1.0开始引入。
上面介绍了标准doclet提供的所有标记。不过，需要注意这些标记的使用是有位置限制的。其中可以出现在类或者接口文档注释中的标记有：@see、{@link}、@since、@deprecated、@author、@version。可以出现在方法或者构造器文档注释中的标记有：@see、{@link}、@since、@deprecated、@param、@return、@throws、@exception、@serialData。可以出现在域文档注释中的有：@see、{@link}、@since、@desprecated、@serial、@serialField。
除了javadoc自身提供的标准标记以外，我们可以定制自己的标记吗？当然可以。只需要对javadoc标准的doclet程序进行扩充即可。实际上，利用javadoc提供的doclet API，不仅可以扩充doclet标记，甚至还可以改变javadoc的整个输出。为了满足需要，你可以使javadoc输出普通文本、XML文件等。由于扩充doclet涉及到Java编程，本文不再做深入介绍。
总之，javadoc提供了完整规范的API文档功能。在软件项目管理中，合理地使用javadoc不仅可以减少开发时的文档工作量，提高效率；而且还非常有利于将来软件的修改和维护。
15.Re:有没有办法获得Java的注释值 [Re: jianhua23] Copy to clipboard
Posted by: zgd
Posted on: 2003-09-03 17:21

编译后的就不行了
编译前，可以考虑自己写一个xdoclet的plugin
16.Re:有没有办法获得Java的注释值 [Re: zgd] Copy to clipboard
Posted by: jianhua23
Posted on: 2003-09-03 17:30

我还考虑另外一个想法，可不可以通过java.io在Java为编译前（源代码）进行分析，已获得相应的注释参数值。并使用javacc进行编译已获得相应的Java源代码。好像 XDoclet的本质是这样的

   Powered by Jute Powerful Forum® Version Jute 1.5.6 Ent
Copyright © 2002-2021 Cjsdn Team. All Righits Reserved. 闽ICP备05005120号-1
客服电话 18559299278    客服信箱 714923@qq.com    客服QQ 714923