JAVA JSONObject 转字符串，为什么自动丢失key为null的数据？

（本篇所讲的JSONObject是net.sf.json包中的）
先看一个例子：

    //定义一个JSONObject
    JSONObject jsonObj = new JSONObject();
    //赋值
    jsonObj.put("yellow","黄色");
    jsonObj.put("blue","蓝色");
    jsonObj.put("red","红色");
    jsonObj.put("black",null);
    //转为字符串并打印
    System.out.println(jsonObj.toString());

//期望输出结果：

{"yellow":"黄色","blue":"蓝色","red":"红色","black":""}

//实际输出结果：

{"yellow":"黄色","blue":"蓝色","red":"红色"}

//发现black值丢失了，这是因为使用JSONObject.put(Object key, Object value) ，put一个key为null的时候，等于是清空了该key值：
原来，当value值为null的时候，json对象直接移除了原来的key值，破案了！

如果在实际的业务逻辑中，想要将value为null的属性，也一并输出，就不能使用JSONObject了，可以是Map代替JSONOBject

    //定义一个Map
    Map map = new HashMap();
    //赋值
    map.put("yellow","黄色");
    map.put("blue","蓝色");
    map.put("red","红色");
    map.put("black",null);
    //转为字符串并打印
    System.out.println(map.toString());   
    //输出结果：{red=红色, blue=蓝色, yellow=黄色, black=null}

趁此机会，深入了解一下JSONObject设置对象的几种用法与区别

1、JSONObject.put(Object key, Object value)
使用此方法赋值的时候，

• key不能为null
• value会替换原来key对应的value
• value可以为null, 为null时移除原来的key (可以直接写put(“key”, null);)
• 调用element(String key, Object value)方法 ，返回Object是原来被替换的value, 可能为null

2、JSONObject element(String key, Object value, JsonConfig jsonConfig)

• key不能为null
• value会替换原来key对应的value
• value可以为null, 为null时移除原来的key (不可以直接写element(“key”, null);)
• 调用element(String key, Object value)方法 ，返回Object是原来被替换的value, 可能为null

3、JSONObject accumulate(String key, Object value, JsonConfig jsonConfig)
//积累这个value到该key下，如果key存在，则该key的值为数组；如果执行之前key值不存在，那该语句与put的效果相同
如下：

 public static void main(String[] arg){          
         JSONObject jsonAddr = new JSONObject();
         jsonAddr.put("city", "北京市");
         jsonAddr.put("area", "朝阳区");
        
         JSONObject json = new JSONObject(); 
         json.put("user", "张艺兴");//增加key值
         json.put("age", 25);
         json.put("addr", jsonAddr); //增加一个对象到该key下,嵌套json
         json.put("tel", "186XXXXXXXX");
         json.accumulate("tel", "座机：010-XXXXXXXX");//积累这个value到该key下，如果key存在，则该key的值为数组
         json.put("age", 26);//如果该key已经存在则覆盖原来的值
         json.put("lover", "secret");
         json.element("lover", "secret2");//替换原来的值"secret"为新值"secret2",并返回原来的value值"secret"
        
         JSONArray jsonArray = new JSONArray();
         jsonArray.add(0,"黄渤");
         jsonArray.add(1,"黄磊");
         json.put("friend", jsonArray);//增加一个数组
        
         System.out.println("json="+json); 
         System.out.println("json.getString(\"user\")="+json.getString("user"));
System.out.println("json.getJSONArray(\"friend\").get(0)="+json.getJSONArray("friend").get(0));
System.out.println("json.getJSONObject(\"addr\").get(\"city\")="+json.getJSONObject("addr").get("city"));
    }

输出结果：

json={"user":"张艺兴","age":26,"addr":{"city":"北京市","area":"朝阳区"},"tel":["186XXXXXXXX","座机：010-XXXXXXXX"],"lover":"secret2","friend":["黄渤","黄磊"]}
json.getString("user")=张艺兴
json.getJSONArray("friend").get(0)=黄渤
json.getJSONObject("addr").get("city")=北京市

了解了以上之后，实际使用中，我们需要避免下面的坑

/**
 * 使用put()方法这是对的
 */
 public void responseJson() {
    JSONObject data = new JSONObject();
    data.put("name", null);
    System.out.println(data.toString());
 }

/**
 * 使用put()方法, 这种方式会抛出空指针异常
 */
 public void responseJson() {
    JSONObject data = new JSONObject();
    // 运行时会抛出空指针异常, 因为之前没有key为"name"的复制, put返回的Object对象为null
    System.out.println(data.put("name", "123").toString());
 }

/**
 * 使用element()方法, 这种方式是正确的
 */
 public void responseJson() {
    JSONObject data = new JSONObject();
    // 运行时会正确输出 {"success":"123"}
    System.out.println(data.element("name", "123").toString());
 }

/**
 * 使用put()方法
 */
 public void responseJson() {
    JSONObject data = new JSONObject();
    data.put("name", "abc");
    // 运行时都会输出 abc
    System.out.println(data.put("name", null).toString());
    // 如果上一行运行, 这里就会抛出空指针异常
    System.out.println(data.put("name", "123").toString());
    // 这里会输出 {"success":"123"}
    System.out.println(data.toString());
 }

/**
 * 使用element()方法
 * 这样直接传入null编译器会直接报错, 代码不会编译通过
 */
 public void responseJson() {
    JSONObject data = new JSONObject();
    data.element("name", null);
    System.out.println(data.toString());
 }