java转json工具类说明文档.doc

Java转json工具类说明文档在公版原型项目中，前台使用Ext框架进行数据展示，由于Ext框架的特性是对AJAX的完美支持，所以在项目中前台与后台的交互基本是通过AJAX实现，使页面无刷新。大多的Ajax框架的数据交互都基于Json，所以本系统在选择前后台交互时也使用的是Json。后台逻辑在后的前台请求后，进行相应处理，处理后结果为java对象，因为使用的是Json格式的数据交互，所以在后台得到处理结果（java对象）后，还需要再进行一步转换的工作，要将java对象转换为Json对象，然后返回给前台进行结果展示。在此提供两个工具类JsonUtilsForJsonLib和JsonUtils，这两个类的作用都是将java对象转换为Json对象。只不过一个是使用了官方提供的jar包，将java对象转换为JSONObject或JSONArray对象。另一个是直接将java对象拼接为Json格式的字符串，再进行传递。两个类都可以使用。下面是两个类的使用说明文档：JsonUtils在使用此类时只需使用此类中的一个方法即可，方法如下：public static String objectToJson(Object obj)参数：Object obj返回值：String此方法接收一个参数，参数类型为Object，即任何类型，可以是基本数据类型（即String、int、double、boolean等等），也可以是引用数据类型（对象、数组、集合等等），在方法中会对传入的参数进行判断，然后根据具体的参数类型，调用不同的转换方法，最终返回Json格式字符串。注意：JsonUtils类返回值为String类型。下面一一介绍此类中方法：public static String stringToJson(String s)参数：String s返回值：String此方法接收一个String类型的参数，返回此参数对应的Json格式字符串，如果参数为null，则调用nullToJson()方法，返回”（空字符串）。返回的Json格式字符串格式为：”abc”（参数s的值）public static String nullToJson()参数：空返回值：String此方法返回一个空字符串。返回的Json格式字符串格式为：”public static String numberToJson(Number number)参数：Number number返回值：String此方法接收一个Number类型的参数，返回此参数对应的Json格式字符串。返回的Json格式字符串格式为：123（参数s的值）public static String booleanToJson(Boolean bool)参数：Boolean bool返回值：String此方法接收一个Boolean类型的参数，返回此参数对应的Json格式字符串。返回的Json格式字符串格式为：true（参数s的值）public static String beanToJson(Object bean)参数：Object bean返回值：String此方法接收一个Object类型的参数，返回此参数对应的Json格式字符串，返回的Json格式字符串格式为：“property1”:”value1”,”property2”:”value2”public static String listToJson(List list)参数：List list返回值：String此方法接收一个List类型的参数，返回此参数对应的Json格式字符串，返回的Json格式字符串格式为：“1”,”2”,”public static String arrayToJson(Object array)参数：Object array返回值：String此方法接收一个Object类型的参数，返回此参数对应的Json格式字符串，返回的Json格式字符串格式为：“1”,”2”,”3”,”json”public static String mapToJson(Map map)参数：Map map返回值：String此方法接收一个Map类型的参数，返回此参数对应的Json格式字符串，返回的Json格式字符串格式为：“key1”:”value1”,”key2”:”value2”public static String setToJson(Set set)参数：Set set返回值：String此方法接收一个Set类型的参数，返回此参数对应的Json格式字符串，返回的Json格式字符串格式为：“1”,”2”,”JsonUtilsForJsonLib对于基本数据类型（即String、int、double、boolean等），统一使用此类中一个方法即可，方法如下：public static JSONObject basicDataTypeToJson(String key, Object obj)参数：String key, Object obj返回值：JSONObject此方法接收两个参数，key参数作为转换后Json对象中的键值，obj参数类型为Object，可以是任何基本数据类型（即String、int、double、boolean等等），在方法中会对传入的参数进行判断，然后根据具体的参数类型，调用不同的转换方法，最终返回JSONObject类型对象。注意：JsonUtilsForJsonLib类返回值为JSONObject类型。对于基本数据类型的转换，和上面的JsonUtils类返回值的格式有很大不同，请自行选择使用。下面一一介绍此类中方法：public static JSONObject stringToJson(String key, String s)参数：String key, String s返回值：JSONObject此方法接收两个参数，key参数用来作为键，s参数作为值构造JSONObject对象，并返回构造的JSONObject对象。返回的JSONObject对象格式为：“key值”:”s值”public static JSONObject numberToJson(String key, Number number)参数：String key, Number number返回值：JSONObject此方法接收两个参数，key参数用来作为键，number参数作为值构造JSONObject对象，并返回构造的JSONObject对象。返回的JSONObject对象格式为：“key值”:number值public static JSONObject booleanToJson(String key, Boolean bool)参数：String key, Boolean bool返回值：JSONObject此方法接收两个参数，key参数用来作为键，bool参数作为值构造JSONObject对象，并返回构造的JSONObject对象。返回的JSONObject对象格式为：“key值”: bool值public static JSONObject nullToJson(String key)参数：String key返回值：JSONObject此方法接收两个参数，key参数用来作为键，”作为值构造JSONObject对象，并返回构造的JSONObject对象。返回的JSONObject对象格式为：“key值”:”public static JSONObject beanToJson(Object bean)参数：Object bean返回值：JSONObject此方法接收一个Object类型的参数，返回此参数对象对应的JSONObject对象，返回的JSONObject对象格式为：“property1”:”value1”,”property2”:”value2”public static JSONArray listToJson(List list)参数：List list返回值：JSONArray此方法接收一个List类型的参数，返回此集合对应的JSONArray对象，返回的JSONArray对象格式为：“1”,”2”,”public static JSONArray arrayToJson(Object array)参数：Object array返回值：JSONArray此方法接收一个Object类型的参数，返回此对象数组对应的JSONArray对象，返回的JSONArray对象格式为：“1”,”2”,”json”public static JSONObject mapToJson(Map map)参数：Map map返回值：JSONObject此方法接收一个Map类型的参数，返回此集合对应