Skip to content

index.md

Latest commit

 

History

History
149 lines (113 loc) · 9.66 KB

index.md

File metadata and controls

149 lines (113 loc) · 9.66 KB
head
meta
name content
og:title
環境設定
meta
name content
og:url
/uroborosql-doc_v0.x/getting_started/

環境設定

ビルドツールの設定

uroboroSQLをMavenプロジェクトに組み込むには、pom.xmlに以下のライブラリ依存関係を追加して下さい。 uroboroSQLはMaven Central Repositoryで公開されています。

<dependency>
  <groupId>jp.co.future</groupId>
  <artifactId>uroborosql</artifactId>
  <version>0.25.0</version>
</dependency>

また、 より式言語ライブラリの選択が可能になりました。
以下の2つのライブラリのうち、どちらかを選択してライブラリ依存関係に追加して下さい。

OGNLを利用する場合

<dependency>
  <groupId>ognl</groupId>
  <artifactId>ognl</artifactId>
  <version>3.1.23</version>
</dependency>

Spring Expression Language(SpEL)を利用する場合

<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-expression</artifactId>
  <version>5.3.20</version>
</dependency>

uroboroSQLでREPLを使用する場合は追加で以下のライブラリ依存関係を追加してください。

<dependency>
  <groupId>org.jline</groupId>
  <artifactId>jline</artifactId>
  <version>3.11.0</version>
</dependency>
<dependency>
  <groupId>org.fusesource.jansi</groupId>
  <artifactId>jansi</artifactId>
  <version>1.18</version>
</dependency>

Gradleプロジェクトの場合は、build.gradleのdependencies内に以下のライブラリ依存関係を追加してください。

compile group: 'jp.co.future', name: 'uroborosql', version: '0.25.0'

// 式言語ライブラリとしてOGNLを使用する場合
compile group: 'ognl', name: 'ognl', version: '3.1.23'
// 式言語ライブラリとしてSpring Expression Language(SpEL)を使用する場合
compile group: 'org.springframework', name: 'spring-expression', version: '5.3.20'

// REPLを使用する場合
compile group: 'org.jline', name: 'jline', version: '3.11.0'
compile group: 'org.fusesource.jansi', name: 'jansi', version: '1.18'

::: tip uroboroSQLを利用するためには、Java8以上の環境が必要です。 :::

事前準備

事前準備として、

をインストールしてください。

サンプルプロジェクトの実行

uroboroSQLのサンプルアプリケーションであるuroborosql-sampleを使ってuroboroSQLを動かしてみましょう。

まず始めにuroborosql-sampleから最新のソースコードを取得します。

git clone https://github.com/future-architect/uroborosql-sample.git

取得できたらcloneしたフォルダに移動します。

cd uroborosql-sample

まずはサンプルアプリケーションを実行してみましょう。 サンプルアプリケーションは以下の起動コマンドで実行します。

mvn -PrunMain

これでサンプルアプリケーションが実行されます。
（初回実行時は必要なライブラリをダウンロードするため時間がかかります）
アプリケーションの実行ログが出力され、Mavenが正常終了すれば成功です。 色々ログが流れますが、この中で

  • DB接続
  • テーブル作成と初期データの挿入
  • SQLによる検索
  • トランザクション
  • SQLによる挿入、更新、削除
  • バッチ更新

といった一連の処理が実行されています。

サンプルプロジェクトの構成

ではサンプルアプリケーションの構成を見ていきましょう。

<<< ./tree.txt

主要なファイルの説明です

ファイル 説明
Main.java uroborosql-sampleのメインプログラムです。ここから各サンプルコードの呼び出しを行っています。
SqlFileApiSample.java / EntityApiSample.java 提供されているAPIの種類毎のサンプルコードです。
Department.java / Employee.java / DeptEmp.java テーブル構造を表すエンティティクラスです。サンプルコードの中で使用します。
Gender.java 性別を表すEnumクラスです。サンプルコードの中で使用します。
sqlフォルダ配下のSQL uroborosqlで実行するSQLファイルです。
dataフォルダ配下のTSV テーブルデータ作成用のTSVファイルです。Mainクラスの中でテーブルへの一括データ投入を行う際のデータとして利用します。
logback.xml ログ出力設定ファイルです。