Como usar o JNotify para monitorar diretórios em Java

O objetivo do Jnotify é notificar (como o próprio nome já sugere) sobre alguma alteração ocorrida em determinado diretório que está sendo monitorado. Isto é muito útil em situações em que precisamos saber quando alguém alterar determinado arquivo, deletar, criar ou modificar. Há inúmeras situações onde a biblioteca Jnotify pode ser aplicada, até mesmo em comunicação de sistemas totalmente distintos.

Imagine a seguinte situação: Você tem um sistema que funciona em COBOL e outro em Java, quando uma informações for inserida no sistema em COBOL você gostaria de replicar imediatamente essa informação em Java, como fazer isso ? (Esqueça Webservice). Uma solução é escrever os dados em um arquivo TXT, XML ou qualquer de sua preferência através do COBOL, e deixar o Java monitorando esse diretório através do Jnotify. Assim quando um dado for inserido no sistema em COBOL, ele escreverá um arquivo chamado “dado001.txt” e o Java capturará esse arquivo “dado001.txt” e irá fazer a inserção no banco, tudo automático sem interação homem-máquina, ou seja, essa é literalmente uma interação máquina-máquina.

Configurando Jnotify

Para este artigo utilizaremos a biblioteca Jnotify para o Linux 64bits (disponibilizada na seção de downloads deste artigo). Vamos ao passo a passo:

• Baixe a biblioteca libjnotify.so disponível na seção de downloads deste artigo.
• Coloque a libjnotify.so no diretório “/usr/lib/java/”.
• Crie um novo projeto Java no eclipse e crie também uma classe chamada Myjnotifyapp.java.
• Vá no menu Run -> Run Configurations...
• Na tela que abriu clique no ícone para adicionar uma nova configuração, assim como mostrado na figura 1.

Em “Project” selecione o seu projeto criado, em “Main Class” deve estar selecionada a classe Myjnotifyapp (em nosso caso). Após isso, clique na aba “Arguments” e na área “VM Arguments” digite: -Djava.library.path=/usr/lib/java.

Isso irá garantir a inicialização da biblioteca libjnotify.so pela VM (Virtual Machine), veja como ficou na figura 2.

Por fim temos que apenas adicionar a biblioteca jnotify.jar ao nosso projeto, este encontra-se na seção de downloads deste artigo.

Usando o Jnotify

Após a configuração acima ser realizada, estamos prontos para começar a utilização da biblioteca em questão. Como já temos criado uma classe Myjnotifyapp vamos trabalhar nesse para exemplificar melhor o uso do Jnotify, utilizaremos também a biblioteca LOG4J para criar logs da nossa aplicação, ou seja, quando arquivos forem criados, deletados, alterados e etc.

Veja abaixo na listagem 1 a nossa classe Myjnotifyapp completa com todos os recursos necessários para monitorar determinado diretório.

import org.apache.log4j.Logger;

import net.contentobjects.jnotify.JNotify;
import net.contentobjects.jnotify.JNotifyAdapter;
import net.contentobjects.jnotify.JNotifyException;

public class Myjnotifyapp {
	
	private static Logger logger = Logger.getLogger(Myjnotifyapp.class);

	/* Diretório que que o JNotify ficará monitorando para
	   ver se alguma das alterações solicitadas na variável 
	   'mask' ocorreram.
	 */
	private static final String PATH_TO_LISTEN = "/home/admin/monitoring_dir";
	
	/*
	 * a variável 'mask' guardará a mascará necessária para o JNotify
	 * saber o que ele deve monitorar no diretório acima. Em nosso caso
	 * ele irá monitorar: Criações, Deleções, Modificações e Renomeações de arquivos.
	 * */
	private static int mask = JNotify.FILE_CREATED |
			JNotify.FILE_DELETED |
			JNotify.FILE_MODIFIED |
			JNotify.FILE_RENAMED;
	
	/*
	 * Serve para identificar se o JNotify irá ler um diretório que foi criado
	 * dentro do nosso diretório monitorado. 
	 * Ex: /tmp/dir1. O diretório dir1 será monitorado pois está dentro de /tmp. Mas
	 * se criarmos /tmp/dir1/subdir1/, a variável 'watchSubtree' deverá estar habilitada para que
	 * o JNotify monitore também o subdir1. 
	 * */
	private static boolean watchSubtree = true;
	/**
	 * @param args
	 */
	public static void main(String[] args) {
		/*
		 * Iniciamos a criação de Watch apartir da API JNotify, e gravamos o seu ID na 
		 * variável watchID, assim podemos remover posteriormente esse Watch pelo seu ID.
		 * */
		try {
			int watchID = JNotify.addWatch(PATH_TO_LISTEN, mask, watchSubtree, new JNotifyAdapter() {

				@Override
				public void fileCreated(int wd, String rootPath,
						String name) {
					logger.info("Arquivo criado: "+name);
				}

				@Override
				public void fileRenamed(int wd, String rootPath,
						String oldName, String newName) {
					logger.info("Arquivo renomeado de: "+oldName+" para: "+newName);
				}
				
				@Override 
				public void fileDeleted(int wd, String rootPath, String name){
					logger.info("Arquivo deletado: "+name);
				}
				
				@Override 
				public void fileModified(int wd, String rootPath, String name){
					logger.info("Arquivo modificado: "+name);
				}
			});
			
				Thread.sleep(1000000);
			
		} catch (JNotifyException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		} catch (InterruptedException e){
			e.printStackTrace();
		}

	}

}

A classe é autoexplicativa, foram adicionados vários comentários para cada passo afim de facilitar o entendimento desta. Vamos atentar apenas a alguns pontos importantes:

• O Jnotify gera uma checked exception, por isso precisamos fazer um bloco try-catch
• O Thread.sleep(tempo), serve para manter a nossa classe monitorando determinado diretório por um período de tempo, se tirássemos esse código, ela apenas iria inicializar e encerrar, quase que instantaneamente.

Faça você mesmo os testes, crie um diretório a seu gosto e crie arquivos, pastas, renomeie e veja o resultado.

Conclusão

Para quem já trabalha com Java 7 pode usufruir de bibliotecas nativas do Java que fazem a mesma tarefa do Jnotify, porém neste artigo consideramos a utilização de versões anteriores a 7, pois estas não possuem recurso nativo de monitoramento de diretórios, tal como o Jnotify o faz.