🦄 ♏️ 🔕 Perfect-SwiftのRESTサーバー ☂️ 👩🏼‍🔧 🧒

ほとんどのiOS開発者は遅かれ早かれiOS SDKの世界でcr屈になります。そして、その理由は、IOSが深刻な開発の機会を十分に持っていないということではありませんが、最新の深刻なアプリケーションにはクライアントサーバーアーキテクチャがありますが、iOS開発者が利用できるのはClient Worldだけです。サーバー開発は、モバイル開発者がAPIの何かを変更するという要件に非常に~~jeしている~~プログラマ~~にとって~~ 、サーバー鹿に翻弄されます。最も単純なAPIを実装するには、独自のパラダイムとニュアンスを備えた別のプログラミング言語を習得する必要があるという事実に楽観主義を加えることはありません。パイロットのアイデアを打ち破るには、外部から人々を引き付けるか、エイリアンの夢の世界（PHP、Pyton、Ruby、C＃）に突入する必要があります。 Objectove-C / Swiftキャンプのすべてがそれほど悪いですか？まったく違います。サーバー開発のテーマについて少し調べてみると、かなり興味深い取り組みに出くわしました。これは、真のクロスプラットフォームソリューションになると主張しています。つまり、OSXと* nixシステムの両方で同じように機能します（Windows、C ＃誰も動かない-あまりにも多くのグッズ）。

プロジェクトの作成者が主張するとおり、パーフェクト-Swiftプログラミング言語を使用してアプリケーションやその他のRESTサービスを作成する開発者にとって理想的なWebサーバーおよびツールキットです。「理想」はしゃれにすぎないことは明らかですが、同時に、提案された解決策に精通した後、この声明に少し真実があるという事実に傾き始めます。

「プレス」は、新しいプログラミング言語のアプローチに関する記事を掲載しました。これは、アップルによる簡単な提出により業界標準になる可能性があります。大衆に昇格したSwiftに基づく言語。原則として、これに関する記事はより多くの質問を引き起こし、すべてを再トレーニングするのにうんざりしている人たちにとってはさらに迷惑です（Swift自体は非常に急速に変化します）。しかし、問題の研究を掘り下げて、すべてが見かけよりもはるかに優れていることが明らかになりました。

Perfectは、新しいサーバー開発言語ではありません。 Perfectは、最新の実装（Swift 2.2の執筆時点）のSwiftのみを使用してREST APIサービスを作成できるサーバー環境です。クライアント開発者が毎日しなければならないことを超えるものはありません。

すること：名刺ページ（スタブ）を作成して、サーバーにアクセスするときにそれを実証します。 GET / POSTリクエストに応答するREST APIサービスを簡単に作成する可能性を示します。静的なサイトページの動的な形成のメカニズムを示します。さらに、これはすべてSwiftで行います。

モノ

Monoの愛好家は、クロスプラットフォームのサーバー開発ツールが長い間存在していると主張することができ、C＃/のサーバー側に精通している人にとって重要な「BUT」があると異議を唱えることは困難です。嫌悪感を引き起こします。

免責事項

HATEOASとHALの伝道者は通り過ぎることができます。モバイル開発者が慣れている形でRESTについて言及します。そのようなRESTの純度は疑問視される可能性がありますが、これからはなくなることはありません。アフリカゾウをゾウと見なすことができるか、インドゾウのみをゾウと見なすことができるかについて、ホリバーを手配する必要はありません。

ですから、旅の出発点は適切な環境の創造です。残念ながら、歩き続ける道はそれほど明白ではなく、ワークスペースの作成からXcodeでのスキームの変更まで、非常に奇妙な操作が数多く含まれます。プロジェクトの作成者が作成したビデオに、ステップバイステップのガイドが示されています。記事の各ステップを説明することは、ハブにとっての「翻訳」というトピックにすぎません。パーフェクト機能の実用化に焦点を当てたいと思います。パーフェクト機能は、コマーシャルには存在しないか、巨大な神秘的な形でそこに表示されます。ところで、著者によって公開されたビデオの中には、有用というよりも有害なものがあります。

HelloPerfect

Xcodeワークスペースのセットアップ方法（HelloPerfectパート1）

カスタムルートで最初のWebアプリケーションをホストする方法（Hello Perfectパート2）

はじめに、概念を理解しましょう。 Perfectは、サーバーライブラリ（PerfectLib）とミニマリストインターフェイスを備えたスタートアップアプリケーション（Perfect Server）の2つの部分で構成されています。どちらのアプリケーションもオープンソースであり、理論的には、自分でニーズを変更/終了できます。ただし、これを行うことは強くお勧めしません。個人的に、私は常に何かを改善するために忍び寄っています。ただし、PerfectはSwift 3での使用に適応していないことに注意してください。言語の作成者は、Swift 3が「トップツーボトム」サポートを持たないと言います。 Swiftの新しいバージョンにアップグレードするために、すでに行われた変更を完全に取り除く必要があります。

「Hello Perfect！」の段階に到達していない場合は、それを実行する時間です。必要な環境をここからダウンロードできます。（プロジェクトサイトのリンクの一部が壊れています）

次に、index.htmlおよびtemplate.htmlファイルを作成し、作業プロジェクトに追加します。追加した後、ビルドフェーズに進み、「新しいファイルコピーフェーズ」ステップを追加しましょう。

最終的に、ウィンドウは次のようになります。

ソースパッケージindex.htmlのダウンロード

<HTML> <HEAD> <TITLE>My company name.</TITLE> </HEAD> <BODY BGCOLOR="FFFFFF"> <CENTER><IMG SRC="http://www.telemis.com/sites/default/files/Cloud-Plain-Blue_2.png" width="300px"> </CENTER> <HR> <a href="http://demonsoft.net">My name</a> is a link to another nifty site <H1>This is a Header</H1> <H2>This is a Medium Header</H2> Send me mail at <a href="mailto:support@yourcompany.com"> mail@gmail.com</a>. <P> This is a new paragraph! <P> <B>This is a new paragraph!</B> <B><I>This is a new sentence without a paragraph break, in bold italics.</I></B> <HR> </BODY> </HTML>

ソースTemplate.htmlをダウンロード

 <HTML> <HEAD> <TITLE>{{TITLE}}</TITLE> </HEAD> <BODY> <table border = "1px" width="100%"> <tr> <th>{{TITLE}}</th> </tr> </table> <table border = "1px" width="100%"> <tr> <th align="left">{{BODY}}</th> </tr> </table> <table border = "0px" width="100%" > <tr> <th align="right">{{FOOTER}}</th> </tr> </table> </BODY> </HTML>

ほとんどの場合、これらすべてのアクションはプロジェクトページのビデオで説明されています： www.youtube.com/watch?v=J441eJ40PH4ただし、このケースでは、Webページをホストするか、REST APIを使用できます。私たちは両方のニーズを1つの機会に結合しようとします。

PerfectServerModuleInitコードを次のコードに完全に置き換えます。

PerfectServerModuleInit

public func PerfectServerModuleInit() 
      

        
        
        
      

     { 
      

        
        
        
      

     Routing.Handler.registerGlobally() 
      

        
        
        
      

     
      

        
        
        
      

     // Root index.html page 
      

        
        
        
      

     Routing.Routes["*"] = { (_:WebResponse) in StaticFileHandler() } 
      

        
        
        
      

     
      

        
        
        
      

     // Request for static pages 
      

        
        
        
      

     Routing.Routes["GET", ["/index", "/list"]] = { (_:WebResponse) in return StaticPageHandler(staticPage: "index.html") } 
      

        
        
        
      

     
      

        
        
        
      

     // REST 
      

        
        
        
      

     Routing.Routes["GET", ["/hello"]] = { (_:WebResponse) in return HelloHandler() } 
      

        
        
        
      

     Routing.Routes["GET", ["/help"]] = { (_:WebResponse) in return HelpHandler() } 
      

        
        
        
      

     Routing.Routes["GET", ["/cars", "/car"]] = { (_:WebResponse) in return CarsJson() } 
      

        
        
        
      

     
      

        
        
        
      

     
      

        
        
        
      

     Routing.Routes["POST", ["/list"]] = { (_:WebResponse) in return CarsJson() } 
      

        
        
        
      

     }

PerfectServerModuleInitメソッドの呼び出しはサーバープロジェクト（私の場合はMySwiftServer）にありますが、どのクラスにも関連付けられていません。別の.swiftファイルに入れました。

PerfectServerModuleInitは、Webサービスへのエントリポイントです。 main関数に似ています。サーバーライブラリから呼び出されるメソッド。後でここで何が起こっているのかを説明します。

ここで、さらにいくつかのクラスを追加する必要があります。

クラスhellohandler

import Foundation 
      

        
        
        
      

     import PerfectLib 
      

        
        
        
      

     
      

        
        
        
      

     class HelloHandler:RequestHandler 
      

        
        
        
      

     { 
      

        
        
        
      

     func handleRequest(request: WebRequest, response: WebResponse) 
      

        
        
        
      

     { 
      

        
        
        
      

     response.appendBodyString("Hello World!\n") 
      

        
        
        
      

     response.appendBodyString("Hello Perfect!\n") 
      

        
        
        
      

     response.appendBodyString("Hello Swift Server!\n") 
      

        
        
        
      

     response.requestCompletedCallback() 
      

        
        
        
      

     } 
      

        
        
        
      

     }

HelloHandlerクラスは役に立たないため、主にサーバーが稼働していることを確認するために使用されます。サーバーの応答は、出力バッファーに行を追加し、クライアント（ブラウザーまたはクライアントアプリケーション）にコールバックを追加することになります。

クラスStaticPageHandler

import Foundation 
      

        
        
        
      

     import PerfectLib 
      

        
        
        
      

     
      

        
        
        
      

     class StaticPageHandler:RequestHandler 
      

        
        
        
      

     { 
      

        
        
        
      

     var staticPage = "index.html" 
      

        
        
        
      

     
      

        
        
        
      

     internal init(staticPage:String) { 
      

        
        
        
      

     self.staticPage = staticPage 
      

        
        
        
      

     } 
      

        
        
        
      

     
      

        
        
        
      

     func handleRequest(request: WebRequest, response: WebResponse) 
      

        
        
        
      

     { 
      

        
        
        
      

     let file = ContentPage().page(request.documentRoot, pageFile: self.staticPage) 
      

        
        
        
      

     
      

        
        
        
      

     response.appendBodyString(file) 
      

        
        
        
      

     response.requestCompletedCallback() 
      

        
        
        
      

     } 
      

        
        
        
      

     }

StaticPageHandlerクラスを使用すると、指定した名前で静的ページをホストできます。「デフォルトで」index.htmlが使用されますが、原則として、プロジェクトに追加された他のページでもかまいません。

HelpHandlerクラス

import Foundation 
      

        
        
        
      

     import PerfectLib 
      

        
        
        
      

     
      

        
        
        
      

     class HelpHandler:RequestHandler 
      

        
        
        
      

     { 
      

        
        
        
      

     func handleRequest(request: WebRequest, response: WebResponse) 
      

        
        
        
      

     { 
      

        
        
        
      

     let list = Routing.Routes.description.stringByReplacingString("+h", withString: "") 
      

        
        
        
      

     let html = ContentPage(title:"HELP", body:list).page(request.documentRoot) 
      

        
        
        
      

     response.appendBodyString("\(html)") 
      

        
        
        
      

     response.requestCompletedCallback() 
      

        
        
        
      

     } 
      

        
        
        
      

     }

HelpHandlerクラスを使用すると、サーバーによって処理されたコマンドのリストを取得できます。他のサーバー環境（MS Framework 4.5.1など）では、自己文書化REST APIサーバーを取得できます。これは、モバイルアプリケーションの開発者にとって非常に便利です。サーバーの開発者にメンテナンスやコマンドの追加を依頼する必要はありません。

更新： 次の記事では、APIドキュメントのメカニズムを改善しました。

クラスCarsJson

import Foundation 
      

        
        
        
      

     import PerfectLib 
      

        
        
        
      

     
      

        
        
        
      

     class CarsJson:RequestHandler 
      

        
        
        
      

     { 
      

        
        
        
      

     func handleRequest(request: WebRequest, response: WebResponse) 
      

        
        
        
      

     { 
      

        
        
        
      

     let car1:[JSONKey: AnyObject] = ["Wheel":4, "Color":"Black"] 
      

        
        
        
      

     let car2:[JSONKey: AnyObject] = ["Wheel":3, "Color":["mixColor":0xf2f2f2]] 
      

        
        
        
      

     let cars = [car1, car2] 
      

        
        
        
      

     let restResponse = RESTResponse(data:cars) 
      

        
        
        
      

     response.appendBodyBytes(restResponse.array) 
      

        
        
        
      

     response.requestCompletedCallback() 
      

        
        
        
      

     } 
      

        
        
        
      

     }

CarsJsonクラスは、GET / POST要求が複雑な戻り構造でどのように機能するかを示しています。返されるデータはAnyObjectによって表されます。

クラスContentPage

import Foundation 
      

        
        
        
      

     
      

        
        
        
      

     public class ContentPage:NSObject 
      

        
        
        
      

     { 
      

        
        
        
      

     private var title = "" 
      

        
        
        
      

     private var body = "" 
      

        
        
        
      

     private var footer = "" 
      

        
        
        
      

     
      

        
        
        
      

     public init(title:String="", body:String="", footer:String="Copyright (C) 2016 _MY_COMPANY_NAME_. All rights reserved.") 
      

        
        
        
      

     { 
      

        
        
        
      

     self.title = title 
      

        
        
        
      

     self.body = body 
      

        
        
        
      

     self.footer = footer 
      

        
        
        
      

     } 
      

        
        
        
      

     
      

        
        
        
      

     func page(webRoot:String, pageFile:String="template.html") -> String 
      

        
        
        
      

     { 
      

        
        
        
      

     let template = self.loadIndexHtml(webRoot, pageFile:pageFile) 
      

        
        
        
      

     let htmlBody = self.body.stringByReplacingString("\n", withString: " 
      

        
        
        
      

     ") 
      

        
        
        
      

     
      

        
        
        
      

     var page = template 
      

        
        
        
      

     page = page.stringByReplacingString("{{TITLE}}", withString: self.title) 
      

        
        
        
      

     page = page.stringByReplacingString("{{BODY}}", withString: htmlBody) 
      

        
        
        
      

     page = page.stringByReplacingString("{{FOOTER}}", withString: self.footer) 
      

        
        
        
      

     
      

        
        
        
      

     return page 
      

        
        
        
      

     } 
      

        
        
        
      

     
      

        
        
        
      

     private func loadIndexHtml(webRoot:String, pageFile:String) -> String { 
      

        
        
        
      

     
      

        
        
        
      

     let fileManager = NSFileManager.defaultManager() 
      

        
        
        
      

     let directory = fileManager.currentDirectoryPath 
      

        
        
        
      

     let path = directory + "/\(webRoot)/\(pageFile)" 
      

        
        
        
      

     do { 
      

        
        
        
      

     return try String(contentsOfFile: path) 
      

        
        
        
      

     } catch { 
      

        
        
        
      

     print("File didn't create") 
      

        
        
        
      

     } 
      

        
        
        
      

     
      

        
        
        
      

     return "404 NOT FOUND" 
      

        
        
        
      

     } 
      

        
        
        
      

     }

静的なページを返し、対応するフィールドで置換を行うサービスクラス。デフォルトでは、template.htmlテンプレートが使用されますが、原則として、プロジェクトに追加された他のテンプレートを使用できます。

クラスRESTResponse

import Foundation 
      

        
        
        
      

     import PerfectLib 
      

        
        
        
      

     
      

        
        
        
      

     public class RESTResponse 
      

        
        
        
      

     { 
      

        
        
        
      

     
      

        
        
        
      

     public var data:AnyObject = "" // Data from Server to Client 
      

        
        
        
      

     public var status = "" // HTTP status or other code of operation. 
      

        
        
        
      

     public var message = "" // This message Client can show in the Alert View 
      

        
        
        
      

     public var errors = [String]() // All real errors for Console 
      

        
        
        
      

     
      

        
        
        
      

     
      

        
        
        
      

     public init(data:AnyObject="", status:String="200", message:String="", errors:[String]=[]) 
      

        
        
        
      

     { 
      

        
        
        
      

     self.data = data 
      

        
        
        
      

     self.status = status 
      

        
        
        
      

     self.message = message 
      

        
        
        
      

     self.errors = errors 
      

        
        
        
      

     } 
      

        
        
        
      

     
      

        
        
        
      

     public var array: [UInt8] { 
      

        
        
        
      

     
      

        
        
        
      

     let result = ["data":self.data, "status":self.status, "message":self.message, "errors":self.errors] 
      

        
        
        
      

     return serialization(result) 
      

        
        
        
      

     } 
      

        
        
        
      

     
      

        
        
        
      

     private func serialization(object:AnyObject) -> [UInt8] 
      

        
        
        
      

     { 
      

        
        
        
      

     do { 
      

        
        
        
      

     let jsonData = try NSJSONSerialization.dataWithJSONObject(object, options: NSJSONWritingOptions.PrettyPrinted) 
      

        
        
        
      

     let count = jsonData.length / sizeof(UInt8) 
      

        
        
        
      

     var jsonArray = [UInt8](count: count, repeatedValue: 0) 
      

        
        
        
      

     jsonData.getBytes(&jsonArray, length:count * sizeof(UInt8)) 
      

        
        
        
      

     return jsonArray 
      

        
        
        
      

     
      

        
        
        
      

     } catch let error as NSError { 
      

        
        
        
      

     print(error) 
      

        
        
        
      

     } 
      

        
        
        
      

     
      

        
        
        
      

     return [UInt8]() 
      

        
        
        
      

     } 
      

        
        
        
      

     }

RESTResponseクラスは、REST APIを使用する重要なクラスであり、最も物議をかもしています。

返されるデータオブジェクトには、次のJSONラッパー構造があります。

{ 
      

        
        
        
      

     «data»:{…. }, 
      

        
        
        
      

     «errors»:[… ], 
      

        
        
        
      

     "message":"", 
      

        
        
        
      

     "status":200 
      

        
        
        
      

     }

1）一部の開発者は、この形式を明確に受け入れません。しかし、返されたデータのこの形式に対する説得力のある議論はありませんでした。ただし、型付き形式には特定の利点があります。歴史的な伝統によれば、「ステータス」フィールドの値は、操作が正常に完了すると「200」になります。ただし、HTTP応答とは直接の関係はありません。これらは常にリクエストヘッダーから差し引くことができ、サーバー環境自体によってクライアント側に送信されます。「ステータス」フィールドでは、HTTP層ではなく、Webサービスのビジネスロジック内でセマンティックロードを持つ値を渡すことができます。「メッセージ」フィールドには、サーバー側のアクションを通知するためにユーザーに表示する必要がある文字列が含まれています。たとえば、特にクライアントアプリケーションの観点からすべてが順調に進んでいる場合のセッションの有効期限に関する情報。「エラー」：[]フィールドは、異常な状況をクライアントに通知する用語の配列です。この情報をクライアント側で保存して処理したり、さらに処理するために専用のログサーバーに送信したりすると便利です。最後に、データフィールド：{.... }には複雑なデータ構造が含まれています-クライアント側で受信されることが正確に予想されるものです。このアプローチの主な利点は、サーバーの応答が指定されたスキームを満たさない場合、クライアントが明確な良心を持って拒否できることです。これを整理する方法については、 habrahabr.ru / post / 283012を参照してください。説明したアプローチに反対する開発者は、「配列」プロパティを簡単に変更して、説明したラッパーなしで生データを返すことができます。

2）Perfect開発者がJSONオブジェクトを返すために使用することを提案したアプローチに少々驚いた。提案されたチュートリアルでは、各JSONオブジェクトは、[JSONKey：JSONValue]（[String：AnyObject]と同等）の形式のキー/値のペアを列挙してツリーを順次構築することにより形成されると想定されていました。次のコードを使用することになっています。

public var json: String 
      

        
        
        
      

     { 
      

        
        
        
      

     let result = ["data":self.data, "status":self.status, "message":self.message, "errors":self.errors] 
      

        
        
        
      

     
      

        
        
        
      

     let jsonEncoder = JSONEncoder() 
      

        
        
        
      

     do { 
      

        
        
        
      

     let respString = try jsonEncoder.encode(result) 
      

        
        
        
      

     return respString 
      

        
        
        
      

     } catch let error as NSError { 
      

        
        
        
      

     print(error) 
      

        
        
        
      

     } 
      

        
        
        
      

     return "" 
      

        
        
        
      

     } 
      

        
        
        
      

     ….. 
      

        
        
        
      

     response.appendBodyString(self.json) 
      

        
        
        
      

     response.requestCompletedCallback()

ただし、このコードは、現在CarsJsonクラスに含まれているデータでも完全に動作しません。さらに、Perfect creatorsチュートリアルのロジックに従う場合、複雑な構造をエンコードするには、返されるオブジェクトごとに独自のクラスを作成する必要があります。私のバージョンでは、数行のコードで任意のネストのオブジェクトをシリアル化できることは明らかです。これは、サービスの開始後に確認することは難しくありません。

発射！

すべてが正しく行われると、ブラウザに次のページが表示されます。

サーバーに挨拶する：ブラウザの行に「/ hello」と入力します

実行されるコマンドに関するサーバー情報を要求します。

すべてのコマンドはカテゴリ（GET、POST）に分かれていることに注意してください。他の述語を使用する場合、それらもこのリストに表示されます。

ただし、/ listコマンドは両方のリストにもあります。 PerfectServerModuleInitによってGETおよびPOSTコマンドに追加されたのは彼女ですが、（！）異なるハンドラーがあります！

ブラウザのコマンドラインからリストにアクセスすると、インデックスページが表示されます。

しかし、特別なアプリケーション（たとえば、無料のPostman）を使用する場合、Postリクエストの本文には、予想されるJSONが含まれます。

JSONはCarsJsonクラスで生成された構造と完全に一貫していることに注意してください。

しかし、GETから/ listコマンドを削除するとどうなりますか

Routing.Routes["GET", ["/index", "/list"]] = { (_:WebResponse) in return StaticPageHandler(staticPage: "index.html") }

取得するもの：

このような簡単な方法で、開始ページまたはスタブページを置き換えることで、RESTコマンドの使用をルールとして簡単にマスクできます。これが、オープンAPIを使用したサービスでない場合、/ helpなどの開発コマンドの最後に削除またはブロックされます。しかし、この機会を別の方法で活用することもできます。GET要求のコマンドに関する詳細を含む情報を表示し、静的ページハンドラーを機能させます。

/ carおよび/ carsコマンドは同じ構造を返すが、Webページとして返されることが予想されます。

ある程度のスキルがあれば、REST APIを作成することは、必要なナビゲーションを備えたViewControllerを作成することほど難しくありません。

エクストリームスポーツのファンは、これらすべてをLinuxで実行しようとすることができます。

更新：

チュートリアルでJSON応答の神秘的なシリアル化が使用された理由についての説明がありました-すべてのNSメソッド（NSJSONSerializationを含む）はUbuntuで動作を停止します。

Perfect-SwiftのRESTサーバー

More articles: