OCRくん

OCRClient.swift

//
//  OCRClient.swift
//  ReceiptManager
//
//  Created by non on 2016/10/10.
//  Copyright © 2016年 non. All rights reserved.
//

import Foundation
import Alamofire

public class OCRClient {
    let HOST = "https://vision.googleapis.com"
    let ANNOTATE_API = "/v1/images:annotate"
    var api_key: String

    init(api_key: String){
        self.api_key = api_key
    }

    // MARK: - main request method
    func annotate(image: Data) -> AnnotatedResponse? {
        let parameters: Parameters = [
            "requests": [
                "image": [
                    "content": image.base64EncodedString()
                ],
                "features": [
                    [
                        "type": "TEXT_DETECTION",
                        "maxResults": 2
                    ]
                ]
            ]
        ]

        let url = HOST + ANNOTATE_API + "?key=" + api_key
        var annotatedResonse: AnnotatedResponse?
        Alamofire.request(url, method: .post, parameters: parameters, encoding: JSONEncoding.default).validate().responseJSON {
            response in
            print(response)
            if let json = response.result.value {
                annotatedResonse = try? AnnotatedResponse.decodeValue(json)
            }
        }
        return annotatedResonse
    }

    // MARK: - convenience request
    func annotate(imagePath: URL) -> AnnotatedResponse? {
        let image = try! Data.init(contentsOf: imagePath)
        return annotate(image: image)
    }
}

まだ重箱なんだけど

func annotate(image: Data) -> AnnotatedResponse?

の image って変数名、そのままだと UIImage とか NSImage の型かな？みたいになって混乱するから imageData みたいな名前の方が好まれそうな気はする。

文化ぜんぜん知らんので重箱の隅助かる

このくらいの規模なら Alamofire はライブラリとして超ファットに思えるので APIKit を使うのがお洒落感あるし、そもそも Alamofire も APIKit も Apple が提供してる Foundation の NSURLSession (Swift 3 では URLSession) の厚いラッパと薄いラッパなのと、URLSession の使い方は簡単なので無理に外部のライブラリに依存することはない気もする。

APIKit は NSURLSession を Swift の型の世界観に上手くお洒落に合わせるように薄く作られたイケてるライブラリという感じと言った方が良いか。

Alamofire は前身が AFNetworking ってライブラリなんだけど、とにかく全部入りを目指してる（ただし NSURLSession がそもそも全部入り）ライブラリで、AFNetworking は昔オプションの指定をアレして脆弱性を作り込んでしまった過去とかもある。
ので最近は全部入りな通信回りを任せるライブラリを使うのはやめようみたいな風潮があるというか、そもそも NSURLSession で全部出来るじゃんということに皆が気付き始めたという感じ。

AFNetworking は昔オプションの指定をアレして脆弱性を作り込んでしまった過去とかもある。

厳しい。。。

この程度の規模のAPIなら題材としても楽だし、今コスト払って公式ライブラリ使えるようになっていたほうが良さそうだね。

NSURLSession の簡単な話をすると、NSURL を放り込むと色々と OS がキューイングとか QoS とかややこしいことを肩代わりしてレスポンスを返してくれるよ、ってやつで、 iOS では 7 以降から、 macOS では 10.9 以降から使えるようになったもの。
それまで古代人達は NSURLRequest ってやつを使って、それに NSURL を放り込んでた。
NSURLSession になってややこしいことを割と OS 側に投げられるようになってみんなハッピーになったという過去がある。

んで、 NSURLSession や NSURLRequest は別に HTTP に限定されてなくて、バイナリとかも放り投げられるしソケット通信も出来る（はず、あまり使わないから忘れた）。
現代人は概ね HTTPS による通信で安全にテキストをやり取りするだろうから、古代人のようにバイナリをソケット通信で投げ合うなんて野蛮なことはしないので、NSURLSession の中の http や ssl に関する一部の機能が上手く使えれば良い、という気持ちでドキュメントを読むとすんなり理解出来そうな気はする

ネットワークライブラリ使わずに自作ネットワークライブラリつくって自分で脆弱性つくり込むより、メンテナンスされたライブラリ使った方がいいとも思いますけどね

http://developers.mobage.jp/blog/2015/afnetworkingssl