[翻译]Reactor Netty参考指南 - 8.UDP客户端

头像
immuthex
    阅读 11 分钟
    1

    Reactor Netty参考指南目录

    原文地址

    Reactor Netty提供了易于使用、易于配置的UdpClient。它隐藏了创建UDP客户端所需的大部分Netty的功能，并增加了Reactive Streams背压。

    8.1.连接和断开

    要将UDP客户端连接到给定的端点，您必须创建并且配置一个UdpClient实例。默认情况下，host为localhost，post为12012。下面是创建和连接一个UDP客户端的例子：

    https://github.com/reactor/re...

    import reactor.netty.Connection;
import reactor.netty.udp.UdpClient;
import java.time.Duration;

public class Application {

    public static void main(String[] args) {
        Connection connection =
                UdpClient.create()                            //<1>
                         .connectNow(Duration.ofSeconds(30)); //<2>

        connection.onDispose()
                  .block();
    }
}

    <1> 创建一个UdpClient实例用来进行的配置操作。

    <2> 用阻塞的方式进行连接操作，并且等待它初始化完成。

    返回的Connection对象提供了简单的连接相关的API，包括disposeNow()，调用这个方法会以阻塞的方式关闭客户端。

    8.1.1.Host和Port

    想要连接特定的host和port，您可以使用以下方式来配置UDP客户端。示例如下：

    https://github.com/reactor/re...

    import reactor.netty.Connection;
import reactor.netty.udp.UdpClient;
import java.time.Duration;

public class Application {

    public static void main(String[] args) {
        Connection connection =
                UdpClient.create()
                         .host("example.com") //<1>
                         .port(80)            //<2>
                         .connectNow(Duration.ofSeconds(30));

        connection.onDispose()
                  .block();
    }
}

    <1> 指定客户端需要连接的host

    <2> 指定客户端需要连接的port

    8.2.预先初始化

    默认情况下，UdpClient初始化资源的操作在需要使用的时候才进行。这意味着初始化加载的时候connect operation会占用额外的时间：

    • 事件循环组
    • 主机名解析器
    • native传输库（当使用了native传输的时候）

    当您需要预加载这些资源的时候，您可以按照以下方式来配置UdpClient：

    https://github.com/reactor/re...

    import reactor.core.publisher.Mono;
import reactor.netty.Connection;
import reactor.netty.udp.UdpClient;

import java.time.Duration;

public class Application {

    public static void main(String[] args) {
        UdpClient udpClient = UdpClient.create()
                                       .host("example.com")
                                       .port(80)
                                       .handle((udpInbound, udpOutbound) -> udpOutbound.sendString(Mono.just("hello")));

        udpClient.warmup() //<1>
                 .block();

        Connection connection = udpClient.connectNow(Duration.ofSeconds(30)); //<2>

        connection.onDispose()
                  .block();
    }
}

    <1> 初始化和加载事件循环组，主机名解析器和native传输库

    <2> 在连接远程节点的时候会进行主机名解析

    8.3.写出数据

    如果要发送数据到一个已有的端点，您必须添加一个I/O处理器。这个I/O处理器可以通过UdpOutbound来写出数据。

    下面是一个发送hello字符串的例子：

    https://github.com/reactor/re...

    import reactor.core.publisher.Mono;
import reactor.netty.Connection;
import reactor.netty.udp.UdpClient;

import java.time.Duration;

public class Application {

    public static void main(String[] args) {
        Connection connection =
                UdpClient.create()
                         .host("example.com")
                         .port(80)
                         .handle((udpInbound, udpOutbound) -> udpOutbound.sendString(Mono.just("hello"))) //<1>
                         .connectNow(Duration.ofSeconds(30));

        connection.onDispose()
                  .block();
    }
}

    <1> 发送一个hello字符串到远端

    8.4.消费数据

    如果要接收从已有端点发过来的数据，您必须添加一个I/O处理器。这个I/O处理器可以通过UdpInbound来读取数据。示例如下：

    https://github.com/reactor/re...

    import reactor.netty.Connection;
import reactor.netty.udp.UdpClient;
import java.time.Duration;

public class Application {

    public static void main(String[] args) {
        Connection connection =
                UdpClient.create()
                         .host("example.com")
                         .port(80)
                         .handle((udpInbound, udpOutbound) -> udpInbound.receive().then()) //<1>
                         .connectNow(Duration.ofSeconds(30));

        connection.onDispose()
                  .block();
    }
}

    <1> 接收从已有端点发送过来的数据

    8.5.生命周期回调

    下面的生命周期回调用参数是提供给您用来扩展UdpClient的：

    CallbackDescription
    doAfterResolve在成功解析远程地址之后调用。
    doOnChannelInit在初始化channel的时候调用。
    doOnConnect当channel将要连接的时候调用。
    doOnConnected当channel已经连接上的时候调用。
    doOnDisconnected当channel断开的时候被调用。
    doOnResolve当远程地址将要被解析的时候被调用。
    doOnResolveError在远程地址解析失败的情况下被调用。

    下面是使用doOnConnected和doOnChannelInit回调的例子：

    https://github.com/reactor/re...

    import io.netty.handler.codec.LineBasedFrameDecoder;
import io.netty.handler.logging.LoggingHandler;
import reactor.netty.Connection;
import reactor.netty.udp.UdpClient;
import java.time.Duration;

public class Application {

    public static void main(String[] args) {
        Connection connection =
                UdpClient.create()
                         .host("example.com")
                         .port(80)
                         .doOnConnected(conn -> conn.addHandler(new LineBasedFrameDecoder(8192))) //<1>
                         .doOnChannelInit((observer, channel, remoteAddress) ->
                             channel.pipeline()
                                    .addFirst(new LoggingHandler("reactor.netty.examples")))      //<2>
                         .connectNow(Duration.ofSeconds(30));

        connection.onDispose()
                  .block();
    }
}

    <1> 当一个channel连接上之后添加了一个LineBasedFrameDecoder到Netty pipeline。

    <2> 当初始化channel的时候添加了一个LoggingHandler到Netty pipeline。

    8.6.连接配置

    这一章节将给您介绍三种UDP层的配置方式：

    8.6.1.Channel Options

    默认情况下，UDP客户端配置了以下options：

    ./../../reactor-netty-core/src/main/java/reactor/netty/udp/UdpClientConnect.java

    UdpClientConnect() {
  this.config = new UdpClientConfig(
          ConnectionProvider.newConnection(),
          Collections.singletonMap(ChannelOption.AUTO_READ, false),
          () -> new InetSocketAddress(NetUtil.LOCALHOST, DEFAULT_PORT));
}

    如果需要添加新的option或者修改已有的option，您可以使用如下的方式：

    https://github.com/reactor/re...

    import io.netty.channel.ChannelOption;
import reactor.netty.Connection;
import reactor.netty.udp.UdpClient;
import java.time.Duration;

public class Application {

    public static void main(String[] args) {
        Connection connection =
                UdpClient.create()
                         .host("example.com")
                         .port(80)
                         .option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 10000)
                         .connectNow(Duration.ofSeconds(30));

        connection.onDispose()
                  .block();
    }
}

    您可以通过以下的链接找到更多关于Netty channel options的信息：

    8.6.2.Wire Logger

    Reactor Netty提供了线路记录（wire logging）用来检查点对点的流量。默认情况下，线路记录是关闭的。如果想要开启它，您必须将日志reactor.netty.udp.UdpClient的设置为DEBUG等级并且按如下方式进行配置：

    https://github.com/reactor/re...

    import reactor.netty.Connection;
import reactor.netty.udp.UdpClient;
import java.time.Duration;

public class Application {

    public static void main(String[] args) {
        Connection connection =
                UdpClient.create()
                         .host("example.com")
                         .port(80)
                         .wiretap(true) //<1>
                         .connectNow(Duration.ofSeconds(30));

        connection.onDispose()
                  .block();
    }
}

    <1> 开启线路记录

    默认情况下，线路记录在输出内容的时候会使用AdvancedByteBufFormat#HEX_DUMP。您也可以通过配置UdpClient改为AdvancedByteBufFormat#SIMPLE或者AdvancedByteBufFormat#TEXTUAL：

    https://github.com/reactor/re...

    import io.netty.handler.logging.LogLevel;
import reactor.netty.Connection;
import reactor.netty.transport.logging.AdvancedByteBufFormat;
import reactor.netty.udp.UdpClient;

import java.time.Duration;

public class Application {

    public static void main(String[] args) {
        Connection connection =
                UdpClient.create()
                         .host("example.com")
                         .port(80)
                         .wiretap("logger-name", LogLevel.DEBUG, AdvancedByteBufFormat.TEXTUAL) //<1>
                         .connectNow(Duration.ofSeconds(30));
  }

}

    <1> 开启线路记录并使用AdvancedByteBufFormat#TEXTUAL来输出内容。

    8.6.3.Event Loop Group

    默认情况下，UDP客户端使用"Event Loop Group"，工作线程数等于初始化的时候可以用的处理器数量（但最小是4）。您也可以使用LoopResource#create其中的一个方法来修改配置。

    默认的Event Loop Group配置如下：

    ./../../reactor-netty-core/src/main/java/reactor/netty/ReactorNetty.java

    /**
 * Default worker thread count, fallback to available processor
 * (but with a minimum value of 4)
 */
public static final String IO_WORKER_COUNT = "reactor.netty.ioWorkerCount";
/**
 * Default selector thread count, fallback to -1 (no selector thread)
 */
public static final String IO_SELECT_COUNT = "reactor.netty.ioSelectCount";
/**
 * Default worker thread count for UDP, fallback to available processor
 * (but with a minimum value of 4)
 */
public static final String UDP_IO_THREAD_COUNT = "reactor.netty.udp.ioThreadCount";
/**
 * Default quiet period that guarantees that the disposal of the underlying LoopResources
 * will not happen, fallback to 2 seconds.
 */
public static final String SHUTDOWN_QUIET_PERIOD = "reactor.netty.ioShutdownQuietPeriod";
/**
 * Default maximum amount of time to wait until the disposal of the underlying LoopResources
 * regardless if a task was submitted during the quiet period, fallback to 15 seconds.
 */
public static final String SHUTDOWN_TIMEOUT = "reactor.netty.ioShutdownTimeout";

/**
 * Default value whether the native transport (epoll, kqueue) will be preferred,
 * fallback it will be preferred when available
 */
public static final String NATIVE = "reactor.netty.native";

    如果需要修改这些设置，您也可以通过如下方式进行配置：

    https://github.com/reactor/re...

    import reactor.netty.Connection;
import reactor.netty.resources.LoopResources;
import reactor.netty.udp.UdpClient;
import java.time.Duration;

public class Application {

    public static void main(String[] args) {
        LoopResources loop = LoopResources.create("event-loop", 1, 4, true);

        Connection connection =
                UdpClient.create()
                         .host("example.com")
                         .port(80)
                         .runOn(loop)
                         .connectNow(Duration.ofSeconds(30));

        connection.onDispose()
                  .block();
    }
}

    8.7.度量

    UDP客户端支持与Micrometer的内置集成。它暴露了所有前缀为reactor.netty.udp.client的度量。

    下面的表格提供了UDP客户端度量的相关信息：

    度量名称类型描述
    reactor.netty.udp.client.data.receivedDistributionSummary收到的数据量，以字节为单位
    reactor.netty.udp.client.data.sentDistributionSummary发送的数据量，以字节为单位
    reactor.netty.udp.client.errorsCounter发生的错误数量
    reactor.netty.udp.client.connect.timeTimer连接远程地址所花费的时间
    reactor.netty.udp.client.address.resolverTimer解析远程地址花费的时间

    下面额外的度量也是可用的：

    ByteBufAllocator度量

    度量名称类型描述
    reactor.netty.bytebuf.allocator.used.heap.memoryGauge堆内存的字节数
    reactor.netty.bytebuf.allocator.used.direct.memoryGauge堆外内存的字节数
    reactor.netty.bytebuf.allocator.used.heap.arenasGauge堆内存的个数（当使用PooledByteBufAllocator的时候）
    reactor.netty.bytebuf.allocator.used.direct.arenasGauge堆外内存的个数（当使用PooledByteBufAllocator的时候）
    reactor.netty.bytebuf.allocator.used.threadlocal.cachesGaugethreadlocal的缓存数量（当使用PooledByteBufAllocator的时候）
    reactor.netty.bytebuf.allocator.used.tiny.cache.sizeGauge微小缓存的大小（当使用PooledByteBufAllocator的时候）
    reactor.netty.bytebuf.allocator.used.small.cache.sizeGauge小缓存的大小（当使用PooledByteBufAllocator的时候）
    reactor.netty.bytebuf.allocator.used.normal.cache.sizeGauge一般缓存的大小（当使用PooledByteBufAllocator的时候）
    reactor.netty.bytebuf.allocator.used.chunk.sizeGauge一个区域的块大小（当使用PooledByteBufAllocator的时候）

    下面是开启集成的度量的例子：

    https://github.com/reactor/re...

    import reactor.netty.Connection;
import reactor.netty.udp.UdpClient;

import java.time.Duration;

public class Application {

    public static void main(String[] args) {
        Connection connection =
                UdpClient.create()
                         .host("example.com")
                         .port(80)
                         .metrics(true) //<1>
                         .connectNow(Duration.ofSeconds(30));

        connection.onDispose()
                  .block();
    }
}

    <1> 开启内建集成的Micrometer

    如果您想让UDP客户端度量与除了Micrometer之外的系统集成或者想提供自己与Micrometer的集成来添加自己的度量记录器，您可以按如下方式实现：

    https://github.com/reactor/re...

    import reactor.netty.Connection;
import reactor.netty.channel.ChannelMetricsRecorder;
import reactor.netty.udp.UdpClient;

import java.net.SocketAddress;
import java.time.Duration;

public class Application {

    public static void main(String[] args) {
        Connection connection =
                UdpClient.create()
                         .host("example.com")
                         .port(80)
                         .metrics(true, CustomChannelMetricsRecorder::new) //<1>
                         .connectNow(Duration.ofSeconds(30));

        connection.onDispose()
                  .block();
    }

}

    <1> 开启UDP客户端度量并且提供ChannelMetricsRecorder的实现。

    Suggest Edit to "UDP Client"

    Reactor Netty参考指南目录

    版权声明：如需转载，请带上本文链接、注明来源和本声明。否则将追究法律责任。https://www.immuthex.com/posts/reactor-netty-reference-guide/udp-client
    javareactornetty翻译
    本文系翻译，阅读原文
    https://projectreactor.io/docs/netty/release/reference/index.html#udp-client
    immuthex
    1 声望1 粉丝
    « 上一篇
    [翻译]Reactor Netty参考指南 - 7.UDP服务端

    引用和评论

    推荐阅读
    头像
    Java12的新特性

    codecraft赞 63阅读 14.8k

    头像
    Java8的新特性

    codecraft赞 36阅读 31.5k评论 1

    头像
    Java11的新特性

    codecraft赞 28阅读 22.3k评论 3

    头像
    Java5的新特性

    codecraft赞 13阅读 26.2k

    头像
    Java9的新特性

    codecraft赞 20阅读 18.5k

    头像
    Java13的新特性

    codecraft赞 17阅读 13.6k

    头像
    Java7的新特性

    codecraft赞 10阅读 21.1k

    0 条评论
    得票最新