camel-file-watch-kafka-connector source configuration

Connector description: Get notified about file events in a directory using java.nio.file.WatchService.

When using camel-file-watch-kafka-connector as source make sure to use the following Maven dependency to have support for the connector:

<dependency>
  <groupId>org.apache.camel.kafkaconnector</groupId>
  <artifactId>camel-file-watch-kafka-connector</artifactId>
  <version>x.x.x</version>
  <!-- use the same version as your Camel Kafka connector version -->
</dependency>

To use this Source connector in Kafka connect you’ll need to set the following connector.class

connector.class=org.apache.camel.kafkaconnector.filewatch.CamelFilewatchSourceConnector

The camel-file-watch source connector supports 20 options, which are listed below.

Name Description Default Required Priority

camel.source.path.path

Path of directory to consume events from.

null

true

HIGH

camel.source.endpoint.antInclude

ANT style pattern to match files. The file is matched against path relative to endpoint path. Pattern must be also relative (not starting with slash)

"**"

false

MEDIUM

camel.source.endpoint.autoCreate

Auto create directory if does not exists.

true

false

MEDIUM

camel.source.endpoint.bridgeErrorHandler

Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions occurred while the consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by the routing Error Handler. By default the consumer will use the org.apache.camel.spi.ExceptionHandler to deal with exceptions, that will be logged at WARN or ERROR level and ignored.

false

false

MEDIUM

camel.source.endpoint.concurrentConsumers

The number of concurrent consumers. Increase this value, if your route is slow to prevent buffering in queue.

1

false

MEDIUM

camel.source.endpoint.events

Comma separated list of events to watch. One of: [CREATE] [MODIFY] [DELETE]

"CREATE,MODIFY,DELETE"

false

MEDIUM

camel.source.endpoint.fileHasher

Reference to io.methvin.watcher.hashing.FileHasher. This prevents emitting duplicate events on some platforms. For working with large files and if you dont need detect multiple modifications per second per file, use #lastModifiedTimeFileHasher. You can also provide custom implementation in registry.

"#murmur3FFileHasher"

false

MEDIUM

camel.source.endpoint.pollThreads

The number of threads polling WatchService. Increase this value, if you see OVERFLOW messages in log.

1

false

MEDIUM

camel.source.endpoint.queueSize

Maximum size of queue between WatchService and consumer. Unbounded by default.

2147483647

false

MEDIUM

camel.source.endpoint.recursive

Watch recursive in current and child directories (including newly created directories).

true

false

MEDIUM

camel.source.endpoint.useFileHashing

Enables or disables file hashing to detect duplicate events. If you disable this, you can get some events multiple times on some platforms and JDKs. Check java.nio.file.WatchService limitations for your target platform.

true

false

MEDIUM

camel.source.endpoint.exceptionHandler

To let the consumer use a custom ExceptionHandler. Notice if the option bridgeErrorHandler is enabled then this option is not in use. By default the consumer will deal with exceptions, that will be logged at WARN or ERROR level and ignored.

null

false

MEDIUM

camel.source.endpoint.exchangePattern

Sets the exchange pattern when the consumer creates an exchange. One of: [InOnly] [InOut] [InOptionalOut]

null

false

MEDIUM

camel.component.file-watch.bridgeErrorHandler

Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions occurred while the consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by the routing Error Handler. By default the consumer will use the org.apache.camel.spi.ExceptionHandler to deal with exceptions, that will be logged at WARN or ERROR level and ignored.

false

false

MEDIUM

camel.component.file-watch.concurrentConsumers

The number of concurrent consumers. Increase this value, if your route is slow to prevent buffering in queue.

1

false

MEDIUM

camel.component.file-watch.fileHasher

Reference to io.methvin.watcher.hashing.FileHasher. This prevents emitting duplicate events on some platforms. For working with large files and if you dont need detect multiple modifications per second per file, use #lastModifiedTimeFileHasher. You can also provide custom implementation in registry.

"#murmur3FFileHasher"

false

MEDIUM

camel.component.file-watch.pollThreads

The number of threads polling WatchService. Increase this value, if you see OVERFLOW messages in log.

1

false

MEDIUM

camel.component.file-watch.queueSize

Maximum size of queue between WatchService and consumer. Unbounded by default.

2147483647

false

MEDIUM

camel.component.file-watch.useFileHashing

Enables or disables file hashing to detect duplicate events. If you disable this, you can get some events multiple times on some platforms and JDKs. Check java.nio.file.WatchService limitations for your target platform.

true

false

MEDIUM

camel.component.file-watch.autowiredEnabled

Whether autowiring is enabled. This is used for automatic autowiring options (the option must be marked as autowired) by looking up in the registry to find if there is a single instance of matching type, which then gets configured on the component. This can be used for automatic configuring JDBC data sources, JMS connection factories, AWS Clients, etc.

true

false

MEDIUM

The camel-file-watch source connector has no converters out of the box.

The camel-file-watch source connector has no transforms out of the box.

The camel-file-watch source connector has no aggregation strategies out of the box.