Quarkus

新しい Quarkus プロジェクトを作成する

1. IntelliJ IDEA を起動してください。

   'ようこそ' 画面が開いたら、「新規プロジェクト 」をクリックします。

   それ以外の場合は、メインメニューの ファイル(F) | 新規(N) | プロジェクト(P)… に移動します。

2. 左側のペインから Quarkus を選択します。

   • をクリックして、使用するサービスの URL を入力するか、デフォルトのままにします。

   • プロジェクトの名前とロケーションを指定し、プロジェクトのメタデータを構成します。言語、ビルドツールを選択し、アーティファクト ID を指定してください。

   • JDK リストから、プロジェクトで使用する JDK を選択します。

     JDK がコンピューターにインストールされているが、IDE で定義されていない場合は、 JDK を追加 を選択し、JDK ホームディレクトリへのパスを指定します。

     必要な JDK がコンピューターにない場合は、 JDK のダウンロード を選択します。

   • サンプルコードの追加 オプションを選択して、プロジェクトと一緒に ExampleResource という名前の REST エンドポイントを作成します。

   

   次へ(N) をクリックします。

3. ウィザードの次のステップで、 拡張 リストから必要なオプションを選択し、 作成 をクリックします。

Quarkus アプリケーションを実行する

IntelliJ IDEA は、必要な Maven ゴールまたは Gradle タスクを実行する Quarkus 実行構成を作成します。

• メインツールバーで Quarkus 実行構成を選択し、 をクリックするか、 Shift+F10 を押します。

  または、 Alt+Shift+F10 を押して、必要な実行構成を選択することもできます。

  成功すると、 実行 ツールウィンドウに出力ログが表示されます。

  

デフォルトでは、アプリケーションは http://localhost:8080 で起動します。 Web ブラウザーでこのアドレスを開いて、Quarkus ランディングページを表示します。

http://localhost:8080/hello エンドポイントを開くと、文字列 Hello from RESTEasy Reactive が表示されます。

Quarkus Dev UI を開く

Quarkus 開発 UI(英語) を IDE 内で直接開くことができます。

1. Quarkus アプリケーションを実行します。

2. 実行 ツールウィンドウで、 (Quarkus Dev UI を開く) をクリックします。

これにより、新しいエディタータブで Quarkus Dev UI が開きます。

既存の Quarkus プロジェクトに拡張機能を追加する

Quarkus 拡張機能(英語)は、プロジェクトの依存関係の事前設定されたセットです。

IntelliJ IDEA を使用して新しい Quarkus プロジェクトを作成する場合、 専用の新規プロジェクトウィザードで拡張機能を追加できます。 また、ビルドファイルで 拡張機能の追加 インレイヒントを使用して、既存のプロジェクトに拡張機能を追加することもできます。

1. pom.xml または build.gradle(.kts) ファイルを開きます。

2. dependencies ブロックで、 拡張機能の追加 をクリックします。

   

3. 開いた 拡張機能の追加 ダイアログで、追加する拡張機能を選択します。

   

ビルドファイルはそれに応じて変更されます。 この方法で依存関係を追加すると、IntelliJ IDEA は Quarkus のバージョンを考慮するため、互換性のある依存関係のバージョンについて心配する必要がなくなります。

このインレイヒントは、IDE 設定 (Ctrl+Alt+S)、 エディター | インレイヒント | その他、 Groovy、 Kotlin、 XML で無効または有効にすることができます。

データベースへの接続をすばやく作成する

データベースツールおよび SQL プラグインを使用すると、IntelliJ IDEA で データベースに接続するを作成および管理できます。

Quarkus プロジェクトでは、アプリケーションプロパティファイルから即座に作成できます。

1. application.properties または application.yml ファイルを開きます。 データソース関連のプロパティが含まれている場合は、ガターにデータソースアイコン が表示されます。

2. をクリックします。 これにより、構成ファイルのデータに基づいてデータソースパラメーター (URL、ユーザー名、データベース名など) が入力されたデータソース作成フォームが開きます。

   データソースがすでに構成されている場合は、代わりにデータソースアイコン が表示されます。 これをクリックすると、 データベース ツールウィンドウでデータソースが開きます。

   

以下は、このアクションが利用できるデータベースのリストです。

• Amazon Redshift

• Apache Cassandra

• Apache Derby

• Couchbase

• H2

• HSQLDB

• IBM Db2

• MariaDB

• Microsoft SQL Server

• MongoDB

• MySQL

• Oracle データベース

• PostgreSQL

• Redis

• SQLite

• Sybase

データソースパラメーターの詳細については、「データソース 」を参照してください。

Quarkus アプリケーションをデバッグする

実行中の Quarkus アプリケーションをデバッグするには、 デバッガーをアプリケーションに接続します。

1. コードに ブレークポイントを設定します。

   例: hello() メソッドの 返却 ステートメントを使用して行に設定できます。

2. メインメニューで 実行 | プロセスにアタッチ… へ移動します。

3. Java プロセスのリストから、Quarkus アプリケーションのプロセスを選択します。

   成功すると、IntelliJ IDEA は確立されたデバッガー接続で デバッグ ツールウィンドウを開きます。

4. 次に、 http://localhost:8080/hello を開いて、 hello() メソッドを呼び出します。 デバッガーは、グリーティング文字列を返す直前にブレークポイントで停止する必要があります。

5. デバッグ ツールウィンドウで、 F9 をクリックして実行を続行し、文字列を Web ブラウザーに返します。

デバッガーをデタッチするには、 Ctrl+F2 をクリックします。 これは実際のアプリケーションプロセスを停止するのではなく、デバッガーをそこから切り離すだけです。