Declaration Has Javadoc Problems °Ë»ç´Â ºÎÁ¤È®ÇÑ Javadoc ÄÜÅÙÆ®¸¦ µ¿¹ÝÇϴ Ŭ·¡½º¿Í Ŭ·¡½º ¸â¹ö¸¦ °Ë»öÇÕ´Ï´Ù.
Declaration Has Javadoc Problems °Ë»ç´Â ¼±¾ðÀÌ Javadoc ÅØ½ºÆ®°¡ ¼±ÇàµÇ´Â °Í¿¡ µû¶ó 4 ÅÇÀ¸·Î ³ª´©°Ô ÇÏ´Â ´ÙÀ½ ¿É¼ÇÀ» °¡Áý´Ï´Ù:
Class
tab
|
Scope
|
None - Ŭ·¡½º¸¦ À§ÇÑ ¾î¶²
Javadoc ÁÖ¼®µµ ÇÊ¿äÇÏÁö ¾Ê½À´Ï´Ù
Public -
Javadoc ÁÖ¼®Àº public Ŭ·¡½º¸¸À» À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
Package - Javadoc
ÁÖ¼®Àº public Ŭ·¡½º¿Í ÆÐŰÁö ·ÎÄà Ŭ·¡½º¸¦ À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
|
|
Required tags
|
@author - @author°¡ ÇÊ¿äÇÕ´Ï´Ù
@version - @version
°¡ ÇÊ¿äÇÕ´Ï´Ù
|
Method
tab
|
Scope
|
None - ¸Þ¼Òµå¸¦ À§ÇÑ ¾î¶²
Javadoc ÁÖ¼®µµ ÇÊ¿äÇÏÁö ¾Ê½À´Ï´Ù
Public -
Javadoc ÁÖ¼®Àº public ¸Þ¼Òµå¸¸À» À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
Protected -
Javadoc ÁÖ¼®Àº public°ú Protected ¸Þ¼Òµå¸¦ À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
Package - Javadoc
ÁÖ¼®Àº public, Protected, package local ¸Þ¼Òµå¸¦ À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
Private - Javadoc
ÁÖ¼®Àº for public, protected, package local, private ¸Þ¼Òµå¸¦ À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
|
|
Required tags
|
@return -
@return ű״ ¸®ÅÏ Å¸ÀÔÀÌ void º¸´Ù ´Ù¸¥ ¸Þ¼Òµå¸¦ À§ÇØ ÇÊ¿äÇÕ´Ï´Ù.
@param -
@param ű״ °¢ ¸Å°³ º¯¼ö¸¦ À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
@throws ¶Ç´Â @exception -
@throws ¶Ç´Â @exception ű״ ¸Þ¼Òµå ½Ã±×³ÊÃÄ¿¡ ´øÁ®Áö´Â °Í¿¡ µû¶ó ¼±¾ðµÈ °¢ ¿¹¿Ü¸¦ À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
|
Field
tab
|
Scope
¹üÀ§
|
None - Çʵ带 À§ÇÑ ¾î¶²
Javadoc ÁÖ¼®µµ ÇÊ¿äÇÏÁö ¾Ê½À´Ï´Ù
Public -
Javadoc ÁÖ¼®Àº public Çʵ常À» À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
Protected -
Javadoc ÁÖ¼®Àº public °ú protected Çʵ带 À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
Package -
Javadoc ÁÖ¼®Àº public°ú Protected, package local fields¸¦ À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
Private -
Javadoc ÁÖ¼®Àº public, protected, package local, privateÇʵ带 À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
|
Inner
class
|
Scope
¹üÀ§
|
None - ³»ºÎ Ŭ·¡½º¸¦ À§ÇÑ ¾î¶² Javadoc ÁÖ¼®µµ ÇÊ¿äÇÏÁö ¾Ê½À´Ï´Ù
Public -
Javadoc ÁÖ¼®Àº public ³»ºÎ Ŭ·¡½º¸¸À» À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
Protected -
Javadoc ÁÖ¼®Àº public °ú protected ³»ºÎ Ŭ·¡½º¸¦ À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
Package -
Javadoc ÁÖ¼®Àº public°ú Protected, package local fields¸¦ À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
Private -
Javadoc ÁÖ¼®Àº public, protected, package local, private³»ºÎ Ŭ·¡½º¸¦ À§ÇØ ÇÊ¿äÇÕ´Ï´Ù
|
|
¸¸ÀÏ Declaration
Has Javadoc Problems üũ ¹Ú½º°¡ ¼±Åõǰí Inspection ÀÌ ¾î¶² ¹®Á¦¸¦ ãÀ¸¸é, Inspection Åø À©µµ¿ì´Â Javadoc°¡ °¨ÁöÇÑ ¹®Á¦°¡ ÀÖ´Â °÷ÀÇ ¸Þ¼Òµå/Ŭ·¡½º/Çʵ带 º¸¿©ÁÖ´Â Javadoc ÅÇÀ» Ç¥½ÃÇÕ´Ï´Ù.
°Ë»ç¿¡ ÀÇÇØ ¹ß°ßµÈ ¹®Á¦¸¦ À§ÇÑ ¾î¶² »çÀü Á¤ÀÇÀÇ ¼Ö·ç¼Çµµ ÀÖÁö ¾Ê½À´Ï´Ù.
´ÙÀ½ Ŭ·¡½º¸¦ º¸½Ê½Ã¿À:
public class AClass {
/**
*
* @param m_str
* @param m_int
*/
public void myMethod(String m_str, int m_int, MyAdapter myAdapter) {
//some code here
}
}
Inspection ÀÌ AClass ¿¡ Àû¿ëµÇ°í ³ ÈÄ¿¡, ´ÙÀ½ÀÇ Åø À©µµ¿ì°¡ ³ªÅ¸³¯ °ÍÀÔ´Ï´Ù.

Inspection Àº ¸î °³ÀÇ Javadoc ¿ä±¸ »çÇ×ÀÌ ºÎÇÕÇÏÁö ¾Ê¾Ò´Ù¶ó°í ÁöÀûÇÕ´Ï´Ù. ƯÈ÷, Ŭ·¡½º´Â ¾î¶² ÇÊ¿äÇÑ Javadocµµ °¡ÁöÁö ¾Ê½À´Ï´Ù, ¸Þ¼Òµå´Â missed ű׸¦ °®°í ¸Þ¼Òµå ¼³¸í¿¡ ¾î¶² ±â°£µµ ÀÖÁö ¾Ê½À´Ï´Ù.
|