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()方法用来添加或者替换数值。

 

 

同样这个类的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类抛出的异常信息。

一个好用的工具JsonViewer

Json的数据格式可读性较差，但是借助这个工具，可以清晰看出它的数据结构。

官方地址 http://jsonviewer.codeplex.com/Release/ProjectReleases.aspx?ReleaseId=5432

软件操作很简单，一张截图，大家就明白了。

 

附上的JsonDemo

先看一下截图

 

 

 

代码下载

            

其中Jsondemo.zip是演示代码；Jsonview.zip是辅助查看小工具jsonviewer，

用来查看”豆瓣返回的json格式数据”。

 

 

ified example taken from * http://senior.ceng.metu.edu.tr/2009/praeda/2009/01/11/a-simple-restful-client-at-android/ * * This class will connect to a website, get a JSON Object and display results into a textview. * @author Damon Skelhorn - eighty-six.co.uk */ package com.damon86.httpdownload; import java.io.InputStream; import android.app.Activity; import android.os.Bundle; import android.widget.LinearLayout; import android.widget.TextView; import java.io.IOException; import java.io.BufferedReader; import java.io.InputStreamReader; import org.apache.http.HttpEntity; import org.apache.http.HttpResponse; import org.apache.http.client.HttpClient; import org.apache.http.client.methods.HttpGet; import org.apache.http.impl.client.DefaultHttpClient; import org.json.JSONArray; import org.json.JSONException; import org.json.JSONObject; public class Httpdwld extends Activity { /** Called when the activity is first created. */ TextView txt; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // Create a crude view - this should really be set via the layout resources // but since its an example saves declaring them in the XML. LinearLayout rootLayout = new LinearLayout(getApplicationContext()); txt = new TextView(getApplicationContext()); rootLayout.addView(txt); setContentView(rootLayout); // Set the text and call the connect function. txt.setText("Connecting..."); txt.setText(connect("http://rentopoly.com/ajax.php?query=Bo")); } private String connect(String url){ // Create the httpclient HttpClient httpclient = new DefaultHttpClient(); // Prepare a request object HttpGet httpget = new HttpGet(url); // Execute the request HttpResponse response; // return string String returnString = null; try { // Open the webpage. response = httpclient.execute(httpget); if(response.getStatusLine().getStatusCode() == 200){ // Connection was established. Get the content. HttpEntity entity = response.getEntity(); // If the response does not enclose an entity, there is no need // to worry about connection release if (entity != null) { // A Simple JSON Response Read InputStream instream = entity.getContent(); // Load the requested page converted to a string into a JSONObject. JSONObject myAwway = new JSONObject(convertStreamToString(instream)); // Get the query value' String query = myAwway.getString("query"); // Make array of the suggestions JSONArray suggestions = myAwway.getJSONArray("suggestions"); // Build the return string. returnString = "Found: " + suggestions.length() + " locations for " + query; for (int i = 0; i < suggestions.length(); i++) { returnString += "/n/t" + suggestions.getString(i); } // Cose the stream. instream.close(); } } else { // code here for a response othet than 200. A response 200 means the webpage was ok // Other codes include 404 - not found, 301 - redirect etc... // Display the response line. returnString = "Unable to load page - " + response.getStatusLine(); } } catch (IOException ex) { // thrown by line 80 - getContent(); // Connection was not established returnString = "Connection failed; " + ex.getMessage(); } catch (JSONException ex){ // JSON errors returnString = "JSON failed; " + ex.getMessage(); } return returnString; } private static String convertStreamToString(InputStream is) { /* * To convert the InputStream to String we use the BufferedReader.readLine() * method. We iterate until the BufferedReader return null which means * there's no more data to read. Each line will appended to a StringBuilder * and returned as String. */ BufferedReader reader = new BufferedReader(new InputStreamReader(is)); StringBuilder sb = new StringBuilder(); String line = null; try { while ((line = reader.readLine()) != null) { sb.append(line + "/n"); } } catch (IOException e) { e.printStackTrace(); } finally { try { is.close(); } catch (IOException e) { e.printStackTrace(); } } return sb.toString(); } } JSON HttpClient Example This entry was posted on Sunday, January 24th, 20