Project Perfect让Swift在服务器端跑起来－引言（一）

编者语：今天是大年初一，先和大家简单说一句猴年快乐！

       

       你认识Swift或者是在客户端，因为它是苹果用来开发客户端的新一代语言。在Swift开源后苹果让它不仅在MacOS/iOS上跑，也运行到了Linux ，而第三方公司RemObject把Swift带到了Android,也带到了Windows(Windows Form/WPF/Universal Windows App) 。可以说Swift已经是一个完整的跨平台语言了。但有人会说Swift缺少了做服务器端的能力，如网站，接口等，现在Perfect就是一个很不错的项目能完成网站开发/数据接口等服务端的工作。今天开始我会介绍给大家。

       Perfect让Swift在服务器端跑起来了，它是开源的。你可以通过官网http://www.perfect.org (这个需要佛跳墙)了解它，也可以从它的Github上下载最新的源码 https://github.com/PerfectlySoft/Perfect/。以下是在Perfect网站上一个重要的介绍, 这真的是一个很cool 的项目。

       

         Perfect主要提供了三块主要的功能一个是从服务器端到客户端都适用的PerfectLib（包括了一些简单的操作如JSON或者是WebHandler的相关操作），其次是一个FastCGI和HTTP服务的容器去支持Perfect在服务端的运行，还有一个Connector这个主要用来和一些服务器基础服务打交道(如和Apache接入，还有数据库链接等现阶段支持MySQL,MongoDB, PostgerSQL还有SQLite).

        Perfect在服务器端是如何运作的？我们先来看看。

         

       从上面的图可以看出，这和我们的rails思想差不多，如果你熟悉.NET MVC/Java Spark !/Ruby on Rails是，那再迁移过来是很快的事情。我们来看看如何来创建一个Perfect项目并创建一个简单的WebAPI。

      1.  先把Perfect从Github拉下来 git clone https://github.com/PerfectlySoft/Perfect.git

      2.  下载完后，第一件事情不是编码，是把Perfect模版添加到Xcode内。模版放在Extras目录下(如图)

      

       然后只需要把Extras/Xcode Templates/Perfect 拷贝到/Users/用户名/Library/Developer/Xcode/Templates/Project Templates/ 下即可。添加完后你打开Xcode就可以看到Perfect模版了。

       

       3. 把上面开发环境配置好现在就可以开始创建Perfect项目了,我们先来创建一个WorkSpace(如果你不太懂看下图)，叫PerfectSample

       

       4. 创建成功后，分别先把PerfectLib,PerfectServer,MySQL引入WorkSpace中，由于用到不同的基础服务所以必须引入。PerfectLib你可以理解成Perfect框架，而PerfectServer是启动支持Perfect的类似IIS/Apache的容器，MySQL是需要介入MySQL Connector

      

      5. 利用Perfect模版创建PerfectWeb项目,如图我创建了一个HelloWorld的项目。如图这个和我们创建Cocoa Framework一致的。当然你可以不需要这个模版，直接从Cocoa Framework模版上创建。

      

      项目里面就包含了一个Handler和一个对应的mustache模版。但这个时候还是不能运行的，你必须把PerfectLib/MySQL Connector引用进来，如下图，这里需要注意PerfectLib是引用PerfectLibOSX版本。

      

     完成添加这两个库后还需要配置Buiding Scheme ，如图，因为你启动需要PerfectServer所以你需要把executable改成PerfectServer.app ，并把Shared项目钩上。

     

     6. 对PerfectHandler.swift进行修改

import PerfectLib
import MySQL


let HOST = "你的数据库链接"
let USER = "你的帐号"
let PASSWORD = "你的密码"
let SCHEME = "你的数据库"

public func PerfectServerModuleInit() {
    
    Routing.Handler.registerGlobally()
    Routing.Routes["GET", ["/"]] = { (_:WebResponse) in return PerfectHandler() }
    print("\(Routing.Routes.description)")
}

//Create a handler for index Route
class PerfectHandler: RequestHandler {
    
    func handleRequest(request: WebRequest, response: WebResponse) {
        
        response.addHeader("Content-Type", value: "application/json")
        response.addHeader("Content-Type", value: "text/html; charset=utf-8")
        
        let mysql = MySQL()
        let connect = mysql.connect(HOST, user: USER, password: PASSWORD)
        if(connect)
        {
            let sres = mysql.selectDatabase(SCHEME)
            if(sres)
            {
                
                let sres2 = mysql.query("SELECT name,memo FROM Info")
                
                if(sres2)
                {
                    let results = mysql.storeResults()!
                    
                    
                    
                    if(results.numRows()==0)
                    {
                        do{
                            
                            
                            let encoder = JSONEncoder()
                            let data = try encoder.encode(["result": ""])
                            response.appendBodyString(data)
                        }
                        catch{
                            response.setStatus(500, message: "Could not create data")
                        }
                    }
                    else
                    {
                        var dataArray:Array = []
                        var dict = Dictionary()
                        while let row = results.next() {
                            
                            dict["name"]=row[0];
                            dataArray.append(dict)
                            
                        }
                        
                        print(NSJSONSerialization.isValidJSONObject(dataArray))
                        
                        
                        do {
                            
                            
                            let dataFinal = try NSJSONSerialization.dataWithJSONObject(dataArray, options:NSJSONWritingOptions(rawValue:0))
                            
                            let string = NSString(data: dataFinal, encoding: NSUTF8StringEncoding)
                            
                            let tee : String = string as! String
                            response.appendBodyString(tee)
                        }
                        catch{
                            response.setStatus(500, message: "Could not create data")
                        }
                        
                        
                        
                    }
                    
                    
                    
                    
                    results.close()
                }
            }
            mysql.close()
        }
        response.requestCompletedCallback()
    }
}

         7. 运行，当运行时会启动 PerfectServer.app,然后在浏览器输入0.0.0.0:8080就可以看到JSON结果了。

        

        结果：

        

       好！一个简单的Web API就完成了，当然这是平平无奇，但是用Swift完成了服务器端的开发是感觉不错的事情。Perfect是一个开始，完成度也有待提高，但是我相信很快会有质的飞跃，如即将支持的ORM等。文档不足也是一个很致命的原因，我相信也会很快改善。

       介绍一个不错的blog(需要佛跳墙) http://code-me-dirty.blogspot.co.uk/2016/02/creating-perfect-swift-server.html ，当然你可以看我的连载。

       今天先说到这里，接下来我会让Perfect在Linux上飞，下篇见