Spring GraphQL 1.0.1：如何将String数组映射为SortedSet？

在使用spring-graphql 1.0.1时，我尝试在GraphQL Mutation中将String数组[String]映射为SortedSet，但出现如下错误：

Property referenced in indexed property path 'names[0]' is neither an array nor a List nor a Map; returned value was [[]]

请问如何指定输入类型的String数组到SortedSet的转换规则？

相关代码 #

schema.graphqls

type Mutation {
    save(person: PersonInput): Person
}

input PersonInput {
    id: String
    names: [String]
}

type Person {
    id: String
    names: [String]
}

Java实体类

@Data
public class Person {
  private String id;
  private SortedSet names;
}

Mutation查询语句

mutation {
    save( person: {  id: "1", names: ["A","B"]} ){
        id
        names
    }
}

解决方法 #

出现该错误的核心原因是Spring GraphQL默认属性绑定机制无法直接将数组/List转换为SortedSet，以下是两种可行的解决方式：

方案一：自定义类型转换器 #

创建实现Converter<List<String>, SortedSet<String>>的转换器，让Spring自动识别并完成类型转换：

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;
import java.util.SortedSet;
import java.util.TreeSet;

@Component
public class ListToSortedSetConverter implements Converter<List<String>, SortedSet<String>> {
    @Override
    public SortedSet<String> convert(List<String> source) {
        return new TreeSet<>(source);
    }
}

同时给实体类的SortedSet添加泛型声明，避免类型不安全问题：

@Data
public class Person {
  private String id;
  private SortedSet<String> names;
}

方案二：通过Setter方法手动转换 #

若不想自定义转换器，可修改实体类，添加一个接收List<String>的Setter方法，在方法内部完成转换：

@Data
public class Person {
  private String id;
  private SortedSet<String> names;

  public void setNames(List<String> namesList) {
    this.names = new TreeSet<>(namesList);
  }
}

Spring GraphQL绑定属性时会自动调用该适配Setter，完成List到SortedSet的转换。

注意事项 #

• 必须给SortedSet指定泛型String，否则会因类型擦除导致转换时出现类型不匹配问题。
• 基于Spring Boot的项目中，自定义转换器标注@Component后会被自动注册到Spring转换服务，无需额外配置。

内容的提问来源于stack exchange，提问作者loonis