1 Star 0 Fork 183

突然空闲 / KJFrameForAndroid

forked from kymjs / KJFrameForAndroid 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 13.35 KB
一键复制 编辑 原始数据 按行查看 历史
kymjs 提交于 2014-09-19 11:25 . 更新项目版本至V1.1.0

logo KJFrameForAndroid简介

================= 感谢支持KJFrameForAndroid的社区与组织:
Android Arsenal Travis CI BlackDuck OpenHUB OSChina
--- KJFrameForAndroid 又叫KJLibrary,是一个android的orm 和 ioc 框架。同时封装了android中的Bitmap与Http操作的框架,使其更加简单易用;
--- KJFrameForAndroid的设计思想是通过封装Android原生SDK中复杂的复杂操作而达到简化Android应用级开发,最终实现快速而又安全的开发APP。我们提倡用最少的代码,完成最多的操作,用最高的效率,完成最复杂的功能。

KJFrameForAndroid 相关链接


框架使用

clone下KJFrameForAndroid最新源码后,导入eclipse中,若只想使用框架而不考虑源码查看与学习,可直接复制binrary目录下的kjlibrary.jar文件至自己项目的libs文件夹中。
gradle?为什么要用AndroidStudio(或类似)我们不对其做支持,当然你可以选择自行研究。
若需要对源码改动或学习,可打开KJLibrary工程查看源码,同时结合KJFrameExample演示项目更好的学习,另外也可以自己新建工程,并右键工程->preference->Android->library->Add,选择KJLibrary工程加入后apply应用。
由于使用了最新的部分API函数,以及3.0版Fragment。KJFrameForAndroid框架最低支持Android3.0版本,本框架可以作代码混淆

注:使用 KJFrameForAndroid 应用开发框架需要在你项目的AndroidManifest.xml文件中加入以下权限:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  • 第一个是访问网络
  • 第二个是访问sdcard
  • 访问网络是请求网络图片的时候需要或者是http数据请求时候需要,访问sdcard是图片缓存的需要(如果你使用utilsLibrary,针对不同的功能可能会需要更多的权限)。

=======各模块使用介绍=======

UILibrary模块

UILibrary包含两个部分Widget(控件)、Topology(Android框架结构继承链) 详细介绍...

UILibrary -> Widget控件部分 主要封装了常用的UI控件,为了不让项目jar包过大,我们只引入了开发中一定会用到的控件,例如:可上下拉的KJListView、可上下拉的KJScrollView、可以双指缩放双击缩放双指旋转的ScaleImageView、等等......更多内容请自行查看项目文件中org.kymjs.aframe.widget包下的内容

UILibrary -> Topology拓扑部分 包含一个使用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
initDataWithThread();(异步,线程中调用)
initData();
initWidget();
registerBroadcast();

BitmapLibrary模块

任何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");

HttpLibrary模块

KJLibrary默认对所有Http通信的数据做了缓存处理,缓存时间为5分钟。这么做的目的不仅是为了节省用户手机流量,同时是为了减少服务器压力
HttpLibrary模块使用HttpClient与HttpUrlConnection两种实现方式实现网络通信、数据上传、多线程断点下载。根据Google建议:在2.3系统之前由于HttpUrlConnection不稳定且有一定的BUG,应该尽量使用HttpClient;在2.3以后的系统,若只是简单的数据交互,应该使用更加轻量级、易扩展的HttpUrlConnection。对于实现的方式,KJLibrary将交由开发者来选择。

###普通get方法示例:

// 使用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 StringRespond(){

	@Override
	public void success(String t) {
			ViewInject.toast("显示JSON信息:" + t);
	}

	@Override
	public void failure(Throwable t, int errorNo, String strMsg) {
		ViewInject.toast("网络加载失败,请检查您的网络");
	}
});

###普通post请求JSON方法示例:

// 使用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 StringRespond(){
	@Override
	public void success(String t) {
			ViewInject.toast("显示JSON信息:" + t);
	}

	@Override
	public void failure(Throwable t, int errorNo, String strMsg) {
		ViewInject.toast("网络加载失败,请检查您的网络");
	}
});

###post上传文件方法示例:

// 使用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 StringRespond(){

	@Override
	public void success(String t) {
			ViewInject.toast("显示JSON信息:" + t);
	}

	@Override
	public void failure(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);

DBLibrary模块

包含了android中的orm框架,使用了线程池对sqlite进行操作,一行代码就可以进行增删改查。支持一对多,多对一等查询。
有关DB模块,要在此感谢afinal框架,很大程度上参考了finalDB的设计

//普通数据存储
KJDB db = KJDB.create(this);
User ugc = new User(); //这里需要注意的是User对象必须有id属性,或者有通过@ID注解的属性
ugc.setEmail("kymjs123@gmail.com");
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());
    }

UtilsLibrary模块

包含了应用开发中的常用工具类,例如系统级别的Log管理、网络状态监测、Bitmap压缩工具类、获取屏幕宽高以及单位转换的工具类、错误信息处理与文件处理工具类、preference工具类、字符串操作与常用正则判断等。详细内容请自行查看项目文件中org.kymjs.aframe.utils包下的内容更多介绍...

许可

**本项目采用 Apache Licence 2.0 授权协议:
Apache Licence是著名的非盈利开源组织Apache采用的协议。该协议和BSD类似,同样鼓励代码共享和尊重原作者的著作权,同样允许代码修改,再发布(作为开源或商业软件)更多...
Copyright (c) 2014, KJFrameForAndroid Open Source Project, Zhang Tao.

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.

关于作者kymjs

blog:http://my.oschina.net/kymjs/blog
email:kymjs123@gmail.com
forum/bbs: http://tieba.baidu.com/f?kw=kym%BD%A9%CA%AC&fr=index

1
https://gitee.com/steed_ns/KJFrameForAndroid.git
git@gitee.com:steed_ns/KJFrameForAndroid.git
steed_ns
KJFrameForAndroid
KJFrameForAndroid
master

搜索帮助