一、JSON是什麼？

JSON(JavaScript Object Notation) 是一種輕量級的資料交換格式。易於人閱讀和編寫，同時也易於機器解

析和生成。它基於JavaScript（Standard ECMA-262 3rd Edition - December 1999）的一個子集。 JSON採用完全獨立於語言的文字格式，但是也使用了類似於C語言家族的習慣（包括C, C , C#, Java, JavaScript, Perl, Python等）。這些特性使JSON成為理想的資料交換語言。

二 、struts2對於JSON有什麼支援？

struts2提供了一個struts2-json-plugin.jar 用於支援JSON的使用。當我們在struts2中使用JSON的時候

必須匯入struts2-json-plugin.jar。

          在 struts2-json-plugin.jar 中有一個 struts-plugin.xml 定義了 json-default 繼承自 struts-default 。

<struts>
    <package name="json-default" extends="struts-default">

        <result-types>
            <result-type name="json" class="org.apache.struts2.json.JSONResult"/>
        </result-types>

        <interceptors>
            <interceptor name="json" class="org.apache.struts2.json.JSONInterceptor"/>
            <interceptor name="jsonValidation" class="org.apache.struts2.json.JSONValidationInterceptor"/>

            <!-- Sample JSON validation stack -->
            <interceptor-stack name="jsonValidationWorkflowStack">
                <interceptor-ref name="basicStack"/>
                <interceptor-ref name="validation">
                    <param name="excludeMethods">input,back,cancel</param>
                </interceptor-ref>
                <interceptor-ref name="jsonValidation"/>
                <interceptor-ref name="workflow"/>
            </interceptor-stack>

        </interceptors>

    </package>
</struts>
 

注意: 我們自己定義的 package 需要繼承 json-default  才能使用。

<package name="jsonPackage" extends="json-default">

<span style="font-size:10px;"><action name="VERSION" class="com.cairenhui.sec.action.AppAction" method="getAppVersion">
	<result name="success" type="json">
	<span style="white-space:pre">	</span><param name="root">resMap</param>  
	</result>
</action>
		
<action name="ajaxVerify!*" class="com.cairenhui.sec.action.VerifyAction" method="{1}">
	<result name="success" type="json">
		<param name="includeProperties">resMap.*</param>
	</result>
</action>  </span>
 

三、關於JSON在struts.xml中的一些屬性的功能。

<action name="*"  class="*">  
          
   <result name="success" type="json">  
   
   <param name=""></param>//關於對JSON的一些定義  <span style="color:#ff0000;">這裡可能會用到一些正則的表達方式</span>
  
   /*
   excludeProperties   //代表排除Action中的哪些屬性，排除多個屬性時，使用逗號進行分隔（即不需要序列化的屬性） 
   例：<param name="excludeProperties">age</param>  排除getAge()這個方法 為什麼是排除這個方法下面詳解 
                     
   includeProperties   //代表包含Action中的哪些屬性，包含多個屬性是，使用逗號進行分隔（即需要序列化的屬性） 
   例：<param name="includeProperties">address</param>包含getAddress()這個方法 為什麼是包含這個方法下面詳解 
                     
   excludeNullProperties //代表排除Action中屬性值為空的欄位 
   例：<param name="excludeNullProperties">true</param> 使用true/false 預設為false(即包含屬性值為null的欄位) 
                     
   root  //代表從哪裡開始序列化 
   例：<param name="root">person</param> person對應的可以是一個屬性，也可以是一個物件，也可以是一個集合 
     //當在這裡定義後，只會將person進行序列化,如果person是一個物件，則會將person物件中所有的getter方法都進行序列化 
                     
    注意：如果相同屬性同時定義了excludeProperties和includeProperties 
        那麼excludeProperties的優先順序要高，因此不對 
    該屬性進行序列化 
    */  
    </result>  
</action>  

四、關於JSON在Action物件中註解的使用。

		

	 	    例：@JSON(name = "myname") 則在客戶端接收到的JSON中UserName屬性對應的地方為 ：
                     {myname:"張三"} 以前的則是{username:"張三"}
		     public String getUsername() {
				return username;
		     }
				*/
			serialize：對該方法進行序列化  true/false
				/*
			例：@JSON(serialize=true) 對該方法序列化，如果為false則不進行序列化
				public String getUsername() {
							return username;
						}
				*/
			deserialize：不對該方法進行序列化  true/false
				/*
			例：@JSON(deserialize=true) 不對該方法序列化，如果為false則進行序列化
				public String getUsername() {
							return username;
						}
				*/
			format：設定JSON對該方法的轉換方式，一般用於對時間進行轉換 
				/*
			例：@JSON(format="yyyy-MM-dd")  則客戶端接收的JSON中date對應的值為：
                                              {date:"2011-10-2"}
						public Date getDate() {
						return date;
						}
				*/

五、具體的例項：

 Action

    package org.viancent.action;  
  
    import java.util.Date;  
    import org.apache.struts2.json.annotations.JSON;  
    import com.opensymphony.xwork2.ActionSupport;  
    public class GetJsonAction extends ActionSupport {  
          
        private String username;  
        private String password;  
        private int age;  
        private Date date;  
  
        @JSON(serialize = false)  
        public String getUsername() {  
            return username;  
        }  
  
        public void setUsername(String username) {  
            this.username = username;  
            }  
          
        @JSON(name="mypassword")  
        public String getPassword() {  
            return password;  
        }  
  
        public void setPassword(String password) {  
            this.password = password;  
        }  
  
        public int getAge() {  
            return age;  
        }  
  
        public void setAge(int age) {  
            this.age = age;  
        }  
          
        @JSON(format="yyyy-MM-dd")  
        public Date getDate() {  
            return date;  
        }  
  
        public void setDate(Date date) {  
            this.date = date;  
        }  
  
        @Override  
        public String execute() throws Exception {  
            this.setDate(new Date());  
            this.setAge(10);  
            this.setPassword("world");  
            this.setUsername("hello");  
            return SUCCESS;  
        }  
    }  

  struts.xml

<struts>  
    <package name="struts2"  extends="json-default">  
    //這裡一定要繼承json-default  
        <action name="getjsons" class="org.viancent.action.GetJsonAction">  
            <result name="success"  type="json">  
            //這裡一定要定義type屬性為json  
                <param name="excludeProperties">age</param>       
            //排除getAge()方法            
            </result>  
        </action>  
  
    </package>  
</struts>   

  JSP:

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>  
  
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  
<html>  
    <head>  
        <script type="text/javascript" src="WEB-JS/jquery-1.5.1.js"></script>   //使用jquery一定要匯入js  
          
                <script type="text/javascript"> //使用jquery實現非同步提交  
                    function getJson() {  
                        $.post(  
                            "/struts2/getjsons.action",{},function(returnedData,status)  
                            {  
                                if("success"==status)  
                                {  
                                    alert(returnedData);  
                                }  
                            }  
                        )  
                    }  
                </script>  
    </head>  
    <body id="theBody">  
        <input type="button" value="GetJson" onclick="getJson();">  
  
    </body>  
</html>  

 得到的結果為：{"date":"2011-03-21","mypassword":"world"}