Maven Alfresco SDK の入門パート 2

IDE でプロジェクトを操作します

• ファイル、インポート、Maven、既存の Maven プロジェクト。「次へ」をクリックします。
  
• someco-mvn-tutorial-repo ディレクトリを含むディレクトリを指定します。Eclipse はこのディレクトリをチェックし、プロジェクトのリストにプロジェクトを表示します。プロジェクト名の横にあるチェックボックスが選択されていることを確認し、「次へ」をクリックします。
  
• Eclipse には Maven プラグイン パネルの設定が表示されます。今は無視しても問題ありません。「完了」をクリックします。
  

1. エラーを右クリックし、「クイック修正」を選択します。
2. 「pom.xml の目標セットのバージョンを Eclipse ビルドで無視されるものとして永続的にマークする」を選択します。準備ができて。
3. POM が配置されている場所 (私の場合は com.someco : someco-mvn-tutorial-repo : 1.0-SNAPSHOT) を選択し、「OK」をクリックします。

1. プロジェクトを右クリックし、「Maven」、「プロジェクトの更新」を選択します。
2. プロジェクトが選択されていることを確認し、「OK」をクリックします。

プロジェクトの構造を理解する

• pom.xmlプロジェクトのルートに pom.xml があります。これは、プロジェクトについて知る必要があるすべてを Maven に伝えます。テンプレートからプロジェクトを作成するときに忘れた設定を覚えていますか? ここで設定を変更できます。たとえば、アーキタイプのバージョン 1.1.1 では、Alfresco Community Edition バージョン 4.2.e で作業できます。別のバージョンで作業したい場合は、いくつかのプロパティを変更し、それらを更新するように Maven に指示するだけで、残りは Maven が処理してくれます。
• src/main/javaここで、Java コードを整理するための独自のパッケージを作成する必要があります。カスタム アクション実行クラス、カスタム ビヘイビアー、Web スクリプト用の Java コントローラーなどがここにあります。これが何なのか分からなくても、心配しないでください。ここにチュートリアルが用意されています。これらのファイルは最終的に JAR に配置されます。AMP が Alfresco WAR にインストールされている場合、JAR はWEB-INF/lib内にあります。
• src/test src/test 内のすべてはテストの実行に関連しています。単体テスト自体はsrc/test/javaにあります。これらのクラスで必要なリソースはすべて src/test/resources にあります。src/test/properties/local内にalfresco-global.propertiesファイルが表示されます。Alfresco についてすでに知っている場合は、Alfresco サーバーの構成に Alfresco が使用されていることをご存知でしょう。この場合、これはテスト目的で組み込みサーバーを実行するためにのみ使用されます。
• src/main/amp他のすべてはプロジェクトのこの部分のどこかにあります。AMP の構造は十分に文書化されているため、ここでは複製しません。要点だけを指摘します。
  
  • module.propertiesファイルは、AMP の ID、バージョン、AMP の実行に必要な Alfresco の最小バージョンと最大バージョン、および同じ依存関係を持つ他の AMP など、AMP について知っておく必要があることを Alfresco に伝えます。
  • config/alfresco/module/someco-mvn-tutorial-repoディレクトリは AMP の中心です。Spring XML ファイル構成、XML ファイルのコンテンツ モデル、およびユーザー インターフェイス構成を配置する場所。後ほど説明しますが、私はこれらのそれぞれに対してサブディレクトリを分離することを好みます。
  • モジュールに Web スクリプトまたはワークフローが含まれている場合、それらはモジュール ディレクトリには含まれません。代わりに、それらはconfig/alfresco/extension/templates/webscripts および config/alfresco/extension/workflowsにあります。
  • モジュールには、Web アプリケーションのルートにデプロイする必要があるクライアント リソースが含まれる場合があります。これらは、css、jsp、scripts、images ディレクトリのsrc/main/amp/webにあります。

共有アクセスに適応したプロジェクトの作成

一般的なプロジェクトの依存関係

戦争目標

これを試してみましょう: アーキタイプを使用した共有プロジェクトの作成

1. ファイル、新しい Maven プロジェクト。
2. 「repo」プロジェクト ディレクトリを含むディレクトリを選択し、[次へ] をクリックします。
   
3. 「構成」をクリックすると、Alfresco ディレクトリをリストに追加できます。
   
4. 「リモートカタログの追加」をクリックします
5. カタログファイルとして「https://artifacts.alfresco.com/nexus/content/groups/public/archetype-catalog.xml」を選択します。「Alfresco Archetypes」という説明を選択します。その後、「OK」をクリックし、「環境設定」パネルの近くでもう一度「OK」をクリックします。
   
6. ここで、ディレクトリ内の「Alfresco Archetypes」を選択すると、リストに多数のアーキタイプが表示されます。
7. 「org.alfresco.maven.archetype」を選択すると、チュートリアルの冒頭と同じ 2 つのアーキタイプがフィルターに表示されます。
8. 「alfresco-amp-archetype」を選択し、「次へ」をクリックします。
   
9. groupIdとして「com.someco」、artifactIdとして「someco-mvn-tutorial-share」を選択し、alfresco_target_amp_client_warを「share」に変更します。「完了」をクリックします。
   

Share Access ディレクトリ構造を理解する

Shareの内部テストを開始

cd someco-mvn-tutorial-repo
mvn 統合テスト -Pamp-to-war

cd someco-mvn-tutorial-share
mvn 統合テスト -Pamp-to-war -Dmaven.tomcat.port=8081

依存関係の管理

Eclipse の依存関係階層 もう 1 つのオプション。以下を実行すると、依存関係の階層を確認できます。

mvn 依存関係:リスト

したがって、Java ベースの Web スクリプトを Share プロジェクトに追加するには、spring-webscripts を依存関係として追加する必要があります。これを行うには、次のように pom.xml を編集します。

<依存関係>
    <groupId>org.springframework.extensions.surf</groupId>
    <artifactId>spring-webscripts</artifactId>
    <バージョン>1.2.0-M14</バージョン>
    <scope>提供</scope>
</依存関係>

Java ベースの Web スクリプトは、その親クラスである DeclarativeWebScript を見つけることができるようになります。
DeclarativeWebScript クラスが spring-webscripts アーティファクトに含まれていることをどうやって知ったのか疑問に思われるかもしれません。たとえば、http://artifacts.alfresco.comにアクセスして見つけたとします。クラスごとに検索すると、そのクラスを含むすべてのアーティファクトが表示されます。

その他の自主学習のトピック

これで、Alfresco Maven SDK を使用してプロジェクトを作成し、Alfresco リポジトリとして使用し、Alfresco Share を構成する方法がわかりました。Alfresco 開発が初めての方は、プロジェクトをまとめて開始するのが非常に簡単であることに同意していただけると思います。すでに Alfresco に慣れているものの、まだ古い SDK を使用している場合は、これが新しい SDK に切り替えて AMP を作成する動機になれば幸いです。
このチュートリアルではカバーされていないトピックが多数あります。ご自身の裁量で探索していただくために、これらは残しておきます。その一部を次に示します。

• Alfresco Maven SDK は、JRebelと呼ばれるツールと組み合わせて使用​​すると、動的クラスのリロードをサポートします。
• このチュートリアルでは、AMP アーキタイプについて説明します。ただし、Alfresco Maven SDK には、オールインワンと呼ばれる別のアーキタイプが含まれています。このアーキタイプでは、SOLR を含む完全な Alfresco インストールが提供されます。
• Alfresco Maven SDK は、Community Edition と Enterprise Edition の両方でサポートされています。Enterprise Edition でアーティファクトにアクセスする際にサポートが必要な場合は、Alfresco サポートにお問い合わせください。

詳細情報の入手先

• Alfresco Maven SDK の公式ドキュメントはhttp://docs.alfresco.comにあります。
• Alfresco Maven SDK の詳細なドキュメントは、 artifacts.alfresco.comにあります。
• Alfresco Summit での Gab プレゼンテーションAlfresco ソリューションのテスト駆動、迅速な開発、継続的デリバリー
• インスタント Apache Maven スターターMaurizio Turatti と Maurizio Pillitu による本は、Apache Maven について詳しく知りたい場合に最適なリソースです。
• Alfresco Summit の Gethin James によるAlfresco 開発プレゼンテーションの概要
• ECM ArchitectのAlfresco Developer シリーズには、カスタム コンテンツ モデル、アクション、動作、ワークフロー、Web スクリプトに関する無料のチュートリアルが含まれています。

<= パート 1