使用Spring構建第一個RESTful服務
最近打算重新學學java,突然發現RESTful這個東西好像蠻有趣的,找來資料學習,找到Spring官方網站的一些資料,這裡就跟著官方網站的例子試驗了下。記錄下實踐的過程,一則穩固記憶,二則溫故知新。
REST (Representational State Transfer)描述了一個架構樣式的網路系統。REST的基本原理就是使用URI來描述資源,每個具體的資源在服務中都對應到一個URI中,資料的傳輸交流通過json或者是xml來實現,對資源的操作通過http中的方法來實現。RESTful是通過REST造出來的一個形容詞,應該說沒有具體的定義,他說描述的是一個規範或者說一系列的原則,符合這些規範和原則的我們就把他成為是RESTful。
下面我們就來構建我們的第一個RESTful的Web服務,下面是開發相關的一些資訊:
開發環境:Eclipse+Maven外掛
框架:Spring
流程管理:Maven
Java版本:JDK1.8+
{"id":1,"content":"Hello, World!"}
這裡的這個id是一個可以增長計數的一個ID,每一次訪問的時候這個ID都會增長。
1,在Eclipse(要已經安裝了Maven外掛)中新建一個Maven專案,這裡格式選擇jar,最好將專案編譯為一個jar包,這樣可以在其他任意地方使用。其他的隨便填。
2,編寫Maven的配置檔案poe.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.gaospot</groupId>
<artifactId> hello</artifactId>
<version>0.0.1-SNAPSHOT</version>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.3.5.RELEASE</version>
</parent>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>com.jayway.jsonpath</groupId>
<artifactId>json-path</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
<repositories>
<repository>
<id>spring-releases</id>
<url>https://repo.spring.io/libs-release</url>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>spring-releases</id>
<url>https://repo.spring.io/libs-release</url>
</pluginRepository>
</pluginRepositories>
</project>
dependencies引入的是這個專案所需要依耐的軟體包。repositories指定這些軟體包的下載地址。parent指出的是父模組,沒搞明白這裡為什麼要使用這個引數,這裡應該是隻需要dependencies中指定了依耐就可以的。
3、在原始碼目錄中新建一個包,在包裡建立Bean,Control和Application,Application在這裡是一個含有主函式的類,可以直接執行這個類來測試我們的應用。
package hello;
public class Greeting {
private final long id;
private final String content;
public Greeting(long id, String content) {
this.id = id;
this.content = content;
}
public long getId() {
return id;
}
public String getContent() {
return content;
}
}
package hello;
import java.util.concurrent.atomic.AtomicLong;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class GreetingController {
private static final String template = "Hello, %s!";
private final AtomicLong counter = new AtomicLong();
@RequestMapping("/greeping")
public Greeting greeting(@RequestParam(value="name", defaultValue="World")String name) {
return new Greeting(counter.incrementAndGet(),
String.format(template, name));
}
}
package hello;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
4、現在原始碼都已經編寫好了,可以測試運用了,運用執行後在瀏覽器中訪問之間的那個地址就可以得到我們想要的結果了。