Comenzando con Maven Alfresco SDK parte 2

Trabajamos con tu proyecto en el IDE

• Archivo, Importación, Maven, Proyectos Maven existentes. Haga clic en Siguiente.
  
• Especifique el directorio que contiene el directorio someco-mvn-tutorial-repo. Eclipse comprobará este directorio y mostrará su proyecto en la lista de proyectos. Asegúrese de que la casilla de verificación junto al nombre del proyecto esté seleccionada y haga clic en Siguiente.
  
• Eclipse mostrará la configuración del panel de complementos de Maven. Puedes ignorarlo con seguridad ahora. Haga clic en Finalizar.
  

1. Haga clic derecho en el error y seleccione "Solución rápida".
2. Seleccionar "Marcar permanentemente la versión del conjunto de objetivos en pom.xml como ignorada en la compilación de Eclipse". Listo.
3. Seleccione la ubicación donde se encuentra su POM (el mío es com.someco: someco-mvn-tutorial-repo: 1.0-SNAPSHOT) y haga clic en Aceptar.

1. Haga clic derecho en el proyecto y seleccione Maven, Actualizar proyecto.
2. Asegúrese de que el proyecto esté seleccionado y haga clic en Aceptar.

Comprender la estructura del proyecto.

• pom.xml En la raíz del proyecto verás pom.xml. Le dice a Maven todo lo que necesita saber sobre su proyecto. ¿Recuerdas algunas configuraciones que olvidaste al crear un proyecto a partir de una plantilla? Puede realizar cambios en la configuración aquí. Por ejemplo, la versión 1.1.1 del arquetipo le permite trabajar con la versión 4.2.e de Alfresco Community Edition. Si desea trabajar con una versión diferente, simplemente cambie algunas propiedades y dígale a Maven que las actualice y él se encargará del resto.
• src/main/java Aquí es donde debes crear tus propios paquetes para organizar tu código Java. Cosas como clases de ejecución de acciones personalizadas, comportamientos personalizados y controladores Java para scripts web están aquí. Si no sabes qué es todo esto, no te preocupes, hay tutoriales disponibles aquí . Estos archivos eventualmente se colocarán en un JAR. Cuando AMP se instala en Alfresco WAR, el JAR estará dentro de WEB-INF/lib .
• src/test Todo lo que hay dentro de src/test está relacionado con la ejecución de pruebas. Las pruebas unitarias en sí se encuentran en src/test/java . Todos los recursos necesarios para estas clases estarán en src/test/resources. Dentro de src/test/properties/local verá un archivo alfresco-global.properties . Si ya sabes algo sobre Alfresco, sabrás que se utiliza para configurar el servidor de Alfresco. En este caso, esto sólo se utiliza para ejecutar el servidor integrado, con fines de prueba.
• src/main/amp Todo lo demás está en algún lugar de esta parte del proyecto. La estructura de AMP está tan bien documentada que no quiero duplicarla aquí. Sólo señalaré los puntos principales:
  
  • El archivo module.properties le dice a Alfresco lo que necesita saber sobre AMP, como su ID, versión, versión mínima y máxima de Alfresco requerida para ejecutar AMP y cualquier otro AMP con las mismas dependencias.
  • El directorio config/alfresco/module/someco-mvn-tutorial-repo es el corazón de AMP. El lugar donde colocará las configuraciones del archivo Spring XML, el modelo de contenido de los archivos XML y la configuración de la interfaz de usuario. Como verá más adelante, prefiero separar subdirectorios para cada una de estas cosas.
  • Si su módulo incluye scripts web o flujos de trabajo, no están contenidos en el directorio de módulos. En su lugar, se encuentran en config/alfresco/extension/templates/webscripts y config/alfresco/extension/workflows .
  • Su módulo puede incluir recursos del cliente que deben implementarse en la raíz de la aplicación web. Están ubicados en src/main/amp/web en los directorios css, jsp, scripts e imágenes.

Creando un proyecto adaptado para el acceso Compartir

Dependencias Generales del Proyecto

Objetivo de guerra

Intentemos esto: crear un proyecto compartido usando un arquetipo

1. Archivo, nuevo proyecto Maven.
2. Seleccione el directorio que contiene el directorio del proyecto "repo", haga clic en Siguiente.
   
3. Haga clic en Configurar y podremos agregar el directorio de Alfresco a la lista.
   
4. Haga clic en Agregar catálogo remoto
5. Seleccione "https://artifacts.alfresco.com/nexus/content/groups/public/archetype-catalog.xml" como archivo de catálogo. Seleccione la descripción "Arquetipos de Alfresco". Luego, haga clic en Aceptar y en Aceptar nuevamente más cerca del panel de Preferencias.
   
6. Ahora seleccione "Arquetipos de Alfresco" en el directorio y verá varios arquetipos en la lista.
7. Seleccione "org.alfresco.maven.archetype" y aparecerán los mismos dos arquetipos en el filtro que al comienzo del tutorial.
8. Seleccione alfresco-amp-archetype y haga clic en Siguiente.
   
9. Seleccione "com.someco" como groupId, "someco-mvn-tutorial-share" como artefactoId y cambie alfresco_target_amp_client_war a "share". Haga clic en Finalizar.
   

Comprender la estructura del directorio Share Access

Lanzamiento de pruebas internas en Share

cd someco-mvn-tutorial-repo
prueba de integración mvn -Pamp-to-war

cd someco-mvn-tutorial-compartir
prueba de integración mvn -Pamp-to-war -Dmaven.tomcat.port=8081

Gestión de dependencia

Jerarquía de dependencias en Eclipse Otra opción. Puede ver la jerarquía de dependencia ejecutando:

dependencia mvn: lista

Entonces, para agregar scripts web basados ​​en Java a su proyecto Share, necesitamos agregar spring-webscripts como dependencia. Puedes hacer esto editando pom.xml de esta manera:

<dependencia>
    <groupId>org.springframework.extensions.surf</groupId>
    <artifactId>scripts web de primavera</artifactId>
    <versión>1.2.0-M14</versión>
    <ámbito>proporcionado</ámbito>
</dependencia>

Ahora los scripts web basados ​​en Java podrán encontrar su clase principal: DeclarativeWebScript.
Quizás se pregunte cómo supo que la clase DeclarativeWebScript estaba incluida en el artefacto spring-webscripts. Bueno, por ejemplo, habiéndolo encontrado yendo a http://artifacts.alfresco.com . Puedes buscar por clase y se te mostrarán todos los artefactos que la contienen.

Otros temas para estudio independiente.

Ahora sabe cómo utilizar el SDK de Alfresco Maven para crear proyectos y como repositorio de Alfresco y configurar Alfresco Share. Si es nuevo en el desarrollo de Alfresco, espero que esté de acuerdo en que es muy fácil armar un proyecto para comenzar. Si ya se ha familiarizado con Alfresco pero todavía utiliza los SDK antiguos, espero que esto le motive a cambiar al nuevo SDK para crear sus AMP.
Hay muchos temas que no se trataron en este tutorial. Te los dejo para que los explores a tu propia discreción. Éstos son algunos de ellos:

• El SDK de Alfresco Maven admite la recarga dinámica de clases cuando se utiliza junto con una herramienta llamada JRebel .
• Este tutorial cubre el arquetipo de AMP. Pero Alfresco Maven SDK incluye otro arquetipo llamado All-in-One. Este arquetipo le ofrece una instalación completa de Alfresco que incluye SOLR.
• Alfresco Maven SDK es compatible tanto con Community Edition como con Enterprise Edition. Si necesita ayuda para acceder a los artefactos de Enterprise Edition, póngase en contacto con el soporte de Alfresco.

Dónde encontrar más información

• La documentación oficial del SDK de Alfresco Maven se encuentra en http://docs.alfresco.com .
• Puede encontrar documentación más detallada sobre el SDK de Alfresco Maven en artefactos.alfresco.com .
• Presentación de Gab en la Cumbre de Alfresco Desarrollo rápido, basado en pruebas y entrega continua de soluciones de Alfresco
• Instant Apache Maven Starter El libro de Maurizio Turatti y Maurizio Pillitu puede ser un gran recurso si está interesado en aprender más sobre Apache Maven.
• Introducción a Alfresco Development Presentación a cargo de Gethin James de Alfresco Summit
• Alfresco Developer Series en ECM Architect contiene tutoriales gratuitos sobre modelos de contenido personalizados, acciones, comportamientos, flujos de trabajo y scripts web.

<= Parte 1