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/JavaSpark!/Ruby on Rails是，那再迁移过来是很快的事情。我们来看看如何来创建一个Perfect项目并创建一个简单的WebAPI。

1. 先把Perfect从Github拉下来Gitclonehttps://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 scheR_428_11845@e ，如图，因为你启动需要PerfectServer所以你需要把executable改成PerfectServer.app ，并把Shared项目钩上。

6. 对PerfectHandler.swift进行修改

[plain]view plaincopy

print?

1. importPerfectLib
2. importMysqL
5. letHOST="你的数据库链接"
6. letUSER="你的帐号"
7. letpassworD="你的密码"
8. letscheR_428_11845@E="你的数据库"
10. publicfuncPerfectServerModuleInit(){
12. RoutIng.Handler.registerGlobally()
13. RoutIng.Routes["GET",["/"]]={(_:WebResponsE)inreturnPerfectHandler()}
14. print("\(RoutIng.Routes.description)")
15. }
17. //CreateahandlerforindexRoute
18. classPerfectHandler:requestHandler{
20. funchandlerequest(request:Webrequest,response:WebResponsE){
22. response.addheader("Content-Type",value:"application/json")
23. response.addheader("Content-Type",value:"text/html;charset=utf-8")
25. letMysqL=MysqL()
26. letconnect=MysqL.connect(HOST,user:USER,password:passworD)
27. if(connect)
28. {
29. letsres=MysqL.SELEctDatabase(scheR_428_11845@E)
30. if(sres)
31. {
33. letsres2=MysqL.query("SELECTname,memoFROMInfo")
35. if(sres2)
36. {
37. letresults=MysqL.storeResults()!
41. if(results.numRows()==0)
42. {
43. do{
46. letencoder=JSONEncoder()
47. letdata=tryencoder.encode(["result":""])
48. response.appendBodyString(data)
49. }
50. catch{
51. response.setStatus(500,@R_607_8798@ge:"Couldnotcreatedata")
52. }
53. }
54. else
55. {
56. vardataArray:Array<AnyObject>=[]
57. varDict=Dictionary<String,String>()
58. whileletrow=results.next(){
60. Dict["name"]=row[0];
61. dataArray.append(Dict)
63. }
65. print(NSJSONserialization.isValidJSONObject(dataArray))
68. do{
71. letdataFinal=tryNSJSONserialization.dataWithJSONObject(dataArray,options:NSJSONWriTingOptions(rawValue:0))
73. letString=NSString(data:dataFinal,encoding:NSUTF8StringEncoding)
75. lettee:string=Stringas!String
76. response.appendBodyString(teE)
77. }
78. catch{
79. response.setStatus(500,@R_607_8798@ge:"Couldnotcreatedata")
80. }
84. }
89. results.close()
90. }
91. }
92. MysqL.close()
93. }
94. response.requestCompletedCallBACk()
95. }
96. }

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上飞，下篇见