---
title: "Catalyst Maven アーキタイプ"
url: https://docs.catalyst.zoho.com/ja/tools/maven-tools/maven-archetypes/
description: "Catalystは、Maven Central Repositoryに一覧表示されている、IDEから直接Basic I/OおよびAdvanced I/Oタイプのサーバーレス関数を作成するための事前定義済みMavenアーキタイプを提供しています。"
last_updated: 2026-08-17T12:16:04Z
service: Serverless
type: general
---

# Maven Archetypes

### はじめに

[Maven archetype](https://maven.apache.org/guides/introduction/introduction-to-archetypes.html)は、Mavenプロジェクトのテンプレートを定義するツールキットです。Maven archetypeは、Java開発者にプロジェクトのテンプレートのパラメータ化されたバージョンを標準化された方法で生成する手段を提供します。

Catalystは、[Basic I/O](https://docs.catalyst.zoho.com/ja/serverless/help/functions/basic-io/)および[Advanced I/O](https://docs.catalyst.zoho.com/ja/serverless/help/functions/advanced-io/)タイプの[サーバーレス](https://docs.catalyst.zoho.com/ja/serverless/)関数を作成するための事前定義済みMavenアーキタイプを提供しています。これらのアーキタイプは[Maven Central Repository](https://mvnrepository.com/repos/central)から一覧表示されます。これらのアーキタイプを使用すると、関数の詳細を含む入力値を提供するだけで、関数を[標準構造](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/introduction/)で作成・初期化し、Mavenプロジェクトのディレクトリに必要な依存関係を含めます。この方法で、個別のPOMディレクトリに複数の関数を追加できます。

Mavenアーキタイプで関数を作成する際には、以下の点に注意してください：

* CLIから[関数を初期化](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/introduction/)する場合、最初にプロジェクトを初期化するか、既存のCatalystプロジェクトディレクトリに[関数を追加](https://docs.catalyst.zoho.com/ja/cli/v1/working-with-functions/add-functions/)する必要があります。Mavenの場合、プロジェクトを個別に初期化することはできません。関数を直接作成できます。

* アーキタイプで作成した関数は、次のセクションで説明するように、選択した保存先フォルダに作成されます。

* アーキタイプで作成した関数は、後のセクションで説明するMaven設定ファイル[`pom.xml`](https://docs.catalyst.zoho.com/ja/tools/maven-tools/pom-xml/)に[Project ID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)を設定することで、リモートアカウントの既存プロジェクトに関連付けることができます。このファイルにCatalyst組織の[Org ID](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-organizations/)も追加する必要があります。

* Mavenツールを通じて、Basic I/OおよびAdvanced I/O以外のタイプの関数、他のスタック、またはクライアントコンポーネントを作成することはできません。これらのリソースをローカル環境で初期化するには、CLIを利用する必要があります。

### アーキタイプでBasic I/OまたはAdvanced I/O関数を作成する

このヘルプドキュメントでは、VS Code IDEの例を使用してCatalyst Maven Toolsを操作する手順を説明します。使用するIDEによっては、一部の詳細が異なる場合があります。

以下の方法でBasic I/OまたはAdvanced I/O関数を作成できます：

1. IDEで新しいMavenプロジェクトを作成します。使用するIDEによって手順は異なる場合があります。IDEに応じて、既存のプロジェクトをMavenに変換することもできます。

    VS Codeの場合、Mavenの下にある**+**アイコンをクリックして新しいMavenプロジェクトを作成します。

![maven-create-project](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-create-project.webp)

2. アーキタイプ検索バーに「com.zoho.catalyst」と入力します。作成したい関数のタイプに基づいて、以下のいずれかを選択します：

* `catalyst-archetype-basicio`: Basic I/O関数を作成する場合
* `catalyst-archetype-advancedio`: Catalyst SDKを含むAdvanced I/O関数を作成する場合
* `catalyst-archetype-advancedio-basic`: Catalyst SDKなしでAdvanced I/O関数を作成する場合

![maven-archetype-create-function](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-archetype-create-function.webp)

> **注意:** Catalystアーキタイプが結果に表示されない場合、または最新のアーキタイプ定義を取得したい場合は、IDEのMavenアーキタイプカタログを更新して、最新の公開済みアーキタイプにアクセスする必要がある場合があります。IDEに応じて、カタログの更新手順を確認し、必要な操作を実行してください。VS Codeでは、コマンドパレットを開いて*Maven: Update Maven Archetype Catalog*を選択します。

3. 選択したアーキタイプのバージョンを選択します。最新バージョンを選択することを推奨します。

![maven-archetype-function-version](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-archetype-function-version.webp)

4. プロジェクトの[group ID](https://maven.apache.org/guides/mini/guide-naming-conventions.html)を入力します。このIDはMavenプロジェクトを一意に識別します。**Enter**を押してデフォルト値を使用することもできます。

![maven-group-id](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-group-id.webp)

5. プロジェクトの[artifact ID](https://maven.apache.org/guides/mini/guide-naming-conventions.html)を入力します。これはバージョンなしのJARの名前です。**Enter**を押してデフォルト値を使用することもできます。

![maven-artifact-id](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-artifact-id.webp)

6. Mavenプロジェクトを保存する保存先フォルダを選択します。

7. ターミナルでいくつかの入力を求められます。各入力後に**Enter**を押してください。入力せずに直接**Enter**を押すと、デフォルト値が送信されます。

    * 出力JARファイルの[`SNAPSHOT`](https://maven.apache.org/guides/getting-started/index.html#what-is-a-snapshot-version)のバージョン
    * Mavenパッケージ名
    * Java関数の`appName`またはCatalyst参照名
    * 関数のメインクラス名
    * この関数が関連付けられるプロジェクトの[Project ID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)
    * プロジェクトが属するCatalyst組織の[Org ID](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-organizations/)

![maven-create-function-1](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-create-function-1.webp)

> **注意:** Project IDとOrg IDの値は[`pom.xml`](https://docs.catalyst.zoho.com/ja/tools/maven-tools/pom-xml/)設定ファイルに保存されます。後で`pom.xml`で直接設定することもできるため、ここでは**Enter**を押してこれらの値の入力をスキップできます。

8. 「**Y**」を入力して**Enter**を押し、Mavenプロジェクトのプロパティ設定を確認します。

![maven-create-function-2](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-create-function-2.webp)

以下に示すディレクトリ構造でMavenプロジェクトに関数が作成されます。

![maven-function-structure](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-function-structure.webp)

CLIからJava関数を初期化する場合、関数はプロジェクトのルートに[`catalyst.json`](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/catalyst-json/)プロジェクト設定ファイル、関数のルートに[Catalyst Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/overview/) JARファイル、およびその他のプロジェクト依存関係とともに作成されます。Catalyst Mavenアーキタイプを使用して関数を作成する場合、これらのディレクトリにJava SDKファイルやプロジェクト依存関係は含まれません。

代わりに、関数のディレクトリにはソースディレクトリとターゲットディレクトリが個別に含まれ、さらにMaven環境固有の`pom.xml`も含まれます。メインのJava関数ファイルも関数タイプに基づくデフォルトコードで作成され、[`catalyst-config.json`](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/functions-directory/#catalyst-config-json-file)ファイルが作成されて自動設定されます。