Afinal

Project Url: yangfuhai/Afinal
Introduction: Afinal 是一个 android 的 ioc，orm 框架，内置了四大模块功能：FinalAcitivity,FinalBitmap,FinalDb,FinalHttp。通过 finalActivity，我们可以通过注解的方式进行绑定 ui 和事件。通过 finalBitmap，我们可以方便的加载 bitmap 图片，而无需考虑 oom 等问题。通过 finalDB 模块，我们一行代码就可以对 android 的 sqlite 数据库进行增删改查。通过 FinalHttp 模块，我们可以以 ajax 形式请求 http 数据
More: Author   ReportBugs   OfficialWebsite   
Tags:
  • QQ 群：192341294（群 1，2000 未满） 246710918（群 2，1000 未满）

    作者个人微信

    mahua

mahua Afinal 简介

  • Afinal 是一个 android 的 sqlite orm 和 ioc 框架。同时封装了 android 中的 http 框架，使其更加简单易用；
  • 使用 finalBitmap，无需考虑 bitmap 在 android 中加载的时候 oom 的问题和快速滑动的时候图片加载位置错位等问题。
  • Afinal 的宗旨是简洁，快速。约定大于配置的方式。尽量一行代码完成所有事情。

目前 Afinal 主要有四大模块：

  • FinalDB 模块：android 中的 orm 框架，一行代码就可以进行增删改查。支持一对多，多对一等查询。

  • FinalActivity 模块：android 中的 ioc 框架，完全注解方式就可以进行 UI 绑定和事件绑定。无需 findViewById 和 setClickListener 等。

  • FinalHttp 模块：通过 httpclient 进行封装 http 数据请求，支持 ajax 方式加载。

  • FinalBitmap 模块：通过 FinalBitmap，imageview 加载 bitmap 的时候无需考虑 bitmap 加载过程中出现的 oom 和 android 容器快速滑动时候出现的图片错位等现象。FinalBitmap 可以配置线程加载线程数量，缓存大小，缓存路径，加载显示动画等。FinalBitmap 的内存管理使用 lru 算法，没有使用弱引用（android2.3 以后 google 已经不建议使用弱引用，android2.3 后强行回收软引用和弱引用，详情查看 android 官方文档），更好的管理 bitmap 内存。FinalBitmap 可以自定义下载器，用来扩展其他协议显示网络图片，比如 ftp 等。同时可以自定义 bitmap 显示器，在 imageview 显示图片的时候播放动画等（默认是渐变动画显示）。

使用 afinal 快速开发框架需要有以下权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  • 第一个是访问网络
  • 第二个是访问 sdcard
  • 访问网络是请求网络图片的时候需要或者是 http 数据请求时候需要，访问 sdcard 是图片缓存的需要。

FinalDB 使用方法：

关于 finalDb 的更多介绍，请点击这里

FinalDb db = FinalDb.create(this);
User user = new User(); //这里需要注意的是 User 对象必须有 id 属性，或者有通过@ID 注解的属性
user.setEmail("mail@tsz.net");
user.setName("michael yang");
db.save(user);

FinalDB OneToMany 懒加载使用方法：

模型定义：

public class Parent{
    private int id;
    @OneToMany(manyColumn = "parentId")
    private OneToManyLazyLoader<Parent ,Child> children;
    /*....*/
}
public class Child{
    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)
                Toast.makeText(this,item.getText() + item.getChildren().getList().get(0).getText(),Toast.LENGTH_LONG).show();
        }

FinalActivity 使用方法：

  • 完全注解方式就可以进行 UI 绑定和事件绑定
  • 无需 findViewById 和 setClickListener 等
public class AfinalDemoActivity extends FinalActivity {

    //无需调用 findViewById 和 setOnclickListener 等
    @ViewInject(id=R.id.button,click="btnClick") Button button;
    @ViewInject(id=R.id.textView) TextView textView;

    public void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.main);
    }

    public void btnClick(View v){
       textView.setText("text set form button");
    }
}

*在其他侵入式框架下使用（如 ActionBarShelock）

     protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
        setContentView(view);
        FinalActivity.initInjectedView(this);
     }

*在 Fragment 中使用

     public View onCreateView(LayoutInflater inflater, ViewGroup container,
          Bundle savedInstanceState) {
       View viewRoot = inflater.inflate(R.layout.map_frame, container, false);
       FinalActivity.initInjectedView(this,viewRoot);
    }

FinalHttp 使用方法：

普通 get 方法

FinalHttp fh = new FinalHttp();
fh.get("http://www.yangfuhai.com", new AjaxCallBack(){

    @Override
    public void onLoading(long count, long current) { //每 1 秒钟自动被回调一次
            textView.setText(current+"/"+count);
    }

    @Override
    public void onSuccess(String t) {
            textView.setText(t==null?"null":t);
    }

    @Override
    public void onStart() {
        //开始 http 请求的时候回调
    }

    @Override
    public void onFailure(Throwable t, String strMsg) {
        //加载失败的时候回调
    }
});

使用 FinalHttp 上传文件 或者 提交数据 到服务器（post 方法）

文件上传到服务器，服务器如何接收，请查看这里

  AjaxParams params = new AjaxParams();
  params.put("username", "michael yang");
  params.put("password", "123456");
  params.put("email", "test@tsz.net");
  params.put("profile_picture", new File("/mnt/sdcard/pic.jpg")); // 上传文件
  params.put("profile_picture2", inputStream); // 上传数据流
  params.put("profile_picture3", new ByteArrayInputStream(bytes)); // 提交字节流

  FinalHttp fh = new FinalHttp();
  fh.post("http://www.yangfuhai.com", params, new AjaxCallBack(){
          @Override
         public void onLoading(long count, long current) {
                 textView.setText(current+"/"+count);
         }

         @Override
         public void onSuccess(String t) {
             textView.setText(t==null?"null":t);
         }
  });

使用 FinalHttp 下载文件：

  • 支持断点续传，随时停止下载任务 或者 开始任务
    FinalHttp fh = new FinalHttp();  
    //调用 download 方法开始下载
    HttpHandler handler = fh.download("http://www.xxx.com/下载路径/xxx.apk", //这里是下载的路径
    true,//true:断点续传 false:不断点续传（全新下载）
    "/mnt/sdcard/testapk.apk", //这是保存到本地的路径
    new AjaxCallBack() {  
                @Override  
                public void onLoading(long count, long current) {  
                     textView.setText("下载进度："+current+"/"+count);  
                }  

                @Override  
                public void onSuccess(File t) {  
                    textView.setText(t==null?"null":t.getAbsoluteFile().toString());  
                }  

            });  


   //调用 stop()方法停止下载
   handler.stop();

FinalBitmap 使用方法

加载网络图片就一行代码 fb.display(imageView,url) ,更多的 display 重载请看帮助文档

private GridView gridView;
    private FinalBitmap fb;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.images);

        gridView = (GridView) findViewById(R.id.gridView);
        gridView.setAdapter(mAdapter);

        fb = FinalBitmap.create(this);//初始化 FinalBitmap 模块
        fb.configLoadingImage(R.drawable.downloading);
        //这里可以进行其他十几项的配置，也可以不用配置，配置之后必须调用 init()函数,才生效
        //fb.configBitmapLoadThreadSize(int size)
        //fb.configBitmapMaxHeight(bitmapHeight)
    }


///////////////////////////adapter getView////////////////////////////////////////////

public View getView(int position, View convertView, ViewGroup parent) {
    ImageView iv;
    if(convertView == null){
        convertView = View.inflate(BitmapCacheActivity.this,R.layout.image_item, null);
        iv = (ImageView) convertView.findViewById(R.id.imageView);
        iv.setScaleType(ScaleType.CENTER_CROP);
        convertView.setTag(iv);
    }else{
        iv = (ImageView) convertView.getTag();
    }
    //bitmap 加载就这一行代码，display 还有其他重载，详情查看源码
    fb.display(iv,Images.imageUrls[position]);

>>> Add by fantouch

配置成 Android Library Project

解决需求:有多个项目依赖 afinal,并且想修改 afinal 源码

  • clone 到本地

  • 添加 AndroidManifest.xml 文件:

    <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  package="net.tsz.afinal" >
  <uses-sdk
      android:minSdkVersion="5"
      android:targetSdkVersion="7" />
</manifest>

  • 导入到 Eclipse:
    Import => Android => Existing Android Code Into Workspace

  • 工程上按右键 => Properties => Android => √ Is Library
  • 完成,你的项目可以引用这个 afinal Library 了.

排除不需要 Git 管理的文件

解决需求:想修改源码,但不想让 Eclipse 把工程弄脏

  • 忽略已经被 Git 管理的./bin目录:
    导入 Eclipse 前执行: git update-index --assume-unchanged ./bin/*

  • 忽略未被 Git 管理的文件和目录: 添加/.gitignore 文件: 

    /gen
/assets
/bin
/res
/.classpath
/.project
/AndroidManifest.xml
/project.properties
/.gitignore
  • 导入到 Eclipse,git status可见 Repository 依旧干净.

<<< Add by fantouch

关于作者 michael

Highly Recommended：Google Play 4.7 Star Android Developer Tools, Decompile, View Manifest, Open Debug Options Quickly

Apps
Android Developer Tools
Android Developer Tools Pro
About Me
Tools: TimeShining
GitHub: Trinea
Facebook: Dev Tools