Collections unmodifiableList() method in Java with Examples
Last Updated :
08 Oct, 2018
The unmodifiableList() method of java.util.Collections class is used to return an unmodifiable view of the specified list. This method allows modules to provide users with “read-only” access to internal lists. Query operations on the returned list “read through” to the specified list, and attempts to modify the returned list, whether direct or via its iterator, result in an UnsupportedOperationException.
The returned list will be serializable if the specified list is serializable. Similarly, the returned list will implement RandomAccess if the specified list does.
Syntax:
public static <T> ListT>
unmodifiableList(List<? extends T> list)
Parameters: This method takes the list as a parameter for which an unmodifiable view is to be returned.
Return Value: This method returns an unmodifiable view of the specified list.
Below are the examples to illustrate the unmodifiableList() method
Example 1:
import java.util.*;
public class GFG1 {
public static void main(String[] argv)
throws Exception
{
try {
List<Character> list = new ArrayList<Character>();
list.add( 'X' );
list.add( 'Y' );
System.out.println( "Initial list: " + list);
List<Character> immutablelist = Collections
.unmodifiableList(list);
System.out.println( "Unmodifiable list: "
+ immutablelist);
}
catch (UnsupportedOperationException e) {
System.out.println( "Exception thrown : " + e);
}
}
}
|
Output:
Initial list: [X, Y]
Unmodifiable list: [X, Y]
Example 2: For UnsupportedOperationException
import java.util.*;
public class GFG1 {
public static void main(String[] argv)
throws Exception
{
try {
List<Character> list = new ArrayList<Character>();
list.add( 'X' );
list.add( 'Y' );
System.out.println( "Initial list: " + list);
List<Character> immutablelist = Collections
.unmodifiableList(list);
System.out.println( "\nTrying to modify"
+ " the unmodifiablelist" );
immutablelist.add( 'Z' );
}
catch (UnsupportedOperationException e) {
System.out.println( "Exception thrown : " + e);
}
}
}
|
Output:
Initial list: [X, Y]
Trying to modify the unmodifiablelist
Exception thrown : java.lang.UnsupportedOperationException
Like Article
Suggest improvement
Share your thoughts in the comments
Please Login to comment...