Close

Java Collections - Collections.checkedList() Examples

[Last Updated: Dec 11, 2025]

Java Collections Java Java API 

PreviousNext

Class:

java.util.Collections

java.lang.Objectjava.lang.Objectjava.util.Collectionsjava.util.CollectionsLogicBig

Method:

public static <E> List<E> checkedList(List<E> list,
                                      Class<E> type)

Returns a dynamically typesafe view of the specified List.


Examples


Without checkedList: 

package com.logicbig.example.collections;

import java.util.ArrayList;
import java.util.List;

public class CheckedListExample {

    public static void main(String... args) {
        List<String> list = new ArrayList<>();
        list.add("one");
        System.out.println(list);

        List list2 = list;
        list2.add(2);
        System.out.println(list2);
    }
}

Output

[one]
[one, 2]
JDK 25




With checkedList: 

package com.logicbig.example.collections;

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

public class CheckedListExample2 {

    public static void main(String... args) {
        List<String> list = new ArrayList<>();
        list = Collections.checkedList(list, String.class);
        list.add("one");
        System.out.println(list);

        List list2 = list;
        list2.add(2);
        System.out.println(list2);
    }
}

Output

[one]
java.lang.ClassCastException: Attempt to insert class java.lang.Integer element into collection with element type class java.lang.String
    at java.util.Collections$CheckedCollection.typeCheck (Collections.java:3455)
    at java.util.Collections$CheckedCollection.add (Collections.java:3503)
    at com.logicbig.example.collections.CheckedListExample2.main (CheckedListExample2.java:22)
    at jdk.internal.reflect.DirectMethodHandleAccessor.invoke (DirectMethodHandleAccessor.java:104)
    at java.lang.reflect.Method.invoke (Method.java:565)
    at org.codehaus.mojo.exec.AbstractExecJavaBase.executeMainMethod (AbstractExecJavaBase.java:402)
    at org.codehaus.mojo.exec.ExecJavaMojo.executeMainMethod (ExecJavaMojo.java:142)
    at org.codehaus.mojo.exec.AbstractExecJavaBase.doExecClassLoader (AbstractExecJavaBase.java:377)
    at org.codehaus.mojo.exec.AbstractExecJavaBase.lambda$execute$0 (AbstractExecJavaBase.java:287)
    at java.lang.Thread.run (Thread.java:1474)
JDK 25

See Also