GraphQL
La solution la plus commune pour consommer des APIs GraphQL est le package Apollo Angular apollo-angular.
Profitez des schematics d'apollo-angular !
yarn ng add apollo-angular
A défaut de disposer d'un mécanisme de configuration dynamique de votre application Angular, mettez en place l'URI de votre API GraphQL via les environnements Angular (fichiers environments/environment*.ts)
Le plugin GraphQL d'IntelliJ / WebStorm facilite la consommation d'APIs GraphQL grâce à la découverte automatique du schéma puis l'autocomplétion.
https://plugins.jetbrains.com/plugin/8097-js-graphql
Bien qu'il soit possible d'utiliser directement les méthodes query, mutate et watchQuery du service Apollo pour exécuter des queries et mutations, depuis n'importe quel endroit de votre application, il est préférable d'utiliser des services dédiés à chaque query ou mutation qui héritent respectivement des classes Query et Mutation.
@Injectable({providedIn: 'root'})export class UserListQuery extends Query<{ users: User[] }> {document = gql`query UserList {users {idfirstNamelastName}}`;}
Ce service peut ensuite être utilisé ainsi :
this._userListQuery.fetch().subscribe(({data}) => this.userList = data.users);
Le service dispose également d'une méthode watch qui vous permet d'observer les changements en cas d'activation du polling (option pollInterval) ou encore en cas de mise à jour du cache local par exemple.
Dans tous les cas, n'oubliez pas d'unsubscribe de l'Observable retourné ou d'utiliser RxScavenger.
https://github.com/wishtack/wishtack-steroids/tree/master/packages/rx-scavenger
Pensez à utiliser les fragments pour factoriser vos queries.
https://www.apollographql.com/docs/angular/features/fragments.html
