# SwiftyJSON
[![Travis CI](https://travis-ci.org/SwiftyJSON/SwiftyJSON.svg?branch=master)](https://travis-ci.org/SwiftyJSON/SwiftyJSON) [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) ![CocoaPods](https://img.shields.io/cocoapods/v/SwiftyJSON.svg) ![Platform](https://img.shields.io/badge/platforms-iOS%208.0+%20%7C%20macOS%2010.10+%20%7C%20tvOS%209.0+%20%7C%20watchOS%202.0+-333333.svg)
SwiftyJSON makes it easy to deal with JSON data in Swift.
1. [Why is the typical JSON handling in Swift NOT good](#why-is-the-typical-json-handling-in-swift-not-good)
2. [Requirements](#requirements)
3. [Integration](#integration)
4. [Usage](#usage)
- [Initialization](#initialization)
- [Subscript](#subscript)
- [Loop](#loop)
- [Error](#error)
- [Optional getter](#optional-getter)
- [Non-optional getter](#non-optional-getter)
- [Setter](#setter)
- [Raw object](#raw-object)
- [Literal convertibles](#literal-convertibles)
- [Merging](#merging)
5. [Work with Alamofire](#work-with-alamofire)
> For Legacy Swift support, take a look at the [swift2 branch](https://github.com/SwiftyJSON/SwiftyJSON/tree/swift2)
> [中文介绍](http://tangplin.github.io/swiftyjson/)
## Why is the typical JSON handling in Swift NOT good?
Swift is very strict about types. But although explicit typing is good for saving us from mistakes, it becomes painful when dealing with JSON and other areas that are, by nature, implicit about types.
Take the Twitter API for example. Say we want to retrieve a user's "name" value of some tweet in Swift (according to Twitter's API https://dev.twitter.com/docs/api/1.1/get/statuses/home_timeline).
The code would look like this:
```swift
if let statusesArray = try? JSONSerialization.jsonObject(with: data, options: .allowFragments) as? [[String: Any]],
let user = statusesArray[0]["user"] as? [String: Any],
let username = user["name"] as? String {
// Finally we got the username
}
```
It's not good.
Even if we use optional chaining, it would be messy:
```swift
if let JSONObject = try JSONSerialization.jsonObject(with: data, options: .allowFragments) as? [[String: Any]],
let username = (JSONObject[0]["user"] as? [String: Any])?["name"] as? String {
// There's our username
}
```
An unreadable mess--for something that should really be simple!
With SwiftyJSON all you have to do is:
```swift
let json = JSON(data: dataFromNetworking)
if let userName = json[0]["user"]["name"].string {
//Now you got your value
}
```
And don't worry about the Optional Wrapping thing. It's done for you automatically.
```swift
let json = JSON(data: dataFromNetworking)
if let userName = json[999999]["wrong_key"]["wrong_name"].string {
//Calm down, take it easy, the ".string" property still produces the correct Optional String type with safety
} else {
//Print the error
print(json[999999]["wrong_key"]["wrong_name"])
}
```
## Requirements
- iOS 8.0+ | macOS 10.10+ | tvOS 9.0+ | watchOS 2.0+
- Xcode 8
## Integration
#### CocoaPods (iOS 8+, OS X 10.9+)
You can use [CocoaPods](http://cocoapods.org/) to install `SwiftyJSON`by adding it to your `Podfile`:
```ruby
platform :ios, '8.0'
use_frameworks!
target 'MyApp' do
pod 'SwiftyJSON'
end
```
Note that this requires CocoaPods version 36, and your iOS deployment target to be at least 8.0:
#### Carthage (iOS 8+, OS X 10.9+)
You can use [Carthage](https://github.com/Carthage/Carthage) to install `SwiftyJSON` by adding it to your `Cartfile`:
```
github "SwiftyJSON/SwiftyJSON"
```
#### Swift Package Manager
You can use [The Swift Package Manager](https://swift.org/package-manager) to install `SwiftyJSON` by adding the proper description to your `Package.swift` file:
```swift
import PackageDescription
let package = Package(
name: "YOUR_PROJECT_NAME",
targets: [],
dependencies: [
.Package(url: "https://github.com/SwiftyJSON/SwiftyJSON.git", versions: Version(1,0,0)..<Version(3, .max, .max)),
]
)
```
Note that the [Swift Package Manager](https://swift.org/package-manager) is still in early design and development, for more information checkout its [GitHub Page](https://github.com/apple/swift-package-manager)
#### Manually (iOS 7+, OS X 10.9+)
To use this library in your project manually you may:
1. for Projects, just drag SwiftyJSON.swift to the project tree
2. for Workspaces, include the whole SwiftyJSON.xcodeproj
## Usage
#### Initialization
```swift
import SwiftyJSON
```
```swift
let json = JSON(data: dataFromNetworking)
```
```swift
let json = JSON(jsonObject)
```
```swift
if let dataFromString = jsonString.data(using: .utf8, allowLossyConversion: false) {
let json = JSON(data: dataFromString)
}
```
#### Subscript
```swift
//Getting a double from a JSON Array
let name = json[0].double
```
```swift
//Getting an array of string from a JSON Array
let arrayNames = json["users"].arrayValue.map({$0["name"].stringValue})
```
```swift
//Getting a string from a JSON Dictionary
let name = json["name"].stringValue
```
```swift
//Getting a string using a path to the element
let path: [JSONSubscriptType] = [1,"list",2,"name"]
let name = json[path].string
//Just the same
let name = json[1]["list"][2]["name"].string
//Alternatively
let name = json[1,"list",2,"name"].string
```
```swift
//With a hard way
let name = json[].string
```
```swift
//With a custom way
let keys:[SubscriptType] = [1,"list",2,"name"]
let name = json[keys].string
```
#### Loop
```swift
//If json is .Dictionary
for (key,subJson):(String, JSON) in json {
//Do something you want
}
```
*The first element is always a String, even if the JSON is an Array*
```swift
//If json is .Array
//The `index` is 0..<json.count's string value
for (index,subJson):(String, JSON) in json {
//Do something you want
}
```
#### Error
Use a subscript to get/set a value in an Array or Dictionary
If the JSON is:
* an array, the app may crash with "index out-of-bounds."
* a dictionary, it will be assigned `nil` without a reason.
* not an array or a dictionary, the app may crash with an "unrecognised selector" exception.
This will never happen in SwiftyJSON.
```swift
let json = JSON(["name", "age"])
if let name = json[999].string {
//Do something you want
} else {
print(json[999].error) // "Array[999] is out of bounds"
}
```
```swift
let json = JSON(["name":"Jack", "age": 25])
if let name = json["address"].string {
//Do something you want
} else {
print(json["address"].error) // "Dictionary["address"] does not exist"
}
```
```swift
let json = JSON(12345)
if let age = json[0].string {
//Do something you want
} else {
print(json[0]) // "Array[0] failure, It is not an array"
print(json[0].error) // "Array[0] failure, It is not an array"
}
if let name = json["name"].string {
//Do something you want
} else {
print(json["name"]) // "Dictionary[\"name"] failure, It is not an dictionary"
print(json["name"].error) // "Dictionary[\"name"] failure, It is not an dictionary"
}
```
#### Optional getter
```swift
//NSNumber
if let id = json["user"]["favourites_count"].number {
//Do something you want
} else {
//Print the error
print(json["user"]["favourites_count"].error)
}
```
```swift
//String
if let id = json["user"]["name"].string {
//Do something you want
} else {
//Print the error
print(json["user"]["name"])
}
```
```swift
//Bool
if let id = json["user"]["is_translator"].bool {
//Do something you want
} else {
//Print the error
print(json["user"]["is_translator"])
}
```
```swift
//Int
if let id = json["user"]["id"].int {
//Do something you want
} else {
//Print the error
print(json["user"]["id"])
}
...
```
#### Non-optional getter
Non-optional getter is named `xxxValue`
```swift
//If not a Number or nil, return 0
let id: Int = json["id"].intValue
```
```swift
//If not a String or nil, return
没有合适的资源?快使用搜索试试~ 我知道了~
Swift-JS交互样例
共68个文件
m:7个
h:7个
plist:7个
1.该资源内容由用户上传,如若侵权请联系客服进行举报
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
版权申诉
0 下载量 27 浏览量
2023-05-19
09:13:27
上传
评论
收藏 203KB ZIP 举报
温馨提示
Swift-JS交互样例
资源推荐
资源详情
资源评论
收起资源包目录
Swift-JS-master.zip (68个子文件)
Swift-JS-master
LICENSE 1KB
swiftjs
Podfile 305B
swiftjs.xcodeproj
project.pbxproj 15KB
xcuserdata
mrzhou.xcuserdatad
xcschemes
xcschememanagement.plist 479B
swiftjs.xcscheme 3KB
project.xcworkspace
contents.xcworkspacedata 152B
xcuserdata
mrzhou.xcuserdatad
UserInterfaceState.xcuserstate 7KB
swiftjs
Base.lproj
Main.storyboard 8KB
LaunchScreen.storyboard 2KB
AppDelegate.swift 2KB
ViewController.swift 2KB
Info.plist 1KB
Assets.xcassets
AppIcon.appiconset
Contents.json 1KB
html
js
jquery-1.11.1.min.js 94KB
index.js 2KB
mui.min.js 110KB
css
mui.min.css 81KB
mui.css 92KB
iconfont.css 1KB
mui.picker.min.css 5KB
index.css 59B
index.html 2KB
fonts
mui.ttf 29KB
iconfont.ttf 10KB
Pods
Pods.xcodeproj
project.pbxproj 38KB
xcuserdata
mrzhou.xcuserdatad
xcschemes
WebViewJavascriptBridge.xcscheme 2KB
Pods-swiftjs.xcscheme 2KB
xcschememanagement.plist 859B
SwiftyJSON.xcscheme 2KB
Manifest.lock 348B
SwiftyJSON
Source
SwiftyJSON.swift 41KB
LICENSE 1KB
README.md 13KB
WebViewJavascriptBridge
LICENSE 1KB
WebViewJavascriptBridge
WebViewJavascriptBridge.m 7KB
WebViewJavascriptBridge_JS.m 4KB
WKWebViewJavascriptBridge.m 7KB
WebViewJavascriptBridge_JS.h 75B
WebViewJavascriptBridge.h 2KB
WebViewJavascriptBridgeBase.m 8KB
WKWebViewJavascriptBridge.h 1KB
WebViewJavascriptBridgeBase.h 2KB
README.md 8KB
Target Support Files
SwiftyJSON
SwiftyJSON-umbrella.h 312B
SwiftyJSON-prefix.pch 195B
SwiftyJSON.modulemap 110B
SwiftyJSON.xcconfig 558B
Info.plist 828B
SwiftyJSON-dummy.m 124B
WebViewJavascriptBridge
WebViewJavascriptBridge-umbrella.h 452B
WebViewJavascriptBridge-dummy.m 150B
WebViewJavascriptBridge-prefix.pch 195B
WebViewJavascriptBridge.modulemap 136B
WebViewJavascriptBridge.xcconfig 569B
Info.plist 828B
Pods-swiftjs
Pods-swiftjs.debug.xcconfig 869B
Pods-swiftjs-dummy.m 128B
Pods-swiftjs-frameworks.sh 4KB
Pods-swiftjs-acknowledgements.plist 3KB
Pods-swiftjs-umbrella.h 316B
Pods-swiftjs-acknowledgements.markdown 2KB
Pods-swiftjs-resources.sh 5KB
Pods-swiftjs.release.xcconfig 869B
Info.plist 828B
Pods-swiftjs.modulemap 114B
swiftjs.xcworkspace
contents.xcworkspacedata 225B
xcuserdata
mrzhou.xcuserdatad
UserInterfaceState.xcuserstate 15KB
Podfile.lock 348B
共 68 条
- 1
资源评论
Java程序员-张凯
- 粉丝: 1w+
- 资源: 6746
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
最新资源
- Picasso_v3.1 2.ipa
- chromedriver-mac-arm64.zip
- 蓝zapro.apk
- chromedriver-linux64.zip
- UCAS研一深度学习实验-MNIST手写数字识别python源码+详细注释(高分项目)
- 基于Python和PyTorch框架完成的一个手写数字识别实验源码(带MINIST手写数字数据集)+详细注释(高分项目)
- 基于Matlab在MNIST数据集上利用CNN完成手写体数字识别任务,并实现单层CNN反向传播算法+源代码+文档说明(高分项目)
- NVIDIA驱动、CUDA和Pytorch及其依赖
- 基于SVM多特征融合的微表情识别python源码+项目说明+详细注释(高分课程设计)
- html动态爱心代码一(附源码)
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功