Kitura

 收藏    我在用   0 人在用

IBM 开源基于 Swift 语言的 HTTP 服务器 Web 开源框架。

 GitHub     官网     下载     同步

277    5509    342    4 天前

A Swift Web Framework and HTTP Server

Build Status - Master
macOS
Linux
Apache 2
 Slack Status

Summary

Kitura is a web framework and web server that is created for web services written in Swift. For more information, visit www.kitura.io.

Table of Contents

Features

  • URL routing (GET, POST, PUT, DELETE)
  • URL parameters
  • Static file serving
  • FastCGI support
  • SSL/TLS support
  • JSON parsing
  • Pluggable middleware

Swift version

Version 1.0 of Kitura requires Swift 3.0. Kitura is unlikely to compile with any other version of Swift.

Installation

macOS

  1. Download and install Xcode 8.
  2. There is no step 2.

Now you are ready to develop your first Kitura app. Check Kitura-Sample or see Getting Started.

Note: if you have been using the Xcode 8 betas, you may also need to run sudo xcode-select -r to reset your selected developer directory.

Ubuntu Linux

Kitura is tested on Ubuntu 14.04 LTS and Ubuntu 15.10.

  1. Install the following system linux libraries:

$ sudo apt-get install libcurl4-openssl-dev uuid-dev

  1. Install the required Swift version from swift.org.

After installing it (i.e. extracting the .tar.gz file), make sure you update your PATH environment variable so that it includes the extracted tools: export PATH=/<path to uncompress tar contents>/usr/bin:$PATH.

Now you are ready to develop your first Kitura app. Check Kitura-Sample or see Getting Started.

Docker

  1. Install Docker on your development system.

  2. Pull down the kitura-ubuntu image from Docker Hub:

$ docker pull ibmcom/kitura-ubuntu:latest

  1. Create a Docker container using the kitura-ubuntu image you just downloaded and forward port 8090 on host to the container:

$ docker run -i -p 8090:8090 -t ibmcom/kitura-ubuntu:latest /bin/bash

  1. From within the Docker container, execute the clone_build_kitura.sh script to build the Kitura-Starter-Bluemix sample project:

# /root/clone_build_kitura.sh

The last two output lines from executing the clone_build_kitura.sh script should be similar to:

  Linking .build/debug/Kitura-Starter-Bluemix
  >> Build for Kitura-Starter-Bluemix completed (see above for results).
  1. You can now run the Kitura-Starter-Bluemix executable inside the Docker container:

# /root/start_kitura_sample.sh

You should see an output message that contains the string Listening on port 8090.

Vagrant

  1. Install VirtualBox.

  2. Install Vagrant.

  3. From the root of the Kitura folder containing the vagrantfile, create and configure a guest machine:

$ vagrant up

  1. SSH into the Vagrant machine:

$ vagrant ssh

  1. As needed for development, edit the vagrantfile to setup Synced Folders to share files between your host and guest machine.

Now you are ready to develop your first Kitura app. Check Kitura-Sample or see Getting Started.

Getting Started

Let's develop your first Kitura web application!

  1. First, create a new project directory.
  $ mkdir myFirstProject
  1. Next, create a new Swift project using the Swift Package Manager.
  $ cd myFirstProject
  $ swift package init --type executable

Now your directory structure under myFirstProject should look like this:
<pre>
myFirstProject
├── Package.swift
├── Sources
│ └── main.swift
└── Tests
└── <i>empty</i>
</pre>

Note: For more information on the Swift Package Manager, go here.

  1. In Package.swift, add Kitura as a dependency for your project.
  import PackageDescription

  let package = Package(
      name: "myFirstProject",
      dependencies: [
          .Package(url: "https://github.com/IBM-Swift/Kitura.git", majorVersion: 1, minor: 0)
      ])
  1. In Sources/main.swift, import the Kitura module.
  import Kitura
  1. Add a router and a path:
  let router = Router()

  router.get("/") {
      request, response, next in
      response.send("Hello, World!")
      next()
  }
  1. Add an HTTP server and start the Kitura framework.
  Kitura.addHTTPServer(onPort: 8090, with: router)
  Kitura.run()
  1. Your Sources/main.swift file should now look like this.
  import Kitura

  let router = Router()

  router.get("/") {
      request, response, next in
      response.send("Hello, World!")
      next()
  }

  Kitura.addHTTPServer(onPort: 8090, with: router)
  Kitura.run()
  1. Optionally, add logging.

In the code example above, no messages from Kitura will logged. You may want to add a logger to help diagnose any problems that occur.

Add a HeliumLogger dependency to Package.swift.

   import PackageDescription

   let package = Package(
       name: "myFirstProject",
       dependencies: [
           .Package(url: "https://github.com/IBM-Swift/Kitura.git", majorVersion: 1, minor: 0),
           .Package(url: "https://github.com/IBM-Swift/HeliumLogger.git", majorVersion: 1, minor: 0)
       ])

Enable HeliumLogger in Sources/main.swift.

   import HeliumLogger

   HeliumLogger.use()

Here is the finished Sources/main.swift file.

   import Kitura
   import HeliumLogger

   HeliumLogger.use()

   let router = Router()

   router.get("/") {
       request, response, next in
       response.send("Hello, World!")
       next()
   }

   Kitura.addHTTPServer(onPort: 8090, with: router)
   Kitura.run()
  1. Compile your application:

$ swift build

Or copy our Makefile and build scripts to your project directory and run make build. You may want to customize this Makefile and use it for building, testing and running your application. For example, you can clean your build directory, refetch all the dependencies, build, test and run your application by running make clean refetch test run.

  1. Now run your new web application:

$ .build/debug/myFirstProject

  1. Open your browser at http://localhost:8090

Contributing to Kitura

All improvements to Kitura are very welcome! Here's how to get started with developing Kitura itself.

  1. Clone this repository.

$ git clone https://github.com/IBM-Swift/Kitura

  1. Build and run tests.

$ make test

You can find more info on contributing to Kitura in our contributing guidelines.

Community

We love to talk server-side Swift, and Kitura. Join our Slack to meet the team!

 
暂无回复。
需要 登录 后方可回复, 如果你还没有账号请点击这里 注册