Java基础 包机制和注释文档

Java基础

一、包机制

为了便于类包的管理和命名冲突建立的文件夹

1.建包 Package

命名规范:

package package1.package2.package3.(类名)……

注意事项:

  1. 建立公司的包时,要严格遵守域名倒置 例如:com.baidu.www

  2. package语句要写在最顶端

 


 

2.导包 import

命名规范:

import java.lang.date.(类名)……

注意事项:

import语句要写在package语句之下,类的外面

 


 

二、注释文档

Java支持单行注释、多行注释和注释文档

注释文档是用于在程序内生成关于程序的信息,使程序员更方便的记录程序的信息

1.注释文档的基本参数

写在类的外部

/**

  • // 注释文档

  • @author Wavesboker //作者名

  • @version //版本号

  • @since //开发用的Java版本

  • @param //参数名

  • @return //返回值

  • @throws //异常抛出情况 */

 


 

写在方法内

public class Demo10 { String name;

/** *

  • @param name

  • @return

  • @throws Exception //抛出异常 */

public String Test(String name) throws Exception{ return name;

}

 


 

2.使用命令行生成doc文件

在文件夹内打开cmd

命令行内使用javadoc指令生成API文档

-encoding UTF-8 将编码格式输出为UTF - 8 以免因中文产生乱码

-charset UTF -8 将字符集编码格式也改成UTF-8

Demo1.java 选择生成doc信息的文件

 


 

3.使用IDEA软件生成Doc文档

选择Tools > Generate Javadoc

按步骤设置 > 点击OK

 


 

posted @ 2021-08-11 19:42  海涛布克  阅读(85)  评论(0编辑  收藏  举报