อินเตอร์เฟซ:
โดยทั่วไปอินเตอร์เฟสจะแสดงสัญญาโดยไม่เปิดเผยรายละเอียดการใช้งานพื้นฐาน ในการเขียนโปรแกรมเชิงวัตถุอินเทอร์เฟซกำหนดชนิดนามธรรมที่เปิดเผยลักษณะการทำงาน แต่ไม่มีตรรกะ การใช้งานถูกกำหนดโดยคลาสหรือชนิดที่ใช้อินเทอร์เฟซ
@interface: (ประเภทคำอธิบายประกอบ)
ใช้ตัวอย่างด้านล่างซึ่งมีความคิดเห็นมากมาย:
public class Generation3List extends Generation2List {
// Author: John Doe
// Date: 3/17/2002
// Current revision: 6
// Last modified: 4/12/2004
// By: Jane Doe
// Reviewers: Alice, Bill, Cindy
// class code goes here
}
แทนที่จะเป็นเช่นนี้คุณสามารถประกาศประเภทคำอธิบายประกอบได้
@interface ClassPreamble {
String author();
String date();
int currentRevision() default 1;
String lastModified() default "N/A";
String lastModifiedBy() default "N/A";
// Note use of array
String[] reviewers();
}
ซึ่งสามารถใส่คำอธิบายประกอบคลาสดังนี้
@ClassPreamble (
author = "John Doe",
date = "3/17/2002",
currentRevision = 6,
lastModified = "4/12/2004",
lastModifiedBy = "Jane Doe",
// Note array notation
reviewers = {"Alice", "Bob", "Cindy"}
)
public class Generation3List extends Generation2List {
// class code goes here
}
PS:
คำอธิบายประกอบจำนวนมากแทนที่ความคิดเห็นในรหัส
การอ้างอิง: http://docs.oracle.com/javase/tutorial/java/annotations/declaring.html