基于NODEJS的前后端项目分离实践

时间:2022-08-28 13:19:47

前后端分离项目实践

 

一、前言

     nodejs有了些准备,希望多了解些后端知识,恰逢公司项目调整,分析了前后端分离的优劣,也做了一个完整的demo演示,同事都觉得靠谱,用了两个版本的时间,将公司主站项目用nodejs实现了前后端分离,在此和大家分享下,以求共同进步。案例参见 www.upopen.cn

 

二、为何做分离

     1、开发体系:架构体系决定了后端重于前端,前端做好静态页后,要转为phpvm等,开发要用eclipce等后端环境工作,一大堆让前端迷糊的配置,一旦java人员更新了错误的文件,会导致所有人的环境启动不了,束手无策,只能等待救援。

     2、难维护:页面总是会有php\jsp等非前端代码,相互干扰、无法优化,时间越久问题越突出。

     3、前后端职责不清晰。

     有人会问,分离为什么不全部走ajax,页面就不需要任何服务端语言了。但实际场景并非如此,首先有些数据总是要生成页面时就已经同步获取的,且全异步对SEO不利、纯html页面没有include功能等。

网上还有其它的理解,大致相同就不列举了。

 

三、如何做分离

     1、产品设计确定后,前后端人员共同制定开发接口,为方便接口的制定、显示、测试,使用nodejs+mongodb开发了接口平台。参见http://www.upopen.cn:8090/interface/index

功能:制定接口时就直接在interface平台上新增录入ActionNamedescription、 method、 param 及 默认值 等并保存到mongodb,当后台开发完成后,直接用在该页面做接口测试,成功后方可交付,避免联调过程中的接口反复。(原本想用interface.upopen.cn 来测试同域名下的项目,但因cookie在不同二级域名下无法共享的问题,暂用了二级目录,不过已有方案,后续优化)

 

     2、从前端角度考虑系统架构图如下:

基于NODEJS的前后端项目分离实践

 

  1. 访问入口 NGINX 代理静态资源到 STATIC 服务器,其它请求则到 NODEJS

  2. 页面请求NODEJS直接render,数据相关NODEJS则做预处理,再发到后台

  3. 前端据已定义的接口,通过nodejs+mysql模拟后台完成数据存取,此处会增加些工作量,但只是为了走通业务流程,模拟后台数据表定义及逻辑无需严谨,只要能正常存取即可,如注册用户save to DB,登录验证read from DB,所以提供模式化的工具、写法后,新增表、接口,并不会多耗时间,nginx – nodejs – 模拟后台,即可按实际使用完成所有前端工作。

  4. QA单独测前端时,修改hostIP指向到测试工具。

  5. Java开发完成后接口,在 Interface平台 上验证所有接口,确认无误。QA也可以通过Interface测试Java接口

  6. nodejs修改config里的hostIP配置到java,理想情况下,修改此步配置即完成联调

 

每个模块的简略部署如下:

Nginx.conf

     Location ~ \.(jpg|png|css|js ){ //静态资源代理

          Root /root/static/;

     }

     Location \{ //其它接口转发

     Proxy_pass http://upopen.cn;

}

Upsteam upopen.cn{

     Server http://node.upopen.cn;

}

 

STATIC 结构如下:使用require.js做模块化加载工具,有朋友问为什么不用seajs,还问这两个优劣,其实前两年的项目用的都是seajs,此处想试试amd vs cmd,所以就用了require.js ,以目前的使用来看,相互可替代

Core[核心模块,主要是引入第三方必用、稳定模块]

     Base.js [自定义通用函数]

     Require.js

     Jquery.js

     Bootstrap.js

     Backgone.js

     Socket.io.js

     I18n.js

     

Public: [业务级公共模块]

     Validate.js [表单验证模块]

     All.js [所有页面需要执行的业务js,如登录验证]

     Zhdoc.js [国际化文本定义]

     Reset.css [样式初始化]

     common.css

     

Widget: [自定义组件]

     Dialog: [弹框组件]

          Dialog.js

          Dislog.css

          Imgs: [弹框组件图片]

     Calendar:[日志组件]

          Calendar.js

          Calendar.css

          Imgs: [日历组件图片]

     

Module: [业务模块]

     Issue: [静态模块]

          Index: [首页]

               Index.js

               Index.css

               Imgs:

          news: [新闻]

               news.js

               news.css

               imgs:

          

     User: [用户模块]

          Register: [注册]

               Register.js

               Register.css

               Imgs:

          findPwd: [找回密码]

               findPwd.js

               findPwd.css

               imgs:

          

Nodejs结构主要如下: express 框架

     App.js

     Package.json

     Node_modules:

     Routes:

          Index.js – 路由入口,接收所有请求做转发,并做权限过滤、404

          Issue.js – 接收来自index.js的静态请求

          User.js - 接收来自index.js的用户请求,页面请求render,数据请求转发

          

     Views: [使用ejs框架,接收来自 routes 里的页面请求]

          Common: [公用模块页]

               Header.ejs

               Footer.ejs

               

          Issue: [静态模块页]

               Index.ejs

               News.ejs

               

          User: [用户模块页]

               Register.ejs

               findPwd.ejs

               

          Controls: [业务逻辑模块]

               Config.js –公共配置模块,如hostIPbasePath等,切换环境修改此配置

               User.js - 接收来自 route/user.js的数据请求,向外转发做逻辑准备

               Tool.js - 封装常用函数如http.request/mailer/md5

               Redis.js - redis封装,对于单体封装内容比较多的模块,单独成立一个文件

               

          Log: [日志,采用Log4js,日志是必须的,页面开发者常欠缺日志理念]

         Assets: 结构、使用同 STATIC,不配置nginx时,调用此处资源,意义不大

         …

Nodejs + MySql: [模拟后台模块,相对上面的模块,主要多了DB]

     Db: [数据处理模块]

          Mysql.js – 封装模式化数据存储接口,提供最便捷的新增表、接口的方法

 

按此结构完成前端所有功能,因目前项目较小,部分模块还有细分空间。

 

 

四、分离结果如何

     1、开发效率更高,在联调之前,互不干扰,前端开发完成后就是实际可用的代码,不需要再转换成后台编译环境,永远不会被java / php 启动不成功所困扰。

     2、部分需要前后端共同开发的功能,如文件上传,通常需要页面端与接收端都进行相关的开发配置,之前较难定位是谁配置错误,现在全部由前端完成,开发、测试都容易定位,上传成功后,只要向java发送文件保存的路径即可。

     3、完全分清了前后端开发人员的职责,任一方开发完成后都可以提测,实现同步开发、测试。

     4、联调非常简单,若双方接口一致,正常情况下只要修改要接口请求IP即可完成切换。

     5、问题责任清晰,联调、测试、预发、上线,每个过程都难免会产生问题,前端、后端、运维三方责任边界清晰,日志中记录nodejs的请求发出,nginx请求接收与转发、java端请求接收与返回,三处任何一处断点,都能马上定位是哪方的问题。

     6、前端人员有更高的权限,页面端的展示几乎全由前端实现,但之前一些配置却受制于后台,比如常见的模板功能,纯html页面虽可以通过angularjs实现模板,但实际效果却并不理想,网速差时经常会出现include部分显示后置、甚至加载不成功的情况,nodejsejs框架可以很好的实现这个功能。

另外,据浏览器加载不同的css以便实现浏览器兼容,之前处理通常是页面加载后,通过js判断浏览器类型,再去加载不同的css文件,影响渲染效率,并且js判断浏览器类型本身就存在兼容问题,用nodejs则可以在render前就完成该判断,直接用相应的浏览器样式做渲染

     7、代码复用,验证模块,页面端与nodejs端可以直接复用

五、注意事项:

     1、前端开发人员不仅需要有扎实的nodejs知识,还要有一定的服务端、运维知识,对http通信有更深层次的理解,nginxredissocketbuffer等技术也要掌握,多多益善。

     2、开发之初对功能充分、宽裕的评估,使用初期不要用nodejs过多开发新功能。初次使用,难免会遇到很多意想不同的问题,前端开发人员本身对服务端知识有限,java人员又对nodejs语法不熟,若处理不好会导致项目延期。我原本认为redismemcached一样就是connect + set + get,但实际开发时遇到一些考虑不周而产生的怪异问题,延长该部分开发时间,最终导致项目delay

     3、前端开发人员可尝试用linux系统开发,第一版用win7开发时,npm部分模块的安装会不顺利,如node-canvaswin7上安装需要6步,而原本在32上已配置成功了,在64位上的系统上又不成功,后来该接口暂由java实现。实际上即使配置成功了,该模块在发布服务器的linux系统上也无法使用,需要重新安装。第二版开发时,我使用了ubuntu,虽然有一定的学习成本,但对后期的效率提升十分有益,多学习一种系统操作,和运维调试时也更加主动。不过ubuntu下没有找到做PSD切图的工具,所以安装双系统更合适切换使用。

 

六、总结:

     目前用分离方式做了两版项目,开发效率提升、协作沟通便捷上有明显优势,作为前端也学习了很多新知识、扩大影响范围,是共赢的。目前使用还较初级,要继续学习、探索。在此贴出以便和同仁共进步之。