comment added to explain the reason that JSON object is unordered

ttulka · ttulka · commit 246350bbcdf8 · 2017-06-09T09:00:17.000+02:00
to avoid implementators' misconceptions and tries to reimplement the
JSON object to keep the elements order
diff --git a/JSONObject.java b/JSONObject.java
@@ -164,7 +164,12 @@ public String toString() {
      * Construct an empty JSONObject.
      */
     public JSONObject() {
-        // HashMap is used on purpose to ensure that elements are unordered
+        // HashMap is used on purpose to ensure that elements are unordered by 
+        // the specification.
+        // JSON tends to be a portable transfer format to allows the container 
+        // implementations to rearrange their items for a faster element 
+        // retrieval based on associative access.
+        // Therefore, an implementation mustn't rely on the order of the item.
         this.map = new HashMap<String, Object>();
     }
 
