轻量级标签注解库Jet比 ButterKnife 更简单功能更丰富

Jet注解库

官网： gybin02.github.io/Jet/

使用注解功能 来实现去除一些重复的模板代码，让Code更简单；
包含 Butterknife功能； 自动初始化Activity里面的Field；

命名来自 WordPress的Jetpack;

• 每个注解做的事情要很简单，符合kiss原则, keep it simple and stupid
• 现阶段很轻量级： 放心使用才 :heart_eyes: :heart_eyes:
• :smile: 如果喜欢，请给个Star:smile:

已完成

注解名称	作用	备注
@JFindView	等同于findViewById	支持Activity和Fragment,ViewHolder等
@JFindViewOnClick	findViewById（） 和 view.setOnClickListener(this)	Activity需要实现View.onClickListener接口
@JOnClick	注解在方法上，view.setOnClickListener	支持单个View和多个View，方法参数带有View view,则可以返回点击的View
@JIntent	用于自动解析Intent 里面的值	也可以从Bundle里自动取值
@JImplement	用于解耦，根据接口值调用实现
@JProvider	配合JImplement
@JPermission	6.0上自动申请权限；	支持多个权限
@JPermissionGrant	权限授权成功	配合 @JPermission ,非必须
@JPermissionDeny	权限授权失败	配合 @JPermission ，非必须

@JFindView([ViewId])

运行时注入，支持 自动初始化 View的findViewById

@JFindViewOnClick([ViewId])

支持 自动初始化View的 findViewById 和 onClick

Activity 需要 implement View.OnClickListener.class;

@JIntent([key])

使用Annotation Runtime实现getIntent功能来读取Intent里面的数据；

支持自动从 Intent 里取值，比如Intent.getStringExtra([String]) 等

支持的参数类型具体如下（包括默认值）

           return intent.getStringExtra(value)

           return intent.getCharExtra(value, '\0');

            return intent.getByteExtra(value, (byte) 0);

            return intent.getShortExtra(value, (short) 0);

            return intent.getIntExtra(value, 0);

            return intent.getLongExtra(value, 0);


            return intent.getFloatExtra(value, 0);


            return intent.getDoubleExtra(value, 0);

            return intent.getBooleanExtra(value, false);

            return intent.getSerializableExtra(value);

            return intent.getBundleExtra(value);

            return intent.getStringArrayExtra(value);

            return intent.getStringExtra(value);复制代码

使用例子

    //原来代码 
   public class DemoActivity implement View.OnClickListener{
     //Android 代码

      private String testString;
      private boolean testBoolean;
      private int testInt;
      private long testLong;

      private Button btnHello;
      private Button btn_test;


      //用值
      public void onCreate(Bundle savedInstanceState){
         super.onCreate(savedInstanceState);
        //Intent 初始化
          Intent intent = getIntent();
          testString = intent.getIntExtra("testString", 0);
          testInt = intent.getStringExtra("testInt");
          testBoolean = intent.getStirngExtra("testBoolean");
          testLong = intent.getBooleanExtra("testLong");

         //View  初始化
        btnHello= findViewById(R.layout.btn_hello);
        btn_test= findViewById(R.layout.btn_test);
        btnHello.setOnClick(this);
        Log.i("old",test1);
      }

      public void onClick(View v){
          int id= v.getId;
          if(id== hello_world){
            //TODO Do Something
          }
      }

      //TODO:如果需要取参的越来越多，代码会是什么样的呢？逻辑上是不是很复杂复制代码

使用 Jet注解实现：

    @JIntent("testString")
    private String testString;
    @JIntent("testBoolean")
    private boolean testBoolean;
    @JIntent("testInt")
    private int testInt;
    @JIntent("testLong")
    private long testLong;

    @JFindViwOnClick("btn_hello")
    private Button btnHello;
    @JFindViw("btn_test")
    private Button btn_test;

      //用值
      public void onCreate(Bundle savedInstanceState){
        super.onCreate(savedInstanceState);
        //初始化后，既可使用所有属性
        Jet.init(this);
      }

      public void onClick(View v){
          int id= v.getId;
          if(id== hello_world){
            //TODO Do Something
          }
      }复制代码

例子2

   //支持从Bundle里面直接取值；
    @JIntent("param1")
    private String mParam1;
    @JIntent("param2")
    private String mParam2;


    public static BlankFragment newInstance(Activity activity) {
        BlankFragment fragment = new BlankFragment();
        Bundle args = new Bundle();
        String param1 = "Hello ";
        String param2 = "world";
        args.putString(ARG_PARAM1, param1);
        args.putString(ARG_PARAM2, param2);
        fragment.setArguments(args);
        return fragment;
    }

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        Jet.bind(this, getArguments());复制代码

其他类的绑定（NON-ACTIVITY BINDING ）

You can also perform binding on arbitrary objects by supplying your own view root.

你可以任意绑定对象，只要你提供一个View Root;

public class FancyFragment extends Fragment {
  @JFindView(R.id.button1) Button button1;
  @JFindView(R.id.button2) Button button2;

  @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
    View view = inflater.inflate(R.layout.fancy_fragment, container, false);
    Jet.bind(this, view);
    // TODO Use fields...
    return view;
  }
}复制代码

Another use is simplifying the view holder pattern inside of a list adapter.

public class MyAdapter extends BaseAdapter {
  @Override public View getView(int position, View view, ViewGroup parent) {
    ViewHolder holder;
    if (view != null) {
      holder = (ViewHolder) view.getTag();
    } else {
      view = inflater.inflate(R.layout.whatever, parent, false);
      holder = new ViewHolder(view);
      view.setTag(holder);
    }

    holder.name.setText("John Doe");
    // etc...

    return view;
  }

  static class ViewHolder {
    @JFindView(R.id.title)
    TextView name;
    @JFindView(R.id.job_title) 
    TextView jobTitle;

    public ViewHolder(View view) {
      Jet.bind(this, view);
    }
  }
}
You can see this implementation in action in the provided sample.复制代码

@JImplement :heart_eyes: :heart_eyes: :heart_eyes:

• 实现根据接口类注释，自动调用实现类功能，代码解耦必备；替代直接写反射
• 更可以用于跨module功能调用，但是不仅于此 更多功能可以自己发掘；

使用方法：

接口类

@JImplement("com.seeker.tony.myapplication.proxy.TestImpl")
public interface ITest {
    public void  test();

    public String getValue();
}复制代码

实现类：

//@JProvider，用来标识实现类，避免被混淆，避免被认为是无功能调用被删掉；
@JProvider
public class TestImpl {

    private static final String TAG = "TestImpl";

    public void test() {
        Log.d(TAG, "test Method  invoke");
    }

    public String getValue() {
        String str = "HelloWorld";
        Log.d(TAG, "getValue Method  invoke： " + str);
        return str;
    }
}复制代码

调用方法：

                    ITest iTest = JetProxy.getInstance().create(ITest.class);
                    iTest.test();
                    iTest.getValue();复制代码

JPermission 6.0上自动申请权限；

//@JPermission(all = {Manifest.permission.CAMERA,Manifest.permission.WRITE_EXTERNAL_STORAGE,Manifest.permission.READ_CONTACTS})
@JPermission(Manifest.permission.CAMERA)
public class MainActivity extends AppCompatActivity

    ....

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        PermissionsManager.getInstance().notifyPermissionsChange(permissions, grantResults);
    }
    //权限通过回调 （可以不用调用）
    @JPermissionGrant
    private void onGrand() {
        Toast.makeText(MainActivity.this, "onGrant Success", Toast.LENGTH_SHORT)
             .show();
    }
    //权限拒绝回调（可以不用调用）
    @JPermissionDeny
    private void onDeny(String permisson) {
        Toast.makeText(MainActivity.this, "onDenied Success: "+permisson, Toast.LENGTH_SHORT)
             .show();
    }复制代码

Download

dependencies {
   //内部使用
   //compile 'com.meiyou.framework:jet:0.0.10-SNAPSHOT'
   compile 'com.meiyou.framework:jet:1.5.0'

}复制代码

Snapshots of the development version are available in Sonatype's snapshots repository.

混淆配置：

#使用JetProxy功能需要避免混淆
-keepattributes *Annotation*
-keep class * extends java.lang.annotation.Annotation { *; }
-keep @com.meiyou.jet.annotation.JImplement class * { *; }
-keep @com.meiyou.jet.annotation.JProvider class * { *; }复制代码

待实现，

待实现区域，列了一些我想到的通用功能， 但是项目里面肯定还存在很多通用的功能；欢迎 各位 提Issue，让项目更强大；

• @JTrycatch

安全调用方法：给方法 自动加入 try Catch ;

已经实现，使用AspectJ来实现。具体参考： Jet-AOP 工程；

• 类似Retrofit的 RestFull 请求库实现；
  @GET， @Post; @Head等；
  github.com/Tamicer/Tam…

常见问题

• 性能测试；O(1)方法，20个@JFindView 属性初始化，耗时50ms;比直接FindViewById多花5ms,性能损耗基本可以忽略；
• 有些注解实现 需要使用AOP技术；可以参考[Jet-AOP]（git.meiyou.im/Android/Jet…) 工程；

交流群：

QQ群：547612870