apollo-client-maven-plugin

apollo-client-maven-plugin copied to clipboard

= Apollo GraphQL Client Code Generation Maven Plugin

:project-owner: aoudiamoncef :project-name: apollo-client-maven-plugin :project-groupId: com.github.aoudiamoncef :project-artifactId: apollo-client-maven-plugin-parent :project-version: 7.0.0

image:https://github.com/{project-owner}/{project-name}/workflows/Build/badge.svg["Build Status",link="https://github.com/{project-owner}/{project-name}/actions"] image:https://img.shields.io/maven-central/v/{project-groupId}/{project-artifactId}.svg[Download,link="https://search.maven.org/#search|ga|1|g:{project-groupId} AND a:{project-artifactId}"] image:https://snyk.io/test/github/{project-owner}/{project-name}/badge.svg[Known Vulnerabilities,link=https://snyk.io/test/github/{project-owner}/{project-name}] image:https://img.shields.io/badge/License-MIT-yellow.svg[License: MIT,link=https://opensource.org/licenses/MIT]

Maven plugin that calls the https://github.com/apollographql/apollo-kotlin[Apollo Kotlin compiler] to generate your Java/Kotlin sources.

== Usage

• A simple usage example can be found in https://github.com/{project-owner}/{project-name}/tree/main/apollo-client-maven-plugin-tests[plugin tests].

• A complete project with https://github.com/{project-owner}/spring-boot-apollo-graphql[Spring Boot].

=== Apollo 2 support

• Go to support https://github.com/aoudiamoncef/apollo-client-maven-plugin/tree/support/apollo-2[branch].

=== Getting Started

. Add the apollo runtime library to your project's dependencies: + [source,xml]

. Add the code generator plugin to your project's build: + [source,xml,subs="attributes+"]

. Create a file src/main/graphql/SERVICE_NAME/schema.json with the JSON results of an https://gist.github.com/aoudiamoncef/a59527016e16a2d56309d62e01ff2348[introspection query], OR you can automatically generate this file by setting introspection.enabled to true and endpointUrl to your GraphQL endpoint. At build time, the plugin will query the server and install this file per the value of schemaFile. . Create files for each query you'd like to generate classes for under src/main/graphql/SERVICE_NAME: .. Query file names must match the name of the query they contain .. Query files must end with .graphql OR .gql by default. .. Any subdirectories under src/main/graphql/SERVICE_NAME are treated as extra package names to append to schemaPackageName in the plugin config. . Run mvn generate-sources to generate classes for your queries.

. If you run into compilation issues such as package com.apollographql.apollo3.api does not exist, you may need to explicitly add the following runtime libraries to your pom.xml + [source,xml]

=== Configuration Options

All plugin configuration properties and their defaults:

[source,xml]

    <!--Minimal configuration-->
    <lahzouz-min-api>
        <compilationUnit>
            <name>lahzouz</name>
        </compilationUnit>
    </lahzouz-min-api>

    <!--Auto configuration-->
    <lahzouz></lahzouz>
</services>

==== Custom Types

To use https://www.apollographql.com/docs/kotlin/essentials/custom-scalars[custom Scalar Types] you need to define mapping configuration then register your custom adapter:

[source,xml]

Implementation of a custom adapter for java.time.LocalDate:

[source,java]

import com.apollographql.apollo3.api.Adapter; import com.apollographql.apollo3.api.CustomScalarAdapters; import com.apollographql.apollo3.api.json.JsonReader; import com.apollographql.apollo3.api.json.JsonWriter; import org.jetbrains.annotations.NotNull;

import java.io.IOException; import java.time.LocalDate; import java.time.format.DateTimeFormatter;

public class LocalDateGraphQLAdapter implements Adapter<LocalDate> { private static final DateTimeFormatter dateFormatter = DateTimeFormatter.ISO_DATE;

@Override
public LocalDate fromJson(@NotNull final JsonReader reader, @NotNull final CustomScalarAdapters customScalarAdapters) throws IOException {
    String dateString = reader.nextString();
    return LocalDate.parse(dateString, dateFormatter);
}

@Override
public void toJson(@NotNull final JsonWriter writer, @NotNull final CustomScalarAdapters customScalarAdapters, final LocalDate value) throws IOException {
    writer.value(value.format(dateFormatter));
}

}

[source,xml]

==== Test Sources

To generate sources for tests: [source,xml]

=== Using Apollo Client

See https://www.apollographql.com/docs/kotlin/[documentation]