Class CsvBuilder

subprojects/groovy-csv/src/main/java/groovy/csv/CsvBuilder.java:44–176

Builds CSV output from collections of maps or typed objects. Example with maps: def data = [[name: 'Alice', age: 30], [name: 'Bob', age: 25]] def csv = groovy.csv.CsvBuilder.toCsv(data) assert csv.contains('name,age') assert csv.contains('Alice,

 * @since 6.0.0
 */
@Incubating
public class CsvBuilder implements Writable {
    private final CsvMapper mapper;
    private char separator = ',';
    private char quoteChar = '"';
    private String content;

    /**
     * Creates a builder that uses comma-separated columns and double quotes
     * for field escaping.
     */
    public CsvBuilder() {
        this.mapper = CsvSlurper.mapper();
    }

    /**
     * Set the column separator character (default: comma).
     *
     * @param separator the separator character
     * @return this builder for chaining
     */
    public CsvBuilder setSeparator(char separator) {
        this.separator = separator;
        return this;
    }

    /**
     * Set the quote character (default: double-quote).
     *
     * @param quoteChar the quote character
     * @return this builder for chaining
     */
    public CsvBuilder setQuoteChar(char quoteChar) {
        this.quoteChar = quoteChar;
        return this;
    }

    /**
     * Convert a collection of maps to CSV.
     * The keys of the first map are used as column headers.
     *
     * @param data the collection of maps
     * @return the CSV string
     */
    public static String toCsv(Collection<? extends Map<String, ?>> data) {
        if (data == null || data.isEmpty()) {
            return "";
        }
        CsvMapper csvMapper = CsvSlurper.mapper();
        Map<String, ?> first = data.iterator().next();
        CsvSchema.Builder schemaBuilder = CsvSchema.builder();
        for (String key : first.keySet()) {
            schemaBuilder.addColumn(key);
        }
        CsvSchema schema = schemaBuilder.build().withHeader();
        try {
            return csvMapper.writer(schema).writeValueAsString(data);
        } catch (IOException e) {