Dart Server开发环境搭建及新建运行项目

Dart Server开发环境搭建及新建运行项目


Dart除了可以使用Flutter进行移动应用开发、Web开发外,还可以进行服务器端开发,也就是后端开发。如建立后端服务、编写接口、查询数据库、任务调度等等后端、服务器端的工作它都可以实现。接下来,我们就开始Dart Server开发的准备工作吧。本文将主要介绍:

  • Dart Server开发环境配置
  • Dart Server开发工具安装
  • Dart Server开发的两种创建Server项目的方式
  • 运行Dart Server项目

开发环境的搭建

Dart Server官方配置英文文档地址:https://www.dartlang.org/tutorials/server/get-started
我们也可以使用DartPad体验和运行Dart程序:https://dartpad.dartlang.org/

DartPad界面

1. 下载Dart SDK

官方英文文档地址:https://www.dartlang.org/tools/sdk#install

本文是在Windows环境下进行安装配置的。
Windows下需要先安装chocolatey:https://chocolatey.org/
使用CMD命令安装:

1
@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

新建一个chocolatey.bat文件,将上面的这段命令复制进去保存。双击运行这个bat文件就会自动执行安装chocolatey包管理器操作了。
安装好之后,Windows命令窗口执行如下命令进行dart-sdk稳定版安装:

1
C:\> choco install dart-sdk

Dart-SDK安装

如果想安装dev版,输入以下命令:

1
choco install dart-sdk --pre

如果想更新dart-sdk,输入以下命令:

1
choco upgrade dart-sdk

Linux需要执行以下命令:

1
2
3
4
> sudo apt-get update
> sudo apt-get install apt-transport-https
> sudo sh -c 'curl https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add -'
> sudo sh -c 'curl https://storage.googleapis.com/download.dartlang.org/linux/debian/dart_stable.list > /etc/apt/sources.list.d/dart_stable.list'

1
2
> sudo apt-get update
> sudo apt-get install dart

Mac下需要执行以下命令:

1
2
> brew tap dart-lang/dart
> brew install dart

当然除了用命令安装Dart SDK外,我们也可以安装Windows版本安装包文件,下载地址:http://www.gekorm.com/dart-windows/

Dart Web SDK安装包

在Dart Web SDK里包含以下工具:

Dart Web SDK里包含的工具

其实主要的命令工具就是:webdev,用来构建和部署Dart Web程序;dart2js,将dart文件转为js文件的编译工具;dartdevc,一个模块化的dart转js文件的编译工具。

Dart Web SDK里包含的工具

chocolatey执行命令安装完dart-sdk后,将Dart SDK的bin目录加入环境变量:

配置Dart环境变量

测试我们的Dart SDK环境变量是否配置好,输入如下命令:

1
dart --version

如能够正确输出版本号,则dart环境变量配置成功。

测试Dart环境变量是否配置成功

2. 下载开发工具

官方英文使用文档地址:https://webdev.dartlang.org/tools/webstorm

开发工具官方推荐是WebStorm,当然也可以使用Visual Studio Code,也可以使用命令工具创建、运行项目。如果想支持命令行运行项目,这样快速方便些。可以安装webdev和stagehand(这里需要安装执行下面这两个命令):

1
2
> pub global activate webdev
> pub global activate stagehand

安装命令窗口:

安装webdev和stagehand

注意:如果你想运行使用Dart2以下的版本,WebStorm版本至少要2018.1.3及以上。当然,现在基本都用Dart2及新版本开发了。

接下来下载安装WebStorm:

WebStorm官方下载地址:https://www.jetbrains.com/webstorm/

WebStorm安装界面

3. 创建Dart Server项目

最简单的Dart应用程序包括如下部分:

一个以.dart后缀结尾的dart源文件;
一个最顶层的main()方法入口函数。

运行这个dart文件,我们可以使用命令:

1
dart main.dart

Dart官方 Server项目结构图如下图:
Server项目结构图

bin目录:主要放置命令行式应用的dart文件,其中的一个dart文件必须有main()入口函数。

lib目录:应用额外使用的代码或者库文件。

pubspec.yaml:应用的配置和描述信息文件,和Flutter的pubspec.yaml功能一致。

命令行应用程序(Command-line apps):

Dart命令行应用程序从命令行独立运行。 命令行应用程序通常用于为Web应用程序提供服务器端支持,但它们也可以是脚本。
Dart VM直接运行Dart代码而无需中间编译。
命令行应用程序

使用WebStorm创建命令行应用程序:

WebStorm新建命令行项目

项目结构目录如下图:

项目结构目录

.dart_tool目录:主要是pub使用的相关支持文件、Dart工具相关,我们可以不管它。

bin目录:应用程序入口,一般叫main.dart文件,里面有main()入口函数。

pubspec.lock:生成的文件,指定应用程序所依赖的软件包的版本号。

lib目录:存放命令行程序的其他类、源文件,具体业务逻辑dart文件写在这里。

.packages文件:告诉Dart工具在哪里获取应用程序使用的包。该文件由pub get命令创建。你可以忽略这一点。

运行命令行应用程序:

运行项目

当然我们也可以使用命令运行:

1
pub run bin/main.dart

运行效果图片:

运行项目

关于main()入口函数和其他顶层入口函数:
Dart允许您定义顶级函数,即未封装在类或对象中的函数。 所有应用程序至少有一个顶级函数,即main()函数。
函数声明包含两部分:签名和正文(a signature and a body)。
函数组成

签名设置函数名称,返回值的数据类型以及输入参数的数量和类型。

函数组成

方法逻辑代码写在花括号({…})之间。如果正文是单个表达式,那么可以跳过大括号并使用=>简写:

1
double milesToKM(double miles) => miles / 0.62;

关于文件命名:一般都是小写,单词间用下划线(_)分隔。

以上是简单的命令行应用程序(Command-line apps)创建过程。

官方详细的命令行应用程序(Command-line apps)编写英文文档地址:https://www.dartlang.org/tutorials/server/cmdline ,后续将给大家详细讲解。

示例代码:

main.dart

1
2
3
4
5
import 'package:untitled2/untitled2.dart' as untitled2;

main(List<String> arguments) {
print('Hello world: ${untitled2.calculate()}!');
}

untitled2.dart

1
2
3
int calculate() {
return 6 * 7;
}

接下来看下Http Server后端应用(HTTP Clients & Servers)的创建方法:

使用WebStorm创建:

新建项目:

WebStorm新建项目

选择Dart项目,点击CREATE:

WebStorm新建项目

或者创建Dart Web项目,再新建个bin目录也可以。

WebStorm新建项目

项目结构目录如下图:

项目结构目录

运行项目:

运行项目

运行后,可以看到控制台显示的日志,如果看到类似的Dart Server启动成功就可以访问我们的页面了:

运行项目

页面效果截图:

运行效果

页面信息监控:http://127.0.0.1:54212/#/vm

页面信息监控

官方详细的Http Server后端应用(HTTP Clients & Servers)编写英文文档地址:https://www.dartlang.org/tutorials/server/httpserver ,后续将给大家详细讲解。

示例代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
import 'dart:io';

import 'package:args/args.dart';
import 'package:shelf/shelf.dart' as shelf;
import 'package:shelf/shelf_io.dart' as io;

main(List<String> args) async {
var parser = ArgParser()..addOption('port', abbr: 'p', defaultsTo: '8080');

var result = parser.parse(args);

var port = int.tryParse(result['port']);

if (port == null) {
stdout.writeln(
'Could not parse port value "${result['port']}" into a number.');
// 64: command line usage error
exitCode = 64;
return;
}

var handler = const shelf.Pipeline()
.addMiddleware(shelf.logRequests())
.addHandler(_echoRequest);

var server = await io.serve(handler, 'localhost', port);
print('Serving at http://${server.address.host}:${server.port}');
}

shelf.Response _echoRequest(shelf.Request request) =>
shelf.Response.ok('Request for "${request.url}"');