Chapter 8. Methods（方法）

Chapter 8 Introduction（章节介绍）

THIS chapter discusses several aspects of method design: how to treat parameters and return values, how to design method signatures, and how to document methods. Much of the material in this chapter applies to constructors as well as to methods. Like Chapter 4, this chapter focuses on usability, robustness, and flexibility.

本章讨论了方法设计的几个方面：如何处理参数和返回值，如何设计方法签名，以及如何编写方法文档。本章的大部分内容不仅适用于方法，也适用于构造函数。与第四章一样，本章重点讨论可用性、健壮性和灵活性。

Contents of the chapter（章节目录）

• Item 49: Check parameters for validity（检查参数的有效性）
• Item 50: Make defensive copies when needed（在需要时制作防御性副本）
• Item 51: Design method signatures carefully（仔细设计方法签名）
• Item 52: Use overloading judiciously（明智地使用重载）
• Item 53: Use varargs judiciously（明智地使用可变参数）
• Item 54: Return empty collections or arrays, not nulls（返回空集合或数组，而不是 null）
• Item 55: Return optionals judiciously（明智地的返回 Optional）
• Item 56: Write doc comments for all exposed API elements（为所有公开的 API 元素编写文档注释）