详解Android XML中引用自定义内部类view的四个why_Android

今天碰到了在XML中应用以内部类形式定义的自定义view,结果遇到了一些坑。虽然通过看了一些前辈写的文章解决了这个问题,但是我看到的几篇都没有完整说清楚why,于是决定做这个总结。

使用自定义内部类view的规则

本文主要是总结why,所以先把XML布局文件中引用内部类的自定义view的做法摆出来,有四点:

1.自定义的类必须是静态类;

2.使用view作为XML文件中的tag,注意,v是小写字母,小写字母v,小写字母v;

3.添加class属性,注意,没有带android:命名空间的,表明该自定义view的完整路径,且外部类与内部类之间用美元“$”连接,而不是“.”,注意,要美元“$”,不要“.”;

4.自定义的view至少应该含有带有Context, AttributeSet这两个参数的构造函数

布局加载流程主要代码  

首先,XML布局文件的加载都是使用LayoutInflater来实现的,通过这篇文章的分析,我们知道实际使用的LayoutInflater类是其子类PhoneLayoutInflater,然后通过这篇文章的分析,我们知道view的真正实例化的关键入口函数是createViewFromTag这个函数,然后通过createView来真正实例化view,下面便是该流程用到的关键函数的主要代码:

final Object[] mConstructorArgs = new Object[2];

  static final Class<?>[] mConstructorSignature = new Class[] {
      Context.class, AttributeSet.class};

  //...

  /**
   * Creates a view from a tag name using the supplied attribute set.
   * <p>
   * <strong>Note:</strong> Default visibility so the BridgeInflater can
   * override it.
   *
   * @param parent the parent view, used to inflate layout params
   * @param name the name of the XML tag used to define the view
   * @param context the inflation context for the view, typically the
   *        {@code parent} or base layout inflater context
   * @param attrs the attribute set for the XML tag used to define the view
   * @param ignoreThemeAttr {@code true} to ignore the {@code android:theme}
   *            attribute (if set) for the view being inflated,
   *            {@code false} otherwise
   */
  View createViewFromTag(View parent, String name, Context context, AttributeSet attrs,
      boolean ignoreThemeAttr) {
    //**关键1**//
    if (name.equals("view")) {
      name = attrs.getAttributeValue(null, "class");
    }

    // Apply a theme wrapper, if allowed and one is specified.
    if (!ignoreThemeAttr) {
      final TypedArray ta = context.obtainStyledAttributes(attrs, ATTRS_THEME);
      final int themeResId = ta.getResourceId(0, 0);
      if (themeResId != 0) {
        context = new ContextThemeWrapper(context, themeResId);
      }
      ta.recycle();
    }

    if (name.equals(TAG_1995)) {
      // Let's party like it's 1995!
      return new BlinkLayout(context, attrs);
    }

    try {
      View view;
      if (mFactory2 != null) {
        view = mFactory2.onCreateView(parent, name, context, attrs);
      } else if (mFactory != null) {
        view = mFactory.onCreateView(name, context, attrs);
      } else {
        view = null;
      }

      if (view == null && mPrivateFactory != null) {
        view = mPrivateFactory.onCreateView(parent, name, context, attrs);
      }

      if (view == null) {
        final Object lastContext = mConstructorArgs[0];
        mConstructorArgs[0] = context;
        try {
          if (-1 == name.indexOf('.')) {
            //**关键2**//
            view = onCreateView(parent, name, attrs);
          } else {
            //**关键3**//
            view = createView(name, null, attrs);
          }
        } finally {
          mConstructorArgs[0] = lastContext;
        }
      }

      return view;
    }
    //后面都是catch,省略
  }

  protected View onCreateView(View parent, String name, AttributeSet attrs)
      throws ClassNotFoundException {
    return onCreateView(name, attrs);
  }

  protected View onCreateView(String name, AttributeSet attrs)
      throws ClassNotFoundException {
    return createView(name, "android.view.", attrs);
  }

  /**
   * Low-level function for instantiating a view by name. This attempts to
   * instantiate a view class of the given <var>name</var> found in this
   * LayoutInflater's ClassLoader.
   *
   * @param name The full name of the class to be instantiated.
   * @param attrs The XML attributes supplied for this instance.
   *
   * @return View The newly instantiated view, or null.
   */
  public final View createView(String name, String prefix, AttributeSet attrs)
      throws ClassNotFoundException, InflateException {
    Constructor<? extends View> constructor = sConstructorMap.get(name);
    Class<? extends View> clazz = null;

    try {
      Trace.traceBegin(Trace.TRACE_TAG_VIEW, name);

      if (constructor == null) {
        //**关键4**//
        // Class not found in the cache, see if it's real, and try to add it
        clazz = mContext.getClassLoader().loadClass(
            prefix != null ? (prefix + name) : name).asSubclass(View.class);

        if (mFilter != null && clazz != null) {
          boolean allowed = mFilter.onLoadClass(clazz);
          if (!allowed) {
            failNotAllowed(name, prefix, attrs);
          }
        }
        constructor = clazz.getConstructor(mConstructorSignature);
        constructor.setAccessible(true);
        sConstructorMap.put(name, constructor);
      } else {
        // If we have a filter, apply it to cached constructor
        if (mFilter != null) {
          // Have we seen this name before?
          Boolean allowedState = mFilterMap.get(name);
          if (allowedState == null) {
            // New class -- remember whether it is allowed
            clazz = mContext.getClassLoader().loadClass(
                prefix != null ? (prefix + name) : name).asSubclass(View.class);

            boolean allowed = clazz != null && mFilter.onLoadClass(clazz);
            mFilterMap.put(name, allowed);
            if (!allowed) {
              failNotAllowed(name, prefix, attrs);
            }
          } else if (allowedState.equals(Boolean.FALSE)) {
            failNotAllowed(name, prefix, attrs);
          }
        }
      }

      Object[] args = mConstructorArgs;
      args[1] = attrs;
      //**关键5**//
      final View view = constructor.newInstance(args);
      if (view instanceof ViewStub) {
        // Use the same context when inflating ViewStub later.
        final ViewStub viewStub = (ViewStub) view;
        viewStub.setLayoutInflater(cloneInContext((Context) args[0]));
      }
      return view;

    }
    //后面都是catch以及finally处理,省略
  }

PhoneLayoutInflater中用到的主要代码:

public class PhoneLayoutInflater extends LayoutInflater {
  private static final String[] sClassPrefixList = {
    "android.widget.",
    "android.webkit.",
    "android.app."
  };
  //......

  /** Override onCreateView to instantiate names that correspond to the
    widgets known to the Widget factory. If we don't find a match,
    call through to our super class.
  */
  @Override protected View onCreateView(String name, AttributeSet attrs) throws ClassNotFoundException {
    //**关键6**//
    for (String prefix : sClassPrefixList) {
      try {
        View view = createView(name, prefix, attrs);
        if (view != null) {
          return view;
        }
      } catch (ClassNotFoundException e) {
        // In this case we want to let the base class take a crack
        // at it.
      }
    } 

    return super.onCreateView(name, attrs);
  } 

  //.........
}

WHY

对于任何一个XML中的元素,首先都是从“1”处开始(“1”即表示代码中标注“关键1”的位置,后同),下面便跟着代码的流程来一遍:

1.“1”处进行名字是否为“view”的判断,那么这里会有两种情况,我们先假设使用“view”

2.由于在“1”满足条件,所以name被赋值为class属性的值,比如“com.willhua.view.MyView”或者“com.willhua.view.MyClass$MyView”。其实这里也是要使用“view”来定义,而不是其他名字来定义的原因。

3.根据name的值,name中含有‘.'符号,于是代码走到“3”处,调用createView,且prefix参数为空

4.来到“4”处,prefix为空,于是loadClass函数的参数即为name,即在a.2中说的class属性的值。我们知道,传给loadClass的参数是想要加载的类的类名,而在Java中,内部类的类名表示都是在外部类类名的后面用符号“$”连接内部类类名而来,于是文章开头提到的第3点的答案也就是在这里了。补充一下,为什么是来到“4”,而不是对应的else块中呢?类第一次被加载的时候,构造器肯定是还不存在的,也就是if条件肯定是成立的。然后等到后面再次实例化的时候,就来到了else块中,而在else快中只是根据mFilter做一些是否可以加载该view的判断而已,并没有从本质上影响view的加载流程。

5.在“4”处还有一个很重要的地方,那就是constructor = class.getConstructor(mConstructorSignature)这句。首先,在代码开头已经给出了mConstructorSignature的定义:

static final Class<?>[] mConstructorSignature = new Class[] {Context.class, AttributeSet.class};

在Oracle的文档上找到getConstructor函数的说明:

Returns a Constructor object that reflects the specified public constructor of the class represented by this Class object. The parameterTypes parameter is an array of Class objects that identify the constructor's formal parameter types, in declared order. If this Class object represents an inner class declared in a non-static context, the formal parameter types include the explicit enclosing instance as the first parameter.

The constructor to reflect is the public constructor of the class represented by this Class object whose formal parameter types match those specified by parameterTypes.

于是,这里其实解答了我们两个问题:(1)getConstructor返回的构造函数是其参数与传getConstructor的参数完全匹配的那一个,如果没有就抛出NoSuchMethodException异常。于是我们就知道,必须要有一个与mConstructorSignature完全匹配,就需要Context和AttributeSet两个参数的构造函数;(2)要是该类表示的是非静态的内部类,那么应该把一个外部类实例作为第一个参数传入。而我们的代码中传入的mConstructorSignature是不含有外部类实例的,因此我们必须把我们自定义的内部类view声明为静态的才不会报错。有些同学的解释只是说到了非静态内部类需要由一个外部类实例来引用,但我想那万一系统在加载的时候它会自动构造一个外部类实例呢?于是这里给了否定的答案。

6. 拿到了类信息clazz之后,代码来到了“5”,在这里注意下mConstructorArgs,在贴出的代码最前面有给出它的定义,为Object[2],并且,通过源码中发现,mConstructorArgs[0]被赋值为创建LayoutInflater时传入的context。于是我们就知道         在“5”这里,传给newInstance的参数为Context和AttributeSet。然后在Oracl的文档上关于newInstance的说明中也有一句:If the constructor's declaring class is an inner class in a non-static context, the first argument to the constructor needs to be the enclosing instance; 我们这里也没有传入外部类实例,也就是说对于静态内部类也会报错。这里同样验证了自定义了的内部类view必须声明为静态类这个问题。

至此,我们已经在假设使用“view”,再次强调是小写‘v',作为元素名称的情况,推出了要在XML中应用自定义的内部类view必须满足的三点条件,即在class属性中使用“$”连接外部类和内部类,必须有一个接受Context和AttributeSet参数的构造函数,必须声明为静态的这三个要求。

而如果不使用“view”标签的形式来使用自定义内部类view,那么在写XML的时候我们发现,只能使用比如<com.willhua.MyClass.MyView />的形式,而不能使用<com.willhua.MyClass$MyView />的形式,这样AndroidStudio会报“Tag start is not close”的错。显然,如果我们使用<com.willhua.MyClass.MyView />的形式,那么在“关键4”处将会调用loadClass("com.willhua.MyClass.MyView"),这样在前面也已经分析过,是不符合Java中关于内部类的完整命名规则的,将会报错。有些人估计会粗心写成大写的V的形式,即<View class="com.willhua.MyClass$MyView" ... />的形式,这样将会在运行时报“wrong type”错,因为这样本质上定义的是一个android.view.View,而你在代码中却以为是定义的com.willhua.MyClass$MyView。

在标识的“2”处,该出的调用流程为onCreateView(parent, name, attrs)——>onCreateView(name, attrs)——>createView(name, "android.view.", attrs),在前面提到过,我们真正使用的的LayoutInflater是PhoneLayoutInflater,而在PhoneLayoutInflater对这个onCreateView(name, attrs)函数是进行了重写的,在PhoneLayoutInflater的onCreateView函数中,即“6”处,该函数通过在name前面尝试分别使用三个前缀:"android.widget.","android.webkit.","android.app."来调用createView,若都没有找到则调用父类的onCreateView来尝试添加"android.view."前缀来加载该view。所以,这也是为什么我们可以比如直接使用<Button />, <View />的原因,因为这些常用都是包含在这四个包名里的。

总结

至此,开篇提到的四个要求我们都已经找到其原因了。其实,整个流程走下来,我们发现,要使定义的元素被正确的加载到相关的类,有三种途径:

1.只使用简单类名,即<ViewName />的形式。对于“android.widget”, "android.webkit", "android.app"以及"android.view"这四个包内的类,可以直接使用这样的形式,因为在代码中会自动给加上相应的包名来构成完整的路径,而对于的其他的类,则不行,因为ViewName加上这四个包名构成的完整类名都无法找到该类。

2.使用<"完整类名" />的形式,比如<com.willhua.MyView />或者<android.widget.Button />的形式来使用,对于任何的非内部类view,这样都是可以的。但是对于内部类不行,因为这样的类名不符合Java中关于内部类完整类名的定义规则。如果<com.willhua.MyClass$MyView />的形式能够通过编译话,肯定是能正确Inflate该MyView的,可惜在编写的时候就会提示错。

3.使用<view class="完整类名" />的形式。这个是最通用的,所有的类都可以这么干,但是前提是“完整类名”写对,比如前面提到的内部类使用"$"符号连接。

为了搞清楚加载内部类view的问题,结果对整个加载流程都有了一定了解,感觉能说多若干个why了,还是收获挺大的。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。

以上是小编为您精心准备的的内容,在的博客、问答、公众号、人物、课程等栏目也有的相关内容,欢迎继续使用右上角搜索按钮进行搜索xml
, 自定义view
自定义view加载xml
java内部类详解、内部类引用外部变量、java匿名内部类详解、java内部类引用外部类、java 引用内部类,以便于您获取更多的相关知识。

时间: 2024-09-17 22:06:13

详解Android XML中引用自定义内部类view的四个why_Android的相关文章

详解Android XML中引用自定义内部类view的四个why

今天碰到了在XML中应用以内部类形式定义的自定义view,结果遇到了一些坑.虽然通过看了一些前辈写的文章解决了这个问题,但是我看到的几篇都没有完整说清楚why,于是决定做这个总结. 使用自定义内部类view的规则 本文主要是总结why,所以先把XML布局文件中引用内部类的自定义view的做法摆出来,有四点: 1.自定义的类必须是静态类: 2.使用view作为XML文件中的tag,注意,v是小写字母,小写字母v,小写字母v: 3.添加class属性,注意,没有带android:命名空间的,表明该自

详解Android TableLayout中stretchColumns、shrinkColumns的用法

详解Android 中TableLayout中stretchColumns.shrinkColumns的用法 android:stretchColumns="1" android:shrinkColumns="1"这两个属性是TableLayout所特有的,也是这两个属性影响了子对象的布局. 表格布局是按照行列来组织子视图的布局.表格布局包含一系列的Tabrow对象,用于定义行(也可以使用其它子对象).表格布局不为它的行.列和单元格显示表格线.每个行可以包含个以上(

详解Android应用中DialogFragment的基本用法_Android

DialogFragment的基本用法 1. 创建DialogFragment public class DialogA extends DialogFragment implements DialogInterface.OnClickListener { @Override public Dialog onCreateDialog(Bundle savedInstanceState) { AlertDialog.Builder builder = new AlertDialog.Builder

详解Android应用中使用TabHost组件进行布局的基本方法_Android

TabHost布局文件 我们先来了解一下布局文件的基本内容:1. 根标签及id 设置Android自带id : XML布局文件中, 可以使用 标签设置, 其中的id 需要引用 android的自带id : android:id=@android:id/tabhost ; getHost()获取前提 : 设置了该id之后, 在Activity界面可以使用 getHost(), 获取这个TabHost 视图对象; 示例 : 复制代码 代码如下: <tabhost android:id="@an

详解Android应用中ListView列表选项栏的编写方法_Android

根据列表的适配器类型,列表分为三种,ArrayAdapter,SimpleAdapter和SimpleCursorAdapter,这三种适配器的使用大家可学习下官网上面的使用或者自行百度谷歌,一堆DEMO!!!其中以ArrayAdapter最为简单,只能展示一行字.SimpleAdapter有最好的扩充性,可以自定义出各种效果.SimpleCursorAdapter可以认为是SimpleAdapter对数据库的简单结合,可以方便的把数据库的内容以列表的形式展示出来. 系统要绘制ListView了

详解Android开发中Fragment的使用_java

前言学习Java和Android将近一年的时间了,期间的成果应该就是独立完成了一个Android客户端,并且保证了其在主线版本的稳定性.期间遇到了很多坑,也跟着师兄学到了很多Android知识.但是人总是要拥抱变化,不能让自己太安逸,虽然有不舍,但是我已经证明了自己的学习能力,下一步就是开始做Rom Porting了.这里总结一下之前项目中用到最多的Fragment. Fragment简介Fragment可以理解成Activity中用户界面的一个行为或者一部分,它必须被嵌套在Activity中.

详解Android应用中preference首选项的编写方法_Android

最近学习android时发现,很多书上都介绍了preference首选项这个东西,但是大部分的书都是直接上来讲怎么用,对其的用途和来历都是只字不提,笔者本人对于这种做法是非常鄙视的. 这里,我将对其进行一点简单的描述,可能说法并不严谨,但是至少能帮助你理解到底什么事首选项: 首选项这个词是preference翻译过来的,至于它到底是什么,我用一句话概括下:preference是一种android为我们提供的方便的对数据进行存储的工具. 分析这句话: 首先,我们明确,preference是和数据存

详解Android开发中Activity的四种launchMode_Android

Activity栈主要用于管理Activity的切换.当使用Intent跳转至某个目标Activity,需要根据目标Activity的加载模式来加载. Activity一共有以下四种launchMode: 1.standard:默认,每次使用Intent跳转到目标Activity时都创建一个新的实例.坏处是每次进入都要创建新的实例,执行OnCreate方法. 2.singleTop:如果要跳转的目标Activity正好在task的顶部(说明当前肯定不在目标task里,例如我在微信首页,然后想使用

详解Android App中使用VideoView来实现视频播放的方法_Android

通过VideoView播放视频的步骤: 1.在界面布局文件中定义VideoView组件,或在程序中创建VideoView组件 2.调用VideoView的如下两个方法来加载指定的视频 (1)setVidePath(String path):加载path文件代表的视频 (2)setVideoURI(Uri uri):加载uri所对应的视频 3.调用VideoView的start().stop().psuse()方法来控制视频的播放 VideoView通过与MediaController类结合使用,