ZXing: Como ler códigos de barras em Java

Neste artigo veremos o uso prático de uma biblioteca chamada de Zxing, que tem por objetivo trabalhar com código de barras 1D e 2D. Mas, primeiro, devemos entender o que é um código de barras e como ele funciona.

O Código de Barras é uma representação gráfica de dados numéricos ou alfanuméricos, estes estão presentes com muita frequência no nosso dia a dia e tem a representação como na Figura 1.

A decodificação ou leitura da Figura 1 é realizada da seguinte forma: um scanner (leitor de código de barras) emite um raio vermelho que percorre todas as barras e onde a barra for escura, a luz é absorvida, e onde for branca (espaços em branco) a luz é refletida para o scanner e no computador é feita a conversão para números ou letras.

Existem diversos formatos de código de barras, por exemplo: Código 39, EAN-13, GS1-128, DUN-14 e etc. Cada um destes tem sua especificidade, por exemplo: o código 39 ou Code 39 possibilita a codificação de letras e números e mais alguns símbolos especiais.

Obviamente que o conceito apresentado aqui foi apenas introdutório em relação ao funcionamento do código de barras para que você leitor possa continuar lendo o restante do artigo com mais confiança no assunto tratado. Existem muitas mais características em relação a cada formatação e como elas são feitas, mas não é foco do nosso artigo apresentar tais conceitos e sim o funcionamento na prática da biblioteca Zxing.

Zxing

Nem sempre temos o leitor de código de barras (scanner) em mãos ou temos situações em que precisamos dispensar o seu uso e é aqui que entra a API Zxing. Para entender melhor, vamos a um cenário real: “O seu sistema deve possuir um módulo onde o usuário fará o upload de contratos assinados pelo seu cliente (imagens) e o sistema deve associar automaticamente estas imagens com o cliente correto sem nenhuma intervenção humana. Na capa do contrato, que pode possuir N folhas, há um código de barras que identifica a numeração do contrato (a numeração do contrato possui o código do cliente em sua composição)."

Sendo assim, nós podemos usar o Zxing para “ler” a capa do contrato e extrair a numeração contida no código de barras e após extração da numeração nós podemos buscar o cliente correspondente. Dado o cenário exposto, nós podemos perceber que o Zxing é muito útil quando precisamos ler as informações contidas no código de barras e não temos a disponibilidade de um leitor de código de barras ou mesmo não podemos utilizar, como mostrado no cenário. Neste artigo veremos apenas como fazer a leitura de um código de barras através de uma imagem que contenha tal código, mas vale ressaltar que o Zxing também realiza a criação de código de barras a partir do valor informado.

O primeiro passo para usar a API Zxing no nosso projeto é fazer a importação das bibliotecas necessárias (o link de download está no final do artigo). Coloque estas no classpath do seu projeto para que possa usar as classes que veremos mais a frente.

Vejamos agora como ficará a interface da nossa aplicação na Figura 2.

A nossa aplicação contém quatro componentes que serão de grande utilidade: o primeiro é o campo de texto onde será mostrado o caminho da imagem que selecionamos, o segundo é o resultado do valor extraído do código de barras, o terceiro é o botão 'Selecionar Imagem' que nos possibilita selecionar uma imagem do nosso computador e o quarto botão 'Processar' inicia o processamento do Zxing que fará a leitura do código de barras e extração dos valores necessários.

Agora vejamos como ficou nosso arquivo .form para quem desejar criar a interface apresentada na Figura 2, no Netbeans.

O código acima dispensa comentário, pois ele servirá apenas para que você possa reproduzir a mesma interface no seu ambiente de desenvolvimento, caso seja o Netbeans.

Enfim começaremos a construir os métodos de cada botão acima e depois mostraremos como ficou nossa classe Fzxing por completo.

O nosso botão jButtonSelecionar possui um listener que dispara o método jButtonSelecionarActionPerformed(), que é chamado toda vez que o usuário clicar no botão. Na Listagem 2 temos exatamente a demonstração do método que possibilita a seleção da imagem. Logo na primeira e segunda linhas temos a criação de um objeto JfileChooser e a configuração do modo de seleção para FILES_ONLY, assim, restringimos a escolha do usuário apenas para arquivos e não diretórios. Continuando a codificação, nós temos uma condição que abre um diálogo do tipo 'saveDialog' e, caso o usuário escolha um arquivo, em vez de clicar em cancelar, o resultado será diferente de 1 e entramos na condição proposta.

Dentro da condição proposta nós capturamos o arquivo escolhido através do fchooser.getSelectedFile() e logo depois transformamos o arquivo, que deve ser uma imagem, em um BufferedImage, não esquecendo de mostrar o caminho da imagem no campo jTextFieldImagem. Todo esse processo faz com que armazenemos a imagem selecionada em um objeto do tipo BufferedImage que está declarado no início da nossa classe Fzxing, ou seja, um atributo de instância.

Nós só podemos processar a imagem caso haja alguma, e sendo assim, a primeira checagem da Listagem 3é conferir se o objeto 'buffImage' não é nulo. As próximas linhas são dedicadas a funções exclusivas do Zxing que estão numeradas com linhas para facilitar a explicação:

• As linhas 1 e 2 fazem o tratamento necessário na imagem para só então processá-la em um 'Reader' específico do Zxing. No nosso caso, na linha 3 nós criamos um MultiFormatReader que possibilita a leitura de código de barras em diversos formatos (Code 39, EAN-13 …), mas você pode criar um tipo específico de Reader caso ache necessário.
• Na linha 4 nós usamos o Reader criado na linha 3 para chamar o método 'decode()'que retorna os dados encontrados no código de barras, O retorno deste método é um Result que contém diversos método como o getText(), que retorna o dado em forma de string, e o getBarcodeFormat() que retorna o formato do código de barras e etc.

Para finalizar o artigo, iremos mostrar na Listagem 4 o código completo da classe Fzxing com todos os detalhes e implementações explicados anteriormente, para que você leitor possa utilizá-la como meio de estudo.

Este artigo teve como principal objetivo demonstrar o uso da API Zxing de forma prática, rápida e eficaz. Assim, você caro leitor, poderá usar tal biblioteca em seus projetos que precisam realizar leitura ou escrita de código de barras em Java.