quarkus实战之三：开发模式(Development mode)

欢迎访问我的GitHub

这里分类和汇总了欣宸的全部原创(含配套源码)：https://github.com/zq2599/blog_demos

本篇概览

• 前文咱们曾提到过几种启动方式，有一种用maven命令启动的，可以进入开发模式，命令如下：

  mvn quarkus:dev

• 当时只提到此模式能看到详细系统信息，并未展开说明更多信息，实际上，此模式下还有很多实用的功能
• 作为《quarkus实战》系列的第三篇，今天咱们一起来学习开发模式(Development mode)，这是quarkus为开发者准备的实用工具

关于开发模式(Development mode)

• 开发模式是quarkus框架提供的内置工具(built-in)，可直接使用
• 开发模式提供以下功能：
• 系统信息：即前文提到过的，查看对象和配置、修改配置、操作单元测试等功能
• 热部署：修改java代码、资源文件、配置文件等类型的文件后，会立即生效
• 断点：这是常用功能就不多说了，稍后直接操作
• 接下来实际体验上述功能，用的是《quarkus实战之二：体验HelloWorld》一文中创建的demo工程

系统信息

• 访问http://localhost:8080/q/dev/，可以看到丰富的系统信息，该地址只在dev模式有效：
  

  热部署

• 热部署是日常开发的常用功能，回顾demo中的HobbyResource.java，如下所示，非常简单：

  package com.bolingcavalry;
  
  import javax.ws.rs.GET;
  import javax.ws.rs.Path;
  import javax.ws.rs.Produces;
  import javax.ws.rs.core.MediaType;
  import java.time.LocalDateTime;
  
  @Path("/actions")
  public class HobbyResource {
  
    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String hello() {
        return "Hello RESTEasy " + LocalDateTime.now();
    }
  }

• 为了演示修改配置可以立即生效的效果，把代码改成下面这样，注意注解<font color="blue">ConfigProperty</font>的作用是将指定配置的值注入修饰的成员变量中：

package com.bolingcavalry;

import org.eclipse.microprofile.config.inject.ConfigProperty;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;
import java.time.LocalDateTime;

@Path("/actions")
public class HobbyResource {

    @ConfigProperty(name = "greeting.message")
    String message;

    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String hello() {
        return "Hello RESTEasy " + LocalDateTime.now() + " " + message;
    }
}

• 打开文件<font color="blue">application.properties</font>，增加一个配置：

# 这是一个自定义属性
greeting.message=message from configuration

• 用命令<font color="blue">mvn quarkus:dev</font>将应用以开发模式启动，用浏览器访问<font color="blue">http://localhost:8080/actions</font>，响应如下图，符合预期，配置的属性可以被正常使用：

• 现在去修改代码，如下图红框：

• 再把文件<font color="blue">application.properties</font>中的配置也改了，我这里改成了<font color="red">abcdef</font>
• 再去刷新页面，如下图所示，代码和配置的修改都生效了：

• 以上就是热部署了，接下来去看另一个实用的功能：断点

断点

• 打断点、单步调试等都是Java程序员的日常操作，就不做介绍了，直接聊聊quarkus上如何操作吧
• 在开发模式下，断点功能是默认开启的，不过为了安全起见，quarkus断点只监听了<font color="blue">localhost</font>网卡，端口是<font color="red">5005</font>
• 在代码中打个断点，如下图，我这里用的是IDEA：

• 在IDEA上新增一个断点，操作如下图：

• 如下图所示，确认端口号正确：
  
• 配置完成后，点击下图红框中的按钮即可发起断点请求：
  
• 如果应用正常监听，应该能立即连接成功，如下图：
  
• 刷新浏览器，请求会立即停留在断点位置，一切都是熟悉的样子，可以像以前一样查看变量和堆栈，也可以做单步执行和条件断点等操作：
  

• 以上是通过<font color="blue">localhost:5005</font>进行本地调试的操作步骤，如果另外一台电脑想连接到到这个quarkus应用进行远程调式，是连接不成功的，因为quarkus应用启动后监听的是localhost这块网卡，为了能够让其他电脑上的IDEA远程连接到这个应用，我们需要给启动命令增加一个参数，令其监听本机所有网卡，支持远程debug的完整启动命令如下，另外，debug参数可以指定端口：

   mvn quarkus:dev -DdebugHost=0.0.0.0 -Ddebug=5006

• 启动后控制台输出信息如下图，红框中显示监听的端口是<font color="red">5006</font>：

• 当前电脑的IP是<font color="blue">192.168.50.221</font>，所以将断点的地址从<font color="blue">localhost:5005</font>改为<font color="red">192.168.50.221:5006</font>，如下图：

• 再尝试连接断点，如下所示，新的IP+端口连接成功：

• 因为连接是基于IP+端口的，您完全可以在A电脑上运行应用，在B电脑上用IDEA远程连接A电脑进行断点操作

热部署的局限性

• 前面的操作：在A电脑用<font color="blue">mvn quarkus:dev -DdebugHost=0.0.0.0 -Ddebug=5006</font>命令启动应用，在B电脑上用IDEA连接到A电脑上进行热部署操作，虽然也算是远程，但聪明的您应该看出了弊端：<font color="red">A电脑上必须有源码</font>
• 很多时候，我们热部署是为了处理特定问题，而出现问题的电脑可能是测试环境，甚至生产环境，这些地方是不会有源码和maven的，此时<font color="blue">mvn quarkus:dev</font>命令就行不通了，那又该如何处理呢？放弃热部署的便利，只能改一次代码部署一次吗？
• 好在quarkus已经考虑到这种情况，为我们准备了远程热部署方案，下一篇文章会详细介绍和操作

欢迎关注思否：程序员欣宸

学习路上，你不孤单，欣宸原创一路相伴...