53.6. 组件选项

entityType (common)

必需的 实体类名称。

类

joinTransaction (common)

camel-jpa 组件默认加入事务。您可以使用这个选项来关闭这个选项，例如，如果您使用 LOCAL_RESOURCE，并加入事务与 JPA 供应商无法工作。这个选项也可以在 JpaComponent 上全局设置，而不必在所有端点上设置它。

true

布尔值

maximumResults (common)

设置在 Query 上检索的最大结果数。

-1

int

namedQuery (common)

使用命名查询。

字符串

nativeQuery (common)

使用自定义原生查询。在使用原生查询时，您可能还想使用选项 resultClass。

字符串

PersistenceUnit ( common)

需要 默认情况下使用的 JPA Persistence 单元。

Camel

字符串

query (common)

使用自定义查询。

字符串

resultClass (common)

定义返回的有效负载的类型（我们将调用 entityManager.createNativeQuery (nativeQuery, resultClass)），而不是 entityManager.createNativeQuery (nativeQuery)。如果没有这个选项，我们将返回一个对象数组。仅在使用数据时与原生查询结合使用时具有影响。

类

consumeDelete (consumer)

如果为 true，则实体会在被使用后删除；如果为 false，则实体不会被删除。

true

布尔值

consumeLockEntity (consumer)

指定是否在处理轮询结果时在每个实体 bean 上设置专用锁定。

true

布尔值

deleteHandler (consumer)

使用自定义 DeleteHandler 在处理交换后删除行。

DeleteHandler

lockModeType (consumer)

在消费者上配置锁定模式。

Enum 值：

PESSIMISTIC_WRITE

LockModeType

maxMessagesPerPoll (consumer)

整数值，用于定义每个轮询收集的最大消息数。默认情况下，不会设置最大值。可用于避免在启动服务器时轮询数千个消息。将值设为 0 或负数设置为 disable。

int

preDeleteHandler (consumer)

使用自定义 Pre-DeleteHandler 在消费者读取实体后删除行。

DeleteHandler

sendEmptyMessageWhenIdle (consumer)

如果轮询使用者没有轮询任何文件，您可以启用此选项来发送空消息（无正文）。

false

布尔值

skipLockedEntity (consumer)

配置是否在锁定时使用 NOWAIT，并静默跳过该实体。

false

布尔值

transacted (consumer)

是否在处理整个批处理时以转换模式运行消费者，所有消息都将提交或回滚。默认行为(false)是提交所有之前成功处理的消息，仅回滚最后的失败消息。

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 值：

ExchangePattern

参数 (consumer (advanced))

此键/值映射用于构建查询参数。它预期是通用类型 java.util.Map，其中键是给定 JPA 查询的命名参数，值是您要为选择的对应有效值。当用于制作者时，简单表达式可用作参数值。它允许您从消息正文、标头等中检索参数值。

Map

pollStrategy (consumer (advanced))

可插拔 org.apache.camel.PollingConsumerPollingStrategy 允许您提供自定义实施来控制在轮询操作期间通常会发生错误处理，然后再创建交换并在 Camel 中路由。

PollingConsumerPollStrategy

findEntity (producer)

如果启用，则制作者将通过将消息正文用作 key 和 entityType 作为类类型来查找单个实体。这可用于查找单个实体，而不使用查询。

false

布尔值

flushOnSend (producer)

在实体 bean 持久保留后，清除 EntityManager。

true

布尔值

remove (producer)

指明使用 entityManager.remove (entity)。

false

布尔值

useExecuteUpdate (producer)

配置在生成者执行查询时是否使用 executeUpdate （）。当您将 INSERT、UPDATE 或 DELETE 语句用作命名查询时，您需要将此选项指定为 'true'。

布尔值

usePersist (producer)

指明使用 entityManager.persist (entity)而不是 entityManager.merge (entity)。注： entityManager.persist (entity)不适用于分离实体（实体管理器必须执行 UPDATE 而不是 INSERT 查询）！。

false

布尔值

lazyStartProducer (producer (advanced))

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

false

布尔值

usePassedInEntityManager (producer (advanced))

如果设置为 true，则 Camel 将使用标题 JpaConstants.ENTITY_MANAGER 中的 EntityManager，而不是组件/端点上配置的实体管理器。这允许最终用户控制将使用的实体管理器。

false

布尔值

entityManagerProperties (advanced)

要使用的实体管理器的其他属性。

Map

sharedEntityManager (advanced)

是否将 Spring 的 SharedEntityManager 用于 consumer/producer。在大多数情况下，joinTransaction 应设置为 false，因为这不是 EXTENDED EntityManager。

false

布尔值

backoffErrorThreshold (scheduler)

在 backoffMultipler 应该 kick-in 之前发生的后续错误轮询（因为某些错误）的数量。

int

backoffIdleThreshold (scheduler)

在 backoffMultipler 应该 kick-in 之前应该发生的后续空闲轮询数量。

int

backoffMultiplier (scheduler)

如果一行中有很多后续空闲/errors，则让调度的轮询消费者避退。然后，倍数是在下一次实际尝试再次发生前跳过的轮询数量。当使用这个选项时，还必须配置 backoffIdleThreshold 和/或 backoffErrorThreshold。

int

delay (scheduler)

下一次轮询前的时间（毫秒）。

500

long

greedy (scheduler)

如果启用了 greedy，如果上一个运行轮询 1 或更多消息，则 ScheduledPollConsumer 将立即运行。

false

布尔值

initialDelay (scheduler)

第一次轮询开始前的毫秒。

1000

long

repeatCount (scheduler)

指定触发的最大数量。因此，如果您将其设置为 1，调度程序将只触发一次。如果您将其设置为 5，它将只触发五次。值为零或负数表示会永久触发。

0

long

runLoggingLevel (scheduler)

消费者在轮询时记录 start/complete log 行。这个选项允许您为其配置日志级别。

Enum 值：

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

允许配置用于消费者的自定义/共享线程池。默认情况下，每个使用者都有自己的单线程线程池。

ScheduledExecutorService

scheduler (scheduler)

要使用 camel-spring 或 camel-quartz 组件的 cron 调度程序。使用值 spring 或 quartz 用于内置在调度程序中。

none

对象

schedulerProperties (scheduler)

在使用自定义调度程序或任何基于 Spring 的调度程序时配置附加属性。

Map

startScheduler (scheduler)

调度程序是否应自动启动。

true

布尔值

timeUnit (scheduler)

initialDelay 和 delay 选项的时间单位。

Enum 值：

MILLISECONDS

TimeUnit

useFixedDelay (scheduler)

控制是否使用固定延迟或固定率。详情请参阅 JDK 中的 ScheduledExecutorService。

true

布尔值