32.4. 配置选项

entityType (common)

所需的 实体类名称。

类

加入事务 (common)

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

true

布尔值

maximumResults (common)

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

-1

int

namedQuery (common)

使用命名的查询：

字符串

nativeQuery (common)

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

字符串

persistenceUnit (common)

必需 默认使用的 JPA 持久性单元。

camel

字符串

query (common)

使用自定义查询，请执行以下操作：

字符串

resultClass (common)

定义返回的有效负载的类型（we will call 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)不适用于分离实体（其中 EntityManager 必须执行 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。请注意，在大多数情况下，加入事务应设为 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

布尔值