1. Homepage
  2. Connector DevKit (3.9)

  3. Anypoint Connector プロジェクトの作成

Anypoint Connector プロジェクトの作成

DevKit は、Studio 6 および Mule 3 とのみ互換性があります。Mule 4 Connector を作成するには、 「Mule SDK」ドキュメント​を参照してください。

前提条件

DevKit ドキュメントの前提条件を次に示します。

  1. Mule、Anypoint Studio、Java 開発全般の実践的な知識がある。

  2. 既存のコネクタ​の調査が完了している。

  3. 対象システムやソースシステムの Sandbox 環境、および公開される Web サービスのドキュメントにアクセスできる。

  4. Java 言語 (特に Java アノテーションの使用) の一般的な理解がある。DevKit の機能は、コードをコネクタクラスに挿入する Java アノテーションを介してコネクタ開発者に公開されます。挿入されたコードは、コネクタと Mule 間のインターフェースとして機能します。これがない場合、各コネクタ開発者は広範な定型コードを含める必要があります。このドキュメントでは、各例に照らしてそれぞれの DevKit 固有のアノテーションについて説明します。アノテーションに詳しくない場合は、​ 「Java annotations (Java アノテーション)」​の簡単な説明を参照してください。

重要:​ コネクタプロジェクトをビルドするには、まず ​Anypoint Connector DevKit プラグイン​を Anypoint Studio にインストールする必要があります。

コネクタ構造の表示

Anypoint Connector DevKit モジュールには、選択したプロジェクト内の全コネクタの DevKit クラス、プロパティ、メソッド、プロセッサ、設定可能な項目をすべて表示する Eclipse パースペクティブが含まれます。

DevKit ビューを設定する手順は、次のとおりです。

  1. 画面の右上の ​[Add View (ビューを追加)]​ アイコンをクリックし、​[Other (その他)]​ をクリックします。

    ViewButton

  2. [Devkit]​ および ​[OK]​ をクリックし、[DevKit Perspective (DevKit パースペクティブ)] を開きます。

    DevKitView

  3. [Devkit]​ パースペクティブの任意の項目をクリックし、それを定義するコードを表示します。次に例を示します。

    DevKitPerspective

DevKit ビューでは、次の作業を行うことができます。

  • [Configurable (設定可能)] 項目またはメソッドをダブルクリックして、それが定義されているコードの行に簡単に移動する。

  • XML で操作が公開されるときに使用される名前を確認する。

  • XSD 名をダブルクリックして、サンプルドキュメントファイルのサンプルを表示する。

  • 絞り込んでコネクタの要素を見つける。

オートコンプリートの使用

コネクタのメイン Java ファイルを編集する場合、オートコンプリート機能により、追加できるいくつかの一般的なメソッドの骨格構造が提供されます。 これらの構造は、プロジェクトがビルドテストに正常に合格し、コネクタのユーザがコネクタに関する参考資料にアクセスできるようにするために入力する必要がある基本的な Javadoc​ ドキュメントに備わっています。

@Connector クラスまたは他の @ アノテーションにカーソルを置いた状態で、CTRL + スペースバーを押すと、推奨エントリのリストが表示されます。

ConnectorHelpInfo

@Connector と他の Anypoint Connector DevKit アノテーションについての詳細は、​ 「Anypoint DevKit API リファレンス」​を参照してください。

コードテンプレートの使用

テンプレートは、コネクタに追加できるコードのカスタマイズ可能な場所で、一般的に使用される要素の基本構造を提供します。名前またはその一部を入力し、​[ Command | Ctrl ] + space​ を押してテンプレートを現在のコネクタクラスに挿入します。

screen23

使用可能な DevKit テンプレート

configurable

設定可能な項目を追加します。

datasense

DataSense 操作を追加します。

processor

プロセッサをコネクタに追加します。各種テンプレートで複数のオプションがあります。

transformer

トランスフォーマメソッドを追加します。トランスフォーマは、ある入力を別の入力に変換します。

restconfig

設定可能な要素 (URI パラメータ、クエリパラメータ、ヘッダーパラメータなど) を REST ベースのコネクタに追加します。

restprocessor

@RestCall プロセッサは、3.9.0 から非推奨になっています。​REST ベースコネクタは、Anypoint Connector プロジェクトの作成時に @RestCall パラメータを挿入します。

Anypoint Studio でコネクタのインストールおよび更新

コネクタをコーディングしたら、Anypoint Studio でインストールして試すことができます。インストールしたら、Mule プロジェクトでコネクタを使用して、意図したとおりに機能することを確認できます。

  1. Anypoint Studio の Package Explorer で、プロジェクトのルートを右クリックします。

  2. [Anypoint Connector (Anypoint Connector)]​ > ​[Install or Update (インストールまたは更新)]​ を選択します。

    connector install update

  3. [Check the items you wish to install (インストールする項目を確認)]​ で、​[Next (次へ)]​ をクリックします。

  4. [Review the items to be installed (インストールされる項目を確認)]​ で、​[Next (次へ)]​ をクリックします。

  5. [Review Licenses (ライセンスを確認)] で、​[I accept the terms of the license agreement (私はライセンス契約の条件に同意します)]​ をクリックして ​[Finish (完了)]​ をクリックします。

  6. Anypoint Studio を再起動します。

コネクタを試す

コネクタを試す手順は、次のとおりです。

  1. [New (新規)]​ > ​[Mule Project (Mule プロジェクト)]​ をクリックして新しいプロジェクトを作成します。

  2. [HTTP connector (HTTP Connector)]​ をキャンバスに追加します。

  3. 名前でコネクタを検索して、フローに追加します。

    次に例を示します。

    connector display

既存のコネクタプロジェクトのインポート

既存のコネクタプロジェクトをインポートするには、​[File (ファイル)]​ > ​[Import (インポート)]​ > ​[Anypoint Studio]​ > ​[Anypoint Connector Project from External Location (既存の場所の Anypoint Connector プロジェクト)]​ をクリックして URL または .zip ファイルを選択し、ウィザードを完了してプロジェクトを見つけてインポートします。

import

プロジェクトの圧縮ファイルのエクスポート

プロジェクトの圧縮ファイルを作成する手順は、次のとおりです。

  1. Anypoint Studio の Package Explorer で、プロジェクト名を右クリックし、​[Export (エクスポート)]​ をクリックします。

  2. [General (一般)]​ をクリックし、次の設定でファイルを​アーカイブ​します。TAR ファイル (Linux または Mac) と ZIP ファイル (Mac または Windows) のどちらが必要なのかを選択します。Windows ユーザは、7zip などのサードパーティソフトウェアを使用して TAR ファイルを展開することもできます。
    重要: target​ フォルダをオフにします。

    ArchiveFile

  3. プロジェクト名の横にある下矢印をクリックして、​target​ をオフにします。

    ArchiveDirs

  4. [To archive file (アーカイブするファイル)]​ で ​[Browse (参照)]​ をクリックし、zip または tar ファイルの名前と場所を選択します。

  5. [Finish (完了)]​ をクリックして、圧縮ファイルを作成します。

関連情報