Premiers pas avec le SDK Maven Alfresco, partie 2

Nous travaillons avec votre projet dans l'IDE

• Fichier, importation, Maven, projets Maven existants. Cliquez sur Suivant.
  
• Spécifiez le répertoire contenant le répertoire someco-mvn-tutorial-repo. Eclipse vérifiera ce répertoire et affichera votre projet dans la liste des projets. Assurez-vous que la case en regard du nom du projet est cochée et cliquez sur Suivant.
  
• Eclipse affichera les paramètres du panneau de plug-in Maven. Vous pouvez l’ignorer en toute sécurité maintenant. Cliquez sur Terminer.
  

1. Faites un clic droit sur l'erreur et sélectionnez "Quick Fix".
2. En sélectionnant "Marquer définitivement la version de l'ensemble d'objectifs dans pom.xml comme ignorée dans la version Eclipse". Prêt.
3. Sélectionnez l'emplacement où se trouve votre POM (le mien est com.someco : someco-mvn-tutorial-repo : 1.0-SNAPSHOT) et cliquez sur OK.

1. Faites un clic droit sur le projet et sélectionnez Maven, Mettre à jour le projet.
2. Assurez-vous que le projet est sélectionné et cliquez sur OK.

Comprendre la structure du projet

• pom.xml À la racine du projet, vous voyez pom.xml. Il indique à Maven tout ce qu'il doit savoir sur votre projet. Vous souvenez-vous de certains paramètres que vous avez oubliés lors de la création d'un projet à partir d'un modèle ? Vous pouvez apporter des modifications aux paramètres ici. Par exemple, la version 1.1.1 de l'archétype vous permet de travailler avec Alfresco Community Edition version 4.2.e. Si vous souhaitez travailler avec une version différente, modifiez simplement quelques propriétés et dites à Maven de les mettre à jour et il s'occupera du reste.
• src/main/java C'est ici que vous devez créer vos propres packages pour organiser votre code Java. Des éléments tels que des classes d'exécution d'actions personnalisées, des comportements personnalisés et des contrôleurs Java pour les scripts Web sont ici. Si vous ne savez pas ce que c'est, ne vous inquiétez pas, des tutoriels sont disponibles ici . Ces fichiers seront éventuellement placés dans un JAR. Lorsque AMP est installé dans Alfresco WAR, le JAR se trouvera dans WEB-INF/lib .
• src/test Tout ce qui se trouve dans src/test est lié à l'exécution des tests. Les tests unitaires eux-mêmes se trouvent dans src/test/java . Toutes les ressources nécessaires à ces classes seront dans src/test/resources. Dans src/test/properties/local, vous verrez un fichier alfresco-global.properties . Si vous connaissez déjà Alfresco, vous savez qu'il est utilisé pour configurer le serveur Alfresco. Dans ce cas, cela sert uniquement à exécuter le serveur intégré, à des fins de tests.
• src/main/amp Tout le reste se trouve quelque part dans cette partie du projet. La structure AMP est si bien documentée que je ne souhaite pas la dupliquer ici. Je me contenterai d'en rappeler les points principaux :
  
  • Le fichier module.properties indique à Alfresco ce qu'il doit savoir sur AMP, comme son ID, sa version, la version minimale et maximale d'Alfresco requise pour exécuter AMP, ainsi que tout autre AMP ayant les mêmes dépendances.
  • Le répertoire config/alfresco/module/someco-mvn-tutorial-repo est le cœur d'AMP. L'endroit où vous placerez les configurations de fichiers Spring XML, le modèle de contenu des fichiers XML et la configuration de l'interface utilisateur. Comme vous le verrez plus tard, je préfère séparer les sous-répertoires pour chacune de ces choses.
  • Si votre module inclut des scripts Web ou des workflows, ils ne sont pas contenus dans le répertoire des modules. Au lieu de cela, ils se trouvent dans config/alfresco/extension/templates/webscripts et config/alfresco/extension/workflows .
  • Votre module peut inclure des ressources client qui doivent être déployées à la racine de l'application Web. Ils se trouvent dans src/main/amp/web dans les répertoires css, jsp, scripts et images.

Créer un projet adapté à l'accès Share

Dépendances générales du projet

Cible de GUERRE

Essayons ceci : Créer un projet Share à l'aide d'un archétype

1. Fichier, nouveau projet Maven.
2. Sélectionnez le répertoire qui contient le répertoire du projet "repo", cliquez sur Suivant.
   
3. Cliquez sur Configurer et nous pouvons ajouter le répertoire Alfresco à la liste.
   
4. Cliquez sur Ajouter un catalogue distant
5. Sélectionnez "https://artifacts.alfresco.com/nexus/content/groups/public/archetype-catalog.xml" comme fichier de catalogue. Sélectionnez la description "Archétypes Alfresco". Ensuite, cliquez sur OK et à nouveau sur OK plus près du panneau Préférences.
   
6. Sélectionnez maintenant "Alfresco Archetypes" dans le répertoire et vous verrez un tas d'archétypes dans la liste.
7. Sélectionnez "org.alfresco.maven.archetype" et les deux mêmes archétypes apparaîtront dans le filtre comme au début du tutoriel.
8. Sélectionnez alfresco-amp-archetype et cliquez sur Suivant.
   
9. Sélectionnez "com.someco" pour groupId, "someco-mvn-tutorial-share" comme artificialId et remplacez alfresco_target_amp_client_war par "share". Cliquez sur Terminer.
   

Comprendre la structure du répertoire Share Access

Lancement des tests internes sur Share

cd someco-mvn-tutorial-repo
test d'intégration mvn -Pamp-to-war

cd someco-mvn-tutorial-share
test d'intégration mvn -Pamp-to-war -Dmaven.tomcat.port=8081

Gestion des dépendances

Hiérarchie des dépendances dans Eclipse Une autre option. Vous pouvez voir la hiérarchie des dépendances en exécutant :

dépendance mvn: liste

Ainsi, pour ajouter des scripts Web basés sur Java à votre projet Share, nous devons ajouter spring-webscripts en tant que dépendance. Vous pouvez le faire en éditant pom.xml comme ceci :

<dépendance>
    <groupId>org.springframework.extensions.surf</groupId>
    <artifactId>spring-webscripts</artifactId>
    <version>1.2.0-M14</version>
    <scope>fourni</scope>
</dépendance>

Désormais, les scripts Web basés sur Java pourront trouver leur classe parent - DeclarativeWebScript.
Vous vous demandez peut-être comment vous saviez que la classe DeclarativeWebScript était incluse dans l'artefact spring-webscripts. Eh bien, par exemple, après l'avoir trouvé en allant sur http://artifacts.alfresco.com . Vous pouvez effectuer une recherche par classe et vous verrez tous les artefacts qui la contiennent.

Autres sujets d'étude indépendante

Vous savez maintenant comment utiliser le SDK Alfresco Maven pour créer des projets et comme référentiel Alfresco et configurer Alfresco Share. Si vous êtes nouveau dans le développement d'Alfresco, j'espère que vous conviendrez qu'il est très facile de monter un projet pour commencer. Si vous avez déjà découvert Alfresco mais que vous utilisez toujours les anciens SDK, j'espère que cela vous motivera à passer au nouveau SDK pour créer vos AMP.
De nombreux sujets n'ont pas été abordés dans ce didacticiel. Je vous les laisse explorer à votre propre discrétion. En voici quelques uns:

• Le SDK Alfresco Maven prend en charge le rechargement dynamique des classes lorsqu'il est utilisé conjointement avec un outil appelé JRebel .
• Ce didacticiel couvre l'archétype AMP. Mais le SDK Alfresco Maven inclut un autre archétype appelé All-in-One. Cet archétype vous offre une installation Alfresco complète incluant SOLR.
• Alfresco Maven SDK est pris en charge dans Community Edition et Enterprise Edition. Si vous avez besoin d'aide pour accéder aux artefacts dans Enterprise Edition, contactez le support Alfresco.

Où trouver plus d'informations

• La documentation officielle du SDK Alfresco Maven se trouve sur http://docs.alfresco.com .
• Une documentation plus détaillée sur le SDK Alfresco Maven est disponible sur crafts.alfresco.com .
• Présentation de Gab à l'Alfresco Summit Test-Driven, développement rapide et livraison continue des solutions Alfresco
• Instant Apache Maven Starter Le livre de Maurizio Turatti et Maurizio Pillitu peut être une excellente ressource si vous souhaitez en savoir plus sur Apache Maven.
• Présentation de Premiers pas avec le développement Alfresco par Gethin James du Sommet Alfresco
• Alfresco Developer Series sur ECM Architect contient des didacticiels gratuits sur les modèles de contenu personnalisés, les actions, les comportements, les flux de travail et les scripts Web.

<= Partie 1