개시하다

LT에서 하고 싶은 말.

통신 인터페이스의 설계

class func items(tagName:String,
                 success:((QiitaItemEntity[]) -> Void)!,
                 failure:((NSError?) -> Void)!) 

//failureがnilなら実行しないのでクラッシュしない
failure?(NSError())

통신 인터페이스의 실현

//クラス変数（定数）は使えないのでプロパティのgetterでAPIのBASE URLを返す
//getterなのにgetが省略できているのは何故かちょっと良くわからないのですがそういうものなんでしょう
class var baseUrlString: String { return "https://qiita.com/api/v1" }

//URLを組み立ててNSURLを返すだけ。APIのエンドポイントとして使う
class func itemsURL(tagName:String) -> NSURL {
    //tagNameは必須なのでここではnilチェックなどをする責任を持たない
    return NSURL(string: "\(self.baseUrlString)/tags/\(tagName)/items")
}

//Qiitaの特定タグの記事一覧を取得するAPIをコールし、
//成功した場合のクロージャか失敗した場合のクロージャで値を取得できるようにする
class func items(tagName:String,
                 success:((QiitaItemEntity[]) -> Void)!,
                 failure:((NSError?) -> Void)!) {

    let url = itemsURL(tagName)
    let request = NSURLRequest(URL: url)

    NSURLConnection.sendAsynchronousRequest(request,
        queue: NSOperationQueue.mainQueue(),
        completionHandler:{(response: NSURLResponse!,
                     data: NSData!,
                    error: NSError!) in
            //入力値のエラーチェックは先に行っておき失敗クロージャに返す
            if error != nil {
                failure?(error)
                return
            }
            //NSJSONSerializationにnil渡すと例外になるためチェックをしている
            //TODO: オリジナルのNSErrorを作ればいいかもしれないがとりあえずnilを返しておく
            if data == nil {
                failure?(nil)
                return
            }

            var jsonError: NSError?
            //キャストしつつOptional BindingするのがSwiftっぽい気がする
            if let anyObjects = NSJSONSerialization.JSONObjectWithData(data,
                    options:NSJSONReadingOptions.AllowFragments,
                    error:&jsonError) as? NSDictionary[] {

                //このブロックではJSONが想定通りの配列と辞書になっていることが確定する

                var items = QiitaItemEntity[]()
                //anyObjectsの全ての要素がNSDictionaryだからfor inできる
                for dictionary : NSDictionary in anyObjects {
                    if let title = dictionary["title"] as? String {
                        if let urlString = dictionary["url"] as? String {

                            let qiita = QiitaItemEntity(title: title, urlString: urlString)
                            qiita.gistUrlString = dictionary["gist_url"] as? String
                            //配列の+=はapendされるっぽい
                            items += qiita
                        }
                    }
                }

                success?(items)

            } else if jsonError != nil {
                //想定外1（APIサーバーが仕様通りのJSONを返していないなど疑う）
                failure?(jsonError)
            } else {
                //想定外2（APIサーバーがメンテナンスモードでJSONを返せていないなどを疑う）
                //TODO: これもオリジナルのNSErrorを作ればいいかもしれないがとりあえずnilを返しておく
                failure?(nil)
            }
        }
    )
}

if let anyObjects = NSJSONSerialization.JSONObjectWithData(data,
                             options:NSJSONReadingOptions.AllowFragments,
                               error:&jsonError) as? NSDictionary[] {

    //このブロックに突入できるのはanyObjectsがnilでない場合

} else if jsonError != nil{
    //異常系の処理1
} else {
    //異常系の処理2
}

//変数を一時的に移しておく（Swiftのメリットが薄くなる）
let anyObjects[] = NSJSONSerialization.JSONObjectWithData(data,
                             options:NSJSONReadingOptions.AllowFragments,
                               error:&jsonError) as? AnyObject[]

if let downCastArray = anyObjects as? NSDictionary[] {
    //このブロックに突入できるのはdownCastArrayがnilでない(NSDictionary[]の)とき
    //anyObjectsが使えるのもこのスコープだけ

} else if jsonError != nil {
    //異常系の処理1
} else {
    //異常系の処理2
}