Spring Boot 和 Jersey 的簡單應用

Spring Boot 是 Spring 應用程式的引導框架。它還與澤西島的整合提供無縫支援。其中一個優點(從 Jersey 使用者的角度來看)是你可以訪問 Spring 龐大的生態系統。

首先,建立一個新的獨立 (非 wepapp)Maven 專案。我們也可以建立一個 webapp,但是對於本指南,我們將只使用一個獨立的應用程式。建立專案後,將以下內容新增到 pom.xml

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>1.4.0.RELEASE</version>
</parent>
<dependencies>  
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jersey</artifactId>
    </dependency>
    <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-tomcat</artifactId>
    </dependency>
</dependencies>
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

我們只需要兩個依賴項。一個用於 Jersey Spring Boot 模組,另一個用於嵌入式 Tomcat 伺服器。我們將使用該外掛執行應用程式進行測試。

完成後,將以下類新增到專案中。

com/example
  |
  +-- GreetingApplication.class
  +-- JerseyConfig.class
  |
  + com/example/services
  |   |
  |   +-- GreetingService.class
  |   +-- NiceGreetingService.class
  |
  + com/examples/resources
      |
      +-- GreetingResource.class 

GreetingApplication.class

這是 bootstrap 類(非常簡單)

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class GreetingApplication {
    
    public static void main(String[] args) {
        SpringApplication.run(GreetingApplication.class, args);
    }
}

JerseyConfig.class

這是 Jersey 配置類

import javax.ws.rs.ApplicationPath;
import org.glassfish.jersey.server.ResourceConfig;
import org.springframework.stereotype.Component;

@Component
@ApplicationPath("/api")
public class JerseyConfig extends ResourceConfig {
    public JerseyConfig() {
        packages("com.example");
    }
}

GreetingService.classNiceGreetingService.class

public interface GreetingService {
   public String getGreeting(String name);
}

import org.springframework.stereotype.Component;

@Component
public class NiceGreetingService implements GreetingService {
    
    @Override
    public String getGreeting(String name) {
        return "Hello " + name + "!";
    }
}

GreetingResource

這是我們將 Spring 注入 GreetingService 的資源類。

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.QueryParam;
import org.springframework.beans.factory.annotation.Autowired;
import com.example.service.GreetingService;

@Path("greeting")
public class GreetingResource {

    private GreetingService greetingService;

    @Autowired
    public GreetingResource(GreetingService greetingService) {
        this.greetingService = greetingService;
    }

    @GET
    public String getGreeting(@QueryParam("name") String name) {
        return this.greetingService.getGreeting(name);
    }
}

就是這樣。我們現在可以執行該應用程式。獲取終端並從專案的根目錄執行以下命令。

mvn spring-boot:run

應用程式應該花幾秒鐘才能開始。會有一些日誌記錄,你會看到一些 Spring ASCII 藝術。在那個藝術之後,它應該是大約 30 行左右的更多日誌記錄,那麼你應該看到

 15.784 seconds (JVM running for 38.056)

現在應用程式已啟動。如果你使用 cURL,你可以使用它進行測試

curl -v 'http://localhost:8080/api/greeting?name=peeskillet'

如果你使用的是 Windows,請在 URL 周圍使用雙引號。如果你不使用 cURL,只需在瀏覽器中輸入即可。你應該看到結果

Hello peeskillet!

你可能會注意到第一次請求時請求需要幾秒鐘。這是因為應用程式啟動時 Jersey 沒有完全載入。我們可以通過在 src/main/resources 資料夾中新增 application.properties 檔案來改變它。在該檔案中新增以下內容:

spring.jersey.servlet.load-on-startup=1