Alamofire 上传图片入门教程（上）

2024-03-02 07:59
文章标签 图片 入门教程 上传 alamofire

本文主要是介绍Alamofire 上传图片入门教程（上），希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

Get the lowdown on Alamofire!

提示:
本教程基于 Xcode 7.3, iOS 9.3, 和 Swift 2.2

Alamofire 是一个为 iOS 和 Mac OS，基于 Swift 的 HTTP 网络库。它在 Apple 的基础网络库上提供了一个优雅的接口，简化了许多常见的网络任务。

Alamofire 提供链式地请求与响应方法，JSON 参数以及响应的序列化和授权，等等。在本教程中，你将使用 Alamofire 来完成基本的网络任务，包括上传文件以及使用第三方库 RESTful API 来请求数据。

注：关于 RESTful API 可以参考这篇博客 RESTful API

Alamofire 的优雅是一个事实，它完全由 Swift 编写，没有任何 Objective-C 的代码，也不是继承自 AFNetworking。

你需要理解一些 HTTP 的基本概念，以及了解苹果的网络类，比如 NSURLSession 和 NSURLConnection。

虽然 Alamofire 掩盖了一些实现细节，但是如果你需要解决你的网络请求，有一些背景知识也是不错的。你也需要使用 CocoaPods 把 Alamofire 安装到你的教程工程中。

入门

下载 初始工程。下载完成后，打开工程运行，会发现中间有一个按钮可以选择图片，点击按钮会访问系统的相册，随便选择一张图片，背景就会被这张图片代替。但是现在的工程是一个初始工程，好多功能没有完成，如下图：

PhotoTagger-start.png

最终完成的效果图会是下面的样子：

PhotoTaggerDemo.gif

Imagga API

Imagga 是一个把图像识别作为服务的平台，为开发者和企业提供了可扩展的图像标注 API，以及图像密集的云应用。你可以从 他们的自动标注服务 下载一个示例程序。

你需要在 Imagga 网站创建一个免费的开发者账户，才能完成这次教程。Imagga 在每次进行 HTTP 请求的时候都需要一个授权头，所以必须注册才能使用他们的服务。去 https://imagga.com/auth/signup/hacker 完成注册吧。注册成功后你会看到类似下面的界面：

Imagga-Dashboard.png

在 Authorization 选项是一个 token，后面你会用到。

注意：
确保你拷贝了整个 token，因为这个 token 很长。

你将会使用 Imagga 作为上传图片的服务器，给图片标注和设置颜色。你可以在 http://docs.imagga.com 了解到所有的 API。

安装依赖包

在工程主目录创建一个名为 Podfile 的文件，并打开这个文件，可以使用下面的方式：

touch Podfile
open Podfile

然后输入下面的内容：

platform :ios, '9.0'inhibit_all_warnings!
use_frameworks!target 'PhotoTagger' dopod 'Alamofire', '~> 3.1.2'
end

接下来，如果你的电脑上没有安装 CocoaPods，点击下面链接进行安装 最新版 CocoaPods 的安装流程。

关闭刚才打开的工程，打开终端进入工程目录。输入 pod install，稍等片刻，完成后会生成一个名为 PhotoTagger.xcworkspace 的文件。然后编译运行你的工程，你会发现没有任何改变，这就对了，下一步从 RESTful 服务器添加一些 HTTP 请求，会返回 JSON 数据。

Alamofire 的好处是什么？

苹果已经提供了 NSURLSession 和其他的类来下载内容，那为什么还要用 Alamofire 呢？因为 Alamofire 基于 NSURLSession，并且它可以让你编写的代码的时候更容易。你不用话费太大的精力就可以获取互联网上的数据，而且你的代码还会很简洁易读。

下面是 Alamofire 中几个主要的函数：

.upload：以分解成部分的形式，数据流的形式，整个文件的形式或者数据的形式上传文件。
.download：下载文件或者暂停后继续下载。
.request：每一个 HTTP 请求和文件传输都不相关。

这些 Alamofire 函数的范围是一个 module，而不是类或结构体。Alamofire 的底层都是类和结构体，比如有 Manager，Request， 和Response，但是你一开始用的时候不必全都理解 Alamofire 其他的结构体。下面是一个例子:
下面直接使用的 NSURLSession：

// With NSURLSession
public func fetchAllRooms(completion: ([RemoteRoom]?) -> Void) {let url = NSURL(string: "http://localhost:5984/rooms/_all_docs?include_docs=true")!let urlRequest = NSMutableURLRequest(URL: url,cachePolicy: .ReloadIgnoringLocalAndRemoteCacheData,timeoutInterval: 10.0 * 1000)urlRequest.HTTPMethod = "GET"urlRequest.addValue("application/json", forHTTPHeaderField: "Accept")let task = urlSession.dataTaskWithRequest(urlRequest){ (data, response, error) -> Void inguard error == nil else {print("Error while fetching remote rooms: \(error)")completion(nil)return}guard let json = try? NSJSONSerialization.JSONObjectWithData(data!,options: []) as? [String: AnyObject] else {print("Nil data received from fetchAllRooms service")completion(nil)return}guard let rows = json["rows"] as? [[String: AnyObject]] {print("Malformed data received from fetchAllRooms service")completion(nil)return}var rooms = [RemoteRoom]()for roomDict in rows {rooms.append(RemoteRoom(jsonData: roomDict))}completion(rooms)}task.resume()
}

下面是使用 Alamofire 的方式：

// With Alamofire
func fetchAllRooms(completion: ([RemoteRoom]?) -> Void) {Alamofire.request(.GET,"http://localhost:5984/rooms/_all_docs",parameters: ["include_docs": "true"],encoding: .URL).validate().responseJSON { (response) -> Void inguard response.result.isSuccess else {print("Error while fetching remote rooms: \(response.result.error)")completion(nil)return}guard let value = response.result.value as? [String: AnyObject],rows = value["rows"] as? [[String: AnyObject]] else {print("Malformed data received from fetchAllRooms service")completion(nil)return}var rooms = [RemoteRoom]()for roomDict in rows {rooms.append(RemoteRoom(jsonData: roomDict))}completion(rooms)}
}

上传文件

打开 ViewController.swift，把下面的代码加到类的底部：

// Networking calls
extension ViewController {func uploadImage(image: UIImage, progress: (percent: Float) -> Void,completion: (tags: [String], colors: [PhotoColor]) -> Void) {guard let imageData = UIImageJPEGRepresentation(image, 0.5) else {print("Could not get JPEG representation of UIImage")return}}
}

上面的代码的作用是上传图片到 Imagga。

接下来，在 imagePickerController(_:didFinishPickingMediaWithInfo:) 方法里，在 imageView.image = image 后面加入下面的代码：

// 1
takePictureButton.hidden = true
progressView.progress = 0.0
progressView.hidden = false
activityIndicatorView.startAnimating()uploadImage(image,progress: { [unowned self] percent in// 2self.progressView.setProgress(percent, animated: true)},completion: { [unowned self] tags, colors in// 3self.takePictureButton.hidden = falseself.progressView.hidden = trueself.activityIndicatorView.stopAnimating()self.tags = tagsself.colors = colors// 4self.performSegueWithIdentifier("ShowResults", sender: self)
})

在 Alamofire 中所有对象都是异步的，也就意味着你会以异步的方式更新 UI：

  1. 隐藏上传按钮，同时显示显示进度条。
  2. 当文件上传的时候，progress 闭包会以百分比的形式进行更新，改变的多少同步显示在进度条上。
  3. 当上传文件完成时，completion 闭包才会执行，设置控件的状态变为原始状态。
  4. 最后，Storyboard 会将成功的（或者不成功）上茶传结果显示到屏幕上，接口并不会基于错误发生改变。

接下来，在 ViewController.swift 中添加下面的代码：

import Alamofire

上面的代可以会让你使用 Alamofire 模块提供的代码。

下面，返回到 uploadImage(_:progress:completion:) 并且在guard 判断后面添加下面的代码：

Alamofire.upload(.POST,"http://api.imagga.com/v1/content",headers: ["Authorization" : "Basic xxx"],multipartFormData: { multipartFormData inmultipartFormData.appendBodyPart(data: imageData, name: "imagefile",fileName: "image.jpg", mimeType: "image/jpeg")},encodingCompletion: { encodingResult in}
)

确保替换『Basic xxx』用你自己在 Imagga 网站生成的 token。

接下来，在 encodingCompletion闭包里添加下面的代码：

switch encodingResult {
case .Success(let upload, _, _):upload.progress { bytesWritten, totalBytesWritten, totalBytesExpectedToWrite indispatch_async(dispatch_get_main_queue()) {let percent = (Float(totalBytesWritten) / Float(totalBytesExpectedToWrite))progress(percent: percent)}}upload.validate()upload.responseJSON { response in}
case .Failure(let encodingError):print(encodingError)
}

这段代码调用 Alamofire 上传功能，通过在计算来更新进度条。

注意:
Alamofire 并不会保证调用过程会在主队列上回调；因此你必须通过向主队列调度来更新用户界面。有一些 Alamofire 的回调，比如 responseJSON，都会默认在主队列调用。例如：

dispatch_async(queue ?? dispatch_get_main_queue()) {let response = ...completionHandler(response)
}

为了改变默认的做法，你需要给 Alamofire 提供一个 dispatch_queue_t。

添加下面的代码到 upload.responseJSON：

// 1.
guard response.result.isSuccess else {print("Error while uploading file: \(response.result.error)")completion(tags: [String](), colors: [PhotoColor]())return
}
// 2.
guard let responseJSON = response.result.value as? [String: AnyObject],uploadedFiles = responseJSON["uploaded"] as? [AnyObject],firstFile = uploadedFiles.first as? [String: AnyObject],firstFileID = firstFile["id"] as? String else {
    print("Invalid information received from service")
    completion(tags: [String](), colors: [PhotoColor]())
    return
}
print("Content uploaded with ID: \(firstFileID)")
// 3.
completion(tags: [String](), colors: [PhotoColor]())

下面是每步的解释：
1. 检查响应是否成功；如果不成功，输出错误信息并调用 completion。
2. 检查响应的每个部分，验证所期望的类型是收到的实际类型，如果 firstFileID 没有被解析，那么输出错误信息，并调用completion。
3. 调用 completion 来更新 UI。你没有任何下载的标志或颜色，所以简化调用数据为空的情况。

注意:
每一个响应都有一个结果，包括枚举值和类型。使用自动验证，当它返回一个合法的 HTTP 码（在200-299之间的内容类型都被认为是可以接受的）。
你可以通过添加 .validate 手动执行验证，代码如下：

Alamofire.request(.GET, "https://httpbin.org/get", parameters: ["foo": "bar"]).validate(statusCode: 200..<300).validate(contentType: ["application/json"]).response { response in// response handling code
}

如果你在上传期间发生错误，UI 并不会显示错误；它仅仅会返回没有标志或颜色给用户。这不是良好的用户体验，但是在本次教程中确实有上面所说的。

编译运行工程代码，选择一个 image 然后会看到进度条发生了变化，上传完成后，你会看到下面的信息：

ImaggaUploadConsole.png

你已经成功的上传图片！

sad-forever-alone-happy.jpg

下篇地址

原帖地址

这篇关于Alamofire 上传图片入门教程（上）的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/765436。

相关文章

基于 HTML5 Canvas 实现图片旋转与下载功能(完整代码展示)

基于 HTML5 Canvas 实现图片旋转与下载功能(完整代码展示)

《基于HTML5Canvas实现图片旋转与下载功能(完整代码展示)》本文将深入剖析一段基于HTML5Canvas的代码，该代码实现了图片的旋转（90度和180度）以及旋转后图片的下载... 目录一、引言二、html 结构分析三、css 样式分析四、JavaScript 功能实现一、引言在 Web 开发中，
阅读更多...
Python如何去除图片干扰代码示例

Python如何去除图片干扰代码示例

《Python如何去除图片干扰代码示例》图片降噪是一个广泛应用于图像处理的技术,可以提高图像质量和相关应用的效果,：本文主要介绍Python如何去除图片干扰的相关资料,文中通过代码介绍的非常详细,... 目录一、噪声去除1. 高斯噪声（像素值正态分布扰动）2. 椒盐噪声（随机黑白像素点）3. 复杂噪声（如伪
阅读更多...
Python中图片与PDF识别文本(OCR)的全面指南

Python中图片与PDF识别文本(OCR)的全面指南

《Python中图片与PDF识别文本(OCR)的全面指南》在数据爆炸时代,80%的企业数据以非结构化形式存在,其中PDF和图像是最主要的载体,本文将深入探索Python中OCR技术如何将这些数字纸张转... 目录一、OCR技术核心原理二、python图像识别四大工具库1. Pytesseract - 经典O
阅读更多...
Python实现精准提取 PDF中的文本,表格与图片

Python实现精准提取 PDF中的文本,表格与图片

《Python实现精准提取PDF中的文本,表格与图片》在实际的系统开发中,处理PDF文件不仅限于读取整页文本,还有提取文档中的表格数据,图片或特定区域的内容,下面我们来看看如何使用Python实... 目录安装 python 库提取 PDF 文本内容：获取整页文本与指定区域内容获取页面上的所有文本内容获取
阅读更多...
Python基于微信OCR引擎实现高效图片文字识别

Python基于微信OCR引擎实现高效图片文字识别

《Python基于微信OCR引擎实现高效图片文字识别》这篇文章主要为大家详细介绍了一款基于微信OCR引擎的图片文字识别桌面应用开发全过程,可以实现从图片拖拽识别到文字提取,感兴趣的小伙伴可以跟随小编一... 目录一、项目概述1.1 开发背景1.2 技术选型1.3 核心优势二、功能详解2.1 核心功能模块2.
阅读更多...
Go语言如何判断两张图片的相似度

Go语言如何判断两张图片的相似度

《Go语言如何判断两张图片的相似度》这篇文章主要为大家详细介绍了Go语言如何中实现判断两张图片的相似度的两种方法,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 在介绍技术细节前，我们先来看看图片对比在哪些场景下可以用得到：图片去重：自动删除重复图片，为存储空间"瘦身"。想象你是一个
阅读更多...
使用Python实现base64字符串与图片互转的详细步骤

使用Python实现base64字符串与图片互转的详细步骤

《使用Python实现base64字符串与图片互转的详细步骤》要将一个Base64编码的字符串转换为图片文件并保存下来,可以使用Python的base64模块来实现,这一过程包括解码Base64字符串... 目录1. 图片编码为 Base64 字符串2. Base64 字符串解码为图片文件3. 示例使用注意
阅读更多...
c/c++的opencv实现图片膨胀

c/c++的opencv实现图片膨胀

《c/c++的opencv实现图片膨胀》图像膨胀是形态学操作,通过结构元素扩张亮区填充孔洞、连接断开部分、加粗物体,OpenCV的cv::dilate函数实现该操作,本文就来介绍一下opencv图片... 目录什么是图像膨胀？结构元素 (KerChina编程nel)OpenCV 中的 cv::dilate() 函
阅读更多...
GitLab文件的上传与下载方式

GitLab文件的上传与下载方式

《GitLab文件的上传与下载方式》：本文主要介绍GitLab文件的上传与下载方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录GitLab 项目拉取到本地GitLab 项目上传方法方法 1：本地项目未初始化Git方法 2：本地项目已初始化GitGitLab 上
阅读更多...
使用Python实现调用API获取图片存储到本地的方法

使用Python实现调用API获取图片存储到本地的方法

《使用Python实现调用API获取图片存储到本地的方法》开发一个自动化工具,用于从JSON数据源中提取图像ID,通过调用指定API获取未经压缩的原始图像文件,并确保下载结果与Postman等工具直接... 目录使用python实现调用API获取图片存储到本地1、项目概述2、核心功能3、环境准备4、代码实现
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2