Jack.Cheng 发表于 2022-6-30 17:01:38

调用HTTP接口(by 活字格)

本帖最后由 Jack.Cheng 于 2022-6-30 17:01 编辑

一般来讲,后端对外提供的Web Service多以RESTful的HTTP API形式呈现,传统代码开发过程中,调用HTTP接口有这么几种场景:
前端页面以JS代码编写,使用ajax方式异步调用;
如果是爬虫代码,用http请求库调用;
如果用unix-like系统,比如Linux或者Mac OS,那么可以用cURL工具在terminal中进行调用;
如果对数据库用的深入,存储过程或者触发器里面,可以用SQL向Web Service发起请求;

那么,活字格里面调用外部HTTP API,使用起来有哪些需要留意的点呢?本文就说下自己的一些感受吧!

1、调用HTTP API的时序图


时序图是UML的一种图示,关于具体的规范和画法,可以百度找一找,网络资源很多。
如果希望对UML有一个比较直观的了解,可以看看这个文章(https://mp.weixin.qq.com/s/EBqtDjx-OZamaJ284VvbSA),讲的还不错。
图示里面,后端是“一坨儿”,属于传统的单体架构、巨石系统(Monolithic Application)。现在互联网应用一般采用微服务居多,后端通过多个微小服务,组合起来,对外提供服务。后端服务直接还存在互相调用。

此图中没有体现出来。关于微服务相关内容,大家可以自行了解下。

2、HTTP请求方法
HTTP请求共8种方法,分别是GET POST HEAD OPTIONS PUT DELETE TRACE CONNECT,每种方法有其特定的语义,具体可以看看这个blog(https://blog.csdn.net/m0_48729489/article/details/122869464)。最常用的是GET和POST。

HTTP请求除了请求方法外,还会携带接口需要的其他信息,可以以URL参数或者请求体方式传递到后端接口。
简单理解,URL参数就是URL里面?后面携带的内容

用&分割,参数以key-value形式书写。
请求体直接看不到,一般以Json形式描述。如果你打开浏览器调试工具,可以看到那些内容


Excel里面,拼接字符串用&。因为活字格对EXCEL优秀功能支持度很高,依然可以这么用来构造URL,举个例子
="https://qyapi.weixin.qq.com/cgi-bin/appchat/create?access_token="&AccessToken

请求体的话,活字格因为有一个发送HTTP请求插件,可以在这个插件里面进行可视化设置

该插件的详细介绍里面,有个公开课,可以针对性学习
https://marketplace.grapecity.com.cn/ApplicationDetails?productID=SP2104270003&productDetailID=D2205200024&tabName=Tabs_detail


3、序列化与反序列化
JSON和对象是两个不同的东西。
JSON是一种数据交换格式,有一套自己的描述规范和体系。目前前后端之间交互数据多用JSON这种格式。

对象是一种内存中的结构,有数据,有行为。
如果我们把一个对象变成JSON,叫做序列化;如果把JSON变成对象,叫做反序列化。

活字格中进行这两个操作,需要一个JSON序列化/反序列化命令插件(https://marketplace.grapecity.co ... tabName=Tabs_detail)

4、业务操作
服务端命令里面可以进行非常复杂的业务操作,而且还很灵活。比如把调用的HTTP接口,一般他们返回的数据格式就是json分,那么我们对返回的json进行反序列化拿到列表,循环列表,经过可能的数据处理,最后逐行写入数据库。
处理末尾,返回前端需要的数据就是一种常见的业务逻辑操作。

之前有格友问到,返回命令要不要装插件?

其实这是设计器自带的功能,可以看看这个(https://help.grapecity.com.cn/pages/viewpage.action?pageId=56530608)






页: [1]
查看完整版本: 调用HTTP接口(by 活字格)