h1,h2{display:block} .space4{display: inline-block;width:20px;} .space8{width:40px;display: inline-block;} .space16{width: 60px;display: inline-block;}
http://www.upopen.cn/article/info?id=559239adb269230039000001
前后端分离项目实践
一、前言 对nodejs有了些准备,希望多了解些后端知识,恰逢公司项目调整,分析了前后端分离的优劣,也做了一个完整的demo演示,同事都觉得靠谱,用了两个版本的时间,将公司主站项目用nodejs实现了前后端分离,在此和大家分享下,以求共同进步。
二、为何做分离 1、开发体系:架构体系决定了后端重于前端,前端做好静态页后,要转为php或vm等,开发要用eclipce等后端环境工作,一大堆让前端迷糊的配置,一旦java人员更新了错误的文件,会导致所有人的环境启动不了,束手无策,只能等待救援。 2、难维护:页面总是会有php/jsp等非前端代码,相互干扰、无法优化,时间越久问题越突出。 3、前后端职责不清晰。 有人会问,分离为什么不全部走ajax,页面就不需要任何服务端语言了。但实际场景并非如此,首先有些数据总是要生成页面时就已经同步获取的,且全异步对SEO不利、纯html页面没有include功能等。 网上还有其它的理解,大致相同就不列举了。
三、如何做分离 1、产品设计确定后,前后端人员共同制定开发接口,为方便接口的制定、显示、测试,使用nodejs+mongodb开发了接口平台。参见 http://www.upopen.cn:8090/interface/index。 功能:制定接口时就直接在interface平台上新增录入ActionName、description、 method、 param 及 默认值 等并保存到mongodb,当后台开发完成后,直接用在该页面做接口测试,成功后方可交付,避免联调过程中的接口反复。(原本想用interface.upopen.cn 来测试同域名下的项目,但因cookie在不同二级域名下无法共享的问题,暂用了二级目录,不过已有方案,后续优化)
2、从前端角度考虑系统架构图如下:
A、 访问入口 NGINX 代理静态资源到 STATIC 服务器,其它请求则到 NODEJS。 B、 页面请求NODEJS直接render,数据相关NODEJS则做预处理,再发到后台 C、 前端据已定义的接口,通过nodejs+mysql模拟后台完成数据存取,此处会增加些工作量,但只是为了走通业务流程,模拟后台数据表定义及逻辑无需严谨,只要能正常存取即可,如注册用户save to DB,登录验证read from DB,所以提供模式化的工具、写法后,新增表、接口,并不会多耗时间,nginx – nodejs – 模拟后台,即可按实际使用完成所有前端工作。 D、 QA单独测前端时,修改hostIP指向到测试工具。 E、 Java开发完成后接口,在 Interface平台 上验证所有接口,确认无误。QA也可以通过Interface测试Java接口 F、 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 –公共配置模块,如hostIP、basePath等,切换环境修改此配置 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部分显示后置、甚至加载不成功的情况,nodejs的ejs框架可以很好的实现这个功能。 另外,据浏览器加载不同的css以便实现浏览器兼容,之前处理通常是页面加载后,通过js判断浏览器类型,再去加载不同的css文件,影响渲染效率,并且js判断浏览器类型本身就存在兼容问题,用nodejs则可以在render前就完成该判断,直接用相应的浏览器样式做渲染 7、代码复用,验证模块,页面端与nodejs端可以直接复用
五、注意事项: 1、前端开发人员不仅需要有扎实的nodejs知识,还要有一定的服务端、运维知识,对http通信有更深层次的理解,nginx、redis、socket、buffer等技术也要掌握,多多益善。 2、开发之初对功能充分、宽裕的评估,使用初期不要用nodejs过多开发新功能。初次使用,难免会遇到很多意想不同的问题,前端开发人员本身对服务端知识有限,java人员又对nodejs语法不熟,若处理不好会导致项目延期。我原本认为redis同memcached一样就是connect + set + get,但实际开发时遇到一些考虑不周而产生的怪异问题,延长该部分开发时间,最终导致项目delay。 3、前端开发人员可尝试用linux系统开发,第一版用win7开发时,npm部分模块的安装会不顺利,如node-canvas在win7上安装需要6步,而原本在32上已配置成功了,在64位上的系统上又不成功,后来该接口暂由java实现。实际上即使配置成功了,该模块在发布服务器的linux系统上也无法使用,需要重新安装。第二版开发时,我使用了ubuntu,虽然有一定的学习成本,但对后期的效率提升十分有益,多学习一种系统操作,和运维调试时也更加主动。不过ubuntu下没有找到做PSD切图的工具,所以安装双系统更合适切换使用。 br /> 六、总结: 目前用分离方式做了两版项目,开发效率提升、协作沟通便捷上有明显优势,作为前端也学习了很多新知识、扩大影响范围,是共赢的。目前使用还较初级,要继续学习、探索。在此贴出以便和同仁共进步之。
扫码关注w3ctech微信公众号