Uso de Collections.singletonList () do Java?

Para que serve o Collections.singletonList()Java? Eu entendo que ele retorna uma lista com um elemento. Por que eu gostaria de ter um método separado para fazer isso? Como a imutabilidade desempenha um papel aqui?

Existem casos de uso úteis especiais para esse método, em vez de apenas ser um método conveniente?

O javadoc diz o seguinte:

"Retorna uma lista imutável que contém apenas o objeto especificado. A lista retornada é serializável."

Você pergunta:

Por que eu gostaria de ter um método separado para fazer isso?

Principalmente como uma conveniência ... para poupar a necessidade de escrever uma sequência de instruções para:

• crie um objeto de lista vazio
• adicione um elemento a ele e
• envolva-o com um invólucro imutável.

Também pode ser um pouco mais rápido e / ou economizar um pouco de memória, mas é improvável que essas pequenas economias sejam significativas. (Um aplicativo que cria um grande número de listas de singleton é incomum, para dizer o mínimo.)

Como a imutabilidade desempenha um papel aqui?

Faz parte da especificação do método; Veja acima.

Existem casos de uso úteis especiais para esse método, em vez de apenas ser um método de conveniência?

Claramente, existem casos de uso em que é conveniente usar o singletonListmétodo Mas não sei como você distinguiria (objetivamente) entre um caso de uso comum e um "especialmente útil" ...

Aqui está uma visão sobre os métodos singleton:

Eu descobri que esses vários métodos "singleton" são úteis para passar um único valor para uma API que requer uma coleção desse valor. Obviamente, isso funciona melhor quando o código que processa o valor passado não precisa ser adicionado à coleção.

Do javadoc

@param  the sole object to be stored in the returned list.
@return an immutable list containing only the specified object.

exemplo

import java.util.*;

public class HelloWorld {
    public static void main(String args[]) {
        // create an array of string objs
        String initList[] = { "One", "Two", "Four", "One",};

        // create one list
        List list = new ArrayList(Arrays.asList(initList));

        System.out.println("List value before: "+list);

        // create singleton list
        list = Collections.singletonList("OnlyOneElement");
        list.add("five"); //throws UnsupportedOperationException
        System.out.println("List value after: "+list);
    }
}

Use-o quando o código espera uma lista somente leitura, mas você deseja passar apenas um elemento nela. singletonListé (thread) seguro e rápido.

Para responder sua pergunta imutável:

Collections.singletonListcriará uma lista imutável. Uma lista imutável (também chamada de lista não modificável) não pode ter seu conteúdo alterado. Os métodos para adicionar ou remover itens lançarão exceções se você tentar alterar o conteúdo.

Uma lista única contém apenas esse item e não pode ser alterada.

Se uma coleção Immutable / Singleton se referir àquela que possui apenas um objeto e que não é mais modificada, a mesma funcionalidade pode ser alcançada criando uma coleção "UnmodifiableCollection" com apenas um objeto. Como a mesma coleção pode ser alcançada com a coleção Unmodifiable com um objeto, para qual finalidade especial a coleção Singleton serve?

singletonList pode conter instância de qualquer objeto. O estado do objeto pode ser modificado.

List<Character> list = new ArrayList<Character>();
list.add('X');
list.add('Y');
System.out.println("Initial list: "+ list);
List<List<Character>> list2 = Collections.singletonList(list);
list.add('Z');
System.out.println(list);
System.out.println(list2);

Não podemos definir unmodifiableList como acima.