12 Nov 2022
GraphQL.js의 리졸버는 네개의 인자를 가지고 있습니다. 그 중 첫번째 인자는 source 입니다.
GraphQL Java에서는 DataFetchingEnvironment.getSource로 얻을 수 있습니다.
앞서 설명했듯이 리졸버는 상위 필드에서 하위 필드 순서로 호출됩니다. source는 상위 필드에서 반환한 값이 들어갑니다. 상위 필드가 없는 Query 필드에는 execute(graphql) 메소드의 rootValue 값이 들어옵니다. 다만 실전에서 rootValue를 사용해 본 적은 없습니다.
굉장히 단순한 동작이지만 상위 필드에서 반환한 값이 그대로 들어온 다는 점을 이해해두면 좋습니다. 카카오스타일에서는 이 특성을 활용한 리졸버가 있습니다.
앞선 예제를 다시 보겠습니다.
const type_defs = `
type User {
id: ID!
name: String!
mobile_tel: String!
}
type Post {
id: ID!
title: String!
author_id: ID!
author: User!
}
type Query {
getPosts: [Post!]!
getUser(id: ID!): User!
}`;
const posts = [
{ id: '1', title: 'Post 1', author_id: '51' },
{ id: '2', title: 'Post 2', author_id: '52' },
{ id: '3', title: 'Post 3', author_id: '51' },
];
const resolvers = {
Query: {
getPosts: () => posts,
},
Post: {
author: (source: any) => authors[source.author_id],
},
};
GraphQL의 Post 타입과 구현 부분의 Post 인터페이스는 명백하게 같지 않습니다. 하지만 문제 없이 동작하죠. 이 차이를 명확히 보기 위해 Post 클래스를 정의하는 것으로 바꿔보겠습니다.
class Post {
constructor(public id: string, public title: string, public author_id: string) {}
}
const posts: Post[] = [new Post('1', 'Post 1', '51'), new Post('2', 'Post 2', '52'), new Post('3', 'Post 3', '51')];
const resolvers = {
Query: {
getPosts: () => posts,
},
Post: {
author: (source: Post) => authors[source.author_id],
},
};
이렇게 하면 GraphQL의 Post 타입과 다르다는 점이 명확히 눈에 들어옵니다.
타입스크립트에서는 필드만 동일하면 해당 클래스와 같은 타입으로 인지합니다. 둘을 섞어서 정의해보면 어떻게 될까요?
const posts: Post[] = [
new Post('1', 'Post 1', '51'),
{ id: '2', title: 'Post 2', author_id: '52' },
{ id: '3', title: 'Post 3', author_id: '51' },
];
const resolvers = {
Post: {
author: (source: Post) => {
console.log(source.id, source instanceof Post);
return authors[source.author_id];
},
},
};
결과는
1 true
2 false
3 false
이 됩니다. 극단적으로는 다음과 같은 것도 가능합니다.
const resolvers = {
Query: {
getPosts: () => posts.map((post) => ({ _id: post.id })),
},
Post: {
id: (source: { _id: string }) => source._id,
title: (source: { _id: string }) => posts.find((post) => post.id === source._id)!.title,
author: (source: { _id: string }) => authors[posts.find((post) => post.id === source._id)!.author_id],
},
};
위에서 알 수 있듯이 상위 필드가 반환하는 값이 GraphQL 타입과 무관해도 아무 문제없습니다.
GraphQL Java에서도 동작은 같습니다. (DGS 예이지만, DGS가 GraphQL Java 위에서 동작하므로 차이가 없습니다.)
data class Id(val _id: String)
data class User(val id: String, val name: String, val mobile_tel: String)
val users = mapOf(
"51" to User("51", "John", "01012345678"),
"52" to User("52", "Alex", "01087654321"),
)
@DgsComponent
class PostDataFetcher {
data class Post(val id: String, val title: String, val author_id: String)
private val posts = listOf(
Post("1", "Post 1", "51"),
Post("2", "Post 2", "52"),
Post("3", "Post 3", "51"),
)
@DgsQuery
fun getPosts() = posts.map { Id(it.id) }
@DgsData(parentType = "Post", field = "id")
fun id(dfe: DgsDataFetchingEnvironment) = dfe.getSource<Id>()._id
@DgsData(parentType = "Post", field = "title")
fun title(dfe: DgsDataFetchingEnvironment) = posts.find { it.id == dfe.getSource<Id>()._id }!!.title
@DgsData(parentType = "Post", field = "author")
fun author(dfe: DgsDataFetchingEnvironment) = users[posts.find { it.id == dfe.getSource<Id>()._id }!!.author_id]
}
잘 활용하면 좋지만 코드를 새로 접한 사람에게 혼란을 줄 수도 있습니다. 또 위 특성 때문에 타입 언어와 안 어울리는 부분이 있습니다. 저희의 경우 TypeScript 프로젝트에 GraphQL Code Generator를 사용해 리졸버 타입을 지정해주고 있는데, getPosts 리졸버가 반환하는 값에 non-null인 author 필드 값이 없다고 타입 에러가 나기 때문에 어쩔 수 없이 any를 써주고 있습니다.
09 Nov 2022
GraphQL 스키마를 정의했고, 클라이언트에서 온 요청을 서버가 처리하기 위해 필요한 기술을 알아봤습니다. 이제 클라이언트에서 온 요청에 따라 적절한 데이터를 반환하는 과정이 남았습니다. 이는 리졸버(resolver)라는 것이 담당합니다. Java쪽에서는 데이터 페처(data fetcher)라고도 부릅니다. 리졸버를 완전히 이해하면 GraphQL을 전부를 알았다고 할만큼 GraphQL의 핵심이라고 볼 수 있습니다.
리졸버는 필드 요청이 들어온 경우 그 값을 제공하는 역할을 합니다. Query 타입에 users 라는 필드를 정의한 경우 query { users }
라는 질의로 값을 요청할 수 있고, 그 경우 users 필드 정의의 resolve 함수가 호출됩니다. 다음은 이전 글에서 리졸버 부분을 가져왔습니다.
users: {
type: new GraphQLNonNull(new GraphQLList(new GraphQLNonNull(User))),
resolve: () => [{ name: 'Johnny' }],
},
위 예제에서는 리졸버를 스키마 정의와 함께 구현했습니다. 개인적인 경험에서는 리졸버를 분리하는 것이 코드 유지보수에 나았습니다. GraphQL Java의 GraphQLCodeRegistry도 스키마와 리졸버를 분리해주는 도구입니다. 반면 코드 우선 접근에서는 리졸버과 스키마 정의와 붙어있게 됩니다.
Node.js에는 GraphQL 사용을 도와주는 GraphQL Tools 라이브러리가 있습니다. GraphQL Tools의 addResolversToSchema를 사용하면 만들어진 스키마에 따로 정의한 리졸버를 연결할 수 있습니다. (makeExecutableSchema를 사용하면 buildSchema와 addResolversToSchema를 한번에 해줍니다.)
import { buildSchema } from 'graphql';
import { addResolversToSchema } from '@graphql-tools/schema';
const pure_schema = buildSchema(`
type User {
name: String!
}
type Query {
users: [User!]!
}
`);
const resolvers = {
Query: {
users: () => [{ name: 'Johnny' }],
},
};
const schema = addResolversToSchema({ schema: pure_schema, resolvers });
위와 같은 형태로 Query 타입과 Mutation 타입의 모든 필드에 대해 리졸버를 구현해 연결해주면 기본적인 데이터 제공이 끝납니다.
비동기로 데이터를 가져와 반환해야 하는 경우에는 Promise 객체를 반환하면 graphql 라이브러리가 프로미스의 이행(fulfill)을 기다려 데이터를 반환합니다.
import fs from 'fs/promises';
const resolvers = {
Query: {
users: async () => JSON.parse(await fs.readFile('users.json', 'utf-8')),
},
};
Spring이나 Rails 같은 프레임워크에서는 REST API를 컨트롤러 클래스에서 구현합니다. 주어진 API에 대해 값을 반환한다는 측면에서 컨트롤러와 리졸버는 비슷한 일을 합니다. GraphQL을 얕은 수준에서 사용하면 REST API와 비슷하게 사용할 수도 있습니다. 이 관점에서 GraphQL과 REST API의 차이는 다음 정도입니다.
컨트롤러는 최상위 레벨(Query, Mutation)의 요청에 대해서만 인식하고 처리하는데 반해, 리졸버는 그 하위 필드에 대해서도 정의할 수 있다는 점에서 GraphQL과 REST API의 차이가 생깁니다. 반대로 그 필요성이 없다면 굳이 GraphQL을 사용할 필요가 없다는 뜻이 됩니다.
다음 스키마를 보겠습니다.
type User {
id: ID!
name: String!
mobile_tel: String!
}
type Post {
id: ID!
title: String!
author_id: ID!
author: User!
}
type Query {
getPosts: [Post!]!
getUser(id: ID!): User!
}
Post와 User는 별도의 리소스이기 때문에 순수 REST API라면 getPosts에서 author_id만 반환하고, author는 별도로 getUser를 호출해 가져가는 것이 자연스럽습니다. 다만 실제에서는 효율을 위해 getPosts에서 author도 같이 반환하게 구현할 겁니다. 하지만 글 목록에서 전화번호는 필요하지 않을테니 아마 name만 반환하는 형태로 할 것 같습니다. 즉 Post.author의 User 타입과 Query.getUser의 User 타입은 사실상 관계없는 타입일 가능성이 높습니다.
반면에 GraphQL에서는 자연스럽게 두 타입이 이어집니다. 또 REST API에서는 모든 클라이언트에게 author를 제공하던지, 제공하지 않는 선택지만 있다면, GraphQL은 필요한 클라이언트만 author를 요청하고, 요청받을 때만 저장소(DB)에 접근하는 것이 가능합니다.
다음은 위 스키마를 가볍게 구현해본 예입니다. 모든 타입의 모든 필드에 리졸버를 붙일 수 있습니다. Query, Mutation도 똑같이 타입이라고 간주하면 됩니다.
import { makeExecutableSchema } from '@graphql-tools/schema';
import { graphql } from 'graphql';
const type_defs = `
type User {
id: ID!
name: String!
mobile_tel: String!
}
type Post {
id: ID!
title: String!
author_id: ID!
author: User!
}
type Query {
getPosts: [Post!]!
getUser(id: ID!): User!
}`;
const posts = [
{ id: '1', title: 'Post 1', author_id: '51' },
{ id: '2', title: 'Post 2', author_id: '52' },
{ id: '3', title: 'Post 3', author_id: '51' },
];
const authors = {
51: { id: '51', name: 'John', mobile_tel: '01012345678' },
52: { id: '52', name: 'Alex', mobile_tel: '01087654321' },
};
const resolvers = {
Query: {
getPosts: () => posts,
getUser: (_source: any, args: any) => authors[args.id],
},
Post: {
author: (source: any) => authors[source.author_id],
},
};
const schema = makeExecutableSchema({ typeDefs: type_defs, resolvers });
(async () => {
const result = await graphql({
schema,
source: 'query { getPosts { id title author { id name } } getUser(id: "51") { id name mobile_tel } }',
});
console.log(JSON.stringify(result, null, 2));
})();
다음은 실행 결과입니다.
{
"data": {
"getPosts": [
{
"id": "1",
"title": "Post 1",
"author": { "id": "51", "name": "John" }
},
{
"id": "2",
"title": "Post 2",
"author": { "id": "52", "name": "Alex" }
},
{
"id": "3",
"title": "Post 3",
"author": { "id": "51", "name": "John" }
}
],
"getUser": { "id": "51", "name": "John", "mobile_tel": "01012345678" }
}
}
리졸버는 모든 필드에 대해서 호출됩니다. 그리고 상위 필드 부터 하위 필드 순으로 호출됩니다. (당연히 상위 필드가 값을 반환해야만 어떤 하위 필드가 있는지 알 수 있겠죠) 같은 레벨에서는 순서를 보장하지 않습니다. (다만 사이드 이펙트가 있는 Mutation 만은 순서대로 실행합니다.)
이와 같은 기준으로 위 쿼리를 보면 다음과 같은 필드에 대해 리졸버가 호출됐을 겁니다.
하지만 우리가 정의한 리졸버는 이 중 5개만 대응됩니다. 나머지는 초기 리졸버가 호출됩니다. 초기 리졸버는 상위 필드에서 반환한 객체에서 해당 이름의 필드를 반환하도록 되어 있습니다.
다음은 GraphQL.js 초기 리졸버 코드입니다.
export const defaultFieldResolver: GraphQLFieldResolver<unknown, unknown> =
function (source: any, args, contextValue, info) {
// ensure source is a value for which property access is acceptable.
if (isObjectLike(source) || typeof source === 'function') {
const property = source[info.fieldName];
if (typeof property === 'function') {
return source[info.fieldName](args, contextValue, info);
}
return property;
}
};
다음은 GraphQL Java의 초기 리졸버 코드입니다.
public class GraphQLCodeRegistry {
public static class Builder {
private DataFetcherFactory<?> defaultDataFetcherFactory = env -> PropertyDataFetcher.fetching(env.getFieldDefinition().getName());
}
}
public class PropertyDataFetcher<T> implements DataFetcher<T>, TrivialDataFetcher<T> {
public T get(DataFetchingEnvironment environment) {
Object source = environment.getSource();
if (source == null) {
return null;
}
if (function != null) {
return (T) function.apply(source);
}
return (T) PropertyDataFetcherHelper.getPropertyValue(propertyName, source, environment.getFieldType(), environment);
}
}
이 동작을 이해하면 결과를 원하는 대로 조작할 수 있습니다. 예를 들어 사용자 이름을 소문자로 변경하려면 다음 리졸버를 추가하면 됩니다.
const resolvers = {
User: {
name: (source: any) => source.name.toLowerCase(),
},
};
User 타입에 적용되기 때문에 getPosts와 getUser 결과 모두에 적용됩니다.
한편 데이터는 어떤 리졸버가 반환해도 괜찮습니다. 즉 Post.author 리졸버를 구현하는 대신 getPosts를 다음과 같이 구현해도 동일한 결과를 얻을 수 있습니다. 대신 getPost(id: ID!)
와 같이 Post 타입을 반환하는 다른 API가 있다면 그쪽에도 동일하게 구현해줘야 합니다.
const resolvers = {
Query: {
getPosts: () => posts.map((post) => ({ ...post, author: authors[post.author_id] })),
},
};
만약 getPosts가 author를 이미 반환하고 있는데, Post.author 리졸버를 구현했다면 어떻게 될까요? 위 원리를 이해했다면 아시겠지만, 호출 됩니다. author를 구하는데 DB 접근을 하고 있다면 중복 요청을 하는 셈이 되겠죠. 만약 getPosts도 author를 반환하는게 효율적이고, 다른 API를 위해 Post.author도 구현해야 했다면 다음과 같이 중복 동작을 막을 수 있습니다.
const resolvers = {
Post: {
author: (source: any) => (source.author ? source.author : authors[source.author_id]),
},
};
위 스키마를 다른 라이브러리로 구현한 예제입니다. 표현 방식은 다르지만 리졸버 원리는 동일합니다.
data class Post(val id: String, val title: String, val author_id: String)
data class User(val id: String, val name: String, val mobile_tel: String)
val posts = listOf(
Post("1", "Post 1", "51"),
Post("2", "Post 2", "52"),
Post("3", "Post 3", "51"),
)
val users = mapOf(
"51" to User("51", "John", "01012345678"),
"52" to User("52", "Alex", "01087654321"),
)
val typeRegistry = SchemaParser().parse(
"""
type User {
id: ID!
name: String!
mobile_tel: String!
}
type Post {
id: ID!
title: String!
author_id: ID!
author: User!
}
type Query {
getPosts: [Post!]!
getUser(id: ID!): User!
}""".trimIndent()
)
val queryBuilderFunction = { builder: TypeRuntimeWiring.Builder ->
builder.dataFetcher("getPosts", StaticDataFetcher(posts))
.dataFetcher("getUser") { env -> users[env.getArgument("id")] }
}
var postBuilderFunction = { builder: TypeRuntimeWiring.Builder ->
builder.dataFetcher("author") { env -> users[env.getSource<Post>().author_id] }
}
var userBuilderFunction = { builder: TypeRuntimeWiring.Builder ->
builder.dataFetcher("name") { env -> env.getSource<User>().name.lowercase() }
}
val runtimeWiring = RuntimeWiring.newRuntimeWiring()
.type("Query", queryBuilderFunction)
.type("Post", postBuilderFunction)
.type("User", userBuilderFunction)
.build()
val schema = SchemaGenerator().makeExecutableSchema(typeRegistry, runtimeWiring)
val graphql = GraphQL.newGraphQL(schema).build()
val query = """query { getPosts { id title author { id name } } getUser(id: "51") { id name mobile_tel } }"""
println(graphql.execute(query).toString())
실행 결과입니다.
ExecutionResultImpl{errors=[], data={getPosts=[{id=1, title=Post 1, author={id=51, name=john}}, {id=2, title=Post 2, author={id=52, name=alex}}, {id=3, title=Post 3, author={id=51, name=john}}], getUser={id=51, name=john, mobile_tel=01012345678}}, dataPresent=true, extensions=null}
DGS는 프레임워크이기 때문에 규칙에 따라 파일들을 작성해줘야 합니다.
Getting Started 문서에 따라 Spring Boot 프로젝트를 생성하고 DGS Framework를 의존성에 추가해줍니다.
src/main/resources/schema/schema.graphqls
에 스키마를 작성합니다.
type User {
id: ID!
name: String!
mobile_tel: String!
}
type Post {
id: ID!
title: String!
author_id: ID!
author: User!
}
type Query {
getPosts: [Post!]!
getUser(id: ID!): User!
}
데이터 페처는 다음과 같이 구현해주면 됩니다.
@DgsComponent
class PostDataFetcher {
data class Post(val id: String, val title: String, val author_id: String)
private val posts = listOf(
Post("1", "Post 1", "51"),
Post("2", "Post 2", "52"),
Post("3", "Post 3", "51"),
)
@DgsQuery
fun getPosts() = posts
}
@DgsComponent
class UserDataFetcher {
data class User(val id: String, val name: String, val mobile_tel: String)
private val users = mapOf(
"51" to User("51", "John", "01012345678"),
"52" to User("52", "Alex", "01087654321"),
)
@DgsQuery
fun getUser(@InputArgument id: String) = users[id]
@DgsData(parentType = "Post", field = "author")
fun author(dfe: DgsDataFetchingEnvironment) = users[dfe.getSource<PostDataFetcher.Post>().author_id]
@DgsData(parentType = "User", field = "name")
fun name(dfe: DgsDataFetchingEnvironment) = dfe.getSource<User>().name.lowercase()
}
http://localhost:8080/graphiql 에 접속해서 질의를 입력하면 결과를 볼 수 있습니다.
07 Nov 2022
이전 글에서 GraphQL 스키마를 정의했습니다. 이제 이 스키마에 질의를 하고 그 결과를 받을 수 있습니다.
graphql 메소드를 써서 질의를 할 수 있습니다.
import { graphql, GraphQLList, GraphQLNonNull, GraphQLObjectType, GraphQLSchema, GraphQLString } from 'graphql';
const User = new GraphQLObjectType({
name: 'User',
fields: {
name: {
type: new GraphQLNonNull(GraphQLString),
},
},
});
const schema = new GraphQLSchema({
query: new GraphQLObjectType({
name: 'Query',
fields: {
users: {
type: new GraphQLNonNull(new GraphQLList(new GraphQLNonNull(User))),
resolve: () => [{ name: 'Johnny' }],
},
},
}),
});
(async () => {
const result = await graphql({ schema, source: 'query { users { name } }' });
console.log(JSON.stringify(result, null, 2));
})();
실행시 다음과 같은 결과를 얻을 수 있습니다.
{
"data": {
"users": [
{
"name": "Johnny"
}
]
}
}
GraphQL 클래스의 execute 메소드를 써서 질의를 할 수 있습니다.
data class User(val name: String)
val userType = GraphQLObjectType.newObject().name("User").field(
GraphQLFieldDefinition.newFieldDefinition().name("name").type(GraphQLNonNull(GraphQLString))
).build()
val usersFetcher = DataFetcher {
listOf(User("Johnny"))
}
val codeRegistry =
GraphQLCodeRegistry.newCodeRegistry().dataFetcher(FieldCoordinates.coordinates("Query", "users"), usersFetcher)
.build()
val schema = GraphQLSchema.newSchema().query(
GraphQLObjectType.newObject().name("Query").field(
GraphQLFieldDefinition.newFieldDefinition().name("users")
.type(GraphQLNonNull(GraphQLList(GraphQLNonNull(userType))))
)
).codeRegistry(codeRegistry).build()
val graphql = GraphQL.newGraphQL(schema).build()
println(graphql.execute("query { users { name } }").toString())
다음은 그 결과입니다
ExecutionResultImpl{errors=[], data={users=[{name=Johnny}]}, dataPresent=true, extensions=null}
GraphQL.js는 한 프로세스 안에서 질의만 처리하고, 서버-클라이언트 구조에 대해서 해주는 것은 아무 것도 없습니다. API를 클라이언트에 전송하려면 별도의 라이브러리가 필요합니다. express-graphql 이나 Apollo Server를 통해 보통 사용되는 HTTP 프로토콜을 통한 GraphQL API 서빙이 가능합니다.
비슷하게 GraphQL Java도 질의 처리만 담당합니다. HTTP를 통해 서빙하려면 Spring for GraphQL 같은 모듈이 필요합니다. (Tutorial with Spring Boot | GraphQL Java 참고)
import express from 'express';
import { graphqlHTTP } from 'express-graphql';
const app = express();
app.use('/graphql', graphqlHTTP({ schema }));
app.listen(4567);
내부 코드를 보면 그다지 복잡하지 않습니다. HTTP 프로토콜에 맞춰 URL이나 body에서 query, variables등을 얻어, GraphQL.js 라이브러리로 질의하고(graphql 메소드 대신, parse, validate, execute로 나눠진 메소드를 사용하긴 합니다), HTTP 프로토콜에 맞춰 결과를 반환합니다.
HTTP 전송은 GraphQL 스펙에 의해 커버되지 않습니다. (GraphQL over HTTP 저장소에서 논의가 진행되고는 있습니다) 그래도 express-graphql 이라는 표준 구현과 Serving over HTTP 문서에 의해 큰 틀은 정의가 되어 있습니다.
HTTP 프로토콜에는 상태 코드가 있습니다. 하지만 GraphQL 특성상 그 실행 결과를 HTTP 상태 코드에 매칭하는 것은 큰 의미가 없습니다. 예를 들어 두 개의 리소스를 요청했는데 하나만 없는 경우 404 Not Found일까요, 아닐까요? 두 개의 Mutation을 실행하는데 하나는 리소스 생성, 하나는 수정일 수도 있는데 201 Create를 반환해야 할까요?
그래서 GraphQL은 보통 최소한의 상태 코드만 사용합니다.
여기까지는 비교적 명확하지만 어플리케이션 로직 수행 중 에러가 난 경우(즉 errors 객체가 있는 경우)가 애매합니다. 또 GraphQL은 부분 성공이라는 개념도 있습니다. (일부만 성공해서 data에 값이 있지만, errors도 있는 경우)
express-graphql은 data가 없는 경우 500을 반환하게 되어 있습니다. 반면에 Apollo Server는 순 에러인 경우에도 200을 반환합니다.
200 성공이 아닌 경우, GraphQL 응답이 아닐 수도 있습니다. (예를 들어 중간에 거치는 로드 밸러서에서 타임아웃 발생시 JSON이 아니였습니다) 400, 500 시 GraphQL errors 객체로 간주하고 처리하려고 했더니, JSON이 아니여서 의미 없는 에러(SyntaxError)를 보게 되는 경우를 겪었습니다.
그래서 400, 500 에러는 취급하지 못하는 에러(클라이언트를 잘못 작성했거나, 서버 접근이 안 되는 등 사용자가 처리할 수 없는 에러)인 경우로 정의했습니다. (많은 HTTP 클라이언트가 400, 500 에러시 예외를 던집니다) 반면 어플리케이션 오류(사용자 행동에 문제가 있고, 사용자가 알아야 하는 - 예를 들어 비밀번호가 틀림 -)는 일단 호출 자체는 성공으로 간주할 수 있도록 200을 반환하는 것을 규칙으로 정했습니다. 어플리케이션 오류는 그 이후에 errors 필드 존재 여부로 판단합니다.
다만 이렇게 처리한 경우 호출 자체는 성공이기 때문에 대부분의 모니터링 툴에서 에러로 잡히지 않습니다. 그래서 저희는 모니터링 툴에 던지는 데이터를 커스터마이즈 해서 이 문제를 피했습니다. (Node.js의 경우고 Java에서는 해결하지 못했습니다.) 상태 코드는 200인데 에러로 나오는 것이라서 좀 어색합니다. (이 이슈로 차후에는 규칙을 바꿀 가능성도 있습니다.)
GraphQL은 엔드포인트를 하나로 정의하고 있습니다. 기능상에 문제는 없지만 모니터링에 문제가 있습니다. 기능별로 latency나 에러율 판단이 불가능합니다.
Node.js에서 모니터링 툴을 커스터마이즈 해서 회피해보긴 했지만, 그게 불가능한 경우도 있어 완전한 해결책은 아닙니다. 또한 건드릴 수 없는 부분(예 AWS 로드 밸런서)에서의 로그 확인/모니터링이 불가능합니다.
그래서 카카오스타일에서는 클라이언트가 엔드포인트를 다르게 호출하는 것을 컨벤션으로 잡았습니다. /graphql/<operation name>
형태로 호출하면 되고, 주요 GraphQL 서버 프레임워크는 뒤에 문자열을 무시하고 동일하게 처리할 수 있습니다.
여기에 더해 마이크로서비스 간의 호출에서 operation name이 겹치는 경우도 있습니다. (예 GetProductList) 이 경우 어느 마이크로서비스에서 호출한 건지 알 수 없습니다. 그래서 마이크로서비스 간의 호출에서는 서비스명을 추가하도록 컨벤션을 정했습니다. /graphql/<service name>__<operation name>
더 복잡한 케이스도 있습니다. 저희는 API gateway 패턴을 사용하고 있는데, API gateway에서 여러 서비스를 호출할 수 있습니다. 예를 들어 클라이언트가 다음과 같이 요청했을 때
query GetUserOrderList {
user {
name
order_list {
order_number
}
}
}
user와 order라는 서비스에 각각 요청을 하게 됩니다.
{
user {
id
name
}
}
{
order_list(user_id: "1234") {
order_number
}
}
이때 각 마이크로서비스에서 어떤 식으로 요청이 온 건지 구분하기 위해서 각각 api__GetUserOrderList__user
, api__GetUserOrderList__order_list
라는 경로와 operation name을 갖도록 컨벤션을 정해서 운영하고 있습니다.