REST API 구축 경험이 4년인 소프트웨어 엔지니어로서 저는 REST가 테이블에 제공하는 단순성과 안정성을 항상 높이 평가해 왔습니다. 엔드포인트를 설계하든 응답을 구조화하든 REST는 제가 선호하는 솔루션이었습니다.
그러나 올해 초 모든 것이 바뀌었습니다. 저는 크고 복잡하며 상호 연관된 데이터 소스를 처리해야 하는 프로젝트에 뛰어들라는 임무를 받았습니다. 이는 단순히 사용자 목록을 가져오거나 단일 레코드를 업데이트하는 것이 아니라 유연성, 정확성 및 REST가 제공하기 힘든 규모의 효율성을 제공합니다.
GraphQL을 입력하세요. ?
처음에는 회의적이었습니다. 깨지지 않은 것을 왜 고치나요? 하지만 더 깊이 파고들수록 GraphQL은 프로젝트의 요구 사항을 충족할 뿐만 아니라 API에 대한 제가 생각하는 방식을 재정의했습니다. 다음과 같은 기능을 제공합니다.
GraphQL은 빠르게 단순한 솔루션 이상의 역할을 했으며 API 디자인에 대한 새로운 표준이 되었습니다.
그렇지만 이 글의 목적은 GraphQL을 선호하여 REST API의 평판을 떨어뜨리지 않는 것입니다. 사실 저는 이 둘이 서로를 아름답게 보완할 수 있다고 믿습니다. REST는 내 프로젝트에서 여전히 중요한 역할을 하며, 특히 GraphQL 쿼리보다 전용 REST 엔드포인트가 더 실용적인 특정 사용 사례의 경우 더욱 그렇습니다.
이 기사에서 공유할 내용은 다음과 같습니다.
GraphQL에 대해 호기심이 있는 초보자이든 전환을 원하는 숙련된 엔지니어이든 관계없이 이 기사에서는 GraphQL이 주목할만한 이유와 REST를 완전히 대체하지 않고도 프로젝트를 변화시킬 수 있는 방법을 보여줍니다.
수년 동안 REST API는 제 빵과 버터였습니다. 저는 강력한 시스템을 구축하고, 데이터를 관리하고, 기능을 제공하기 위해 이들에게 의존했습니다. 하지만 내 프로젝트가 점점 복잡해지면서 균열이 나타나기 시작했습니다.
반복적으로 발생하는 불만 중 하나는 데이터를 너무 많이 가져오거나 적게 가져오는 것이었습니다. 필요하지 않은 정보를 너무 많이 얻거나 내가 한 모든 정보를 얻으려면 여러 번 요청해야 했습니다. 복잡성에 추가된 수많은 엔드포인트를 관리하면 업데이트와 유지 관리가 번거로워집니다.
올해 초 저는 상호 연결된 대규모 데이터 소스를 처리해야 하는 프로젝트에 참여했습니다. REST는 이에 맞지 않았고 팀에서는 GraphQL을 제안했습니다. 처음에는 회의적이었지만 단일 엔드포인트에서 필요한 것이 무엇인지 정확하게 쿼리할 수 있다는 사실이 흥미를 끌었습니다.
GraphQL을 시작하는 데 어려움이 없지는 않았습니다. 스키마와 확인자는 어렵게 느껴졌지만 그것이 제공하는 유연성과 제어력 덕분에 노력할 가치가 있었습니다. 시간이 지남에 따라 REST가 직면한 문제점을 얼마나 원활하게 해결했는지 깨달았습니다.
저는 여전히 특정 사례에 REST를 사용하지만 복잡하고 동적인 데이터 요구 사항을 처리하기 위해 GraphQL을 선호하는 도구가 되었습니다.
GraphQL에 대해 더 자세히 살펴보면서 몇 가지 주요 이점이 눈에 띄어 전환이 매우 간편해졌습니다.
여정에 어려움이 있었던 것은 아니었지만, 여러 단계로 나누어 전환을 관리하기 쉽게 만들었습니다.
핵심 개념을 익히는 것부터 시작했습니다.
이러한 기본적인 이해는 제가 첫 GraphQL 서버를 구축하는 데 핵심이었습니다.
실습을 위해 Node.js와 Apollo Server를 사용하여 간단한 서버를 구축했습니다. 프로세스는 다음과 같습니다.
처음으로 작동하는 모습을 보니 짜릿하셨나요? 그 노력이 가치 있다고 느껴지게 만들었습니다.
다음 단계는 GraphQL을 기존 REST 기반 프로젝트에 통합하는 것이었습니다. 저는 점진적인 접근 방식을 따랐습니다.
이 하이브리드 접근 방식을 통해 기존 기능을 방해하지 않고 GraphQL을 점진적으로 출시할 수 있었습니다.
GraphQL을 시작하는 것은 생각보다 간단합니다. Node.js와 Apollo Server를 사용하여 기본 서버를 설정하는 빠른 가이드는 다음과 같습니다.
Node.js 프로젝트를 초기화하고 필요한 패키지를 설치하는 것으로 시작하세요.
npm init -y npm install apollo-server graphql
index.js라는 파일을 만들고 다음 코드를 추가하세요.
const { ApolloServer, gql } = require('apollo-server');
// Simulated user data
const users = [
{ id: '1', name: 'John Doe', email: 'john@example.com' },
{ id: '2', name: 'Jane Smith', email: 'jane@example.com' },
{ id: '3', name: 'Alice Johnson', email: 'alice@example.com' },
];
// Define schema
const typeDefs = gql`
type User {
id: ID
name: String
email: String
}
type Query {
users: [User]
user(id: ID!): User
}
`;
// Define resolvers
const resolvers = {
Query: {
users: () => users,
user: (_, { id }) => users.find((user) => user.id === id),
},
};
// Create server
const server = new ApolloServer({ typeDefs, resolvers });
// Start server
server.listen().then(({ url }) => {
console.log(`? Server ready at ${url}`);
});
다음을 사용하여 서버를 시작하세요.
node index.js
브라우저나 GraphQL과 같은 도구에서 제공된 URL을 열고 쿼리를 테스트하세요.
모든 사용자 쿼리:
query {
users {
id
name
email
}
}
ID별 단일 사용자 조회:
query {
user(id: "1") {
name
email
}
}
축하해요?? 방금 첫 번째 GraphQL 서버를 구축했습니다!
GraphQL로 전환하면서 귀중한 교훈을 얻었습니다.
GraphQL로 전환하는 것은 단순히 도구를 바꾸는 것이 아니라 데이터와 상호 작용하는 방식을 다시 생각하는 것입니다. 작게 시작하고, 실험하고, 여행을 즐겨보세요!
REST와 GraphQL 중 하나를 선택할 때 주요 차이점을 이해하면 프로젝트에 적합한 선택을 하는 데 도움이 될 수 있습니다. 간단한 분석은 다음과 같습니다.
| Feature | REST API | GraphQL |
|---|---|---|
| Data Fetching | Fixed data structure for endpoints; can lead to over-fetching or under-fetching. | Flexible queries; fetch exactly what you need. |
| Endpoint Management | Multiple endpoints for different resources. | Single endpoint for all queries and mutations. |
| Flexibility | Limited flexibility; requires custom endpoints for specific data needs. | Highly flexible; client defines data requirements. |
| Type Safety | Relies on documentation; no built-in type enforcement. | Strongly-typed schema ensures predictable data. |
| Error Handling | Custom error formats; inconsistent across APIs. | Standardized error responses from schema validation. |
| Tooling | Varied and often endpoint-specific tools. | Rich ecosystem with tools like Apollo, GraphQL, and Relay. |
REST API는 안정적이고 널리 지원되지만 GraphQL은 복잡하고 상호 연관된 데이터와 유연성이 필요한 시나리오에서 빛을 발합니다.
이전 기사에서 차이점을 자세히 알아보세요
REST에서 GraphQL로 전환한 것은 제게 획기적인 변화였습니다. 유연성, 효율성 및 향상된 개발자 경험 덕분에 내 프로젝트는 더욱 강력해지고 확장 가능해졌습니다. 즉, 저는 REST API와 GraphQL이 공존하여 다양한 사용 사례에 대해 서로를 보완할 수 있다고 굳게 믿습니다.
전환을 고려하고 있다면 소규모로 시작하여 실험하고 점진적으로 GraphQL을 스택에 통합하는 것이 좋습니다. 이는 착수할 가치가 있는 여정이며, 여러분이 어떻게 이를 자신만의 것으로 만들 수 있을지 기대됩니다.
다음은 GraphQL을 이해하는 데 도움이 되는 몇 가지 도구와 가이드입니다.
여기 벤틸 ?
REST에서 GraphQL로 전환했습니까, 아니면 전환을 고려하고 있습니까? 그 과정에서 어떤 어려움이나 성공을 경험했나요? 아래 댓글을 통해 여러분의 생각, 질문, 경험을 자유롭게 공유해 주세요. 함께 성장하고 배워요! ?
위 내용은 REST에서 GraphQL로: 전환한 이유와 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!
![[웹 프런트엔드] Node.js 빠른 시작](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
