使用上下文路徑

Spring Cloud Contract 支援上下文路徑。

完全支援上下文路徑唯一需要的變更是切換到生產者端。此外，自動產生的測試必須使用顯式模式。消費者端保持不變。為了使產生的測試通過，您必須使用顯式模式。以下範例示範如何將測試模式設定為 EXPLICIT

Maven

<plugin>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-contract-maven-plugin</artifactId>
    <version>${spring-cloud-contract.version}</version>
    <extensions>true</extensions>
    <configuration>
        <testMode>EXPLICIT</testMode>
    </configuration>
</plugin>

Gradle

contracts {
		testMode = 'EXPLICIT'
}

這樣一來，您產生的測試不會使用 MockMvc。這表示您產生真實的請求，並且需要設定產生的測試的基底類別以在真實的 Socket 上運作。

考慮以下契約

org.springframework.cloud.contract.spec.Contract.make {
	request {
		method 'GET'
		url '/my-context-path/url'
	}
	response {
		status OK()
	}
}

以下範例示範如何設定基底類別和 RestAssured

import io.restassured.RestAssured;
import org.junit.Before;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.web.server.LocalServerPort;

@SpringBootTest(classes = ContextPathTestingBaseClass.class, webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class ContextPathTestingBaseClass {
	
	@LocalServerPort int port;
	
	@Before
	public void setup() {
		RestAssured.baseURI = "http://localhost";
		RestAssured.port = this.port;
	}
}

如果您這樣做

自動產生的測試中的所有請求都會傳送到包含您的上下文路徑的真實端點（例如，/my-context-path/url）。
您的契約反映您有上下文路徑。您產生的 Stub 也具有該資訊（例如，在 Stub 中，您必須呼叫 /my-context-path/url）。