【开源】KJFrameForAndroid

KJFrameForAndroid

  •  https://github.com/kymjs/KJFrameForAndroid

    介绍：

    KJFrameForAndroid 又叫KJLibrary，是一个帮助快速开发的框架。使用KJFrameForAndroid，你可以只用一行代码就完成http请求、网络图片加载、数据库数据保存或读取。

    运行效果：

    使用说明：

    Demo工程运行 ：①下载框架最新源码。②选择KJFrameExample工程导入Eclipse。③将/binrary目录最新的项目jar包复制至demo的libs目录。④删除project.properties文件的最后一行
    在项目中使用 ：将KJFrameForAndroid的最新jar包添加到你工程/libs目录中并引用。

    • KJFrameForAndroid默认已集成了android-support-v4.jar，你无需再次添加。

    • 由于使用了SDK最新的API函数，以及3.0版Fragment。KJFrameForAndroid框架最低支持Android3.0版本，本框架可以作代码混淆，混淆时请保留包含注解部分的类的完整性。
      注：使用 KJFrameForAndroid 应用开发框架需要在你项目的AndroidManifest.xml文件中加入以下基本权限：

    1
    2
    <uses-permissionandroid:name="android.permission.INTERNET" />
    <uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE" />

    • 第一个是访问网络

    • 第二个是访问sdcard

    • 访问网络是请求网络图片的时候需要或者是http数据请求时候需要，访问sdcard是图片缓存的需要(如果你使用utilsLibrary，针对不同的功能可能会需要更多的权限)。

    Plugin模块

    使用Plugin模块可以让你的插件apk不用安装便直接被运行，极大的方便了APP动态更新，且可以轻松实现插件与APP项目之间的解耦。更多介绍请看Plugin模块详细介绍
    现支持以下功能

    • apk无需安装即可被应用调用

    • Activity的动态加载：包括生命周期和交互事件、R文件资源引用、插件与APP之间的数据通信

    • Fragment的完美加载使用

    • 动态注册的BroadcastReceiver

    • 绑定式、启动式Service均可完美使用

    • 已成功模拟出launchMode的效果。(launchModer实际上是一个虚拟的，生命周期的调用还是一样的，仅仅模拟出了系统的BackStack)

    • 完美集成了KJFrameForAndroid中UiLibrary->Topology的全部功能，支持注解式绑定控件设置监听

    UILibrary模块

    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部分的全部功能。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    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();

    BitmapLibrary模块

    任何View(ImageView设置src，普通View设置bg)加载图片的时候都无需考虑图片加载过程中出现的oom和android容器快速滑动时候出现的图片错位等现象，同时无需考虑图片加载过程中出现的OOM。默认使用内存lru算法+磁盘lru算法缓存图片 详细介绍
    注：在Android2.3之前，我们常常使用软引用或弱引用的形式去做缓存图片，然而根据Google的描述：垃圾回收器会更倾向于回收持有软引用或弱引用的对象，这让软引用和弱引用变得不再可靠。另外，Android 3.0 (API Level 11)中，图片的数据会存储在本地的内存当中，因而无法用一种可预见的方式将其释放，这就有潜在的风险造成应用程序的内存溢出并崩溃。BitmapLibrary使用lru算法去管理缓存，同时内存缓存配合磁盘缓存能更有效的管理缓存调用。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    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方法示例：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    // 使用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("网络加载失败，请检查您的网络");
        }
    });

    普通post请求JSON方法示例：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    // 使用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("网络加载失败，请检查您的网络");
        }
    });

    post上传文件方法示例：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    // 使用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("网络加载失败，请检查您的网络");
        }
    });

    多线程下载方法示例：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    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框架，一行代码就可以进行增删改查。支持一对多，多对一等查询。
    DB模块，很大程度上参考了finalDB的设计，并在此基础上完善了几乎全部的API注释，与更多可定制的DB操作

    1
    2
    3
    4
    5
    6
    //普通数据存储
    KJDB db = KJDB.create(this);
    User ugc = new User(); //这里需要注意的是User对象必须有id属性，或者有通过@ID注解的属性
    ugc.setEmail("kymjs123@gmail.com");
    ugc.setName("kymjs");
    db.save(ugc);

     

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    //一对多数据存储
    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包下的内容更多介绍...

posted on 2015-03-31 12:20  wasdchenhao  阅读(177)  评论(0)    收藏  举报

导航