ButterKnife Android程序员的一大利器

2024-02-24 05:58

本文主要是介绍ButterKnife Android程序员的一大利器,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

注:最近才看到的这个类库,来自于jakewharton大神的力作,安卓里面的视图注入库

另小弟水平有限,翻译的不好,还请多多指正

首先是地址(托管在github上):http://jakewharton.github.io/butterknife/

进去后首先看到的是关于用法的讲解,翻译部分正式开始(通俗且精简化,建议对照着看)!

简介:

程序员都是懒惰的,不想写一大堆像下面这样的代码
view source print ?
01. class ExampleActivity extends Activity {
02. TextView title;
03. TextView subtitle;
04. TextView footer;
05.  
06. @Override public void onCreate(Bundle savedInstanceState) {
07. super.onCreate(savedInstanceState);
08. setContentView(R.layout.simple_activity);
09. title = (TextView) findViewById(R.id.title);
10. subtitle = (TextView) findViewById(R.id.subtitle);
11. footer = (TextView) findViewById(R.id.footer);
12.  
13. // TODO Use views...
14. }
15. }

这样很不好,因此我们就找到了一个方法,使用魔法一般的注解,来浓缩代码,就像下面这样
view source print ?
01. class ExampleActivity extends Activity {
02. @Magic(R.id.title) TextView title;
03. @Magic(R.id.subtitle) TextView subtitle;
04. @Magic(R.id.footer) TextView footer;
05.  
06. @Override public void onCreate(Bundle savedInstanceState) {
07. super.onCreate(savedInstanceState);
08. setContentView(R.layout.simple_activity);
09. // TODO Use "injected" views...
10. }
11. }

然而,这样虽然看起来很酷,很Magic,不过还是会带来严重的运行时的问题
于是,我们就利用javac 编译器中一大利器来生成前面例子中的findViewById的引用,并且继续保持代码的精简 ,继续看下面的代码
view source print ?
01. class ExampleActivity extends Activity {
02. @InjectView(R.id.title) TextView title;
03. @InjectView(R.id.subtitle) TextView subtitle;
04. @InjectView(R.id.footer) TextView footer;
05.  
06. @Override public void onCreate(Bundle savedInstanceState) {
07. super.onCreate(savedInstanceState);
08. setContentView(R.layout.simple_activity);
09. ButterKnife.inject(this);
10. // TODO Use "injected" views...
11. }
12. }

在原本Magic的地方使用inject 方法来替代,下面是该方法的一段代表(This method delegates to generated code 不明),可以看并debug
view source print ?
1. public void inject(ExampleActivity activity) {
2. activity.subtitle = (android.widget.TextView) activity.findViewById(2130968578);
3. activity.footer = (android.widget.TextView) activity.findViewById(2130968579);
4. activity.title = (android.widget.TextView) activity.findViewById(2130968577);
5. }

(这段可以忽略吗?貌似翻译不对,看不太懂)有些人称这个为视图注入,并加到了传统的依赖注入框架中,也许在术语上有错误,不过或许有一点作用.......


NON-ACTIVITY INJECTION

我们可以对任意的View对象使用注入,当然了,需要提供view root的对象
view source print ?
01. public class FancyFragment extends Fragment {
02. @InjectView(R.id.button1) Button button1;
03. @InjectView(R.id.button2) Button button2;
04.  
05. @Override View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
06. View view = inflater.inflate(R.layout.fancy_fragment, container, false);
07. ButterKnife.inject(this, view);
08. // TODO Use "injected" views...
09. return view;
10. }
11. }

另外一个用处是简化list adapter中的View Holder模式,这个例子可以在提供的sample中看到
view source print ?
01. public class MyAdapter extends BaseAdapter {
02. @Override public View getView(int position, View view, ViewGroup parent) {
03. ViewHolder holder;
04. if (view != null) {
05. holder = (ViewHolder) view.getTag();
06. else {
07. view = inflater.inflate(R.layout.whatever, parent, false);
08. holder = new ViewHolder(view);
09. view.setTag(holder);
10. }
11.  
12. holder.name.setText("John Doe");
13. // etc...
14.  
15. return convertView;
16. }
17.  
18. static class ViewHolder {
19. @InjectView(R.id.title) TextView name;
20. @InjectView(R.id.job_title) TextView jobTitle;
21.  
22. public ViewHolder(View view) {
23. ButterKnife.inject(this, view);
24. }
25. }
26. }

其他的API(这段真心建议看一下原版)
-当使用activity作为view root节点时,你如果使用的是像MVC设计模式,你可以将控制器注入,使用它的acitvity并通过ButterKnife.inject(this, activity)方法 -将一个子View对象字段注入,使用ButterKnife.inject(this)(在前面例子的onCreate方法中就是,不懂的可以参考这个),如果你在一个layout 的构造方法中使用<merge>标签并且,inflate了一个自定义View,立即调用这个方法。或者,如果是从xml中inflate自定义view, 可以使用这个方法---onLayoutInflated() 

CLICK LISTENER INJECTION


Click listener 也可以被注入
view source print ?
1. @OnClick(R.id.submit)
2. public void submit() {
3. // TODO submit data to server...
4. }

也可以加一个view对象,特定的类型会被自动转换
view source print ?
1. @OnClick(R.id.submit)
2. public void sayHi(Button button) {
3. button.setText("Hello!");
4. }

一次指定多个id,同时加事件
view source print ?
1. @OnClick({ R.id.door1, R.id.door2, R.id.door3 })
2. public void pickDoor(DoorView door) {
3. if (door.hasPrizeBehind()) {
4. Toast.makeText(this"You win!", LENGTH_SHORT).show();
5. else {
6. Toast.makeText(this"Try again", LENGTH_SHORT).show();
7. }
8. }

INJECTION RESET

Fragments 有比Avtivity更多的生命周期 ,如果需要在onCreateView中注入一个fragment,在onDestroyView中销毁它
Butter Knife 有一个reset 方法自动实现它
view source print ?
01. public class FancyFragment extends Fragment {
02. @InjectView(R.id.button1) Button button1;
03. @InjectView(R.id.button2) Button button2;
04.  
05. @Override View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
06. View view = inflater.inflate(R.layout.fancy_fragment, container, false);
07. ButterKnife.inject(this, view);
08. // TODO Use "injected" views...
09. return view;
10. }
11.  
12. @Override void onDestroyView() {
13. super.onDestroyView();
14. ButterKnife.reset(this);
15. }
16. }


OPTIONAL INJECTIONS

默认情况下 @InjectView和@OnClick都是必须加上的,如果当前对象不存在,就会抛出一个异常
为了压制这个异常,可以在变量或者方法上加入一下注解
view source print ?
1. @Optional @InjectView(R.id.might_not_be_there) TextView mightNotBeThere;
2.  
3. @Optional @OnClick(R.id.maybe_missing) void onMaybeMissingClicked() {
4. // TODO ...
5. }

BONUS


这段看不太懂,大意估计是除了以上注入方法之外还有一种,类型会自动转换,需要静态导入ButterKnife.findById
view source print ?
1. View view = LayoutInflater.from(context).inflate(R.layout.thing, null);
2. TextView firstName = ButterKnife.findById(view, R.id.first_name);
3. TextView lastName = ButterKnife.findById(view, R.id.last_name);
4. ImageView photo = ButterKnife.findById(view, R.id.photo);


Download:当前版本 4.0.1


具体:http://github.com/JakeWharton/butterknife
jar包:http://repo1.maven.org/maven2/com/jakewharton/butterknife/4.0.1/butterknife-4.0.1.jar


Maven配置:如果你是用maven开发的童鞋,请自觉加上如下依赖

view source print ?
1. <dependency>
2. <groupId>com.jakewharton</groupId>
3. <artifactId>butterknife</artifactId>
4. <version>4.0.1</version>
5. </dependency>



IDE的配置


  • IntelliJ IDEA — 如果你是用外部工具管理工程 (如 Maven pom.xml) 应该能正常工作, 不然就看看这个 http://jakewharton.github.io/butterknife/ide-idea.html
    • Eclipse — http://jakewharton.github.io/butterknife/ide-eclipse.html 

      PROGUARD

      使用注入会导致ProGuard 认为变量未被使用,因此,需要在ProGuard 中加入如下字段

      view source print ?
      1. -dontwarn butterknife.internal.**
      2. -keep class **$$ViewInjector { *; }
      3. -keepnames class * { @butterknife.InjectView *;}


      Having Happy Coding!

这篇关于ButterKnife Android程序员的一大利器的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/741152

相关文章

Android学习总结之Java和kotlin区别超详细分析

《Android学习总结之Java和kotlin区别超详细分析》Java和Kotlin都是用于Android开发的编程语言,它们各自具有独特的特点和优势,:本文主要介绍Android学习总结之Ja... 目录一、空安全机制真题 1:Kotlin 如何解决 Java 的 NullPointerExceptio

JVisualVM之Java性能监控与调优利器详解

《JVisualVM之Java性能监控与调优利器详解》本文将详细介绍JVisualVM的使用方法,并结合实际案例展示如何利用它进行性能调优,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全... 目录1. JVisualVM简介2. JVisualVM的安装与启动2.1 启动JVisualVM2

Android NDK版本迭代与FFmpeg交叉编译完全指南

《AndroidNDK版本迭代与FFmpeg交叉编译完全指南》在Android开发中,使用NDK进行原生代码开发是一项常见需求,特别是当我们需要集成FFmpeg这样的多媒体处理库时,本文将深入分析A... 目录一、android NDK版本迭代分界线二、FFmpeg交叉编译关键注意事项三、完整编译脚本示例四

Android与iOS设备MAC地址生成原理及Java实现详解

《Android与iOS设备MAC地址生成原理及Java实现详解》在无线网络通信中,MAC(MediaAccessControl)地址是设备的唯一网络标识符,本文主要介绍了Android与iOS设备M... 目录引言1. MAC地址基础1.1 MAC地址的组成1.2 MAC地址的分类2. android与I

Android 实现一个隐私弹窗功能

《Android实现一个隐私弹窗功能》:本文主要介绍Android实现一个隐私弹窗功能,本文通过实例代码给大家介绍的非常详细,感兴趣的朋友一起看看吧... 效果图如下:1. 设置同意、退出、点击用户协议、点击隐私协议的函数参数2. 《用户协议》、《隐私政策》设置成可点击的,且颜色要区分出来res/l

Android实现一键录屏功能(附源码)

《Android实现一键录屏功能(附源码)》在Android5.0及以上版本,系统提供了MediaProjectionAPI,允许应用在用户授权下录制屏幕内容并输出到视频文件,所以本文将基于此实现一个... 目录一、项目介绍二、相关技术与原理三、系统权限与用户授权四、项目架构与流程五、环境配置与依赖六、完整

Android 12解决push framework.jar无法开机的方法小结

《Android12解决pushframework.jar无法开机的方法小结》:本文主要介绍在Android12中解决pushframework.jar无法开机的方法,包括编译指令、框架层和s... 目录1. android 编译指令1.1 framework层的编译指令1.2 替换framework.ja

Android开发环境配置避坑指南

《Android开发环境配置避坑指南》本文主要介绍了Android开发环境配置过程中遇到的问题及解决方案,包括VPN注意事项、工具版本统一、Gerrit邮箱配置、Git拉取和提交代码、MergevsR... 目录网络环境:VPN 注意事项工具版本统一:android Studio & JDKGerrit的邮

Android实现定时任务的几种方式汇总(附源码)

《Android实现定时任务的几种方式汇总(附源码)》在Android应用中,定时任务(ScheduledTask)的需求几乎无处不在:从定时刷新数据、定时备份、定时推送通知,到夜间静默下载、循环执行... 目录一、项目介绍1. 背景与意义二、相关基础知识与系统约束三、方案一:Handler.postDel

Java注解之超越Javadoc的元数据利器详解

《Java注解之超越Javadoc的元数据利器详解》本文将深入探讨Java注解的定义、类型、内置注解、自定义注解、保留策略、实际应用场景及最佳实践,无论是初学者还是资深开发者,都能通过本文了解如何利用... 目录什么是注解?注解的类型内置注编程解自定义注解注解的保留策略实际用例最佳实践总结在 Java 编程