Android自定义视图构造函数的多重调用解析与最佳实践

Android自定义视图构造函数的多重调用解析与最佳实践

本文旨在深入解析android自定义视图构造函数被多次调用的常见原因,主要归结为xml布局文件膨胀和代码中显式实例化两种方式。文章将通过示例代码阐述这两种调用场景,并提供针对性的最佳实践,指导开发者如何正确初始化自定义视图,避免不必要的重复执行,确保视图生命周期行为符合预期。

在android应用开发中,自定义视图(custom view)是实现独特ui和交互逻辑的重要手段。然而,开发者有时会遇到一个令人困惑的问题:自定义视图的构造函数被执行了多次。这通常不是一个bug,而是对android视图加载机制和生命周期理解不足所致。

Android自定义视图构造函数的调用机制

一个自定义视图的构造函数被调用的场景主要有两种:

  1. XML布局文件膨胀(Inflation): 当你在XML布局文件中定义了一个自定义视图,并通过setContentView()方法或LayoutInflater服务加载该布局时,Android系统会自动解析XML,并为其中定义的每个视图元素创建相应的实例。对于自定义视图,系统会查找其全限定类名,并通过反射机制调用其带有Context和AttributeSet参数的构造函数。这个过程称为视图的膨胀。

    示例代码: 假设我们有一个名为MyCustomView的自定义视图,其XML布局如下:

    <!-- activity_main.xml --> <androidx.constraintlayout.widget.ConstraintLayout     xmlns:android="http://schemas.android.com/apk/res/android"     xmlns:app="http://schemas.android.com/apk/res-auto"     android:layout_width="match_parent"     android:layout_height="match_parent">      <com.example.app.MyCustomView         android:id="@+id/my_custom_view_xml"         android:layout_width="wrap_content"         android:layout_height="wrap_content"         app:layout_constraintTop_toTopOf="parent"         app:layout_constraintStart_toStartOf="parent"/>  </androidx.constraintlayout.widget.ConstraintLayout>

    对应的MyCustomView类:

    package com.example.app;  import android.content.Context; import android.util.AttributeSet; import android.view.View; import androidx.annotation.NULLable;  public class MyCustomView extends View {      private static final String TAG = "MyCustomView";      // 用于XML膨胀的构造函数     public MyCustomView(Context context, @Nullable AttributeSet attrs) {         super(context, attrs);         // 在这里可以读取XML中定义的属性         System.out.println(TAG + ": Constructor (Context, AttributeSet) called.");         init(); // 调用初始化方法     }      // 如果视图只通过代码创建,可以使用这个构造函数     public MyCustomView(Context context) {         super(context);         System.out.println(TAG + ": Constructor (Context) called.");         init(); // 调用初始化方法     }      private void init() {         // 视图的公共初始化逻辑放在这里         System.out.println(TAG + ": init() method called.");     } }

    在Activity中,当调用setContentView(R.layout.activity_main)时,MyCustomView(Context context, AttributeSet attrs)构造函数将被执行一次。

  2. 代码中显式实例化(Programmatic Instantiation): 你可以在Javakotlin代码中直接使用new关键字创建自定义视图的实例。此时,会根据你传入的参数类型,调用对应的构造函数。

    示例代码: 继续使用上面的MyCustomView类,在Activity中显式创建实例:

    package com.example.app;  import android.os.Bundle; import androidx.appcompat.app.AppCompatActivity;  public class MainActivity extends AppCompatActivity {      @Override     protected void onCreate(Bundle savedInstanceState) {         super.onCreate(savedInstanceState);         setContentView(R.layout.activity_main); // 第一次调用:XML膨胀          // 第二次调用:代码显式实例化         MyCustomView myCustomViewProgrammatic = new MyCustomView(this);         // 或者,如果传入null作为AttributeSet,也会调用 (Context, AttributeSet) 构造函数         // MyCustomView myCustomViewProgrammatic = new MyCustomView(this, null);          // 你可能需要将这个视图添加到某个布局中才能看到它         // LinearLayout layout = findViewById(R.id.some_layout_id);         // layout.addView(myCustomViewProgrammatic);     } }

    在这个场景下,new MyCustomView(this)会调用MyCustomView(Context context)构造函数。如果调用的是new MyCustomView(this, null),则会调用MyCustomView(Context context, AttributeSet attrs)构造函数。

构造函数多次调用的根本原因

当你的自定义视图同时存在于XML布局中,并且你在对应的Activity或Fragment代码中又显式地new了一个该自定义视图的实例时,就会导致其构造函数被调用两次。

如问题描述中的情况:

  1. XML布局文件activity_main2.xml中定义了。当MainActivity2调用setContentView(R.layout.activity_main2)时,系统会膨胀该布局,从而调用CustomView的CustomView(Context context, AttributeSet attrs)构造函数。这是第一次调用。
  2. 在MainActivity2的onCreate方法中,你又显式地执行了CustomView customView = new CustomView(this, null);。这会再次调用CustomView的CustomView(Context context, AttributeSet attrs)构造函数。这是第二次调用。

因此,构造函数被执行两次是预期行为,因为你以两种不同的方式触发了它的实例化。

视图构造函数类型详解

android.view.View类提供了多个构造函数,以适应不同的实例化场景:

  • public View(Context context): 这是最基本的构造函数,通常用于纯代码创建视图的场景。它不处理XML属性。
  • public View(Context context, @Nullable AttributeSet attrs): 这是最常用的构造函数,当视图在XML布局中定义时,系统会调用此构造函数。AttributeSet参数包含了XML中为该视图定义的所有属性(如android:layout_width、android:id以及自定义属性)。
  • public View(Context context, @Nullable AttributeSet attrs, int defStyleAttr): 此构造函数允许指定一个默认样式属性(defStyleAttr)。如果XML中没有为视图指定样式,或者指定的样式中没有某个属性,系统会从defStyleAttr指向的样式中查找。
  • public View(Context context, @Nullable AttributeSet attrs, int defStyleAttr, int defStyleRes): 这是最完整的构造函数,除了defStyleAttr,还允许指定一个默认样式资源ID(defStyleRes)。它在defStyleAttr之后应用,提供了更细粒度的样式控制。

最佳实践与注意事项

为了避免重复初始化逻辑和潜在的错误,同时确保自定义视图的健壮性,请遵循以下最佳实践:

  1. 区分实例化方式:

    • 如果你的自定义视图主要通过XML布局使用,那么其主要初始化逻辑应该放在View(Context context, AttributeSet attrs)构造函数中,并处理AttributeSet中的自定义属性。
    • 如果你的自定义视图只通过代码创建,那么可以使用View(Context context)构造函数。
    • 切勿在XML中定义了视图后,又在代码中显式new同一个视图实例,除非你有非常明确的意图需要两个独立的实例。
  2. 使用统一的初始化方法: 无论视图是通过XML还是代码创建,通常都需要执行一些共同的初始化操作(如设置画笔、加载图片、初始化内部状态等)。将这些共同的逻辑封装在一个私有的init()方法中,并从所有相关的构造函数中调用它。

    public class MyCustomView extends View {      public MyCustomView(Context context) {         super(context);         init(context, null); // 调用统一的初始化方法     }      public MyCustomView(Context context, @Nullable AttributeSet attrs) {         super(context, attrs);         init(context, attrs); // 调用统一的初始化方法     }      // 可以根据需要添加更多构造函数,并都调用init     public MyCustomView(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {         super(context, attrs, defStyleAttr);         init(context, attrs); // 传递attrs以处理样式     }      private void init(Context context, @Nullable AttributeSet attrs) {         // 所有构造函数共享的初始化逻辑         System.out.println("MyCustomView: Common init logic executed.");          // 处理自定义属性 (仅当attrs不为null时)         if (attrs != null) {             // 例如:TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.MyCustomView);             // ...             // a.recycle();         }     } }
  3. 调试技巧: 当不确定构造函数何时被调用时,可以在构造函数内部设置断点。当程序执行到断点时,检查调用(Call Stack)窗口。调用堆栈会清晰地显示是哪个方法(例如LayoutInflater.createViewFromTag或你的Activity.onCreate)触发了该构造函数的调用。

总结

自定义视图构造函数被多次调用,通常是因为它同时被XML布局膨胀机制和代码显式实例化所触发。理解这两种不同的实例化途径是解决问题的关键。通过采用统一的init()方法来处理共同的初始化逻辑,并根据视图的预期使用方式(XML或代码)选择合适的构造函数,可以有效避免重复初始化问题,确保自定义视图的行为符合预期,并提升代码的健壮性与可维护性。

© 版权声明
THE END
喜欢就支持一下吧
点赞13 分享