blackfish - 一个快速的HTTP web服务器基于Node.js和Express采用Swift开发

jopen 4年前


blackfish - 一个快速的HTTP web服务器基于Node.js和Express采用Swift开发。可用于iOS, OS X, 和Ubuntu.

  • Insanely fast
  • Single Threaded
  • Beautiful syntax
  • Type safe

Getting Started

You must have Swift 2.2 or later installed. You can learn more about Swift 2.2 at

Work in Progress

This is a work in progress and will likely change frequently, pull requests are welcome!


Starting the server is as simple as express.


import Blackfish    let app = Blackfish()    app.get("/") { request, response in      response.send(text: "Hello World!")  }    app.listen(port: 3000) { error in      if error == nil {          print("Example app listening on port 3000")      }  }

If you are having trouble connecting, make sure your ports are open. Check out apt-get ufw for simple port management.


Routing in Blackfish is simple and very similar to Express.


app.get("/welcome") { request, response in      response.send(text: "Hello")  }'/') { request, response in      response.send(text: 'Got a POST request')  });    //...start server


You can also create a Router object which will allow you to define multiple routes with a prefix.

let router = Router()    router.get("/") { request, response in      response.send(text: "Bird is the word")  }    router.get("/about") { request, response in      response.send(text: "Don't you know, about the bird?")  }    app.use(path: "/birds", router: router)    // ...start server

Navigating to will show a page with Bird is the word and navigating to will show a page with "Don't you know, about the bird?".


Responding with JSON is easy.

app.get("version") { request, response in      response.send(json: ["version": "1.0"])  }

This responds to all requests to with the JSON dictionary {"version": "1.0"} and Content-Type: application/json.


You can also respond with HTML pages.

app.get("/") { request, response in      response.render("index.html")   }

Just put the file in the Resources folder at the root of your project and it will be served.


A manual response can be returned if you want to set something like cookies.

Route.get("cookie") { request, response in      response.status = .OK      response.text = "Cookie was set"      response.cookies["test"] = "123"      response.send()  }

The Status enum above (.OK) can be one of the following.

public enum Status {      case OK, Created, Accepted      case MovedPermanently      case BadRequest, Unauthorized, Forbidden, NotFound      case ServerError      case Unknown      case Custom(Int)  }

Or something custom.

let status: Status = .Custom(420) //https://dev.推


All files put in the Public folder at the root of your project will be available at the root of your domain. This is a great place to put your assets (.css, .js, .png, etc).


Every route call gets passed a Request object. This can be used to grab query and path parameters.

This is a list of the properties available on the request object.

let method: Method  var parameters: [String: String] //URL parameters like id in user/:id  var data: [String: String] //GET or POST data  var cookies: [String: String]  var session: Session


Similar to Express, Blackfish provides Middleware which can be used to extend the request stack.

Below is an example of a validation Middleware, that validates every request before passing it down the stack.

let validator = Middleware { (request, response, next) in        // Some validation logic      if validator.validate(request) {            // Go to the next call in the stack.          next()        } else {            // Return an error and don't call anything else in the stack.          response.send(error: "Request was unauthorized")      }  }

You can also use middleware on a path which will add it to that path and further on.

let userDetail = Middleware(path: "/user") { (request, response, next) in {      let user = findUserById(["userId"])["user"] = user      next()  }

Using Middleware can allow you endless possibilities with a simple interface.


Sessions will be kept track of using the blackfish-session cookie. The default (and currently only) session driver is .Memory.

if let name =["name"] {      //name was in session     }    //store name in session["name"] = "Blackfish"


Vapor has been successfully tested on Ubuntu 14.04 LTS (DigitalOcean) and Ubuntu 15.10 (VirtualBox).

To deploy to DigitalOcean, simply

  • Install Swift 2.2
    • wget the .tar.gz from Apple
    • Set the export PATH in your ~/.bashrc
    • (you may need to install binutils as well if you see ar not found)
  • Set Blackfish as a dependency of your project in your Package.swift swift dependencies:[ // ...Previous dependencies .Package(url: "", majorVersion: 0) ]
  • cd into the repository
    • Run swift build
    • Run .build/debug/MyApp
    • (you may need to run as sudo to use certain ports)
    • (you may need to install ufw to set appropriate ports)
    • </ul> </li> </ul>


      This project is based on Vapor by Tanner Nelson. It uses compatibilty code from NSLinux by johnno1962.

      Go checkout and star their repos.