Java基礎語法（4）包機制與JavaDoc

---

包機制

一、問題發現

存在這樣一個問題：當定義了多個類的時候，可能會發生類名的重複問題。
解決方式：在java中採用包機制處理開發者定義的類名衝突問題。就比如咱們平時的用電腦，一個文件夾下不能存在同名的文件，咱們要是有這樣的需求，可是又不想換名字，咱們就能夠考慮使用新建一個文件夾來存放！在Java中也是這樣的。

二、包的做用

爲了更好地組織類，Java 提供了包機制，用於區別類名的命名空間。

包的做用：

一、把功能類似或相關的類或接口組織在同一個包中，方便類的查找和使用。
二、如同文件夾同樣，包也採用了樹形目錄的存儲方式。同一個包中的類名字是不一樣的，不一樣的包中的類的名字是能夠相同的，當同時調用兩個不一樣包中相同類名的類時，應該加上包名加以區別。所以，包能夠避免名字衝突。
三、包也限定了訪問權限，擁有包訪問權限的類才能訪問某個包中的類。Java 使用包（package）這種機制是爲了防止命名衝突，訪問控制，提供搜索和定位類（class）、接口、枚舉（enumerations）和註釋（annotation）等。

語法格式爲：

package pkg1[．pkg2[．pkg3…]];

 

例如,一個Koudada.java 文件它的內容:

package net.java.util;public class Koudada{
...
}

 

那麼它的路徑應該是 net/java/util/Koudada.java 這樣保存的。 package(包) 的做用是把不一樣的java 程序分類保存，更方便的被其餘 java 程序調用。

如下是一些 Java 中的包：
java.lang-打包基礎的類
java.io-包含輸入輸出功能的函數

三、建立包

建立包的時候，你須要爲這個包取一個合適的名字。以後，若是其餘的一個源文件包含了這個包提供的類、接口、枚舉或者註釋類型的時候，都必須將這個包的聲明放在這個源文件的開頭。

通常利用公司域名倒置做爲包名：www.baidu.com 包名：com.baidu.www。

四、import 關鍵字

爲了可以使用某一個包的成員，咱們須要在 Java 程序中明確導入該包。使用 "import" 語句可完成此功能。
在 java 源文件中 import 語句應位於 package 語句以後，全部類的定義以前，能夠沒有，也能夠有多
條，其語法格式爲：

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

 

若是在一個包中，一個類想要使用本包中的另外一個類，那麼該包名能夠省略。要是要用到其餘包下的類，就必需要先導包！
若是兩個類重名，須要導入對應的包，不然就須要寫出完整地址：

com.kou.da.Hello hello = new com.kou.da.Hello()

 

用 import 關鍵字引入，使用通配符 "*" , 導入io包下的全部類

import java.io.*;

 

使用 import 關鍵字引入指定類:

import com.kou.Hello;

 

JavaDoc

簡介

JavaDoc是一種將註釋生成HTML文檔的技術，生成的HTML文檔相似於Java的API，易讀且清晰明瞭。

使用方式：使用命令行在目標文件所在目錄輸入javadoc +文件名.java。

• 以 /* 開始，以 / 結束。
• @author 做者名
• @version 版本號
• @since 指明須要最先使用的jdk版本
• @param 參數名
• @return 返回值狀況
• @throws 異常拋出狀況

總結

之後這些東西在咱們的生活中會每天遇到！因此，簡單的東西，不要忽略！