38.3. auto-Discovery 和 configuration
38.3.1. 设置自动诊断
概述
自动发现是一种机制,可让您动态地将组件添加到 Apache Camel 应用程序。组件 URI 前缀用作按需加载组件的密钥。例如,如果 Apache Camel 遇到端点 URI、activemq://MyQName,并且 ActiveMQ 端点尚未加载,则 Apache Camel 会搜索由 activemq 前缀标识的组件,并动态加载组件。
组件类的可用性
在配置自动发现前,您必须确保可以从您当前的 classpath 访问自定义组件类。通常,您可以将自定义组件类捆绑到 JAR 文件中,并将 JAR 文件添加到您的类路径。
配置自动发现
要启用组件的自动发现,请创建一个名为组件前缀、组件前缀 并将该文件存储在 以下位置的 Java 属性文件:
/META-INF/services/org/apache/camel/component/component-prefixcomponent-prefix 属性文件必须包含以下属性设置:
class=component-class-name其中 component-class-name 是自定义组件类的完全限定名称。您还可以在此文件中定义额外的系统属性设置。
示例
例如,您可以通过创建以下 Java 属性文件,为 Apache Camel FTP 组件启用自动发现:
/META-INF/services/org/apache/camel/component/ftp
包含以下 Java 属性设置:
class=org.apache.camel.component.file.remote.RemoteFileComponent
FTP 组件的 Java 属性文件已在 JAR 文件 camel-ftp-Version.jar 中定义。
38.3.2. 配置组件
概述
您可以通过在 Apache Camel Spring 配置文件 META-INF/spring/camel-context.xml 中配置组件来添加组件。要查找组件,组件的 URI 前缀与 Spring 配置中的 bean 元素的 ID 属性匹配。如果组件前缀与 bean 元素 ID 匹配,Apache Camel 会实例化引用类并注入 Spring 配置中指定的属性。
这种机制的优先级高于自动发现。如果 CamelContext 找到具有必要 ID 的 Spring bean,它不会尝试使用自动发现查找组件。
在组件类上定义 bean 属性
如果要注入组件类的任何属性,请将它们定义为 bean 属性。例如:
public class CustomComponent extends DefaultComponent<CustomExchange> { ... PropType getProperty() { ... } void setProperty(PropType v) { ... } }
getProperty() 方法和 setProperty() 方法访问 属性 的值。
在 Spring 中配置组件
要在 Spring 中配置组件,请编辑配置文件 META-INF/spring/camel-context.xml,如 例 38.1 “在 Spring 中配置组件” 所示。
例 38.1. 在 Spring 中配置组件
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd">
<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
<package>RouteBuilderPackage</package>
</camelContext>
<bean id="component-prefix" class="component-class-name">
<property name="property" value="propertyValue"/>
</bean>
</beans>
带有 ID component-prefix 的 bean 元素配置 component-class-name 组件。您可以使用 property 元素将属性注入组件实例。例如,上例中的 property 元素将通过调用组件上的 setProperty() 将值 propertyValue 注入属性属性。
例子
例 38.2 “JMS 组件 Spring 配置” 演示了如何通过定义 ID 等于 jms 的 bean 元素来配置 Apache Camel 的 JMS 组件。这些设置添加到 Spring 配置文件 camel-context.xml 中。
例 38.2. JMS 组件 Spring 配置
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd">
<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
<package>org.apache.camel.example.spring</package> 1
</camelContext>
<bean id="jms" class="org.apache.camel.component.jms.JmsComponent"> 2
<property name="connectionFactory"3
<bean class="org.apache.activemq.ActiveMQConnectionFactory">
<property name="brokerURL"
value="vm://localhost?broker.persistent=false&broker.useJmx=false"/> 4
</bean>
</property>
</bean>
</beans>- 1
CamelContext会自动实例化在指定 Java 软件包 org.apache.camel.example.spring 中找到的任何RouteBuilder类。- 2
- 带有 ID
jms的 bean 元素配置 JMS 组件。bean ID 对应于组件的 URI 前缀。例如,如果路由指定了带有 URI jms://MyQName 的端点,则 Apache Camel 会使用jmsbean 元素中的设置自动加载 JMS 组件。 - 3
- JMS 只是消息传递服务的打包程序。您必须通过在
JmsComponent类上设置connectionFactory属性来指定消息传递系统的具体实施。 - 4
- 在本例中,JMS 消息传递服务的具体实施是 Apache ActiveMQ。
brokerURL属性初始化与 ActiveMQ 代理实例的连接,其中消息代理嵌入到本地 Java 虚拟机(JVM)中。如果 JVM 中不存在代理,ActiveMQ 将使用选项broker.persistent=false(代理不持久消息)和broker.useJmx=false(代理没有打开 JMX 端口)实例化它。