自从「Deno1.0」发布以来,有关Deno的文章很多,大多数都是在讨论怎么安装Deno
、Deno有哪些特点
、Deno和Node有哪些异同
、Deno是不是Node的替代品
等。咱们今天不讨论这些,毕竟Talk is cheap. Show me the code!
亲自体验一把Deno开发带来的快感,用Deno搞一个“企业级”
应用:deno-supermarket[1],难道不香吗?
在实战之前,还是先来介绍几个我在刚接触Deno时遇到的小坑。
我们都知道,Deno默认是安全的,就是导致了默认情况下是不允许访问网络、读写文件等。比如有个名为index.ts
的文件内容如下:
import { serve } from "https://deno.land/std@0.50.0/http/server.ts";
const s = serve({ port: 8000 });
console.log("http://localhost:8000/");
for await (const req of s) {
req.respond({ body: "Hello World\n" });
}
如果直接执行deno run index.ts
,会报错:error: Uncaught PermissionDenied: network access to "0.0.0.0:8000", run again with the --allow-net flag
所以我们很自然的就会在启动命令的最后加上--allow-net
,如下:
deno run index.ts --allow-net
但是,这样仍然会报错。查了资料才知道,--allow-net
、--allow-read
之类的标志是不可以放到文件名后面的,必须紧跟在deno run
后面,比如,如下才是正确的:
deno run --alow-net index.ts
为什么调换了位置就不行呢?issue
上的回答是,如果--allow-net
跟在文件名后面,是传给JS脚本而不是传给Deno。想了解更多可以看这个confused by order of cli option flags[2]。反正,记住一点就行:权限标志一定要跟在deno run
后面!
因为我们前端同学大多数平时很少写后台,不太清楚安全的重要性,为了避免遇到各种权限问题,我建议平时在写一些练手项目时,直接用deno run -A
来启用全部的权限。(「这只是方便调试,在生产环境中一定要慎用!」)
因为实战过程中使用了Mongodb
,所以需要引入Deno的第三方模块mongo[3],然而在启动项目会报错:error: TS2339 [ERROR]: Property 'openPlugin' does not exist on type 'typeof Deno'.
查了一下,发现是因为openPlugin
这个方法目前还不稳定。默认情况下,Deno只会提供稳定的API。如果需要开启不稳定API,可以添加--stable
标志。比如:
deno run -A --unstable index.ts
可能有人会问,-A
和--unstable
的位置调换会不会有问题。这个亲测过不会有问题。只要标志符在文件名称之前就行了。
还有个问题,到底哪些是稳定API,哪些是不稳定API呢?其实Deno官方文档已经帮我们分好类的了,入口地址分别是:
如果你怀疑--unstable
的作用,可以使用下面的方法打印出Deno
上的所有成员:
console.log(Object.keys(Deno).length);
使用deno run --unstable index.ts
输出的结果是117
,使用deno run index.ts
输出的结果是88
。说明稳定的API有88个,不稳定的有29个。
从Node切换到Deno,我们的开发思维也要随之转变。所以,我们再来看看Deno的一些和Node不一样的开发技巧。
刚开始我也很疑惑:没有了package.json
,那怎么控制各依赖的版本呀?比如,我们有10个文件都依赖了mongo@0.0.6
,那每个文件都使用以下代码进行引入:
import { init, MongoClient } from "https://deno.land/x/mongo@v0.6.0/mod.ts";
可是有一天,我突然想把0.6.0
升级到0.7.0
,那怎么办呢?一个个文件的进行替换容易漏掉,当然也可以全局搜索批量替换。但是这种效率都不是很高。
官方给出的推荐做法是,使用deps.ts
文件来引入远程文件,并管理版本。当然,文件名称不一定叫做deps.ts
, 你也可以改成其他的名称。具体做法就是,把所有用到的远程依赖,都在deps.ts
中引入,并且通过Re-export
手段导出各依赖,然后其他文件就可以从deps.ts
中拿到所需要的依赖了。
回到刚才说10个文件都依赖到mongo
的问题,如果改成deps.ts
文件来统一管理是这样的:
export * from "https://deno.land/x/mongo@v0.6.0/mod.ts";
然后那些需要用到 mongo 的文件,不要直接从远程引入,而是从deps.ts
中引入,如下:
import { init, MongoClient } from "../pathTo/deps.ts";
如果需要升级的话,我们可以直接把deps.ts
里面的mongo
地址中的0.6.0
改成0.7.0
就行了。
另外,有一点和npm
类似的是,如果没有指定版本号,即远程地址中没有指定版本,比如:
export * from "https://deno.land/x/mongo/mod.ts";
就会默认安装最新版的依赖。
使用Node,可以到npm
上查找一些库。Deno也有类似的平台,目前分为两种库,一种是官方标准的,另外一种是第三方的。标准库可以到这里查找:Deno Standard Modules[6]。第三方库可以到这里查找:Deno Third Party Modules[7]。
OK,具备以上的知识点,现在可以实战了。首先,需要保证你的电脑安装了Deno1.0。另外,由于用到了Mongodb
,所以需要你的电脑也要安装Mongodb
。
先来看看我们的商城的界面:
麻雀虽小五脏俱全哈!具备添加商品、查询商品、删除商品、修改商品的功能。这是典型的「REST API」风格的系统。
然后再来看看项目结构:
mongo
模块所下载的动态链接库,不用关注它Mongodb
的相关配置文件。目前写死的端口号是27017
,如果你的Mongodb
端口不是这个,可以在这个文件里面修改Re-export
出去给其他文件使用express
或koa
时的入口文件app.js
类似因为该项目涉及到了前后端,如果使用Node的话,一般会选择express
或koa
。同样的,我们使用Deno也要选择对应的框架,不然http服务
以及路由跳转
等都不是那么容易处理的。Deno上的这类框架,比较多人star的是oak[8]和abc[9],这里我们选择使用abc
。
另外,因为使用Mongodb
,所以还需要引入mongo[10]。