JavaTM 2 Platform
Standard Ed. 5.0

java.util
ÀÎÅÍÆäÀ̽º Map<K, V>

±âÁ¸ÀÇ ¼­ºê ÀÎÅÍÆäÀ̽ºÀÇ À϶÷:
ConcurrentMap <K, V>, SortedMap <K, V>
±âÁ¸ÀÇ ±¸Çö Ŭ·¡½ºÀÇ À϶÷:
AbstractMap, Attributes, AuthProvider, ConcurrentHashMap, EnumMap, HashMap, Hashtable, IdentityHashMap, LinkedHashMap, PrinterStateReasons, Properties, Provider, RenderingHints, TabularDataSupport, TreeMap, UIDefaults, WeakHashMap

public interface Map<K, V>

۸¦ °ª¿¡ ¸ÅÇÎ ÇÏ´Â ¿ÀºêÁ§Æ®ÀÔ´Ï´Ù. ¸Ê¿¡´Â µ¿ÀÏÇÑ Å°¸¦ º¹¼ö µî·ÏÇÒ ¼ö ¾ø½À´Ï´Ù. °¢ Ű´Â 1 °³ÀÇ °ª¹Û¿¡ ¸ÅÇÎ ÇÒ ¼ö ¾ø½À´Ï´Ù.

ÀÌ ÀÎÅÍÆäÀ̽º´Â ÀÎÅÍÆäÀ̽º¶ó°í ÇÏ´Â °Íº¸´Ù ¿ÀÈ÷·Á ¿ÏÀüÇÏ°Ô Ãß»ó Ŭ·¡½º¿¡¼­ ¸¸³­ Dictionary Ŭ·¡½º¿¡ ´ë½ÅÇÏ´Â °ÍÀÔ´Ï´Ù.

Map ÀÎÅÍÆäÀ̽º°¡ Á¦°øÇÏ´Â 3 °³ÀÇ ÄÚ·¹Å©¼Çºä¿¡ ÇØ, ¸ÊÀÇ ³»¿ëÀ», Ű¼¼Æ®, °ªÀÇ Ä÷º¼Ç, ȤÀº Ű¿Í °ªÀÇ ¸ÅÇμ¼Æ®·Î¼­ Ç¥½ÃÇÒ ¼ö ÀÖ°Ô µË´Ï´Ù. ¸ÊÀÇ ¡¸¼ø¼­¡¹´Â ¸ÊÀÇ ÄÚ·¹Å©¼ÇºäÀÇ ¹Ýº¹ÀÚ°¡ ¿ä¼Ò¸¦ µ¹·ÁÁÙ ¶§ÀÇ ¼ø¼­·Î¼­ Á¤Àǵ˴ϴÙ. TreeMap Ŭ·¡½º µî ÀϺÎÀÇ ¸ÊÀÇ ±¸Çö¿¡¼­´Â ¼ø¼­¿¡ ´ëÇØ º¸ÁõÇÕ´Ï´Ù¸¸,HashMap Ŭ·¡½ºµîÀÇ ±¸Çö¿¡¼­´Â ¼ø¼­´Â º¸ÁõµÇÁö ¾Ê½À´Ï´Ù.

ÁÖ: °¡º¯ ¿ÀºêÁ§Æ®¸¦ ¸Ê Ű·Î¼­ »ç¿ëÇÏ´Â °æ¿ì´Â ¼¼½ÉÀÇ ÁÖÀǰ¡ ÇÊ¿äÇÕ´Ï´Ù. ¿ÀºêÁ§Æ®°¡ ¸Ê³»ÀÇ Å°ÀÏ ¶§, equals ºñ±³¿¡ ¿µÇâÀ» ÁÖ´Â ¹æ¹ýÀ¸·Î ¿ÀºêÁ§Æ®ÀÇ °ªÀÌ º¯°æµÇ¾úÀ» °æ¿ì, ¸ÊÀÇ µ¿ÀÛÀº º¸ÁõµÇÁö ¾Ê½À´Ï´Ù. ÀÌ ±ÝÁö »çÇ×ÀÇ Æ¯¼öÇÑ ¿¹·Î¼­ ¸ÊÀÌ ±×°Í ÀÚ½ÅÀ» Ű·Î¼­ °¡ÁöÁö ¸øÇÏ´Â °ÍÀ» µé ¼ö ÀÖ½À´Ï´Ù. ¸ÊÀÌ ±×°Í ÀÚ½ÅÀ» °ªÀ¸·Î ÇØ¼­ °¡Áö´Â °ÍÀº Çã°¡µË´Ï´Ù¸¸, ±× °æ¿ì´Â ¼¼½ÉÀÇ ÁÖÀǰ¡ ÇÊ¿äÇÕ´Ï´Ù. ÀÌ·¯ÇÑ ¸ÊÀÇ °æ¿ì, equals ¸Þ¼­µå ¹× hashCode ¸Þ¼­µåÀÇ °á°ú´Â º¸ÁõµÇÁö ¾Ê½À´Ï´Ù.

¹ü¿ë ¸ÊÀÇ ±¸Çö Ŭ·¡½º´Â ¸ðµÎ, ´ÙÀ½ÀÇ 2 °³ÀÇ Ç¥ÁØÀûÀÎ »ý¼ºÀÚ¸¦ Á¦°øÇϵµ·Ï ÇØ ÁÖ¼¼¿ä. 2 °³ÀÇ Ç¥ÁØÀûÀÎ »ý¼ºÀÚ°¡¶õ void (Àμö ¾øÀ½) »ý¼ºÀÚ °úMap ÇüÀÇ Àμö¸¦ 1 °³ ÃëÇÏ´Â »ý¼ºÀÚ ÀÔ´Ï´Ù. ÀüÀÚ´Â ÇÏ´ÃÀÇ ¸ÊÀ» ÀÛ¼ºÇØ, ÈÄÀÚ´Â °°Àº Ű¿Í °ªÀÇ ¸ÅÇÎÀ» Àμö·Î¼­ °¡Áö´Â »õ·Î¿î ¸ÊÀ» ÀÛ¼ºÇÕ´Ï´Ù. ±× °á°ú, À¯Àú´Â ÈÄÀÚÀÇ »ý¼ºÀÚ¸¦ »ç¿ëÇØ ÀÓÀÇÀÇ ¸ÊÀ» Ä«ÇÇÇÏ´Â °ÍÀ¸·Î½á, ÇÊ¿äÇÑ Å¬·¡½º¿Í µî°¡ÀÎ ¸ÊÀ» ÀÛ¼ºÇÒ ¼ö ÀÖ½À´Ï´Ù. À̰ÍÀº °­Á¦ÀûÀÎ °ÍÀÌ ¾Æ´Õ´Ï´Ù¸¸ (ÀÎÅÍÆäÀ̽º°¡ »ý¼ºÀÚ¸¦ °¡Áú ¼ö°¡ ¾ø±â ¶§¹®¿¡), JDK ¿¡¼­ÀÇ ¹ü¿ë ¸ÊÀÇ ±¸ÇöÀº ¸ðµÎ À̰Ϳ¡ µû¸£°í ÀÖ½À´Ï´Ù.

ÀÌ ¸ÊÀÌ ¿ÀÆÛ·¹À̼ÇÀ» ¼­Æ÷Æ®Çϰí ÀÖÁö ¾Ê´Â °æ¿ì, ÀÌ ÀÎÅÍÆäÀ̽º (󸮵Ǵ ¸ÊÀ» ¼öÁ¤ÇÏ´Â ¸Þ¼­µå)¿¡ Æ÷ÇԵǾî ÀÖ´Â ¡¸ÆÄ±«ÀûÀΡ¹¸Þ¼­µå´Â UnsupportedOperationException¸¦ Throw Çϵµ·Ï ÁöÁ¤µÇ°í ÀÖ½À´Ï´Ù. ÀÌ ¶§, È£ÃâÀÌ ¸Ê¿¡ ¿µÇâÀ» ¹ÌÄ¡Áö ¾Ê´Â °æ¿ì, ÀÌ·¯ÇÑ ¸Þ¼­µå´Â UnsupportedOperationException¸¦ Throw ÇÏ´Â ÀÏÀÌ ÀÖ½À´Ï´Ù¸¸, Çʼö°¡ ¾Æ´Õ´Ï´Ù. ¿¹¸¦ µé¾î, ¸ÅÇÎÀ» ¡¸°ÅµìÇØ ¸ÂÃá´Ù¡¹¸ÊÀÌ ÇÏ´ÃÀÇ °æ¿ì¿¡ º¯°æ ºÒ°¡´ÉÇÑ ¸ÊÀ¸·Î putAll(Map) ¸Þ¼­µå¸¦ È£ÃâÇϸé, ¿¹¿Ü¸¦ Throw ÇÏ´Â ÀÏÀÌ ÀÖ½À´Ï´Ù¸¸, Çʼö°¡ ¾Æ´Õ´Ï´Ù.

¸ÊÀÇ ±¸Çö¿¡´Â Æ÷ÇÔÇÒ ¼ö Àִ Ű¿Í °ª¿¡ Á¦ÇÑÀÌ ÀÖ´Â °Íµµ ÀÖ½À´Ï´Ù. ¿¹¸¦ µé¾î, null Ű¿Í null Ä¡¸¦ ±ÝÁöÇÏ´Â ±¸ÇöÀ̳ª, null ŰÀÇ ÇüÅ¿¡ Á¦ÇÑÀÌ ÀÖ´Â ±¸Çöµµ ÀÖ½À´Ï´Ù. ºÎÀû´çÇÑ Å° ¶Ç´Â °ªÀ» »ðÀÔÇÏ·Á°í Çϸé, º¸Åë NullPointerException ¶Ç´Â ClassCastException ¿Í °°Àº üũµÇÁö ¾Ê´Â ¿¹¿Ü°¡ Throw µË´Ï´Ù. ºÎÀû´çÇÑ Å°³ª °ªÀÌ ÀÖÀ»Áö ¾î¶³Áö¸¦ Á¶È¸ÇÏ·Á°í Çϸé, ¿¹¿Ü¸¦ Throw ÇÏ´Â °æ¿ì³ª, ´Ù¸¸ false¸¦ µ¹·ÁÁÖ´Â °æ¿ìµµ ÀÖ½À´Ï´Ù. ÀüÀÇ µ¿ÀÛÀ» ±ÝÁöÇÏ´Â ±¸Çöµµ ÀÖÀ¸¸é, ÈÄÀÇ µ¿ÀÛÀ» ±ÝÁöÇÏ´Â ±¸Çöµµ ÀÖ½À´Ï´Ù. ¸¹Àº °æ¿ì´Â ¸Ê¿¡ ºÎÀû°ÝÀÎ ¿ä¼Ò¸¦ »ðÀÔÇÏÁö ¾Ê´Â ºÎÀû°ÝÀΠŰ ¶Ç´Â °ªÀ» ó¸®ÇÏ·Á°í Çϸé, ±¸ÇöÀÇ Àç·®À¸·Î ¿¹¿Ü°¡ Throw µÇ´Â °æ¿ì³ª, 󸮰¡ À¯È¿ÇÏ°Ô µÇ´Â °æ¿ì°¡ ÀÖ½À´Ï´Ù. ÀÌ·¯ÇÑ ¿¹¿Ü´Â ÀÌ ÀÎÅÍÆäÀ̽º¿¡ °üÇÑ ¡¸ÀÓÀÇ¡¹ÀÇ »ç¾çÀ¸·Î¼­ ¸¶Å© µË´Ï´Ù.

ÀÌ ÀÎÅÍÆäÀ̽º´Â Java Collections Framework ¸â¹öÀÔ´Ï´Ù.

Collections Framework ÀÎÅÍÆäÀ̽º³»ÀÇ ´Ù¼öÀÇ ¸Þ¼­µå´Â equals ¸Þ¼­µå¿ÍÀÇ °ü·ÃÀ¸·Î Á¤Àǵ˴ϴÙ. ¿¹¸¦ µé¾î,contains(Object key) ¸Þ¼­µåÀÇ »ç¾çÀº, ¡¸ÀÌ ¸Ê Ä÷º¼Ç¿¡ (key==null ? k==null : key.equals(k))¸¦ ä¿ì´Â Ű k °¡ Æ÷ÇԵǴ °æ¿ì¿¡°Ô¸¸,true¸¦ µ¹·ÁÁش١¹¶ó°í ÇÏ´Â °ÍÀÔ´Ï´Ù. ÀÌ »ç¾çÀº, ¡¸null ÀÌ¿ÜÀÇ Àμö key¸¦ »ç¿ëÇØ Map.containsKey¸¦ È£ÃâÇϸé, Ű k ·Î key.equals(k) °¡ ºÒ·Á °£´Ù¡¹¶ó°í ÀÌÇØÇØ¾ß ÇÏÁö´Â ¾Ê½À´Ï´Ù. ÃÖÀûÈ­ÀÇ ±¸Çö ¹æ¹ýÀº ÀÚÀ¯·Ó±â ¶§¹®¿¡ 2 °³ÀÇ Å°ÀÇ ÇØ½Ã Äڵ带 ÃÖÃÊ·Î ºñ±³ÇÏ´Â µî ¹æ¹ýÀ¸·Î equals È£ÃâÀº ÇÇÇÒ ¼ö ÀÖ´Â (Object.hashCode() »ç¾ç¿¡¼­´Â µî°¡°¡ ¾Æ´Ñ ÇØ½Ã Äڵ带 º¸°ü À¯ÁöÇÏ´Â 2 °³ÀÇ ¿ÀºêÁ§Æ®´Â µî°¡°¡ ¾Æ´Ñ °ÍÀÌ º¸ÁõµÈ´Ù). º¸Åë , ´Ù¾çÇÑ Collections Framework ÀÎÅÍÆäÀ̽ºÀÇ ±¸ÇöÀ¸·Î ±¸ÇöÀÚ°¡ ÀûÀýÀ̶ó°í ÆÇ´ÜÇÑ´Ù¸é, ±â¹ÝÀÌ µÇ´Â Object ¸Þ¼­µåÀÇ ÁöÁ¤µÈ µ¿ÀÛÀ» ÀÚÀ¯·Ó°Ô ÀÌ¿ëÇÒ ¼ö ÀÖ½À´Ï´Ù.

µµÀÔµÈ ¹öÁ¯:
1.2
°ü·Ã Ç׸ñ:
HashMap, TreeMap, Hashtable, SortedMap, Collection, Set

Áßø(Nested) Ŭ·¡½º °³¿ä
static interface Map.Entry <K, V >
          ¸ÊÀÇ ¿£Æ®¸® (Ű¿Í °ªÀÇ Æä¾î)ÀÔ´Ï´Ù.
 
¸Þ¼­µå °³¿ä
 void clear ()
          ¸ÊÀ¸·ÎºÎÅÍ ¸ÅÇÎÀ» ¸ðµÎ »èÁ¦ÇÕ´Ï´Ù (ÀÓÀÇÀÇ ¿ÀÆÛ·¹À̼Ç).
 boolean containsKey (Object  key)
          ÁöÁ¤µÈ ŰÀÇ ¸ÅÇÎÀÌ ¸Ê¿¡ Æ÷ÇԵǾî ÀÖ´Â °æ¿ì¿¡ true¸¦ µ¹·ÁÁÝ´Ï´Ù.
 boolean containsValue (Object  value)
          ¸ÊÀÌ, ÁöÁ¤µÈ °ª¿¡ 1 °³ ÀÌ»óÀÇ Å°¸¦ ¸ÅÇÎ Çϰí ÀÖ´Â °æ¿ì¿¡ true¸¦ µ¹·ÁÁÝ´Ï´Ù.
 Set <Map.Entry <K, V >> entrySet ()
          ¸Ê¿¡ Æ÷ÇԵǾî ÀÖ´Â ¸ÅÇÎÀÇ ¼ÂÆ®ºä¸¦ µ¹·ÁÁÝ´Ï´Ù.
 boolean equals (Object  o)
          ÁöÁ¤µÈ ¿ÀºêÁ§Æ®°¡ ÀÌ ¸Ê°ú µ¿ÀÏÇÑÁö ¾î¶²Áö¸¦ ºñ±³ÇÕ´Ï´Ù.
 V get (Object  key)
          ¸ÊÀÌ ÁöÁ¤µÈ ۸¦ ¸Ê ÇÏ´Â °ªÀ» µ¹·ÁÁÝ´Ï´Ù.
 int hashCode ()
          ¸ÊÀÇ ÇØ½Ã ÄÚµåÄ¡¸¦ µ¹·ÁÁÝ´Ï´Ù.
 boolean isEmpty ()
          ¸ÊÀÌ Å°¿Í °ªÀÇ ¸ÅÇÎÀ» º¸°ü À¯ÁöÇÏÁö ¾Ê´Â °æ¿ì¿¡ true¸¦ µ¹·ÁÁÝ´Ï´Ù.
 Set <K > keySet ()
          ¸Ê¿¡ Æ÷ÇԵǰí Àִ ŰÀÇ ¼ÂÆ®ºä¸¦ µ¹·ÁÁÝ´Ï´Ù.
 V put (K  key, V  value)
          ÁöÁ¤µÈ °ª°ú ÁöÁ¤µÈ ۸¦ ÀÌ ¸Ê¿¡ °ü·ÃÁþ½À´Ï´Ù (ÀÓÀÇÀÇ ¿ÀÆÛ·¹À̼Ç).
 void putAll (Map <? extends K, ? extends V > t)
          ÁöÁ¤µÈ ¸ÊÀÇ ¸ðµç ¸ÅÇÎÀ» ÀÌ ¸Ê¿¡ Ä«ÇÇÇÕ´Ï´Ù (ÀÓÀÇÀÇ ¿ÀÆÛ·¹À̼Ç).
 V remove (Object  key)
          ÀÌ Å°¿¡ ¸ÅÇÎÀÌ ÀÖ´Â °æ¿ì¿¡ ±× ¸ÅÇÎÀ» ¸ÊÀ¸·ÎºÎÅÍ »èÁ¦ÇÕ´Ï´Ù (ÀÓÀÇÀÇ ¿ÀÆÛ·¹À̼Ç).
 int size ()
          ¸Ê³»ÀÇ Å°¿Í °ªÀÇ ¸ÅÇÎÀÇ ¼ö¸¦ µ¹·ÁÁÝ´Ï´Ù.
 Collection <V > values ()
          ¸Ê¿¡ Æ÷ÇԵǰí ÀÖ´Â °ªÀÇ ÄÚ·¹Å©¼Çºä¸¦ µ¹·ÁÁÝ´Ï´Ù.
 

¸Þ¼­µåÀÇ »ó¼¼

size

int size()
¸Ê³»ÀÇ Å°¿Í °ªÀÇ ¸ÅÇÎÀÇ ¼ö¸¦ µ¹·ÁÁÝ´Ï´Ù. ¸Ê¿¡ Integer.MAX_VALUE º¸´Ù ¸¹Àº ¿ä¼Ò°¡ ÀÖ´Â °æ¿ì´Â Integer.MAX_VALUE¸¦ µ¹·ÁÁÝ´Ï´Ù.

¹Ýȯ°ª:
¸Ê³»ÀÇ Å°¿Í °ªÀÇ ¸ÅÇÎÀÇ ¼ö

isEmpty

boolean isEmpty()
¸ÊÀÌ Å°¿Í °ªÀÇ ¸ÅÇÎÀ» º¸°ü À¯ÁöÇÏÁö ¾Ê´Â °æ¿ì¿¡ true¸¦ µ¹·ÁÁÝ´Ï´Ù.

¹Ýȯ°ª:
¸ÊÀÌ Å°¿Í °ªÀÇ ¸ÅÇÎÀ» º¸°ü À¯ÁöÇÏÁö ¾Ê´Â °æ¿ì´Â true

containsKey

boolean containsKey(Object  key)
ÁöÁ¤µÈ ŰÀÇ ¸ÅÇÎÀÌ ¸Ê¿¡ Æ÷ÇԵǾî ÀÖ´Â °æ¿ì¿¡ true¸¦ µ¹·ÁÁÝ´Ï´Ù. Áï, ¸Ê¿¡ (key==null ? k==null : key.equals(k)) °¡ µÇ´Â Ű k ¸ÅÇÎÀÌ Æ÷ÇԵǾî ÀÖ´Â °æ¿ì¿¡¸¸ true¸¦ µ¹·ÁÁÝ´Ï´Ù. ¸ÊÀº ÀÌ·¯ÇÑ ¸ÅÇÎÀ» 1 °³¸¸ Æ÷ÇÔÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
key - ¸Ê¿¡ ÀÖÀ»Áö ¾î¶³Áö°¡ ÆÇÁ¤µÇ´Â Ű
¹Ýȯ°ª:
¸ÊÀÌ ÁöÁ¤µÈ ŰÀÇ ¸ÅÇÎÀ» º¸°ü À¯ÁöÇÏ´Â °æ¿ì´Â true
¿¹¿Ü:
ClassCastException - ۰¡ ¸Ê¿¡ ÀûÇÕÇÏÁö ¾Ê´Â ÇüÅÂÀÇ °æ¿ì (ÀÓÀÇÀÇ ¿É¼Ç)
NullPointerException - ۰¡ null ¶§¿¡ ¸ÊÀÌ null ۸¦ Çã°¡ÇÏÁö ¾Ê´Â °æ¿ì (ÀÓÀÇÀÇ ¿É¼Ç)

containsValue

boolean containsValue(Object  value)
¸ÊÀÌ, ÁöÁ¤µÈ °ª¿¡ 1 °³ ÀÌ»óÀÇ Å°¸¦ ¸ÅÇÎ Çϰí ÀÖ´Â °æ¿ì¿¡ true¸¦ µ¹·ÁÁÝ´Ï´Ù. Áï, ¸Ê¿¡ (value==null ? v==null : value.equals(v)) °¡ µÇ´Â °ª v ¿¡ÀÇ ¸ÅÇÎÀÌ 1 °³ ÀÌ»ó ÀÖ´Â °æ¿ì¿¡¸¸ true¸¦ µ¹·ÁÁÝ´Ï´Ù. Map ÀÎÅÍÆäÀ̽ºÀÇ ´ëºÎºÐÀÇ ±¸ÇöÀ¸·Î ÀÌ ¿ÀÆÛ·¹À̼ǿ¡ °É¸®´Â ½Ã°£Àº ¸ÊÀÇ »çÀÌÁî¿¡ Á¤ºñ·Ê ÇÕ´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
value - ¸Ê¿¡ ÀÖÀ»Áö ¾î¶³Áö¸¦ ÆÇÁ¤µÇ´Â °ª
¹Ýȯ°ª:
¸ÊÀÌ 1 °³ ¶Ç´Â º¹¼öÀÇ Å°¿Í ÁöÁ¤µÈ °ªÀ» ¸ÅÇÎ Çϰí ÀÖ´Â °æ¿ì´Â true
¿¹¿Ü:
ClassCastException - Ä¡°¡ ¸Ê¿¡ ÀûÇÕÇÏÁö ¾Ê´Â ÇüÅÂÀÇ °æ¿ì (ÀÓÀÇÀÇ ¿É¼Ç)
NullPointerException - Ä¡°¡ null ¶§¿¡ ¸ÊÀÌ null Ä¡¸¦ Çã°¡ÇÏÁö ¾Ê´Â °æ¿ì (ÀÓÀÇÀÇ ¿É¼Ç)

get

V  get(Object  key)
¸ÊÀÌ ÁöÁ¤µÈ ۸¦ ¸Ê ÇÏ´Â °ªÀ» µ¹·ÁÁÝ´Ï´Ù. ¸ÊÀÌ ÀÌ Å°ÀÇ ¸ÅÇÎÀ» º¸°ü À¯ÁöÇϰí ÀÖÁö ¾Ê´Â °æ¿ì´Â null¸¦ µ¹·ÁÁÝ´Ï´Ù. ¹Ýȯ°ªÀÇ null´Â ¸ÊÀÌ Å°ÀÇ ¸ÅÇÎÀ» º¸°ü À¯ÁöÇϰí ÀÖÁö ¾Ê´Â °ÍÀ» ³ªÅ¸³½´Ù°í´Â ÇÒ ¼ö ¾ø½À´Ï´Ù. Áï, ¸ÊÀÌ ¸í½ÃÀûÀ¸·Î ۸¦ null ¿¡ ¸Ê ÇÏ´Â Àϵµ ÀÖ½À´Ï´Ù. containsKey ¿ÀÆÛ·¹À̼ÇÀ» »ç¿ëÇϸé, ÀÌ·¯ÇÑ 2 °³ÀÇ °æ¿ì¸¦ ºÐº°ÇÒ ¼ö°¡ ÀÖ½À´Ï´Ù.

Áï, ¸Ê¿¡ (key==null ? k==null : key.equals(k)) ¶ó°í ÇÏ´Â Á¶°ÇÀ¸·Î Ű k ·ÎºÎÅÍ °ª v ±îÁö ¸ÅÇÎÀÌ Æ÷ÇԵǴ °æ¿ì, ÀÌ ¸Þ¼­µå´Â v¸¦ µ¹·ÁÁÝ´Ï´Ù. Æ÷ÇÔµÇÁö ¾Ê´Â °æ¿ì´Â null¸¦ µ¹·ÁÁÝ´Ï´Ù. ÀÌ·¯ÇÑ ¸ÅÇÎÀÌ 1 °³¸¸ ÀÖ½À´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
key - °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø °ªÀÌ µ¹·ÁÁÖ°íÁö´Â Ű
¹Ýȯ°ª:
¸ÊÀÌ, ÁöÁ¤µÈ Ű¿¡ ¸ÅÇÎ Çϰí ÀÖ´Â °ª. ÀÌ Å°¿¡ ´ëÇÑ ¸ÅÇÎÀÌ ¸Ê¿¡ ¾ø´Â °æ¿ì´Â null
¿¹¿Ü:
ClassCastException - ۰¡ ¸Ê¿¡ ÀûÇÕÇÏÁö ¾Ê´Â ÇüÅÂÀÇ °æ¿ì (ÀÓÀÇÀÇ ¿É¼Ç)
NullPointerException - ۰¡ null ¶§¿¡ ¸ÊÀÌ null ۸¦ Çã°¡ÇÏÁö ¾Ê´Â °æ¿ì (ÀÓÀÇÀÇ ¿É¼Ç)
°ü·Ã Ç׸ñ:
containsKey(Object)

put

V  put(K  key,
      V  value)
ÁöÁ¤µÈ °ª°ú ÁöÁ¤µÈ ۸¦ ÀÌ ¸Ê¿¡ °ü·ÃÁþ½À´Ï´Ù (ÀÓÀÇÀÇ ¿ÀÆÛ·¹À̼Ç). ¸Ê¿¡ ¹ú½á ÀÌ Å°¿¡ ´ëÇÑ ¸ÅÇÎÀÌ ÀÖ´Â °æ¿ì, ³°Àº °ªÀº ÁöÁ¤µÈ °ªÀ¸·Î ¿Å°ÜÁý´Ï´Ù. m.containsKey(k) °¡ true¸¦ µ¹·ÁÁÖ´Â °æ¿ì¿¡ ÇÑÁ¤ÇØ, ¸Ê m´Â Ű k ¸ÅÇÎÀ» Æ÷ÇÔÇÑ´Ù°í ¸»ÇÒ ¼ö ÀÖ½À´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
key - ÁöÁ¤µÇ´Â °ªÀ» °ü·ÃÁöÀ» ¼ö Àִ Ű
value - ÁöÁ¤µÇ´Â Ű¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ´Â °ª
¹Ýȯ°ª:
ÁöÁ¤µÈ Ű¿¡ °ü·ÃÇÑ ÀÌÀüÀÇ °ª. key ¿¡ ¸ÅÇÎÀÌ ¾ø¾ú´ø °æ¿ì´Â null. ¶Ç,null ¹Ýȯ°ªÀº, ±¸ÇöÀÌ null Ä¡¸¦ ¼­Æ÷Æ®Çϰí ÀÖ´Â °æ¿ì´Â ÁöÁ¤µÈ Ű¿¡ ÀÌÀü ¸ÊÀÌ null¸¦ °ü·ÃÁþ°í ÀÖ´ø °ÍÀ» ³ªÅ¸³»´Â °æ¿ìµµ ÀÖ´Ù
¿¹¿Ü:
UnsupportedOperationException - put ¿ÀÆÛ·¹À̼ÇÀÌ ¸Ê¿¡ ÇØ ¼­Æ÷Æ®µÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
ClassCastException - ÁöÁ¤µÈ Ű ¶Ç´Â °ªÀÇ Å¬·¡½º°¡ ¿øÀÎÀ¸·Î ¸Ê¿¡ Æ÷ÇÔÇÒ ¼ö ¾ø´Â °æ¿ì
IllegalArgumentException - ÀÌ Å° ¶Ç´Â °ªÀÇ Æ¯¼ºÀÌ ¿øÀÎÀ¸·Î ¸Ê¿¡ Æ÷ÇÔÇÒ ¼ö ¾ø´Â °æ¿ì
NullPointerException - ¸ÊÀÌ null Ű³ª null Ä¡¸¦ Çã°¡ÇÏÁö ¾ÊÀ» ¶§¿¡ ÁöÁ¤µÈ Ű ¶Ç´Â °ªÀÌ null °æ¿ì

remove

V  remove(Object  key)
ÀÌ Å°¿¡ ¸ÅÇÎÀÌ ÀÖ´Â °æ¿ì¿¡ ±× ¸ÅÇÎÀ» ¸ÊÀ¸·ÎºÎÅÍ »èÁ¦ÇÕ´Ï´Ù (ÀÓÀÇÀÇ ¿ÀÆÛ·¹À̼Ç). Áï,(key==null ? k==null : key.equals(k)) ¶ó°í ÇÏ´Â Á¶°ÇÀ¸·Î Ű k ·ÎºÎÅÍ °ª v ±îÁö ¸ÅÇÎÀÌ ¸Ê¿¡ Æ÷ÇԵǴ °æ¿ì, ÀÌ ¸ÅÇÎÀº »èÁ¦µË´Ï´Ù. ¸ÊÀº ÀÌ·¯ÇÑ ¸ÅÇÎÀ» 1 °³¸¸ Æ÷ÇÔÇÕ´Ï´Ù.

۸¦ ÀÌÀü °ü·ÃÁþ°í ÀÖ´ø ¸ÊÀÇ °ªÀ» µ¹·ÁÁÝ´Ï´Ù. ÀÌ Å°ÀÇ ¸ÅÇÎÀÌ ¸Ê¿¡ ¾ø´Â °æ¿ì´Â null¸¦ µ¹·ÁÁÝ´Ï´Ù (null ¹Ýȯ°ªÀº, ±¸ÇöÀÌ null Ä¡¸¦ ¼­Æ÷Æ®Çϰí ÀÖ´Â °æ¿ì, ¸ÊÀÌ ÁöÁ¤µÈ Ű¿Í null¸¦ ÀÌÀü °ü·ÃÁþ°í ÀÖ´ø °ÍÀ» ³ªÅ¸³»´Â °æ¿ìµµ ÀÖ´Ù). 1 ¹ø È£ÃâÀÌ µ¹¾Æ°¡¸é, ¸ÊÀº ÁöÁ¤µÈ ŰÀÇ ¸ÅÇÎÀ» Æ÷ÇÔÇÏÁö ¾Ê½À´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
key - ¸ÅÇÎÀÌ ¸ÊÀ¸·ÎºÎÅÍ »èÁ¦µÇ´Â Ű
¹Ýȯ°ª:
ÁöÁ¤µÈ Ű¿Í °ü·ÃÁöÀ» ¼ö ÀÖ°í ÀÖ´ø ÀÌÀüÀÇ °ª. ŰÀÇ ¸ÅÇÎÀÌ ¾ø¾ú´ø °æ¿ì´Â null
¿¹¿Ü:
ClassCastException - ۰¡ ¸Ê¿¡ ÀûÇÕÇÏÁö ¾Ê´Â ÇüÅÂÀÇ °æ¿ì (ÀÓÀÇÀÇ ¿É¼Ç)
NullPointerException - ۰¡ null ¶§¿¡ ¸ÊÀÌ null ۸¦ Çã°¡ÇÏÁö ¾Ê´Â °æ¿ì (ÀÓÀÇÀÇ ¿É¼Ç)
UnsupportedOperationException - ¸ÊÀÌ remove ¸Þ¼­µå¸¦ ¼­Æ÷Æ®Çϰí ÀÖÁö ¾Ê´Â °æ¿ì

putAll

void putAll(Map <?  extends K,
?  extends V > t)
ÁöÁ¤µÈ ¸ÊÀÇ ¸ðµç ¸ÅÇÎÀ» ÀÌ ¸Ê¿¡ Ä«ÇÇÇÕ´Ï´Ù (ÀÓÀÇÀÇ ¿ÀÆÛ·¹À̼Ç). ÁöÁ¤µÈ ¸ÊÀÇ Å° k ·ÎºÎÅÍ °ª v ±îÁöÀÇ °¢ ¸ÅÇο¡ °üÇØ¼­, ÀÌ È£ÃâÀÇ È¿°ú´Â ¸ÊÀ¸·Î put(k, v) ¸¦ È£ÃâÇßÀ» °æ¿ì¿Í °°½À´Ï´Ù. ÁöÁ¤µÈ ¸ÊÀÌ ÀÌ ¿ÀÆÛ·¹À̼ÇÀÇ Ã³¸®ÁßÀ¸·Î º¯°æµÇ¾úÀ» °æ¿ì, ±× ¿ÀÆÛ·¹À̼ÇÀÇ µ¿ÀÛÀº ÁöÁ¤¿Ü°¡ µË´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
t - ¸Ê¿¡ Æ÷ÇԵǴ ¸ÅÇÎ
¿¹¿Ü:
UnsupportedOperationException - ¸ÊÀÌ putAll ¸Þ¼­µå¸¦ ¼­Æ÷Æ®Çϰí ÀÖÁö ¾Ê´Â °æ¿ì
ClassCastException - ÁöÁ¤µÈ ¸Ê³»ÀÇ Å° ¶Ç´Â °ªÀÇ Å¬·¡½º°¡ ¿øÀÎÀ¸·Î ¸Ê¿¡ Æ÷ÇÔÇÒ ¼ö ¾ø´Â °æ¿ì
IllegalArgumentException - ÁöÁ¤µÈ ¸Ê³»ÀÇ Å° ¶Ç´Â °ªÀÇ Æ¯¼ºÀÌ ¿øÀÎÀ¸·Î ¸Ê¿¡ Æ÷ÇÔÇÒ ¼ö ¾ø´Â °æ¿ì
NullPointerException - ÁöÁ¤µÈ ¸ÊÀÌ null ÀÎÁö, ÀÌ ¸ÊÀÌ null Ű³ª null Ä¡¸¦ Çã°¡ÇÏÁö ¾Ê´Â »óÅ·ΠÁöÁ¤µÈ ¸Ê¿¡ null Ű³ª null Ä¡°¡ Æ÷ÇԵǴ °æ¿ì

clear

void clear()
¸ÊÀ¸·ÎºÎÅÍ ¸ÅÇÎÀ» ¸ðµÎ »èÁ¦ÇÕ´Ï´Ù (ÀÓÀÇÀÇ ¿ÀÆÛ·¹À̼Ç).

¿¹¿Ü:
UnsupportedOperationException - clear °¡ ¸Ê¿¡ ÇØ ¼­Æ÷Æ®µÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì

keySet

Set <K > keySet()
¸Ê¿¡ Æ÷ÇԵǰí Àִ ŰÀÇ ¼ÂÆ®ºä¸¦ µ¹·ÁÁÝ´Ï´Ù. ¼¼Æ®´Â ¸Ê°ú ¿¬µ¿Çϰí ÀÖÀ¸¹Ç·Î ¸Ê¿¡ ´ëÇÑ º¯°æÀº ¼¼Æ®¿¡ ¹Ý¿µµÇ¾î ¶Ç ¼¼Æ®¿¡ ´ëÇÑ º¯°æÀº ¸Ê¿¡ ¹Ý¿µµË´Ï´Ù. ¼¼Æ®ÀÇ ¹Ýº¹ ó¸®ÁßÀ¸·Î ¸ÊÀÌ º¯°æµÇ¾úÀ» °æ¿ì, ¹Ýº¹ÀÇ °á°ú´Â º¸ÁõµÇÁö ¾Ê½À´Ï´Ù (¹Ýº¹ÀÚ ÀÚ½ÅÀÇ remove ¿ÀÆÛ·¹À̼ÇÀ» Á¦¿ÜÇÏ´Ù). ¼¼Æ®´Â ¿ä¼ÒÀÇ »èÁ¦¸¦ ¼­Æ÷Æ®Çϰí ÀÖ¾î, ´ëÀÀÇÏ´Â ¸ÅÇÎÀ» ¸ÊÀ¸·ÎºÎÅÍ »èÁ¦ÇÒ ¼ö ÀÖ½À´Ï´Ù. »èÁ¦´Â Iterator.remove,Set.remove,removeAll,retainAll ¹× retainAll ¿ÀÆÛ·¹À̼ÇÀ» ÅëÇØ ½Ç½ÃÇÕ´Ï´Ù. add ¹× addAll ¿ÀÆÛ·¹À̼ÇÀº ¼­Æ÷Æ®µÇ°í ÀÖÁö ¾Ê½À´Ï´Ù.

¹Ýȯ°ª:
¸Ê¿¡ Æ÷ÇԵǾî Àִ ŰÀÇ ¼ÂÆ®ºä

values

Collection <V > values()
¸Ê¿¡ Æ÷ÇԵǰí ÀÖ´Â °ªÀÇ ÄÚ·¹Å©¼Çºä¸¦ µ¹·ÁÁÝ´Ï´Ù. Ä÷º¼ÇÀº ¸Ê°ú ¿¬µ¿Çϰí ÀÖÀ¸¹Ç·Î ¸Ê¿¡ ´ëÇÑ º¯°æÀº Ä÷º¼Ç¿¡ ¹Ý¿µµÇ¾î ¶Ç Ä÷º¼Ç¿¡ ´ëÇÑ º¯°æÀº ¸Ê¿¡ ¹Ý¿µµË´Ï´Ù. Ä÷º¼ÇÀÇ ¹Ýº¹ ó¸®ÁßÀ¸·Î ¸ÊÀÌ º¯°æµÇ¾úÀ» °æ¿ì, ¹Ýº¹ÀÇ °á°ú´Â º¸ÁõµÇÁö ¾Ê½À´Ï´Ù (¹Ýº¹ÀÚ ÀÚ½ÅÀÇ remove ¿ÀÆÛ·¹À̼ÇÀ» Á¦¿ÜÇÏ´Ù). Ä÷º¼ÇÀº ¿ä¼ÒÀÇ »èÁ¦¸¦ ¼­Æ÷Æ®Çϰí ÀÖ¾î, ´ëÀÀÇÏ´Â ¸ÅÇÎÀ» ¸ÊÀ¸·ÎºÎÅÍ »èÁ¦ÇÒ ¼ö ÀÖ½À´Ï´Ù. »èÁ¦´Â Iterator.remove,Collection.remove,removeAll,retainAll ¹× clear ¿ÀÆÛ·¹À̼ÇÀ» ÅëÇØ ½Ç½ÃÇÕ´Ï´Ù. add ¹× addAll ¿ÀÆÛ·¹À̼ÇÀº ¼­Æ÷Æ®µÇ°í ÀÖÁö ¾Ê½À´Ï´Ù.

¹Ýȯ°ª:
¸Ê³»¿¡ Æ÷ÇԵǾî ÀÖ´Â °ªÀÇ ÄÚ·¹Å©¼Çºä

entrySet

Set <Map.Entry <K,
V >> entrySet()
¸Ê¿¡ Æ÷ÇԵǾî ÀÖ´Â ¸ÅÇÎÀÇ ¼ÂÆ®ºä¸¦ µ¹·ÁÁÝ´Ï´Ù. µ¹·ÁÁÖ°íÁö´Â ¼¼Æ®³»ÀÇ °¢ ¿ä¼Ò´Â Map.Entry ÀÔ´Ï´Ù. ¼¼Æ®´Â ¸Ê°ú ¿¬µ¿Çϰí ÀÖÀ¸¹Ç·Î ¸Ê¿¡ ´ëÇÑ º¯°æÀº ¼¼Æ®¿¡ ¹Ý¿µµÇ¾î ¶Ç, ¼¼Æ®¿¡ ´ëÇÑ º¯°æÀº ¸Ê¿¡ ¹Ý¿µµË´Ï´Ù. ¼¼Æ®¿¡ ´ëÇÑ ¹Ýº¹ÀÇ Ã³¸®ÁßÀ¸·Î ¸ÊÀÌ º¯°æµÇ¾úÀ» °æ¿ì´Â ¹Ýº¹ÀÇ °á°ú´Â º¸ÁõµÇÁö ¾Ê½À´Ï´Ù (¹Ýº¹ÀÚ ÀÚ½ÅÀÇ remove ¿ÀÆÛ·¹À̼Ç, ¶Ç´Â ¹Ýº¹ÀÚ¿¡ ÇØ µ¹·ÁÁÖ°íÁö´Â ¸Ê ¿£Æ®¸®¿¡ ´ëÇÑ setValue ¿ÀÆÛ·¹À̼ÇÀ» Á¦¿ÜÇÏ´Ù). ¼¼Æ®´Â ¿ä¼ÒÀÇ »èÁ¦¸¦ ¼­Æ÷Æ®Çϰí ÀÖ¾î, ´ëÀÀÇÏ´Â ¸ÅÇÎÀ» ¸ÊÀ¸·ÎºÎÅÍ »èÁ¦ÇÒ ¼ö ÀÖ½À´Ï´Ù. »èÁ¦´Â Iterator.remove,Set.remove,removeAll,retainAll ¹× clear °¢ ¿ÀÆÛ·¹À̼ÇÀ» ÅëÇØ ½Ç½ÃÇÕ´Ï´Ù. add ¹× addAll ¿ÀÆÛ·¹À̼ÇÀº ¼­Æ÷Æ®µÇ°í ÀÖÁö ¾Ê½À´Ï´Ù.

¹Ýȯ°ª:
¸Ê³»¿¡ º¸°ü À¯ÁöµÇ°í ÀÖ´Â ¸ÅÇÎÀÇ ¼ÂÆ®ºä

equals

boolean equals(Object  o)
ÁöÁ¤µÈ ¿ÀºêÁ§Æ®°¡ ÀÌ ¸Ê°ú µ¿ÀÏÇÑÁö ¾î¶²Áö¸¦ ºñ±³ÇÕ´Ï´Ù. ÁöÁ¤µÈ ¿ÀºêÁ§Æ®µµ ¸ÊÀ̸ç, 2 °³ÀÇ Map °¡ °°Àº ¸ÅÇÎÀ» ³ªÅ¸³»°í ÀÖ´Â °æ¿ì´Â true¸¦ µ¹·ÁÁÝ´Ï´Ù. Áï,t1.entrySet(). equals(t2.entrySet()) ÀÎ °æ¿ì, 2 °³ÀÇ ¸Ê t1 ¿Í t2´Â °°Àº ¸ÅÇÎÀ» ³ªÅ¸³À´Ï´Ù. À̰Ϳ¡ ÇØ,Map ÀÎÅÍÆäÀ̽ºÀÇ ±¸ÇöÀÌ ´Ù¸¥ °æ¿ì¿¡¼­µµ,equals ¸Þ¼­µå°¡ ¿Ã¹Ù¸£°Ô µ¿ÀÛÇÏ´Â °ÍÀÌ º¸ÁõµË´Ï´Ù.

¿À¹ö¶óÀ̵å(override):
Ŭ·¡½º Object ³»ÀÇ equals
ÆÄ¶ó¹ÌÅÍ:
o - ¸Ê°ú µ¿ÀÏÇÑÁö ¾î¶²Áö¸¦ ºñ±³ÇÏ´Â ¿ÀºêÁ§Æ®
¹Ýȯ°ª:
ÁöÁ¤µÈ ¿ÀºêÁ§Æ®°¡ ¸Ê°ú µ¿ÀÏÇÑ °æ¿ì´Â true
°ü·Ã Ç׸ñ:
Object.hashCode(), Hashtable

hashCode

int hashCode()
¸ÊÀÇ ÇØ½Ã ÄÚµåÄ¡¸¦ µ¹·ÁÁÝ´Ï´Ù. ¸ÊÀÇ ÇØ½Ã ÄÚµå´Â ¸ÊÀÇ entrySet ºä³»ÀÇ °¢ ¿£Æ®¸®ÀÇ hashCode ÇÕ°è°¡ µÇµµ·Ï Á¤Àǵ˴ϴÙ. À̰Ϳ¡ ÇØ, Object.hashCode ÀÏ¹Ý ±Ô¾à¿¡ ÇØ ¿ä±¸µÇµµ·Ï, ÀÓÀÇÀÇ 2 °³ÀÇ ¸Ê t1 ¿Í t2 ·Î t1.equals(t2) À̸é,t1.hashCode() ==t2.hashCode() °¡ µÇ´Â °ÍÀÌ º¸ÁõµË´Ï´Ù.

¿À¹ö¶óÀ̵å(override):
Ŭ·¡½º Object ³»ÀÇ hashCode
¹Ýȯ°ª:
¸ÊÀÇ ÇØ½Ã ÄÚµåÄ¡
°ü·Ã Ç׸ñ:
Map.Entry.hashCode(), Object.hashCode(), Object.equals(Object), equals(Object)

JavaTM 2 Platform
Standard Ed. 5.0

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy µµ ÂüÁ¶ÇϽʽÿÀ.