RESTful定义
REST这个词,是Roy Thomas Fielding在他2000年的博士论文中提出的。Fielding将他对互联网软件的架构原则,定名为REST,即Representational State Transfer的缩写,翻译为”表现层状态转化”。如果一个架构符合REST原则,就称它为RESTful架构。
根据阮一峰博客 中对Fielding论文定义中的总结,满足如下条件即可认为是RESTful架构:
每一个URI代表一种资源;
客户端和服务器之间,传递这种资源的某种表现层;
客户端通过四个HTTP动词,对服务器端资源进行操作,实现”表现层状态转化”。
Spring Boot
创建一个Maven项目
pom.xml
<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>
<groupId> com.freud.test</groupId>
<artifactId> spring-boot-02</artifactId>
<version> 0.0.1-SNAPSHOT</version>
<packaging> jar</packaging>
<name> spring-boot-02</name>
<url> http://maven.apache.org</url>
<properties>
<project.build.sourceEncoding> UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<dependency>
<groupId> org.springframework.boot</groupId>
<artifactId> spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
<dependencyManagement>
<dependencies>
<dependency>
<!-- Import dependency management from Spring Boot -->
<groupId> org.springframework.boot</groupId>
<artifactId> spring-boot-dependencies</artifactId>
<version> 1.5.4.RELEASE</version>
<type> pom</type>
<scope> import</scope>
</dependency>
</dependencies>
</dependencyManagement>
</project>
src/main/resources/application.properties
spring.application.name=test-02
server.port= 9091
src/main/java/com.freud.springboot.App
package com.freud.springboot ;
import org.springframework.boot.SpringApplication ;
import org.springframework.boot.autoconfigure.SpringBootApplication ;
import org.springframework.web.bind.annotation.GetMapping ;
import org.springframework.web.bind.annotation.RequestMapping ;
import org.springframework.web.bind.annotation.RequestMethod ;
import org.springframework.web.bind.annotation.RestController ;
/**
* @author Freud
*/
@SpringBootApplication
@RestController
@RequestMapping ( value = "/freud/echo" )
public class App {
@GetMapping ( value = "/hello" )
public String hello () {
return "hello" ;
}
@RequestMapping ( value = "/hi" , method = RequestMethod . GET )
public String hi () {
return "hi" ;
}
public static void main ( String [] args ) {
SpringApplication . run ( App . class , args );
}
}
项目结构
运行及结果
通过main函数的方式运行App类。并在浏览器中依次打开http://localhost:9091/freud/echo/hi
和http://localhost:9091/freud/echo/hello
。
代码分析
其中@GetMapping
注解是Spring 4.3之后出现的组合注解,作用与@RequestMapping(value = "/hi", method = RequestMethod.GET)
相同。@RestController
是Spring 4.0之后出现的注解,相当于@Controller
加@ResponseBody
结合。
参考资料
Spring Boot Reference Guide : Spring Boot Reference Guide
《JavaEE开发的颠覆者 Spring Boot实战》 - 汪云飞
理解RESTful架构 :http://www.ruanyifeng.com/blog/2011/09/restful.html