Declaration Has Javadoc Problems  

 


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 ű׸¦ °®°í ¸Þ¼Òµå ¼³¸í¿¡ ¾î¶² ±â°£µµ ÀÖÁö ¾Ê½À´Ï´Ù.