openapi and light-4j

2022-10-27,

light-4j项目支持openapi规范,本文介绍一下参照相关demo做的上传功能。

openapi.yaml,按照规范编写内容,/openapi/swagger可以查看对应的swagger页面,Authorize可以使用README.en.md里面的Bearer token
handler.yml,路由/openapi/*给OpenapiHandler处理,OpenapiEndpointSource路由所有http方法

MyJwtVerifyHandler,浏览器遇到非简单请求时会额外发送OPTIONS请求,并且不会携带请求头Authorization,因此security略过此类请求。
UploadHandler,上传功能比较简单,openapi接口都需要jwt鉴权,更细致的权限管理还有待研究。

LayuiHandler,支持常用的验证码、登录、找回密码等功能
验证码:/service/layui/captcha?v={sid},使用v参数标识身份,demo里面取的是当前时间戳
登录:/service/layui/login?v=&vercode=&username=&password=,使用v+vercode校验验证码,验证通过并登录成功时返回access_token
找回密码:/service/layui/sms?v=&vercode=&mobile=,检查验证码,通过后发送手机验证码
admin,前端页面demo,会自动跳至登录页面
login.html,登录页面自动获取验证码,登录成功后使用$.ajaxSetup配置后续http请求携带Authorization请求头
访问:组件=》上传=》功能页面一,第一个上传按钮可以正常上传,上传后点击图片可打开链接

openapi and light-4j的相关教程结束。

《openapi and light-4j.doc》

下载本文的Word格式文档,以方便收藏与打印。