Skip to content

docs: clarify List.of mutability and mutable array copies - #2940

Open
Shubham-Padkonde wants to merge 1 commit into
Snailclimb:mainfrom
Shubham-Padkonde:docs/clarify-list-of-mutability
Open

Shubham-Padkonde wants to merge 1 commit into
Snailclimb:mainfrom
Shubham-Padkonde:docs/clarify-list-of-mutability

Conversation

@Shubham-Padkonde

Copy link
Copy Markdown

Fixes #2649.

数组转列表一节以 ArrayList 为标题,但其中的 List.of() 示例返回不可修改的列表,容易让读者误以为它支持增删元素。

将标题改为 List,说明 List.of() 不支持添加、删除或替换元素,也不接受 null,并补充复制到 ArrayList 后进行修改的例子。保留与 Arrays.asList() 的区别:后者可以替换元素。

验证:

  • Java 26 上编译(javac --release 9)并运行示例检查:确认三种修改操作抛出 UnsupportedOperationException、包含 null 时抛出 NullPointerException、Arrays.asList() 支持替换,以及可变副本的结果与注释一致。
  • Prettier 3.4.2、markdownlint-cli2 0.17.1 和 git diff --check 通过。
  • 未在本地运行完整 VuePress 构建,文档构建由仓库 CI 验证。

行为依据:Java List 的 Unmodifiable Lists 说明。

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

关于数组转集合方法的第六种:使用Java9的List.of()

1 participant

⌂ Proxy