DBFlute Intro (いんとろ)

Alto DBFlute の利用を支援するための、IDEなどに依存しない独立したgUIツールです。

一方で、O/RマッパーとしてDBFluteを使う場合も、DBFlute Introは大いに活躍します。

• DBFlute Introとは？
  • gUIでDBFluteを利用できるツール
  • 想定される利用ケース
  • オープンソースとして運用
• Introのダウンロード
  • jarファイルをひとつ (for Alto DBFluteスタイル)
  • Introタスクでダウンロード (for ORM DBFluteスタイル)
• 使い方の流れ
• DBFlute Intro を起動
  • Javaコマンドから起動 (for Alto DBFluteスタイル)
  • Introタスクから起動 (for ORM DBFluteスタイル)
• まずは Welcome !
  • Welcome画面
  • セットアップするための最低限の項目
  • JDBCドライバのパスの補足
  • JDBC接続URLの補足
  • O/Rマッパーのための項目
  • connect as test で接続テスト
  • Create ボタンで Create
  • O/Rマッパー利用ならセットアップへ
• とりあえず、テーブル定義ドキュメント (SchemaHTML)
  • トップ画面
  • Operate画面の初期状態
  • ドキュメントの生成ボタン
  • Operate画面のドキュメントリンクあり
  • ドキュメントリンクをクリック
• DB変更したら、またドキュメント生成 (HistoryHTML)
  • 最新のSchemaHTML
  • HistoryHTML表示リンク
• Introのいろいろな機能
  • DBコメントにデコメント
  • DBコメントにハコメント
• DBFlute本体はどこに？

DBFlute Introとは？

gUIでDBFluteを利用できるツール

アプリの外側で活躍するDBFluteの機能 (Alto DBFlute) を、インストールから実行までgUIだけで実行できるツールです。 Javaの実行環境(JRE)さえあれば利用できる導入しやすいツールです。

想定される利用ケース

大きく二つになります。

Alto DBFluteスタイル

Intro経由でDBFluteのDB管理支援機能(Alto DBFlute)を使う

ORM DBFluteスタイル

DBFluteをO/Rマッパーとして使う上でIntroで補助操作する

※ドキュメントは主に、Alto DBFluteスタイルを中心に書いています。

オープンソースとして運用

github で開発されているオープンソースです。 DBFlute本体とは、独立した運用がされていますので、本家のサイトにも注目です。(ということで、ここでは、簡単な利用方法の説明だけをしていきます)

以下のようにリリースされています。

2022/07/15

0.6.0 :: Intro経由のSchemaHtmlからSchemaDiagramとNeighborhoodSchemaHtmlを表示できるよう修正

2022/01/01

0.5.0 :: SchemaPolicyCheck画面のUI改善

2021/05/01

0.4.0 :: SchemaPolicyCheck画面のデザイン修正

2021/01/01

0.3.11 :: ReplaceSchema画面にボタン追加、全体デザインの微修正

2020/02/21

0.3.10 :: AlterCheck時に、最新のzipファイルを利用しない不具合を修正

2020/01/12

0.3.9 :: AlterCheckのStep1で、チケット番号入力を必須に

2020/01/01

0.3.8 :: SchemaPolicyCheckのStatement登録/削除を追加

2019/10/24

0.3.7 :: targetLanguage と targetContainer のデフォルト値対応等、細かい改善

2019/10/20

0.3.6 :: AlterCheck画面リニューアル、gUIで完結するように

2019/07/07

0.3.5 :: AlterCheck、SchemaPolicyCheckの細かい改善

2019/05/01

0.3.4 :: SchemaPolicyCheckの画面追加、ナビゲーションバーを追加

2019/01/01

0.3.3 :: AlterCheckの調整、SchemaPolicyCheckの設定

2018/12/01

0.3.2 :: ReplaceSchema, AlterCheckの実行

2018/10/21

0.3.1 :: Java11 で実行できるように

2018/09/24

0.3.0 :: riot.jsに移行、細かい改善

2018/09/01

0.2.3 :: 起動IPを指定できるように (for デコメントサーバー)

2018/06/30

0.2.2 :: デコメントサーバーモードをサポート

2018/05/20

0.2.1 :: デコメントの改善、ハコメントのデビュー

2018/01/01

0.2.0 :: デコメントのプロダクションリリース

2017/11/26

0.1.3 :: デコメントのファーストリリース

2017/05/05

0.1.2 :: DBFluteのセットアップ、SchemaHTMLなど基本を一通り

Introのダウンロード

jarファイルをひとつ (for Alto DBFluteスタイル)

インストールという概念はありません。単にファイル (.jar) を一つダウンロードするだけです。

githubのリリースページから最新版をダウンロードできます。

Introのリリースページ

dbflute-intro Releases | github

そして、例えば以下のよう感じで、どこかのディレクトリに入れておくと良いでしょう。

e.g. DBFlute Intro のjarファイルを dbflute-intro ディレクトリ配下に @Directory
...
 |-...
 |
 |-dbflute-intro
 |  |
 |  |-dbflute-intro.jar
 |
 |-...

後に、DBFlute を "O/Rマッパー" (ORM DBFluteスタイル) としても利用する想定であれば、クラスを自動生成するプロジェクトの直下に置きましょう。

e.g. DBFlute Intro のjarファイルを maihama プロジェクトディレクトリ配下に @Directory
...
 |-maihama
 |  |-src/main/java
 |  |-src/main/resources
 |  |-...
 |  |-dbflute-intro.jar
 |  |-...
 |  |-pom.xml
 |
 |-...

特にバージョン番号は付けていません。アップグレードするときは上書きしてしまいましょう。起動するとメイン画面の下の方に表示される System Info にバージョンが表示されます。常に最新を使っていきましょう。

Introタスクでダウンロード (for ORM DBFluteスタイル)

すでに DBFlute がセットアップ済みで、普段からDBFluteタスクを直接実行している状態であれば、Manageタスクの 88 (intro) からダウンロードすると良いでしょう。同時に起動もします。(もし最新版があれば上書きダウンロードされるので、アップグレードを気にする必要はありません)

ただ、ORM DBFluteスタイルでも、DBFluteの初回セットアップをIntroで行うなら、Alto DBFluteスタイルと同じです。jarファイルをダウンロードして配置しましょう。

使い方の流れ

1. DBFlute Intro を起動
2. まずは Welcome !
3. とりあえず、テーブル定義ドキュメント (SchemaHTML)
4. DB変更したら、またドキュメント生成 (HistoryHTML)

DBFlute Intro を起動

Javaコマンドから起動 (for Alto DBFluteスタイル)

Mac/Windows

コマンドラインから... java -jar dbflute-intro.jar

※javaコマンドが叩ける必要があります。

Introタスクから起動 (for ORM DBFluteスタイル)

すでに DBFlute がセットアップ済みで、普段からDBFluteタスクを直接実行している状態であれば、Manageタスクの 88 (intro) でダウンロードと同時に起動できます。その場合、Welcome画面はスキップされてトップ画面が表示されます。(次の "まずは Welcome !" は読み飛ばしましょう)

ただ、ORM DBFluteスタイルでも、DBFluteの初回セットアップをIntroで行うなら、Alto DBFluteスタイルと同じです。jarファイルをコマンドから起動しましょう。

まずは Welcome !

DBFlute Intro を起動すると、DBFluteをセットアップするための最低限必要な情報 を入力する画面が ブラウザ で表示されます。(起動に少し時間がかかるのでお待ちください)

Welcome画面

まず表示されるのが Welcome画面 です。

ここで必要な情報を入力して、DBFluteを利用するための初期セットアップ (DBFluteエンジンのダウンロードとDBFluteクライアントのセットアップ) を行います。

Welcome画面

(そのディレクトリにDBFluteが何もセットアップされていない場合は、必ずこのWelcome画面)

セットアップするための最低限の項目

*Project Name

DBFluteクライアントのプロジェクト名、通常はスキーマ名を指定

*DBMS

対象のデータベースの種類 e.g. MySQL, PostgreSQL, Oracle

*JDBC Driver

JDBCドライバのクラス名、DBMSを選択すると自動入力される

JDBC Driver Path

JDBCドライバのjarファイルのパス (補足あり)

*URL

JDBCでデータベースに接続するためのURL (補足あり)

Schema

接続するスキーマ、OracleやDB2などでは必須

*User

データベースに接続するときのユーザ

Password

データベースに接続するときのパスワード

迷う場合は、"DBMSごとの取扱い" の該当DBMSのページを参考に。

JDBCドライバのパスの補足

DBFlute Intro は "JDBCドライバ" を利用して接続するため、JDBCドライバが DBFlute に同梱されていないDBMS(同梱が許されていないDBMS)の場合は、自分でダウンロードする必要があります。

MySQL

同梱されているので指定不要

PostgreSQL

同梱されているので指定不要

Oracle

"ojdbc.jar ダウンロード" で検索してダウンロード画面へ

DB2

"db2jcc.jar ダウンロード" で検索してダウンロード画面へ

SQLServer

"sqljdbc4.jar ダウンロード" で検索してダウンロード画面へ

H2 Database

同梱されているので指定不要

Apache Derby

"derby ダウンロード" で検索してダウンロード画面へ

JDBC接続URLの補足

DB接続のURLは、DBMSを選択することで自動入力されるURLひな形の xxx 部分にデータベース名もしくはスキーマ名を入力します。例えば、以下のような感じになります。

MySQL

jdbc:mysql://localhost:3306/maihamadb

PostgreSQL

jdbc:postgresql://localhost:5432/maihamadb

Oracle

jdbc:oracle:thin:@localhost:1521:XE

DB2

jdbc:db2://localhost:50000/dfexdb

SQLServer

jdbc:sqlserver://localhost:1433;databaseName=maihamadb;

H2 Database

jdbc:h2:file:../src/main/resources/maihamadb/maihamadb

Apache Derby

jdbc:derby:../src/main/resources/librarydb;create=true

O/Rマッパーのための項目

O/Rマッパーとしての利用も想定しているなら、"O/R Mapper settings" を押して追加項目も調整しましょう。

*Language

自動生成クラスのプログラミング言語 e.g. Java

*DI Container

自動生成クラスが利用するDIコンテナ e.g. Lasta Di, Spring

*generation Package

自動生成クラスのパッケージ e.g. org.docksidestage.dbflute

connect as test で接続テスト

"connect as test" にチェックを入れた状態で Create すると、入力された情報で実際にデータベースにテスト接続しにいきます。 接続できない場合は、入力情報に間違いがある可能性があるので入力し直しましょう。

Create ボタンで Create

Create ボタンを押すと、最新版の "DBFluteエンジン" をダウンロードして、入力された情報を元にDBFluteクライアントをセットアップします。

成功すれば、DBFlute Intro のトップ画面に自動で遷移し、作成したDBFluteクライアントが確認できます。 DBFlute Intro の war ファイルと同じディレクトリを見ると、DBFluteクライアントとDBFluteエンジンがあるはずです。 (mydbfluteの下には、intro_resourcesというディレクトリがあり、Intro自体のログなどが出力されています)

e.g. DBFlute Intro のwarファイルを maihama プロジェクトディレクトリ配下に @Directory
...
 |-dbflute_maihamadb
 |
 |-mydbflute
 |  |-dbflute-1.1.1
 |  |-intro_resources
 |  |  |-log
 |  |  |  |-app_intro.log
 |
 |-dbflute-intro.jar
 |
 |-...

O/Rマッパー利用ならセットアップへ

もし、DBFluteをO/Rマッパー利用する ORM DBFluteスタイルなのであれば、セットアップのページに行きましょう。 DBFluteランタイムの依存設定や、O/Rマッパー固有のdfpropの設定など行っていきます。

とりあえず、テーブル定義ドキュメント (SchemaHTML)

トップ画面

トップ画面

Welcome画面で Create が終わると、DBFlute Intro のトップ画面が表示されます。そして表示されているDBFluteクライアントを 選択することでOperate画面に繊維できます。この画面で様々な DBFlute の操作ができますが、まずはドキュメントを生成しましょう。

Operate画面の初期状態

Operate画面

ドキュメントの生成ボタン

"generate Documents (jdbc, doc)" を叩いてみましょう。 (DBFluteクライアントを経由して、JDBCタスクとDocタスクが実行され、実際にデータベースにアクセスしてドキュメントを自動生成します)

少し待つと、"テーブル定義ドキュメント (SchemaHTML)" へのリンクが表示されます。

Operate画面のドキュメントリンクあり

Operate画面のドキュメントリンクあり

ドキュメントリンクをクリック

したら、"Open the table layout, SchemaHTML" のリンクをクリックしてみましょう。

ブラウザ上の別タブで SchemaHTML が表示されます。

SchemaHTML Example

DB変更したら、またドキュメント生成 (HistoryHTML)

DBが変わったら、またドキュメント生成をしましょう。

最新のSchemaHTML

ドキュメント生成ボタンを押して SchemaHTML を開くと、新しいスキーマの情報が表示されます。

このように、ボタンを押せばすぐに最新状態のドキュメントが生成できます。

HistoryHTML表示リンク

そして、HistoryHTMLリンクをクリックしてみましょう。DB変更の履歴が表示されます。

HistoryHTMLの例

Introのいろいろな機能

DBコメントにデコメント

Intro経由で開いたSchemaHTML上で、DBコメントを追加・修正できます。

DBコメントにハコメント

Intro経由で開いたHistoryHTML上で、履歴コメントを追加・修正できます。

e.g. DBFlute Intro のファイルを dbflute-intro 配下に @Directory
どこかのディレクトリ
 |-...
 |
 |-dbflute-intro
 |  |-dbflute_xxx      // DB名が yourdb なら dbflute_yourdb
 |  |  |-dfprop        // DB接続情報が保持されている、その他もろもろの設定
 |  |  |-log           // DBFlute実行時のログ
 |  |  |-...
 |  |
 |  |-mydbflute
 |  |  |-dbflute-1.x.x
 |  |
 |  |-dbflute-intro.jar
 |
 |-...