文档中对 "IObjectFieldDescriptor.Type" 的混淆

Question

我只是想设置一些基本示例。我想“代码优先”，我需要 C# 编译器告诉我哪里出错了。

如果我看 https://chillicream.com/docs/hotchocolate/v10/schema/object-type/

有个例子

type Person {
  id: Int!
  name: String!
  friends: [Person]
}

据称是此 C# 代码的结果

public class PersonType
    : ObjectType<Person>
{
    protected override void Configure(IObjectTypeDescriptor<Person> descriptor)
    {
        descriptor.Field(t => t.Name).Type<NonNullType<StringType>>();
        descriptor.Field("friends")
            .Type<ListType<NonNullType<StringType>>>()
            .Resolver(context =>
                context.Service<IPersonRepository>().GetFriends(
                    context.Parent<Person>().Id));
    }
}

好的，所以 id 丢失了，但是文档继续解释说热巧克力会填补空白（我不喜欢……但把它放在一边）。然后我们有“name”，它是一个字符串，这似乎对应于

.Type<NonNullType<StringType>>()

好吧，那是可信的，“朋友”虽然看起来很奇怪。 “类型”是

.Type<ListType<NonNullType<StringType>>>()

我希望更明显地映射到“[Person]”的东西

文档有误吗？还是我的理解有误？

Answer 1

首先，是的，那里的文档是错误的。将在此 PR 中修复：https://github.com/ChilliCream/hotchocolate/pull/2890

正确的代码是

public class PersonType
    : ObjectType<Person>
{
    protected override void Configure(IObjectTypeDescriptor<Person> descriptor)
    {
        descriptor.Field(t => t.Name).Type<NonNullType<StringType>>();
        descriptor.Field("friends")
            .Type<ListType<NonNullType<PersonType>>>()
            .Resolver(context =>
                context.Service<IPersonRepository>().GetFriends(
                    context.Parent<Person>().Id));
    }
}

Ok, so id is missing, but the documentation goes on to explain that hot chococolate will fill in the gaps (something I'm not a fan of...but putting that aside).

如果您不喜欢，可以部分关闭它。如果未设置，HotChocolate 将始终尝试从 .NET 推断类型。但是如果你想禁用属性推断，你可以通过两种方式做到这一点。

全局禁用它

schemaBuilder.ModifyOptions(x => x.DefaultBindingBehavior = BindingBehavior.Explicit)

根据类型禁用它

public class PersonType
    : ObjectType<Person>
{
    protected override void Configure(IObjectTypeDescriptor<Person> descriptor)
    {
         descriptor.BindFieldsExplicitly();
    }
}

文档中对 "IObjectFieldDescriptor.Type" 的混淆

Confusion over "IObjectFieldDescriptor.Type" in documentation

hotchocolate