React에서 graphQL 요청을 위한 Apollo 클라이언트 설정

소개

이 문서에서는 ApolloClient 라이브러리를 사용하여 graphQL 요청에 대한 React 앱을 설정하는 방법을 보여줍니다. 목표는 앱을 구성하는 방법을 보여주고 요청하는 방법의 예를 제공하는 것입니다.

라이브러리

• @apollo/client: 상태 관리를 활성화하고 graphQL 요청을 수행하는 lib
• graphql: GraphQL 쿼리를 구문 분석할 수 있는 lib

프로젝트에 libs를 추가하려면:

원사 추가 @apollo/client graphql --dev

구성

아래에서는 graphQL 요청을 활성화하기 위해 ApolloClient를 구성하는 방법을 보여드리겠습니다.
먼저, 자식으로 포함된 모든 항목이 graphQL 요청을 할 수 있도록 ApolloClient 컨텍스트가 생성됩니다.

import {
  ApolloClient,
  ApolloProvider,
  HttpLink,
  InMemoryCache
} from '@apollo/client'

function ExampleApolloProvider({ children, token, uri }) {
  const httpLink = new HttpLink({
    uri: uri,
    headers: {
      authorization: `Bearer ${token}`,
    },
  })

  const client = new ApolloClient({
    cache: new InMemoryCache(),
    link: httpLink,
  })

  return <ApolloProvider client={client}>{children}</ApolloProvider>
}

export { ExampleApolloProvider as ApolloProvider }

const 클라이언트에서는 ApolloClient가 초기화되어 ApolloClient가 쿼리 결과를 캐시하는 데 사용하는 InMemoryCache 인스턴스를 사용하여 정의된 링크와 캐시를 통해 엔드포인트를 지정합니다.
httpLink에서는 요청에 필요한 헤더와 함께 graphQL API의 URI가 설정됩니다. 이 예에서는 Bearer 토큰이 사용됩니다.
마지막으로 앱 내에서 사용할 수 있도록 반환 및 내보내기가 정의되었습니다.

로그인 후 토큰이 localStorage에 저장되는 앱이고 앱 전체에서 graphQL 요청을 활성화하는 것이 목표라는 점을 고려하면 이전 파일에 정의된 ApolloProvider를 사용합니다.

import { ApolloProvider } from './contexts/ApolloContext'
import AppContent from './components/AppContent'

const token = localStorage.getItem('@tokenId')
// endpoint of your graphQL api
const graphqlURI = 'https://www.example.com'

const App = () => {
  return (
    <ApolloProvider token={token} uri={graphqlURI}>
      <AppContent />
    </ApolloProvider>
  )
}

이 예에서는 토큰이 localStorage에서 검색되고(이 경우 @tokenId 키로 저장된 것처럼), uri는 동일한 파일 내에 정의된 다음 ApolloProvider에 전달됩니다. AppContent는 ApolloProvider의 하위 요소로 전달됩니다. 즉, AppContent에 포함된 모든 것, 즉 전체 앱이 graphQL 요청을 할 수 있다는 의미입니다.
실제로 테스트 및 프로덕션 환경이 서로 다른 경우 graphqlURI는 환경 변수에서 나올 수 있으며 이에 따라 각 환경의 URI가 정의됩니다.

사용자의 이름과 직업을 반환하는 API가 노출하는 user라는 쿼리로 시작하여 다음과 같은 쿼리로 파일이 정의됩니다.

import { gql } from '@apollo/client'

const GET_USER = gql`
  query GetUser {
    user {
      name
      occupation
    }
  }
`

export default GET_USER

GET_USER는 React 앱에서 쿼리가 호출되는 방식에 해당하고, user는 API에서 사용할 쿼리의 이름입니다.

AppContent를 정의하는 파일에서 GET_USER 쿼리가 호출되고 해당 반환이 사용됩니다.

import {
  ApolloClient,
  ApolloProvider,
  HttpLink,
  InMemoryCache
} from '@apollo/client'

function ExampleApolloProvider({ children, token, uri }) {
  const httpLink = new HttpLink({
    uri: uri,
    headers: {
      authorization: `Bearer ${token}`,
    },
  })

  const client = new ApolloClient({
    cache: new InMemoryCache(),
    link: httpLink,
  })

  return <ApolloProvider client={client}>{children}</ApolloProvider>
}

export { ExampleApolloProvider as ApolloProvider }

useQuery 후크는 GET_USER에 정의된 쿼리를 실행하여 요청이 진행 중인 동안 로딩을 true로 반환하고, 요청이 실패하면 오류를 반환하고, 요청이 성공적으로 완료되면 데이터를 반환합니다. 데이터가 반환될 때까지 화면에 Loading... 메시지가 표시됩니다. 요청이 오류로 종료되면 요청 실패 메시지가 표시됩니다. 요청이 성공하면 화면에 해당 사용자의 이름과 직업(이름과 직업)이 표시됩니다.
이런 방식으로 ApolloClient는 graphQL 요청에 대해 구성되고 사용할 준비가 됩니다.

결론

React 앱이 graphQL을 호출할 수 있도록 ApolloClient를 구성하는 방법을 보여주고 컨텍스트 정의, 이 컨텍스트의 사용법, 쿼리 실행 방법의 예를 보여주는 것이 아이디어였습니다.
더 자세히 알아보고 싶은 분들을 위한 ApolloClient 문서 링크는 다음과 같습니다.

위 내용은 React에서 graphQL 요청을 위한 Apollo 클라이언트 설정의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!