api-result
,是对API接口返回结果规范处理的一个解决方案,是在实际应用环境下产生了,并不断更新和完善,
当然这只是我个人提出的解决方案。不足之处,还请多多指正。
因为这个jar目前没有提交到中央仓库,所以,你需要指定一下仓库的位置
我们在 pom.xml
文件中添加如下配置:
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
然后,我们就可以引入包了:
<dependencies>
<!-- 添加 Api Result 支持 -->
<dependency>
<groupId>com.github.iutil</groupId>
<artifactId>api-result</artifactId>
<version>1.0.0.BUILD</version>
</dependency>
</dependencies>
完整版如下(基于Spring Boot 2.1.3.RELEASE搭建):
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.3.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.fengwenyi</groupId>
<artifactId>javalib-result-demo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>javalib-result-demo</name>
<description>Demo project for Spring Boot</description>
<properties>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<!-- 添加 JavaLib-result 支持 -->
<dependency>
<groupId>com.github.fengwenyi</groupId>
<artifactId>JavaLib-result</artifactId>
<version>V1.1.0.Beta</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
</project>
让 Maven 去仓库拉取文件,拉取完毕,如果不报错,就说明依赖成功,就可以正常使用了。
我们来写一个例子:
首先在启动类(xxxApplication)上添加注解: @RestController
指明,这个类中的方法将字符串返回给页面。
然后,我们写一个测试的方法:
@RequestMapping("/hello")
public Result hello() {
return Result.success("Hello");
}
测试:访问页面 http://localhost:8080/hello
返回:
{
"code": 0,
"msg": "Success",
"data": "Hello"
}
到此就算成功了。更多用法,请参考测试代码。