首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

Oracle 19c给我的启示:RESTful API

这是学习笔记的第 2113 篇文章

最近Oracle发布了19c,而且随着Openworld的到来,官网也提前做了更新,打开Oracle官网,让我一脸懵逼,鼠标不知道该往哪儿点。

整个页面是这样的风格,也没有了原本的导航等。

认真看了下标题介绍,那我就选择一个和我贴近的吧,就点击了Infrastructure,按照这个定义,现在已然是2.0时代了。

不过随着这些链接点进去,看到了一系列的关于自治数据库的介绍和说明,其实我是想找一下19c的软件下载目录,看看最新版有哪些更新,尝尝鲜。

还好,总算找到了这个导航入口,想了想也是,毕竟和云比起来,软件下载安装的优先级确实没有那么高了。

看到这个界面,让我开始有一些踏实。

19c带给了哪些新鲜的特性呢,首先吸引到我的就是关于API的部分,当然你如果看到Books的推荐足够仔细,会发现第一个文档是Java开发者的。

所以我们接下来不讲关于19c的数据库功能相关的特性,而是着重在API方向上。

潜台词就是,19c已经大踏步开始在开发方向铺展开来了,如果我们还在传统运维上面,拉开的差距就实在太大了。

在开始之前,我们可以试想一下:假设你是Oracle的首席应用架构师,让你来设计相关的API体系,你该如何设计?

带着这个问题来纵览整个API的设计,会发现这样一个体系设计,有基础的数据字典部分,环境部署和查看,补丁和升级,通用功能(比如查看表空间,段,datapump任务等),监控(会话监控,锁监控等),性能(SQL性能),PDB的生命周期管理(创建,修改,删除PDB等)。

比如数据字典的部分,我们选择表相关的API,右侧的部分是集成了swagger,

对于参数的输入输出都有详细的定义,包括整个API的整体逻辑(这里可以看到是从dba_tables里面提取数据)。

到了这里我们其实会发现没有想象的复杂,因为这些基础信息我们基本都掌握了,所以API开发对于熟悉系统,业务层面的同学来说就是纸老虎。

可以想象很多同学希望做自动化相关的工作,势必会用到运维开发层面的API,而在以往我们需要自己封装API服务。

而现在是一站式打包服务。

整个API的设计主要是基于如下的方法,相比于标准的REST方法,多了PATCH方法,其他的增删改查分别对应(POST,DELETE,PUT,GET)

如下是API相关的返回编码。

一种很不规范的方式就是API设计中要么没有返回码,要不无论对错返回码都为200.

至于API的调用,这里给出的例子是基于cURL,如果需要调用,基本可以实现命令行级别的调用模式。

curl -v -i -H "Content-Type: application/json" http://xxxxx.com/database/objects/tables/,

当然这里还是推荐使用Postman这样的工具来进行调试,更加方便快捷。

这个体系设计整体是很不错的,很清晰,而且还提供了基于JSON的swagger配置文件,感兴趣的同学可以做下对接调试。

  • 发表于:
  • 原文链接https://kuaibao.qq.com/s/20190927A0531200?refer=cp_1026
  • 腾讯「腾讯云开发者社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 cloudcommunity@tencent.com 删除。

扫码

添加站长 进交流群

领取专属 10元无门槛券

私享最新 技术干货

扫码加入开发者社群
领券