Java Agent
📄️ クイックスタート
このクイックスタートガイドで5-10分でNetFUNNEL 4 Java Agentを始めましょう。
📄️ インストールおよび初期化
NetFUNNEL Javaエージェントのインストールと初期化ガイドです。
📄️ Integration Methods
NetFUNNEL Java Agentがサポートする統合方法の概要です。
📄️ 初期化設定
このドキュメントでは、NetFunnelInitializeで使用可能なすべての初期化設定について説明します。
📄️ APIリファレンス
NetFUNNEL Java Agent関数と使用方法の完全なリファレンスです。
📄️ トラブルシューティング
NetFUNNEL Java Agent統合に関する一般的な問題、解決方法、よくある質問です。
概要
Java Agentは、JavaベースのSpring BootサーバーでNetFUNNEL 4トラフィック制御機能を提供するサーバー側SDKです。
主な機能
- サーバー側SDK: Spring Bootアプリケーションに直接統合
- URL-Triggered統合: トリガールールベースの自動制御
- Interceptor/Filterサポート: Spring Boot InterceptorまたはFilter方式で適用
- 自動待機室リダイレクト: 待機応答時に自動的に待機室ページにリダイレクト
- トリガールールマッチング: URLベースのトリガールールで待機列適用ポイントを制御
- 堅牢なエラー処理: 包括的なエラー処理とロギング
システム要件
- Java: 1.7以上
- Spring Boot: 3.x以上
- 外部依存関係:
- gson: JSONシリアライゼーション/デシリアライゼーション用のライブラリ
- jackson-module-kotlin: Kotlin使用のために必要なライブラリ（Java使用時）
互換環境
- Javaアプリケーション: Java 1.7以上ベースのアプリケーション
- Spring Bootアプリケーション: Spring Boot 3.x以上ベースのアプリケーション
動作方法
- エージェント初期化: NetFUNNELを初期化し、設定を構成
- Interceptor/Filter適用: リクエストを最初に受信するInterceptorまたはFilterにNetFUNNELロジックを適用
- トリガールールマッチング: ユーザーがアクセスしたページのURLとトリガールールを比較し、一致する場合に待機列を適用
- 自動待機室処理: 待機応答時に自動的に待機室ページにリダイレクト
エージェント動作フロー
待機前: ページロード → エージェント初期化 → トリガールールマッチ
待機中: NetFUNNELサーバーリクエスト → NetFUNNELキー発行 → 待機室ページに移動
待機後: サービスページ進入 → NetFUNNELキー返却
統合方法
URL-Triggered統合
URL-Triggered統合は、NetFUNNELコンソールのセグメントトリガールールを通じて待機列制御ポイントを設定します。ユーザーがアクセスしたページのURLとトリガールールを比較し、一致する場合に待機列が適用されます。
詳細については、統合方法概要ドキュメントを参照してください。
制限事項
コードベース統合非対応
Java Agentはコードベース統合をサポートしていません。URL-Triggered統合のみ使用できます。
クイックスタート
Java Agentをすぐに始めるには、クイックスタートガイドを参照してください。
ドキュメント
コアドキュメント
- クイックスタート: 基本的な例で5-10分で始める
- インストールと初期化: 依存関係と設定に関する詳細ガイド
- 統合方法: URL-Triggered統合概要
- APIリファレンス: 完全な関数仕様と使用方法
- 初期化設定: すべての初期化パラメータと使用方法
- トラブルシューティング: 一般的な問題、解決方法、FAQ
関連コンテンツ
- Node.js Agent: Node.js SDK統合ガイド
- サンプルプロジェクト: すぐに使用できるプロジェクトテンプレート