lbs@node
2018年的4月26日,我在自己的idea清单中,加上了一条“基于 nodejs 移植 lbs 博客系统”。
一、lbs 是什么东东?
它是一款比较小众的博客程序,是基于微软的ASP环境运行的,作者是SiC,最后的版本应该是 2.0.313,更新于 2007年7月3日。
(注:整理了一份代码到Git上,见: )
二、扯淡
ASP在我那个年代,是学生能接触到的最好的编程语言和环境,尽管它不是语言,但一直作为一种编程语言的代称。ASP 基于IIS Web服务器,借助于微软Windows系统的脚本宿主环境,支持运行VBScript和JScript两种脚本语言,版本大致在5.X范围。
那时大家编写 ASP 程序都只知道用 VBScript。而 lbs 能够被大家所铭记,则是因为它是基于 JScript 写的。尽管其中有少量代码混合使用了 VBScript,但这不妨碍我等文艺青年的逼格追求。
熟悉我的童鞋都知道,我是有丝丝个人站长情节的。虽然没有经历第一代站长像雷布斯、小马哥、丁三石那个年代,但也算是经历过了草根站长的中后期阶段。
到后来所谓Web 2.0的时代,只剩下博客和博主了。再现在的新媒体时代,满眼则只剩网红了。
说这些呢,只是为了间接说明当年研究过各种“建站”系统,而自己也搭过不少次的博客站点。其中但凡需要动态程序支持的,都没有坚持下来;而翻译的一个静态技术文章的站点,反而因为其信息本质的价值得以一直存活。所以后来也放弃了自建,改用第三方服务,如博客园。
但情结就是情结,对一个事物有了情结,除非你真的得到拥有过Ta,否则,就不可能真的放下,对吧,小龙。
三、源头
这种情结驱使我在idea清单中添加了很多类似的事项,一大半都是已经打勾了的,因为很多想法自己虽然没去实现,但已经有人实现了,或者仔细考虑过实在没有意义。
而剩下的那些里面,基于 Node.js 改造这款 lbs 博客程序的意义在哪呢?
今年一直在用Nodejs,但主要是围绕遗留的系统,还是N年前ES5时代的回调、ES6时代的yield,混合写法的产物,代码的可读性比较差,这样的系统也不会闲着没事去完全重构,投入产出比在那。那么,就只有自己拿些东西练手了。
但程序员,你知道的,都是死脑筋,眼里只有技术,很少会有还具备比较完整的产品idea,能自产自销的。所以,不拿一个现有系统去折腾,而只是随便写点demo也是没用的,得不到完整的项目经验积累。
这样,就想起来了以前用过的这套比较小型的博客系统,刚好是基于Js语法写的,然后想看看基于Nodejs这样的代码该如何写。
四、过程
基本过程是这样:
1、五一之前的那几天,正式开始研究。
- 先解读了其代码组织结构,确定了基本的MVC方式的对应关系,比如lib、service、model、controller、view等;
- 数据库原本是基于Access的,在SQLite、MongoDB、MysQL中选,最后决定MySQL;
- 也做了框架选型,开始是想基于express/kraken 那一套,也让小部分功能界面跑起来了;也测试了国产的 thinkjs,基本在thinkjs下走了一遍流程,它是基于koa的,支持async/await了,代码可读性就能达到正常水平。
代码结构认知
1. 根目录下那些功能性代码文件如user.js 相当于是 每个功能的路由值 + 视图内容;2. class 对应的是 Logic3. source 对应是 控制器4. lang 是语言包5. data db 文件所在目录6. www 所有前端静态资源文件
2、9月1号加深了不少认知
5月到8月实际上忙到非常,头发也快掉光。
8月底9月初那几天有了点空,又重新梳理了一下,定了一下基调。
基调:
1)小型;所以数据库继续使用 小型数据库如 sqlite;
2)路由;完全兼容 lbs 原来;含asp文件 及其它前端静态资源文件; 3)原来的代码结构尽量保持; 4)框架选型?实现一套兼容 asp 运行环境的库,达到最小化改动lbs 原有代码的目的; 5)模板引擎 ejs;js 原始语法思考过程:
基于thinkjs,然后充分模拟原始运行环境
基于thinkjs是对的,其做了很多封装、整合的工作,避免了从头开始的过程;db层可以切换多种数据库引擎;全局对象都应该以中间件形式存在,才能在相关代码中简单访问到 ctx 对象;
i18n 目前只能在控制器和视图中访问,如何处理?;the 开头的一些全局对象、lang、input、Application、Sesson 函数langfuncconnBlogtheCachetheUserSessionApplication
npmjs 中查找asp asp 兼容asp3语法、基于js-fpm、还没有完成,废的;node-fastcgi:与主流的nodejs 思路相背,坑会比较多,不考虑;
基于koa?方法
先将标准降低一个档次;以一种具体的框架的原有模式为主导,先实现一个lbs的版本;然后再按最高标准:完全原封不动的在nodejs环境实现lbs的运行;而这种目标会因为涉及fastcgi、asp运营环境等属于服务器和框架级别的工作量,会导致无法达成目标;
9月13号
开始有空看看开源中国的新闻了,无意中看到eggjs的介绍,确定了基本这款框架来进行,主要的理由是,它这里面没有固定的Model概念,只有service,与lbs原来的代码结构能贴合一些。
Egg.js
『约定优于配置』- 深度框架定制
- 高度可扩展的插件机制
- 内置多进程管理
- 基于 koa 开发,性能优异
11月16日
又是很忙的一个阶段,一下又到年底了,才开始将这个事放在手机的提醒app里每天提醒。
1、基于 egg.js 框架
2、代码保持原有的结构和写法; 3、2018 结束前完成; 4、确定开发任务清单1)[x]框架确定-egg、[x]代码结构确定、[x]模版引擎确定-ejs、[x]数据库确定-mysql;2)cookie、session3)db 引擎 [x] 方法封装 []表名处理 [blog_] []top 条件处理3)[x]i18n4)view5)cache []中涉及到原asp的 Application 数据存取、数组的 ubound 等专有属性方法;6)user7)lib8)功能移植;login、register、user、default、article、comment、feed、trackback、stats、gbook;
从模版的迁移方式开始;
Helper 的实例还可以在模板中获取到
{ { helper.shtml(value) }}'use strict';module.exports = app => { app.beforeStart(async () => { app.locals = { strTitle: 'Page Title', }; });};
[]func => helper
业务代码中 ctx.helper
视图中则 helper.[x]lang []i18n
[]theCache
[]theUser11月22日
将about页面视图基本调试正常,主要是解决了cache service;
下一步沿着登陆页面,走通theUser user service;涉及到 theCache、Session、connBlog、input、func、ServerVariables、Cookies、验证码
connBlog 是全局对象,意味着没有 context
theCache、theUser 应该是 请求级对象,都依赖于 ctx;
将Cache 一分为二;大部分属于 App级别的,少部分可以转到 helper中去;
12月17日
[x]1、验证码图片加载;
2、登陆结果处理; 3、注册 4、找回密码; 5、管理员登陆;this.ctx.__('scode_invalid’)
不能展开成 __ 函数进行使用;
const { theCache, connBlog, session, helper: func, cookies, logger } = this.ctx;
最佳实践,可能可以尽量保留原代码;
用中间件的形式实现全局对象的数据初始化执行,让需要提前初始化的代码被执行;而且支持 async/await,否则无论是 application.js app.js 还是 context.js 都不满足场景;