O método java.util.HashMap.put() do HashMap é usado para inserir um mapeamento em um mapa. Isso significa que podemos inserir uma chave específica e o valor para o qual ela está mapeando em um mapa específico. Se uma chave existente for passada, o valor anterior será substituído pelo novo valor. Se um novo par for passado, o par será inserido como um todo.
Sintaxe: 
 

Hash_Map.put(key, value)

Parâmetros: O método leva dois parâmetros, ambos são do tipo Object do HashMap. 
 

• chave: Refere-se ao elemento-chave que precisa ser inserido no Mapa para mapeamento.
• valor: refere-se ao valor para o qual a chave acima seria mapeada.

Valor de retorno: se uma chave existente for passada, o valor anterior será retornado. Se um novo par for passado, NULL será retornado.
Os programas abaixo são usados ​​para ilustrar o funcionamento do Método java.util.HashMap.put(): 
Programa 1: Ao passar uma chave existente. 
 

// Java code to illustrate the put() method
import java.util.*;
 
public class Hash_Map_Demo {
    public static void main(String[] args)
    {
 
        // Creating an empty HashMap
        HashMap<Integer, String> hash_map = new HashMap<Integer, String>();
 
        // Mapping string values to int keys
        hash_map.put(10, "Geeks");
        hash_map.put(15, "4");
        hash_map.put(20, "Geeks");
        hash_map.put(25, "Welcomes");
        hash_map.put(30, "You");
 
        // Displaying the HashMap
        System.out.println("Initial Mappings are: " + hash_map);
 
        // Inserting existing key along with new value
        String returned_value = (String)hash_map.put(20, "All");
 
        // Verifying the returned value
        System.out.println("Returned value is: " + returned_value);
 
        // Displaying the new map
        System.out.println("New map is: " + hash_map);
    }
}

Os mapeamentos iniciais são: {20 = Geeks, 25 = Welcome, 10 = Geeks, 30 = You, 15 = 4}
O valor retornado é: Geeks
O novo mapa é: {20 = Todos, 25 = Boas-vindas, 10 = Geeks, 30 = Você, 15 = 4}

Programa 2: Ao passar uma nova chave. 
 

// Java code to illustrate the put() method
import java.util.*;
 
public class Hash_Map_Demo {
    public static void main(String[] args)
    {
 
        // Creating an empty HashMap
        HashMap<Integer, String> hash_map = new HashMap<Integer, String>();
 
        // Mapping string values to int keys
        hash_map.put(10, "Geeks");
        hash_map.put(15, "4");
        hash_map.put(20, "Geeks");
        hash_map.put(25, "Welcomes");
        hash_map.put(30, "You");
 
        // Displaying the HashMap
        System.out.println("Initial Mappings are: " + hash_map);
 
        // Inserting existing key along with new value
        String returned_value = (String)hash_map.put(50, "All");
 
        // Verifying the returned value
        System.out.println("Returned value is: " + returned_value);
 
        // Displaying the new map
        System.out.println("New map is: " + hash_map);
    }
}

Os mapeamentos iniciais são: {20 = Geeks, 25 = Welcome, 10 = Geeks, 30 = You, 15 = 4}
O valor retornado é: nulo
O novo mapa é: {50 = Todos, 20 = Geeks, 25 = Boas-vindas, 10 = Geeks, 30 = Você, 15 = 4}

Nota: A mesma operação pode ser realizada com qualquer tipo de mapeamento com variação e combinação de diferentes tipos de dados.