Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/release-6u2'
Browse files Browse the repository at this point in the history
  • Loading branch information
kankichi00 committed Sep 27, 2024
2 parents b6e2663 + 056a2bf commit 4ec7321
Show file tree
Hide file tree
Showing 2 changed files with 46 additions and 61 deletions.
46 changes: 32 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,13 @@ Nablarchを使ったHTTPメッセージングウェブサービスのExampleで
### 1.動作環境
実行環境に以下のソフトウェアがインストールされている事を前提とします。
* Java Version : 17
* Maven 3.9.0以降
* Maven 3.9.9以降

以下は、本手順では事前準備不要です。

|ソフトウェア|説明|
|:---|:---|
|APサーバ|このアプリケーションはJetty12を使用しています。jetty-ee10-maven-pluginはJetty12へのアプリケーションのデプロイ、起動を行います。|
|APサーバ|このアプリケーションはJetty 12を使用しています。jetty-ee10-maven-pluginはJetty 12へのアプリケーションのデプロイ、起動を行います。|
|DBサーバ|このアプリケーションはH2 Database Engine(以下H2)を組み込んであるため、別途インストールの必要はありません。|

### 2. プロジェクトリポジトリの取得
Expand All @@ -27,20 +27,38 @@ Gitを使用している場合、アプリケーションを配置したいデ

Gitを使用しない場合、最新のタグからzipをダウンロードし、任意のディレクトリへ展開してください。

### 3. アプリケーションのビルド
アプリケーションのビルドを行います。
ビルドの際に、gspプラグインによりデータベースのセットアップが行われます。
### 3. アプリケーションのビルドと起動
jetty-ee10-maven-pluginを実行し、組み込みJettyを起動させます。以下のコマンドを実行してください。

$mvn compile
$cd nablarch-example-http-messaging
$mvn jetty:run

#### コマンドの補足
本Exampleアプリケーションを起動するまでに必要な手順は以下になります。

1. データベースのセットアップ及びエンティティクラスの作成
1. アプリケーションのビルド
1. Jetty 12の起動

これらの手順はJetty 12を起動する`jetty:run`を実行する際にすべて含まれていますが、個別に実行することもできます。

##### データベースのセットアップ及びエンティティクラスの作成

以下のコマンドを実行することでデータベースのセットアップ及びエンティティクラスの作成を行うことができます。

$mvn generate-resources

※gspプラグインをJava 17で実行するためにはJVMオプションの指定が必要ですが、そのオプションは`.mvn/jvm.config`で指定しています。

### 4. アプリケーションの起動
jetty-ee10-maven-pluginを実行し、組み込みJettyを起動させます。以下のコマンドを実行してください。
##### アプリケーションのビルド

$mvn jetty:run
以下のコマンドを実行することでアプリケーションのビルドを行うことができます。

$mvn compile

`compile`を実行するとデータベースのセットアップ及びエンティティクラスの作成処理も行われます。

### 5. テスト用クライアントクラスからのアクセス
### 4. テスト用クライアントクラスからのアクセス

以下のテスト用クライアントクラスのmainメソッドを実行します。

Expand All @@ -59,21 +77,21 @@ jetty-ee10-maven-pluginを実行し、組み込みJettyを起動させます。

以降はコマンドプロンプトからクライアントクラスを実行する手順となります。

#### 5.1. クライアントクラスのビルド
#### 4.1. クライアントクラスのビルド

以下のコマンドを実行し、テスト用ソースコードのコンパイルを行い、クライアントクラスが依存するjarをtarget/dependency配下に出力してください。

$cd nablarch-example-http-messaging
$mvn test-compile
$mvn dependency:copy-dependencies -DoutputDirectory=target/dependency

#### 5.2. クライアントクラスの実行
#### 4.2. クライアントクラスの実行

以下のコマンドを実行し、クライアントクラスのmainメソッドを実行してください。

$java -cp .\target\test-classes\;.\target\classes\;.\target\dependency\*; com.nablarch.example.client.ProjectClient

#### 5.3. 結果検証
#### 4.3. 結果検証

標準出力に以下の内容が出力されていることを確認してください。

Expand All @@ -82,7 +100,7 @@ jetty-ee10-maven-pluginを実行し、組み込みJettyを起動させます。

DBに登録された値は、H2のコンソールから確認してください。

### 6. DBの確認方法
### 5. DBの確認方法

1. https://www.h2database.com/html/download.html からH2をインストールしてください。

Expand Down
61 changes: 14 additions & 47 deletions pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

<groupId>com.nablarch.example</groupId>
<artifactId>nablarch-example-http-messaging</artifactId>
<version>6u1</version>
<version>6u2</version>
<packaging>war</packaging>

<properties>
Expand Down Expand Up @@ -36,14 +36,14 @@
<dependency>
<groupId>com.nablarch.profile</groupId>
<artifactId>nablarch-bom</artifactId>
<version>6u1</version>
<version>6u2</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>org.junit</groupId>
<artifactId>junit-bom</artifactId>
<version>5.8.2</version>
<version>5.11.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
Expand All @@ -57,7 +57,7 @@
<dependency>
<groupId>org.glassfish.jersey</groupId>
<artifactId>jersey-bom</artifactId>
<version>3.1.1</version>
<version>3.1.8</version>
<type>pom</type>
<scope>import</scope>
</dependency>
Expand Down Expand Up @@ -198,10 +198,15 @@
</resources>

<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.13.0</version>
</plugin>
<plugin>
<groupId>jp.co.tis.gsp</groupId>
<artifactId>gsp-dba-maven-plugin</artifactId>
<version>5.0.0</version>
<version>5.1.0</version>
<configuration>
<adminUser>${db.adminUser}</adminUser>
<adminPassword>${db.adminUser}</adminPassword>
Expand Down Expand Up @@ -242,7 +247,7 @@
<plugin>
<groupId>org.eclipse.jetty.ee10</groupId>
<artifactId>jetty-ee10-maven-plugin</artifactId>
<version>12.0.3</version>
<version>12.0.12</version>
<configuration>
<httpConnector>
<port>9080</port>
Expand All @@ -252,33 +257,22 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>3.2.0</version>
<version>3.4.0</version>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.22.2</version>
<version>3.5.0</version>
<configuration>
<!-- MANIFEST.MFでClass-Pathを指定すると、依存jar内で定義されているtaglibのuriを正しく解決してくれない。 -->
<useManifestOnlyJar>false</useManifestOnlyJar>
</configuration>
</plugin>
<!-- カバレッジ取得 -->
<plugin>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<version>0.8.3</version>
<configuration>
<excludes>
<exclude>**/com/nablarch/example/app/entity/*</exclude>
</excludes>
</configuration>
</plugin>
<!-- 自動生成されたEntityをビルド対象に組み込む -->
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>build-helper-maven-plugin</artifactId>
<version>3.0.0</version>
<version>3.6.0</version>
<executions>
<execution>
<phase>generate-sources</phase>
Expand All @@ -292,32 +286,5 @@
</executions>
</plugin>
</plugins>
<extensions>
<extension>
<groupId>org.apache.maven.wagon</groupId>
<artifactId>wagon-webdav-jackrabbit</artifactId>
<version>3.0.0</version>
</extension>
</extensions>
</build>
<reporting>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-report-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<configuration>
<additionalparam>-Xdoclint:none</additionalparam>
</configuration>
</plugin>
<plugin>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<version>0.8.0</version>
</plugin>
</plugins>
</reporting>
</project>

0 comments on commit 4ec7321

Please sign in to comment.