基础的 express 实现静态文件访问
index.js
开启 http
服务
const express = require('express'); // 引入 express 模块
const globalConfig = require('./config'); // 导入全局配置
const app = new express(); // 实例化一个 express
app.use(express.static(globalConfig['page_path'])); // 告诉 express 示例, 静态文件的位置
app.listen(globalConfig['port']); // 监听配置文件中的端口
server.conf
是服务的配置文件
port=8081
page_path=page
config.js
用来处理 server.conf
,将配置文件转换为配置对象
/*
将配置文件格式化成对象键值对的形式
*/
const fs = require('fs'); // 引入 fs 模块
let globalConfig = {}; // 定义全局配置对象
let conf = fs.readFileSync('./server.conf'); // 同步读取 server.conf 文件
let confArr = conf.toString().split("\n"); // 通过回车符拆分
for (let i = 0, len = confArr.length; i < len; i++) {
globalConfig[confArr[i].split('=')[0]] = confArr[i].split('=')[1]
}
module.exports = globalConfig; // 将配置对象导出
page 文件夹中存放页面文件
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<h1>Hello, world!</h1>
</body>
</html>
然后运行 index.js
,浏览器访问127.0.0.1:8081
基于 express 搭建 web 服务
这个不同于上面简单的web服务,这是一个完整的简易 web 服务。
首先目录是这样的:
server.conf
尽管它不在一个文件夹中, 也是很重要的一环
这个文件定义了整个服务的基本信息。
port=8081
page_path=page
web_path=web
尽管只有简单的三行, 但是业务逻辑复杂之后, 这个文件也会逐渐丰满的。如果不定义此文件,在需要这些字段的时候,就会变得很麻烦。例如改端口号, 可能很多地方都需要改, 但是有这个文件, 只需要修改文件中的端口就好了。
config.js
有了配置文件, 肯定需要一段代码去解析配置文件。
/*
将配置文件格式化成对象键值对的形式
*/
const fs = require('fs'); // 引入 fs 模块
let globalConfig = {}; // 定义全局配置对象
let conf = fs.readFileSync('./server.conf'); // 同步读取 server.conf 文件
let confArr = conf.toString().split("\n"); // 通过回车符拆分
for (let i = 0, len = confArr.length; i < len; i++) {
globalConfig[confArr[i].split('=')[0]] = confArr[i].split('=')[1]
}
module.exports = globalConfig; // 将配置对象导出
这个文件的目的是将上面的配置文件格式化为对象的形式:
{
port: '8081',
page_path: 'page',
web_path: 'web',
'': undefined
}
然后在需要配置项的地方使用globalConfig.xxx
的形式即可。
index.js
此文件用于创建服务。
const express = require('express'); // 引入 express 模块
const globalConfig = require('./config'); // 导入全局配置
const app = new express(); // 实例化一个 express
const loader = require('./loader')
app.use(express.static(globalConfig['page_path'])); // 告诉 express , 静态文件的位置
app.post("/dosomething", loader.get("/dosomething")) // 请求数据的方法
app.listen(globalConfig['port']); // 监听配置文件中的端口
app.post("/dosomething", loader.get("/dosomething"))
:
假设点击了一个按钮, 这个按钮要获取数据。这个请求可能是www.example.com/dosomething?name=xx&age=yy
, 然后服务监听到这个请求, 然后就会去loader.js
中寻找对应的处理函数, 对这个请求进行处理。至于参数在哪里, 这个请求是怎么处理的, 在下面会介绍。
这个时候服务已经搭好, 已经可以访问静态文件了。
page
page
文件夹之下都是静态资源信息。如果请求为静态资源, 会直接去express.static
参数的文件夹下寻找。
web
如果说 page
文件夹存放静态资源, 那么 web
的作用就是存储获取动态数据的方法。
在这里, 有许多的 controller
,是用来处理逻辑的。这里有一个dosomething
的例子:
const timeUtil = require('../Utils/timeUtil')
const writeRes = require('../Utils/resultUtil')
let path = new Map()
let dosomething = require('../dao/somethingDao');
function something(request, response) {
request.on('data', function (data) {
dosomething.dosomething(data, timeUtil.getNow(), function (res) {
response.writeHead(200)
response.write(writeRes.writeResult("success OK", timeUtil.getNow(), res))
response.end()
})
})
}
path.set("/dosomething", something)
module.exports = path
请求的url
在request
里面。可以使用url
模块解析这个url
获取对应的参数信息。data
就是post
请求发送过来的参数。这里忽略了对 data
的解析。
loader.js
const fs = require('fs')
const globalConfig = require('./config')
let controllerSet = []
let pathMap = new Map()
let files = fs.readdirSync(globalConfig['web_path']) // 读取文件夹
for (let i = 0, len = files.length; i < len; i++){ // 读取 files 中所有的文件
let temp = require('./' + globalConfig['web_path'] + '/' + files[i]) // 引入 web 里面的文件
if(temp.path){
for (let [key, value] of temp.path){ // 读取 每一个文件的 path
if(pathMap.get(key) == null){ // 如果在 pathMap 中没有, 就添加进去
pathMap.set(key, value)
}else { // 如果进入 else , 说明 url 重了。 这当然不允许
throw new Error("url error, url: " + key);
}
controllerSet.push(temp)
}
}
}
module.exports = pathMap // 将 pathMap 导出
读取上面的web
文件夹, 引入所有的js
文件, 引入一个解析一个, 获取到所有的处理动态数据的方法, 将这些方法全部放入一个叫做pathMap
的Map
中 ,然后将之导出, 在index.js
里面引入pathMap
。然后根据不同请求, get
到loader
里面对应的方法。
dao(Data Access Object)
此文件夹下有两类文件,第一类只有一个, 叫做DBUtil.js
,它用于创建一个与数据库的链接。
let mysql = require('mysql')
function createConnection() {
return mysql.createConnection({
host: "127.0.0.1",
port: "3306",
user: "root",
password: "123546",
database: "test"
})
}
module.exports.createConnection = createConnection
第二类可能有很多个, 它们用于响应用户请求对数据库的增删改查操作。
这里是上面dosomething
的例子:
const DBUtil = require('./DBUtil') // 引入创建数据库的工具方法
function dosomething(content, ctime, success) {
let sql = "insert into table (`content`, `ctime`) values (?, ?)" // 编写数据库查询语句
let params = [content, ctime] // 定义参数列表
let connection = DBUtil.createConnection() // 创建一个数据库的链接
connection.connect() // 连接
connection.query(sql, params, function (err, result) { // 进行查询
if (!err){ // 如果过程没有出错
success(result)
} else {
console.log(err)
}
})
connection.end() // 查询完毕一定要关闭数据库的连接
}
module.exports.dosomething = dosomething // 将此方法导出,供 web 层使用
至此, 文件夹说明完毕。
回顾整个流程。
使用 express
开启一个服务。
使用 app.get, app.post
等待对应的请求进来。
请求进来之后, 使用loader.get()
拿到对应的处理方法。这个方法去查询数据库, 逻辑复杂的还要经过逻辑处理流程, 查询完毕之后执行loader
预先设置到的回调函数, 这个回调函数返回给客户端需要的数据。