node.js的Express框架起步

node.js的Express框架起步

  介绍一下如何使用Express框架开发项目。

  目录：

---

新建项目

  在命令提示符中输入：express <projectName>
  这样就自动生成了一个以jade为模板引擎的项目：
  
  接着根据提示继续在命令提示符中依次输入：

• 进入项目目录：cd install
• 安装依赖：express install
• 运行：npm start

  现在打开浏览器浏览器访问 http://localhost:3000/ :
  

---

解读app.js

var express = require('express');
var app = express();
// 上面代码首先加载express模块，赋给变量express。然后，生成express实例，赋给变量app。

// 接着，设定express实例的参数。

// 设定views变量，意为视图存放的目录
app.set('views', path.join(__dirname, 'views'));

// 设定view engine变量，意为网页模板引擎
app.set('view engine', 'jade');

// 设置网站图标
//app.use(favicon(path.join(__dirname, 'public', 'favicon.ico')));
// 输出有颜色区分的日志，以便于开发调试
app.use(express.logger('dev'));
// 解析POST请求主体
app.use(express.bodyParser());
// 协助处理POST请求伪装PUT、DELETE和其他HTTP methods
app.use(express.methodOverride());
app.use(app.router);

// 设定静态文件目录，比如本地文件
// 目录为demo/public/images，访问网址则显示为http://localhost:3000/images
app.use(express.static(path.join(__dirname, 'public')));

// catch 404 and forward to error handler
app.use(function(req, res, next) {
  var err = new Error('Not Found');
  err.status = 404;
  next(err);
});

// error handler
app.use(function(err, req, res, next) {
  // set locals, only providing error in development
  res.locals.message = err.message;
  res.locals.error = req.app.get('env') === 'development' ? err : {};

  // render the error page
  res.status(err.status || 500);
  res.render('error');
});

更改监听端口或启动方式

  更改监听端口可以修改bin\www文件里面的：

var port = normalizePort(process.env.PORT || '3000');
app.set('port', port);

  把上面代码里的 3000 改为你想要的值就可以了。
  之所以可以使用 npm start 命令来启动项目，是因为在根目录下的 package.json 文件里的配置：

"scripts": {
  "start": "node ./bin/www"
}

  当你的命令行中输入npm start (这其实是npm run start 的简写)就相当于执行了node ./bin/www。
  当然，如果你直接运行 app.js 文件，可以在 app.js 文件中的代码加入：

// 设定port变量，意为访问端口
app.set('port', process.env.PORT || 3000);
// 调用实例方法listen，让其监听事先设定的端口（3000）。
app.listen(app.get('port'));

  然后你就可以在命令提示符中输入 node app.js 来启动程序了。

---

配置路由

指定根路径

  在app.js之中，先指定根路径的处理方法。

app.get('/', function(req, res) {
    res.send('Hello World');
});

  get 方法的第一个参数是访问路径，正斜杠（/）就代表根路径；第二个参数是回调函数，它的 req 参数表示客户端发来的HTTP请求，res 参数代表发向客户端的HTTP回应，这两个参数都是对象。在回调函数内部，使用 HTTP 回应的 send 方法，表示向浏览器发送一个字符串。
  如果需要指定 HTTP 头信息，回调函数就必须换一种写法，要使用 setHeader 方法与 end 方法 :

app.get('/', function(req, res){
  var body = 'Hello World';
  res.setHeader('Content-Type', 'text/plain');
  res.setHeader('Content-Length', body.length);
  res.end(body);
});

指定特定路径

  上面是处理根目录的情况，下面再举一个例子。假定用户访问 api 路径，希望返回一个 JSON 字符串。这时，get可以这样写：

app.get('/api', function(request, response) {
   response.send({name:"楚留香",age:30});
});

  我们也可以把 app.get 的回调函数，封装成模块。先在routes目录下面建立一个api.js文件。

// routes/api.js
exports.index = function (req, res){
  res.json(200, {name:"楚留香",age:30});
}

  然后，在app.js中加载这个模块：

// app.js
var api = require('./routes/api');
app.get('/api', api.index);

---

静态网页模块

  在项目目录之中，有一个子目录 views，用于存放网页模板。
  假定这个项目有三个路径：根路径（/）、自我介绍（/about）和文章（/article）。那么，app.js可以这样写：

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

app.get('/', function(req, res) {
   res.sendfile('./views/index.html');
});

app.get('/about', function(req, res) {
   res.sendfile('./views/about.html');
});

app.get('/article', function(req, res) {
   res.sendfile('./views/article.html');
});

  上面代码表示，三个路径分别对应views目录中的三个模板：index.html、about.html和article.html。另外，向服务器发送信息的方法，从send变成了sendfile，后者专门用于发送文件。

---

动态网页模板

  在 app.js 文件中设定 view engine 变量，设置网页模板引擎，可以是 jade，也可以是 ejs 等。

app.set('view engine', 'jade');
//app.set('view engine', 'ejs');

  可以这样使用模板返回网页给请求者：

res.render('index', { title: 'Express' });

  其中，‘index’ 指的是模板 index.jade ，后面的 json 对象是传入模板的数据，这样就实现了将我们的数据填充到模板后展示出完整的页面，也就是实现了动态网页技术。

---

指定静态文件目录

  模板文件默认存放在views子目录。这时，如果要在网页中加载静态文件（比如样式表、图片等），就需要另外指定一个存放静态文件的目录。
  在 app.js 中设定静态文件目录：

app.use(express.static('public'));

  上面代码在文件app.js之中，指定静态文件存放的目录是public。于是，当浏览器发出非HTML文件请求时，服务器端就到public目录寻找这个文件。比如，浏览器发出如下的样式表请求：

<link href='/stylesheets/style.css' rel="stylesheet">

  服务器端就到public/stylesheets/目录中寻找style.css文件。