---
title: "Catalyst SDKの実装"
url: https://docs.catalyst.zoho.com/ja/serverless/help/appsail/implement-catalyst-sdk/
description: "Catalyst AppSailは、Catalyst Serverlessのフルマネージドプラットフォームであり、Java、Node.js、Pythonのマネージドランタイム、またはOCIイメージとしてのカスタムランタイムでWebサービスを簡単に開発・デプロイできます。"
last_updated: 2026-03-30T08:10:30Z
service: Serverless
type: general
---

# AppSailでCatalyst SDKを実装する

Catalystでは、[Catalystマネージドランタイム](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/)のAppSailアプリケーションに、サポートされている開発環境のSDKパッケージを実装できます。これにより、アプリの機能で他のCatalystサービスやコンポーネントを利用できるようになります。以下に示すように、さまざまなプログラミング環境の開発SDKをアプリに実装できます。

> **Note:** これは、サポートされているCatalystマネージドランタイム向けに構築されたWebサービスでのみ利用可能です。[カスタムランタイム](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/custom-runtimes/overview/)を通じてOCIイメージとしてデプロイされたアプリには、Catalyst SDKを実装できません。

### Catalyst Java SDKの実装

Catalyst Java SDKパッケージは、Catalystコンソールの[Developer Tools設定](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/developer-tools/)からダウンロードして、アプリのソースコードに含めることができます。その後、アプリケーションのコードにCatalyst Java SDKを実装して初期化できます。SDKツールキットのさまざまな機能とサンプルコードスニペットの詳細については、[Catalyst Java SDKヘルプ](https://docs.catalyst.zoho.com/ja/sdk/java/v1/overview/)を参照してください。

JavaサーブレットのさまざまなAPIバージョンに対するSDKの実装と初期化の手順を、サンプルコードで以下に示します。

すべてのケースで、Catalystは、Catalyst Java SDKパッケージから`AuthHeaderProvider`インターフェースを実装する必要があります。この実装では、リクエストヘッダーの値を返す`getHeader()`メソッドを定義します。その後、実装クラスのオブジェクトを`init()`メソッドに渡して、SDKを初期化できます。

#### Java Servlet APIバージョン4以下

Java Servlet APIバージョン4.0以下（`[javax.servlet](https://docs.oracle.com/javaee%2F7%2Fapi%2F%2F/javax/servlet/package-summary.html)`）を使用するJavaアプリケーション用のサンプルコード:

**実装クラス:**

```java
package com.zoho.catalyst.appsail.demo.utils;
import javax.servlet.http.HttpServletRequest;
import com.zc.auth.AuthHeaderProvider;
public class AuthProviderImpl implements AuthHeaderProvider {
 HttpServletRequest request;
 public AuthProviderImpl(HttpServletRequest request) {
  this.request = request;
 }
 @Override
 public String getHeaderValue(String key) {
  return request.getHeader(key);
 }
}

```

**初期化:**

```json
AuthProviderImpl authProviderImpl = new AuthProviderImpl(req);
CatalystSDK.init(authProviderImpl)
```

#### Java Servlet APIバージョン5以上

Java Servlet APIバージョン5.0以上（`[jakarta.servlet](https://mvnrepository.com/artifact/jakarta.servlet)`）を使用するJavaアプリケーション用のサンプルコード:

**実装クラス:**

```java
import com.zc.auth.AuthHeaderProvider;
import jakarta.servlet.http.HttpServletRequest;
public class AuthProviderImpl implements AuthHeaderProvider {
    private HttpServletRequest request;
    AuthProviderImpl(HttpServletRequest request) {
        this.request = request;
    }
    @Override
    public String getHeaderValue(String s) {
        return request.getHeader(s);
    }
}
```

**初期化:**

```json
CatalystSDK.init(new AuthProviderImpl((HttpServletRequest) servletRequest));
```

[Maven](https://maven.apache.org/)ビルドツールを使用してJavaアプリケーションを開発している場合、SDKを手動でダウンロードしてソースコードに追加する代わりに、Mavenの設定ファイル（[`pom.xml`](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)）にCatalyst Java SDKを依存関係として含めることができます。

MavenプロジェクトにCatalyst SDKを追加するには、`pom.xml`ファイルに以下のようにZohoリポジトリ（[MvnRepository](https://mvnrepository.com/)で公開）を追加します:

```json
<repositories>
	<repository>
      <id>java-sdk</id>
      <url>https://maven.zohodl.com</url>
    </repository>
  </repositories>
```

その後、以下のようにpom.xmlにJava SDKを依存関係として追加できます:

```json
<dependencies>
    <dependency>
      <groupId>com.zoho.catalyst</groupId>
      <artifactId>java-sdk</artifactId>
      <version>1.15.0</version>
    </dependency>
 </dependencies>
```

### Catalyst Node.js SDKの実装

ターミナルで次のコマンドを実行して、Catalyst Node.js SDKパッケージをインストールし、アプリのソースコードに含めることができます:

```json
npm install zcatalyst-sdk-node --save
```

これにより、Node.js SDKの最新サポートバージョンがインストールされます。以下の方法で特定のサポートバージョンをインストールすることもできます:

```json
npm install zcatalyst-sdk-node@2.1.1 --save
```

その後、以下のサンプルコードのようにアプリケーションのコードでNode.js SDKを初期化できます。これは、リクエストオブジェクトを`initialize()`メソッドに渡します。

```javascript
const catalyst = require('zcatalyst-sdk-node')
const express = require('express')
const app = express()
app.get((req, res) => {
let catalystApp = catalyst.initialize(req);
//コードをここに記述する 
})
app.listen(process.env("X_ZOHO_CATALYST_LISTEN_PORT") || 9000)
```

詳細については、[Catalyst Node.js SDKヘルプ](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/overview/)を参照してください。SDKドキュメントには、サポートされているすべての機能のサンプルコードスニペットも記載されています。

### Catalyst Python SDKの実装

ターミナルで次のコマンドを実行して、AppSailソリューション用のCatalyst Python SDKをインストールし、アプリのソースコードに含めることができます:

```json
pip install zcatalyst-sdk -t .
```

その後、CatalystアプリのコードにPython SDKをインポートできます。SDKは各リクエストの前にリクエストオブジェクトで初期化する必要があります。

FlaskWebアプリでPython SDKをインポートおよび初期化するコードスニペットの例を以下に示します:

```python
from flask import Flask, request, g
import os
import zcatalyst_sdk
from zcatalyst_sdk.catalyst_app import CatalystApp
app = Flask(__name__)
@app.before_request
def before_request():
    if request.path.startswith('/admin'):
        return 'Unauthorized', 401
    # 認可済みユーザーの場合
    g.zc_app = zcatalyst_sdk.initialize(req=request)
@app.route('/')
def index():
    return 'Web App with Python Flask!'
@app.route('/cache')
def cache():
    app: CatalystApp = g.zc_app
    resp = app.cache().segment().put('key', 'value')
    return resp, 200
listen_port = os.getenv('X_ZOHO_CATALYST_LISTEN_PORT', 9000)
app.run(host='0.0.0.0', port = listen_port)
```

SDKツールキットのさまざまな機能とサンプルコードスニペットの詳細については、[Catalyst Python SDKヘルプ](https://docs.catalyst.zoho.com/ja/sdk/python/v1/overview/)を参照してください。