IntelliJ IDEA 2024.1 ヘルプ

Micronaut

Micronaut(英語) は、マイクロサービスおよびサーバーレスアプリケーションを作成するための最新の Java フレームワークです。IntelliJ IDEA は以下を提供します。

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

  1. IntelliJ IDEA を起動します。

    ウェルカム画面が開いたら、新しいプロジェクトをクリックします。

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

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

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

    • プロジェクトの名前と場所を指定し、プロジェクトのメタデータを構成します。言語、ビルドツールを選択し、アーティファクト ID を指定します。

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

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

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

      プロジェクト JDK のバージョンとは異なる Java バージョンでプロジェクトをビルドする場合は、ここで選択できます。

    New Micronaut project wizard

    次へをクリックします。

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

生成されたプロジェクトには、メインの Application クラスと、アプリケーションの実行に必要なすべてのもののみが含まれています。IntelliJ IDEA はそれを認識し、the Run icon をガターに追加します。ガターをクリックすると、アプリケーションを実行できます。

The default Micronaut application main class

しかし、空のプロジェクトは退屈です。HTTP GET リクエストに応答してアプリケーションが Hello World! を返すようにしましょう。

MicronautHTTP コントローラーを追加する

  1. メインクラス(デフォルトでは src/main/java/com/example)のあるディレクトリを右クリックし、新規 | Java クラスを選択します。

  2. クラス HelloController の名前を入力し、Enter を押します。

  3. 作成したファイルに次のコードをコピーします。

    package com.example; import io.micronaut.http.MediaType; import io.micronaut.http.annotation.Controller; import io.micronaut.http.annotation.Get; import io.micronaut.http.annotation.Produces; @Controller("/hello") public class HelloController { @Get(produces = MediaType.TEXT_PLAIN) public String sayHello() { return "Hello World!"; } }
    • @Controller アノテーションは、クラスを /hello エンドポイントにマップされた HTTP コントローラーとして定義します。

    • @Get アノテーションは、このエンドポイントに対するすべての HTTP GET 要求を sayHello() メソッドにマップし、応答の Content-Typetext/plain に設定します。

    • sayHello() メソッドは、文字列 Hello World! を返します。

IntelliJ IDEA は HTTP コントローラーを認識し、ガター内で The HTTP Controller icon でマークします。The Open in HTTP Client icon をクリックしてエンドポイントの HTTP リクエストを生成し、別の HTTP クライアントエディタータブで開くこともできます。IntelliJ IDEA は、他のガターアイコンを提供します。例:

  • The Navigate to event listeners icon イベントリスナーに移動

  • The Navigate to event publisher icon イベントパブリッシャーに移動

  • The Navigate to the autowired dependencies icon Autowired 依存性に移動

アプリケーションで定義されているすべてのエンドポイントを表示するには、エンドポイントツールウィンドウを開きます。例: これが /hello エンドポイントです:

The Endpoints tool window with the sample /hello endpoint

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

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

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

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

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

    Micronaut application running in the Run tool window

デフォルトでは、アプリケーションは http://localhost:8080 で起動します。Web ブラウザーでこのアドレスを開くと、アプリケーションルートが GET リクエストを処理しないため、標準エラー応答が表示されます。

{"message":"Page Not Found","_links":{"self":{"href":"/","templated":false}}}

ただし、アプリケーションには、GET 要求に応答する HTTP コントローラーがあります。http://localhost:8080/hello エンドポイントを開くと、アプリケーションは Hello World! で応答します。

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

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

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

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

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

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

    Create data source window

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

  • Amazon Redshift

  • Apache Cassandra

  • Apache Derby

  • Couchbase

  • H2

  • HSQLDB

  • IBM Db2

  • MariaDB

  • Microsoft SQL Server

  • MongoDB

  • MySQL

  • Oracle データベース

  • PostgreSQL

  • Redis

  • SQLite

  • Sybase

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

関連ページ:

Beans ツールウィンドウ

Bean ツールウィンドウには、プロジェクト内で検出された Spring、Micronaut、Java コンテキストと依存関係インジェクション (CDI) Bean のビューが表示されます。これらのテクノロジの 1 つだけがプロジェクトで使用されている場合、ツールウィンドウには対応する名前が付けられます:Spring、Micronaut、または CDI。複数のフレームワークが使用されている場合、ツールウィンドウには Bean という名前が表示され、フレームワークごとに Bean をフィルターするオプショ...

エンドポイントツールウィンドウ

エンドポイントツールウィンドウは、HTTP および WebSocket プロトコルのプロジェクトで使用されるクライアント API とサーバー API の両方の集約ビューを提供します。ツールウィンドウは、マイクロサービスやバックエンドとフロントエンドの通信を開発する際に役立ちます。また、サードパーティの API を調べるのにも役立ちます。エンドポイントツールウィンドウからエンドポイント宣言に移動するには、次のいずれかを実行します。エンドポイントのコンテキストメニューからソースに移動を選択します。エ...

SDK

ソフトウェア開発キットまたは SDK は、特定のソフトウェアフレームワーク用のアプリケーションを開発するために必要なツールのコレクションです。例: Java でアプリケーションを開発するには、Java SDK(JDK) が必要です。SDK には、バイナリ、バイナリのソースコード、ソースコードのドキュメントが含まれています。JDK ビルドにはアノテーションも含まれています。一般に、SDK はグローバルです。つまり、1 つの SDK を複数のプロジェクトやモジュールで使用できます。新しいプロジェクトを作...

HTTP クライアント

HTTP クライアントプラグインを使用すると、IntelliJ IDEA コードエディターで HTTP リクエストを直接作成、編集、実行できます。HTTP リクエストを作成して実行する必要がある場合、主に 2 つのユースケースがあります。RESTful Web サービスを開発していて、それが期待どおりに機能し、仕様に準拠してアクセス可能であり、正しく応答することを確認したい場合。RESTful Web サービスに対応するアプリケーションを開発している場合。この場合、開発を開始する前にサービスへの...

データベースへの接続

データベースツールと SQL プラグインを有効にするこの機能は、IntelliJ IDEA にバンドルされており、デフォルトで有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。このトピックでは、IntelliJ IDEA...

Quarkus の実行構成

Quarkus 実行 / デバッグ構成は、IntelliJ IDEA で Quarkus アプリケーションを実行する方法を定義します。プロジェクトに Quarkus の依存関係が含まれている場合は、自動的に作成されます。この実行構成は、Quarkus アプリケーションを開発モードで実行し、ライブ再ロードを有効にします。主なパラメーター:名前実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。実行構成を実行するターゲット環境を選択します。アプリケーションをロー...