38.3. 自动诊断和配置

自动发现是一种可让您动态地将组件添加到 Apache Camel 应用程序的机制。组件 URI 前缀用作按需加载组件的密钥。例如，如果 Apache Camel 遇到端点 URI，activemq://MyQName 并且 ActiveMQ 端点尚未加载，则 Apache Camel 会搜索 activemq 前缀标识的组件，并动态加载该组件。

在配置自动发现前，您必须确保您的自定义组件类可从您当前的 classpath 访问。通常，您可以将自定义组件类捆绑到 JAR 文件中，并将 JAR 文件添加到 classpath 中。

要启用组件的自动发现，请创建一个名为组件前缀的 Java 属性文件，组件前缀，并将该文件存储在以下位置：

/META-INF/services/org/apache/camel/component/component-prefix

component-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

您可以通过在 Apache Camel Spring 配置文件 META-INF/spring/camel-context.xml 中配置组件来添加组件。要查找组件，组件的 URI 前缀与 Spring 配置中 bean 元素的 ID 属性匹配。如果组件前缀与 bean 元素 ID 匹配，Apache Camel 会实例化引用类并注入 Spring 配置中指定的属性。

如果要注入组件类的任何属性，请将其定义为 bean 属性。例如：

public class CustomComponent extends
  DefaultComponent<CustomExchange> {
    ...
    PropType getProperty() { ... }
    void setProperty(PropType v) { ... }
}

getProperty（） 方法和 setProperty（） 方法访问 属性 的值。

要在 Spring 中配置组件，请编辑配置文件 META-INF/spring/camel-context.xml，如 例 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（） 将值 attribute Value 注入到 property 属性中。

例 38.2 “JMS 组件 Spring 配置” 演示了如何通过定义 ID 等于 jms 的 bean 元素来配置 Apache Camel 的 JMS 组件。这些设置添加到 Spring 配置文件 camel-context.xml 中。

<?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&amp;broker.useJmx=false"/> 4
       </bean>
    </property>
  </bean>
</beans>