ローカル開発環境設定と VJSP プロジェクト起動ガイド

ステップ1：基本プロジェクトファイルのダウンロード

プロジェクトの基本ファイルパッケージを取得し、ローカルディレクトリに解凍します。

ステップ2：VS Codeでプロジェクトを開く

VSCodeを起動し、「ファイル > フォルダを開く」から解凍したプロジェクトのルートディレクトリを選択します。

ステップ3：環境依存のインストール

プロジェクトの実行には以下の環境依存が必要です。指定バージョンでの設定を推奨します：

• JDK 1.8 以上

• Maven 3.6 以上（本記事では 3.8.1 を例とします）

• データベース（PostgreSQL/MySQL いずれか）

• Redis サーバー

Maven インストール手順

1. インストールパッケージのダウンロード

   Maven公式サイトにアクセスし、最新バージョンのバイナリ圧縮パッケージ（例：apache-maven-3.8.1-bin.zip）をダウンロードします。

2. ファイルの解凍

   圧縮パッケージをローカルディレクトリ（例：C:\Apache\maven）に解凍します。パスに中文、スペース、特殊文字が含まれないことを確認してください。

3. システム変数の設定

   • 「コントロールパネル > システム > システムの詳細設定 > 環境変数」を開きます。

   • 「システム環境変数」領域で「新規」をクリックし、以下を設定します：

     • 変数名：MAVEN_HOME

     • 変数値：Maven 解凍ルートディレクトリ（例： C:\Apache\maven-3.8.1）

   • 「OK」をクリックして保存します。

4. Path 変数の追加

   • 「システム環境変数」から Path 変数を探し、「編集」をクリックします。

   • 「新規」をクリックし、%MAVEN_HOME%\bin と入力し、「OK」をクリックして設定を完了します。

5. インストールの確認

   コマンドプロンプト（CMD）を開き、mvn -v と入力します。Mavenのバージョン及びJava環境情報が出力されれば、インストール成功です。

6. VS Code の設定

   VSCode で Maven 拡張のパスを設定し、ローカルインストールディレクトリと一致することを確認します。

ステップ4：プロジェクト起動フロー

1. ローカル依存パッケージのインポート

   • コマンドプロンプトを開き、プロジェクトルートディレクトリ下の lib フォルダに移動します（cd lib を実行）。

   • 以下のコマンドを実行して、JAR パッケージをローカル Maven リポジトリにインストールします：

   mvn install:install-file -Dfile="vjsp-form-3.0-RELEASE.jar" -DpomFile="pom.xml"

   

   • VSCode の「MAVEN」パネルで、vjsp-boot-form > Lifecycle を展開します：

     • まず clean コマンドを実行してプロジェクトをクリーンアップします（ターミナルで mvn clean と入力可能）。

     • 次に install コマンドを実行してプロジェクトをビルドします（ターミナルで mvn install と入力可能）。

2. プロジェクトの起動

   • プロジェクトディレクトリ内で起動クラスを探します： /src/main/java/net/vjsp/VjspApplication.java

   • ファイル上部の「Debug」ボタンをクリックしてプロジェクトを起動します。

   • プロジェクトの起動に成功したら、ブラウザで http://localhost:8080/vjsp/ にアクセスしてプロジェクトのホームページを確認できます。

よくある問題

コンテナ「Maven 依存関係」が存在しないライブラリを参照している

解決策：

Maven 設定ファイル settings.xml のローカルリポジトリパスを確認し、以下を強制的に指定する必要があります：

<localRepository>C:\Users\CR7\.m2\repository</localRepository>

Maven 依存関係がこのパスから読み込まれるかダウンロードされることを確認します。