### FragmentKey 一款解决使用 newInstance 创建 fragment 定义 key 传值问题的 apt 框架

更新日志：

v1.0.0 2020.1.17

• 第一次发布

使用前:

   public TFragment newInstance(String username, String password, int age) {
        TFragment tFragment = new TFragment();
//传值
        Bundle bundle = new Bundle();
        bundle.putString("username", username);
        bundle.putString("password", password);
        bundle.putInt("age", age);
        tFragment.setArguments(bundle);
        return tFragment;
    }
    
    @Override
    public void onAttach(Context context) {
        super.onAttach(context);
        //使用
        Bundle arguments = getArguments();
        mUsername = arguments.getString("username");
        mPassword = arguments.getString("password");
        age = arguments.getInt("age");
    }

使用后:

    //定义
    @Inject
    public String mUsername;
    @Inject(name = "password1")
    public String mPassword;
    @Inject
    public int age;
    //传值
     TFragment2 tFragment = new TFragment2Key().send("姓名", "密码", 10);
      
    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        //使用
        Log.d(TAG, mUsername);
        Log.d(TAG, mPassword);
        Log.d(TAG, String.valueOf(age));
        return super.onCreateView(inflater, container, savedInstanceState);
    }

可以看出此框架简化了传值过程,避免了使用 key 来传递数据带来的麻烦.

Installation：

1.project.gradle

    buildscript {
    repositories {
        google()
        jcenter()
        maven { url 'https://jitpack.io' }
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.2.1'
    }
}

2.app.gradle 添加

dependencies {
   implementation 'com.github.TanZhiL.FragmentKey:fragmentkey:1.0.2'
    annotationProcessor 'com.github.TanZhiL.FragmentKey:fragmentkey-compiler:1.0.2'
}

Usage：

1.在 fragment 中需要外部传递的字段上加上 Inject 注解,然后 build

   @Inject
    public String mUsername;
    //name 为自定义 key 值,默认为字段名
    @Inject(name = "password1")
    public String mPassword;
    @Inject
    public int age;

2.创建 fragment 实例时使用 xxxKey.send(...)方法;xxxKey 类由 apt 自动生成.

      TFragment2 tFragment = new TFragment2Key().send("姓名", "密码", 10);

##注意: 目前以支持 bundle 能传递的常见类型字段

   @Inject
    protected String s;
    @Inject
    protected Integer i;
    @Inject
    protected boolean b;
    @Inject
    protected float f;
    @Inject
    protected double d;
    @Inject
    protected long l;
    @Inject
    protected ArrayList<String> ls;
    @Inject
    protected ArrayList<Integer> li;
    @Inject
    protected ArrayList<Parcelable> lp;
    @Inject
    protected Serializable se;
    @Inject
    protected Parcelable p;

致谢

• 感谢所有开源库的大佬
• 借鉴大佬 https://github.com/JakeWharton/butterknife

问题反馈

欢迎加星，打 call https://github.com/TanZhiL/FragmentKey

• email：1071931588@qq.com

关于作者

谭志龙

开源项目

• 快速切面编程开源库 https://github.com/TanZhiL/OkAspectj
• 一款解决使用 newInstance 创建 fragment 定义 key 传值问题的 apt 框架 https://github.com/TanZhiL/FragmentKey
• 高仿喜马拉雅听 Android 客户端 https://github.com/TanZhiL/Zhumulangma
• 基于面向对象设计的快速持久化框架 https://github.com/TanZhiL/RxPersistence
• 骨架屏弹性块 https://github.com/TanZhiL/SkeletonBlock

License

Copyright (C)  tanzhilong FragmentKey Open Source Project

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.