macrochao — Tue, 13 May 2008 14:50:00 GMT

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

使用下面命��o�Q?br /> javadoc -private -d doc -author -version myHelloworld.java
卛_��以生成漂亮的关于myHelloworld.java的API文档了�?br /> 上面例子中以@开头的标记��是javadoc标记。在Java�E�序中正��用javadoc标记是一个良好的注释习惯�Q�将非常有助于javadoc自动从源代码文�g生成完整的格式化API文档。下面就对各�U�标记进行详�l�说明�?br /> �?@author name-text 指定生成文档中的"作�?��，从JDK/SDK 1.0开始引入。name-text可以指定多个名字�Q��?,"隔开�Q�。文档注释可以包含多个类�?br /> �?{@docroot} 代表产生文档的根路径�Q�从JDK/SDK 1.3开始引入。用法�D例如�?br /> /**
*see the href={@docroot}/copyright.html>copyright>
*/
假定生成文档的根目录是doc�Q�上面注释所在的文�g最后生成的文�g是docutilityutl.html�Q�那�?copyright"的链接会指向..copyright.html�?br /> �?@deprecated deprecated-text ��d��注释�Q�表明不推荐使用该API�?br /> �?@exception class-name description @throw的同义标讎ͼ�从JDK/SDK 1.0开始引入�?br /> �?{@link package.class#member label} 插入指向package.class#member的内嵌链接，从JDK/SDK 1.2开始引入。�D例说明，假定注释中有如下文档�Q?br /> /** Use the {@link #getComponentAt(int, int) getComponentAt} method. */
那么javadoc最�l�生成的HTML��面中将有如下内�?br /> Use the getComponentAt method.
�?@param parameter-name description 描述参数�Q�从JDK/SDK 1.0开始引入�?br /> �?@return description 描述�q�回��|��从JDK/SDK 1.0开始引入�?br /> �?@see reference ��d��"参见"标题�Q�其中有指向reference的链接或者文本项�Q�从JDK/SDK 1.0开始引入。@see标记有三�U��Ş式，下面分别说明�Q?br /> �Q?�Q�、@see "string" �?string"��d��文本��，不��生链接�?br /> �Q?�Q�、@see Label 使用HTML标记产生链接
�Q?�Q�、@see package.class#member Label 使用Java语言的名字package.class #member产生链接�?br /> �?@serial field-description 用于�~�省可序列化域的注释�Q�从JDK/SDK 1.2开始引入�?br /> �?@serialField field-name field-type field-description 建立Serializable�cȝ��serialPersistentFields成员的ObjectStreamField�l��g的文档，从JDK/SDK 1.2开始引入�?br /> �?@serialData data-description data-description建立数据序列和类型的文档�Q�从JDK/SDK 1.2开始引入�?br /> �?@since since-text 利用since-text内容为文档增�?since"标题�Q�从JDK/SDK 1.1开始引入�?br /> �?@throws class-name description 与@exception同义。用class-name和description��出文档添�?抛出"标题�Q�从JDK/SDK 1.2开始引入�?br /> �?@version version-text ��d��"版权"标题�Q�从JDK/SDK 1.0开始引入�?br /> 上面介绍了标准doclet提供的所有标记。不�q�，需要注意这些标记的使用是有位置限制的。其中可以出现在�c�L��者接口文档注释中的标记有�Q�@see�?a href="mailto:%7B@link">{@link}、@since、@deprecated、@author、@version。可以出现在�Ҏ��或者构造器文档注释中的标记有：@see�?a href="mailto:%7B@link">{@link}、@since、@deprecated、@param、@return、@throws、@exception、@serialData。可以出现在域文档注释中的有�Q�@see�?a href="mailto:%7B@link">{@link}、@since、@desprecated、@serial、@serialField�?br /> 除了javadoc自��n提供的标准标��C��外，我们可以定制自己的标记吗�Q�当然可以。只需要对javadoc标准的doclet�E�序�q�行扩充卛_��。实际上�Q�利用javadoc提供的doclet API�Q�不仅可以扩充doclet标记�Q�甚臌��可以改变javadoc的整个输出。�ؓ了满��需要，你可以��javadoc输出普通文本、XML文�g�{�。由于扩充doclet涉及到Java�~�程�Q�本文不再做深入介绍�?br /> ��M��Q�javadoc提供了完整规范的API文档功能。在软�g��目��理中，合理��C��用javadoc不仅可以减少开发时的文档工作量�Q�提高效率；而且�q�非常有利于��来软�g的修改和�l�护�?br /> JavaDoc 书写规范�Q?br /> 1�?File Header Comments : 每个文�g都应该加上文件头标记�Q�包括文件名、修改历双Ӏ�版权信息和附加信息。例如：

/**
* @(#)demo.java 1.00 2002/05/27
*
* Copyright (c) 2000-2002 中国�q�_��保险股䆾有限公司版权所�?br /> * Ping An Insurance Company of China. All rights reserved.

* This software is the confidential and proprietary
* information of Ping An Insurance Company of China.
* ("Confidential Information"). You shall not disclose
* such Confidential Information and shall use it only
* in accordance with the terms of the contract agreement
* you entered into with Ping An.
*/

2、class description:�c�M��息，概括的描�q�类的功能和实现�?br /> /** class description
*/
3、Variable Description:描述变量的意义和取值含义�?br /> /** var variable description
*/
4、Method Description:标明每个�Ҏ��的输入、输出参数和�q�回值类型，说明�Ҏ��变量取值的含义。相关类文档链接�?br /> /** method description
* @param var signification
* @exception exception class name
* @return return_value return signification
*/

5、Association Description:兌��c�L��档描�q�ͼ�在注释当中需要参引其它文档描�q�的地方�Q�可在相应的注释当中如下插入�Q?br /> /** method description
* @param var signification
* @exception exception class name
* @return return_value return signification
* @see package.class#member label
*/
6、包描述文�g�Q�概括描�q�包的功能和设计概要。�ؓ每个包创��Z��个描�q�文�Ӟ��命名为package.html�Q�与包的java文�g攑֜�一赗��?br /> 注：javadoc生成文档�Ӟ��会将该html文�g的第一句放在package summary中，而把整个内容攑֜�Overview summary�?/p>

macrochao 2008-05-13 22:50 发表评论

macrochao — Wed, 19 Mar 2008 03:24:00 GMT

先说下素数基本概念，素数是除自己和本�w�不能被其他整数整除的一个数�?br /> �q�个�E�序效率比较低，主要�Ҏ��是��所判断的数除以所有除他本�w�和1的数�Q�若能整数某数则不是素数�?br />

public class Prime {
    public static boolean isPrime(int num){
        for(int i=2;i<num;i++){
            if((num%i)==0){
                return false;
            }
        }
        return true;
    }
    public static void main(String[] args){
        for(int i=1;i<=100;i++){
            if(isPrime(i)){
                System.out.print(i+" ");
            }
        }
    }
}

此程序注意事��判断是否�ؓ素数�Ҏ��中i初始值必��Mؓ2�Q�因为素数能除尽1。判断条件必��d��于该数因为素数能除尽自己�?br />

macrochao 2008-03-19 11:24 发表评论

JAVA中位�q�算与负数求二进制�ȝ��

macrochao — Fri, 29 Feb 2008 06:15:00 GMT

负数求解�Ҏ��Q?br /> �?7二进�?br /> 1.先将-7�l�对��D�{换成二进�Ӟ��?0000111
2.然后求该二进制数的反码，�?1111000
3.最后�ؓ�W�二步得到的二进制数+1�Q�结果�ؓ11111001

位运��求解方法：
求~7的十�q�制�l�果
1.先将7�l�对��D�{换成二进�Ӟ��?0000111
2.然后求该二进制数的反码，�?1111000�Q�此时�ؓ~7的二�q�制表达式，然后��通过该二�q�制得该数的十进�?br /> 3.�׃��该二�q�制最高位�?�Q�所以该��Cؓ负数�Q�由于负数的求解方式是求反后+1�Q�所以通过反过来的�Ҏ��求该数的10�q�制。该�?1�?1110111
4.该二�q�制数求�?0001000�Q�得�l�果�?.

macrochao 2008-02-29 14:15 发表评论

欧美成人免费在线视频,在线电影院国产精品,99re热这里只有精品视频

JAVA中位�q�算与负数求二进制�ȝ��