JSON的定义:
一种轻量级的数据交换格式,具有良好的可读和便于快速编写的特性。业内主流技术为其提供了完整的解决方案(有点类似于正则表达式,获得了当今大部分语言的支持),从而可以在不同平台间进行数据交换。JSON采用兼容性很高的文本格式,同时也具备类似于C语言体系的行为。–Json.org
为什么用JSON?
很简单,因为它比xml快十倍。
有哪些应用案例?
Twitter、豆瓣、facebook等公司的开放api,一般这些服务都会提供多种格式供开发人员选择(xml、json、atom等),而在手机终端上,我们自然希望给用户最佳体验,所以我选用最有效率的json格式。
按照我的文档习惯,将会附上具体demo,在本文档末尾中可找到下载,其中的示例是用豆瓣api。
JSON的结构:
Name/Value Pairs类似所熟知的Keyed list、Hash table、Disctionary和Associative array。在Android平台中同时存在另外一个类“Bundle”,某种程度上具有相似的行为。
org.json.JSONObjectArray,一组有序的数据列表。org.json.JSONArray
Android中JSON相关的类(4个)和Exceptions(1个):
lJSONArray
lJSONObject
lJSONStringer
lJSONTokener
lJSONException
JSONObject:
这是系统中有关JSON定义的基本单元,其包含一对儿(Key/Value)数值。它对外部(External:应用toString()方法输出的数值)调用的响应体现为一个标准的字符串(例如:{"JSON": "Hello, World"},最外被大括号包裹,其中的Key和Value被冒号":"分隔)。其对于内部(Internal)行为的操作格式略微,例如:初始化一个JSONObject实例,引用内部的put()方法添加数值:new JSONObject().put("JSON", "Hello, World!"),在Key和Value之间是以逗号","分隔。
Value的类型包括:Boolean、JSONArray、JSONObject、Number、String或者默认值JSONObject.NULL object。
有两个不同的取值方法:
get():在确定数值存在的条件下使用,否则当无法检索到相关Key时,将会抛出一个Exception信息。
opt():这个方法相对比较灵活,当无法获取所指定数值时,将会返回一个默认数值,并不会抛出异常。
JSONArray:
它代表一组有序的数值。将其转换为String输出(toString)所表现的形式是用方括号包裹,数值以逗号”,”分隔(例如:[value1,value2,value3],大家可以亲自利用简短的代码更加直观的了解其格式)。这个类的内部同样具有查询行为,get()和opt()两种方法都可以通过index索引返回指定的数值,put()方法用来添加或者替换数值。
例子1: Array里面包含对象(object)
[ {"id":1,"name":"小猪" ,"age”:22} ,{"id":2,"name":"小猫","age”:23}, .......]
例子2:同样对象(object)中可以包含Array
(1)一个对象包含1个数组,2个子对象
{"root":[{"id":"001","name":"小猪"},{"id":"002","name":"小猫"},{"id":"003","name":"小狗"}],
"total":3,
"success":true
}
(2)也可以对象嵌套子对象,子对象再嵌套数组
{"calendar":{"calendarlist":
[
{"id":"001","name":"小猪"},
{"id":"002","name":"小猫"}
]
}
}
同样这个类的value类型可以包括:Boolean、JSONArray、JSONObject、Number、String或者默认值JSONObject.NULL object。
JSONStringer:
根据官方的解释,这个类可以帮助快速和便捷的创建JSON text。其最大的优点在于可以减少由于格式的错误导致程序异常,引用这个类可以自动严格按照JSON语法规则(syntax rules)创建JSON text。每个JSONStringer实体只能对应创建一个JSON text。
根据下边的实例来了解其它相关信息:
string myString =newJSONStringer().object()
.key("AR").value("www.Androidres.com!")
.endObject()
.toString();
结果是一组标准格式的JSON text:{”AR”:”www.Androidres.com!”}
其中的.object()和.endObject()必须同时使用,是为了按照Object标准给数值添加边界。同样,针对数组也有一组标准的方法来生成边界.array()和.endArray()。
JSONTokener:
这个是系统为JSONObject和JSONArray构造器解析JSON source string的类,它可以从source string中提取数值信息。
JSONException:
是JSON.org类抛出的异常信息
下面引用一个完整的应用实例:
应用JSONObject存储Map类型数值:
- publicclassHelloJSONActivityextendsActivity{
- /**Calledwhentheactivityisfirstcreated.*/
- Buttonb_parse;
- TextViewtv;
- @Override
- publicvoidonCreate(BundlesavedInstanceState){
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- tv=(TextView)findViewById(R.id.tv);
- b_parse=(Button)findViewById(R.id.parse_json);
- b_parse.setOnClickListener(newParseJSONListener());
- }
- classParseJSONListenerimplementsOnClickListener{
- @Override
- publicvoidonClick(Viewv){
- Map<String,Map<String,String>>maps=newHashMap<String,Map<String,String>>();
- Map<String,String>map=newHashMap<String,String>();
- map.put("0001","a");
- map.put("0002","b");
- map.put("0003","c");
- Map<String,String>map2=newHashMap<String,String>();
- map2.put("1001","aa");
- map2.put("1002","bb");
- map2.put("1003","cc");
- maps.put("1",map);
- maps.put("2",map2);
- JSONObjectjsonObjec=getJSON(maps);
- tv.setText(jsonObjec.toString());
- System.out.println(jsonObjec.toString());
- }
- }
- publicstaticJSONObjectgetJSON(Mapmap){
- Iteratoriter=map.entrySet().iterator();
- JSONObjectholder=newJSONObject();
- while(iter.hasNext()){
- Map.Entrypairs=(Map.Entry)iter.next();
- Stringkey=(String)pairs.getKey();
- Mapm=(Map)pairs.getValue();
- JSONObjectdata=newJSONObject();
- try{
- Iteratoriter2=m.entrySet().iterator();
- while(iter2.hasNext()){
- Map.Entrypairs2=(Map.Entry)iter2.next();
- data.put((String)pairs2.getKey(),(String)pairs2
- .getValue());
- }
- holder.put(key,data);
- }catch(JSONExceptione){
- Log.e("Transforming","TherewasanerrorpackagingJSON",e);
- }
- }
- returnholder;
- }
- }
public class HelloJSONActivity extends Activity {
/** Called when the activity is first created. */
Button b_parse;
TextView tv;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
tv= (TextView)findViewById(R.id.tv);
b_parse = (Button)findViewById(R.id.parse_json);
b_parse.setOnClickListener(new ParseJSONListener());
}
class ParseJSONListener implements OnClickListener{
@Override
public void onClick(View v) {
Map<String, Map<String, String>> maps = new HashMap<String, Map<String, String>>();
Map<String, String> map = new HashMap<String, String>();
map.put("0001", "a");
map.put("0002", "b");
map.put("0003", "c");
Map<String, String> map2 = new HashMap<String, String>();
map2.put("1001", "aa");
map2.put("1002", "bb");
map2.put("1003", "cc");
maps.put("1", map);
maps.put("2", map2);
JSONObject jsonObjec = getJSON(maps);
tv.setText(jsonObjec.toString());
System.out.println(jsonObjec.toString());
}
}
public static JSONObject getJSON(Map map) {
Iterator iter = map.entrySet().iterator();
JSONObject holder = new JSONObject();
while (iter.hasNext()) {
Map.Entry pairs = (Map.Entry) iter.next();
String key = (String) pairs.getKey();
Map m = (Map) pairs.getValue();
JSONObject data = new JSONObject();
try {
Iterator iter2 = m.entrySet().iterator();
while (iter2.hasNext()) {
Map.Entry pairs2 = (Map.Entry) iter2.next();
data.put((String) pairs2.getKey(), (String) pairs2
.getValue());
}
holder.put(key, data);
} catch (JSONException e) {
Log.e("Transforming", "There was an error packaging JSON", e);
}
}
return holder;
}
}
配置main.xml文件;
运行结果如下图: