php graph类,关于类型 · graphql-php · 看云

[toc]

#### 类型系统

要开始使用`GraphQL`，你需要实现一个`type`层次结构并将之公开为`Schema`。

在`graphql-php`中`type`是来自`GraphQL\Type\Definition`命名空间(`ScalarType`，`ObjectType`，`InterfaceType`，`UnionType`，`InputObjectType`)的内部类(或其子类)的实例。

你的`schema`中的大部分类型都是`object types`。

#### 类型定义风格

根据你的喜好，支持几种风格的定义类型。

##### 内联定义

~~~

namespace MyApp;

use GraphQL\Type\Definition\ObjectType;

use GraphQL\Type\Definition\Type;

$myType = new ObjectType([

'name' => 'MyType',

'fields' => [

'id' => Type::id()

]

]);

~~~

##### 每个类型定义一个类

~~~

namespace MyApp;

use GraphQL\Type\Definition\ObjectType;

use GraphQL\Type\Definition\Type;

class MyType extends ObjectType

{

public function __construct()

{

$config = [

// Note: 'name' is not needed in this form:

// it will be inferred from class name by omitting namespace and dropping "Type" suffix

'fields' => [

'id' => Type::id()

]

];

parent::__construct($config);

}

}

~~~

#### 类型注册

每个类型在`Schema`中必须通过单个实例(当graphql-php在`schema`中发现具有相同名字的多个实例会抛出异常)表示。

因此，如果你通过单独的`class` 定义`type`，你必须确保只有该类的唯一一个实例添加到`schema`中。

做到上面这些典型的方法是创建你的类型注册表。

~~~

namespace MyApp;

class TypeRegistry

{

private $myAType;

private $myBType;

public function myAType()

{

return $this->myAType ?: ($this->myAType = new MyAType($this));

}

public function myBType()

{

return $this->myBType ?: ($this->myBType = new MyBType($this));

}

}

~~~

在你的类型定义中使用这个注册表。

~~~

namespace MyApp;

use GraphQL\Type\Definition\ObjectType;

class MyAType extends ObjectType

{

public function __construct(TypeRegistry $types)

{

parent::__construct([

'fields' => [

'b' => $types->myBType()

]

]);

}

}

~~~

很显然，因为你期望减少冗余，你可以自动化这个注册表，甚至引用依赖注入窗口如果你的类型有其它依赖的话。

或者，如果你愿意的话，注册表中的所有方法都可以是静态的，然后你不再需要将实例化的TypeRegistry传入类型定义的构造函数，而只需要在类型定义中使用`TypeRegistry::MyAType()`。

使用静态方法重新定义注册表类：

~~~

namespace MyApp;

class TypeRegistry

{

private $myAType;

private $myBType;

public static function myAType()

{

return self::$myAType ?: (self::$myAType = new MyAType());

}

public function myBType()

{

return self::$myBType ?: (self::$myBType = new myBType());

}

}

~~~

定义类型

~~~

namespace MyApp;

use GraphQL\Type\Definition\ObjectType;

class MyAType extends ObjectType

{

public function __construct()

{

parent::__construct([

'fields' => [

'b' => $types::myBType()

]

]);

}

}

~~~