20200304学习Java:包机制和javadoc

包机制

语法格式

package pkg1;//一般用域名的倒置作为包名,例如com.baidu

导入形式

 import package1.package2.classname;
 import package1.package2.*;//导入这个包下所有的类

JavaDoc生成文档

javadoc命令是用来生成自己API文档的,api文档属于一种文档注释。

package com.kuang.base;
/**
*@author Yanhao
*@version 1.0
*@since 1.8
*/
public class Doc{
    String name;
 /**
 *@author Yanhao
*@param name 
*@throws Exception
*/
 public String test(String name) throws Exception{
     return name;
 }
}

加在类上是类的注解,加在方法上是方法的注解。

格式:javadoc 参数 Java文件

如何在IDEA中生成javadoc的api文档

  • javadoc常用标识

@author 作者
@version 版本号
@param 参数名 描述 方法的入参名及描述信息,如入参有特别要求,可在此注释。
@return 描述 对函数返回值的注释
@deprecated 过期文本 标识随着程序版本的提升,当前API已经过期,仅为了保证兼容性依然存在,以此告之开发者不应再用这个API。
@throws异常类名 构造函数或方法所会抛出的异常。
@exception 异常类名 同@throws。
@see 引用 查看相关内容,如类、方法、变量等。
@since 描述文本 API在什么程序的什么版本后开发支持。
{@link包.类#成员 标签} 链接到某个特定的成员对应的文档中。
{@value} 当对常量进行注释时,如果想将其值包含在文档中,则通过该标签来引用常量的值。

  • 第一步:在工具栏中找到 Tool,然后再子菜单中找到 Generate JavaDoc。
  • 第二步:在生成文档上进行配置。

参数说明

1.Whole project:整个项目都生成文档

2.Custom scope 自定义范围。如下:

(1)project files 项目文件,

(2)project production files 项目产品文件,

(3)project test files 项目的测试文件, 未知范围,class hierarchy 类层

3.include test source 包含测试目录

4.include JDK and … 包含jdk和其他的第三方jar

5.link to JDK documentation…链接到JDK api

6.output directy 生成的文档存放的位置

(1)private、package、protected、public 生成文档的级别(类和方法)

(2)右边的Generate…是选择生成的文档包含的内容,层级树、导航、索引…

(3)再右边是生成的文档包含的内容信息,作者版本等信息

7.Locale 语言类型,zh-CN

8.Other command line arguments 其他参数

9.Maximum heep… 最大堆栈

  • IntelliJ IDEA作为Java流行的编辑器, 其生成一些Javadoc会对中文乱码, 使用UTF-8编码即可. 这个常见的问题, 则需要生成时设置参数即可.

    在 “Tools->Gerenate JavaDoc” 面版的 “Other command line arguments:” 栏里输入 :

    传入JavaDoc的参数,一般这样写
    -encoding UTF-8 -charset UTF-8

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值