DBFlute Maven Plugin

• DBFlute Maven Pluginとは？
• Pluginのインストール
  • 1.1.x なら *Java8
  • 1.0.x なら *Java6,7
• Mavenゴールたち
  • ゴールの実行の仕方
  • それぞれのゴールの概要
• コンフィグたち

DBFlute Maven Pluginとは？

DBFlute Maven Plugin は Apache Maven 2.x, 3.x で利用可能なプラグインです。 DBFlute のセットアップなどの処理を Maven の mvn コマンドを通して実行することができます。

Pluginのインストール

1.1.x なら *Java8

pom.xml の plugins に、dbflute-maven-plugin を設定します。

e.g. プラグイン情報の追加 (実行のための基本的な設定) {1.1.0} @pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project>
...
    <build>
        <plugins>
            ...
            <plugin>
                <groupId>org.dbflute</groupId>
                <artifactId>dbflute-maven-plugin</artifactId>
                <version>1.1.0</version>
                <configuration>
                    <clientProject>xxxdb</clientProject>
                    <packageBase>com.xxx.dbflute</packageBase>
                </configuration>
            </plugin>
            ...
        </plugins>
    </build>
...
</project>

1.0.x なら *Java6,7

1.0.x用の方は、Seasarのリポジトリに入っているので、pluginRepositoryの設定が必要です。

e.g. プラグインのリポジトリを追加 @pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project>
...
    <pluginRepositories>
        <pluginRepository>
            <id>maven.seasar.org</id>
            <name>The Seasar Foundation Maven2 Repository</name>
            <url>http://maven.seasar.org/maven2/</url>
        </pluginRepository>
    </pluginRepositories>
...
    <build>
        <plugins>
            <plugin>
                <groupId>org.seasar.dbflute</groupId>
                <artifactId>dbflute-maven-plugin</artifactId>
                <version>1.0.0</version>
                <configuration>
                    <dbfluteVersion>1.0.5N</dbfluteVersion>
                    <clientProject>xxxdb</clientProject>
                </configuration>
            </plugin>
        </plugins>
    </build>
...
</project>

Mavenゴールたち

ゴールの実行の仕方

コマンドラインにて、mvnコマンドで dbflute:xxx という形式で実行します。

e.g. dbflute:download ゴールを叩く！ @Command
...$ mvn -e dbflute:download

それぞれのゴールの概要

DBFlute Maven Plugin では、以下のゴール (goal) を提供します。

download

指定されたバージョンをダウンロードして、展開。

既存のDBFluteクライアントの参照を変更したりはせずダウンロード展開だけなので、 アップグレード目的の場合はDBFluteクライアントの_project.bat(sh)を手動で修正する必要あり。

create-client

ダウンロードした、指定したバージョンのdbflute_dfclient.zipを展開して、データベースのパラメータなどを更新。 コンフィグ設定を必要とするので、設定内容を確認してから。

1.1.x (Java8) を前提のセットアップドキュメントを参考に。

Mavenによるセットアップ

manage

manage.[sh|bat]を実行。実行後にメニューから実行するタスクを選ぶ

jdbc

jdbc.[sh|bat]を実行。DBスキーマのメタデータを取得

doc

doc.[sh|bat]を実行。ドキュメントなどを自動生成

generate

generate.[sh|bat]を実行。クラスを自動生成

outside-sql-test

outside-sql-test.[sh|bat]を実行。外だしSQLを一括テスト

sql2entity

sql2entity.[sh|bat]を実行。外だしSQL対応のクラスを自動生成

replace-schema

replace-schema.[sh|bat]を実行。開発用DBスキーマを再構築

DBFluteクライアントが二つ存在する場合、DBFluteタスク実行ゴールは clientProject で指定されているDBFluteクライアントのものを実行します。

コンフィグたち

clientProject

DBFluteクライアントの名前、dbflute_xxx の xxx 部分に相当

SiteMap Author's BlogBTS