日本語

简体中文
English

日本語

简体中文
English

VJSPAI-LINK 設定 ​

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

✅ ファイルの場所: Project/.vjsp/vjspai-link.yml

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

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

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

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

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

正しく設定されていない場合、これらの機能は利用できなくなります。具体的には、データソースが読み込めなかったり、ワークフロー定義が見つからなかったり、フォームフィールドがレンダリングされなかったりします。

📋 主な設定項目の説明 ​

項目説明
datasourceデータソース設定
driverClassNameデータベースドライバー：現時点で MySQL、PostgreSQL、達夢（Dameng）データベースに対応PostgreSQL: org.postgresql.DriverMySQL: com.mysql.cj.jdbc.Driver達夢: dm.jdbc.driver.DmDriver
urlデータベース接続 URL
usernameデータベースユーザー名
passwordデータベースパスワード
staticPath静的リソースパス（デフォルト値のため、通常変更不要）
mappingPath論理マッピングファイルのパス（デフォルト値のため、通常変更不要）
templatePathHTML テンプレート生成パス（デフォルト値のため、通常変更不要）
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
    bean: jasyptStringEncryptor

🔐 セキュリティ上のヒント: .gitignore で機密情報を除外するか、環境変数経由で認証情報を注入することを推奨します。

他のデータベースのサポートが必要ですか？お問い合わせください

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

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

設定の有効化手順 ​

設定ファイルを追加または変更した後、新しい設定を完全に反映させるには、以下の手順を実行してください：

  1. 現在開いているデザイナー画面を閉じる。

  2. デザイナーを再度開く。

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