Java 코드 주석 사양(동력 노드 정리)
1. 주석 형식 통일
전체 응용 프로그램에서 일관된 문장부호와 구조를 가진 스타일을 사용하여 주석을 구성합니다.만약 다른 항목에서 그들의 주석 규범이 이 문서와 다르다는 것을 발견한다면, 이 규범에 따라 코드를 쓰고, 기존의 규범 시스템에 새로운 규범을 도입하려고 하지 마라.
2. 주석 내용이 정확하고 간결하다
내용은 간단하고 명확하며 의미가 정확해야 하며 주석의 다의성을 방지해야 한다. 잘못된 주석은 무익할 뿐만 아니라 오히려 해롭다.
주석 기준:
1. 기본 주석
(a) 클래스(인터페이스)에 대한 설명
(b) 구조 함수의 주석
(c) 방법에 대한 설명
(d) 전역 변수에 대한 설명
(e) 필드/속성에 대한 주석
비고: 간단한 코드로 간단한 주석을 하고 주석 내용이 10글자 이상이면 됩니다. 또한 지속화 대상이나 VO 대상의 getter,setter 방법은 주석을 달지 않아도 됩니다.구체적인 주석 형식은 아래의 예를 참고하십시오.
2. 특수 추가 설명
(a) 전형적인 알고리즘은 반드시 주석이 있어야 한다.
(b) 코드가 명확하지 않은 곳에는 반드시 주석이 있어야 한다.
(c) 코드 수정처에 표지를 수정하는 주석을 추가합니다.
(d) 순환과 논리 분기로 구성된 코드에 주석을 추가합니다.
(e) 다른 사람에게 제공된 인터페이스는 상세한 설명을 넣어야 합니다.
비고: 이러한 주석 형식은 예가 없습니다.구체적인 주석 형식은 스스로 정의하고 주석 내용이 정확하고 간결해야 한다.
주석 형식:
1행(single-line) 주석: "//..."
2. 블록(block) 설명: "/*...*/"
3. 문서 주석: "/**...*/"
4.javadoc 주석 라벨 문법
@author 클래스에 대한 설명은 이 모듈을 개발한 저자를 표시합니다
@version 클래스에 대한 설명은 이 모듈의 버전을 표시합니다
@see 클래스, 속성, 방법에 대한 설명 참고 방향, 즉 관련 주제
@param 방법에 대한 설명 방법 중의 매개 변수에 대한 설명
@return 방법에 대한 설명 방법 반환 값에 대한 설명
@exception 방법에 대한 설명 방법이 던질 수 있는 이상에 대한 설명
참조 예:
1. 클래스(인터페이스) 주석
예:
/**
*
* @author Administrator
* @Time 2016-11-14:49:01
*
*/
public classTest extends Button {
……
}
2. 구조 메소드 주석예:
public class Test extends Button {
/**
*
* @param name
*
*/
public Test(String name){
……
}
}
3. 메소드 주석예:
public class Test extends Button {
/**
*
*@param color
*@return
*@exception ( )
* @author Administrator
* @Time2012-11-20 15:02:29
*/
public voidaddColor(String color){
……
}
}
4. 글로벌 변수 주석예:
public final class String
implements Java.io.Serializable, Comparable<String>,CharSequence
{
/** The value is used for characterstorage. */
private final char value[];
/** The offset is the first index of thestorage that is used. */
private final int offset;
/** The count is the number of charactersin the String. */
private final int count;
/** Cache the hash code for the string */
private int hash; // Default to 0
……
}
5. 필드/속성 주석예:
public class EmailBody implements Serializable{
private String id;
private String senderName;//
private String title;// 120
private String content;//
private String attach;// ,
private String totalCount;//
private String successCount;//
private Integer isDelete;//0 1
private Date createTime;//
privateSet<EmailList> EmailList;
……
}
사실 규범은 스스로 정한 것이다. 팀에서 모두가 통일적으로 준수하고 규범을 통일하면 좋은 효과를 거둘 수 있기 때문에 평소에 주석을 달지 않는 친구에게 도움이 되기를 바란다.위에서 말한 것은 여러분이 소개한 자바 코드 주석 규범(동력 노드 정리)입니다. 여러분께 도움이 되었으면 합니다. 만약에 궁금한 것이 있으면 저에게 메시지를 남겨 주십시오. 편집자는 제때에 여러분에게 회답할 것입니다.여기에서도 저희 사이트에 대한 지지에 감사드립니다!
이 내용에 흥미가 있습니까?
현재 기사가 여러분의 문제를 해결하지 못하는 경우 AI 엔진은 머신러닝 분석(스마트 모델이 방금 만들어져 부정확한 경우가 있을 수 있음)을 통해 가장 유사한 기사를 추천합니다:
38. Java의 Leetcode 솔루션텍스트를 자유롭게 공유하거나 복사할 수 있습니다.하지만 이 문서의 URL은 참조 URL로 남겨 두십시오.
CC BY-SA 2.5, CC BY-SA 3.0 및 CC BY-SA 4.0에 따라 라이센스가 부여됩니다.