本文主要記錄搭建RESTful API标準工程，包含比較推薦的工程結構，掌握一些基本注解，并引入Swagger
建立一個項目
通過Spring Initializr建立工程，選擇所需要的jar包，如下圖：
工程結構
Spring Boot架構對工程結構并沒有什麼特殊的限制，我這邊基本按照網上主流和自己一些喜好進行劃分，供參考：
代碼層結構
前端控制器(Controller): com.xxx.controller
資料服務層(Service): com.xxx.service
實體(Entity)與資料通路層(Repository):com.xxx.domain
公共方法及工具類: com.xxx.common
資源檔案的結構
配置檔案: src/main/resources/config
靜态檔案: src/main/resources/static
模闆: src/main/resources/templates
編寫第一個服務
在controller下建立類HelloController，相關代碼做了簡單的注釋，如下:
//相當于 @Controller + @ResponseBody
//該注解 方法method 傳回類型是String時候則傳回string,傳回對象時候則講json_encode 該對象的json字元串
@RestController
public class HelloController {
//該注解mapping指定路由
@RequestMapping(value = "/hello",method = RequestMethod.GET)
public String SayHello() {
return "Hello Spring Boot";
}
}
編寫到這裡，已經可以直接編譯運作了，這裡值得注意的是被@SpringBootApplication注解的啟動類一定要放在所有的RestController的根路徑的package下，@SpringBootApplication隻會掃描@SpringBootApplication注解标記類包下及其子包的類，如果不放在根路徑下，可以指定下：@SpringBootApplication(scanBasePackages = "com.example.api_demo")
無需配置Tomcat，直接啟動，輸入對應的位址可看到結果：
增加service層
在搭建了基礎應用的基礎上，我們增加service層抽離控制層和業務層代碼。
在service下新增HelloService和HelloServiceImpl兩個類，代碼如下：
//業務層接口：HelloService
public interface HelloService {
public String sayHello();
}
//接口實作：HelloServiceImpl
@Service
public class HelloServiceImpl implements HelloService{
@Override
public String sayHello()
{
return "Hello Spring Boot";
}
}
修改對應的controller代碼：
@Autowired
private HelloService helloService;
@RequestMapping(value = "/hello",method = RequestMethod.GET)
public String sayHello()
{
return helloService.sayHello();
}
這樣，簡單的拆分就完成了。
引入Swagger
Swagger是什麼大家自行百度，對于Restful API來說，Swagger絕對是它的好基友。
首先引入對應的jar包，在pom.xml加入：
io.springfox
springfox-swagger2
2.7.0
io.springfox
springfox-swagger-ui
2.7.0
新增類Swagger2.java,代碼如下：
@Configuration
@EnableSwagger2
public class Swagger2 {
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.example.api_demo.controller"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("測試文檔")
.description("這裡是一段描述")
.termsOfServiceUrl("http://www.bug2048.com/")
.version("1.0")
.build();
}
}
到這裡，Swagger就算配置完成了，接下來就是要添加文檔内容了，修改之前的HelloController之後，直接編譯運作，通過/swagger-ui.html就能看到效果
@ApiOperation(value="增加Service層輸出Hello", notes="這是第二個demo")
@RequestMapping(value = "/hello",method = RequestMethod.GET)
public String sayHello()
{
return helloService.sayHello();
}
至此，簡單的架構算是完成了，後面就可以逐漸完善，包括接入日志，資料庫等等，後面會持續更新。
總結
基于Spring Boot建構RESTful API相對來說還是比較便捷的，其中注解使得代碼更加簡潔，本次用到注解再彙總下，有時間的話可以深入了解下其背後的原理：
@SpringBootApplication: 申明讓spring boot自動給程式進行必要的配置。
@RestController:REST風格的控制器
@RequestMapping:提供路由資訊，負責URL到Controller中的具體函數的映射
@Service:一般用于修飾service層的元件
@Autowired: 自動導入依賴的bean