Java 주석 소개
주석 기반 Java 개발은 의심할 여지 없이 최신 개발 추세입니다. [역자 주: 이 기사는 2005년 기사입니다. 2014년에 주석 사용이 협업 환경에서 다중 사용자 공동 개발을 위한 좋은 솔루션이 되었다는 것은 의심의 여지가 없습니다. 방식으로 상호 영향과 결합이 매우 낮을 수 있습니다.]
주석 기반 개발을 통해 Java 개발자는 번거롭고 번거로운 구성 파일에서 벗어날 수 있습니다. 주석은 Java 5.0에서 처음으로 도입된 기능으로, 프로그래머의 작업을 Java 샘플 API 파일 작성 작업으로 컴파일러에 전달합니다. . 별도의 소스 코드와 API 문서가 더 이상 유지되지 않으면 코드와 문서를 유지하기가 더 쉽습니다. 또한 생성된 코드 예제에 버그가 포함될 가능성도 줄어듭니다.
Java 주석은 JDK 5의 주요 기능 중 하나로서 개발을 더욱 간단하고 쉽게 만들어줍니다. 주석은 일종의 메타 정보(특수 프로그램이 볼 수 있는 추가 정보로 이해될 수 있음)와 같으며 In code에 추가할 수 있습니다. , 패키지 선언, 유형 선언, 생성자, 메소드, 필드, 매개변수 및 변수에서 사용할 수 있습니다. 이는 메소드가 다른 메소드에 의존하는지, 완전한지, 클래스가 다른 클래스를 참조하는지 등을 나타내는 효율적인 방법을 제공합니다.
Oracle의 공식 웹사이트에서 인용하면 "(주석 기반 개발)을 사용하면 많은 경우 별도의 API 문서를 작성하지 않아도 됩니다. 소스 코드에서 주석을 생성하는 도구만 활성화하면 됩니다. 이는 선언적 프로그래밍 스타일이 되었습니다. 프로그래머들은 해야 할 일은 코드에 따라 도구가 하도록 놔두기만 하면 된다고 말합니다."
간단히 말해서, 주석은 메타 태그를 프로그램 요소와 연결하는 메커니즘으로, 컴파일러나 JVM이 주석이 달린 요소에서 프로그램 동작을 추출하고 필요할 때 상호 의존적인 코드를 생성할 수 있도록 합니다.
이 기사 시리즈의 첫 번째 부분에서는 몇 가지 기본 Java 주석, 이점 및 몇 가지 사용 예를 소개합니다.
Java 주석 기본 사항
두 가지를 이해해야 합니다. 하나는 "주석"(새 객체와 유사한 주석) 자체이고 다른 하나는 "주석 유형"(주석 유형, 클래스 정의와 유사)입니다. 코드에는 실제로 수명주기와 적용 범위가 있습니다. 주석 유형은 주석을 정의하는 데 사용됩니다. type은 실제로 사용되는 생성된 유형이고 주석은 해당 유형의 특정 용도일 뿐입니다.
주석 유형을 정의할 때 "at"(@, 중국에서는 원으로 발음하는 사람도 있음) 표시를 사용한 다음 키워드 인터페이스와 주석 이름을 사용해야 합니다. 주석의 경우에도 먼저 "at" 기호(@)를 쓰고 그 뒤에 주석 유형을 작성합니다. 또한 주석을 사용할 때 이름 뒤에 괄호를 추가하여 필요한 매개변수를 포함할 수 있습니다. 다음으로 그 예를 볼 수 있습니다.
Annotation Type 정의 예: (Annotation Type, Annotation type, 클래스 정의와 유사)
다음과 같이 코드 코드를 복사합니다.
공개 @interface MyAnnotation {
문자열 doSomething();
}
일반 코드에서 주석(Annotation 인스턴스) 사용
다음과 같이 코드 코드를 복사합니다.
@MyAnnotation(doSomething="해야 할 일")
공개 무효 mymethod() {
....
}
Java 주석 유형(주석 유형)
주석에는 세 가지 유형이 있습니다.
마커: 마커 유형 주석에는 요소가 없고 이름만 있습니다.
정의:
다음과 같이 코드 코드를 복사합니다.
// 이런 종류의 주석은 상태가 없는 라벨과 같습니다.
// 메서드 정의가 없는 직렬화 가능 인터페이스와 약간 비슷합니다.
공개 @interface AMarkerAnnotation {
}
사용:
다음과 같이 코드 코드를 복사합니다.
@AMarkerAnnotation
공개 무효 mymethod() {
....
}
단일 요소 주석: 단일 요소 또는 단일 값 주석은 하나의 데이터만 전달합니다. 괄호 안에 data=value로 표시하거나 하나의 값만 전달할 수 있습니다(간단한 작성 방법).
정의:
다음과 같이 코드 코드를 복사합니다.
공개 @interface SingleElementAnnotation
{
문자열 doSomething();
}
사용:
다음과 같이 코드 코드를 복사합니다.
@SingleElementAnnotation ("해당 유형의 값만 전달할 수 있습니다")
공개 무효 mymethod() {
....
}
전체 값 또는 다중 값 주석: 전체 값 유형 주석에는 여러 데이터 멤버가 있으므로 각 멤버에 대해 완전한 data=value 구문 형식을 사용하여 매개변수를 전달해야 합니다.
정의:
다음과 같이 코드 코드를 복사합니다.
공개 @interface FullValueAnnotation {
문자열 doSomething();
정수 개수;
문자열 날짜();
}
사용:
다음과 같이 코드 코드를 복사합니다.
@FullValueAnnotation(doSomething="매개변수 값", 개수=1,
날짜="2005년 9월 9일")
공개 무효 mymethod() {
....
}
Java 주석 유형 정의 시 고려 사항
주석 유형을 정의할 때 참고할 사항:
1. 주석 선언은 at 기호(@)로 시작하고 그 뒤에 인터페이스 키워드와 주석 이름이 와야 합니다.
2. 주석의 메소드 선언은 어떤 매개변수도 허용하지 않습니다(메소드처럼 보이지만 본질적으로 속성 도메인입니다).
3. 주석의 메소드 선언에는 throws 절이 있을 수 없습니다.
4. 주석의 메서드 반환 유형은 다음과 같습니다.
@primitives(6개의 기본 데이터 유형, int, byte 등)
@String(문자열)
@Class(String.class와 같은 클래스)
@enum(열거)
위 유형의 @array (배열, 배열 요소는 위 유형 중 하나만 가능)
Java 주석 유형
JDK5에는 두 가지 유형의 주석이 있습니다.
1. 단순 주석(단순 주석 유형): Tiger에서 제공하는 기본 유형입니다(Tiger는 JDK1.5의 코드 이름입니까?). 일반 코드에 주석을 추가하는 데만 사용할 수 있으며 다른 사용자 정의 주석 유형을 생성하는 데 사용할 수 없습니다. .
2. 메타 주석: 다른 주석 유형의 선언에 주석을 달기 위해 특별히 설계되었습니다. 간단히 말해서 주석 주석이라고 합니다.