前后端开发的心得体会_前后端对接的思考及总结
说在前面的话
随着前端NodeJs技术的火爆,现在的前端已经非以前传统意义上的前端了,各种前端框架(Vue、React、Angular......)井喷式发展,配合NodeJs服务端渲染引擎,目前前端能完成的工作不仅仅局限于CSS,JS等方面,很多系统的业务逻辑都可以放在前端来完成,例如我司的管控
那可能有些人会说,前端这么火,NodeJs发展这么迅猛,后端是不是以后都没事情干了,其实不然,拿Java来说,经过这么多年发展,已经相当稳定,完善的生态圈也非最近今年发展起来的NodeJs可比,我们常常说闻道有先后,术业有专攻,用在这里最合适不过了,集群、分布式、高可用等等技术还是需要后端架构师来思考的事情
目前前端同后端的合作方式是前后端分离,通过Nginx+Tomcat的组合部署(还可加nodejs中间件)方式能有效的进行解耦,并且前后端分离为项目以后的架构扩展、微服务化、组件化都打下重要基础,所以这在以后是一个发展的必然趋势,我们需要去适应,做出改变!!!
早期的开发方式
早期的开发方式如下图:
这也是我前面工作1-3年的开发方式,我们没有前端帮我们写JS函数功能,所有的页面表单验证,数据渲染,数据接口编写都是我们后端全部实现,看上去更像是一个全栈工程师,从需求分析、搭建整个技术架构、数据库表设计、功能设计、编码开发,再到最终部署上线,我们无所不在,这可能也是目前很多小公司仍然在沿用的开发方式,很多后端同学担负起了项目的方方面面
以我目前的经验来看,这样的开发方式对我个人的成长是有益无害的,因为你只有在了解了前端的JS/CSS/HTML的情况下,然后再谈目前的前后端分离,会让你的工作事半功倍,在写后端接口前,你脑子里浮现的是整个功能的交互页面,最终呈现的是前后端合作开发好后的的终端结果,这大大缩减了前后端的沟通交流
前后端分离的探索
jsonp
可能由于我在前面三年积累了丰富的前端经验,在上家公司主要负责开发官网、微信、后台等相关系统的接口,前期我们的开发方式虽然也是前后端分离的方式,但大都使用jsonp跨域接口调用的方式来达到分离效果,后端所有的接口都是可跨域调用的jsonp形式,抛开需要登录的授权之外的接口,前端在开发的时候本地无需开启服务即可调用服务端接口,然后渲染数据,完成页面交互渲染效果
jsonp的优点
不像XMLHttpRequest对象实现的Ajax请求那样受到同源策略的限制
兼容性更好,在更低版本的ie浏览器中都能兼容,这里区别于cors跨域类型
jsonp的原理其实很简单,当然,这也涉及到前端的知识,简单点说就是js端的function函数执行
正常的后端响应数据,例如:
{
"code":"8200",
"data":{
"id":"100",
"name":"Test"
//more......
}
}
jsonp需要的返回格式:
callback({
"code":"8200",
"data":{
"id":"100",
"name":"Test"
//more......
}
});
前端在页面定义callback回调函数,callback函数接收后端响应回来的data-json数据,后端响应后执行callback函数达到调用前端业务逻辑的目的,渲染页面
nginx+ajax
这种配合开发方式也是适合前端还没有引入Node等一站式开发解决方案的情况下引入的,纯粹的HTML+CSS+JS同后端对接,绑定业务接口,渲染数据
我们在使用JSONP开发的时候,前端都是需要在页面端写死HOST+IP接口地址,存在很重大一个弊端就是前端需要些config文件,来配置我们后端的接口请求地址,如果前端工程师规范意识强一点,会通用到一个配置文件里,但是如果没有这方面的意识的话,就会出现代码里硬编码的情况,不利于服务器迁移,代码更新,接口变动等操作
为规避上面碰到的问题,使用nginx的反向代理功能,将后端服务器代理下来,前端在开发的时候本地开启nginx服务,即解决了jsonp跨域问题,同时也解决了无需写死后端的服务ip+端口地址,利于后端在部署时整合代码,减少不必要的错误
node
随着NodeJs的火热,前端已经可以本地开启服务写接口的情况下,就类似服务端开启tomcat一样,在这样的情况下,前端框架VUE、React等都在此基础上,提供了一套完整的技术解决方案,这和上面说到的开启nginx服务架构有点类似
这样做的意义:真正的解放了前后端,专注各自擅长的领域
技术架构如下:
前端node服务直接访问后端Java Restful Api接口服务,Api接口最终访问数据库完成数据查询最终返回node层,node渲染响应数据到前端
如果存在会话信息同步等问题,可以使用中间件,例如redis缓存数据库,解决前端node和后端Api信息同步问题,传参可以通过JWT等方式完成接口权限验证
不管是jsonp还是ajax+nginx这两种方式,node作为中间件都可以轻松切换处理,而且node作为中间层,还可以将多个后端接口组合成一整个数据集,最终以同步的方式渲染前端,这也利于做SEO优化,也是前面两种方式无法做到的
关于前后端分离,详细可阅读,该文章详细的列述了关于前后端分离的实际经验
谈谈接口
随着前后端的分离,后端工程师不需要编写页面,不需要写JS,只需要提供接口即可,可是就是仅仅这一个接口,对于很多后端开发工程师而言,在实际开发,同前端对接的过程中,依然问题重重
很多后端同学说我只负责写接口,其他我一概不管,这样造成的后果就是
1、接口结构无序、杂乱无章
2、接口和实际业务场景不相匹配、不可用
3、频繁的同前端沟通,简单的事情复杂化,前后端都很恼火
4、事情没做好
后端在编写接口前,首先是对业务的理解,在对业务未理解透彻之前,编码都是无意义的,作为后端来说,需要锻炼自己对整个系统全局考虑的能力,接口之间并非是毫无关联的,我们在写第一个接口之间,其他接口之间的业务逻辑也许考虑到,这在后端团队合作开发不同功能的情况下显得尤为重要.
后端在开发接口时,我觉得主要从以下几个方面需要注意:
接口url 定义
接口类型、参数
全局错误码定义
接口json格式
接口文档编写
接口url定义
对于后端开发人员来说,接口前端入参,最终组合查询数据库资源,经过一系列相关业务场景下的计算,响应给前端json数据,每一层url的path定义需要清晰明了,这和后端在使用AOP定义事务管理同理,后端service需要满足一定的命名规范,这样方便统一管理,而且有这层规范后,后续的前后端对接会轻松很多
为了在许多API和长时间内提供一致的开发人员体验,API使用的所有名称应为:
简单
直觉
一致
这包括接口,资源,集合,方法和消息的名称。
由于许多开发人员不是英文母语人士,因此这些命名约定的目标之一是确保大多数开发人员能够轻松了解API。 它通过鼓励在命名方法和资源时使用简单,一致和小的词汇表来实现。
API中使用的名称应该是正确的美国英语。例如,许可证(而不是许可证),颜色(而不是颜色)。
可以简单地使用常用的简短形式或长字的缩写。例如,API优于应用程序编程接口。
尽可能使用直观,熟悉的术语。例如,当描述删除(和销毁)资源时,删除是优先于擦除。
对同一概念使用相同的名称或术语,包括跨API共享的概念。
避免名称重载。为不同的概念使用不同的名称。
仔细考虑使用可能与常用编程语言中的关键字冲突的名称。可以使用这些名称,但在API审查期间可能会触发额外的审查。谨慎和谨慎地使用它们。
接口类型、参数
关于接口的请求类型,目前比较常用的:GET、POST、PUT、DELETE、PATCH
GET(SELECT):从服务器取出资源(一项或多项)。
POST(CREATE):在服务器新建一个资源。
PUT(UPDATE):在服务器更新资源(客户端提供改变后的完整资源)。
PATCH(UPDATE):在服务器更新资源(客户端提供改变的属性)。
DELETE(DELETE):从服务器删除资源。
后端可根据不同的业务场景定义不同的接口类型
在定义接口参数之时,目前我们常用的几种提交方式
表单提交,application/x-www-form-urlencoded
表单提交主要针对key-value的提交形式
如下Java片段:
@PostMapping("/queryAll")
public RestfulMessage queryAll(RuleCheckLogs ruleCheckLogs, @RequestParam(value = "current_page",defaultValue = "1")Integer current_page
, @RequestParam(value = "page_size",defaultValue = "10")Integer page_size
, @RequestParam(value = "tableName",required = false) String tableName){
RestfulMessage restfulMessage=new RestfulMessage();
try{
assertArgumentNotEmpty(ruleCheckLogs.getProjectId(),"质检方案id不能为空"); restfulMessage.setData(qcRuleCheckLogsService.queryRuleLogsByPage(ruleCheckLogs,tableName,current_page,page_size));
}catch (Exception e){
restfulMessage=wrapperException(e);
}
return restfulMessage;
}
文件流提交
json提交,application/json
json提交方式在SpringMVC或Spring Boot中主要有两种,一种是以@RequestBody注解接收方式,另外一种是以HttpEntity requestEntity字节接收
Java代码示例:
@PostMapping("/mergeModelEntitys")
public RestfulMessage mergeModelEntitys(HttpEntity requestEntity){
RestfulMessage restfulMessage=new RestfulMessage();
try{
JsonObject paramsJson = paramJson(requestEntity);
assertJsonNotEmpty(paramsJson,"请求参数不能为空");
//more...
}catch (Exception e){
restfulMessage=wrapperException(e);
}
return restfulMessage;
}
全局错误码定义
错误码的定义同HTTP请求状态码一样,对接者能通过系统定义的错误码,快速了解接口返回错误信息,方便排查错误原因
{
"code": "8200",
"message": "Success",
"data": {
"total_page": 1,
"current_page": 1,
"page_size": 10,
"count": 5,
"data": [
{
"id": "a29ab07f1d374c22a72e884d4e822b29",
//......
}//....
]
}
}
接口json格式
后端响应json给前端需要注意以下几点:
1、json格式需固定
例如如下图形
如上图所示,横向是时间,纵向是value值
我们给出的json结构应该如此:
[
{
"date":"2018-01",
"value":100
},
{
"date":"2018-02",
"value":200
}
//more...
]
在工作中,我们经常碰见这样的数据格式:
[
"2018-01":{
value:100
},
"2018-02":{
value:200
}
//more...
]
这里所说的json格式固定主要针对此种情况,后端给到前端的接口格式必须是固定的,所有动态数据值都需相应的key与之对应
2、所有返回接口数据需直接可用,越简单越好
后端提供给前端的接口数据,最终交给前端的工作,只需要让前端渲染数据即可,越简单越好,不因掺杂过多的业务逻辑让前端处理,所有复杂的业务逻辑,能合并规避掉的都需后端处理掉.
接口文档编写
接口文档编写是前后端对接重要依据,后端写明接口文档,前端根据接口文档对接
文档形势目前主要分几种:
1、依赖swagger框架,自动生成接口文档(swagger只能生成基于key-value详细参数方式,针对json格式,无法说明具体请求内容)
2、手动编写说明文档,推荐markdown编写
接口对接
万事俱备,只欠东风,虽然上面我们准备了所有我们该准备的,接口定义完美无缺,接口文档也已说明,但在对接时任然可能出现问题,此时我想我们还需注意的细节
1、后端接口需自行进行Junit单元测试
Spring目前集成Junit框架可方便进行单元测试,包括对业务bean的方法测试,以及针对api的mock测试
@RunWith(SpringRunner.class)
@SpringBootTest
public class QcWebApplicationTests {
@Autowired
private WebApplicationContext context;
private MockMvc mvc;
@Autowired
QcFieldService qcFieldService;
@Before
public void setUp() throws Exception {
//初始化mock对象
mvc = MockMvcBuilders.webAppContextSetup(context).build();
}
@Test
public void queryByDsId(){
try {
//针对mock-接口Controller层测试
mvc.perform(MockMvcRequestBuilders.post("/qc/entity/queryByDsId")
.contentType(MediaType.APPLICATION_JSON_UTF8)
.param("dsId", "7d4c101498c742368ef7232f492b95bc")
.accept(MediaType.APPLICATION_JSON))
.andExpect(MockMvcResultMatchers.status().isOk())
.andDo(MockMvcResultHandlers.print());
} catch (Exception e) {
e.printStackTrace();
}
}
@Test
public void testUpdateField(){
QcField qcField=new QcField();
qcField.setId("513ee55f5dc2498cb69b14b558bc73e6");
qcField.setShortName("密码");
//业务bean-service方法测试
qcFieldService.updateBatchFields(Lists.newArrayList(qcField));
}
2、使用工具测试,推荐PostMan
作为接口调试神器,Postman大名想必大家都已知道
作为后端来说,我们需要学会查看chrome推荐给我们的审查元素的功能,可参看
chrome提供了一个可以copy当前接口的url功能,最终生成curl命令行
最终通过Copy as cURL(bash)功能可生成curl命令
curl 'http://demo.com/qc/ds/getAll' -H 'Origin: http://demo.com' -H 'Accept-Encoding: gzip, deflate' -H 'Accept-Language: zh-CN,zh;q=0.9' -H 'User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/65.0.3325.181 Safari/537.36' -H 'Content-Type: application/x-www-form-urlencoded' -H 'Accept: application/json, text/plain, */*' -H 'Referer: http://demo.com/index.html' -H 'Connection: keep-alive' --data 'current_page=1&page_size=6&' --compressed
以上命令可以在Linux等各终端直接执行
curl命令是一个利用URL规则在命令行下工作的文件传输工具。它支持文件的上传和下载,所以是综合传输工具,但按传统,习惯称curl为下载工具。作为一款强力工具,curl支持包括HTTP、HTTPS、等众多协议,还支持POST、cookies、认证、从指定偏移处下载部分文件、用户代理字符串、限速、文件大小、进度条等特征。做网页处理流程和数据检索自动化,curl可以祝一臂之力。
postman提供导入curl命令行
3、前后端需心平气和沟通,勿推卸责任,前后端开发人员水平不尽相同,作为同事,需要的是团结合作,努力将事情做好,而非相互推卸
结语
前后端分离,简化了我们的开发方式,不同人专注于不同的领域,技术价值最大化,大大提高工作效率,我们在掌握这些技能的同时,也需要加强自身的发展,以适应当前的技术发展趋势,不管是前端还是后端,多了解一些,总是没错的,古人云:技多不压身,我想也正是此理!!!
前后端开发的心得体会_前后端对接的思考及总结相关推荐
- 前后端开发的心得体会_从后端支撑岗位到前端渠道运营中心工作感想
1 8 月份,渠道攻坚战打响,做为电信的生力军,我奋不顾身 的冲在最前面,为电信生存而战,力求打赢这场战役. 从后端支撑岗位到前端渠道运营中心这一新的部门, 开展了 夜场促销活动, 设计炒店主题及手写 ...
- 前后端开发的心得体会_社招后端三面总结以及学习经验感言(操详细)
简单介绍下背景:本人已工作两年,这次属于社招,不是校招哦!投递的岗位base是北京. 先上正文 一面内容大概:先来道算法题,不难:链表表示的两个数相加.面试官说不用运行,大概写一下就行,说是因为说牛客 ...
- 软件开发实训需要用到的算法和结构_软件开发实习心得体会
软件开发实习心得体会 [篇一:软件工程实训心得体会] 软件工程实训心得体会 软件工程实训心得体会一:软件工程实训心得体会 这次软件工程实训是从 2010.12.26 号开始的,截至 2010.12.3 ...
- 开发医院管理系统心得体会_如何开发医院内容管理系统
开发医院管理系统心得体会 入门 对于医院来说,在其在线站点上提供出色的患者和医师体验非常重要. 如果您为医师提供有用的在线工具,则医师很有可能会将患者转介至您的医院. 患者也是如此. 如果您通过向他们 ...
- 员工培训与开发实训心得体会_企业实训心得体会.doc
企业实训心得体会 企业实训心得体会 公司实习心得体会 王依依 文化,是企业的灵魂,是一个企业能够傲立商海的根本所在.培训了文化的浇灌,企业便像无源之水,是无法长久的.中国的海尔集团.邯郸钢铁公司.美国 ...
- 员工培训与开发实训心得体会_公司新员工培训心得体会800字范文
点击蓝字关注我们 培训是一次能够快速提升我们的机会,而每个新员工也是通过培训尽快的融入公司的.因此,我们要更加重视培训一些!下面是小编为大家整理的公司新员工培训心得体会,希望对大家有帮助. 公司新员工 ...
- 做python的心得体会_实训python的心得体会
如何学习Python的一些总结 C++.Java乃至C#都可以看做是同一类型的语言:C++还算灵活,但纷繁复杂的语法使得生产效率低下,Java提高了生产效率,却损失了灵活性;C#算是在生产效率和灵活性 ...
- 计算机信息化教学培训心得体会,信息化教学培训心得体会_信息化教育学习收获范文...
培训不仅仅为我们提供了很好的学习信息化教学能力的机会,也为我们提供了与同行交流讨论的机会.下面是学习啦带来的信息化教学培训的心得体会,仅供参考. 信息化教学培训心得体会一 今年的暑假很特别,因为这是我 ...
- 学习java的心得体会_学习java的心得体会范文.doc
学习java的心得体会范文 篇一:JAVA学习的心得体会 ? 国家队每一次踢球失败后都要说这么一句:我们回去后要好好总结,下次会打得更好! ? 总结不代表就能改过原有的不足,也不代表就能进步了 ? ( ...
最新文章
- 简单介绍python3判断IP地址的方法
- 余承东和张小龙背后的故事:成年人,请远离线性努力
- 在大数据时代,我们需要数据售货员
- devc++鼠标变成了光标_游戏鼠标到底能不能提升你的实力?
- 利用PHP执行SQL文件,将SQL文件导入到数据库
- golang goroutine实现_golang中的Mutex设计原理详解(一)
- web mis系统构建
- SpringBoot和hadoop组件Hive的集成
- Python之判断闰年
- 开源项目——小Q聊天机器人V1.0
- 离散数学-数理逻辑基本概念
- 操作系统:基本磁盘和动态磁盘
- python链家数据分析统计服_链家二手房成交——Python数据分析
- php微擎Goto2C解密研究
- C语言 酒店房间登记与计费管理系统
- Spring Cloud Alibaba系列使用(二)----Nacos注册中心
- 织梦手机站生成html,织梦手机端静态页面生成教程
- 2021年中式烹调师(中级)报名考试及中式烹调师(中级)考试总结
- 1237:求排列的逆序数
- oracle sqlloader 的简单使用
热门文章
- python爬虫实验总结_python3爬虫总结(共4篇).docx
- csr867x入门之iis使用(八)
- zzuli 2126 tmk买礼物 思维题
- 翟天临的噩梦:怎样用Python检测抄袭行为?
- OpenHarmony HDF Input框架模块 按键控制LED基于小熊派micro
- 看似美好,实则无奈,水果业上限如此?
- 【华为OD机试真题 python】水仙花素 【2022 Q4 | 100分】
- 旅行社旅游APP开发维护经验
- 菜鸟最爱,60行代码打造一款音乐播放器!
- 每年都有几个研究生,被“爸爸”逼得跳楼