34.4. ビルトイン UUID ジェネレーター

概要

Apache Camel では、CamelContext で UUID ジェネレーターを登録できます。この UUID ジェネレーターは、Apache Camel が一意の ID を生成する必要があるたびに使用されます。特に、登録済みの UUID ジェネレーターが呼び出され、Exchange.getExchangeId() および Message.getMessageId() メソッドによって返される ID を生成します。

たとえば、アプリケーションの一部が 36 文字の ID をサポートしていない場合には、デフォルトの UUID ジェネレーターを置き換えます (Websphere MQ など)。また、テスト目的でシンプルなカウンター (SimpleUuidGenerator を参照) を使用して ID を生成すると便利です。

提供される UUID ジェネレーター

Apache Camel を設定して、コアで提供される以下の UUID ジェネレーターのいずれかを使用できます。

  • org.apache.camel.impl.ActiveMQUuidGenerator - (Default) は、Apache ActiveMQ で使用されるものと同じスタイルの ID を生成します。この実装は、クラウドコンピューティング (Google App Engine など) で禁止されている JDK API を使用するので、すべてのアプリケーションに適しているとは限りません。
  • org.apache.camel.impl.SimpleUuidGenerator - 1 から始まるシンプルなカウンター ID を実装します。基礎となる実装では java.util.concurrent.atomic.AtomicLong タイプを使用するため、スレッドセーフになります。
  • org.apache.camel.impl.JavaUuidGenerator - java.util.UUID タイプに基づいて ID を実装します。java.util.UUID は同期されるため、同時システムのパフォーマンスに影響する可能性があります。

カスタム UUID ジェネレーター

カスタム UUID ジェネレーターを実装するには、例34.5「UuidGenerator インターフェイス」 に示されている org.apache.camel.spi.UuidGenerator インターフェイスを実装します。一意の ID 文字列を返すには、generateUuid() を実装する必要があります。

例34.5 UuidGenerator インターフェイス

// Java
package org.apache.camel.spi;

/**
 * Generator to generate UUID strings.
 */
public interface UuidGenerator {
    String generateUuid();
}

Java を使用した UUID ジェネレーターの指定

Java を使用してデフォルトの UUID ジェネレーターを置き換えるには、現在の CamelContext オブジェクトの setUuidGenerator() メソッドを呼び出します。たとえば、以下のように SimpleUuidGenerator インスタンスを現在の CamelContext に登録できます。

// Java
getContext().setUuidGenerator(new org.apache.camel.impl.SimpleUuidGenerator());
注記

ルートがアクティベートされる 前に、起動時に setUuidGenerator() メソッドを呼び出す必要があります。

Spring を使用した UUID ジェネレーターの指定

Spring を使用してデフォルトの UUID ジェネレーターを置き換えるには、Spring bean 要素を使用して UUID ジェネレーターのインスタンスを作成することのみが必要ですcamelContext インスタンスが作成されると、Spring レジストリーが自動的に検索され、org.apache.camel.spi.UuidGenerator を実装する Bean を検索します。たとえば、以下のように CamelContextSimpleUuidGenerator インスタンスを登録することができます。

<beans ...>
  <bean id="simpleUuidGenerator"
        class="org.apache.camel.impl.SimpleUuidGenerator" />

  <camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
      ...
  </camelContext>
  ...
</beans>