summer 0.6.4

Powerful Server Framework behind Spring

Summer

优雅而强大的Dart Web框架。借鉴了Express.js等开源库，支持路由管理，中间件，静态文件托管，以及各种常用的功能

简单的例子

import 'package:summer/summer.dart';

void main(List<String> arguments) {
  var app = createApp();
  app.get('/test', [
    (req, res, next) {
      return 'test finished';
    }
  ]);
  app.listen(httpPort: 4000);
}

app.get定义一个get请求，/test为路径，后面的回调函数负责执行业务逻辑
app.listen(httpPort: 4000)，启动HTTP服务，并监听4000端口

中间件

import 'package:summer/summer.dart';

void main(List<String> arguments) {
  var app = createApp();
  var corsOptions = {'origin': 'http://localhost:4200'};
  app.use(fns: [cors(corsOptions)]);
  app.get('/test', [
    (req, res, next) {
      print('test');
    }
  ]);
  app.listen(httpPort: 4000);
}

以cors中间件为例，cors()会返回函数
使用app.use(fns: [cors(corsOptions)])就可将中间件注册

路由管理器

import 'package:summer/summer.dart';

void main(List<String> arguments) {
  var app = createApp();
  var router = httpRouter();
  router.get('/test', [
    (req, res, next) {
      return 'test';
    }
  ]);
  app.useHttpRouter(path: '/index', router: router);
  app.listen(httpPort: 4000);
}

创建路由管理器，并使用app.useHttpRouter将路由管理器注册进应用，访问接口的路径为/index/test

文件系统

import 'package:summer/summer.dart';

void main(List<String> arguments) {
  var app = createApp();
  app.use(fns: [fileDB('files')]);
  app.listen(httpPort: 4000);
}

引入fileDB中间件，输入http://localhost:4000，即可访问files文件夹

静态网站

import 'package:summer/summer.dart';

void main(List<String> arguments) {
  var app = createApp();
  app.use(fns: [serveStatic('htmls')]);
  app.listen(httpPort: 4000);
}

引入serveStatic中间件，输入http://localhost:4000即可访问htmls文件夹下的静态网站

文件下载

import 'package:summer/summer.dart';

void main(List<String> arguments) {
  var app = createApp();
  app.get('/download', [
    (req, res, next) async {
      await res.downloadFile('files/file.txt');
    }
  ]);
  app.listen(httpPort: 4000);
}

调用res.downloadFile('files/file.txt')即可

API请求

HTTP

import 'package:summer/summer.dart';

var app = createApp();
app.get('/path', [(req, res, next) => next.complete(), (req, res, next) => 'test']);
app.listen(httpPort: 4000);

引入summer包后，需要调用createApp创建应用，然后可以调用app.get(http方法)，输入路径以及回调函数

回调函数中的next类似于express的next，只不过summer是调用next.complete()来继续执行函数

WebSocket

import 'package:summer/summer.dart';

void main(List<String> arguments) {
  var app = createApp();
  app.ws('webSocket', [
    (req, ws, next) {
      ws.listen((event) {
        print(event);
      });
    }
  ]);
  app.listen(httpPort: 4000);
}

TCP/UDP

import 'dart:io';

import 'package:summer/summer.dart';

void main(List<String> arguments) {
  var app = createApp();
  app.tcp((socket, next) {
    socket.listen((event) {
      print(event);
    });
  });
  app.udp((socket, next) {
    socket.listen((event) {
      if (event == RawSocketEvent.read) {
        var data = socket.receive();
        if (data != null) {
          print(data.data);
        }
      }
    });
  });
  app.listen(tcpPort: 4000, udpPort: 5000);
}

app.use(path: '/', fns:[...]);

app.use用来注册中间件，传递一个Handler函数数组
目前仅支持HttpHandler.path为可选值，符合该路径才调用