前言
每次开发一个新的项目的时候，最烦的是，要写很多重复的代码，比如findViewById 、setOnClickListener、intent跳转 等等，虽然简单，但是却很浪费时间！但是用JinBase库，代码将如下图一样，看起来是不是简洁很多呢？findViewById 不再需要强转，setOnClickListener 不再需要加一句findViewById获取对象，跳转，不需要new Intent对象了，跳转fragment，代码有多少，我就不说了，自行百度，而现在，只要一句代码就解决问题
main.png
详细用法
1.在build.gradle文件中集成JinBase项目
compile 'cn.jin:jinbase:1.0.3'
2.初始化JinBase库
如果项目中有自己的application类，则在自己的application类中的onCreate方法加上以下代码：
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
JinLib.initialize(this);//初始化JinLib
}
}
如果项目中没有自己的application类，则在AndroidManifest.xml文件的application标签中加上如下代码：
<application
android:name="cn.jin.base.JinLib"
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme">
、、、
</application>
3.BaseActivity介绍
项目中，每一个activity必须继承BaseActivity，之后可以使用BaseActivity封装好的如下功能了
findViewById
//Button btnGo2Fragment = (Button) findViewById(R.id.btn_main_go2fragment);替换成下列代码
Button btnGo2Fragment = find(R.id.btn_main_go2fragment);//获取某个id的控件对象
//动态加载布局的，可以这样
View headerView = LayoutInflater.from(this).inflate(R.layout.layout_header,null);
TextView tvTitle = find(headerView,R.id.tv_header_title);
setOnClickListener
//传View对象
Button btnGo2Fragment = find(R.id.btn_main_go2fragment);//获取某个id的控件对象
addListener(btnGo2Fragment);//监听控件点击事件
//直接传view id
addListener(R.id.btn_main_go2listfragment);
//也可以给自己点击的按钮加状态
addListener(R.id.btn_main_go2webview,ResUtil.getColor(R.color.transparent) ,ResUtil.getColor(R.color.black_50));
//重写onClick方法接收点击事件
@Override
public void onClick(View v) {
switch (v.getId()){
、、、
}
}
startActivity与startActivityForResult
//跳转到activity
go2(SecondActivity.class);
//传参数跳转到acitivty
Bundle bundle = getBundle("data","test");
go2(SecondActivity.class,bundle);//跳转到activity
//类似与startActivityForResult
go24Result(SecondActivity.class,100);//跳转到activity
//传参的startActivityForResult
go24Result(SecondActivity.class,bundle,100);//跳转到activity
fragment相关的
//跳转到fragment,不在当前activity中打开，跳转到新的页面打开
go2(new ThirdFragment());
//跳转到fragment,不在当前activity中打开，跳转到新的页面打开 并且传参
Bundle bundle = getBundle("data","test");
go2(new ThirdFragment(),bundle);//跳转到fragment
//跳转到fragment，在当前activity中打开，需要传入ViewGroup的id
BaseFragment fragment = new ThirdFragment();
go2(R.id.activity_base_fragment,fragment);
弹出等待对话框
showWaitDialog("请稍候...");//显示对话框
hideWaitDialog();//隐藏对话框
4.打印日志
//打印日志，不用在意是debug版本和release版本，已经内部做了判断只要调用以下代码就可以判断
L.i("打印日志");
L.i("打印日志","拼接");
L.e("打印错误日志");
L.d("日志");
L.v("打印日志");
5.Toast
//传string资源id的短Toast
T.showShort(R.string.app_name);
//传字符串的短Toast
T.showShort("弹了个土司");
//传字符串的长Toast
T.showLong("弹了个长土司");
//传string资源id的长Toast
T.showLong(R.string.app_name);
6.WebView的页面的封装
/**
* 通过继承BaseWebActivity 而不在需要写任何WebView相关的代码
*/
public class MyWebActivity extends BaseWebActivity {
@Override
protected View getHeaderView() {
View headerView = LayoutInflater.from(this).inflate(R.layout.layout_header,null);
TextView tvTitle = find(headerView,R.id.tv_header_title);
tvTitle.setText("百度");
ImageView ivBack = find(headerView,R.id.iv_header_left);
addListener(ivBack);
return headerView;
}
@Override
public void onClick(View v) {
switch (v.getId()){
case R.id.iv_header_left:
finish();
break;
}
}
@Override
protected String getUrl() {
return "www.baidu.com";
}
}
7.ListView或者GridView的adapter的封装类CommonAdapter的使用
/**
* 通过继承CommonAdapter减少adapter的代码量
* Created by 邱锦洋 on 2017/3/30.
*/
public class MyListAdapter extends CommonAdapter<MyItem> {
public MyListAdapter(Context context) {
super(context);
}
@Override
protected int getLayoutId() {
return R.layout.layout_header;//item的布局
}
@Override
public void convert(ViewHolder helper, MyItem item, int position) {
helper.setText(R.id.tv_header_title,"标题");//可以直接给TextView设置内容
TextView tvTitle = helper.find(R.id.tv_header_title);//调用find方法获取控件
go2(SecondActivity.class);//支持BaseActivity中的大部分go2方法 和go24Result方法
}
}
//在activity或者fragment中，给adapter传输数据的方法
List<MyItem> lists = new ArrayList<>();
MyListAdapter adapter = new MyListAdapter(getActivity());
adapter.setData(lists);//给adapter设置数据
adapter.resetData(lists);//重置adapter的为新的lists的数据，会清空已有的list数据
adapter.addData(lists);//在已有的list数据的基础上，添加新的lists数据
adapter.addItem(new MyItem());//在list的末尾添加一个item数据
adapter.addItem(new MyItem(),2);//在list的某一个位置插入一条item数据
adapter.clearData();//清空当前的list数据
adapter.getCurData();//获取当前的list数据
8.BaseFragment介绍
//直接继承BaseFragment 来简化fragment的代码量
public class ThirdFragment extends BaseFragment {
/**
* 用来觉得是返回上一个fragment，还是直接关闭当前activity
* true 表示关闭当前activity
* false 表示如果还有上一层fragment，则返回上一层fragment
*/
@Override
public boolean onBackPressed() {
return false;
}
@Override
protected int getLayoutId() {//fragment的布局
return R.layout.fragment_third;
}
@Override
protected void init() {
//做一下初始化工作，fragment的主入口
}
}
关于fragment的方法跟BaseActivity的方法类似获取控件用find() 跳转用go() 监听用addListener() ，详情看BaseActivity那一节。BaseFragment比BaseActivity多一个方法，就是finish()方法。
finish()方法，会根据onBackPressed()方法的返回值来决定，是跳到上一层fragment 还是 直接返回上一个acitivty
9.BaseFragmentPagerAdapter 与 BaseViewPagerFragment
这两个是对类似于下图这个界面实现的封装
jiemian.png
用法：
/**
* 是集成了MVP架构设计的，
* Created by 邱锦洋 on 2017/3/31.
*/
public class TestViewPagerFragment extends BaseViewPagerFragment<MyMvpView,MyMvpPresenter>
implements MyMvpView {
private BaseFragmentPagerAdapter mTabsAdapter;
@Override
protected MyMvpPresenter createPresenter() {
return new MyMvpPresenter();
}
@Override
protected void onSetupTabAdapter(BaseFragmentPagerAdapter tabsAdapter) {
this.mTabsAdapter = tabsAdapter;//可以把adapter,设置为成员变量
mPresenter.loadData();//可以通过Presenter实例加载网络数据
}
@Override
public boolean onBackPressed() {
return false;
}
@Override
public void success() {//请求网络成功之后，再设置fragment
mTabsAdapter.addTab("第一个","tag1",ThirdFragment.class,null);//注意必须保证tag不一样
mTabsAdapter.addTab("第二个","tag2",ThirdFragment.class,null);//注意必须保证tag不一样
mTabsAdapter.notifyDataSetChanged();
}
}
10.集成MVP架构设计的BaseMvpActivity 和BaseMvpFragment 基类
BaseMvpActivity的用法
public class MyMvpActivity extends BaseMvpActivity<MyMvpView,MyMvpPresenter>
implements MyMvpView {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_my_mvp);
mPresenter.loadData();//利用Presenter实例来处理数据
}
@Override
protected MyMvpPresenter createPresenter() {
return new MyMvpPresenter();//实例化Presenter的具体实例
}
/**
* Mvp 的 view interface 的方法
*/
@Override
public void success() {
}
}
BaseMvpFragment的用法
public class ThirdFragment extends BaseMvpFragment<MyMvpView,MyMvpPresenter>
implements MyMvpView{
/**
* 用来觉得是返回上一个fragment，还是直接关闭当前activity
* true 表示关闭当前activity
* false 表示如果还有上一层fragment，则返回上一层fragment
*/
@Override
public boolean onBackPressed() {
return false;
}
@Override
protected int getLayoutId() {//fragment的布局
return R.layout.fragment_third;
}
@Override
protected void init() {
//做一下初始化工作，fragment的主入口
mPresenter.loadData();//利用Presenter实例来处理数据
}
@Override
protected MyMvpPresenter createPresenter() {
return new MyMvpPresenter();//实例化Presenter的具体实例
}
/**
* Mvp 的 view interface 的方法
*/
@Override
public void success() {
}
}
11.ResUtil工具类的用法
这个工具类主要是简化获取资源string、color、drawable 等的方法
12.PreferencesUtil 工具类
SharedPreferences 的封装工具类
通过 PreferencesUtil.setName()方法，让SharedPreferences 可以跨应用访问
通过PreferencesUtil.add()方法，存储数据
通过PreferencesUtil.getString() 、PreferencesUtil.getBoolean() 。。。等诸多方法获取存储的数据值
[源码传送门]
[源码传送门]: https://github.com/Jeff518/JinBase "源码传送门"
