使用Kotlin高效地开发Android App(三）

一. ?、!! 、lateinit 以及 let

Kotlin 的类型系统旨在从我们的代码中消除 NullPointerException。

1.1 ?

Kotlin基于Java的空指针提出了一个空安全的概念，即每个属性默认不可为null。

例如：

1. var a: String = "test kotlin"

2. a = null //编译错误

如果要允许为空，我们需要手动声明一个变量为可空字符串类型，写为String?

1. var a: String? = "test kotlin"

2. a = null //编译成功

1.2 !!

!!是非空断言运算符。将任何值转换为非空类型，若该值为空则抛出异常。

1. object Test {

3.    var s:String?=null

5.    @JvmStatic

6.    fun main(args: Array<String>) {

8.        println(s!!.length)

9.    }

10. }

执行上述代码会抛出如下异常。

1. Exception in thread "main" kotlin.KotlinNullPointerException

在App快要发布时，我们会进行检查尽量避免使用“!!”,转而考虑使用lateinit或者let函数来代替它。

1.3 lateinit

在某个类中，如果某些成员变量没办法在一开始就初始化，并且又不想使用可空类型(也就是带?的类型)。那么，可以使用lateinit来修饰它。

被lateinit修饰的变量，并不是不初始化，它需要在生命周期流程中进行获取或者初始化。

如果访问未初始化的 lateinit 变量会导致 UninitializedPropertyAccessException。

1.4 let函数

let函数把当前对象作为闭包的it参数，返回值是函数里面最后一行，或者指定return。它看起来有点类似于run函数。

let函数跟run函数的区别是：let函数在函数内可以通过 it 指代该对象。

1. /**

2. * Calls the specified function [block] with `this` value as its argument and returns its result.

3. */

4. @kotlin.internal.InlineOnly

5. public inline fun <T, R> T.let(block: (T) -> R): R {

6.    contract {

7.        callsInPlace(block, InvocationKind.EXACTLY_ONCE)

8.    }

9.    return block(this)

10. }

跟?结合使用， let函数可以在对象不为 null 的时候执行函数内的代码，从而避免了空指针异常的出现。

一般是这样使用：

1. ?.let {

2.       ....

3. }

在使用Kotlin高效地开发Android App(二）中，曾经介绍过结合run和apply函数一起使用的方式。其实，里面使用了“!!”是有隐患的。

1.        viewModel.email.run {

3.            if (value!!.isEmpty()) {

4.                toast(resources.getString(R.string.you_have_not_completed_the_email_address)).show()

5.                return@onClickRight

6.            }

7.            if (!Util.checkEmail(value!!)) {

8.                toast(resources.getString(R.string.the_email_format_you_have_filled_is_incorrect)).show()

9.                return@onClickRight

10.            }

12.            viewModel

13.        }.subject.run {

15.            if (value!!.isEmpty()) {

16.                toast(resources.getString(R.string.you_have_not_completed_the_feedback_subject)).show()

17.                return@onClickRight

18.            }

20.            viewModel

21.        }.content.apply {

23.            if (value!!.isEmpty()) {

24.                toast(resources.getString(R.string.you_have_not_completed_the_details)).show()

25.                return@onClickRight

26.            }

27.        }

可以使用let函数进行优化，避免出现空指针的情况。

1.        viewModel.email.run {

2.            value?.let {

3.                if (it.isEmpty()) {

4.                    toast(string(R.string.you_have_not_completed_the_email_address)).show()

5.                    return@onClickRight

6.                }

7.                if (!Util.checkEmail(it)) {

8.                    toast(string(R.string.the_email_format_you_have_filled_is_incorrect)).show()

9.                    return@onClickRight

10.                }

11.            }

13.            viewModel

14.        }.subject.run {

15.            value?.let {

16.                if (it.isEmpty()) {

17.                    toast(string(R.string.you_have_not_completed_the_feedback_subject)).show()

18.                    return@onClickRight

19.                }

20.            }

22.            viewModel

23.        }.content.apply {

24.            value?.let {

25.                if (it.isEmpty()) {

26.                    toast(string(R.string.you_have_not_completed_the_details)).show()

27.                    return@onClickRight

28.                }

29.            }

30.        }

二.函数的默认参数

在Kotlin中，函数可以拥有默认参数，这样一来就不再需要像Java那样为了默认参数而写一大长串重载函数了。

例如，我们使用RxBinding时，可能会考虑到防止UI控件被重复点击，于是写下了这样的Transformer

1.    /**

2.     * 防止重复点击的Transformer

3.     */

4.    @JvmStatic

5.    fun <T> preventDuplicateClicksTransformer(windowDuration:Long=1000,timeUnit: TimeUnit=TimeUnit.MILLISECONDS): ObservableTransformer<T, T> {

6.        return ObservableTransformer { upstream ->

7.            upstream.throttleFirst(windowDuration, timeUnit)

8.        }

9.    }

在1秒内不能重复点击某个UI控件，可以这样写，因为使用了默认参数。

1.        RxView.clicks(textview)

2.                .compose(RxJavaUtils.preventDuplicateClicksTransformer())

3.                .subscribe({

4.                         ......

5.                })

三.DSL的使用

去年的时候，我曾经写过一篇关于kotlin dsl的文章——用kotlin来实现dsl风格的编程,使用dsl的方式编写代码个人感觉更加简洁和直观。

在项目中，我对toast以及glide框架尝试使用dsl的方式来封装。之前的用法是使用Kotlin的扩展函数，由于团队的其他成员更偏好链式调用，目前暂时保留了两种写法。

3.1 对glide的封装

glide的扩展函数，可以满足项目中的使用。

1. /**

2. * 占位符矩形

3. */

4. fun ImageView.load(url: String?) {

5.    get(url).placeholder(R.drawable.shape_default_rec_bg)

6.            .error(R.drawable.shape_default_rec_bg)

7.            .into(this)

8. }

10. /**

11. * 占位符圆角矩形

12. */

13. fun ImageView.loadRound(url: String?, centerCrop: Boolean = false) {

14.    get(url).placeholder(R.drawable.shape_default_round_bg)

15.            .error(R.drawable.shape_default_round_bg)

16.            .transform(RoundedCornersTransformation(DisplayUtil.dp2px(context, 10f), 0, centerCrop = centerCrop))

17.            .into(this)

18. }

20. /**

21. * 占位符圆形

22. */

23. fun ImageView.loadCircle(url: Drawable?) {

24.    get(url).placeholder(R.drawable.shape_default_circle_bg)

25.            .apply(RequestOptions.circleCropTransform())

26.            .error(R.drawable.shape_default_circle_bg)

27.            .into(this)

28. }

30. fun ImageView.loadCircle(url: String?) {

31.    get(url).placeholder(R.drawable.shape_default_circle_bg)

32.            .apply(RequestOptions.circleCropTransform())

33.            .error(R.drawable.shape_default_circle_bg)

34.            .into(this)

35. }

37. fun ImageView.get(url: String?): GlideRequest<Drawable> = GlideApp.with(context).load(url)

38. fun ImageView.get(url: Drawable?): GlideRequest<Drawable> = GlideApp.with(context).load(url)

加载某个图片之后，让它呈现出圆角矩形的效果

1. holder.itemView.iv_game.loadRound(image_url)

使用dsl进行封装

1. class GlideWrapper {

3.    var url:String? = null

5.    var image: ImageView?=null

7.    var placeholder: Int = R.drawable.shape_default_rec_bg

9.    var error: Int = R.drawable.shape_default_rec_bg

11.    var transform: Transformation<Bitmap>? = null

13. }

15. fun load(init: GlideWrapper.() -> Unit) {

17.    val wrap = GlideWrapper()

19.    wrap.init()

21.    execute(wrap)

22. }

24. private fun execute(wrap:GlideWrapper) {

26.    wrap.image?.let {

28.        var request = it.get(wrap.url).placeholder(wrap.placeholder).error(wrap.error)

30.        if (wrap?.transform!=null) {

32.            request.transform(wrap.transform!!)

33.        }

35.        request.into(it)

37.    }

39. }

仍然是加载该图片，让它呈现出圆角矩形的效果

1.            load {

2.                url = image_url

3.                image = holder.itemView.iv_game

4.                transform = RoundedCornersTransformation(DisplayUtil.dp2px(context, 10f), 0, centerCrop = false)

5.            }

3.2 对toast的封装

提示信息是任何App必不可少的，在我们的项目中也使用扩展函数对toast进行封装。

1. fun Toast.setGravityCenter(): Toast {

2.    setGravity(Gravity.CENTER, 0, 0)

3.    return this

4. }

6. /**

7. * 设置Toast字体及背景颜色

8. * @param messageColor

9. * @param backgroundColor

10. * @return

11. */

12. fun Toast.setToastColor(@ColorInt messageColor: Int, @ColorInt backgroundColor: Int) {

13.    val view = view

14.    if (view != null) {

15.        val message = view.findViewById(android.R.id.message) as TextView

16.        message.setBackgroundColor(backgroundColor)

17.        message.setTextColor(messageColor)

18.    }

19. }

21. /**

22. * 设置Toast字体及背景

23. * @param messageColor

24. * @param background

25. * @return

26. */

27. fun Toast.setBackground(@ColorInt messageColor: Int = Color.WHITE, @DrawableRes background: Int = R.drawable.shape_toast_bg): Toast {

28.    val view = view

29.    if (view != null) {

30.        val message = view.findViewById(android.R.id.message) as TextView

31.        view.setBackgroundResource(background)

32.        message.setTextColor(messageColor)

33.    }

34.    return this

35. }

37. //@SuppressLint("ShowToast")

38. fun toast(text: CharSequence): Toast = Toast.makeText(App.instance, text, Toast.LENGTH_LONG)

39.        .setGravityCenter()

40.        .setBackground()

41. //需要的地方调用withErrorIcon，默认不要添加

42. //        .withErrorIcon()

45. //@SuppressLint("ShowToast")

46. fun toast(@StringRes res: Int): Toast = Toast.makeText(App.instance, App.instance.resources.getString(res), Toast.LENGTH_LONG)

47.        .setGravityCenter()

48.        .setBackground()

49. //需要的地方调用withErrorIcon，默认不要添加

50. //        .withErrorIcon()

52. fun Toast.withErrorIcon(@DrawableRes iconRes: Int = R.drawable.ic_toast_error): Toast {

53.    val view = view

54.    if (view != null) {

55.        val layout = this.view as LinearLayout

56.        val layoutParams = LinearLayout.LayoutParams(LinearLayout.LayoutParams.WRAP_CONTENT, LinearLayout.LayoutParams.WRAP_CONTENT)

57.        val icon = ImageView(getApplicationContext())

58.        icon.setImageResource(iconRes)

59.        icon.setPadding(0, 0, Util.dip2px(8f), 0)

60.        icon.layoutParams = layoutParams

61.        layout.orientation = LinearLayout.HORIZONTAL

62.        layout.gravity = Gravity.CENTER_VERTICAL

63.        layout.addView(icon, 0)

64.    }

65.    return this

66. }

68. fun Toast.withSuccIcon(@DrawableRes iconRes: Int = R.drawable.ic_right_circle): Toast {

69.    val view = view

70.    if (view != null) {

71.        val layout = this.view as LinearLayout

72.        val layoutParams = LinearLayout.LayoutParams(LinearLayout.LayoutParams.WRAP_CONTENT, LinearLayout.LayoutParams.WRAP_CONTENT)

73.        val icon = ImageView(getApplicationContext())

74.        icon.setImageResource(iconRes)

75.        icon.setPadding(0, 0, Util.dip2px(8f), 0)

76.        icon.layoutParams = layoutParams

77.        layout.orientation = LinearLayout.HORIZONTAL

78.        layout.gravity = Gravity.CENTER_VERTICAL

79.        layout.addView(icon, 0)

80.    }

81.    return this

82. }

要展示一个错误的提示，大致需要这样写。

1. toast(resources.getString(R.string.you_have_not_completed_the_email_address)).withErrorIcon().show()

使用dsl进行封装

1. class ToastWrapper {

3.    var text:String? = null

5.    var res:Int? = null

7.    var showSuccess:Boolean = false

9.    var showError:Boolean = false

10. }

12. fun toast(init: ToastWrapper.() -> Unit) {

13.    val wrap = ToastWrapper()

15.    wrap.init()

17.    execute(wrap)

18. }

20. private fun execute(wrap:ToastWrapper) {

22.    var taost:Toast?=null

24.    wrap.text?.let {

26.        taost = toast(it)

27.    }

29.    wrap.res?.let {

31.        taost = toast(it)

32.    }

34.    if (wrap.showSuccess) {

36.        taost?.withSuccIcon()

37.    } else if (wrap.showError) {

39.        taost?.withErrorIcon()

40.    }

42.    taost?.show()

43. }

使用dsl的方式展示同样的错误信息。

1.                toast {

3.                    res = R.string.you_have_not_completed_the_email_address

4.                    showError = true

5.                }

总结

目前该系列的文章整理得比较随意，更像是一些常用的tips。

文中的dsl还是结合了扩展函数来使用的，个人认为是进一步的封装。相比起链式调用，我还是比较偏向dsl。

该系列的相关文章：

使用Kotlin高效地开发Android App(二）

使用Kotlin高效地开发Android App(一）

关注【Java与Android技术栈】

更多精彩内容请关注扫码：