属性声明(Declaring Properties)
使用Kotlin语言,类可以有若干属性,它们可以是可变的(var),可也以是只读的(val):
class Address {
var name: String = ...
var street: String = ...
var city: String = ...
var state: String? = ...
var zip: String = ...
}
要使用一个属性,我们简单地通过名称引用它,就好像它是Java中的一个字段:
fun copyAddress(address: Address): Address {
val result = Address() // there's no 'new' keyword in Kotlin
result.name = address.name // accessors are called
result.street = address.street
// ...
return result
}
Getter和Setter
声明一个属性的完整语法是:
var <propertyName>[: <PropertyType>] [= <property_initializer>]
[<getter>]
[<setter>]
属性的初始化、getter方法和setter方法都是可选的。如果存在属性的初始化操作,则属性的类型在可以被推断出来(或从getter返回的类型进行推断)的时候也是可以省略的:
var allByDefault: Int? // error: explicit initializer required, default getter and setter implied
var initialized = 1 // has type Int, default getter and setter
只读属性的声明方式和可变属性的声明方式有两点不同:前者以val开头,后者以var开头;前者不允许有setter方法:
val simple: Int? // has type Int, default getter, must be initialized in constructor
val inferredType = 1 // has type Int and a default getter
我们可以在一个属性声明中写出自定义访问器,与普通函数非常类似。 以下是一个自定义getter的例子:
val isEmpty: Boolean
get() = this.size == 0
一个自定义setter的例子如下:
var stringRepresentation: String
get() = this.toString()
set(value) {
setDataFromString(value) // parses the string and assigns values to other properties
}
按照惯例,setter方法的参数名称是value,但若你喜欢,可以选择其他的名称。
从Kotlin 1.1开始,如果可以通过getter方法推断出属性的类型,则属性的类型也可以省略:
val isEmpty get() = this.size == 0 // has type Boolean
如果需要改变访问器的可见性或注解它,不必改变默认的实现,只需要定义一个无方法体的访问器即可:
var setterVisibility: String = "abc"
private set // the setter is private and has the default implementation
var setterWithAnnotation: Any? = null
@Inject set // annotate the setter with Inject
Backing Fields
由于对该方面的概念不太了解,暂且不译。原文点这里Backing Fields
Backing Properties
由于对该方面的概念不太了解,暂且不译。原文点这里Backing Properties
编译时常量(Compile-Time Constants)
在编译时已知其值的属性可以使用const修饰符标记为编译时常数。 这些属性需要满足以下要求:
- Top-level or member of an object
- 基本类型或字符串类型。Initialized with a value of type String or a primitive type
- 无自定义getter方法。No custom getter
这些属性可以在注释中使用:
const val SUBSYSTEM_DEPRECATED: String = "This subsystem is deprecated"
@Deprecated(SUBSYSTEM_DEPRECATED) fun foo() { ... }
属性的延时初始化(Late-Initialized Properties)
通常,声明为非空类型的属性必须在构造函数中进行初始化。 然而,这通常不方便。 例如,有时需要通过依赖注入或单元测试的设置方法来初始化属性。 在这种情况下,您不能在构造函数中提供非空的初始值,但你在引用类体中的一个属性的时候仍然需要避免null检查。
为了处理这种情况,可以使用lateinit修饰符类修饰目标属性:
public class MyTest {
lateinit var subject: TestSubject
@SetUp fun setup() {
subject = TestSubject()
}
@Test fun test() {
subject.method() // dereference directly
}
}
lateinit修饰符仅用于在类体中的var属性(不在主构造器中),并且只有当该属性没有自定义的getter或setter时才可以使用。 属性的类型必须为非空值,并且不能为原始类型。
在初始化之前访问一个lateinit属性会引发一个特殊的异常,该异常明确指出目标属性被访问了但它还没被初始化的事实。
属性重写(Overriding Properties)
委托属性(Delegated Properties)
由于对该方面的概念不太了解,暂且不译。原文点这里Delegated Properties