Jetty Gradle でビルド

目次

FrontPage
・Chromebook
・Random
・機械学習
・さくらVPS
・Fedora13
・SuSe10
・Docker
・Ansible
・Java
・Scala
・Python
・Ruby
・Lisp
・Computer
・GIS
・HTML
・Culture
・Link

訪問者

total: 1100
today: 1
yesterday: 2
now: 7

更新

最新の10件

人気の10件

MenuBar

Gradle とは？ †

• Javaアプリのビルドツール
• Yet another maven
  • 依存関係を解決する際のライブラリの取得元は Maven と同じ
  • Maven Central を参照しているし、Sonatype Nexus で自前のレポジトリを作ってもいい
• Maven が XML なのに対して、Gradle は Groovy スクリプト
• その気になれば Gladle の中に Groovy (≒Java) でプログラムを書けるけど、それは最後の手段やね。普通は、Maven みたいなことを XML ぢゃなく書きたいという程度の認識でいいだろう

インストール †

• Debian (Chromebook の Crostini) なら

  $ sudo apt intsall gradle

• Windows なら https://gradle.org/ からバイナリをダウンロードしてきて、PATH を通す

プロジェクトの作成 †

$ gradle init --type java-library

まぁ、コマンドラインじゃなくても IDE (Eclipse/Netbeans/IntelliJ) に任せればよかろう

ディレクトリ構成 †

$ tree
.
└── JettyExam
    ├── LICENSE
    ├── README.md
    ├── bin
    │     ├── main/ ← コンパイル結果
    │     └── test/ ← コンパイル結果
    ├── build / ← ビルド結果 (プロジェクト全体を zip 圧縮したものや、製品の jar など)
    ├── build.gradle ← ★これが gradle スクリプト
    ├── gradle
    │     └── wrapper
    │             ├── gradle-wrapper.jar
    │             └── gradle-wrapper.properties
    ├── gradle.properties
    ├── gradlew      ← ★これが、このプロジェクト向けの設定が入った gralde 実行スクリプト。プロジェクト作成時に自動生成される
    ├── gradlew.bat  ← ★その Windows用
    ├── settings.gradle
    └── src
        ├── main
        │     ├── java/ ← ソースコード
        │     └── resources/ ← 設定ファイル類
        └── test
             ├── java/ ← テストコード 
             └── resources / ← テストデータ類

ビルドコマンド †

• gradle コマンドではなく、gradlew を実行します
  • gradlew 内部で、いろいろな設定やお膳立てをしたあと grale が呼び出されている
• ビルド

  $ gradlew build

• テスト

  $ gradlew test

• Javadoc

  $ gradlew javadoc

• これも CI なんかではコマンドラインからの実行が必要だけど、普通は IDE から使うのが良かろう

ひな型 †

https://github.com/kagyuu/JettyExam/blob/master/build.gradle

Tips †

定数定義 †

buildscript {
  ext.buildConfig = [
      'compileSdk': 11,
      'targetSdk': 11
  ]
  ext.versions = [
      'jetty': '9.4.25.v20191220',
      'jersey': '2.30',
      'derby': '10.15.1.3'
  ]
}

とすると、${buildConfig.compileSdk} や ${versions.jettty} で、値を参照できる

ライブラリのバージョン確認 †

plugins {
    // check library versions
    // $ ./gradlew dependencyUpdates
  id "com.github.ben-manes.versions" version "0.27.0"
}

というように build.gradle を書いておき、コマンドラインから

$ ./gradlew dependencyUpdates

を実行すると最新のライブラリが使われているか調べることができる

全部盛りJar (Fat Jar) を作る †

plugins {
 id "com.github.johnrengelman.shadow" version "4.0.4"
}

で全部盛りJarが作られる

java -jar で実行されるクラスの指定 †

jar {
    manifest {
        attributes "Main-Class" : "com.example.jetty.Main"
    }
}

で Jar の MANIFEST に属性を書き込むことができる

gradlew run で実行されるクラスの指定 †

mainClassName = 'com.example.jetty.Main'

javac のオプションの指定 †

sourceCompatibility = "${buildConfig.compileSdk}" // -source
targetCompatibility = "${buildConfig.targetSdk}" // -target'

mainClassName = "${buildConfig.main}"
 
compileJava {
    options.encoding = 'UTF-8'
    options.compilerArgs << '-Xlint:unchecked'
}

• Gradle の compileJava セクションで想定されているオプションは options.XXXX = XXXX 形式で設定できる
  • http://gradle.monochromeroad.com/docs/dsl/org.gradle.api.tasks.compile.CompileOptions.html
• それ以外のオプションは options.compileArgs に指定する ( << は Groovy で List<String> に追記する syntax)
  • 「詳細は、-Xlint:uncheckedオプションを指定して再コンパイルしてください」の-Xlint:unchecked はこの方法で指定する

依存ライブラリの指定 †

dependencies {
    // https://mvnrepository.com/artifact/commons-cli/commons-cli
    compile 'commons-cli:commons-cli:1.4'
    ...
}

• 依存ライブラリの記述は、 https://mvnrepository.com/ の検索結果を貼り付ければいい
• 依存ライブラリ指定の省略形

  compile 'commons-cli:commons-cli:1.4'

  は、

  compile group: 'commons-cli', name: 'commons-cli', version: '1.4'

  の省略形

依存ライブラリが、依存しているライブラリを除く †

compile ("org.glassfish.jersey.containers:jersey-container-jetty-http:${versions.jersey}") {
    exclude group : 'org.eclipse.jetty', module : 'jetty-util'
}

テストクラスの標準出力を表示する †

test {
    testLogging {
        events 'standard_out', 'standard_error'
    }
}

ライブラリの参照先を google, maven-central, jcenter にする †

repositories {
    google()
    mavenCentral()
    jcenter()
}

ビルドの途中で標準出力にログを出力する †

   println "Target SDK is ${buildConfig.targetSdk} => Use Derby ${versions.derby8}"

ビルドの中で条件分岐する †

   if (buildConfig.targetSdk < 9) {
       println "Target SDK is ${buildConfig.targetSdk} => Use Derby ${versions.derby8}"
       compile "org.apache.derby:derby:${versions.derby8}"
       compile "org.apache.derby:derbytools:${versions.derby8}"
   } else {
       println "Target SDK is ${buildConfig.targetSdk} => User Derby ${versions.derby}"
       compile "org.apache.derby:derby:${versions.derby}"
       compile "org.apache.derby:derbytools:${versions.derby}"
       compile "org.apache.derby:derbyshared:${versions.derby}"
   }

上記のように条件分岐がいるのは、Apache Derby が、Java 8 用と Java 9 or higher 用で異なるため。ライブラリパッケージの構成も異なる。

Java#Jetty