欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

Node.js Express安装与使用教程

程序员文章站 2023-11-20 08:17:52
之前我们在安装完node.js后直接写了个helloworld网站,这次呢,我们使用node.js的web框架express来重写一下helloworld,看看有什么不同。...

之前我们在安装完node.js后直接写了个helloworld网站,这次呢,我们使用node.js的web框架express来重写一下helloworld,看看有什么不同。同时我们还会重写之前的文件服务器,功能更完善而代码更简洁。

安装 express

为了重写我们的helloworld,我们需要安装express模块。express基于node.js的一个web框架,官方网站在这里:。官网对express的介绍是:

fast, unopinionated, minimalist web framework for node.js

express很轻巧,通常用来做web后端的开发。有一些推荐的书,可以看这里:。

要安装express模块,直接使用npm命令即可。在命令行环境下不带参数执行npm命令,即可看到npm的帮助信息。安装某个node.js模块,使用install子命令。“npm install xxx”会将xxx模块安装到当前路径下,“npm install -g xxx”则将xxx模块安装到当前用户的全局位置。使用“npm helo install”可以查看install子命令的细节。要卸载一个模块,使用“npm uninstall xxx”,假如你是全局安装,则使用“npm uninstall -g xxx”。

在使用npm安装某个模块时,它会自动解决依赖。

在命令行环境执行下面的命令来安装express:

npm install -g express –registry=https://registry.npm.taobao.org

注意,我指定了使用淘宝的镜像,快一些。

特别说明一下:

我参考了这里的教程哦:

很快啦,你就可以看到下面的界面(注意我们安装的express版本是4.13.3):

Node.js Express安装与使用教程

好啦,express安装完毕。

需要说明的是,使用-g命令全局安装node.js模块后,需要设置环境变量node_path,否则在我们使用node命令启动某个应用时可能会报找不到指定的模块这种错误。在我的windows 7环境下,全局安装时npm模块的位置为“c:\users\administrator\appdata\roaming\npm\node_modules”(看上面的图可知)。至于环境变量的设置,计算机->高级系统设置->高级->环境变量,添加一个名为node_path的环境变量, 将其值设置为全局模块的根目录。设置完成后,重新进入命令行环境即可生效。

提一下,如果要在node_path中添加多个模块路径,只需用“;”分隔开即可。具体含义,命令行下执行“node -h”可查看帮助。

helloworld

代码就是这么简单:

// 引入 express 模块
var express = require('express');

// 创建 express 实例
var app = express();

// 响应http的get方法
app.get('/', function (req, res) {
 res.send('hello world!');
});

// 监听到8000端口
app.listen(8000, function () {
 console.log('hello world is listening at port 8000');
});

保存为helloexpress.js,然后在node.js的命令行环境下执行“node helloexpress.js”命令,网站就运行起来了。浏览器访问一下,和上次的示例一样一样的。

使用express有什么不同

没有使用express的代码是酱紫的:

// 引入http模块
var http = require("http"); 

// 创建server,指定处理客户端请求的函数
http.createserver(
  function(request, response) { 
    response.writehead(200, {"content-type": "text/plain"}); 
    response.write("hello world!"); 
    response.end(); 
  }
).listen(8000); 

console.log("hello world is listening at port 8000");

上面的代码直接使用node.js带的http模块来创建http服务器,指定了一个处理请求的函数。实际应用时,我们需要在这个函数内区分不同的http请求,比如get、head、post等。而express版本的helloworld则有所不同,它可以针对每一个路径和http请求指定响应函数,比如express版本的helloworld实例,只有你在浏览器中输入“http://localhost:8000”时它才会返回“helloworld”,如果你在浏览器中输入“http://localhost:8000/abc”,你就看到一条错误信息(会收到404状态码,express自动帮你处理了)。这里边有一个url路由(url routing)的概念。假如把代码修改成下面的样子:

app.get('*', function (req, res) {
 res.send('hello world!');
});

效果就和使用http模块的版本类似了。因为我使用了“*”作为通配符,可以匹配任何路径。express的get方法原型如下:

app.method(path, callback [, callback …])

具体可以参考这里:http://expressjs.com/4x/api.html#app.method

使用express创建helloexpress

express模块有一个命令行工具express,可以用来生成基于express模块的应用结构(网站结构)。

express 4.x之后,express命令被独立出来放在了express-generator模块中。我们用下面的命令全局安装express这个命令行工具:

npm install -g express-generator

安装完成后,在命令行环境下执行“express -v”,可以看到express的版本是4.13.1。

好了,现在我们使用express命令来创建一个默认的网站。

在命令行环境下导航到myprojects这个目录下,执行下面的命令:

express helloexpress

然后可以看到:

Node.js Express安装与使用教程

仔细看上面的图哦,它告诉了我们三类非常重要的信息:

  1. express命令创建的网站的目录结构以及创建的文件
  2. 安装依赖(进入到helloexpress下,执行npm install)
  3. 使用npm start启动网站(express 4.x后)

好啦,我们先安装依赖。这里要先提一下helloexpress目录下的package.json文件,其内容如下:

{
 "name": "helloexpress",
 "version": "0.0.0",
 "private": true,
 "scripts": {
  "start": "node ./bin/www"
 },
 "dependencies": {
  "body-parser": "~1.13.2",
  "cookie-parser": "~1.3.5",
  "debug": "~2.2.0",
  "express": "~4.13.1",
  "jade": "~1.11.0",
  "morgan": "~1.6.1",
  "serve-favicon": "~2.3.0"
 }
}

这个文件定义了一个node.js应用的基本信息,我们这次注意的是 dependencies ,它定义了应用依赖的模块。

在helloexpress下执行“npm install”命令,npm会自动找到package.json,分析它,安装所有依赖模块。这要花费一些时间,休息一下,去喝杯茶。

看看,下面是安装结果:

g:\nodejs\myprojects\helloexpress>npm install
debug@2.2.0 node_modules\debug
└── ms@0.7.1

cookie-parser@1.3.5 node_modules\cookie-parser
├── cookie-signature@1.0.6
└── cookie@0.1.3

serve-favicon@2.3.0 node_modules\serve-favicon
├── fresh@0.3.0
├── etag@1.7.0
├── parseurl@1.3.0
└── ms@0.7.1

morgan@1.6.1 node_modules\morgan
├── basic-auth@1.0.3
├── on-headers@1.0.0
├── depd@1.0.1
└── on-finished@2.3.0 (ee-first@1.1.1)

body-parser@1.13.3 node_modules\body-parser
├── content-type@1.0.1
├── bytes@2.1.0
├── depd@1.0.1
├── on-finished@2.3.0 (ee-first@1.1.1)
├── qs@4.0.0
├── iconv-lite@0.4.11
├── http-errors@1.3.1 (inherits@2.0.1, statuses@1.2.1)
├── raw-body@2.1.2 (unpipe@1.0.0)
└── type-is@1.6.6 (media-typer@0.3.0, mime-types@2.1.4)

express@4.13.3 node_modules\express
├── escape-html@1.0.2
├── merge-descriptors@1.0.0
├── array-flatten@1.1.1
├── cookie@0.1.3
├── cookie-signature@1.0.6
├── methods@1.1.1
├── utils-merge@1.0.0
├── range-parser@1.0.2
├── fresh@0.3.0
├── path-to-regexp@0.1.7
├── vary@1.0.1
├── content-type@1.0.1
├── etag@1.7.0
├── parseurl@1.3.0
├── content-disposition@0.5.0
├── serve-static@1.10.0
├── depd@1.0.1
├── qs@4.0.0
├── finalhandler@0.4.0 (unpipe@1.0.0)
├── on-finished@2.3.0 (ee-first@1.1.1)
├── send@0.13.0 (destroy@1.0.3, statuses@1.2.1, ms@0.7.1, mime@1.3.4, http-er
rors@1.3.1)
├── accepts@1.2.12 (negotiator@0.5.3, mime-types@2.1.4)
├── type-is@1.6.6 (media-typer@0.3.0, mime-types@2.1.4)
└── proxy-addr@1.0.8 (forwarded@0.1.0, ipaddr.js@1.0.1)

jade@1.11.0 node_modules\jade
├── character-parser@1.2.1
├── void-elements@2.0.1
├── commander@2.6.0
├── constantinople@3.0.2 (acorn@2.1.0)
├── mkdirp@0.5.1 (minimist@0.0.8)
├── clean-css@3.3.7 (commander@2.8.1, source-map@0.4.4)
├── uglify-js@2.4.24 (uglify-to-browserify@1.0.2, async@0.2.10, source-map@0.
1.34, yargs@3.5.4)
├── with@4.0.3 (acorn@1.2.2, acorn-globals@1.0.5)
├── transformers@2.1.0 (css@1.0.8, uglify-js@2.2.5, promise@2.0.0)
└── jstransformer@0.0.2 (is-promise@2.0.0, promise@6.1.0)

g:\nodejs\myprojects\helloexpress>

有兴趣的可以研究下各个依赖模块的信息,现在我们启动网站了。执行 npm start 命令,很快就可以看到下面的图:

Node.js Express安装与使用教程

看到上图,说明网站已正常运行。你可以在浏览器里访问http://localhost:3000,然后就可以看到这个页面:

Node.js Express安装与使用教程

ok,大功告成。

这个由express generator创建的helloexpress和我们基于express手动写的helloworld又有一些不同,比如你在浏览器地址栏里输入http://localhost:3000/abc,就会看到一个默认的404页面,显示了具体的错误信息。而我们的helloworld,显示的则是“cannot get /abc”这个文本串。这就是模板的便利之处,有很多默认处理,可以为我们省很多麻烦。

express版本的文件服务器

express是在node.js的http的基础上实现的,相比http模块,封装更多更适用于web服务器场景的功能。之前我们在node.js开发入门——http文件服务器里使用http模块实现了一个简单的文件服务器。那个版本的文件服务器还有一个缺陷,就是没有根据文件名设置http的content-type头部。如果我们使用express来实现文件服务器(用到了request对象的sendfile方法),哈哈,就只有几行代码,还解决了content-type问题!

代码如下:

var express = require('express');
var app = express();

app.get('*', function(req, res){
  res.sendfile(req.path, {root: __dirname+'/', dotfiles: 'deny'});
});

app.listen(3000);

是不是超级简单?

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。