深入理解Android View的构造函数

原文:A deep dive into Android View constructors 

我经常看到关于Android View构造方法的困惑。为什么有四个构造方法?每个参数是做什么的?我需要实现哪个构造方法?

tl;dr

如果你想要一个直接而实际的建议,这里有几个不错的指导原则:

  • 在代码中创建View的时候用View(Context)。

  • 当从XML inflate view的时候重写View(Context, AttributeSet)。

  • 剩余的知识其实可以忽略,因为你很可能并不需要。

对于那些仍和我一样想继续探究的人-让我们深入下去吧。

构造方法参数

构造函数参数最多有四个。简单总结下:

  • Context - View中随处都会用到。

  • AttributeSet - XML属性(当从XML inflate的时候)。

  • int defStyleAttr - 应用到View的默认风格(定义在主题中)。

  • int defStyleResource - 如果没有使用defStyleAttr,应用到View的默认风格

除了Context,其它的参数只是用来通过XML属性配置View的初始状态(从布局,style以及theme中)。

属性

让我们从如何定义XML属性的开始讨论。这里是一个XML中最基本的ImageView:

<ImageView  
  android:layout_width="wrap_content"
  android:layout_height="wrap_content"
  android:src="@drawable/icon"
  />

你有没有想过这里的layout_width, layout_height 以及 src是从哪里来的?它们可不是凭空产生的;实际上是通过把这些属性明确的声明为系统需要处理的东西。比如,src就是在这里定义的:

<declare-styleable name="ImageView">  
  <!-- Sets a drawable as the content of this ImageView. -->
  <attr name="src" format="reference|color" />
  <!-- ...snipped for brevity... -->
</declare-styleable>

每个declare-styleable产生一个R.styleable.[name],外加每个属性的R.styleable.[name]_[attribute] 。比如,上面的代码产生R.styleable.ImageView和R.styleable.ImageView_src。

这些资源是什么东西呢?R.styleable.[name]是所有属性资源的数组,系统使用它来查找属性值。每个R.styleable.[name]_[attribute]只不过是这个数组的索引罢了,所以你可以一次性取出所有属性,然后分别查询每个的值。

如果你把它想象成一个cursor,R.styleable.[name]就可以看成是一个待查找的column列表,而R.styleable.[name]_[attribute]就是一个column的索引。

关于declare-styleable的更多信息,这里是关于自定义declare-styleable的 官方文档

AttributeSet

上面写的XML是以一个AttributeSet的形式传递给View的。

通常你不直接使用AttributeSet。而是使用[Theme.obtainStyledAttributes()](https://developer.android.com/reference/android/content/res/Resources.Theme.html#obtainStyledAttributes(android.util.AttributeSet, int[], int, int))。这是因为原始的属性通常需要引用和应用样式。比如,如果你在XML中定义了style=@style/MyStyle,这个方法先获取MyStyle,然后把它的属性混合进去。最终obtainStyledAttributes() 返回一个TypedArray,你可以用它来获取属性值。

这个过程简化之后就像这样:

public ImageView(Context context, AttributeSet attrs) {  
  TypedArray ta = context.obtainStyledAttributes(attrs, R.styleable.ImageView, 0, 0);
  Drawable src = ta.getDrawable(R.styleable.ImageView_src);
  setImageDrawable(src);
  ta.recycle();
}

这里我们向obtainStyledAttributes()传递了两个参数。第一个参数是AttributeSet attrs,即XML中的属性,表示从layout文件中直接为这个View添加的属性的集合(一种是直接使用android:layout_width="wrap_content"这种直接指定,还有一种是通过style="@style/somestyle"指定。)。第二个参数是R.styleable.ImageView数组,它告诉这个方法我们想取哪个属性的值,这里表示要获取ImageView属性的值。

当获得了TypedArray之后,我们就可以获取单个属性了。我们需要使用 R.styleable.ImageView_src来正确索引数组中的属性。

通常我们可以一次获取多个属性。实际上,真实ImageView的实现要比上面的复杂多了。

你可以在 官方文档中阅读更多关于获取属性的知识。

Theme 属性

旁注:AttributeSet并不是obtainStyledAttributes() 获取属性值的唯一地方。属性也可以存在于主题中。但是它在View inflate的过程中扮演着不重要的角色,因为主题一般不会设置src这样的属性。但是如果你使用obtainStyledAttributes() 获取主题属性的话它就有作用了(这也是很有用的知识,不过不在本文的讨论范围)。

Default Style Attribute

你可能注意到了obtainStyledAttributes()的最后两个参数我使用的值为0。实际上它们是两个资源引用-defStyleAttr 和 defStyleRes。这里我将关注的是第一个。

defStyleAttr是obtainStyledAttributes()最令人困惑的参数。根据官网:

当前主题中包含了为TypedArray提供默认值的样式资源的引用的一个属性。

用普通的语言表述,其实它就是一个为某个类型的View定义一个基本样式的方法。比如,如果你想一次性修改app中所有TextView,你可以在主题中设置textViewStyle。如果不存在这个东西的话,你就需要手动为每个TextView定义样式了。

让我们介绍一下它实际是如何工作的,以TextView为例。

首先,他是一个属性(这里是,R.attr.textViewStyle)。这里是安卓系统定义textViewStyle的地方:

<resources>  
  <declare-styleable name="Theme">
    <!-- ...snip... -->
    <!-- Default TextView style. -->
    <attr name="textViewStyle" format="reference" />
    <!-- ...etc... -->
  </declare-styleable>
</resource>

又一次的,我们使用了declare-styleable,但是这次是用来定义存在于theme中的属性。这里我们说textViewStyle是一个reference- 即,它的值只是一个资源的引用,这里,它应该是一个指向style的引用。

接下来,我们必须在当前主题设置textViewStyle。默认的Android主题如下:

<resources>  
  <style name="Theme">
    <!-- ...snip... -->
    <item name="textViewStyle">@style/Widget.TextView</item>
    <!-- ...etc... -->
  </style>
</resource>

然后需要为Application或者Activity设置这个主题,通常是通过manifest设置:

<activity  
  android:name=".MyActivity"
  android:theme="@style/Theme"
  />

现在我们就可以在obtainStyledAttributes()里使用它了:

TypedArray ta = theme.obtainStyledAttributes(attrs, R.styleable.TextView, R.attr.textViewStyle, 0);

最终的效果是,任何没有在AttributeSet中定义的属性都将用textViewStyle引用的样式填充。

除非你在写核心源码,否则你并不需要知道这些实现的细节。它的存在主要是Android framework为了让你可以在主题里为不同的View定义基础样式。

Default Style Resource

defStyleRes就要比defStyleAttr简单多了。它只是一个style资源(@style/Widget.TextView)。不需要间接的通过theme。

只有在defStyleAttris没有定义的情况下,才会应用style中的defStyleRes(设置为0,或者没有在主题中设置)。

优先级

我们现在有了一些列通过obtainStyledAttributes()获取属性值的方式。这里是它们的优先级,从高到低:

  1. 定义在AttributeSet中的值

  2. 定义在AttributeSet中的style资源(比如:style=@style/blah)

  3. defStyleAttr指定的默认样式。

  4. defStyleResource指定的默认样式资源(如果没有defStyleAttr)

  5. 主题中的值

换句话说,任何直接在XML中设置的属性都将首先被使用。但是如果你没有设置,这些属性也可以从其它地方获取。

View constructors

本文不是应该讨论View的构造函数的吗?

总共有四个构造函数,依次增加一个参数:

View(Context)
View(Context, AttributeSet)
View(Context, AttributeSet, defStyleAttr)
View(Context, AttributeSet, defStyleAttr, defStyleRes)

注意:最后一个是在API 21添加的。因此除非你的minSdkVersion为21,否则不要使用它。(如果你想使用defStyleRes只需自己调用obtainStyledAttributes()就好了)

它们是串联的,因此如果你调用了一个,所有的都会被调用(通过super)。串联还意味着你只需重写你需要的构造函数。一般来说,你只需实现前两个(一个用于代码,一个用于XML inflation)。

我一般这样设置我的自定义View:

SomeView(Context context) {  
  this(context, null);
}
SomeView(Context context, AttributeSet attrs) {  
  // Call super() so that the View sets itself up properly
  super(context, attrs);
  // ...Setup View and handle all attributes here...
}

只需要这个两个参数的构造方法你就能随意的使用obtainStyledAttributes()了。实现默认样式的一个简便方法是直接提供defStyleRes给它。那样你就不需要忍受defStyleAttr的痛苦了(其实它更多时候是一个framework工具,app中通常不需要)。

总之,希望本文不仅帮助你理解了View的构造方法,还帮你了解属性是如何在View构造期间获取的!