Java 自定义 View - Kotlin 自定义 View

在 Android 开发中，Java 自定义 View 常常需要编写大量重复的构造函数模板代码，而 Kotlin 借助 @JvmOverloads 注解能够大幅精简这类样板，让代码更简洁、更易维护。

从 Java 到 Kotlin：自定义 View 的迁移实践

旧版 Java 写法

public class CircleView extends View {
    private Paint paint;
    private int circleColor;

    public CircleView(Context context) {
        super(context);
        init(null);
    }

    public CircleView(Context context, AttributeSet attrs) {
        super(context, attrs);
        init(attrs);
    }

    public CircleView(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        init(attrs);
    }

    private void init(AttributeSet attrs) {
        paint = new Paint(Paint.ANTI_ALIAS_FLAG);
        circleColor = Color.RED;

        if (attrs != null) {
            TypedArray a = getContext().obtainStyledAttributes(attrs, R.styleable.CircleView);
            circleColor = a.getColor(R.styleable.CircleView_circleColor, Color.RED);
            a.recycle();
        }
    }

    @Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);
        paint.setColor(circleColor);
        int radius = Math.min(getWidth(), getHeight()) / 2;
        canvas.drawCircle(getWidth() / 2f, getHeight() / 2f, radius, paint);
    }

    public void setCircleColor(int color) {
        this.circleColor = color;
        invalidate();
    }
}

痛点分析

三个重载构造函数属于典型的样板代码，每个自定义 View 都要重复编写，一个包含十几个 View 的项目仅构造函数就可能累积上百行。之所以引入 init() 方法，不过是为了规避构造函数之间不能相互调用的限制。

新版 Kotlin 写法

class CircleView @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : View(context, attrs, defStyleAttr) {

    private val paint = Paint(Paint.ANTI_ALIAS_FLAG)
    private var circleColor = Color.RED

    init {
        if (attrs != null) {
            val typedArray = context.obtainStyledAttributes(attrs, R.styleable.CircleView)
            circleColor = typedArray.getColor(R.styleable.CircleView_circleColor, Color.RED)
            typedArray.recycle()
        }
    }

    override fun onDraw(canvas: Canvas) {
        super.onDraw(canvas)
        paint.color = circleColor
        val radius = minOf(width, height) / 2
        canvas.drawCircle(width / 2f, height / 2f, radius.toFloat(), paint)
    }

    fun setCircleColor(color: Int) {
        circleColor = color
        invalidate()
    }
}

关键注意点

@JvmOverloads 与 Kotlin 默认参数配合，会自动为 Java 调用方生成所需的三个重载构造函数。若自定义 View 需要在 XML 布局中使用，该注解不可省略；否则布局填充器将因找不到对应签名的构造函数而导致崩溃。

paint.color = circleColor 是 Kotlin 的属性访问语法，它等价于 Java 中的 paint.setColor(circleColor)。Android SDK 中所有 getXxx()/setXxx() 方法对在 Kotlin 里都会自动映射为属性，无需像 Java 那样显式调用 setter。

迁移到 Kotlin 后，自定义 View 的构造代码量显著减少，维护性也得到提升——这就是 @JvmOverloads 带来的实际收益，也是 Java 老项目向 Kotlin 平滑迁移的关键一环。