[2024.12.18 JavaSE学习]包管理 && JavaDoc

今日学习知识点：

一、包管理

• 企业开发中，一般使用公司域名倒置当做包的路径层级（需要遵守的规范！！！）
• 包下.java需要在最上面使用 package 声明当前包路径，使用 import 导入包中的成员
• 在一个文件中，导入不同包的同名类会出现报错

  import java.util.Date;
  import java.sql.Date;

  可使用全限定名（fully qualified name）的方式进行类内方法使用

  import java.util.*;
  import java.sql.*;
  
  public class Class {
      public static void main(String[] args) {
          java.util.Date date1 = new java.util.Date();
          java.sql.Date date2 = new java.sql.Date(2019, 9, 16);
      }
  }

　　　　　　　　　　　　　　　　　　　　

二、JavaDoc

• Overview (Java Platform SE 8 ) -> jdk8 api 帮助文档
  
• @author 作者名
  
• @version 版本号
• @since 需要最早使用的jdk版本
• @param 参数名
• @return 返回值情况
• @throws 异常抛出情况
• 可用dos命令行进行html文档生成，e.g.

  javadoc -encoding UTF-8 -charset UTF-8 file.java

  也可以使用IDEA直接生成