Java中如何将GherkinDocument转换为字符串并写入Cucumber Feature文件

安全阿岳

2026-9-27

实现方案

你可以直接使用Cucumber Gherkin库内置的GherkinFormatter工具类完成GherkinDocument到Feature文本的转换，不需要自行实现序列化逻辑。

核心代码示例

导入依赖类

import io.cucumber.gherkin.GherkinFormatter;

直接调用静态方法完成转换

// doc为你编辑完成的GherkinDocument对象
String featureContent = GherkinFormatter.format(doc);
// 若需要字符串数组，直接按换行符拆分即可
String[] featureLines = featureContent.split(System.lineSeparator());

完整读写流程示例

import io.cucumber.gherkin.GherkinDocumentBuilder;
import io.cucumber.gherkin.Parser;
import io.cucumber.gherkin.IdGenerator;
import io.cucumber.gherkin.GherkinFormatter;
import io.cucumber.messages.types.GherkinDocument;
import java.io.FileReader;
import java.io.FileWriter;
import java.io.Reader;

public class GherkinEditDemo {
    public static void main(String[] args) throws Exception {
        // 1. 解析原有Feature文件
        IdGenerator idGenerator = new IdGenerator.Incrementing();
        Parser<GherkinDocument> parser = new Parser<>(new GherkinDocumentBuilder(idGenerator));
        try (Reader reader = new FileReader("原始文件路径/origin.feature")) {
            GherkinDocument doc = parser.parse(reader);
            
            // 2. 此处插入你编辑标签、修改文档内容的逻辑
            // ...你的业务代码...
            
            // 3. 转换为Feature格式字符串
            String outputContent = GherkinFormatter.format(doc);
            
            // 4. 写入目标Feature文件
            try (FileWriter writer = new FileWriter("输出文件路径/modified.feature")) {
                writer.write(outputContent);
            }
        }
    }
}