Primeiros passos com Maven Alfresco SDK parte 2

Trabalhamos com seu projeto no IDE

• Arquivo, importação, Maven, projetos Maven existentes. Clique em Avançar.
  
• Especifique o diretório que contém o diretório someco-mvn-tutorial-repo. O Eclipse irá verificar este diretório e mostrar seu projeto na lista de projetos. Certifique-se de que a caixa de seleção ao lado do nome do projeto esteja marcada e clique em Avançar.
  
• O Eclipse mostrará as configurações do painel de plug-ins do Maven. Você pode ignorá-lo com segurança agora. Clique em Concluir.
  

1. Clique com o botão direito no erro e selecione "Correção rápida".
2. Selecionando "Marcar permanentemente a versão do conjunto de metas em pom.xml como ignorada na compilação do Eclipse". Preparar.
3. Selecione o local onde seu POM está localizado (o meu é com.someco: someco-mvn-tutorial-repo: 1.0-SNAPSHOT) e clique em OK.

1. Clique com o botão direito no projeto e selecione Maven, Atualizar Projeto.
2. Certifique-se de que o projeto esteja selecionado e clique em OK.

Entendendo a estrutura do projeto

• pom.xml Na raiz do projeto você vê pom.xml. Ele conta ao Maven tudo o que ele precisa saber sobre o seu projeto. Você se lembra de algumas configurações que esqueceu ao criar um projeto a partir de um template? Você pode fazer alterações nas configurações aqui. Por exemplo, a versão 1.1.1 do arquétipo permite trabalhar com o Alfresco Community Edition versão 4.2.e. Se você quiser trabalhar com uma versão diferente - basta alterar algumas propriedades e dizer ao Maven para atualizá-las e ele cuidará do resto.
• src/main/java É aqui que você deve criar seus próprios pacotes para organizar seu código Java. Coisas como classes executoras de ações personalizadas, comportamentos personalizados e controladores Java para scripts da web estão aqui. Se você não sabe o que é tudo isso, não se preocupe, há tutoriais disponíveis aqui . Esses arquivos serão eventualmente colocados em um JAR. Quando o AMP for instalado no Alfresco WAR, o JAR estará dentro de WEB-INF/lib .
• src/test Tudo dentro de src/test está relacionado à execução do teste. Os próprios testes de unidade estão localizados em src/test/java . Quaisquer recursos necessários para essas classes estarão em src/test/resources. Dentro de src/test/properties/local você verá um arquivo alfresco-global.properties . Se você já conhece alguma coisa sobre o Alfresco, sabe que ele é usado para configurar o servidor Alfresco. Neste caso, é utilizado apenas para executar o servidor embarcado, para fins de teste.
• src/main/amp Todo o resto está em algum lugar nesta parte do projeto. A estrutura do AMP está tão bem documentada que não quero duplicá-la aqui. Vou apenas apontar os pontos principais:
  
  • O arquivo module.properties informa ao Alfresco o que ele precisa saber sobre o AMP, como ID, versão, versão mínima e máxima do Alfresco necessária para executar o AMP e quaisquer outros AMPs com as mesmas dependências.
  • O diretório config/alfresco/module/someco-mvn-tutorial-repo é o coração do AMP. O local onde você colocará as configurações do arquivo XML do Spring, o modelo de conteúdo dos arquivos XML e a configuração da interface do usuário. Como você verá mais tarde, prefiro separar subdiretórios para cada uma dessas coisas.
  • Se o seu módulo incluir scripts da web ou fluxos de trabalho, eles não estarão contidos no diretório de módulos. Em vez disso, eles estão localizados em config/alfresco/extension/templates/webscripts e config/alfresco/extension/workflows .
  • Seu módulo pode incluir recursos de cliente que devem ser implantados na raiz do aplicativo Web. Eles estão localizados em src/main/amp/web nos diretórios css, jsp, scripts e images.

Criando um projeto adaptado para acesso Share

Dependências Gerais do Projeto

Alvo de GUERRA

Vamos tentar isto: Criando um projeto Share usando um arquétipo

1. Arquivo, Novo Projeto Maven.
2. Selecione o diretório que contém o diretório do projeto "repo" e clique em Avançar.
   
3. Clique em Configurar e podemos adicionar o diretório Alfresco à lista.
   
4. Clique em Adicionar catálogo remoto
5. Selecione "https://artifacts.alfresco.com/nexus/content/groups/public/archetype-catalog.xml" como arquivo de catálogo. Selecione a descrição "Arquétipos ao ar livre". Depois, clique em OK e OK novamente próximo ao painel Preferências.
   
6. Agora selecione "Alfresco Archetypes" no diretório e você verá vários arquétipos na lista.
7. Selecione "org.alfresco.maven.archetype" e os mesmos dois arquétipos aparecerão no filtro como no início do tutorial.
8. Selecione alfresco-amp-archétype e clique em Avançar.
   
9. Selecione "com.someco" para groupId, "someco-mvn-tutorial-share" como artefatoId e altere alfresco_target_amp_client_war para "share". Clique em Concluir.
   

Noções básicas sobre a estrutura de diretórios do Share Access

Lançamento de testes internos no Share

cd someco-mvn-tutorial-repo
teste de integração mvn -Pamp-to-war

cd someco-mvn-tutorial-share
teste de integração mvn -Pamp-to-war -Dmaven.tomcat.port=8081

Gerenciamento de dependências

Hierarquia de dependência no Eclipse Outra opção. Você pode ver a hierarquia de dependências executando:

dependência mvn: lista

Portanto, para adicionar scripts da web baseados em Java ao seu projeto Share, precisamos adicionar spring-webscripts como uma dependência. Você pode fazer isso editando pom.xml assim:

<dependência>
    <groupId>org.springframework.extensions.surf</groupId>
    <artifactId>spring-webscripts</artifactId>
    <versão>1.2.0-M14</versão>
    <scope>fornecido</scope>
</dependency>

Agora, os scripts da web baseados em Java serão capazes de encontrar sua classe pai - DeclarativeWebScript.
Você pode estar se perguntando como saber que a classe DeclarativeWebScript foi incluída no artefato spring-webscripts. Bem, por exemplo, tendo encontrado acessando http://artifacts.alfresco.com . Você pode pesquisar por classe e serão mostrados todos os artefatos que a contêm.

Outros tópicos para estudo independente

Agora você sabe como usar o Alfresco Maven SDK para criar projetos e como seu repositório Alfresco e configurar o Alfresco Share. Se você é novo no desenvolvimento do Alfresco, espero que concorde que é muito fácil montar um projeto para começar. Se você já começou a usar o Alfresco, mas ainda usa os SDKs antigos, espero que isso o motive a mudar para o novo SDK para criar seus AMPs.
Existem muitos tópicos que não foram abordados neste tutorial. Vou deixá-los para você explorar a seu próprio critério. Aqui estão alguns deles:

• O Alfresco Maven SDK oferece suporte ao recarregamento dinâmico de classes quando usado em conjunto com uma ferramenta chamada JRebel .
• Este tutorial cobre o arquétipo AMP. Mas o Alfresco Maven SDK inclui outro arquétipo chamado All-in-One. Este exemplo oferece uma instalação Alfresco completa, incluindo SOLR.
• Alfresco Maven SDK é compatível com Community Edition e Enterprise Edition. Se precisar de ajuda para acessar artefatos na Enterprise Edition, entre em contato com o Suporte Alfresco.

Onde encontrar mais informação

• A documentação oficial do Alfresco Maven SDK está localizada em http://docs.alfresco.com .
• Documentação mais detalhada sobre o Alfresco Maven SDK pode ser encontrada em artefatos.alfresco.com .
• Apresentação Gab no Alfresco Summit orientada a testes, desenvolvimento rápido e entrega contínua de soluções Alfresco
• Instant Apache Maven Starter O livro de Maurizio Turatti e Maurizio Pillitu pode ser um ótimo recurso se você estiver interessado em aprender mais sobre o Apache Maven.
• Apresentação de introdução ao desenvolvimento ao ar livre por Gethin James do Alfresco Summit
• Alfresco Developer Series no ECM Architect contém tutoriais gratuitos sobre modelos de conteúdo personalizados, ações, comportamentos, fluxos de trabalho e scripts da web.

<= Parte 1