补充知识点——Eclipse打jar包与JavaDOC文档的生成
1、Eclipse如何打jar包,如何运行jar包
Java当中编写的Java代码,Java类、方法、接口这些东西就是项目中相关内容,到时候我们需要把代码提供给甲方、或者是我们需要运行我们编写的代码,我们总不能给甲方安装一个Eclipse开发环境,然后在开发环境中运行。我们一般是将编写好的Java代码打包称为一个jar包(是Java中一种特殊的压缩包,压缩包中存放的是Java中所有class二进制字节码文件以及项目中一些静态资源),把jar包给了甲方或者我们直接运行jar包就ok了。
打包方式:项目名—>export—>java—>jar file
运行方式:在命令行执行命令运行
java -jar xxx.jar包的路径 需要我们在打jar包时指定main-class文件
java -cp xxx.jar包的路径 全限定类名
2、JavaDOC文档
在编写项目的时候,我们自己定义很多的java类、方法、接口等等,编写的代码在很多情况下可不是我们自己看的,我们需要给甲方、或者是后来者查看,但是如果直接给他们看源代码的话,有点复杂了,源代码里面的东西说白了,挺乱的。因此Java给我们提供了一种注释语法:文档注释/** */,可以通过文档注释生成项目中的API文档,这样的话用户就不要看源码中注释了,只需要看API文档,就可以掌握项目中所有代码的含义。
Java文档注释中可以加一些注解去详细描述Java类和方法:
@author 作者(用于类和方法)
@since 版本—从哪个版本开始有的(用于类和方法)
@see 全限定类名 这个类和see中的类是有关系的(用于类和方法)
@version 类的版本(用于类和方法)
@param 参数名 参数注释 方法中形参的含义和注释(用于方法)
@return 注释 方法的返回值的注释(用于方法)
生成JavaDOC文档方式:项目名—>export—>java—>javadoc
文档生成后,点击index.html进行查看
即JavaDOC文档生成!