学习java Day07

包机制

作用:

类比文件夹,防止命名空间重复

命名规则:

一般用公司域名倒置作为包的名称 .

例如百度www.baidu.com

则命名为:com.baidu.www

包的语法格式:

 package  pkg1[.pkg2 [. pkg3 ...]];

包的导入

定义包叫 package

导入包叫 import

import  package1[ . package2 ...].(classname |*);

导入的包需要放在当前类所在包的下面,否则会报错

注意导入的包内类名不能跟当前类名一样

导入包内所有类

例如:

//导入这个包下所有的类 *通配符
import  com.kuang.base.*;

---

JavaDoc生成文档

javadoc命令是用来生成自己API文档的

参数信息

• @author 作者名
• @version 版本号
• @since 指明需要最早使用的jdk版本
• @param 参数名
• @return 返回值情况
• @throws 异常抛出情况

//给类加参数信息
package com.kuang.base;

/**
 *@author kuangshen
 *@version 1.0
 *@since  1.8
 */
 pubulic class Doc{
    String name;
    
 }

package com.kuang.base;

 pubulic class Doc{
    String name;
    public String test(String name){
        return name;
    }
       
 }

输入/**.自动生成参数信息

package com.kuang.base;

 pubulic class Doc{
    String name;
    /**
      *@param name
      *@return
      */
    public String test(String name){
        return name;
    }
       
 }

加在类的上面就是类的注解

加在方法上面就是方法的注解

DOC窗口下生成

键入:

javac -encoding UTF-8 -charset UTF-8 文件名

(-charset UTF-8,防止路径有中文导致乱码)

运行后,会生成一堆文件.打开(首页): index.html.

//以上,通过命令行,生成javadoc文件.

格式: javadoc 参数 java文件

//作业: 学会查找使用IDEA 生成javadoc文档! 面向百度编程!