Javaالإنترفيس Map في جافا
- مقدمة
- دوال الإنترفيس Map
- مثال شامل
مقدمة
الإنترفيس Map يتيح لك تخزين العناصر بشكل Key / Value.
هنا كل عنصر يتم تخزينه يملك كائنين: الأول عبارة عن مفتاح ( key ) و الثاني عبارة قيمة ( value ).
للوصول إلى أي عنصر, سواء لحذفه أو إعطائه قيمة جديدة نستخدم المفتاح له.
نظرة عامة
- بشكل عام, يستخدم لتخزين العناصر بشكل Key / Value.
- يمكن للمفاتيح المختلفة أن تحتوي على نفس القيمة.
- بعض الدوال التي يملكها ترمي الإستثناء UnsupportedOperationException إذا تم استخدامهم بطريقة خاطئة.
- يرمى الإستثناء ClassCastException في حال كان لا يمكن تحويل نوع الكائن إلى نوع آخر.
- يرمى الإستثناء NullPointerException في حال تم إضافة القيمة null فيه لأنه لا يقبل القيمة null.
- يرمى الإستثناء NoSuchElementException في حال كان كائن الـ Map فارغاً و كنت تحاول إرجاع قيمة عنصر من عناصره.
دوال الإنترفيس Map
الجدول التالي يحتوي على دوال الإنترفيس Map.
الدالة مع تعريفها | |
---|---|
1 | public void clear() تمسح جميع العناصر الموجودة في الكائن الذي قام باستدعائها. |
2 | public boolean containsKey(Object key) ترجع true إذا كان الكائن الذي قام باستدعائها يحتوي على الكائن key الذي نضعه لها كـ Argument كمفتاح فيه. |
3 | public boolean containsValue(Object value) ترجع true إذا كان الكائن الذي قام باستدعائها يحتوي على الكائن value الذي نضعه لها كـ Argument كقيمة فيه. |
4 | public boolean equals(Object obj) ترجع true في حال كان الكائن الذي قام باستدعائها يتطابق مع الكائن الذي نمرره لها كـ Argument. |
5 | public Object get(Object key)
ترجع قيمة المفتاح الذي نمرره لها كـ Argument. في حال كان كائن الكائن الذي قام باستدعائها لا يحتوي على المفتاح الذي مررناه لها, ترجع القيمة null. |
6 | public int hashCode() ترجع الـ Hash Code للكائن الذي قام باستدعائها. |
7 | public boolean isEmpty() ترجع true في حال كان الكائن الذي قام باستدعائها فارغاً. |
8 | public Set keySet() ترجع كائن نوعه Set يحتوي على جميع مفاتيح الكائن الذي قام باستدعائها. |
9 | public Object put(Object key, Object value)
تستخدم لإضافة عنصر جديد في الكائن الذي قام باستدعائها مع تحديد مفتاح الوصول إليه و قيمته.
|
10 | public void putAll(Map m) تضيف جميع عناصر الكائن m الذي نمرره لها كـ Argument في الكائن الذي قام باستدعائها. |
11 | public Object remove(Object key) تحذف العنصر الذي يملك المفتاح الذي نمرره لها كـ Argument. |
12 | public int size() ترجع عدد العناصر الموجودة في الكائن الذي قام باستدعائها. |
13 | public Collection values() ترجع كائن نوعه Collection يحتوي على جميع قيم الكائن الذي قام باستدعائها. |
مثال شامل
في المثال التالي قمنا بإنشاء ثلاث كائنات من ثلاث كلاسات مختلفة ترث من الإنترفيس Map.
لاحظ أننا استخدمنا الدالة put() التي ورثتها الكائنات في الأساس من الإنترفيس Map.
سنحصل على النتيجة التالية عند التشغيل.