Skip to main content

[json-processing-spec issues] [JIRA] Updated: (JSON_PROCESSING_SPEC-39) JSON API renaming: s/JsonArray/JsonList and s/JsonObject/JsonMap

  • From: "jitu (JIRA)" < >
  • To:
  • Subject: [json-processing-spec issues] [JIRA] Updated: (JSON_PROCESSING_SPEC-39) JSON API renaming: s/JsonArray/JsonList and s/JsonObject/JsonMap
  • Date: Tue, 11 Dec 2012 18:32:00 +0000 (GMT+00:00)
  • Auto-submitted: auto-generated


     [ 
http://java.net/jira/browse/JSON_PROCESSING_SPEC-39?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

jitu updated JSON_PROCESSING_SPEC-39:
-------------------------------------


I received the same feedback from Brian Goetz earlier. But some libraries are 
already using JsonObject and JsonArray, so we continued that naming. But this 
API is for Java developers, so we should follow what is suggested by Mark and 
Brian.

This would also mean we need to change in other places

JsonArray            --> JsonList
JsonArrayBuilder     --> JsonListBuilder 

* JsonReader and JsonWriter changes
s/readArray/readList
s/readObject/readMap

s/writeArray/writeList
s/writeObject/writeMap

* JsonGenerator
s/writeStartArray/writeStartList
s/writeStartObject/writeStartMap

* We have events (like START_ARRAY etc) in the JsonParser. Those need to be 
changed to START_LIST etc
* ValueType has ARRAY and OBJECT, those will be changed to LIST and MAP.


> JSON API renaming: s/JsonArray/JsonList and s/JsonObject/JsonMap
> ----------------------------------------------------------------
>
>                 Key: JSON_PROCESSING_SPEC-39
>                 URL: http://java.net/jira/browse/JSON_PROCESSING_SPEC-39
>             Project: json-processing-spec
>          Issue Type: Improvement
>    Affects Versions: 1.0-pr
>            Reporter: jitu
>             Fix For: 1.0-pr
>
>
> Mark Reinhold's feedback
> -------------------------
> Looking at this API in depth for the first time, I kept getting confused
> by the name "JsonObject".
> In Java terms, what JSON calls an "Object" is just a map, from strings to
> JSON values.  Java already uses "Object" as the unifying supertype of all
> types, so I'd expect "JsonObject" to unify (some set of) JSON-specific
> value types.
> This suggests a renaming along these lines:
>     JsonObject        --> JsonMap
>     JsonObjectBuilder --> JsonMapBuilder
>     JsonStructure     --> JsonObject
> I think Java developers would find this more natural, since most will
> never read the actual JSON specification.
> Remember that this API is for Java developers, not readers of the JSON
> specification.
> -------------

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: 
http://java.net/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        


[json-processing-spec issues] [JIRA] Created: (JSON_PROCESSING_SPEC-39) JSON API renaming: s/JsonArray/JsonList and s/JsonObject/JsonMap

jitu (JIRA) 12/11/2012

[json-processing-spec issues] [JIRA] Updated: (JSON_PROCESSING_SPEC-39) JSON API renaming: s/JsonArray/JsonList and s/JsonObject/JsonMap

jitu (JIRA) 12/11/2012

[json-processing-spec issues] [JIRA] Resolved: (JSON_PROCESSING_SPEC-39) JSON API renaming: s/JsonArray/JsonList and s/JsonObject/JsonMap

jitu (JIRA) 12/13/2012
 
 
Close
loading
Please Confirm
Close