上篇文章我们讲了查看设备详细信息的接口。这篇文章我们来讲讲一般的查询接口怎么写。我们就以最简单的查询为例子,来讲讲怎么写查询接口。
这是写IT设备查询接口的要求:
首先要知道的是,你写任何接口都是针对某张表来进行操作的。就像这个接口,针对的就是IT设备信息表来,我们希望通过IT设备信息表的某几个字段作为查询条件,把符合查询条件的行记录都查出来。比如说我想查询组织机构(orgId)==35的行记录,当你传入orgId=35的时候,我希望把这张表中关于orgId=35的所有行记录全部返回出来。
明确好这个接口的目的之后,就可以开始写了。首先先写controller层,controller层要写的无非就是传入的参数以及返回VO。传入的参数图片中已经圈出来了,就那几个字段,而返回参数就是这张表的所有字段。
那就开始写呗!但是肯定不是我自己写,我找AI帮我写,我把我想要写的东西描述清楚给AI,AI帮我写,写完之后controller层就写好了,长这样:
之后写service层。这个接口的service层很简单,没有任何业务逻辑,所以不怎么需要写,service层长这样:
最后进入mapper层,写sql语句。我们先来捋清楚我们想要写的这条sql语句,这条sql语句可以通过这张表的某几个字段(就是上图那个条件查询的那几个字段),把整张表的所有字段查询出来,就这么简单,甚至都不用关联其他表。接下来要干什么?对,就是把你的想法告诉AI,AI帮你写这条sql。写完后如果没有报错的话,mapper层就完成了。
接着用postman测试一下,如果测试没有问题的话,这个查询接口就算写完了。
这就是最简单的查询接口,基本上其他复杂的查询接口都和这个接口很类似,无非就是service层的逻辑多了一点,mapper层的sql语句复杂一点,仅此而已,除此之外,大差不差。