Application Android

[AEM Headless as a Cloud Service]{class="badge informative"}

Découvrez les fonctionnalités découplées d’Adobe Experience Manager (AEM) grâce aux exemples d’applications. Cette application Android explique comment interroger du contenu à l’aide des API GraphQL d’AEM. Le client AEM Headless pour Java est utilisé pour exécuter les requêtes GraphQL et mapper les données aux objets Java afin d’alimenter l’application.

Afficher le code source sur GitHub

Prérequis prerequisites

Les outils suivants doivent être installés localement :

Configuration requise d’AEM

L’application Android fonctionne avec les options de déploiement AEM suivantes. Tous les déploiements nécessitent que la version v3.0.0 ou supérieure du site WKND soit installée.

L’application Android est conçue pour se connecter à un environnement de publication AEM. Toutefois, elle peut extraire du contenu à partir de l’instance de création AEM si l’authentification est fournie dans la configuration de l’application Android.

Utilisation

Se connecter à des environnements AEM

Si vous vous connectez à un environnement de création AEM, une autorisation est obligatoire. L’AEMHeadlessClientBuilder permet d’utiliser des authentifications par jeton. Pour utiliser l’authentification par jeton, mettez à jour le générateur de client dans AdventureLoader.java et AdventuresLoader.java :

/* Comment out basicAuth
 if (user != null && password != null) {
   builder.basicAuth(user, password);
 }
*/

// use token-authentication where `token` is a String representing the token
builder.tokenAuth(token)

Le code

Vous trouverez ci-dessous un bref résumé des fichiers et du code importants utilisés pour alimenter l’application. Le code complet se trouve sur GitHub.

Requêtes persistantes

En suivant les bonnes pratiques d’AEM Headless, l’application iOS utilise les requêtes persistantes GraphQL d’AEM pour interroger les données d’Adventure. L’application utilise deux requêtes persistantes :

# Retrieves a list of all adventures
{
    adventureList {
        items {
            _path
            slug
            title
            price
            tripLength
            primaryImage {
                ... on ImageRef {
                _dynamicUrl
                _path
                }
            }
        }
    }
}

# Retrieves an adventure Content Fragment based on it's slug
# Example query variables:
# {"slug": "bali-surf-camp"}
# Technically returns an adventure list but since the the slug
# property is set to be unique in the CF Model, only a single CF is expected

query($slug: String!) {
  adventureList(filter: {
        slug: {
          _expressions: [ { value: $slug } ]
        }
      }) {
    items {
      _path
      title
      slug
      activity
      adventureType
      price
      tripLength
      groupSize
      difficulty
      price
      primaryImage {
        ... on ImageRef {
          _dynamicUrl
          _path
        }
      }
      description {
        json
        plaintext
      }
      itinerary {
        json
        plaintext
      }
    }
    _references {
      ...on AdventureModel {
        _path
        slug
        title
        price
        __typename
      }
    }
  }
}

Exécuter la requête persistante GraphQL

Les requêtes persistantes AEM sont exécutées sur GET HTTP. Par conséquent, la variable Client AEM Headless pour Java est utilisée pour exécuter les requêtes GraphQL persistantes sur AEM et charger le contenu de l’Adventure dans l’application.

Chaque requête conservée possède une classe « loader » correspondante, qui appelle de manière asynchrone le point d’entrée AEM HTTP GET et renvoie les données de l’Adventure à l’aide du modèle de données défini.

//AdventuresLoader.java

public static final String PERSISTED_QUERY_NAME = "/wknd-shared/adventures-all";
...
AEMHeadlessClientBuilder builder = AEMHeadlessClient.builder().endpoint(config.getContentApiEndpoint());

// Optional authentication for basic auth
String user = config.getContentApiUser();
String password = config.getContentApiPassword();

if (user != null && password != null) {
    builder.basicAuth(user, password);
}

AEMHeadlessClient client = builder.build();
// run a persistent query and get a response
GraphQlResponse response = client.runPersistedQuery(PERSISTED_QUERY_NAME);

Modèles de données de réponse GraphQL data-models

Adventure.java est un POJO Java initialisé avec les données JSON de la requête GraphQL. Il modélise une Adventure à utiliser dans les vues de l’application Android.

Vues

L’application Android utilise deux vues pour présenter les données des Adventures dans l’expérience mobile.

Images distantes

loader/RemoteImagesCache.java est une classe d’utilitaire qui permet de préparer des images distantes dans un cache afin qu’elles puissent être utilisées avec les éléments de l’interface utilisateur Android. Le contenu des Adventures référence des images dans AEM Assets via une URL et cette classe est utilisée pour afficher ce contenu.

Ressources supplémentaires