流動圖書館
流動圖書館是一個圖書漂流和借閱工具，旨在共享閑置圖書，并鏈接趣味相投的小伙伴。
預覽
技術棧
- 小程序MINA框架： 一個響應的數據綁定框架。分為兩塊視圖層(View)和邏輯層(App Service)
- Flex：flex彈性布局
- Express : http服務框架
- websocket: 前后端消息的實時推送
- mongoose: 操作mongodb數據庫
- pm2: 服務端使用pm2部署，常駐進程
截圖
首頁
借閱書架
發布的圖書
借閱的圖書
客戶端
-
代碼結構
微信小程序中每個頁面會有四個文件 .js .json .wxml .wxss
js文件中是頁面的邏輯，json文件是頁面的一些配置，wxml是小程序的頁面結構，wxss為頁面的樣式。
- 封裝http請求
const request = (obj) => {
if(obj.header){
obj.header.sessionId = session.sessionId;
}else{
obj.header = { sessionId: session.sessionId};
}
wx.request(obj);
}
在請求頭中手動加上sessionId,因為小程序沒有cookie。
- websocket
//連接websocket
wx.connectSocket({
url: 'wss://liudongtushuguan.cn/socket?sessionId=' + session.sessionId,
});
wx.onSocketOpen(function(res){
});
wx.onSocketClose(function(res){
console.log('websocket closed');
});
wx.onSocketMessage(function(res){ //收到消息的回調
let msg = JSON.parse(res.data);
let msgs = that.data.borrowMessage;
msgs.unshift(msg);
that.setData({ borrowMessage: msgs});
});
//發送socket消息
let data = JSON.stringify({
targetId: bookData.ownerId,
nickName: APP.globalData.userInfo.nickName,
bookName: bookData.title,
time: new Date().toLocaleString(),
bookId: bookId,
wxNum: wxNum,
phoneNum: phoneNum,
msg: msg,
});
wx.sendSocketMessage({
data: data,
});
服務端
- 代碼目錄
- Express框架實現http服務
const https = require('https');
const fs = require('fs');
const express = require('express')
const cookieParser = require('cookie-parser');
const bodyParser = require('body-parser');
const app = express();
const queryString = require('querystring');
const URL = require('url');
const socket = require('./service/socket');
const router = require('./routes/router').router;
//獲取認證證書
var key = fs.readFileSync('./key/2_www.liudongtushuguan.cn.key');
var cert = fs.readFileSync('./key/1_www.liudongtushuguan.cn_bundle.crt');
var options = {
key : key,
cert : cert,
};
app.use(cookieParser());
app.use(bodyParser.json());
const httpsServer = https.createServer(options,app);
httpsServer.listen(443,() =>{
console.log('listening 443 port');
});
socket(httpsServer); //websocket
app.use(router);
小程序規定必須要用https協議。
- websocket模塊
這里使用ws模塊而沒有選擇使用http://socket.io，因為小程序客戶端不支持http://socket.io
const WebSocket = require('ws'); //使用ws模塊
const queryString = require('querystring');
const URL = require('url');
const sessions = require('./session');
module.exports = (httpServer) => {
const wss = new WebSocket.Server({server : httpServer});
wss.on('connection',(ws, req) => {
let sessionId = queryString.parse(URL.parse(req.url).query).sessionId;
ws.id = sessionId;
ws.on('message' , (msg) => {
let msgObj = JSON.parse(msg);
if(sessions[msgObj.targetId]){
wss.clients.forEach((client) => {
if(client.id === msgObj.targetId){
let data = {
time : msgObj.time,
borrower :msgObj.nickName,
book :msgObj.bookName,
borrowerId : sessions[sessionId],
bookId : msgObj.bookId,
wxNum : msgObj.wxNum,
phoneNum : msgObj.phoneNum,
msg : msgObj.msg
};
client.send(JSON.stringify(data));
}
});
}
});
});
};
- mongoose操作數據庫
db.js:
const mongoose = require('mongoose');
mongoose.connect('mongodb://app:12345678@127.0.0.1/wxapp');
const connection = mongoose.connection;
connection.once('open', (err) => {
if(err){
console.log('Database connection failure');
}else{
console.log('Database opened');
}
});
connection.on('error',(err) => {
console.log('Mongoose connected error '+ err);
});
connection.on('disconnected', () => {
console.log('Mongoose disconnected');
});
module.exports = {
connection : connection,
mongoose : mongoose,
};
model.js:
const Schema = mongoose.Schema;
const UserSchema = new Schema({
onlyId : {type: String},
publishedBooks : {type: Array},
borrowedBooks : {type: Array},
borrowMessages : Array,
});
const BookSchma = new Schema({
isbn : String,
title : String,
press : String,
author : String,
rate : String,
tags : String,
image : String,
status : {type : Boolean,default : true},
ownerId : String,
owner : String,
ownerImage : String,
});
const userModel = mongoose.model('user' , UserSchema);
const bookModel = mongoose.model('book' , BookSchma);
module.exports = {
UserModel : userModel,
BookModel : bookModel,
}
- 獲得微信用戶的openId
小程序前端會請求微信服務器得到一個code, 將code發送給自己的服務器，然后自己的服務器給微信服務器發送請求，得到微信用戶的唯一標識openId
const https = require('https');
const queryString = require('querystring');
const sessions = require('./session');
module.exports = (req, res, next) => {
let code = req.query.code;
let otherRes = res;
DATA.js_code = code;
OPTION.path = PATH + queryString.stringify(DATA);
let wxReq = https.request(OPTION, (res) => {
if(res.statusCode == 200){
let json = '';
res.on('data' , (data) => {
json+=data;
});
res.on('end' , () => {
json =JSON.parse(json);
let openId = json.openid;
sessions[openId] = openId;
otherRes.type('application/json');
otherRes.json({
data : {'sessionId' : openId},
});
otherRes.status(200);
});
}
});
wxReq.end();
};
使用pm2部署
安裝pm2
npm install -g pm2
啟動應用
pm2 start app.js
總結
流動圖書館小程序是由三個人的小團隊設計和開發的。我主要負責前后端的開發工作。這對從來沒接觸過服務端和小程序開發的我來說是一個挑戰當然也是一次難得的學習機會。從最初對小程序，服務端兩眼一抹黑，到搭建出應用的雛形，實現基本的效果，再到最后的拆分整合代碼，這期間經歷了很多，也收獲了很多。從數據庫的設計到后臺數據庫操作、會話管理、http服務接口一直到前后端數據交互、小程序前端，我對程序開發的大致流程有了更進一步的了解，彌補的之前對服務端知識的缺失。
三個人的小團隊，因為興趣結在一起，利用工作之余的時間完成自己喜歡的事情真的是一件令人十分有成就感的事情。
有興趣的可以看源碼
如果覺得不錯，就毫不吝嗇地給個star吧。后期項目還會繼續更新和完善。
本文作者：wenke
原文地址：流動圖書館微信小程序
