Utilizando Bibliotecas JAR: Primeiros Passos

1. Introduç�o

JAR (Java ARchive) � um arquivo compactado no formato ZIP que cont�m um conjunto de classes (arquivos �.class�) e arquivos de configuraç�o. O formato JAR � utilizado para permitir a distribuiç�o de bibliotecas ou, at� mesmo, sistemas inteiros em Java (uma vez que � poss�vel montar arquivos JAR formados por centenas de classes).

As principais bibliotecas Java desenvolvidas por terceiros � ou seja, bibliotecas que n�o fazem parte da JDK - s�o estruturadas e distribu�das em arquivos JAR. Apenas para citar alguns exemplos de bibliotecas populares, podemos relacionar: Joda (biblioteca para facilitar a manipulaç�o de tipos data e hora), XStream (biblioteca para serializar objetos para XML), Weka (biblioteca de algoritmos para mineraç�o de dados), Gson (biblioteca para serializar objetos para JSON), entre diversas outras.

Apesar de muito popular, o formato JAR �assusta� um pouco os iniciantes em Java, pois o uso dessas bibliotecas pressup�e o conhecimento de certos conceitos n�o muito triviais do universo Java, como por exemplo: configuraç�o da vari�vel CLASSPATH, definiç�o da estrutura de diret�rios/pacotes do sistema, conhecimento da estrutura interna do JAR, entre outros. Muitas vezes, um desenvolvedor quer apenas testar essas bibliotecas de uma forma b�sica, evitando lidar com esse monte de conceitos (e suas complicaç�es associadas!). Felizmente, isso � poss�vel. Na seç�o a seguir apresentamos um roteiro para que voc� possa testar e utilizar bibliotecas JAR de uma maneira r�pida e direta em seus programas.

2. Roteiro para Testar/Utilizar Bibliotecas JAR

Para apresentar o roteiro, utilizaremos como exemplo a biblioteca �gson-2.2.2.jar�, apresentada em nosso artigo anterior: https://www.devmedia.com.br/introducao-ao-formato-json/25275. Execute as etapas a seguir:

Passo 1: crie uma pasta em seu computador, como por exemplo �C:\TESTE� e coloque o arquivo JAR nessa pasta (Figura 1).

Figura 1: Pasta C:\TESTE com o arquivo JAR

Passo 2: Digite programa Java mostrado na Listagem 1 e salve-o na pasta �C:\TESTE�, com o nome �TesteGson.java� (Figura 2). Este programa faz uso da classe Gson, do pacote com.google.gson.Gson, que � distribu�do exatamente no arquivo �gson-2.2.2.jar� (se voc� quiser conferir isso, renomeie temporariamente o arquivo de JAR para ZIP e explore a sua estrutura de pastas).

Listagem 1: Programa exemplo que utiliza a classe �Gson� de �gson-2.2.2.jar�


import com.google.gson.Gson;

    //classe com exemplo de uso do Gson
    public class TesteGson {

       public static void main(String[] args) {
 
            //instancia e preenche um vetor de strings
            String escritores[] = new String[5];
			
			escritores[0] = "George Orwell";
			escritores[1] = "Thomas More";
			escritores[2] = "Plat�o";
			escritores[3] = "Tommaso Campanella";
			escritores[4] = "Leonardo Boff";

            //instancia um objeto da classe Gson           
            Gson gson = new Gson();
             
            //serializa o conte�do do vetor para o formato JSON 
			//e armazena em uma vari�vel auxiliar
            String aux = gson.toJson(escritores);
             
            //imprime a string JSON
            System.out.println(aux);
         }
}

Figura 2: Pasta C:\TESTE com o arquivo JAR e o programa Java

Passo 4 - Compilaç�o: agora devemos compilar o programa Java. Como os dois arquivos est�o na mesma pasta, isto pode ser feito atrav�s da linha de comando mostrada na Listagem 2

Listagem 2: Compilando o programa


C:\TESTE>javac -cp .;gson-2.2.2.jar TesteGson.java

Passo 5 - Execuç�o: para executar o programa, o processo � an�logo, como mostra a Listagem 3:

Listagem 3: Executando o programa


C:\TESTE>java -cp .;gson-2.2.2.jar TesteGson

["George Orwell","Thomas More","Plat�o","Tommaso Campanella","Leonardo Boff"]

Explicaç�o: o par�metro �cp (ou �classpath) serve para indicar ao Java quais s�o as pastas onde ele deve procurar pelas classes que comp�em o seu programa. Ap�s o �cp voc� deve indicar uma lista de diret�rios ou de arquivos JAR separados pelo caractere � ; � (ponto-e-v�rgula) caso o seu sistema seja Windows (ou � : � no caso de Linux).

Observe com calma a linha de comando mostrada na Listagem 3. Veja que o primeiro item ap�s o �cp � � . � (um ponto!), que significa o diret�rio corrente. J� o segundo item � �gson-2.2.2.jar�, o arquivo JAR que cont�m a classe Gson. O resultado disto �: o Java ir� procurar por classes tanto no diret�rio corrente, como �dentro� do arquivo �gson-2.2.2.jar�. O uso do ponto � . � como primeira entrada ap�s o par�metro �cp assume que o arquivo TesteGson.java est� no diret�rio corrente (�C:\TESTE�) e faz com que o mesmo possa localizado pelo compilador.

A maioria dos iniciantes em Java n�o percebe esse detalhe de usar o �pontinho� como primeira entrada e quase enlouquece na hora de tentar executar o programa. Quando voc� esquecer de colocar o � . � como primeira entrada, o programa n�o � executado e o Java retorna uma mensagem de erro como a mostrada na Listagem 4 (exceç�o do tipo ClassNotFoundException).

Listagem 4:Erro � Esquecemos de especificar o ponto � . � ap�s o -cp


C:\TESTE>java -cp gson-2.2.2.jar TesteGson
Erro: N�o foi poss�vel localizar nem carregar a classe principal TesteGson

3. Utilizando Diversos arquivos JAR

O exemplo apresentado na seç�o anterior envolveu o uso de apenas um arquivo JAR. No entanto, � poss�vel utilizar diversos arquivos, bastando separ�-los por � ; �. Supondo que todos os JAR estejam em um mesmo diret�rio, a sintaxe seria similar � mostrada na Listagem 5. No exemplo, temos tr�s arquivos JAR: �lib1.jar�, �lib2.jar� e �lib3.jar� e o programa �MinhaClasse.class� todos localizados na mesma pasta.

Listagem 5: Executando o programa


C:\TESTE>java -cp .;lib1.jar;lib2.jar;lib3.jar MinhaClasse

A partir do Java 6, foi adicionada a possibilidade de utilizar o caractere asterisco para incluir todos os arquivos de uma vez no classpath, como mostra a Listagem 6 (obs: no caso do Linux, o asterisco deve vir entre aspas simples � � * �).

Listagem 6: Executando o programa


C:\TESTE>java -cp .;"*" MinhaClasse

4. Conclus�es

Este artigo apresentou um roteiro direto para facilitar o processo de incorporaç�o e teste de bibliotecas JAR em programas Java. Este assunto sempre confunde os iniciantes em Java, j� que o formato JAR possui uma s�rie de conceitos associados que n�o s�o t�o triviais. Mas agora que voc� j� conhece o m�todo mais simples para trabalhar com bibliotecas JAR poder� �avançar de n�vel� e estudar esses conceitos. � importante que todo programador Java entenda o significado de CLASSPATH e aprenda sobre a estrutura e a criaç�o de arquivos JAR.

Utilizando Bibliotecas JAR: Primeiros Passos

1. Introduç�o

2. Roteiro para Testar/Utilizar Bibliotecas JAR

3. Utilizando Diversos arquivos JAR

4. Conclus�es

Artigos relacionados