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 ÇÏ´Â °æ¿ì³ª, ´Ù¸¸ false¸¦ µ¹·ÁÁÖ´Â °æ¿ìµµ ÀÖ½À´Ï´Ù. ÀüÀÇ µ¿ÀÛÀ» ±ÝÁöÇÏ´Â ±¸Çöµµ ÀÖÀ¸¸é, ÈÄÀÇ µ¿ÀÛÀ» ±ÝÁöÇÏ´Â ±¸Çöµµ ÀÖ½À´Ï´Ù. ¸¹Àº °æ¿ì´Â ¸Ê¿¡ ºÎÀû°ÝÀÎ ¿ä¼Ò¸¦ »ðÀÔÇÏÁö ¾Ê´Â ºÎÀû°ÝÀÎ Å° ¶Ç´Â °ªÀ» ó¸®ÇÏ·Á°í Çϸé, ±¸ÇöÀÇ Àç·®À¸·Î ¿¹¿Ü°¡ ¹ß»ýµÇ´Â °æ¿ì³ª, 󸮰¡ À¯È¿ÇÏ°Ô µÇ´Â °æ¿ì°¡ ÀÖ½À´Ï´Ù. ÀÌ·¯ÇÑ ¿¹¿Ü´Â ÀÌ ÀÎÅÍÆäÀ̽º¿¡ °üÇÑ ¡¸ÀÓÀÇ¡¹ÀÇ »ç¾çÀ¸·Î¼­ ¸¶Å© µË´Ï´Ù.

ÀÌ ÀÎÅÍÆäÀ̽º´Â 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 µµ ÂüÁ¶ÇϽʽÿÀ.