搜索

40.5. 端点选项

download PDF

gRPC 端点使用 URI 语法进行配置:

grpc:host:port/service

使用以下路径和查询参数:

40.5.1. 路径参数(3 参数)

Name描述默认值类型

host (common)

必需 gRPC 服务器主机名。在使用生成者时作为消费者或远程服务器主机名,这是 localhost 或 0.0.0.0。

 

字符串

port (common)

需要 gRPC 本地或远程服务器端口。

 

int

service (common)

从协议缓冲区描述符文件(软件包点服务定义名称)中所需的完全限定服务名称。

 

字符串

40.5.2. 查询参数(29 参数)

Name描述默认值类型

flowControlWindow (common)

HTTP/2 流控制窗口大小(MiB)。

1048576

int

maxMessageSize (common)

允许接收/sent (MiB)的最大消息大小。

4194304

int

autoDiscoverServerInterceptors (consumer)

如果为 true 设置 autoDiscoverServerInterceptors 机制,则组件将自动在 registry 中查找 ServerInterceptor 实例,否则它将跳过该检查。

true

布尔值

consumerStrategy (consumer)

这个选项指定在流传输模式下处理服务请求和响应的顶级策略。如果选择了聚合策略,则会在列表中累计所有请求,然后传送到流中,累积的响应将发送到发送者。如果选择了传播策略,则会将请求发送到流,响应将立即发送到发送者。

Enum 值:

  • 聚合
  • PROPAGATION

PROPAGATION

GrpcConsumerStrategy

forwardOnCompleted (consumer)

确定是否应将 onCompleted 事件推送到 Camel 路由。

false

布尔值

forwardOnError (consumer)

确定是否应将 onError 事件推送到 Camel 路由。例外将设置为消息正文。

false

布尔值

maxConcurrentCallsPerConnection (consumer)

每个传入服务器连接允许的最大并发调用数。

2147483647

int

routeControlledStreamObserver (consumer)

使路由能够控制流观察器。如果将此值设置为 true,则 gRPC 调用的响应观察器将使用 Exchange 对象中的名称 GrpcConstants.GRPC_RESPONSE_OBSERVER 设置。请注意,路由中应调用流 observer's onNext (), onError (), onCompleted ()方法。

false

布尔值

bridgeErrorHandler (consumer (advanced))

允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。

false

布尔值

exceptionHandler (consumer (advanced))

要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。

 

ExceptionHandler

exchangePattern (consumer (advanced))

在消费者创建交换时设置交换模式。

Enum 值:

  • InOnly
  • InOut
 

ExchangePattern

autoDiscoverClientInterceptors (producer)

如果为 true 设置 autoDiscoverClientInterceptors 机制,则组件将自动在 registry 中查找 ClientInterceptor 实例,否则它将跳过该检查。

true

布尔值

method (producer)

gRPC 方法名称。

 

字符串

producerStrategy (producer)

用于与远程 gRPC 服务器通信的模式。在 SIMPLE 模式中,单个交换被转换为远程过程调用。在 STREAMING 模式中,所有交换都将在同一请求中发送(接收者 gRPC 服务的输入和输出必须是 'stream' 类型)。

Enum 值:

  • SIMPLE

SIMPLE

GrpcProducerStrategy

streamRepliesTo (producer)

使用 STREAMING 客户端模式时,它指示应转发响应的端点。

 

字符串

userAgent (producer)

传递给服务器的用户代理标头。

 

字符串

lazyStartProducer (producer (advanced))

生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。

false

布尔值

同步 (advanced)

设置是否应严格使用同步处理。

false

布尔值

authenticationType (security)

身份验证方法类型提前到 SSL/TLS 协商。

Enum 值:

  • NONE
  • GOOGLE
  • JWT

NONE

GrpcAuthType

jwtAlgorithm (security)

JSON Web 令牌签名算法。

Enum 值:

  • HMAC256
  • HMAC384
  • HMAC512

HMAC256

JwtAlgorithm

JWTIssuer (security)

JSON Web 令牌签发者.

 

字符串

jwtSecret (security)

JSON Web 令牌 secret。

 

字符串

JWTSubject (security)

JSON Web 令牌主题.

 

字符串

keyCertChainResource (security)

PEM 格式链接的 X.509 证书链文件资源。

 

字符串

keyPassword (security)

PKCS#8 私钥文件密码。

 

字符串

keyResource (security)

PKCS#8 私钥文件资源采用 PEM 格式链接。

 

字符串

negotiationType (security)

标识用于 HTTP/2 通信的安全协商类型。

Enum 值:

  • TLS
  • PLAINTEXT_UPGRADE
  • PLAINTEXT

PLAINTEXT

NegotiationType

serviceAccountResource (security)

Google Cloud SDK 支持的 JSON 格式的服务帐户密钥文件。

 

字符串

trustCertCollectionResource (security)

PEM 格式的可信证书集合文件资源,用于验证远程端点的证书。

 

字符串

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.