Android注解编程的第一步---模仿ButterKnife的ViewBinder机制

原文:http://www.cnblogs.com/wenjiang/p/4298143.html 

  ButterKnife的使用极大方便了Android程序员的开发,实际上,我们可以自己模仿一下实现。

    首先就是要了解Java注解的使用。

    我们首先要声明一个@interface,也就是注解类:

@Target(ElementType.FIELD)//表示用在字段s上
@Retention(RetentionPolicy.RUNTIME)//表示在生命周期是运行时
public @interface ViewBinder {
    int id() default -1;
    String method() default "";
    String type() default "";
}

     @interface是用于自定义注解的,它里面定义的方法的声明不能有参数,也不能抛出异常,并且方法的返回值被限制为简单类型、String、Class、emnus、@interface,和这些类型的数组。

    注解@Target也是用来修饰注解的元注解,它有一个属性ElementType也是枚举类型,值为:ANNOTATION_TYPE,CONSTRUCTOR ,FIELD,LOCAL_VARIABLE,METHOD,PACKAGE,PARAMETER和TYPE,如@Target(ElementType.METHOD) 修饰的注解表示该注解只能用来修饰在方法上。

     @RetentionRetention注解表示需要在什么级别保存该注释信息,用于描述注解的生命周期,它有一个RetentionPolicy类型的value,是一个枚举类型,它有以下的几个值:

     1.用@Retention(RetentionPolicy.SOURCE)修饰的注解,指定注解只保留在源文件当中,编译成类文件后就把注解去掉;
2.用@Retention(RetentionPolicy.CLASS)修饰的注解,指定注解只保留在源文件和编译后的class 文件中,当jvm加载类时就把注解去掉;
3.用@Retention(RetentionPolicy.RUNTIME )修饰的注解,指定注解可以保留在jvm中,这样就可以使用反射获取信息了。

     默认是RUNTIME,这样我们才能在运行的时候通过反射获取并做对应的逻辑处理。

     接下来我们就是利用反射来获取注解的属性以及做相应的处理:

public class ViewBinderParser implements Parsable {
    private ViewBinderParser() {
    }
    public static void inject(Object object) {
        ViewBinderParser parser = new ViewBinderParser();
        try {
            parser.parse(object);
        } catch (Exception e) {
            LogUtil.e(e.toString());
        }
    }
    @Override
    public void parse(final Object object) throws Exception {
        View view = null;
        final Class<?> clazz = object.getClass();
        Field\[\] fields = clazz.getDeclaredFields();//获得Activity中声明的字段
        for (Field field : fields) {
            // 查看这个字段是否有我们自定义的注解类标志的
            if (field.isAnnotationPresent(ViewBinder.class)) {
                ViewBinder inject = field.getAnnotation(ViewBinder.class);
                int id = inject.id();
                if (id < 0) {
                    throw new Exception("id must not be null");
                }
                if (id > 0) {
                    field.setAccessible(true);
                    if (object instanceof View) {
                        view = ((View) object).findViewById(id);
                    } else if (object instanceof Activity) {
                        view = ((Activity) object).findViewById(id);
                    }
                    field.set(object, view);//给我们要找的字段设置值
                    String methodName = inject.method();
                    if (!methodName.equals("")) {
                        OnEventListener listener = new OnEventListener(object);
                        String type = inject.type();
                        if (type.equals("")) {
                            throw new Exception("Please input the type of Method,such as 'method=OnClick'");
                        }
                        if (type.equals("OnClick")) {
                            listener.setOnClick(id, methodName);
                        }
                    }
                }
            }
        }
    }
}

     我们通过inject将添加注解的对象传进来,然后进入注解属性的解析方法中。

     利用反射获取所有声明的字段,然后再利用isAnnotationPresent方法查看该字段是否有添加的注解类型,再从该字段中获取注解,通过定义 好的方法获取到相应的属性值。我们这里获取到对应的View的id,然后在这里进行View的初始化,以及事件的绑定。

     完成事件的绑定还需要一个类:

public class OnEventListener {
    private Object object;
    public OnEventListener(Object object) {
        this.object = object;
    }
    public void setOnClick(int id, final String methodName) {
        View view = null;
        if (object instanceof View) {
            view = ((View) object).findViewById(id);
        } else if (object instanceof Activity) {
            view = ((Activity) object).findViewById(id);
        }
        view.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                MethodModel methodModel = new MethodModel();
                Class clazz = methodModel.getClass();
                try {
                    Method method = clazz.getMethod(methodName, new Class\[\]{});
                    method.invoke(methodModel, new Object\[\]{});
                } catch (NoSuchMethodException e) {
                    e.printStackTrace();
                } catch (InvocationTargetException e) {
                    e.printStackTrace();
                } catch (IllegalAccessException e) {
                    e.printStackTrace();
                }
            }
        });
    }
}

       目前只是实现了点击事件的绑定。

       接着我们就可以这样使用我们自定义的注解了: 

public class MainActivity extends ActionBarActivity {
    @ViewBinder(id = R.id.cet_receiver)
    protected CustomEditText cetReceiver;
    @ViewBinder(id = R.id.cet_cc)
    protected CustomEditText cetCC;
    @ViewBinder(id = R.id.cet_content)
    protected CustomEditText cetContent;
    @ViewBinder(id = R.id.cet_subject)
    protected CustomEditText cetSubject;
    @ViewBinder(id = R.id.iv_receiver)
    protected ImageView ivReceiver;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ViewBinderParser.inject(this);
        ivReceiver.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                cetCC.setVisibility(View.VISIBLE);
            }
        });
    }
}

     注解的使用可以让我们的代码更加简洁,但前提是,这种前提是否有必要。