下载bootstrap怎么引用
launchcsm是什么意思?
作为BAT的Java开发工程师,来分享下我在公司里写的项目(脱敏)中的封装api接口部分。
我们使用的是SSM框架,但是这里其实不论是SSM还是SSH,抑或是SPRING BOOT,接下来的介绍都是通用的,因为主要是通过介绍注解(annotation),而不是xml文件。
Controller.Class
首先,API接口需要出现在controller层,因此,在类名上方,需要至少两个注解,@controller,用于在项目启动的时候告诉spring,这个类是controller层的,需要加载好;@requestMapping,这个注解相当于指明了api的url中的一部分。
如果一个服务绑定的域名是
,然后requestMapping中的内容意味着,url为/.... 格式的请求,会被转发到当前这个类中。Controller.function
看完接下来我们看函数部分,这里首先也要加一个responseBody注解,这个注解的含义是将controller层中,函数的返回对象通过转换器,转换为指定的格式,写入到http response返回对象的body中去,也就是说下面这个函数返回的String,直接作为response的body内容返回给了用户。
接下来,依旧是requestMapping注解,相信大家也能了解了,复用上面的例子,当url为
的时候,相当于调用了这个validateParams函数,并且这个请求request的body就会作为body参数,一并传入这个函数。这里大家可以能注意到了,上面的函数的参数名中用的是requestBody,而下面用的是formParam,虽然二者都是post请求,但是参数接收方式却不一样。这就意味着,代码里指定了不同的接收方式,request的body里也必须用对应的方式才能将数据传递给函数。上图中body用raw形势的就可以,而下图则要求用application/x-www-form-urlencoded格式的body。
最后,上面介绍的都是post请求的api,下图介绍了GET请求的api如何写。可以看出,注解方面,requestMapping里指定requestMethod为GET即可。在函数的参数方面,需要用requestParma注解来接收,如下图。当你发送
/dispatch/getMyContract?username=xiaomin&password=123 这个请求的时候,就相当于调用了下面的getMyContract函数,并且传入的username参数为xiaomin,password参数为123.以上是我的浅见,欢迎各位在下方评论区交流点赞。
我是苏苏思量,来自BAT的Java开发工程师,每日分享科技类见闻,欢迎关注我,与我共同进步。
如何在OSC社区运营你的开源项目?
API的全称是应用程序接口(API:Application Program Interface)。
它是一组定义、程序及协议的集合,通过 API 接口实现计算机软件之间的相互通信。API 的一个主要功能是提供通用功能集。程序员通过调用 API 函数对应用程序进行开发,可以减轻编程任务。 API 同时也是一种中间件,为各种不同平台提供数据共享。
最常见也是最简单的设计一个api接口的方式就是通过一个网址url来实现,也就是我们常说的通过http请求来访问接口。
api接口可以很复杂,也可以很简单,这个主要看项目需求和设计需求。
首先,通过代码返回json字符串就是最简单的接口实现。
然后,我们可能需要加上一些请求认证,比如授权等。
其次,我们可能需要一些限流,一些熔断处理,当接口被大量请求的时候,需要做一些判断处理。
最后,完善接口文档,一个好的api接口,接口文档一定是完整的且高效的。
从何开始
前面说了那么多的理论和过程,但是真正如何去实现,还是需要看代码才能弄明白的,你可以去github上搜索 `编程语言+api` 就可以找到相关的实现例子,通过那些例子,你就可以在那些基础上进行修改,然后最后实现自己的需求。
很多时候,当我们不知道如何开始的时候,看别人的代码是最好的方式,学习都是通过模仿开始的,当我们模仿得差不多了,对逻辑有了深刻的理解之后,就是我们开始写自己的代码的时候,也就是开始创新的时候。