Java基础11--12：包机制，Doc

Java基础11：包机制

• 为了更好的组织类，Java提供了包机制，用于区别类名的命名空间。

• 包语句的语法格式为：

  • package com.wang.operator;
    

    package后面是各个包的位置

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

• 为了能够使用某一个包的成员，我们需要在Java程序中明确导入该包。使用“import”语句可完成此功能。

import com.wang.base.Demo02;

package com.wang.operator;

//import com.wang.base.Demo02;
import com.wang.base.*  //导入这个包下所有的类！

import java.util.Date;

public class Demo01 {
    public static void main(String[] args) {
        
       Date	//输入后上方会自动出现	import java.util.Date;
        
    }
}    

Java基础12：Doc

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

• 参数信息

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

• 用文档注释来写

  • 加在类上面就是类的注释
  • 加在方法上面就是方法的注释

  package com.wang.base;
  
  //类注释
  /**
   * @author 若初
   * @version 1.0
   * @since 1.8
   */
  -----------------------------------------
  public class Doc {
  
      String name;
  //方法注释
      /**
       * 
       * @param name
       * @return
       * @throws Exception
       */
      public String test(String name) throws Exception{
          return name;
      }
  }
  

  第一种生成文档的方法

  1. 点击Show in Explorer（打开所在文件夹）
     
  2. 在当前位置打开Dos窗口，输入“cmd空格”，回车
     
  3. 输入**“javadoc -encoding UTF-8 -charset UTF-8 Doc.java”**回车
  4. 返回文件夹，你会发现多出好多后缀为.html的文件。点击此处
  5. 点击Dos
  6. 这就是把Java文件编译成一份文档，供我们阅读

• 以上是通过命令行完成的，

第二种方法：

作业：学会查找使用IDEA生产JavaDoc文档！面向百度编程！

1. 首先创建一个文件夹，用来存放生成的文档

2. 点击<

3. 1. 是找到开始创建的文件夹
   2. zh_CN表示中文
   3. -encoding UTF-8 -charet UTF-8
   4. ok

   
   ​

基础部分的一切知识，后面几乎每天都会用