【Android XML】Android XML 转 Java Code 系列之 Selector(2)

今天我们要把drawable下的selector的XML文件转换成Java代码。(打包进jar,不依赖apk)

在转换工具中的代码为:

https://github.com/SickWorm/AndroidXMLToJava/blob/master/src/com/excelsecu/androidx2j/SelectorTranslator.java

 

Selector是什么?就是给Button等控件使用的一个根据状态改变控件颜色或背景的状态器,它一般放在drawable目录下。

Selector分两种,一种是指定color和alpha的状态器,XML形式如下:

 <selector xmlns:android="http://schemas.android.com/apk/res/android">
   <item android:state_focused="true" android:color="@color/testcolor1"/>
   <item android:state_pressed="true" android:state_enabled="false" android:color="@color/testcolor2" />
   <item android:state_enabled="false" android:color="@color/testcolor3" />
   <item android:color="@color/testcolor5" android:alpha="0.5" />
 </selector>

另一种是指定drawable的状态器,XML形式如下:

 <selector xmlns:android="http://schemas.android.com/apk/res/android">
   <item android:state_focused="true" android:drawable="@drawable/testdrawable1"/>
   <item android:state_pressed="true" android:state_enabled="false" android:drawable="@drawable/testdrawable2" />
   <item android:state_enabled="false" android:drawable="@drawable/testdrawable3" />
   <item android:drawable="@color/testdrawable5"/>
 </selector>

 

知道了XML格式,我们如何去找到对应实现的类呢?这时候就应该上万能的http://developer.android.com/(科学上网,我用红杏我自豪)寻找selector。点击第一个链接:

http://developer.android.com/guide/topics/resources/color-list-resource.html

在这个文档上我们可以明显看到第一个XML对应的类就是ColorStateList(里面介绍的第一个就是)。而第二个XML,我一开始找了很久都没找到,直到我点开文档最下方的State List Drawable,发现赫然写着:

StateListDrawable(原谅我激动的心情)

点进这个类看到对应的XML布局,确定这就是第二个XML布局啦。

 

找到了对应的类,接下来要开始正式的工作了。我们先从ColorStateList下手。

所谓转换,其实就是构造一个对应类的对象,然后把XML的属性对应的内容用Java代码的方式“填充”进这个对象中便完成了。在使用到这个XML的地方,也用对应的设置方法把该成员设置进去就可以了。

那首先找到ColorStateL的构造函数:ColorStateList(int[][] states, int[] colors);

一开始便难倒我了。。这诡异的两个int数组是shenmegui?看看人家控件家族(Button, TextView等等)只需要一个context就可以构造了。根据名字猜测,这两个数组估计是对应的各种状态和颜色。那我们接下去认证这个猜想。

说时迟那时快,我发现了另一个函数:createFromXml(Resources r, XmlPullParser parser);

该函数就是给我们用Java代码动态解析XML用的方法。里面肯定有对XML各参数解析的过程,赶紧看一下源代码(作为一个开源操作系统的程序猿,一定要下一份源码)。

    /**
     * Create a ColorStateList from an XML document, given a set of {@link Resources}.
     */
    public static ColorStateList createFromXml(Resources r, XmlPullParser parser)
            throws XmlPullParserException, IOException {
        final AttributeSet attrs = Xml.asAttributeSet(parser);

        int type;
        while ((type=parser.next()) != XmlPullParser.START_TAG
                   && type != XmlPullParser.END_DOCUMENT) {
        }

        if (type != XmlPullParser.START_TAG) {
            throw new XmlPullParserException("No start tag found");
        }

        return createFromXmlInner(r, parser, attrs);
    }

我们跟着这个XmlPullparser走,因为他里面藏着XML信息。结果发现他调用了createFromXmlInner。继续跟,发现调用了colorStateList.inflate。看inflate就知道是解析函数啦!那我们来详细分析这个inflate:

(下面是我分析inflate函数时的笔记,应该算比较详细了)

    /**
     * Fill in this object based on the contents of an XML "selector" element.
     */
    //解析XmlPullparser, (剧透)最终得到 mColors 和 mStateSpecs, 这两个参数用于构造ColorStateList
    private void inflate(Resources r, XmlPullParser parser, AttributeSet attrs)
            throws XmlPullParserException, IOException {
        int type;

        final int innerDepth = parser.getDepth()+1;
        int depth;

        int[][] stateSpecList = ArrayUtils.newUnpaddedArray(int[].class, 20);
        int[] colorList = new int[stateSpecList.length];
        int listSize = 0;

        while ((type=parser.next()) != XmlPullParser.END_DOCUMENT
               && ((depth=parser.getDepth()) >= innerDepth
                   || type != XmlPullParser.END_TAG)) {
            if (type != XmlPullParser.START_TAG) {
                continue;
            }
            //只解析item项
            if (depth > innerDepth || !parser.getName().equals("item")) {
                continue;
            }

            int alphaRes = 0;
            float alpha = 1.0f;
            int colorRes = 0;
            int color = 0xffff0000;
            boolean haveColor = false;

            int i;
            int j = 0;
            final int numAttrs = attrs.getAttributeCount();
            int[] stateSpec = new int[numAttrs];
            //对item项的各个属性做分析
            for (i = 0; i < numAttrs; i++) {
                //获取属性名对应的id, 如果没有则返回0, 其实就是把字符匹配的工作交出去, 提高代码灵活性
                final int stateResId = attrs.getAttributeNameResource(i);
                if (stateResId == 0) break;
                //如果是alpha属性则赋值alpha. alpha是一个透明度的值
                if (stateResId == com.android.internal.R.attr.alpha) {
                    //获取属性值对应的资源id, 就是我们熟悉的R.java里面的东西啦, 比如R.drawable.button1 = 0x7f040001这样的值
                    alphaRes = attrs.getAttributeResourceValue(i, 0);
                    //如果不是资源id, 是常数, 则直接翻译
                    if (alphaRes == 0) {
                        alpha = attrs.getAttributeFloatValue(i, 1.0f);
                    }
                //如果是color属性, 也做类似的处理. color就是对应指定状态下的背景或颜色
                } else if (stateResId == com.android.internal.R.attr.color) {
                    colorRes = attrs.getAttributeResourceValue(i, 0);
                    if (colorRes == 0) {
                        color = attrs.getAttributeIntValue(i, color);
                        haveColor = true;
                    }
                //不是上面两个条件的话, 只能是设置状态的布尔值了, 如android:state_pressed="true"
                } else {
                    //此时会把属性名对应的id存进数组, 并根据是否设置正负, 这样selector的各种状态条件就构建出来了
                    //具体的id值是多少, 是R.attr中的属性值吗(如state_pressed就是android.R.attr.state_pressed)?我们下面再仔细分析
                    stateSpec[j++] = attrs.getAttributeBooleanValue(i, false)
                            ? stateResId : -stateResId;
                }
            }
            //这个trimStateSet的用处是重新指定此int数组的长度, 也就是j, stateSpec初始化的时候是使用了属性数量作为长度, 在这里会被重新设置, 以节省空间.
            //因为上一条语句会做j++, 所以永远空出一个位置给下一个属性添加
            //数组很小, 所以不会很费时间, 牺牲一点性能换取简单的写法也是可取的. 如果是我我会在循环开始的时候先找出有多少个设置状态的属性.
            stateSpec = StateSet.trimStateSet(stateSpec, j);

            //这里对刚才获取的资源值做获取, 并做一些结构完整性检查, 如果一个item连color都没有, 那真是坑爹了
            if (colorRes != 0) {
                color = r.getColor(colorRes);
            } else if (!haveColor) {
                throw new XmlPullParserException(
                        parser.getPositionDescription()
                        + ": <item> tag requires a 'android:color' attribute.");
            }

            //alpha就可有可无了, 如果没有, 默认是1 (初始化的值float alpha = 1.0f;), 也就是100%不透明
            if (alphaRes != 0) {
                alpha = r.getFloat(alphaRes);
            }

            //稍微转换一下, 把color算出来
            // Apply alpha modulation.
            //算出alpha. Color.alpha(color)看源码, 就是 color >>> 24. 这个运算是算出color的alpha值 (int color 长度为4个字节, 3个字节分别代表RGB, 还有一个最高位字节的alpha喔)
            //比如#AAFFFFFF的alpha值就是AA. 但要注意的是#FFFFFF的alpha值是FF, 因为Android的Color.parse会自动给没填写alpha的值的最高位填上FF(具体看源代码). 
       //如果你使用int形式, 如0xaaaaaa, alpha值就是0, 这样写是会全透明的. 用int形式一定要写上alpha值, 如全黑是0xff000000.
//所以一个item真正的alpha值是由color自带的alpha和android:alpha的值共同决定的 //MathUtils.constrain这个函数不用看都能知道是百分比缩放的函数, 比如0.5, 0, 255, 的出来的就是(255 - 0) * 0.5 final int alphaMod = MathUtils.constrain((int) (Color.alpha(color) * alpha), 0, 255); //再把这个0~255的值塞回color的最高字节里面去 (折腾啊) color = (color & 0xFFFFFF) | (alphaMod << 24); //如果只有这个android:color这个属性, 没有表示状态的属性, 就认为他是默认色 if (listSize == 0 || stateSpec.length == 0) { mDefaultColor = color; } //把color 和 stateSpec塞进数组里面去. 比用ArrayList要节省点空间. 看来Android在节省内存方面上很卖力啊 //append能猜到又是重新定义数组长度这种事情, 不同的是会加一个数组进去 colorList = GrowingArrayUtils.append(colorList, listSize, color); stateSpecList = GrowingArrayUtils.append(stateSpecList, listSize, stateSpec); listSize++; } //所有的item都跑完了, 可以把结果存给全局变量mColors 和 mStateSpecs了. mColors = new int[listSize]; mStateSpecs = new int[listSize][]; System.arraycopy(colorList, 0, mColors, 0, listSize); System.arraycopy(stateSpecList, 0, mStateSpecs, 0, listSize); }

我们现在来看下ColorStateList的构造函数:

    public ColorStateList(int[][] states, int[] colors) {
        mStateSpecs = states;
        mColors = colors;

        if (states.length > 0) {
            mDefaultColor = colors[0];

            for (int i = 0; i < states.length; i++) {
                if (states[i].length == 0) {
                    mDefaultColor = colors[i];
                }
            }
        }
    }

inflate得到的两个最终产物 mStateSpecs 和 mColors 就是我们想要的构造函数!我们只要照葫芦画瓢,照inflate画数组,就可以把这两个数组写出来了。ColorStateList被降服了!

喔,忘了还有一个遗留问题:

穿山甲到底说了什么?

stateResId到底是什么?

再看分析:

//首先这个id是从AttributeSet中得到的,AttributeSet是一个interface,实现它的是XmlPullAttributes(为什么?因为搜遍了源码就他一个...),但可惜的是XmlPullAttributes没有实现getAttributeNameResource()
//继续找儿子。BridgeXmlPullAttributes 继承了XmlPullAttributes,而且他实现了getAttributeNameResource()
    BridgeXmlPullAttributes extends XmlPullAttributes
        //This methods must return com.android.internal.R.attr.<name> matching the name of the attribute.
        BridgeXmlPullAttributes.getAttributeNameResource(int index)
        ->    Bridge.getResourceId(ResourceType.ATTR, name);
        ->->        Integer v = Bridge.getResourceId(ResourceType.ATTR, name);
        ->->->        sRevRMap.get(type);
                if (v != null) {
                    return v.intValue();
                }
//这里写的有点乱,“->”的意思是深入一层,同样的梯度表示在同一个函数中,也就是说getAttributeNameResource调用了Bridge.getResourceId调用了sRevRMap.get,最后Bridge.getResourceId返回了sRevRMap.get的int值。
//这个sRevRMap是在哪初始化的呢?搜源码发现在init中()
    init(...) {
    ...
            Class<?> r = com.android.internal.R.class;      
            //这里这里!init函数把这个class里面的所有子类声明的值put进去sRevRMap了。
            //这个com.android.internal.R.class是在Android ROM编译的时候生成的一个类,就类似我们写应用时自动生成的R.java,里面全部是声明的值。
            //而我们getResourceId的时候传的type是ResourceType.ATTR。所以就是ATTR的id值。这个值在http://developer.android.com/reference/android/R.attr.html中有详细列表。
            //实际上我们使用只需要给对应的属性名加上前缀android.R.attr即可。如android:state_pressed对应android.R.attr.state_pressed。
            //至于为什么初始化的时候是com.android.internal.R,使用的时候是android.R,应该是涉及到Android系统编译的东西,我没有深入了解。

            for (Class<?> inner : r.getDeclaredClasses()) {
                String resTypeName = inner.getSimpleName();
                ResourceType resType = ResourceType.getEnum(resTypeName);
                if (resType != null) {
                    Map<String, Integer> fullMap = new HashMap<String, Integer>();
                    sRevRMap.put(resType, fullMap);

                    for (Field f : inner.getDeclaredFields()) {
                        // only process static final fields. Since the final attribute may have
                        // been altered by layoutlib_create, we only check static
                        int modifiers = f.getModifiers();
                        if (Modifier.isStatic(modifiers)) {
                            Class<?> type = f.getType();
                            if (type.isArray() && type.getComponentType() == int.class) {
                                // if the object is an int[] we put it in sRArrayMap using an IntArray
                                // wrapper that properly implements equals and hashcode for the array
                                // objects, as required by the map contract.
                                sRArrayMap.put(new IntArray((int[]) f.get(null)), f.getName());
                            } else if (type == int.class) {
                                Integer value = (Integer) f.get(null);
                                sRMap.put(value, Pair.of(resType, f.getName()));
                                fullMap.put(f.getName(), value);
                            } else {
                                assert false;
                            }
                        }
                    }
                }
            }
            ...
        }            

这里“com.android.internal.R,使用的时候是android.R”,说服力可能不足,但这个表http://developer.android.com/reference/android/R.attr.html应该是可靠的,Google不会做两个表出来吧。。

是com.android.internal.R,使用的时候是android.R,

 

接下来还有一个

StateListDrawable(怎么还是这么大)

这个东西就简单的多了,构造器不需要参数,直接new StateListDrawable()即可。添加状态使用addState(int[] stateSet, Drawable drawable)。stateSet和ColorStateList的规则是一样的,drawable就是XML文件里面指定的drawable资源。这里就不多赘述了。

 

注意:

虽然ColorStateList对应的selector XML放在drawable文件夹里面,但他本身是一个自定义类!父类是Object!和

StateListDrawable(啊啊啊啊吓死我了)

不一样,这货父类是Drawable,可以用getDrawable()获取。如果你用getDrawable(R.drawable.colorStateList)获取对应资源的话是会崩溃的。为什么要提到这点呢?因为转换工具(详细介绍看第一篇文章)有一个仿照getResources()专门管理资源的类(叫AXMLResources),因为这个ColorStateList的特殊原因,就要另外用函数处理了。

 

版权所有,转载请注明出处:

http://www.cnblogs.com/sickworm/p/4245210.html 

 
posted @ 2015-01-23 22:50  sickworm  阅读(2437)  评论(0编辑  收藏  举报