The Consumer Interface is a part of the java.util.function package which has been introduced since Java 8, to implement functional programming in Java. It represents a function which takes in one argument and produces a result. However these kind of functions don’t return any value.
Hence this functional interface which takes in one generic namely:-
- T: denotes the type of the input argument to the operation
The lambda expression assigned to an object of Consumer type is used to define its accept() which eventually applies the given operation on its argument. Consumers are useful when it not needed to return any value as they are expected to operate via side-effects.
Functions in Consumer Interface
The Consumer interface consists of the following two functions:
This method accepts one value and performs the operation on the given argument
void accept(T t)
Parameters: This method takes in one parameter:
- t– the input argument
Returns: This method does not return any value.
Below is the code to illustrate accept() method:
10 4 2 6
It returns a composed Comsumer wherein the parameterized Consumer will be executed after the first one. If evaluation of either function throws an error, it is relayed to the caller of the composed operation.
Note: The function being passed as the argument should be of type Consumer.
default Consumer <T> andThen(Consumer<? super T> after)
Parameters: This method accepts a parameter after which is the Consumer to be applied after the current one.
Return Value: This method returns a composed Consumer that first applies the current Consumer first and then the after operation.
Exception: This method throws NullPointerException if the after operation is null.
Below is the code to illustrate andThen() method:
4 2 6
Program 2: To demonstrate when NullPointerException is returned.
Program 3: To demonstrate how an Exception in the after function is returned and handled.
2 1 3 Exception: java.lang.IndexOutOfBoundsException: Index: 3, Size: 3
- Java.util.function.IntPredicate interface in Java with Examples
- Java.util.function.BiPredicate interface in Java with Examples
- Java.util.function.LongPredicate interface in Java with Examples
- Java.util.function.DoublePredicate interface in Java with Examples
- Java 8 | IntToDoubleFunction Interface in Java with Examples
- Java 8 | DoubleToLongFunction Interface in Java with Examples
- Java 8 | BiConsumer Interface in Java with Examples
- Java 8 | IntToLongFunction Interface in Java with Examples
- IntFunction Interface in Java with Examples
- DoubleFunction Interface in Java with Examples
- SortedMap Interface in Java with Examples
- Supplier Interface in Java with Examples
- ToLongBiFunction Interface in Java with Examples
- DoubleConsumer Interface in Java with Examples
- LongConsumer Interface in Java with Examples
If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to email@example.com. See your article appearing on the GeeksforGeeks main page and help other Geeks.
Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.