集成swagger,进行接口管理和测试

1.传输格式

传输格式均为JSON字符串,使用spring mvc返回对象,并自动通过fasterxml jackson工具类(JsonMapper.java, AjaxJson, PrintJSON)进行对象到JSON转换。 输出格式符合JSON标准,UTF-8编码。

2.账号登录

http://localhost:8080/jeeplus/a/login?__ajax

POST参数:

参数名 是否必须 类型 说明
username string 用户名
password string 密 码
mobileLogin boolean 必须true

返回结果

登录成功

{"success":true,"errorCode":"-1"," msg":"登录成功!","body":{"username":"admin","name":"admin","mobileLogin":true,"JSESSIONID":"23a38fb96d374d3ebb20b8bc84b54536"}}

登录失败

{"success":false,"errorCode":"-1","msg":"用户或密码错误, 请重试.","body":{"username":"admin1","name":"","mobileLogin":true,"JSESSIONID":""}}

3.账号退出

http://127.0.0.1:8080/jeeplus/a/logout

4.请求数据

请求rest 接口,有2种,一种需要登录才能访问。

4.1登录访问

先调用登录接口,获取会话ID。 在请求路径后包含会话ID(JSESSIONID一定要大写)即可,格式如下: URL = “请求URL” + “;JSESSIONID=”+ “会话ID” 例子: http://localhost:8080/jeeplus/a/sys/user/infoData;JSESSIONID=21a65e45a78f415c9c21f9376df9c1d3?__ajax=true&mobileLogin=true

4.2不登录访问

如果该接口不需要登录就可以访问: 在src/main/resources/spring/spring-context-shiro.xml文件中去除权限过滤。 例如 :${adminPath}/sys/user/infoCareStatus = anon。