Arrays.asList: примеры (JAVA)

Короткие примеры использования

Примеры демонстрируют типичные варианты и результаты вызовов.

1) Простое создание списка из элементов (varargs)

import java.util.*;
class Demo1 {
  public static void main(String[] args) {
    List list = Arrays.asList("a", "b", "c");
    System.out.println(list);
  }
}

[a, b, c]

2) Создание из уже существующего массива ссылочного типа

String[] arr = {"x", "y"};
List list = Arrays.asList(arr);
System.out.println(list);
arr[0] = "z";
System.out.println(list);

[x, y]
[z, y]

3) Попытка добавить элемент приведёт к исключению

List list = Arrays.asList(1, 2, 3);
list.add(4);

Exception in thread "main" java.lang.UnsupportedOperationException
    at java.base/java.util.AbstractList.add(AbstractList.java:~)
    ...

4) Поведение с примитивным массивом (неожиданный результат)

int[] nums = {1, 2, 3};
List list = Arrays.asList(nums);
System.out.println(list.size());
System.out.println(list.get(0)[1]);

1
2

5) Получение изменяемого списка через копирование

List modifiable = new ArrayList<>(Arrays.asList("a", "b"));
modifiable.add("c");
System.out.println(modifiable);

[a, b, c]

Похожие Java-методы и когда применять

• List.of(...) (Java 9+) - создаёт неизменяемый список. Предпочтительно, когда нужен короткий синтаксис и неизменяемость. Отличие: бросает NullPointerException при null-элементе, возвращаемый список полностью неизменяем.
• Collections.unmodifiableList(new ArrayList<>(...)) - создаёт неизменяемую оболочку над изменяемой коллекцией. Используется при необходимости защищённого представления после создания копии.
• Arrays.stream(...).collect(Collectors.toList()) - создаёт обычно изменяемую коллекцию (реализация не жёстко определена, но чаще ArrayList). Подходит для примитивных массивов с применением boxed().
• Collections.addAll(list, array) - добавляет элементы массива в существующий список. Удобно для заполнения уже созданной коллекции.

Выбор зависит от требований: нужен видимость изменений между массивом и списком - Arrays.asList. Нужен неизменяемый результат - List.of. Нужен изменяемый список - копия через new ArrayList<>(...).

Эквиваленты в других языках и отличия

Краткие примеры и особенности отличий от Java.

JavaScript - создание массива из значений

const arr = Array.from([1, 2, 3]);
const copy = [...arr];
console.log(arr, copy);

[1, 2, 3] [1, 2, 3]

Отличие: в JS массивы изменяемы и не имеют «видового» представления на базовый массив - копирование и представление работают явно.

Python

lst = list((1, 2, 3))
print(lst)

[1, 2, 3]

Отличие: list и tuple - встроенные типы, нет понятия «список, привязанный к массиву». Примитивы автоматически упаковываются.

C#

int[] arr = {1,2,3};
var list = arr.ToList();
Console.WriteLine(string.Join(",", list));

1,2,3

Отличие: ToList создаёт копию (System.Linq), изменения в списке не меняют исходный массив.

Kotlin

val arr = arrayOf(1,2,3)
val list = Arrays.asList(*arr)
println(list)

[1, 2, 3]

Отличие: Kotlin имеет свои коллекции (listOf, mutableListOf); Arrays.asList работает как в Java и возвращает фиксированный список.

Go

a := []int{1,2,3}
fmt.Println(a)

[1 2 3]

Отличие: срезы в Go - динамические представления последовательностей, поведение ближе к изменяемому списку-резервуару.

PHP

$arr = [1,2,3];
print_r($arr);

Array
(
    [0] => 1
    [1] => 2
    [2] => 3
)

Отличие: массивы PHP - универсальные ассоциативные структуры, нет различия между списком и массивом Java.

Lua

t = {1,2,3}
for i,v in ipairs(t) do print(v) end

1
2
3

Отличие: таблицы Lua универсальны, нет стандартного метода-посредника как Arrays.asList.

SQL

-- SQL не имеет прямого аналога; в некоторых СУБД можно использовать массивы как тип
SELECT ARRAY[1,2,3];

 {1,2,3} 

Отличие: SQL оперирует типом массивов в контексте запросов, не имеет встраиваемой коллекционной semantics Java.

Типичные ошибки и причины

• UnsupportedOperationException при add/remove/clear: возвращённый список фиксированного размера. Пример:

List list = Arrays.asList("a", "b");
list.remove(0);

Exception in thread "main" java.lang.UnsupportedOperationException
    at java.base/java.util.AbstractList.remove(AbstractList.java:~)
    ...

• Непреднамеренный список из одного элемента при передаче примитивного массива. Пример:

int[] nums = {1,2};
List list = Arrays.asList(nums);
System.out.println(list.size()); // 1

1

• Изменения в массиве отражаются в списке и наоборот, что может привести к неожиданному поведению в коде, где предполагается копия.
• Ошибки приведения типов при использовании raw-типов или некорректных дженериков могут приводить к ClassCastException во время выполнения.

Рекомендации по избежанию ошибок: для изменяемых списков использовать копию через new ArrayList<>(Arrays.asList(...)), для примитивных массивов применять boxed() и потоки.

Изменения и история поведения

Метод Arrays.asList присутствует в JDK давно и его базовая семантика не претерпела значительных изменений: он всегда возвращал фиксированное представление массива. Начиная с Java 9 в библиотеке появились альтернативы: List.of и List.copyOf, которые предоставляют удобный синтаксис для создания неизменяемых списков. Поведение asList в отношении отображения на массив и неподдержки операций изменения размера осталось прежним.

В более ранних версиях JDK не выполнялось автоматическое упаковывание/распаковка для примитивных массивов - это не менялось. Рекомендуемые практики (копирование в ArrayList для изменяемых списков или использование потоков для обработки примитивов) актуальны для последних версий.

Расширенные и неочевидные примеры применения

Несколько продвинутых случаев с пояснениями.

1) Сортировка через список-представление меняет исходный массив

String[] arr = {"c","a","b"};
List view = Arrays.asList(arr);
Collections.sort(view);
System.out.println(Arrays.toString(arr));
System.out.println(view);

[a, b, c]
[a, b, c]

Пояснение: Collections.sort изменяет список, что отражается в массиве.

2) Конвертация примитивного массива в список обёрток

int[] prim = {1,2,3};
List boxed = Arrays.stream(prim).boxed().collect(Collectors.toList());
System.out.println(boxed);

[1, 2, 3]

Пояснение: позволяет получить полноценный список Integer, пригодный для дальнейших модификаций после копирования в ArrayList.

3) Использование asList для создания фиксированного набора при тестах или в параметрах метода

void register(List names) { /* ... */ }
register(Arrays.asList("x","y"));

// нет вывода, пример вызова API

Пояснение: экономия на создании временных коллекций, когда не требуется изменение размера.

4) Получение подсписка и поведение с subList

String[] arr = {"a","b","c","d"};
List view = Arrays.asList(arr);
List sub = view.subList(1, 3);
sub.set(0, "X");
System.out.println(Arrays.toString(arr));

[a, X, c, d]

Пояснение: subList работает как окно над тем же представлением, изменения отражаются в исходном массиве.

5) Преобразование обратно в массив фиксированного типа

List list = Arrays.asList("a","b");
String[] arr = list.toArray(new String[0]);
System.out.println(Arrays.toString(arr));

[a, b]

6) Защита от непреднамеренных изменений - создание неизменяемой копии

List safe = Collections.unmodifiableList(new ArrayList<>(Arrays.asList("a","b")));
// safe.add("c"); // UnsupportedOperationException

// при попытке изменения будет исключение

7) Использование с обобщёнными типами и null-элементами

List list = Arrays.asList("a", null, "c");
System.out.println(list.get(1) == null);
list.set(1, "b");
System.out.println(list);

true
[a, b, c]

Пояснение: null допустим как элемент списка, установка нового значения работает, но добавление нет.