Kotlin 第十七章： 异常和注解

异常类

所有的异常类都是 Exception 的子类。每个异常都有一个消息，栈踪迹和可选的原因。

使用 throw 表达式，抛出异常

throw MyException("Hi There!")

使用 try 捕获异常

try {  // some code}catch (e: SomeException) {  // handler}finally {  // optional finally block}

有可能有不止一个的 catch 块。finally 块可以省略。

try 是一个表达式

try 可以有返回值：

val a: Int? = try { parseInt(input) } catch (e: NumberFormatException) { null }

try 返回值要么是 try 块的最后一个表达式，要么是 catch 块的最后一个表达式。finally 块的内容不会对表达式有任何影响。

检查异常

Kotlin 中没有异常检查。这是由多种原因造成的，我们这里举个简单的例子

下面是 JDK StringBuilder 类实现的一个接口

Appendable append(CharSequence csq) throws IOException;

这个签名说了什么？　它说每次我把 string 添加到什么东西(StringBuilder 或者 log console 等等)上时都会捕获 IOExceptions 为什么呢？因为可能涉及到 IO 操作(Writer 也实现了 Appendable)…　所以导致所有实现 Appendable 的接口都得捕获异常

try {  log.append(message)}catch (IOException e) {  // Must be safe}

注解声明

注解是一种将元数据附加到代码中的方法。声明注解需要在类前面使用 annotation 关键字：

annotation class fancy

@Retention 注解

指定该注解是否存储在编译后的 Class 文件中，以及它在运行时能否通过反射可见，有三个值，默认是AnnotationRetention.RUNTIME，分别为：

• AnnotationRetention.SOURCE：不存储在编译后的 Class 文件。
• AnnotationRetention.BINARY：存储在编译后的 Class 文件，但是反射不可见。
• AnnotationRetention.RUNTIME：存储在编译后的 Class 文件，反射可见。

@Target 注解

表示该注解可以用于什么地方，类型有

• AnnotationTarget.CLASS：类，接口或对象，注解类也包括在内。
• AnnotationTarget.ANNOTATION_CLASS：只有注解类。
• AnnotationTarget.TYPE_PARAMETER：Generic type parameter (unsupported yet)通用类型参数（还不支持）。
• AnnotationTarget.PROPERTY：属性。
• AnnotationTarget.FIELD：字段，包括属性的支持字段。
• AnnotationTarget.LOCAL_VARIABLE：局部变量。
• AnnotationTarget.VALUE_PARAMETER：函数或构造函数的值参数。
• AnnotationTarget.CONSTRUCTOR：仅构造函数（主函数或者第二函数）。
• AnnotationTarget.FUNCTION：方法（不包括构造函数）。
• AnnotationTarget.PROPERTY_GETTER：只有属性的 getter。
• AnnotationTarget.PROPERTY_SETTER：只有属性的 setter。
• AnnotationTarget.TYPE：类型使用。
• AnnotationTarget.EXPRESSION：任何表达式。
• AnnotationTarget.FILE：文件。
• AnnotationTarget.TYPEALIAS：@SinceKotlin("1.1") 类型别名，Kotlin1.1已可用。

@Repeatable 注解

表示允许在同一申明类型（类，属性，或方法）的多次使用同一个注解

@MustBeDocumented 注解

决定了注解是公共 API 的一部分，因此应该包含在用于注解的元素的生成文档注解中。

这里声明一个 Fancy 注解：

@Target(AnnotationTarget.CLASS, AnnotationTarget.FUNCTION,        AnnotationTarget.VALUE_PARAMETER, AnnotationTarget.EXPRESSION)@Retention(AnnotationRetention.SOURCE)@MustBeDocumentedannotation class Fancy

用法

@fancy class Foo {    @fancy fun baz(@fancy foo: Int): Int {        return (@fancy 1)    }}

在多数情形中 @ 标识是可选的。只有在注解表达式或本地声明中才必须：

fancy class Foo {    fancy fun baz(fancy foo: Int): Int {        @fancy fun bar() { ... }        return (@fancy 1)    }}

如果要给构造函数注解，就需要在构造函数声明时添加 constructor 关键字，并且需要在前面添加注解：

class Foo @inject constructor (dependency: MyDependency)    //...

也可以注解属性访问者：

class Foo {    var x: MyDependency?=null        @inject set}

构造函数

注解可以有带参数的构造函数。

annotation class special(val why: String)special("example") class Foo {}

Lambdas

注解也可以用在 Lambda 中。这将会应用到 lambda 生成的 invoke() 方法。这对 Quasar 框架很有用，在这个框架中注解被用来并发控制

annotation class Suspendableval f = @Suspendable { Fiber.sleep(10) }

java 注解

java 注解在 kotlin 中是完全兼容的：

import org.junit.Testimport org.junit.Assert.*class Tests {  Test fun simple() {    assertEquals(42, getTheAnswer())  }}

java 注解也可以通过在导入是重命名实现像修改者那样：

import org.junit.Test as testclass Tests {  test fun simple() {    ...  }}

因为 java 中注解参数顺序是没定义的，你不能通过传入参数的方法调用普通函数。相反，你需要使用命名参数语法：

//Javapublic @interface Ann {    int intValue();    String stringValue(0;}

//kotlinAnn(intValue = 1, stringValue = "abc") class C

像 java 中那样，值参数是特殊的情形；它的值可以不用明确的名字。

public @interface AnnWithValue {    String value();}//kotlinAnnWithValue("abc") class C

如果java 中的 value 参数有数组类型，则在 kotlin 中变成 vararg 参数：

// Javapublic @interface AnnWithArrayValue {    String[] value();}// KotlinAnnWithArrayValue("abc", "foo", "bar") class C

如果你需要明确一个类作为一个注解参数，使用 Kotlin 类 KClass。Kotlin 编译器会自动把它转为 java 类，因此 java 代码就可以正常看到注解和参数了。

import kotlin.reflect.KClassannotation class Ann(val arg1: KClass<*>, val arg2: KClass<out Any?>)Ann(String::class, Int::class) class MyClass

注解实例的值在 kotlin 代码中是暴露属性。

// Javapublic @interface Ann {    int value();}// Kotlinfun foo(ann: Ann) {    val i = ann.value}

后记

这一篇文章算是学习 Kotlin 的最后一篇文章了，后面会不定期的带来几篇 Kotlin 实战小 Demo 用来增加 Kotlin 的理解和记忆，经历的这么长的时间，Kotlin 的学习算是告一段落了，虽然学习文章中有些内容在以后的编码中不一定能够用得到，但是写下来，以后翻翻加深记忆还是不错，玩意能用到呢？

最后还是希望各位看官能够多多留言，有问题多多指正。

参考

Kotlin中文文档