Mapa - interfejs Map oraz klasa HashMap - wyszukiwanie przy użyciu klucza

package java.util.Map;

public interface Map<K,V>
// !!! interfejs Map nie dziedziczy od interfejsu Collection

// gdzie:
// K to typ kluczy (Keys) używanych w danej mapie 
// V to typ mapowanych wartości (Vaules) 

• HashMap - podstawowa implementacja interfejsu Map - mapa nie posortowana, przypadkowa i zmienna w czasie kolejność w wyniku iteracji po parach klucz-wartość - pozwala szybko wyszukiwać elementy na podstawie klucza;
• LinkedHashMap - wiązana implementacja interfejsu Map - kolejność występowania klucz jest stała i zgodna z kolejnością dodawania par klucz-wartość - bardzo szybko pozwala przechodzić do kolejnych lub poprzednich elementów.
• TreeMap - posortowana implementacja interfejsu Map - elementy (pary klucz-wartość) są automatycznie posortowane - nowa para jest automatycznie dodawana w odpowiednim miejscu, aby zapewnić uporządkowanie kluczy według porządku naturalnego klucza, o ile typ klucza implementuje interfejs Comparable (w klasie klucza muszą być prawidłowo zaimplementowane metody equals() oraz hashCode()).

Map mapa1 = new HashMap();
Map<String, Integer> mapaParStringInteger = new TreeMap<String, Integer>(); 

• put( K key, V value ); // dodaj element mapy, czyli parę klucz-wartość, gdzie K to dowolny typ/klasa obiektu klucza key, a V to dowolny typ/klasa obiektu value;
• get( Object key ); // pobierz element mapowany przy użyciu danego klucza, zwracana jest wartość (obiekt) typu/klasy V;
• containsKey( Object key ); // zwraca true, jeśli w mapie występuje określony klucz (obiekt klucza);
• containsValue( Object value ); // zwraca true, jeśli w mapie występuje jeden lub więcej kluczy mapujących na określoną wartość (obiekt);
• keySet(); // zwraca zbiór kluczy w formie obiektu klasy Set<K>, gdzie K to klasa obiektów kluczy;
• entrySet(); // zwraca zestaw odwzorowań klucz-wartość w formie zbioru typu Set - obiektu klasy Set - z elementami typu Map.Entry<K,V>;
• remove( Object key ); // usuwa element mapy - czyli parę klucz-wartość - związany z danym kluczem (obiektem klucza);
• size(); // zwraca liczbę elementów mapy - czyli par klucz-wartość;
• clear(); // usuwa wszystkie elementy z mapy - wszystkie pary klucz-wartość;

• po kluczach
• po wartościach
• po wpisach (parach klucz-wartość)

Map<String, String> sampleMap = new HashMap<>();
sampleMap.put( "Klucz1", "Wartość1" );
sampleMap.put( "Klucz2", "Wartość2" );
sampleMap.put( "Klucz3", "Wartość3" );
 
System.out.println( "Iterowanie po kluczach i pobieranie wartosci" );
for( String key : sampleMap.keySet() ) {
    String value = sampleMap.get(key);
    System.out.println( key + ": " + value );
}
 
System.out.println( "Iterowanie po wartosciach" );
for( String value : sampleMap.values() ) {
    System.out.println( value );
}
 
System.out.println("Iterowanie po wpisach - parach klucz-wartość");
for( Map.Entry<String, String> entry : sampleMap.entrySet() ) {
    String key = entry.getKey();
    String value = entry.getValue();
    System.out.println( key + " : " + value );
}

/*
1. Utwórz HashMapę z kluczami typu String i wartościami typu Integer, nazwij ją mapaKontaktow.
2. Wstaw do powyższej mapy 10 kontaktów (klucz - nazwa, wartość - nr telefonu jak integer) 
3. Wypisz wszystkie kontakty, których numery telefonów zaczynają się na cyfrę 7.
4. Wypisz wszystkie kontakty, których nazwy zaczynają się na literę A. 
5. Wyświetl numer telefonu do dowolnego kontaktu pobierając go po kluczu.
*/

import java.util.HashMap;
import java.util.Map;

public class HashMapProgram {
    public static void main( String[] args ) {
        System.out.println( "----------------------------------------------" );

        Map<String, Integer> mapaKontaktow = new HashMap<>();

        mapaKontaktow.put( "Maciej", 776555444 );
        mapaKontaktow.put( "Maurycy", 444333444 );
        mapaKontaktow.put( "Ada", 333565333 );
        mapaKontaktow.put( "Tadeusz", 555234567 );
        mapaKontaktow.put( "Arek", 765432100 );
        mapaKontaktow.put( "Krystian", 123456789 );
        mapaKontaktow.put( "Ania", 321321321 );
        mapaKontaktow.put( "Kasia", 432432452 );
        mapaKontaktow.put( "Waldek", 765765765 );
        mapaKontaktow.put( "Adam", 901902903 );

        // Wyświetlenie całej mapy
        System.out.println( "Mapa kontaktów: " + mapaKontaktow );
        System.out.println();

        // Wyszukiwanie 1
        System.out.println( "Numery telefonów zaczynające się cyfrą 7:" );
        for( Map.Entry<String, Integer> kontakt : mapaKontaktow.entrySet() ) {
            if( kontakt.getValue().toString().startsWith("7") ) 
                System.out.println( kontakt );
        }
        System.out.println();

        // Wyszukiwanie 2
        System.out.println( "Numery telefonów osób, których imie zaczynające się od litery A:" );
        for( Map.Entry<String, Integer> kontakt : mapaKontaktow.entrySet() ) {
            if( kontakt.getKey().startsWith( "A") ) 
                System.out.println( kontakt );
        }
        System.out.println();

        // Wyszukiwanie 3
        System.out.println( "Numer telefonu Waldka:" );
        System.out.println( mapaKontaktow.get( "Waldek" ) );
        System.out.println( "----------------------------------------------" );
    }
}