android-data-binding
这是一个可以将 json 字符串 直接绑定到 view 上的库， 不用先将 json 转换为 model 类。
github 传送门: https://github.com/gplibs/android-data-binding
1. 安装
gradle:
dependencies { compile 'com.gplibs:data-binding:1.0.0'}2. 一个简单的例子
json字符串数据源 json_data_source_binding_json.txt:
{
name: "my name"}StringJsonDataSourceBindingActivity:
public class StringJsonDataSourceBindingActivity extends AppCompatActivity { // 将 json 中的 name 字符段绑定到 TextView 的 text 上
@Binding(source = "name", target = "text") private TextView tvName; @Override
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_string_json_data_source_binding);
tvName = (TextView) findViewById(R.id.tv_name); // 读取json数据
String json = Utils.readText("json_data_source_binding_json.txt"); // 绑定操作
BindingManager.binding(json, this);
}
}运行结果
3. 值转换
某些时候数据源的类型可能与 view 的目标字段类型不一致，此时就需要对值进行转换。
json字符串数据源 convert_binding_json.txt:
{
name: "my name",
sex: 1,
head_url: "https://github.com/gplibs/resources/raw/master/sample.jpeg",
is_vip: true}定义一个将 boolean 转换为 visibility 的转换器:
class BooleanToVisibilityConverter implements IValueConverter { @Override
public Object convert(Object sourceValue) { return ((Boolean) sourceValue) ? View.VISIBLE : View.GONE;
}
}定义一个将 表示性别的整形值 转换为对应文本的转换器:
class SexToStringConverter implements IValueConverter { @Override
public Object convert(Object sourceValue) { return (((Integer) sourceValue) == 0) ? "Female" : "Male";
}
}定义一个将 url字符串 转换为 bitmap 的转换器:
(为了不阻塞主线程,实现的是一个异步转换器接口 IAsyncValueConverter)
class UrlToBitmapConverter implements IAsyncValueConverter { @Override
public void convert(final Object sourceValue, final IValueConverterCallback callback) {
Executors.newSingleThreadExecutor().submit(new Runnable() { @Override
public void run() { try {
URL url = new URL((String) sourceValue);
callback.run(BitmapFactory.decodeStream(url.openStream()));
} catch (Exception ex) {
ex.printStackTrace();
}
}
});
}
}ConvertBindingActivity:
public class ConvertBindingActivity extends AppCompatActivity { @Binding(source = "name", target = "text") private TextView tvName; // 使用转换器将 json 中整形字段 sex 转换为对应文案， 绑定到 TextView 的 text 上
@ConvertBinding(source = "sex", target = "text", converter = SexToStringConverter.class) private TextView tvSex; // 使用转换器将 json 中布尔字段 is_vip 转换为对应 visibility， 绑定到 TextView 的 visibility 上, 是 vip 才显示
@ConvertBinding(source = "is_vip", target = "visibility", converter = BooleanToVisibilityConverter.class) private TextView tvVip; // 使用转换器将 json 中布尔字段 head_url 转换为 bitmap， 绑定到 ImageView 的 imageBitmap 上
@ConvertBinding(source = "head_url", target = "imageBitmap", converter = UrlToBitmapConverter.class) private ImageView ivHead; @Override
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_convert_binding);
tvName = (TextView) findViewById(R.id.tv_name);
tvSex = (TextView) findViewById(R.id.tv_sex);
tvVip = (TextView) findViewById(R.id.tv_vip);
ivHead = (ImageView) findViewById(R.id.iv_head); // 读取json数据
String json = Utils.readText("convert_binding_json.txt"); // 绑定操作
BindingManager.binding(json, this);
}
}运行结果
4. 将多个字段绑定到同一个 View 的不同属性上
json字符串数据源 multi_binding_json.txt:
{
name: "my name",
is_vip: true,
vip_data: "I am Vip"}定义一个将 boolean 转换为 visibility 的转换器:
class BooleanToVisibilityConverter implements IValueConverter { @Override
public Object convert(Object sourceValue) { return ((Boolean) sourceValue) ? View.VISIBLE : View.GONE;
}
}MultiBindingActivity:
public class MultiBindingActivity extends AppCompatActivity { @Binding(source = "name", target = "text") private TextView tvName; // 将 json 字段 is_vip 绑定到 TextView 的 visibility 上, 是 vip 才显示
// 将 json 字段 vip_data 绑定到 TextView 的 text 上
@ConvertBinding(source = "is_vip", target = "visibility", converter = BooleanToVisibilityConverter.class) @Binding(source = "vip_data", target = "text") private TextView tvVip; @Override
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_multi_binding);
tvName = (TextView) findViewById(R.id.tv_name);
tvVip = (TextView) findViewById(R.id.tv_vip); // 读取 json 文本
String json = Utils.readText("multi_binding_json.txt"); // 绑定操作
BindingManager.binding(json, this);
}
}运行结果
5. 路径绑定
某些 json 有较复杂的数据结构，有子对象 或者 数组; 我们也可以将子对象或者数组中的字段绑定到 View 上;
路径绑定语法中 "." 可以获取子对象; ".[数字索引]" 可以获取数组中某索引处的元素。
json字符串数据源 path_binding_json.txt:
{
name: "my name",
father:
{
name: "my father"
},
children:
[ {
name: "my son"
},
{
name: "my daughter"
}
]}PathBindingActivity:
public class PathBindingActivity extends AppCompatActivity { @Binding(source = "name", target = "text") private TextView tvName; // 将 json 中子对象 father 的 name 字段绑定到 TextView 的 text 上
@Binding(source = "father.name", target = "text") private TextView tvFatherName; // 将 json 中子对象 children 数组的第0个元素的 name 字段绑定到 TextView 的 text 上
@Binding(source = "children.[0].name", target = "text") private TextView tvSonName; // 将 json 中子对象 children 数组的第1个元素的 name 字段绑定到 TextView 的 text 上
@Binding(source = "children.[1].name", target = "text") private TextView tvDaughterName; @Override
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_path_binding);
tvName = (TextView) findViewById(R.id.tv_name);
tvFatherName = (TextView) findViewById(R.id.tv_father_name);
tvSonName = (TextView) findViewById(R.id.tv_son_name);
tvDaughterName = (TextView) findViewById(R.id.tv_daughter_name); // 读取 json 文本
String json = Utils.readText("path_binding_json.txt"); // 绑定操作
BindingManager.binding(json, this);
}
}运行结果
5. 其他非字符串数据源
除了可以使用 json 字符串作为数据源外，我们也简单支持其他数据源进行绑定。
a. Model类作为数据源， 需实现 ModelSource:
class TestModel extends ModelSource { // @BindingField注解作用为：让框架使用其标注的名称作为绑定中数据源字段名
// GSON 中的 @SerializedName 注解也有同样的效果
@BindingField("name") public String name = "my name";
}public class ModelSourceActivity extends AppCompatActivity { @Binding(source = "name", target = "text") private TextView tvName; private Button btnTest; private int index; private TestModel testModel = new TestModel(); @Override
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_model_source);
tvName = (TextView) findViewById(R.id.tv_name);
btnTest = (Button) findViewById(R.id.btn_test);
btnTest.setOnClickListener(new View.OnClickListener() { @Override
public void onClick(View v) { // 修改 ModelSource 的 name 属性, 界面也会一起改变。
testModel.setProperty("name", "new name " + (++index));
}
}); // 绑定操作
BindingManager.binding(testModel, this);
}
}运行结果
b. 数组数据源:
可以使用 "[数字索引]" 语法将某个元素绑定到 View。
public class ArraySourceActivity extends AppCompatActivity { @Binding(source = "[0]", target = "text") private TextView tvName; @Override
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_array_source);
tvName = (TextView) findViewById(R.id.tv_name);
String[] data = new String[] { "item1", "item2", "item3" };
BindingManager.binding(data, this);
}
}c. Collection数据源:
与数组数据源一样
public class CollectionSourceActivity extends AppCompatActivity { @Binding(source = "[1]", target = "text") private TextView tvName; @Override
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_collection_source);
tvName = (TextView) findViewById(R.id.tv_name);
Collection<String> data = new ArrayList<>();
data.add("item1");
data.add("item2");
data.add("item3");
BindingManager.binding(data, this);
}
}d. Map数据源:
只支持 Key 类型为 String 的 Map。
public class MapSourceActivity extends AppCompatActivity { @Binding(source = "key1", target = "text") private TextView tvName; @Override
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_map_source);
tvName = (TextView) findViewById(R.id.tv_name);
Map<String, String> data = new HashMap<>();
data.put("key1", "value1");
BindingManager.binding(data, this);
http://www.cnblogs.com/gplibs/p/6536658.html延伸阅读
- Swift实现JSON转Model - HandyJSON使用讲解 2017-07-26 16:41:51.797
- [Android FrameWork 6.0源码学习] View的重绘过程之Measure 2017-07-26 16:27:03.317
- protobuf转json 2017-07-26 16:13:35.07
- 扩展entity framework core 实现默认字符串长度,decimal精度,entity自动注册和配置 2017-07-26 15:52:06.747
- 基于Json序列化和反序列化通用的封装 2017-07-25 17:06:10.47
- c#通用配置文件读写类（xml,ini,json） 2017-07-21 09:31:13.93
- 字符串和关系表的转化 2017-07-18 10:15:01.223
- 自定义七天签到View 2017-07-16 15:46:44.637
- View学习(二)-View的测量（measure）过程 2017-07-11 17:00:45.49
- View学习（三）- View的布局（layout）过程 2017-07-11 09:06:17.407
Swift实现JSON转Model - HandyJSON使用讲解