Android注解式綁定控件
Android開發(fā)中,有一個讓人又愛又恨的方法叫findViewById(int);我想如果你是一民Android開發(fā)者,必然知道這個方法,讓我們來看一下KJFrameForAndroid框架是如何解決這個問題的。
KJFrameForAndroid框架項目地址:https://github.com/kymjs/KJFrameForAndroid。
為什么說findViewById(int);讓人又愛又恨呢?想必大家也是很有感觸。
寫一個布局,用Java代碼寫和用xml文件寫,完成速度完全是無法比擬的。xml布局太方便了。
同樣的,想獲取一個控件的對象,如果你是使用的xml布局文件寫的布局,那么你必須調(diào)用findViewById()這個方法。
- TextView t = (TextView) findViewById(R.id.x);
這是我們最常見的 獲取xml布局中一個textview對象的過程。
那么問題就來了,這特么奇葩的方法名也太長了吧?。?!好吧,其實人家名字起的也沒有錯,要描述清楚這函數(shù)的含義,也必須這么多個字母。
可是你丫的返回一個View讓我用的時候還得強轉(zhuǎn),這也太麻煩了吧。我一行代碼總共也就100列(Eclipse默認),縮進八格(方法寫在類里面,語句寫在方法里面),
就算像上面的例子textView對象只有一個字母,id也只有一個字母,這一個初始化也要占我54列了。要是變量名再長點,縮進層次再深點,這一個初始化就兩行了。
一個界面至少也有四個控件吧,這么復(fù)雜的初始化,太坑爹了。
有問題總會有對應(yīng)的解決辦法,下面我就向大家介紹一下使用注解解決這種麻煩。
了解注解:
從jdk1.5開始,Java提供了注解的功能,允許開發(fā)者定義和使用自己的注解類型,該功能由一個定義注解類型的語法和描述一個注解聲明的語法,讀取注解的API,一個使用注解修飾的class文件和一個注解處理工具組成。
首先,你需要接受一個關(guān)鍵字@interface ,噢,它可不是接口定義關(guān)鍵字,更不是OC里面的@interface關(guān)鍵字,是Java中表示聲明一個注解類的關(guān)鍵字。
使用@interface 表示我們已經(jīng)繼承了java.lang.annotation.Annotation類,這是一個注解的基類接口,就好像Object類,現(xiàn)在你只需要知道它的存在就行了。
還有一條規(guī)定:在定義注解時,不能繼承其他的注解或接口。
那么,這就是最簡單的一個注解類
- public @interface MyAnnotation {
- }
然而通常在使用時我們都會給這個注解類加上兩個注解:
@Target(ElementType.FIELD)、@Retention(RetentionPolicy.RUNTIME)
ElementType、RetentionPolicy是兩個枚舉類,ElementType.FIELD表示我們需要注解的是一個字段,以下是摘自JDK1.6文檔中的介紹:
使用注解:
以下為KJFrameForAndroid框架中綁定控件注解部分的定義與使用
- @Target(ElementType.FIELD)
- @Retention(RetentionPolicy.RUNTIME)
- public @interface BindView {
- public int id();
- public boolean click() default false;
- }
- @BindView(id = R.id.x, click = true)
- private TextView t;
我們可以看到,除了明顯減少了代碼量,還使得代碼結(jié)構(gòu)更加清晰。
其中,定義部分的id() 表示注解接受一個int類型的數(shù)據(jù)作為id所對應(yīng)的值(就如使用中的id = R.id.xxx);
同理,定義部分的click表示接受一個Boolean類型的數(shù)據(jù)作為click對應(yīng)的值,還可以設(shè)置一個默認值使用default修飾;
處理注解:
我們已經(jīng)知道了注解怎么定義和使用,接下來就應(yīng)該知道怎么處理了。
上面已經(jīng)說了,bindview注解可以接受一個int類型的值和一個Boolean類型的值,那么這兩個值接受了以后如何獲取呢?
其實獲取的方式很簡單就是通過一個BindView類型的對象,調(diào)用這個對象來自聲明中定義的兩個方法——>id()或click()方法。
現(xiàn)在就有一個問題了,注解類型是不能直接new對象的,那么這個BindView對象從哪里來呢?
這時就需要用到Java的反射機制。我們知道,每一個繼承自O(shè)bject類的類都會繼承一個getClass()方法,下面看一下這個方法的原型:
- /**
- * Returns the unique instance of {@link Class} that represents this
- * object's class. Note that {@code getClass()} is a special case in that it
- * actually returns {@code Class<? extends Foo>} where {@code Foo} is the
- * erasure of the type of the expression {@code getClass()} was called upon.
- * <p>
- * As an example, the following code actually compiles, although one might
- * think it shouldn't:
- * <p>
- * <pre>{@code
- * List<Integer> l = new ArrayList<Integer>();
- * Class<? extends List> c = l.getClass();}</pre>
- *
- * @return this object's {@code Class} instance.
- */
- public final native Class<?> getClass();
是一個native方法,根據(jù)注釋我們知道,這個方法返回的是該類的Class對象,同時也是該類的二進制對象。
Class中有一個方法叫g(shù)etDeclaredFields(),是用來返回這個類的全部字段,返回類型是Field[]
通過Field對象的getAnnotation(Class<?>)方法,我們可以獲取到任何一個Class的對象,通過getAnnotation(Class<?>),我們就可以獲取到BindView的對象了。
例如
- Field[] fields = currentClass.getClass().getDeclaredFields();
- for(int i = 0; i < fields.length; i++){
- BindView bindView = field.getAnnotation(BindView.class);
- int viewId = bindView.id(); //這是我們傳的id
- boolean clickLis = bindView.click(); //這是我們傳的click
- }
在Android項目中應(yīng)用:
至此,我們已經(jīng)了解了注解,并且知道怎么使用,怎么處理注解了,現(xiàn)在只剩下最后一個問題:在項目中使用。
很簡單,傳一個Activity對象,調(diào)用findViewById()不就行了。
于是,我們可以這樣
activity.findViewById( bindView.id() );
最后在我們的Activity中調(diào)用這個函數(shù)就OK了。
以下是Android應(yīng)用框架KJFrameForAndroid中使用注解綁定控件的核心代碼:
- /**
- * @param currentClass
- * 當(dāng)前類,一般為Activity或Fragment
- * @param sourceView
- * 待綁定控件的直接或間接父控件
- */
- public static void initBindView(Object currentClass, View sourceView) {
- // 通過反射獲取到全部屬性,反射的字段可能是一個類(靜態(tài))字段或?qū)嵗侄?/span>
- Field[] fields = currentClass.getClass().getDeclaredFields();
- if (fields != null && fields.length > 0) {
- for (Field field : fields) {
- // 返回BindView類型的注解內(nèi)容
- BindView bindView = field.getAnnotation(BindView.class);
- if (bindView != null) {
- int viewId = bindView.id();
- boolean clickLis = bindView.click();
- try {
- field.setAccessible(true);
- if (clickLis) {
- sourceView.findViewById(viewId).setOnClickListener(
- (OnClickListener) currentClass);
- }
- // 將currentClass的field賦值為sourceView.findViewById(viewId)
- field.set(currentClass, sourceView.findViewById(viewId));
- } catch (Exception e) {
- e.printStackTrace();
- }
- }
- }
- }
- }
其實安卓中的注解式綁定控件(也是所謂的IOC控制反轉(zhuǎn)在安卓中的一種應(yīng)用)其實本質(zhì)的使用就是Java基礎(chǔ)中反射的使用。值得一提的是,反射執(zhí)行的效率是很低的
如果不是必要,應(yīng)當(dāng)盡量減少反射的使用,因為它會大大拖累你應(yīng)用的執(zhí)行效率。
順帶一提:我一直很排斥注解,因為類反射的效率太低了?,F(xiàn)在有很多安卓應(yīng)用開發(fā)框架,比如KJFrameForAndroid, xUtils, afinal, thinkAndroid,這些框架都是使用反射來起到注解綁定控件。
更有的框架甚至是一切東西都使用注解去完成,我只能說注解便捷,但請慎用。
本文鏈接:http://my.oschina.net/kymjs/blog/305882