KJFrameForAndroid的设计思想是通过封装Android原生SDK中复杂的复杂操作而达到简化Android应用级开发,最终实现快速而又安全的开发APP。我们提倡用最少的代码,完成最多的操作,用最高的效率,完成最复杂的功能。
UILibrary包含两个部分Widget(控件)、Topology(Android框架结构继承链) 详细介绍...
UILibrary -> Widget控件部分 主要封装了常用的UI控件,为了不让项目jar包过大,我们只引入了开发中一定会用到的控件,例如:可上下拉的KJListView、可上下拉的KJScrollView、可以双指缩放双击缩放双指旋转的ScaleImageView、等等......更多内容请自行查看项目文件中org.kymjs.aframe.widget包下的内容
UILibrary -> Topology拓扑部分 规范了Activity中数据及控件的初始化,并包含一个使用IOC设计思想的控件初始化方式:可通过注解的方式进行UI绑定,与设置监听,在Activity和Fragment中均可以通过一行代码绑定控件并实现点击监听;还包含了在目前应用开发中常见的布局界面,如侧滑效果,高效的底部TAB导航,3D效果的切换。同时UILibrary为开发者定义了完善的BaseActivity和BaseFragment,开发者只需手动继承就可以获得Topology部分的全部功能。
public class TabExample extends BaseActivity {
@BindView(id = R.id.bottombar_content1, click = true)
public RadioButton mRbtn1;
@BindView(id = R.id.bottombar_content2, click = true)
private RadioButton mRbtn2;
@Override
public void setRootView() {
setContentView(R.layout.aty_tab_example);
}
@Override
protected void initWidget() {
super.initWidget();
mRbtn1.setText("控件已经初始化绑定并设置了监听");
}
@Override
public void widgetClick(View v) {
super.widgetClick(v);
switch (v.getId()) {
case R.id.bottombar_content1:
ViewInject.toast("点击了mRbtn1");
break;
case R.id.bottombar_content2:
ViewInject.toast("点击了mRbtn2");
break;
}
}
}
Topology中各函数调用顺序: setRootView();
@BindView
initDataFromThread();(异步调用,可做耗时操作)
threadDataInited();(initDataFromThread执行完成后才会回调)
initData();
initWidget();
registerBroadcast();
任何View(ImageView设置src,普通View设置bg)加载图片的时候都无需考虑图片加载过程中出现的oom和android容器快速滑动时候出现的图片错位等现象,同时无需考虑图片加载过程中出现的OOM。默认使用内存lru算法+磁盘lru算法缓存图片 详细介绍
注:在Android2.3之前,我们常常使用软引用或弱引用的形式去做缓存图片,然而根据Google的描述:垃圾回收器会更倾向于回收持有软引用或弱引用的对象,这让软引用和弱引用变得不再可靠。另外,Android 3.0 (API Level 11)中,图片的数据会存储在本地的内存当中,因而无法用一种可预见的方式将其释放,这就有潜在的风险造成应用程序的内存溢出并崩溃。BitmapLibrary使用lru算法去管理缓存,同时内存缓存配合磁盘缓存能更有效的管理缓存调用。
KJBitmap kjb = KJBitmap.create();
/**
* url不仅支持网络图片显示,同时支持本地SD卡上的图片显示;
* view不仅可以是imageview,同时普通view也可以传入,框架会自动识别对imageview设置src对普通view设置bg
*/
// 载入本地图片
kjb.display(imageView, "/storage/sdcard0/1.jpg",80,80); //可选参数,设置要显示图片的宽高,不设置则默认显示原图
// 载入网络图片
kjb.display(textView, "http://www.eoeandroid.com/data/attachment/forum/201107/18/142935bbi8d3zpf3d0dd7z.jpg");
KJLibrary默认对所有Http通信的数据做了缓存处理,缓存时间为5分钟。这么做的目的不仅是为了节省用户手机流量,同时是为了减少服务器压力
HttpLibrary模块使用HttpClient与HttpUrlConnection两种实现方式实现网络通信、数据上传、多线程断点下载。根据Google建议:在2.3系统之前由于HttpUrlConnection不稳定且有一定的BUG,应该尽量使用HttpClient;在2.3以后的系统,若只是简单的数据交互,应该使用更加轻量级、易扩展的HttpUrlConnection。对于实现的方式,KJLibrary将交由开发者来选择。
// 使用HttpClient,与使用HttpUrlConnection的使用方法一样,就只具体写一种了
KJHttp kjh = new KJHttp();
kjh.get(String url,I_HttpParams params, HttpCallback callback);
// 使用HttpUrlConnection
KJHttp kjh = new KJHttp();
kjh.urlGet("http://my.oschina.net/kymjs/blog", new StringCallBack(){
@Override
public void onSuccess(String t) {
ViewInject.toast("显示JSON信息:" + t);
}
@Override
public void onFailure(Throwable t, int errorNo, String strMsg) {
ViewInject.toast("网络加载失败,请检查您的网络");
}
});
// 使用HttpClient,与使用HttpUrlConnection的使用方法一样,就只具体写一种了
KJHttp kjh = new KJHttp();
kjh.post(String url,I_HttpParams params, HttpCallback callback);
// 使用HttpUrlConnection
KJHttp kjh = new KJHttp();
KJStringParams params = new KJStringParams();
params.put("user_id", "33");
params.put("birthday", "2008-8-1");
kjh.urlPost("http://my.oschina.net/kymjs/blog", params, new StringCallBack(){
@Override
public void onSuccess(String t) {
ViewInject.toast("显示JSON信息:" + t);
}
@Override
public void onFailure(Throwable t, int errorNo, String strMsg) {
ViewInject.toast("网络加载失败,请检查您的网络");
}
});
// 使用HttpClient,与使用HttpUrlConnection的使用方法一样,就只具体写一种了
kjh.post(String url,I_HttpParams params, HttpCallback callback);
// 使用HttpUrlConnection
KJHttp kjh = new KJHttp();
KJFileParams params = new KJFileParams();
params.put("user_id", "33");
params.put(new File("/storage/sdcard0/1.jpg"));//传file对象
params.put(inputstream);//传文件输入流
params.put(byteArray);//传文件byte数组
//以上三种方法任选其一即可
kjh.urlPost("http://my.oschina.net/kymjs/blog", params, new StringCallBack(){
@Override
public void onSuccess(String t) {
ViewInject.toast("显示JSON信息:" + t);
}
@Override
public void onFailure(Throwable t, int errorNo, String strMsg) {
ViewInject.toast("网络加载失败,请检查您的网络");
}
});
KJHttp kjh = new KJHttp();
FileCallBack file = new FileCallBack() {
@Override
public void onSuccess(File f) {
ViewInject.toast("下载成功");
}
@Override
public void onLoading(long count, long current) {
super.onLoading(count, current);
if (!maxed) {
mProgress.setMax((int) count);
maxed = true;
}
mProgress.setProgress((int) current);
}
@Override
public void onFailure(Throwable t, int errorNo, String strMsg) {
super.onFailure(t, errorNo, strMsg);
ViewInject.toast("失败原因: " + strMsg);
}
};
file.setProgress(true); // 若要调用onLoading,必须设置为true
kjh.urlDownload(mEt.getText().toString(), "/storage/sdcard0/3.png",file);
包含了android中的orm框架,一行代码就可以进行增删改查。支持一对多,多对一等查询。
DB模块,很大程度上参考了finalDB的设计,并在此基础上完善了几乎全部的API注释,与更多可定制的DB操作
//普通数据存储
KJDB db = KJDB.create(this);
User ugc = new User(); //这里需要注意的是User对象必须有id属性,或者有通过@ID注解的属性
ugc.setEmail("[email protected]");
ugc.setName("kymjs");
db.save(ugc);
//一对多数据存储
public class Parent{ //JavaBean
private int id;
@OneToMany(manyColumn = "parentId")
private OneToManyLazyLoader<Parent ,Child> children;
/*....*/
}
public class Child{ //JavaBean
private int id;
private String text;
@ManyToOne(column = "parentId")
private Parent parent;
/*....*/
}
List<Parent> all = db.findAll(Parent.class);
for( Parent item : all){
if(item.getChildren ().getList().size()>0)
ViewInject.toast(item.getText() + item.getChildren().getList().get(0).getText());
}
包含了应用开发中的常用工具类,例如系统级别的Log管理、网络状态监测、Bitmap压缩工具类、获取屏幕宽高以及单位转换的工具类、错误信息处理与文件处理工具类、preference工具类、字符串操作与常用正则判断等。详细内容请自行查看项目文件中org.kymjs.aframe.utils包下的内容更多介绍...
https://github.com/kymjs/KJFrameForAndroid