VJSPAI-LINK 設定

vjspai-link.yml は VJSP 可視化機能のコアプロジェクト設定ファイルです。このファイルは、現在のプロジェクトと VJSP プラグインを統合するために必要なすべてのパラメータを定義します。プラグインは起動時にこのファイルを自動的に読み込み、データソース、静的リソースパス、国際化（i18n）設定などの重要なランタイム環境を初期化します。

✅ ファイルの場所: プロジェクト/.vjsp/vjspai-link.yml

⚠️ 前提条件: このファイルが存在し、正しい形式であることを確認してください。そうでない場合、VJSP プラグインの一部の機能が正しく機能しません。

注意: vjspai-link.yml ファイルが存在しない場合、プラグインの「データベースデザイナー」または「ワークフローデザイナー」をクリックしてください。ファイルは .vjsp ディレクトリに自動的に作成され、手動での作成は不要です。

環境要件

プラグイン機能は Java サービス に依存しています。ローカルに Java 環境が正しくインストールされており、環境変数が正しく設定されていることを確認してください。

推奨バージョン: Java 8 ~ Java 17
確認方法: コマンドライン/ターミナルで java -version を実行
検証成功: コマンドが正常に返り、Java バージョン情報が表示されます

🔧 この設定に依存する機能モジュール

以下の VJSP 機能はすべて vjspai-link.yml で定義された設定に依存しています：

データベーススキーマエディタ
ワークフローデザイナー
フォームロジック & ページビルダー

正しく設定されていない場合、これらの機能は使用できず、以下の問題が発生する可能性があります：

データソースを読み込めません
ワークフロー定義が見つかりません
フォームフィールドをレンダリングできません

📋 主な設定項目の説明

設定項目	説明
`datasource`	データソース設定
`driverClassName`	データベースドライバー：現在 MySQL、PostgreSQL、達夢データベースドライバーをサポート - PostgreSQL: `org.postgresql.Driver` - MySQL: `com.mysql.cj.jdbc.Driver` - 達夢：`dm.jdbc.driver.DmDriver`
`url`	データベース接続 URL
`username`	データベースユーザー名
`password`	データベースパスワード
`staticPath`	静的リソースパス、デフォルト値を使用、変更不要
`mappingPath`	論理ファイルパス、デフォルト値を使用、変更不要
`templatePath`	HTML テンプレート生成パス、デフォルト値を使用、変更不要
`i18n`	国際化：`zh_CN` 中国語、`ja_JP` 日本語、`en_US` 英語
`appUrl`	アプリケーションアクセス URL。IP またはポートを変更する場合はここで更新してください

設定ファイルの例

yml

# VJSPAI プラグイン設定ファイル
vjspai:
  # データソース設定
  datasource:
    # データベースドライバー
    driverClassName: org.postgresql.Driver
    #driverClassName: com.mysql.cj.jdbc.Driver
    #driverClassName: dm.jdbc.driver.DmDriver
    # データベース接続 URL
    url: jdbc:postgresql://127.0.0.1:5432/xxx
    #url: jdbc:mysql://127.0.0.1:3306/xxx?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
    #url: jdbc:dm://127.0.0.1:5236/xxx?allowMultiQueries=true&useUnicode=true&characterEncoding=UTF-8&useSSL=true&&useOldAliasMetadataBehavior=true&serverTimezone=Asia/Shanghai&rewriteBatchedStatements=true
    # データベースユーザー名
    username: xxx
    # データベースパスワード
    # 暗号化パスワード：
    # キー生成方法：付属のアプリケーションプロジェクトの `SM4Utils.java` の `generateHexKey()` メソッドを使用してキーを生成し、下記の `sm4-key` に設定してください。
    # 機密情報の暗号化方法：`SM4Utils.java` の `encrypt("暗号化する文字列", "キー")` メソッド。
    # password: ENC(142d7d928b591d6c030c6350a21ecfc19db6718b2879eaeea3fac0bd0fb70d241)
    # 平文パスワード
    password: "123456"
  # VJSP ファイルパス
  resources: 
    # 静的リソースパス
    staticPath: src/main/resources/static/
    # 論理ファイルパス
    mappingPath: src/main/resources/vjsp-mapping/
    # HTML テンプレート生成パス
    templatePath: src/main/resources/template/html-template.html
  # 国際化
  i18n:
    list: zh_CN,en_US
    default: zh_CN
  # アプリケーションアクセス URL
  appUrl: http://localhost:8070/

# ENC 暗号化設定
jasypt:
  encryptor:
    # SM4 キー（32 文字の 16 進数文字列）
    sm4-key: 2fe4b2696b85208e81d30a71c44fb482
    # 暗号化クラス
    bean: jasyptStringEncryptor

🔐 セキュリティのヒント: 機密情報は .gitignore を通じて除外することを推奨します。または、環境変数を使用して資格情報を注入します。

その他のデータベースが必要な場合は、お問い合わせください

データベースドライバーと接続例

データベース	ドライバー (driverClassName)	接続 URL (url)
PostgreSQL	org.postgresql.Driver	jdbc:postgresql://127.0.0.1:5432/vjsp_form
MySQL	com.mysql.cj.jdbc.Driver	jdbc:mysql://127.0.0.1:3306/vjsp_form?serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=UTF-8&useSSL=false
達夢	dm.jdbc.driver.DmDriver	jdbc:dm://localhost:5236/vjsp_form?allowMultiQueries=true&useUnicode=true&characterEncoding=UTF-8&useSSL=true&&useOldAliasMetadataBehavior=true&serverTimezone=Asia/Shanghai&rewriteBatchedStatements=true

設定の有効化手順

設定ファイルの追加または変更後、新しい設定を完全に有効にするには、以下の手順を実行する必要があります：

現在のデザイナーウィンドウを閉じます。
デザイナーを再び開きます。

この時点で、デザイナーは最新の設定ファイルの内容を読み込み、適用します。

正しい設定を完了し、ファイルを保存すると、IDE の右下隅に "VJSP AI TOOLS started successfully" というプロンプトが表示されます。プロンプトが表示されない場合は、ファイルが正しく設定されているか、ローカルの Java バージョンを確認してください。

VJSPAI-LINK 設定 ​

環境要件 ​

🔧 この設定に依存する機能モジュール ​

📋 主な設定項目の説明 ​

設定ファイルの例 ​

データベースドライバーと接続例 ​

設定の有効化手順 ​