iOS 14开发-网络

基础知识

App如何通过网络请求数据？

客户服务器模型

App 通过一个 URL 向特定的主机发送一个网络请求加载需要的资源。URL 一般是使用 HTTP（HTTPS）协议，该协议会通过 IP（或域名）定位到资源所在的主机，然后等待主机处理和响应。
主机通过本次网络请求指定的端口号找到对应的处理软件，然后将网络请求转发给该软件进行处理（处理的软件会运行在特定的端口）。针对 HTTP（HTTPS）请求，处理的软件会随着开发语言的不同而不同，如 Java 的 Tomcat、PHP 的 Apache、.net 的 IIS、Node.js 的 JavaScript 运行时等）
处理软件针对本次请求进行分析，分析的内容包括请求的方法、路径以及携带的参数等。然后根据这些信息，进行相应的业务逻辑处理，最后通过主机将处理后的数据返回（返回的数据一般为 JSON 字符串）。
App 接收到主机返回的数据，进行解析处理，最后展示到界面上。
发送请求获取资源的一方称为客户端。接收请求提供服务的一方称为服务端。

基本概念

URL

Uniform Resource Locator（统一资源定位符），表示网络资源的地址或位置。
互联网上的每个资源都有一个唯一的 URL，通过它能找到该资源。
URL 的基本格式协议://主机地址/路径。

HTTP/HTTPS

HTTP—HyperTextTransferProtocol：超文本传输协议。
HTTPS—Hyper Text Transfer Protocol over Secure Socket Layer 或 Hypertext Transfer Protocol Secure：超文本传输安全协议。

请求方法

在 HTTP/1.1 协议中，定义了 8 种发送 HTTP 请求的方法，分别是GET、POST、HEAD、PUT、DELETE、OPTIONS、TRACE、CONNECT。
最常用的是 GET 与 POST。

响应状态码

状态码	描述	含义
200	Ok	请求成功
400	Bad Request	客户端请求的语法出现错误，服务端无法解析
404	Not Found	服务端无法根据客户端的请求找到对应的资源
500	Internal Server Error	服务端内部出现问题，无法完成响应

请求响应过程

JSON

JavaScript Object Notation。
一种轻量级的数据格式，一般用于数据交互。
服务端返回给 App 客户端的数据，一般都是 JSON 格式。

语法

数据以键值对key : value形式存在。
多个数据由,分隔。
花括号{}保存对象。
方括号[]保存数组。

key与value

标准 JSON 数据的 key 必须用双引号""。
JSON 数据的 value 类型：
- 数字（整数或浮点数）
- 字符串（"表示）
- 布尔值（true 或 false）
- 数组（[]表示）
- 对象（{}表示）
- null

解析

厘清当前 JSON 数据的层级关系（借助于格式化工具）。
明确每个 key 对应的 value 值的类型。
解析技术
- Codable 协议（推荐）。
- JSONSerialization。
- 第三方框架。

URLSession

使用步骤

创建请求资源的 URL。
创建 URLRequest，设置请求参数。
创建 URLSessionConfiguration 用于设置 URLSession 的工作模式和网络设置。
创建 URLSession。
通过 URLSession 构建 URLSessionTask，共有 3 种任务。（1）URLSessionDataTask：请求数据的 Task。（2）URLSessionUploadTask：上传数据的 Task。（3）URLSessionDownloadTask：下载数据的 Task。
启动任务。
处理服务端响应，有 2 种方式。（1）通过 completionHandler（闭包）处理服务端响应。（2）通过 URLSessionDataDelegate（代理）处理请求与响应过程的事件和接收服务端返回的数据。

基本使用

class ViewController: UIViewController {

    override func viewDidLoad() {

        super.viewDidLoad()

        // get()

        // post()

    }


    func get() {

        // 1. 确定URL

        let url = URL(string: "http://v.juhe.cn/toutiao/index?type=top&key=申请的key")

        // 2. 创建请求

        let urlRequest = URLRequest(url: url!)

        // cachePolicy: 缓存策略，App最常用的缓存策略是returnCacheDataElseLoad，表示先查看缓存数据，没有缓存再请求

        // timeoutInterval：超时时间

        // let urlRequest = URLRequest(url: url!, cachePolicy: .returnCacheDataElseLoad, timeoutInterval: 5)

        let config = URLSessionConfiguration.default

        // 3. 创建URLSession

        let session = URLSession(configuration: config)

        // 4. 创建任务

        let task = session.dataTask(with: urlRequest) { data, _, error in

            if error != nil {

                print(error!)

            } else {

                if let data = data {

                    print(String(data: data, encoding: .utf8)!)

                }

            }

        }

        // 5. 启动任务

        task.resume()

    }


    func post() {

        let url = URL(string: "http://v.juhe.cn/toutiao/index")

        var urlRequest = URLRequest(url: url!)

        // 指明请求方法

        urlRequest.httpMethod = "POST"

        // 指明参数

        let params = "type=top&key=申请的key"

        // 设置请求体

        urlRequest.httpBody = params.data(using: .utf8)

        let config = URLSessionConfiguration.default

        // delegateQueue决定了代理方法在哪个线程中执行

        let session = URLSession(configuration: config, delegate: self, delegateQueue: OperationQueue())

        let task = session.dataTask(with: urlRequest)

        task.resume()

    }

}


// MARK:- URLSessionDataDelegate

extension ViewController: URLSessionDataDelegate {

    // 开始接收数据

    func urlSession(_ session: URLSession, dataTask: URLSessionDataTask, didReceive response: URLResponse, completionHandler: @escaping (URLSession.ResponseDisposition) -> Void) {

        // 允许接收服务器的数据，默认情况下请求之后不接收服务器的数据即不会调用后面获取数据的代理方法

        completionHandler(URLSession.ResponseDisposition.allow)

    }


    // 获取数据

    // 根据请求的数据量该方法可能会调用多次，这样data返回的就是总数据的一段，此时需要用一个全局的Data进行追加存储

    func urlSession(_ session: URLSession, dataTask: URLSessionDataTask, didReceive data: Data) {

        let result = String(data: data, encoding: .utf8)

        if let result = result {

            print(result)

        }

    }


    // 获取结束

    func urlSession(_ session: URLSession, task: URLSessionTask, didCompleteWithError error: Error?) {

        if let error = error {

            print(error)

        } else {

            print("=======成功=======")

        }

    }

}

注意：如果网络请求是 HTTP 而非 HTTPS，默认情况下，iOS 会阻断该请求，此时需要在 Info.plist 中进行如下配置。
<key>NSAppTransportSecurity</key>

<dict>

<key>NSAllowsArbitraryLoads</key>

<true/>

</dict>

URL转码与解码

当请求参数带中文时，必须进行转码操作。

let url = "https://www.baidu.com?name=张三"

    .addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)!

print(url) // URL中文转码

print(url.removingPercentEncoding!) // URL中文解码

有时候只需要对URL中的中文处理，而不需要针对整个URL。

let str = "阿楚姑娘"

    .addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)!

let url = URL(string: "https://music.163.com/#/search/m/?s=\(str)&type=1")

下载数据

class ViewController: UIViewController {

    // 下载进度

    @IBOutlet var downloadProgress: UIProgressView!

    // 下载图片

    @IBOutlet var downloadImageView: UIImageView!


    override func viewDidLoad() {

        super.viewDidLoad()


        download()

    }


    func download() {

        let url = URL(string: "http://172.20.53.240:8080/AppTestAPI/wall.png")!

        let request = URLRequest(url: url)

        let session = URLSession(configuration: URLSessionConfiguration.default, delegate: self, delegateQueue: OperationQueue())

        let task = session.downloadTask(with: request)

        task.resume()

    }

}


extension ViewController: URLSessionDownloadDelegate {

    // 下载完成

    func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didFinishDownloadingTo location: URL) {

        // 存入沙盒

        let savePath = NSSearchPathForDirectoriesInDomains(.documentDirectory, .userDomainMask, true).first!

        // 文件类型根据下载的内容决定

        let fileName = "\(Int(Date().timeIntervalSince1970)).png"

        let filePath = savePath + "/" + fileName

        print(filePath)

        do {

            try FileManager.default.moveItem(at: location, to: URL(fileURLWithPath: filePath))

            // 显示到界面

            DispatchQueue.main.async {

                self.downloadImageView.image = UIImage(contentsOfFile: filePath)

            }

        } catch {

            print(error)

        }

    }


    // 计算进度

    func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didWriteData bytesWritten: Int64, totalBytesWritten: Int64, totalBytesExpectedToWrite: Int64) {

        DispatchQueue.main.async {

            self.downloadProgress.setProgress(Float(totalBytesWritten) / Float(totalBytesExpectedToWrite), animated: true)

        }

    }

}

上传数据

上传数据需要服务端配合，不同的服务端代码可能会不一样，下面的上传代码适用于本人所写的服务端代码。

数据格式。

上传数据格式

实现。

class ViewController: UIViewController {

    let YFBoundary = "AnHuiWuHuYungFan"

    @IBOutlet var uploadInfo: UILabel!

    @IBOutlet var uploadProgress: UIProgressView!


    override func viewDidLoad() {

        super.viewDidLoad()


        upload()

    }


    func upload() {

        // 1. 确定URL

        let url = URL(string: "http://172.20.53.240:8080/AppTestAPI/UploadServlet")!

        // 2. 确定请求

        var request = URLRequest(url: url)

        // 3. 设置请求头

        let head = "multipart/form-data;boundary=\(YFBoundary)"

        request.setValue(head, forHTTPHeaderField: "Content-Type")

        // 4. 设置请求方式

        request.httpMethod = "POST"

        // 5. 创建NSURLSession

        let session = URLSession(configuration: URLSessionConfiguration.default, delegate: self, delegateQueue: OperationQueue())

        // 6. 获取上传的数据（按照固定格式拼接）

        var data = Data()

        let header = headerString(mimeType: "image/png", uploadFile: "wall.png")

        data.append(header.data(using: .utf8)!)

        data.append(uploadData())

        let tailer = tailerString()

        data.append(tailer.data(using: .utf8)!)

        // 7. 创建上传任务 上传的数据来自getData方法

        let task = session.uploadTask(with: request, from: data) { _, _, error in

            // 上传完毕后

            if error != nil {

                print(error!)

            } else {

                DispatchQueue.main.async {

                    self.uploadInfo.text = "上传成功"

                }

            }

        }

        // 8. 执行上传任务

        task.resume()

    }


    // 开始标记

    func headerString(mimeType: String, uploadFile: String) -> String {

        var data = String()

        // --Boundary\r\n

        data.append("--" + YFBoundary + "\r\n")

        // 文件参数名 Content-Disposition: form-data; name="myfile"; filename="wall.jpg"\r\n

        data.append("Content-Disposition:form-data; name=\"myfile\";filename=\"\(uploadFile)\"\r\n")

        // Content-Type 上传文件的类型 MIME\r\n\r\n

        data.append("Content-Type:\(mimeType)\r\n\r\n")


        return data

    }


    // 结束标记

    func tailerString() -> String {

        // \r\n--Boundary--\r\n

        return "\r\n--" + YFBoundary + "--\r\n"

    }


    func uploadData() -> Data {

        let image = UIImage(named: "wall.png")

        let imageData = image!.pngData()

        return imageData!

    }

}


extension ViewController: URLSessionTaskDelegate {

    // 上传进去

    func urlSession(_ session: URLSession, task: URLSessionTask, didSendBodyData bytesSent: Int64, totalBytesSent: Int64, totalBytesExpectedToSend: Int64) {

        DispatchQueue.main.async {

            self.uploadProgress.setProgress(Float(totalBytesSent) / Float(totalBytesExpectedToSend), animated: true)

        }

    }


    // 上传出错

    func urlSession(_ session: URLSession, task: URLSessionTask, didCompleteWithError error: Error?) {

        if let error = error {

            print(error)

        }

    }

}

URLCache

网络缓存有很多好处：节省流量、更快加载、断网可用。
使用 URLCache 管理缓存区域的大小和数据。
每一个 App 都默认创建了一个 URLCache 作为缓存管理者，可以通过URLCache.shared获取，也可以自定义。

// 创建URLCache

// memoryCapacity：内存缓存容量

// diskCapacity：硬盘缓存容量

// directory：硬盘缓存路径

let cache = URLCache(memoryCapacity: 10 * 1024 * 1024, diskCapacity: 100 * 1024 * 1024, directory: FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first)

// 替换默认的缓存管理对象

URLCache.shared = cache

常见属性与方法。

let url = URL(string: "http://v.juhe.cn/toutiao/index?type=top&key=申请的key")

let urlRequest = URLRequest(url: url!, cachePolicy: .returnCacheDataElseLoad, timeoutInterval: 5)

let cache = URLCache.shared


// 内存缓存大小

cache.memoryCapacity

// 硬盘缓存大小

cache.diskCapacity

// 已用内存缓存大小

cache.currentMemoryUsage

// 已用硬盘缓存大小

cache.currentDiskUsage

// 获取某个请求的缓存

let cacheResponse = cache.cachedResponse(for: urlRequest)

// 删除某个请求的缓存

cache.removeCachedResponse(for: urlRequest)

// 删除某个时间点开始的缓存

cache.removeCachedResponses(since: Date().addingTimeInterval(-60 * 60 * 48))

// 删除所有缓存

cache.removeAllCachedResponses()

WKWebView

用于加载 Web 内容的控件。
使用时必须导入WebKit模块。

基本使用

加载网页。

// 创建URL

let url = URL(string: "https://www.abc.edu.cn")

// 创建URLRequest

let request = URLRequest(url: url!)

// 创建WKWebView

let webView = WKWebView(frame: UIScreen.main.bounds)

// 加载网页

webView.load(request)

加载本地资源。

// 文件夹路径

let basePath = Bundle.main.path(forResource: "localWeb", ofType: nil)!

// 文件夹URL

let baseUrl = URL(fileURLWithPath: basePath, isDirectory: true)

// html路径

let filePath = basePath + "/index.html"

// 转成文件

let fileContent = try? NSString(contentsOfFile: filePath, encoding: String.Encoding.utf8.rawValue)

// 创建WKWebView

let webView = WKWebView(frame: UIScreen.main.bounds)

// 加载html

webView.loadHTMLString(fileContent! as String, baseURL: baseUrl)

注意：如果是本地资源是文件夹，拖进项目时，需要勾选Create folder references，然后用Bundle.main.path(forResource: "文件夹名", ofType: nil)获取资源路径。

与JavaScript交互

创建WKWebView

lazy var webView: WKWebView = {

    // 创建WKPreferences

    let preferences = WKPreferences()

    // 开启JavaScript

    preferences.javaScriptEnabled = true

    // 创建WKWebViewConfiguration

    let configuration = WKWebViewConfiguration()

    // 设置WKWebViewConfiguration的WKPreferences

    configuration.preferences = preferences

    // 创建WKUserContentController

    let userContentController = WKUserContentController()

    // 配置WKWebViewConfiguration的WKUserContentController

    configuration.userContentController = userContentController

    // 给WKWebView与Swift交互起一个名字：callbackHandler，WKWebView给Swift发消息的时候会用到

    // 此句要求实现WKScriptMessageHandler

    configuration.userContentController.add(self, name: "callbackHandler")    

    // 创建WKWebView

    var webView = WKWebView(frame: UIScreen.main.bounds, configuration: configuration)

    // 让WKWebView翻动有回弹效果

    webView.scrollView.bounces = true

    // 只允许WKWebView上下滚动

    webView.scrollView.alwaysBounceVertical = true

    // 设置代理WKNavigationDelegate

    webView.navigationDelegate = self

    // 返回

    return webView

}()

创建HTML

<!DOCTYPE html>

<html lang="en">

    <head>

        <meta charset="UTF-8">

        <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0,user-scalable=no"/>

    </head>

    <body>

        iOS传过来的值：<span id="name"></span>

        <button onclick="responseSwift()">响应iOS</button>

        <script type="text/javascript">

            // 给Swift调用

            function sayHello(name) {

                document.getElementById("name").innerHTML = name

                return "Swift你也好！"

            }

            // 调用Swift方法

            function responseSwift() {

                // 这里的callbackHandler是创建WKWebViewConfiguration是定义的

                window.webkit.messageHandlers.callbackHandler.postMessage("JavaScript发送消息给Swift")

            }

        </script>

    </body>

</html>

两个协议

WKNavigationDelegate：判断页面加载完成，只有在页面加载完成后才能在实现 Swift 调用 JavaScript。WKWebView 调用 JavaScript：

// 加载完毕以后执行

func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {

    // 调用JavaScript方法

    webView.evaluateJavaScript("sayHello('WebView你好！')") { (result, err) in

        // result是JavaScript返回的值

        print(result, err)

    }

}

WKScriptMessageHandler：JavaScript 调用 Swift 时需要用到协议中的一个方法来。JavaScript 调用 WKWebView：

// Swift方法，可以在JavaScript中调用

func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) {

    print(message.body)

}

ViewController

class ViewController: UIViewController {

    // 懒加载WKWebView

    ...


    // 加载本地html

    let html = try! String(contentsOfFile: Bundle.main.path(forResource: "index", ofType: "html")!, encoding: String.Encoding.utf8)


    override func viewDidLoad() {

        super.viewDidLoad()

        // 标题

        title = "WebView与JavaScript交互"

        // 加载html

        webView.loadHTMLString(html, baseURL: nil)

        view.addSubview(webView)

    }

}


// 遵守两个协议

extension ViewController: WKNavigationDelegate, WKScriptMessageHandler {

    func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {

        ...

    }


    func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) {

        ...

    }

}

SFSafariViewController

iOS 9 推出的一种 UIViewController，用于加载与显示 Web 内容，打开效果类似 Safari 浏览器的效果。
使用时必须导入SafariServices模块。

import SafariServices


class ViewController: UIViewController {

    override func viewDidLoad() {

        super.viewDidLoad()

    }


    override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) {

        showSafariViewController()

    }


    func showSafariViewController() {

        // URL

        let url = URL(string: "https://www.baidu.com")

        // 创建SFSafariViewController

        let sf = SFSafariViewController(url: url!)

        // 设置代理

        sf.delegate = self

        // 显示

        present(sf, animated: true, completion: nil)

    }

}


extension ViewController: SFSafariViewControllerDelegate {

    // 点击左上角的完成(done)

    func safariViewControllerDidFinish(_ controller: SFSafariViewController) {

        print(#function)

    }


    // 加载完成

    func safariViewController(_ controller: SFSafariViewController, didCompleteInitialLoad didLoadSuccessfully: Bool) {

        print(#function)

    }

}

基础知识

App如何通过网络请求数据？

基本概念

URL

HTTP/HTTPS

请求方法

响应状态码

请求响应过程

JSON

语法

key与value

解析

URLSession

使用步骤

基本使用

URL转码与解码

下载数据

上传数据

URLCache

WKWebView

基本使用

与JavaScript交互

创建WKWebView

创建HTML

两个协议

ViewController

SFSafariViewController

0 个评论

发起人

推荐内容