jinotify: Java file event notifier on Linux

Jinotify is a file change notifier implemented with inotify(7) and epoll(7). Jinotify provides simple and strong interface for watching file events, such as new file creation, open, delete, and so on. Jinotify is useful for java6 or under, but your Linux kernel should be more than 2.6.13+. From java7, we have nio2 which is providing much better APIs.

Example

import com.github.shinpei.jinotify.*;

class MyListner extends JinotifyListener {
    @Override
    public void onCreate (String path) {
        System.out.println("hey, you created " + path + ", huh?");
    }
}

Jinotify jinotify = new Jinotify();
MyListener listener = new MyListener();
jinotify.addWatch("/tmp", listener);
jinotify.closeNotifier();

Install (Maven)

<dependency>
    <groupId>com.github.shinpei</groupId>
    <artifactId>jinotify</artifactId>
    <version>0.1.0-SNAPSHOT</version>
</dependency>

Events

You can define following event with Jinotify. If you override methods below, it'll automatically watch event.

• Jinotify.onCreate works on when watching file or dir is created, modified file name is given as an argument.

• Jinotify.onAccess It works on when file is opened, and read contents. For example, open watching files for reading.

• Jinotify.onModified It works on when file contents are modified.

• Jinotify.onDelete It works on when watching file or dir has removed.

• Jinotify.onMoved It works on when watching file or dir has moved.

• Jinotify.onClose It works on when file is closed.

License, contact info, contribute

It's under ASL2.0. If you find bug or improvement request, please contact me through twitter, @shinpeintk. And always welcoming heartful pull request.

cheers, 🍻