当前位置: 首页 > 工具软件 > afinal > 使用案例 >

android 框架 Afinal 解析

戎桐
2023-12-01

目前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显示图片的时候播放动画等(默认是渐变动画显示)。

什么是orm?

对象关系映射(英语:Object Relational Mapping,简称ORM,或O/RM,或O/R mapping),是一种程序技术,用于实现面向对象编程语言里不同类型系统的数据之间的转换。从效果上说,它其实是创建了一个可在编程语言里使用的“虚拟对象数据库”。

什么是ioc?

控制反转(Inversion of Control,英文缩写为IoC)是一个重要的面向对象编程的法则来削减计算机程序的耦合问题,也是轻量级的Spring框架的核心。 控制反转一般分为两种类型,依赖注入(Dependency Injection,简称DI)和依赖查找(Dependency Lookup)。依赖注入应用比较广泛。

什么是java注解?

注解(Annotation),也叫元数据。一种代码级别的说明。它是JDK5.0及以后版本引入的一个特性,与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面,用来对这些元素进行说明,注释。 作用分类:
①编写文档:通过代码里标识的元数据生成文档【生成文档doc文档】
②代码分析:通过代码里标识的元数据对代码进行分析【使用反射】
③编译检查:通过代码里标识的元数据让编译器能够实现基本的编译检查【Override】

FinalDB 使用如下

首先我们来创建一个测试实体类 User.java
package com.devchina.ormdemo;
import java.util.Date;
 
public class User {
     
    private int id;
    private String name;
    private String email;
    private Date registerDate;
    private Double money;
     
    /getter and setter 不能省略哦///
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getEmail() {
        return email;
    }
    public void setEmail(String email) {
        this.email = email;
    }
    public Date getRegisterDate() {
        return registerDate;
    }
    public void setRegisterDate(Date registerDate) {
        this.registerDate = registerDate;
    }
    public Double getMoney() {
        return money;
    }
    public void setMoney(Double money) {
        this.money = money;
    }        
}
这个实体类要注意一点就是getter和setter是不能省略的哦,,,,因为afinal的finalDb最终会调用setter去给实体类的属性赋值。

现在实体类创建完毕了,我们来写我们的第一个demo:
package com.devchina.ormdemo;
AfinalOrmDemoActivity.java
 
import java.util.Date;
import java.util.List;
 
import net.tsz.afinal.FinalActivity;
import net.tsz.afinal.FinalDb;
import net.tsz.afinal.annotation.view.ViewInject;
import android.os.Bundle;
import android.util.Log;
import android.widget.TextView;
 
public class AfinalOrmDemoActivity extends FinalActivity {
     
    @ViewInject(id=R.id.textView) TextView textView; //这里使用了afinal的ioc功能,以后将会讲到
     
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
         
        FinalDb db = FinalDb.create(this);
         
        User user = new User();
        user.setEmail("afinal@tsz.net");
        user.setName("探索者");
        user.setRegisterDate(new Date());
         
        db.save(user);
         
        List<User> userList = db.findAll(User.class);//查询所有的用户
         
        Log.e("AfinalOrmDemoActivity", "用户数量:"+ (userList!=null?userList.size():0));
         
        textView.setText(userList.get(0).getName()+":"+user.getRegisterDate());
    }
}
很简单吧,就一个FinalDb db = FinalDb.create(this),然后db.save(user);就可以把我们定义的实体类保存到数据库去啦。我们来看输出日志:
什么?就这样就保存到sqlite数据库里面去了?可是我们还没有创建数据库,也没有创建表呀?怎么可能?

这里,我要跟大家说的是afinal自己去创建啦,简单吧。

我们来看下adt的File Exploer 查看database目录,下面确实有一个afinal.db文件。

我们把afinal.db导出来后,通过sqlite数据库打开afinal.db。

同时afinal自动给我们创建来表:com_devchina_ormdemo_User,由此看出afinal会以类名为表名自动创建表。

到这里,相信大家能明白了,原理afinal自动给我们创建了数据库afinal.db同时给我们创建了表com_devchina_ormdemo_User,保存的时候,afinal自动把数据保存到sqlite表里面去了。

这时候,估计大家的疑问又起来了


afinal自动创建了数据库afinal.db,同时自动创建了表com_devchina_ormdemo_User。可是,我们不想创建数据库afinal.db,也不想让我们的表示com_devchina_ormdemo_User,那我们应该怎么办呢?

这一些呀,afinal都已经想好了。

接下来,我们来介绍下afinal的orm注解功能。

第一个,配置数据库中的表名  net.tsz.afinal.annotation.sqlite.Table,我们来给user,java配置一下:
package com.devchina.ormdemo;
 
import java.util.Date;
 
import net.tsz.afinal.annotation.sqlite.Table;
 
@Table(name="user_test")
public class User {
     
    private int id;
    private String name;
    private String email;
    private Date registerDate;
    private Double money;
     
    /getter and setter///
    //代码太长,略getter setter,开发中不能省略
}
这里和上边唯一不同的是 多了一个注解 @Table(name="user_test"),只要我们配置了这个以后,我们再来看下afinal创建的数据库和表:

由此,我们可以看出来,afinal又自动给我们创建了表user_test,
但是要注意的是com_devchina_ormdemo_User这个表afinal并没有去删除,所以这里也要提醒下大家,我们在重新设计了类的结构或者属性的时候,先手动删除掉直接的数据,否则就会有垃圾数据保存在数据库里面,当然,不删除也可以,不会有任何的影响。

在上面的讲述中,细心的朋友可能会注意到了一个问题,afinal自动把user的id的这个属性当做了主键。而且自动增长。

可是,可是在我们的开发过程中,我们的user可能没有id这个属性啊,可能是userId,或者又可能是其他我们喜欢的属性,那怎么办呢?

没有关系:afinal有给我们准备了另一个注解:net.tsz.afinal.annotation.sqlite.Id,通过这个,我们就可以给我们的实体类定义主键啦

afinal的主键机制是:

当给某个属性添加注解@id的时候,该属性就是主键(一个类中只有一个主键),保存在数据库中的列名为属性的名称,@Id(column="userId")给属性添加注解的时候,保存在数据库的列名是userId,当这个属性没有的时候,afinal自动回去该类查找_id属性,_id属性也没有的时候,afinal就会自动去查找id属性。如果连id属性也没有,那么afinal就报错啦,afinal的orm规则中,表示必须有主键的,而且只能有一个(目前暂时不支持复合主键)。

回到刚才的问题,afinal给我们自动创建数据库afinal.db,可是,我们不想创建让数据库名是afinal.db,那怎么办呢?

afinal的创建时候有多个方法的重载。

在create的方法中,

isDebug表示是否是debug模式,debug模式中,使用afinal操作数据库的时候就会答应SQL语句的log,

dbName就是数据库的名称啦。

所以这里,我们传入我们自己想要的数据库名称就行了。


其实afinal的FinalDb模块中,还有很多其他的功能,比如一对多,多对一的配置和注解等等。等待大家挖掘了。

afinal的orm注解中有:
Id------->注解注解
Property------>属性注解
Table------->数据表注解
ManyToOne-------->多对一注解
OneToMany--------->一对多注解
Transient------->忽略属性注解(如果该属性添加这个注解,afinal的orm功能将忽略该属性)


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使用方法

FinalHttp 是对 HttpClient再次封装,最简洁的就是增加了许多回调的方法,对Get 和 Post 请求进行了简化。另外一点就是FinalHttp加入线程池操作,默认的Http请求池连接为3。下面是为FinalHttp可配置的操作。
FinalHttp finalHttp = new FinalHttp();
finalHttp.addHeader("Accept-Charset", "UTF-8");//配置http请求头
finalHttp.configCharset("UTF-8");
finalHttp.configCookieStore(null);
finalHttp.configRequestExecutionRetryCount(3);//请求错误重试次数
finalHttp.configSSLSocketFactory(null);
finalHttp.configTimeout(5000);//超时时间
finalHttp.configUserAgent("Mozilla/5.0");//配置客户端信息

普通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();

公共方法

public void getDataByPost(Context context, String URL, final HttpOnStartInter startInter,
final HttpSuccessInter successInter, final HttpOnFailInter failInter
) {//自定义的3个接口,用于回调
if (!WifiUtil.isConnectivity(context)) {
return;
}
FinalHttp http = new FinalHttp();
http.post(URL, new AjaxCallBack<String>() {
@Override
public void onStart() {
startInter.httpOnStart();//交互中
}
@Override
public void onSuccess(String t) {
successInter.httpOnSuccess(t);//成功
}
@Override
public void onFailure(Throwable t, int errorNo, String strMsg) {
failInter.httpOnFail();//失败
}
});
}

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]);

AfinalBitmap配置调用

代码:
初始化代码
bitmap = FinalBitmap.create(this.getApplicationContext()); 初始化  
bitmap.configBitmapLoadThreadSize(3);定义线程数量  
bitmap.configDiskCachePath(this.getApplicationContext().getFilesDir().toString());设置缓存目录;  
bitmap.configDiskCacheSize(1024 * 1024 * 10);设置缓存大小  
bitmap.configLoadingImage(R.drawable.news_default);设置加载图片  
 
2、调用代码
bitmap.display(imageView, newsinfoa.getImageUrl());第一个参数为iamgeview组件,第二个为加载的url地址  


//第一种方式:image为要显示图片的控件
bitmap.display(iv, uri);
//第二种方式:loadingBitmap为正在加载时显示的图片
//bitmap.display(iv, uri, loadingBitmap);
//第三种方式:loadingBitmap为加载中图片,failBitmap为加载失败图片
// bitmap.display(iv, uri, loadingBitmap, failBitmap);
//第四种方式:我们也可以设置加载图片的大小
//bitmap.display(iv, uri, 100, 100);
//第五种方式:设置加载图片的大小以及加载中和加载失败的图片
//bitmap.display(iv, uri, 100, 100, loadingBitmap, failBitmap);

 类似资料: