Android上基于JSON的数据交互应用

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.JSONObject     Array，一组有序的数据列表。org.json.JSONArray

 

Android中 JSON相关的类(4个)和Exceptions(1个)：

l  JSONArray

l  JSONObject

l  JSONStringer

l  JSONTokener

l  JSONException

 

 

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 = new JSONStringer().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类型数值：

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;
    }
}

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文件；

运行结果如下图：