SOLID
Gato GraphQL, yazılım mimarisi için SOLID yaklaşımını benimser; kodu sürdürülebilir, genişletilebilir ve anlaşılır kılmak amacıyla farklı sorumlulukları farklı varlıklara devreder.
Kullanıcı varlığının plugin tarafından nasıl sağlandığı aşağıda gösterilmektedir. User türü şu kod aracılığıyla sağlanır:
class UserTypeResolver extends AbstractTypeResolver
{
public function getTypeName(): string
{
return 'User';
}
public function getSchemaTypeDescription(): ?string
{
return $this->translationAPI->__('Representation of a user', "users");
}
public function getID(object $user)
{
return $this->usersAPI->getUserId($user);
}
public function getTypeDataLoaderClass(): string
{
return UserTypeDataLoader::class;
}
}Type resolver, nesneleri doğrudan veritabanından yüklemez; bunun yerine bu görevi bir TypeDataLoader nesnesine devreder (yukarıdaki örnekte, UserTypeDataLoader sınıfından).
User türüne username, email ve url alanlarının eklenmesi, şu kod ile bir FieldResolver nesnesi aracılığıyla yapılır:
class UserFieldResolver extends AbstractDBDataFieldResolver
{
public static function getClassesToAttachTo(): array
{
return [
UserTypeResolver::class,
];
}
public static function getFieldNamesToResolve(): array
{
return [
'username',
'email',
'url',
];
}
public function getSchemaFieldDescription(
TypeResolverInterface $typeResolver,
string $fieldName
): ?string {
$descriptions = [
'username' => $this->translationAPI->__("User's username handle", "users"),
'email' => $this->translationAPI->__("User's email", "users"),
'url' => $this->translationAPI->__("URL of the user's profile in the website", "users"),
];
return $descriptions[$fieldName];
}
public function getSchemaFieldType(
TypeResolverInterface $typeResolver,
string $fieldName
): ?string {
$types = [
'username' => SchemaDefinition::TYPE_STRING,
'email' => SchemaDefinition::TYPE_EMAIL,
'url' => SchemaDefinition::TYPE_URL,
];
return $types[$fieldName];
}
public function resolveValue(
TypeResolverInterface $typeResolver,
object $user,
string $fieldName,
array $fieldArgs = []
) {
switch ($fieldName) {
case 'username':
return $this->usersAPI->getUserLogin($user);
case 'email':
return $this->usersAPI->getUserEmail($user);
case 'url':
return $this->usersAPI->getUserURL($user);
}
return null;
}
}Görüldüğü üzere, GraphQL şeması için bir alanın tanımı ve çözümlenmesi birden fazla fonksiyona bölünmüştür:
getSchemaFieldDescriptiongetSchemaFieldTyperesolveValue
Diğer fonksiyonlar şunlardır:
getSchemaFieldArgs: alan argümanlarını bildirmek için (ad, açıklama, tür ve zorunlu olup olmadıklarını içerir)isSchemaFieldResponseNonNullable: bir alanın null olamaz olup olmadığını belirtmek içingetImplementedInterfaceClasses: alanlar tarafından uygulanan arayüzler için resolver'ları tanımlamak amacıylaresolveFieldTypeResolverClass: alan bir bağlantı olduğunda type resolver'ı tanımlamak içinresolveFieldMutationResolverClass: alan mutations çalıştırdığında resolver'ı tanımlamak için
Bu kod, tüm işlevselliklerin tek bir fonksiyon veya bir yapılandırma dizisi aracılığıyla karşılandığı duruma kıyasla daha okunabilirdir; bu da resolver'ların uygulanmasını ve bakımını kolaylaştırır.