`BinaryOperator` în Java

O funcție care combină două valori de același tip într-una (T, T → T); folosită de reduce, toMap și Map.merge.

Sintaxă

import java.util.function.BinaryOperator;

@FunctionalInterface
public interface BinaryOperator<T> extends BiFunction<T, T, T>
static <T> BinaryOperator<T> minBy(Comparator<? super T> comparator)
static <T> BinaryOperator<T> maxBy(Comparator<? super T> comparator)

Ce face `BinaryOperator`

BinaryOperator<T> primește două valori de tip T și returnează tot un T. Exemple: adunarea (Integer::sum), maximul (Math::max), lipirea a două texte.

Este tipul cerut de Stream.reduce, de funcția de combinare din Collectors.toMap și de Map.merge. Metodele statice BinaryOperator.minBy(comparator) și maxBy(comparator) creează un operator care păstrează valoarea mai mică, respectiv mai mare.

Ce returnează

apply(a, b) returnează valoarea combinată, de tipul T.

Exemple

Exemplul 1: Operatori pentru reduce

import java.util.Comparator;
import java.util.List;
import java.util.function.BinaryOperator;

public class Main {
    public static void main(String[] args) {
        BinaryOperator<Integer> suma = Integer::sum;
        BinaryOperator<String> lipire = (a, b) -> a + "-" + b;
        BinaryOperator<String> maiLung = BinaryOperator.maxBy(Comparator.comparingInt(String::length));

        System.out.println(suma.apply(15, 27));
        System.out.println(List.of(9, 7, 10).stream().reduce(0, suma));
        System.out.println(List.of("Iași", "Vaslui", "Bacău").stream().reduce(lipire).orElse(""));
        System.out.println(List.of("Iași", "Vaslui", "Bacău").stream().reduce(maiLung).orElse(""));
    }
}

Rezultat

42
26
Iași-Vaslui-Bacău
Vaslui

Exemplul 2: Map.merge: numărarea voturilor

Când candidatul există deja, merge folosește operatorul ca să combine valoarea veche cu cea nouă.

import java.util.Map;
import java.util.TreeMap;
import java.util.function.BinaryOperator;

public class Main {
    public static void main(String[] args) {
        BinaryOperator<Integer> aduna = Integer::sum;
        Map<String, Integer> voturi = new TreeMap<>();
        for (String vot : new String[]{"Ana", "Radu", "Ana", "Ioana", "Ana", "Radu"}) {
            voturi.merge(vot, 1, aduna);
        }
        System.out.println(voturi);
    }
}