Skip to content

JSON serializer and tests. #291

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Apr 1, 2016

Conversation

ianpartridge
Copy link
Contributor

This implements NSJSONSerialization's dataWithJSONObject(_:options:), providing a JSON serializer and associated tests. It is RFC 7159 compliant, I hope.

There is another pull request implementing this API, which has been unmerged for some time. I believe this approach is superior, because

  1. It implements the serializer using the same code structure as the existing deserializer.
  2. It doesn't use generics unnecessarily.
  3. It correctly handles string escaping, as per the JSON spec.
  4. It leaves the existing API signature unchanged, so is more interoperable with the existing Objective-C implementation.
  5. The handling of pretty-printing is simpler, and also correct.

Feedback wanted please!

@parkera parkera self-assigned this Mar 16, 2016
@@ -97,7 +97,26 @@ public class NSJSONSerialization : NSObject {
/* Generate JSON data from a Foundation object. If the object will not produce valid JSON then an exception will be thrown. Setting the NSJSONWritingPrettyPrinted option will generate JSON with whitespace designed to make the output more readable. If that option is not set, the most compact possible JSON will be generated. If an error occurs, the error parameter will be set and the return value will be nil. The resulting data is a encoded in UTF-8.
*/
public class func dataWithJSONObject(obj: AnyObject, options opt: NSJSONWritingOptions) throws -> NSData {
NSUnimplemented()
guard obj is NSArray || obj is NSDictionary else {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't this going to fail for e.g. [String] or [String:Any]? Because those are not automatically bridged to NSArray and NSDictionary on Linux, so unless things have changed, I don't think this will work on Linux.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You are right, this is a consequence of the current bridging situation. There is also the fact that the documentation of NSJSONSerialization says that the top-level objects must be NSArray or NSDictionary - so perhaps the documentation needs updating as well.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note that the signature is for AnyObject not Any as well...

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You're right, but the parsing code uses native Swift types like [Any] and [String: Any], which I think is the right way to do it. I think here you should detect native Swift containers as well, so that it works properly both on OS X and Linux.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The 'NSDictionary' or 'NSArray' language is just a reflection of the JSON spec, which says that the top level must be an 'Object' or 'Array'. We can use a Swift dictionary or array here.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@parkera That's how I read it too. Now, if @ianpartridge does want to detect the native Swift containers as well, what would you recommend is the right approach? I wrote my own JSON parser Jay, where I had to opt in for ugly (almost) exhaustive checking of all Array/Dictionary types, because of the lack of automatic bridging on Linux. Is there a better way to do it that I missed?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think a recursive descent of the input and checking all types along the way is the most reasonable way to do this for now. There's a lot of libraries out there that are exploring different avenues for parsing JSON in a type-safe way, but I haven't seen a clear winner among the approaches yet.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Right, that makes sense to tell a String from a Int, but iterating through all possible [String: String], [String: Int], [String: Double`, ... is less than ideal I think. I'm fine with using this for detecting different JSON-compatible types, but is it really the best way to detect different Array and Dictionary types?

@ianpartridge
Copy link
Contributor Author

Hi @parkera - could you review this please? Happy to make improvements if needed, but I'm hoping this is a decent starting point.

@parkera
Copy link
Contributor

parkera commented Mar 31, 2016

@swift-ci please test

@parkera
Copy link
Contributor

parkera commented Apr 1, 2016

Let's go ahead and merge this, then continue to improve it incrementally.

@parkera parkera merged commit 5eebcc8 into swiftlang:master Apr 1, 2016
@parkera
Copy link
Contributor

parkera commented Apr 1, 2016

Thanks for your hard work on this!

@ianpartridge ianpartridge deleted the nsjsonserialization branch February 28, 2017 10:56
atrick pushed a commit to atrick/swift-corelibs-foundation that referenced this pull request Jan 12, 2021
Revert "[test] Workaround an issue with createDirectory on Linux"
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants