jar和javadoc命令的使用,Android外包是如何进入阿里的

程序示例

1:将当前目录下所有CLASS文件打包成新的JAR文件:

jar cf file.jar *.class

2:显示一个JAR文件中的文件列表

jar tf file.jar

3:将当前目录下的所有文件增加到一个已经存在的JAR文件中

jar cvf file.jar *

JavaDoc文档标记

javadoc注释以/**开始,以*/结束,里面可以包含普通文本、HTML标记和javadoc标记。javadoc只处理源文件中在类/接口定义、方法、域、构造器之前的注释,忽略位于其他地方的注释。举例如下:

/**

*Demo–Helloworld

*@author sunjl

*@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 copyright

*/

假定生成文档的根目录是doc,上面注释所在的文件最后生成的文件是docutilityutl.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 getComponentAt 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 Label 使用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不仅可以减少开发时的文档工作量,提高效率;而且还非常有利于将来软件的修改和维护。

自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。

深知大多数初中级安卓工程师,想要提升技能,往往是自己摸索成长,但自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!

因此收集整理了一份《2024年最新Android移动开发全套学习资料》送给大家,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
img
img
img
img

由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频
如果你觉得这些内容对你有帮助,可以添加下面V无偿领取!(备注Android)
img

写在最后

对程序员来说,很多技术的学习都是“防御性”的。也就是说,我们是在为未来学习。我们学习新技术的目的,或是为了在新项目中应用,或仅仅是为了将来的面试。但不管怎样,一定不能“止步不前”,不能荒废掉。

![
[]


文章以下内容会给出阿里与美团的面试题(答案+解析)、面试题库、Java核心知识点梳理等,需要这些文档资料的,直接点击我的GitHub免费领取~

3527932)]
[外链图片转存中…(img-cxX6ekxg-1710663527932)]

文章以下内容会给出阿里与美团的面试题(答案+解析)、面试题库、Java核心知识点梳理等,需要这些文档资料的,直接点击我的GitHub免费领取~

  • 15
    点赞
  • 23
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值