• Introduction
• Part 1 Good Code
  • Chapter 1 Safety
  • 引言
  • 第1条：限制可变性
  • 第2条：最小化变量作用域
  • 第3条：尽快消除平台类型
  • 第4条：不要把推断类型暴露给外部
  • Item 5 Specify Your Expectations On Arguments And State
  • 第6条：尽可能使用标准库中提供的异常
  • 第7条：当不能返回预期结果时，优先使用null o或Failure 作为返回值
  • Item 8 Handle Nulls Properly
  • 第9条：使用use关闭资源
  • Item 10 Write Unit Tests
  • Chapter 2 Readability
  • Introduction
  • Item 11 Design For Readability
  • Item 12 Operator Meaning Should Be Consistent With Its Function Name
  • Item 13 Avoid Returning Or Operating On Unit
  • Item 14 Specify The Variable Type When It Is Not Clear
  • Item 15 Consider Referencing Receivers Explicitly
  • Item 16 Properties Should Represent State Not Behavior
  • Item 17 Consider Naming Arguments
  • Item 18 Respect Coding Conventions
• Part 2 Code Design
  • Chapter 3 Reusability
  • Introduction
  • Item 19 Do Not Repeat Knowledge
  • Item 20 Do Not Repeat Common Algorithms
  • Item 21 Use Property Delegation To Extract Common Property Patterns
  • Item 22 Use Generics When Implementing Common Algorithms
  • Item 23 Avoid Shadowing Type Parameters
  • Item 24 Consider Variance For Generic Types
  • Item 25 Reuse Between Different Platforms By Extracting Common Modules
  • Chapter 4 Abstraction Design
  • Introduction
  • Item 26 Each Function Should Be Written In Terms Of A Single Level Of Abstraction
  • Item 27 Use Abstraction To Protect Code Against Changes
  • Item 28 Specify API Stability
  • Item 29 Consider Wrapping External API
  • Item 30 Minimize Elements Visibility
  • Item 31 Define Contract With Documentation
  • Item 32 Respect Abstraction Contracts
  • Chapter 5 Object Creation
  • Introduction
  • Item 33 Consider Factory Functions Instead Of Constructors
  • Item 34 Consider A Primary Constructor With Named Optional Arguments
  • Item 35 Consider Defining A DSL For Complex Object Creation
  • Chapter 6 Class Design
  • Introduction
  • Item 36 Prefer Composition Over Inheritance
  • Item 37 Use The Data Modifier To Represent A Bundle Of Data
  • Item 38 Use Function Types Instead Of Interfaces To Pass Operations And Actions
  • Item 39 Prefer Class Hierarchies To Tagged Classes
  • Item 40 Respect The Contract Of Equals
  • Item 41 Respect The Contract Of Hash Code
  • Item 42 Respect The Contract Of Compare To
  • Item 43 Consider Extracting Non Essential Parts Of Your API Into Extensions
  • Item 44 Avoid Member Extensions
• Part 3 Efficiency
  • Chapter 7 Make It Cheap
  • Introduction
  • Item 45 Avoid Unnecessary Object Creation
  • Item 46 Use Inline Modifier For Functions With Parameters Of Functional Types
  • Item 47 Consider Using Inline Classes
  • Item 48 Eliminate Obsolete Object References
  • Chapter 8 Efficient Collection Processing
  • Introduction
  • Item 49 Prefer Sequence For Big Collections With More Than One Processing Step
  • Item 50 Limit The Number Of Operations
  • Item 51 Consider Arrays With Primitives For Performance Critical Processing
  • Item 52 Consider Using Mutable Collections
• Published with GitBook

第6条：尽可能使用标准库中提供的异常

第6条：尽可能使用标准库中提供的异常

require， check 和assert函数涵盖了Kotlin中最常见的异常情况， 但还是有很多其他情况需要我们去主动抛出异常。例如，当你实现一个库来解析JSON时，当提供的JSON文件格式不正确时时，抛出一个JsonParsingException是合理的：

inline fun <reified T> String.readObject(): T {
   //...
   if (incorrectSign) {
       throw JsonParsingException()
   }
   //...
   return result
}

这里我们使用了一个自定义异常，因为在标准库中没有合适的异常来表答这种情况。你应该尽可能使用标准库提供的异常，而不是定义自己定义的异常。这些标准库提供的异常应该被开发者熟知和复用。在特定场景下使用这些异常会使你的API更容易学习和理解。下面是一些你可以使用的最常见的异常：

• IllegalArgumentException 和IllegalStateException - 像在第5条中提到的那样，使用 require 和check 来抛出该异常。
• IndexOutOfBoundsException - 表示索引越界。 常用于集合和数组。比如在 ArrayList.get(Int)中就会抛出该异常。
• ConcurrentModificationException - 表示并发修改是禁止的，当检测到这种行为时会抛出该异常。
• UnsupportedOperationException - 表示该对象不支持它声明的方法。我们应该避免这种情况，当一个方法不受支持时，它就不应该被声明在类中。
• NoSuchElementException - 表示被请求的元素不存在。 例如，当我们实现Iterable时，迭代器内已经没有其他元素了但是还是调用了 next 方法。

results matching ""

No results matching ""