Cucumber 將在每個情境之前建立一個新的膠合程式碼類別實例，因此您的步驟不會洩漏狀態。

• 注意：當使用 Spring 時，有一個註釋 ScenarioScope可用於任何已用於共享步驟狀態的 Spring bean；此註釋確保這些 bean 不會跨情境持續存在，因此不會洩漏狀態。
• 注意：當使用 Guice 時，有一個範圍 ScenarioScoped 應該始終在步驟定義類別中使用。

另請參閱依賴注入。

如果您的程式語言是 JVM 語言，您將在類別中編寫膠合程式碼（步驟定義和鉤子）。

Cucumber 將在每個情境之前建立一個新的膠合程式碼類別實例。

如果您的所有膠合程式碼類別都有一個空的建構函式，則您不需要其他任何東西。但是，大多數專案將受益於依賴注入 (DI) 模組，以更好地組織您的程式碼並在步驟定義之間共享狀態。

可用的依賴注入模組包括

• PicoContainer（如果您的應用程式不使用其他 DI 模組，則建議使用這個）
• Spring
• Guice
• OpenEJB
• Weld
• Needle

要使用 PicoContainer，請將以下依賴項新增至您的 pom.xml

<dependency>
    <groupId>io.cucumber</groupId>
    <artifactId>cucumber-picocontainer</artifactId>
    <version>7.20.1</version>
    <scope>test</scope>
</dependency>

或者，如果您使用 Gradle，請新增

compile group: 'io.cucumber', name: 'cucumber-picocontainer', version: '7.20.1'

目前沒有文件，但是程式碼在GitHub上。有關更多資訊，請參閱使用 PicoContainer 共享狀態。

要使用 Spring，請將以下依賴項新增至您的 pom.xml

<dependency>
    <groupId>io.cucumber</groupId>
    <artifactId>cucumber-spring</artifactId>
    <version>7.20.1</version>
    <scope>test</scope>
</dependency>

或者，如果您使用 Gradle，請新增

compile group: 'io.cucumber', name: 'cucumber-spring', version: '7.20.1'

目前沒有文件，但是程式碼在GitHub上。

要使用 Guice，請將以下依賴項新增至您的 pom.xml

<dependency>
    <groupId>io.cucumber</groupId>
    <artifactId>cucumber-guice</artifactId>
    <version>7.20.1</version>
    <scope>test</scope>
</dependency>

或者，如果您使用 Gradle，請新增

compile group: 'io.cucumber', name: 'cucumber-guice', version: '7.20.1'

目前沒有文件，但是程式碼在GitHub上。有關更多資訊，請參閱使用 Guice 共享狀態。

要使用 OpenEJB，請將以下依賴項新增至您的 pom.xml

<dependency>
    <groupId>io.cucumber</groupId>
    <artifactId>cucumber-openejb</artifactId>
    <version>7.20.1</version>
    <scope>test</scope>
</dependency>

或者，如果您使用 Gradle，請新增

compile group: 'io.cucumber', name: 'cucumber-openejb', version: '7.20.1'

目前沒有文件，但是程式碼在GitHub上。

要使用 Weld，請將以下依賴項新增至您的 pom.xml

<dependency>
    <groupId>io.cucumber</groupId>
    <artifactId>cucumber-weld</artifactId>
    <version>7.20.1</version>
    <scope>test</scope>
</dependency>

或者，如果您使用 Gradle，請新增

compile group: 'io.cucumber', name: 'cucumber-weld', version: '7.20.1'

目前沒有文件，但是程式碼在GitHub上。

要使用 Needle，請將以下依賴項新增至您的 pom.xml

<dependency>
    <groupId>io.cucumber</groupId>
    <artifactId>cucumber-needle</artifactId>
    <version>7.20.1</version>
    <scope>test</scope>
</dependency>

或者，如果您使用 Gradle，請新增

compile group: 'io.cucumber', name: 'cucumber-needle', version: '7.20.1'

目前尚無文件，但程式碼位於 GitHub 上。

當使用 DI 框架時，所有您的步驟定義、鉤子、轉換器等都將由框架的實例注入器建立。

Cucumber 的範例測試通常很小且沒有依賴性。然而，在現實生活中，測試通常需要存取應用程式特定的物件實例，這些實例也需要由注入器提供。這些實例需要提供給您的步驟定義，以便對它們執行操作並測試傳遞的結果。

使用 Cucumber 和 DI 框架的原因通常源於被測試的應用程式也使用相同的框架。因此，我們需要設定一個自訂注入器以用於 Cucumber。這個注入器將測試和應用程式實例連結在一起。

以下是一個使用 Google Guice 的典型步驟定義範例。使用 Cucumber 提供的 Guice 注入器將無法實例化所需的 appService 成員。

package com.example.app;

import static org.junit.Assert.assertTrue;

import io.cucumber.java.en.When;
import io.cucumber.java.en.Then;
import io.cucumber.guice.ScenarioScoped;
import com.example.app.service.AppService;
import java.util.Objects;
import javax.inject.Inject;

@ScenarioScoped
public final class StepDefinition {

    private final AppService appService;

    @Inject
    public StepDefinition( AppService appService ) {
        this.appService = Objects.requireNonNull( appService, "appService must not be null" );
    }

    @When("the application services are started")
    public void startServices() {
        this.appService.startServices();
    }

    @Then("all application services should be running")
    public void checkThatApplicationServicesAreRunning() {
        assertTrue( this.appService.servicesAreRunning() );
    }
}

AppService 的實作可能需要更多的參數和設定，通常必須由 Guice 模組提供。Guice 模組用於設定注入器，可能如下所示

package com.example.app.service.impl;

import com.example.app.service.AppService;
import com.google.inject.AbstractModule;

public final class ServiceModule extends AbstractModule {
    @Override
    protected void configure() {
        bind( AppService.class ).to( AppServiceImpl.class );
        // ... (further bindings)
    }
}

然後實際的注入器會像這樣建立：injector = Guice.createInjector( new ServiceModule() );

這表示我們需要建立自己的注入器，並告訴 Cucumber 使用它。

每當 Cucumber 需要特定的物件時，它會使用物件工廠。Cucumber 有一個預設的物件工廠，它（在 Guice 的情況下）會建立一個預設的注入器，並將物件建立委派給該注入器。如果您想要自訂注入器，我們需要提供自己的物件工廠，並告訴 Cucumber 改用它。

package com.example.app;

import io.cucumber.core.backend.ObjectFactory;
import io.cucumber.guice.CucumberModules;
import io.cucumber.guice.ScenarioScope;
import com.example.app.service.impl.ServiceModule;
import com.google.inject.Guice;
import com.google.inject.Injector;
import com.google.inject.Stage;

public final class CustomObjectFactory implements ObjectFactory {

    private Injector injector;

    public CustomObjectFactory() {
        // Create an injector with our service module
        this.injector =
          Guice.createInjector( Stage.PRODUCTION, CucumberModules.createScenarioModule(), new ServiceModule());
    }

    @Override
    public boolean addClass( Class< ? > clazz ) {
        return true;
    }

    @Override
    public void start() {
        this.injector.getInstance( ScenarioScope.class ).enterScope();
    }

    @Override
    public void stop() {
        this.injector.getInstance( ScenarioScope.class ).exitScope();
    }

    @Override
    public < T > T getInstance( Class< T > clazz ) {
        return this.injector.getInstance( clazz );
    }
}

這是 Guice 的預設物件工廠，除了我們已將自己的綁定新增至注入器之外。Cucumber 會透過 java.util.ServiceLoader 載入物件工廠。為了讓 ServiceLoader 能夠選擇我們的自訂實作，我們需要提供檔案 META-INF/services/io.cucumber.core.backend.ObjectFactory。

com.example.app.CustomObjectFactory
#
# ... additional custom object factories could be added here
#

現在我們必須告訴 Cucumber 使用我們的自訂物件工廠。有多種方式可以達成此目的。

當從命令列執行 Cucumber 時，可以將自訂物件工廠指定為引數。

java io.cucumber.core.cli.Main --object-factory com.example.app.CustomObjectFactory

如果存在，Cucumber 會使用屬性檔 (cucumber.properties)。自訂物件工廠可以在此檔案中指定，並會在 Cucumber 執行時被選取。以下項目需要存在於 cucumber.properties 檔案中

cucumber.object-factory=com.example.app.CustomObjectFactory

適用於 JUnit 4 和 TestNG 的 Cucumber 模組允許透過 JUnit/TestNG 測試執行 Cucumber。可以使用 @CucumberOptions 註解設定自訂物件工廠。對於 JUnit 5，請參閱 cucumber-junit-platform-engine 文件。

Cucumber 在許多情況下會在事件匯流排上發出事件，例如：- 在剖析功能檔案期間 - 當執行測試情境時

每個事件都有一個 UUID 作為唯一識別碼。可以使用 cucumber.uuid-generator 屬性設定 UUID 產生器

| UUID 產生器 | 功能 | 效能 [每秒產生數百萬個 UUID] | 一般使用範例 | |——————————————————-|————————————————————————————————————————————————————————————————————|————————————|——————————————————————————————————————————————————————————————————————————————————————————–| | io.cucumber.core.eventbus.RandomUuidGenerator |

• 執行緒安全
• 在單一 JVM/多個 JVM 中無衝突

• 執行緒安全
• 在相同的類別載入器中無衝突
• 在不同的類別載入器/JVM 中幾乎無衝突
• 使用來自相同類別載入器的實例產生的 UUID 是可排序的

實際專案的效能提升取決於功能的大小。

當未指定產生器時，會使用 RandomUuidGenerator。

當 RandomUuidGenerator 或 IncrementingUuidGenerator 都無法滿足專案需求時，可以定義自訂 UUID 產生器。這可以使用以下方法完成

1. 建立 UUID 類別產生器，例如：java package mypackage.mysubpackage; import io.cucumber.core.eventbus.UuidGenerator; public class MyUuidGenerator implements UuidGenerator { @Override public UUID generateId() { return ... } }
2. 使用類別路徑上的檔案 META-INF/services/io.cucumber.code.eventbus.UuidGenerator (例如，Maven resources 目錄) 將 UUID 產生器定義為 SPI，其中包含產生器類別名稱：java mypackage.mysubpackage.MyUuidGenerator

此 UUID 產生器將會覆寫預設的 RandomUuidGenerator。

當 META-INF/services/... 檔案包含多個 UUID 產生器，或當類別路徑上有多個 META-INF/services/... 時，必須設定 cucumber.uuid-generator 屬性以選取所需的產生器。

請參閱 Cucumber-JVM 中的 spring-java-junit5 範例，以取得最簡設定。