Java註釋與規範、javadoc命令生成幫助手冊
阿新 • • 發佈:2019-01-26
1.檢視Eclipse中自動編譯出來的.class檔案:
導航器--類似於Windows中的資源管理器
選擇選單“Window → Show View → Navigator” 專案名稱下---bin目錄
2.註釋---是寫給人(程式設計師)看的,對程式執行沒有影響的程式碼。
A.單行註釋:// 單行註釋以 // 開始,例如:
// 輸出資訊到控制檯
System.out.println("Hello World!!!");
B.多行註釋:/* ... */ 多行註釋以/*開頭,以*/結尾 ,例如:
/*
* 這是一個多行註釋
* 這是Java程式執行的入口
*/
public static void main(String[] args) {
// 輸出資訊到控制檯
System.out.println("Hello World!!!");
}
C.文件註釋:/** ... */ 以/**開頭,以*/結束 主要用於生成幫助文件或手冊 例如:
package com.ddb.javacore.helloworld;
/**
* 作者:ddb
* 時間:2017.03.17
* 說明:這是我的第一個java程式--HelloWorld
*/
public class HelloWorld {...}
說明:為了我們寫的程式碼容易被看懂,強烈建議養成程式碼寫註釋的好習慣
3.Java編碼規範
A.包名:全小寫
B.檔名與類名一致
C.一個Java原始碼檔案正常只包含一個public修飾的類
D.類名:每個單詞的首字母都大寫,駝峰式命名
E.變數:第一個單詞的首字母小寫,後面每個單詞的首字母大寫
F.方法:與變數命名規則一致
G.一行只寫一條語句,並以;結尾
H.所有名稱的命名,盡力做到見名之意!
4.javadoc命令生成幫助文件
index開頭的檔案,通常都是首頁檔案
1.使用CMD提取文件註釋的方式:
2.使用Eclipse提取文件註釋的方式: 3.使用EditPluse提取文件註釋的方式:-encoding UTF-8 -charset UTF-8 $(FileName) 其他知識: 1.Eclipse 中程式碼進行格式化快捷鍵:Ctrl+Shift+F; 2.在Eclipse的程式碼區中右鍵--show in --System explorer 可以開啟當前編輯的原始碼檔案在作業系統中的目錄的位置; 3.【Ctrl++】、【Ctrl + -】放大和縮小當前正在編輯檔案的字型大小; 4.【Ctrl+d】刪除當前游標所在行; 5.關閉作業系統中服務,讓系統更流暢:以MySQL為例 計算機---右鍵---管理--服務和應用程式--服務--找到MYSQL57--右鍵屬性--啟動型別--手動,同時停止服務!
2.使用Eclipse提取文件註釋的方式: 3.使用EditPluse提取文件註釋的方式:-encoding UTF-8 -charset UTF-8 $(FileName) 其他知識: 1.Eclipse 中程式碼進行格式化快捷鍵:Ctrl+Shift+F; 2.在Eclipse的程式碼區中右鍵--show in --System explorer 可以開啟當前編輯的原始碼檔案在作業系統中的目錄的位置; 3.【Ctrl++】、【Ctrl + -】放大和縮小當前正在編輯檔案的字型大小; 4.【Ctrl+d】刪除當前游標所在行; 5.關閉作業系統中服務,讓系統更流暢:以MySQL為例 計算機---右鍵---管理--服務和應用程式--服務--找到MYSQL57--右鍵屬性--啟動型別--手動,同時停止服務!