JAVA基础语法（三）

一、包机制

JAVA提供了包机制，用于防止类名的命名空间重复

1. 本质就是文件夹让重名的Demo也可以命名

解决多级包合并的问题--->取消勾选

一般利用公司域名倒置作为包名：

com.baidu.www

• com
  • baidu
    • www
    • baike
    • tieba

2.导入

package com.Shelton.operator;//包名必须在最前

import com.Shelton.base.Demo01;//报错 导入包的class文件与当前class文件重名

public class Demo01 {
    public static void main(String[] args) {
        //二元运算符
        int a = 10;
        int b = 20;
        int c = 25;
        int d = 25;

import com.Shelton.base.*;//.*通配符，会导入包下所有的类

二、JavaDoc

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

• java jdk帮助文档

@author 作者名

@version 版本号

@since 指明需要最早使用的jdk版本

@param 参数名

@return 返回值情况

@throws 异常抛出情况

package com.Shelton.base;

/**
 * @author Kuangshen
 * @version 1.0
 * @since 1.8
 */

//加在类上面，就是类的注释
public class Doc {

    String name;//属性

    /**
     *
     * @param name
     * @return
     */
    
//加在方法上面，就是方法的注释
    public String test(String name){//方法
        return name;
    }

}

public class Doc {

    String name;//属性

    /**
     * 
     * @param name
     * @return
     * @throws Exception
     */
    public String test(String name) throws Exception{//方法
        return name;
    }

}

2 用命令行生成javadoc文档

进入包目录（idea可以直接右键show in explorer），地址栏输入cmd进入命令行

javadoc -encoding UTF-8 charset "文档名".java

3 用idea生成javadoc文档

-encoding UTF-``8` `-charset UTF-``8` `-windowtitle ``"test"

• encoding是java代码编码，

• charset是对生成文档所用的编码。

• windowtitle就是对应html的