# Micronaut

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 必需插件：  Micronaut （捆绑）

[Micronaut](https://micronaut.io/) 是一个现代 Java 框架，用于编写微服务和无服务器应用程序。 IntelliJ IDEA 提供以下内容：

IntelliJ IDEA 提供以下内容：

* 基于 [launch.micronaut.io](https://launch.micronaut.io/) 的专用项目创建向导。

* Micronaut 应用程序的专用运行配置。

* 与 Micronaut API 和配置文件参数相关的编码辅助。 例如，当您 [编写查询方法](https://micronaut-projects.github.io/micronaut-data/latest/guide/#querying)、为已定义的端点生成 HTTP 请求等。

* 与 [Beans](beans-tool-window.html) 和 [Endpoints](endpoints-tool-window.html) 工具窗口集成。

Procedure: 创建一个新的 Micronaut 项目

1. 启动 IntelliJ IDEA。

如果打开欢迎屏幕，请点击   新建项目  。

否则，请在主菜单中转到  `文件 | 新建 | 项目…` 。

2. 从左侧窗格中选择   Micronaut  。

* 点击 ![配置图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) 以输入要使用的服务的 URL，或保留默认值。

* 指定项目的名称和位置，并配置项目元数据：选择一种语言、一种构建工具，并指定工件 ID。

* 从 JDK 列表中选择您想在项目中使用的 [JDK](sdk.html#jdk)。 * 如果已在计算机上安装 JDK，但未在 IDE 中定义，请选择 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.jdk.png) 从磁盘添加 JDK… 并指定 JDK 主目录的路径。​ * 如果您的计算机上没有必要的 JDK，请选择 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.download.svg) 下载 JDK 。 如果要使用与项目 JDK 版本不同的 Java 版本来构建项目，可以在此处选择。

![新 Micronaut 项目向导](https://resources.jetbrains.com/help/img/idea/2026.3/micronaut-new-project.png)

点击   下一步  。

3. 在向导的下一步中，从   功能   列表中选择必要的选项，然后点击   创建  。

生成的项目只包含主要的  `应用程序` 类和运行应用程序所需的一切。 IntelliJ IDEA 会识别它并将 ![运行图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg) 添加到装订区域，您可以点击它来运行应用程序。

![默认的 Micronaut 应用程序主类](https://resources.jetbrains.com/help/img/idea/2026.3/micronaut-default-main-class.png)

但是，一个空项目是无聊的。 让应用程序在响应 HTTP GET 请求时返回  `Hello World!` 。

Procedure: 添加 Micronaut HTTP 控制器

1. 右键点击包含主类的目录（默认情况下为  `src/main/java/com/example` ），然后选择  `新建 | Java 类` 。

2. 请输入类的名称  `HelloController` 并按下  `回车键` 。

3. 请将以下代码复制到创建的文件中：

```JAVA
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-Type` 设置为 `text/plain` 。

* `sayHello()` 方法返回字符串 `Hello World!` 。

IntelliJ IDEA 识别 HTTP 控制器并在侧边栏用 ![HTTP Controller 图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.icons.cdi.newui.bean%4014x14.svg)标记。 您还可以点击 ![“在 HTTP 客户端中打开”图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.icons.web.newui.requestMapping%4014x14.svg)，为该端点生成 HTTP 请求，并在单独的 [HTTP 客户端](http-client-in-product-code-editor.html)编辑器选项卡中打开它。 IntelliJ IDEA 提供了其他行间图标，例如：

* ![“导航到事件监听器”图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.icons.cdi.newui.listener%4014x14.svg) 导航到事件监听器

* ![导航到事件发布者图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.icons.cdi.newui.publisher%4014x14.svg) 导航到事件发布者

* ![导航到 autowired 依赖项图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.icons.cdi.newui.showAutowiredDependencies%4014x14.svg) 导航到自动装配依赖项

要查看应用程序中定义的所有端点，请打开 [Endpoints](endpoints-tool-window.html)工具窗口。 例如，这里是  `/hello` 终端：

![终端工具窗口，其中包含示例 /hello 端点](https://resources.jetbrains.com/help/img/idea/2026.3/micronaut-hello-endpoint.png)

Procedure: 运行 Micronaut 应用程序

IntelliJ IDEA 创建一个 Micronaut 运行配置来执行所需的 Maven goal 或 Gradle task。

* 在主工具栏中选择 Micronaut 运行配置，然后点击 ![运行按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg)或按 `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS))。

或者，您可以按 `Alt+Shift+F10` (Windows), `⌃ ⌥ R` (macOS), `⌥ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ R` (macOS System Shortcuts), `Alt+Shift+F10` (XWin), `Alt+Shift+F10` (GNOME), `Alt+Shift+F10` (KDE), `Alt+Shift+F10` (Emacs), `Alt+Shift+F10` (Sublime Text), `⌃ ⌥ R` (Sublime Text (macOS)), `Ctrl+Alt+Shift+R` (Visual Studio), `⌘ ⌥ ⇧ R` (Visual Studio (macOS)), `Alt+Shift+F10` (NetBeans), `Alt+Shift+F10` (Eclipse), `⌃ ⌥ R` (Eclipse (macOS)) 并选择所需的运行配置。

如果成功，应会在   运行   工具窗口中看到输出日志。

![在运行工具窗口中运行的 Micronaut 应用程序](https://resources.jetbrains.com/help/img/idea/2026.3/micronaut-run-tool-window.png)

默认情况下，应用程序会在 [http://localhost:8080](http://localhost:8080) 上启动。 在 Web 浏览器中打开此地址，您将看到标准错误响应，因为应用程序根目录不处理 GET 请求：

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

但是，应用程序有一个 [HTTP controller](#controller)，用于响应 GET 请求。 如果您打开 [http://localhost:8080/hello](http://localhost:8080/hello) 端点，应用程序将以  `Hello World!`  进行响应。

Procedure: 快速创建与数据库的连接

借助   数据库工具和 SQL   插件，IntelliJ IDEA 可用于创建和管理 [数据库连接](connecting-to-a-database.html)。

在 Micronaut 项目中，您可以立即从应用程序属性文件创建它。

1. 打开一个  `application.properties`  或  `application.yml`  文件。 如果其中包含与数据源相关的属性（例如，  `mongodb.uri`  或  `redis.host` ），数据源图标 ![数据源图标](https://resources.jetbrains.com/help/img/idea/2026.3/javaee-persistence-impl.icons.expui.add-db-from-config.svg) 将显示在边距中。

2. 点击 ![数据源图标](https://resources.jetbrains.com/help/img/idea/2026.3/javaee-persistence-impl.icons.expui.add-db-from-config.svg)。 这将打开数据源创建表单，并根据配置文件中的数据填充数据源形参（例如 URL、用户名或数据库名称）。

如果数据源已配置，则会显示数据源图标 ![](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.dbms.svg)。 点击它以在   数据库   工具窗口中打开数据源。

![创建数据源窗口](https://resources.jetbrains.com/help/img/idea/2026.3/micronaut_create_datasource_from_properties.png)

以下是此操作可用的数据库列表：

* Amazon Redshift

* Apache Cassandra

* Apache Derby 数据库

* Couchbase

* H2

* HSQLDB

* IBM Db2

* MariaDB

* Microsoft SQL 服务器

* MongoDB

* MySQL

* Oracle Database

* PostgreSQL

* Redis

* SQLite

* Sybase

有关数据源形参的更多详细信息，请参阅 [数据源](managing-data-sources.html)。

