blob: a13da763cef3ac72f27d5dd6e30eafc3704e8d89 [file] [log] [blame]
// Do not edit directly!
// This file was generated by camel-quarkus-maven-plugin:update-extension-doc-page
[[file-watch]]
= File Watch
[.badges]
[.badge-key]##Since Camel Quarkus##[.badge-version]##1.0.0-M5## [.badge-key]##JVM##[.badge-supported]##supported## [.badge-key]##Native##[.badge-supported]##supported##
Get notified about file events in a directory using java.nio.file.WatchService.
== What's inside
* https://camel.apache.org/components/latest/file-watch-component.html[File Watch component], URI syntax: `file-watch:path`
Please refer to the above link for usage and configuration details.
== Maven coordinates
[source,xml]
----
<dependency>
<groupId>org.apache.camel.quarkus</groupId>
<artifactId>camel-quarkus-file-watch</artifactId>
</dependency>
----
Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
== Camel Quarkus limitations
The underlying Camel component configures the Directory Watcher in a platform specific way:
* On Mac, the `io.methvin.watchservice.MacOSXListeningWatchService` is used that depends on
`https://github.com/java-native-access/jna[net.java.dev.jna:jna]`.
* Other platforms use `java.nio.file.WatchService` provided by the Java Runtime.
Because JNA is https://github.com/oracle/graal/issues/673[not supported on GraalVM] yet, we made the component to behave differently on Camel Quarkus: We are substituting the respective Directory Watcher method do use the stock `java.nio.file.WatchService` also on Mac.