About

ドキュメント

Javadoc

モジュール

プロジェクト文書

Built by Maven

説明

概要

データベースのデータをCSV形式でダンプ出力します。ダンプの対象となるのはエンティティに対応するテーブルです。

ダンプされるファイルの形式については、ダンプファイル を参照ください。

パラメータ

Antタスクへのパラメータを以下に示します。

トップレベルのパラメータ

属性 説明 デフォルト値 必須
classpathDir エンティティクラスを含むクラスパスのディレクトリです。このディレクトリはタスクの実行時のクラスパスに含まれている必要があります。 - YES
rootPackageName ルートパッケージ名です。 "" NO
entityPackageName エンティティクラスのパッケージ名です。エンティティクラスは、rootPackageNameとこの値をピリオドで連結したパッケージに配置されているとみなされます。 "entity" NO
entityClassNamePattern このタスクで対象とするエンティティクラス名の正規表現です。 ".*" NO
ignoreEntityClassNamePattern このタスクで対象としないエンティティクラス名の正規表現です。 "" NO
migrateDir マイグレーション用のファイルを管理するディレクトリです。 "db/migrate" NO
ddlInfoFile DDLのバージョン番号を管理するファイルです。 "db/ddl-info.txt" NO
versionNoPattern バージョン番号のパターンです。バージョン番号に対応するディレクトリ名に使用されます。 "0000" NO
dumpDirName ダンプファイルを出力するディレクトリ名です。 "040-dump" NO
dumpDir ダンプファイルを出力するディレクトリです。指定しない場合、最新のバージョンディレクトリ以下のdumpDirName属性で指定した名前のディレクトリに出力されます。 - NO
dumpFileEncoding ダンプファイルのエンコーディングです。 "UTF-8" NO
genDialectClassName S2JDBC-Genのダイアレクトインタフェースの実装クラス名です。ここに指定するクラスはorg.seasar.extension.jdbc.gen.dialect.GenDialectインタフェースを実装している必要があります。指定しない場合はS2JDBCのダイアレクト に対応したデフォルトのクラスが使用されます。 - NO
configPath JdbcManagerのコンポーネント定義を含む設定ファイルです。このタスクの実行に使用されます。 "s2jdbc.dicon" NO
env 環境名です。 "ut" NO
applyEnvToVersion バージョンディレクトリに環境名を適用する場合"true"を指定します。trueを指定すると、通常のバージョンディレクトリとは別の環境名つきのバージョンディレクトリにダンプファイルが出力されます。dumpDirを指定しない場合にのみ有効です。 "false" NO
jdbcManagerName JdbcManagerのコンポーネント名です。 "jdbcManager" NO
factoryClassName S2JDBC-Genの公開されたインタフェースの実装を作成するファクトリのクラス名です。S2JDBC-Genをカスタマイズする場合に独自のファクトリクラスを指定できます。ここに指定するクラスはorg.seasar.extension.jdbc.gen.internal.factory.Factoryインタフェースを実装している必要があります。 "org.seasar.extension.jdbc.gen
.internal.factory.FactoryImpl"
NO
commandInvokerClassName S2JDBC-Genのコマンドを呼び出すクラスの名前です。コマンドの呼び出し前後で任意の処理を実行したい場合に指定します。ここに指定するクラスはorg.seasar.extension.jdbc.gen.command.CommandInvokerインタフェースを実装している必要があります。 "org.seasar.extension.jdbc.gen
.internal.command.CommandInvokerImpl"
NO
classpath このタスクを実行する際のクラスパスです。 - classpathrefが指定されていない場合YES
classpathref このタスクを実行する際のクラスパスの参照です。 - classpathが指定されていない場合YES

ネストした要素として指定されるパラメータ

jvmArg

このタスクの大部分の処理は別VMで行われます。VMに引数を渡す場合は<jvmarg>要素を使用します。 これはAntのJavaタスクで使用できる<jvmarg>と同じです。 使用可能な属性やネストした要素についてはAntのドキュメントを参照してください。

環境名つきバージョンディレクトリにダンプ出力する

プロジェクトで共有するダンプデータとは別にダンプデータを管理したい場合は、環境名つきバージョンディレクトリにダンプ出力します。 環境名つきバージョンディレクトリにダンプ出力するにはapplyEnvToVersion属性に"true"を設定します。

<dump-data
    classpathDir="build/classes"
    rootPackageName="examples"
    applyEnvToVersion="true"
    env="ut"
    classpathRef="classpath"
/>

上記の設定でタスクを実行すると、バージョンディレクトリと環境名を#で連結したディレクトリ以下にダンプ出力されます。

db
└─migrate
    ├─0001
    │  └─create
    │      └─・・
    │
    └─0001#ut
        └─create
            └─040-dump
                ├─employee.csv
                ├─address.csv
                └─・・

環境名つきバージョンディレクトリ以下のダンプデータは、Load-DataタスクMigrateタスク で、環境名なしのバージョンディレクトリに優先してロードされます。