O método Equals

Ola pessoal!

Conforme solicitado hoje vou falar um pouco sobre o método equals do java.

Bom vamos ao que interessa.

O nome do método já diz tudo equals do inglês "igual", significa que serve para igualar ou comparar objetos, da especificação do java "Indica se algum outro objeto é "igual a" um presente." ou seja comparação entre objetos em memoria.

Existe varios pontos que devemos elencar:

O método equals implementa uma relação de equivalência em referências a objetos não nulos:

• É reflexivo : para qualquer valor não nulo de referência x , deve retornar  true .
• Exemplos:  x.equals(x) --> true

• É simétrico : para qualquer valor não nulo de referência x e y ,  deve retornar true .
• Exemplo: 
• x.equals(y) --> true
• y.equals(x)  --> true

• É transitivo : para quaisquer valores não nulos de referência x , y , e z.
• Exemplo:
• se x.equals(y) --> true
• e y.equals(z) --> true
• então x.equals(z) --> true

• É consistente : para qualquer valor não nulo de referência x e y , várias invocações de x.equals(y) consistentemente retornar true ou retornar sempre false, desde que nenhuma informação usada em equals comparações sobre os objetos seja modificado.

• Para qualquer valor não nulo de referência x , retornar false .
• Exemplo:
•  x.equals(null) ou   x.equals(objeto nulo) --> false

O método equals para a classe Object implementa a mais exigente possível relação de equivalência em objetos, ou seja, para qualquer valor não nulo de referência x e y , este método retorna true se e somente se x e y se referem ao mesmo objeto ( x == y tem o valor true ).

Obs: note-se que geralmente é necessário sobrescrever também o método hashCode sempre que o método equals é sobrescrito, de modo a manter o contrato geral para o método hashCode , que afirma que os objectos iguais deve ter códigos de hash iguais, assunto para um proximo post.

Exemplos de codigos:

1 2 3 4 5 6 7 8 9 10

public boolean equals(Object obj) {     if (this == obj)         return true;     if (!super.equals(obj))         return false;     if (getClass() != obj.getClass())         return false;       ... }

Classe Para Gerar Chamar o Relatorio do IReport

Pessoal segue uma classe fornecida pelo Marcos Vinícius para chamar o relatorio gerado pelo IReport

view plaincopy to clipboardprint?

1. /*
2. * @(#)Relatorio.java 1.0 28/04/2006
3. *
4. * Copyright 2006 Marcos Vinícius Soares. Todos os direitos reservados.
5. * mvsoares@estadao.com.br
6. *
7. */
9. import java.sql.*;
10. import java.net.URL;
11. import java.util.HashMap;
12. import net.sf.jasperreports.engine.util.JRLoader;
13. import net.sf.jasperreports.view.JasperViewer;
14. import net.sf.jasperreports.engine.*;
15. import conexao.Conexao;
17. /**
18. * Relatorio.java
    
19. *
20. *

    A classe Relatorio deve ser utilizada para emissão de relatórios. Após a

21. * criação de algum relatório é possível exibí-lo na tela, exportá-lo para um
22. * arquivo pdf/html ou enviá-lo direto para impressão.

23. *
24. *

    A classe manipula relatórios desenvolvidos utilizando-se a ferramenta

25. * iReport e utiliza a ferramenta JasperReports para emissão dos relatórios

26. *
27. * @author Marcos Vinícius Soares
28. */
29. public class Relatorio {
31. /** Representa o relatório gerado. */
32. private JasperPrint jasperPrint_;
34. /**
35. * Cria um novo Relatorio.
36. *
37. * @param conn Conexão com o banco de dados.
38. * @param parameters Parâmetros a serem exibidos no relatório.
39. * @param localRelatorio Localização do relatório.
40. * @throws JRException Caso o relatório não seja encontrado ou haja
41. * algum problema com ele, uma exceção é gerada.
42. */
43. public Relatorio(Conexao conn, HashMap parameters, URL localRelatorio) throws JRException{
45. try {
47. // O objeto JasperReport representa o objeto JasperDesign (arquivo .jrxml) compilado.
48. // Ou seja, o arquivo .jasper
49. JasperReport jr = (JasperReport)JRLoader.loadObject(localRelatorio);
51. // JasperPrint representa o relatório gerado.
52. // É criado um JasperPrint a partir de um JasperReport, contendo o relatório preenchido.
53. this.jasperPrint_ = JasperFillManager.fillReport(jr, parameters, conn.getConnection());
55. } catch (JRException e) { throw e; }
56. }
60. /**
61. * Cria um novo Relatorio.
62. *
63. * @param conn Conexão com o banco de dados.
64. * @param parameters Parâmetros a serem exibidos no relatório.
65. * @param localRelatorio Localização do relatório.
66. * @throws JRException Caso o relatório não seja encontrado ou haja
67. * algum problema com ele, uma exceção é gerada.
68. */
69. public Relatorio(Conexao conn, HashMap parameters, String localRelatorio) throws JRException{
71. try {
73. // O objeto JasperReport representa o objeto JasperDesign (arquivo .jrxml) compilado.
74. // Ou seja, o arquivo .jasper
75. JasperReport jr = (JasperReport)JRLoader.loadObject(localRelatorio);
77. // JasperPrint representa o relatório gerado.
78. // É criado um JasperPrint a partir de um JasperReport, contendo o relatório preenchido.
79. this.jasperPrint_ = JasperFillManager.fillReport(jr, parameters, conn.getConnection());
81. } catch (JRException e) { throw e; }
82. }
86. /**
87. * Cria um novo Relatorio.
88. *
89. * @param conn Conexão com o banco de dados.
90. * @param sql Expressão SQL (SELECT...) a ser utilizada para preenchimento do relatório
91. * @param parameters Parâmetros a serem exibidos no relatório.
92. * @param localRelatorio Localização do relatório.
93. * @throws JRException Caso o relatório não seja encontrado ou haja
94. * algum problema com ele, uma exceção é gerada.
95. * @throws SQLException Caso exista alguma divergência ou problema com
96. * a Expressão SQL passada como parâmetro, uma exceção é gerada.
97. */
98. public Relatorio(Conexao conn, String sql,
99. HashMap parameters, URL localRelatorio) throws SQLException, JRException {
101. try {
103. // O objeto JasperReport representa o objeto JasperDesign (arquivo .jrxml) compilado.
104. // Ou seja, o arquivo .jasper
105. JasperReport jr = (JasperReport)JRLoader.loadObject(localRelatorio);
107. // Resultado da consulta
108. ResultSet rs = conn.executeQuery(sql);
110. // JRResultSetDataSource é uma implementaçao de JRDataSource, o qual é requerido
111. // como parametro para preencher o relatório criado.
112. // Ele armazena o dados do ResultSet
113. JRResultSetDataSource jrRS = new JRResultSetDataSource(rs);
115. // JasperPrint representa o relatório gerado.
116. // É criado um JasperPrint a partir de um JasperReport, contendo o
117. // relatório preenchido.
118. this.jasperPrint_ = JasperFillManager.fillReport(jr, parameters, jrRS);
120. rs.close();
122. }
123. catch (SQLException e) { throw e; }
124. catch (JRException e) { throw e; }
125. }
129. /**
130. * Cria um novo Relatorio.
131. *
132. * @param conn Conexão com o banco de dados.
133. * @param sql Expressão SQL (SELECT...) a ser utilizada para preenchimento do relatório
134. * @param parameters Parâmetros a serem exibidos no relatório.
135. * @param localRelatorio Localização do relatório.
136. * @throws JRException Caso o relatório não seja encontrado ou haja
137. * algum problema com ele, uma exceção é gerada.
138. * @throws SQLException Caso exista alguma divergência ou problema com
139. * a Expressão SQL passada como parâmetro, uma exceção é gerada.
140. */
141. public Relatorio(Conexao conn, String sql,
142. HashMap parameters, String localRelatorio) throws SQLException, JRException {
144. try {
146. // O objeto JasperReport representa o objeto JasperDesign (arquivo .jrxml) compilado.
147. // Ou seja, o arquivo .jasper
148. JasperReport jr = (JasperReport)JRLoader.loadObject(localRelatorio);
150. // Resultado da consulta
151. ResultSet rs = conn.executeQuery(sql);
153. // JRResultSetDataSource é uma implementaçao de JRDataSource, o qual é requerido
154. // como parametro para preencher o relatório criado.
155. // Ele armazena o dados do ResultSet
156. JRResultSetDataSource jrRS = new JRResultSetDataSource(rs);
158. // JasperPrint representa o relatório gerado.
159. // É criado um JasperPrint a partir de um JasperReport, contendo o
160. // relatório preenchido.
161. this.jasperPrint_ = JasperFillManager.fillReport(jr, parameters, jrRS);
163. rs.close();
165. }
166. catch (SQLException e) { throw e; }
167. catch (JRException e) { throw e; }
168. }
172. /**
173. * Cria um novo Relatorio.
174. *
175. * @param parameters Parâmetros a serem exibidos no relatório.
176. * @param localRelatorio Localização do relatório.
177. * @throws JRException Caso o relatório não seja encontrado ou haja
178. * algum problema com ele, uma exceção é gerada.
179. */
180. public Relatorio(HashMap parameters, URL localRelatorio) throws JRException {
182. try {
184. // O objeto JasperReport representa o objeto JasperDesign (arquivo .jrxml) compilado.
185. // Ou seja, o arquivo .jasper
186. JasperReport jr = (JasperReport) JRLoader.loadObject(localRelatorio);
188. // JREmptyDataSource é uma implementaçao de JRDataSource, o qual é requerido
189. // como parametro para preencher o relatório criado.
190. // Ele armazena o dados do ResultSet, que, neste caso, é vazio
191. JREmptyDataSource jrEDS = new JREmptyDataSource();
193. // Jasper Print representa o relatório gerado.
194. // É criado um JasperPrint a partir de um JasperReport, contendo o
195. // relatório preenchido.
196. this.jasperPrint_ = JasperFillManager.fillReport(jr, parameters, jrEDS);
198. } catch (JRException e) { throw e; }
199. }
203. /**
204. * Cria um novo Relatorio
205. *
206. * @param parameters Parâmetros a serem exibidos no relatório.
207. * @param localRelatorio Localização do relatório.
208. * @throws JRException Caso o relatório não seja encontrado ou haja
209. * algum problema com ele, uma exceção é gerada.
210. */
211. public Relatorio(HashMap parameters, String localRelatorio) throws JRException {
213. try {
215. // O objeto JasperReport representa o objeto JasperDesign (arquivo .jrxml) compilado.
216. // Ou seja, o arquivo .jasper
217. JasperReport jr = (JasperReport) JRLoader.loadObject(localRelatorio);
219. // JREmptyDataSource é uma implementaçao de JRDataSource, o qual é requerido
220. // como parametro para preencher o relatório criado.
221. // Ele armazena o dados do ResultSet, que, neste caso, é vazio
222. JREmptyDataSource jrEDS = new JREmptyDataSource();
224. // Jasper Print representa o relatório gerado.
225. // É criado um JasperPrint a partir de um JasperReport, contendo o
226. // relatório preenchido.
227. this.jasperPrint_ = JasperFillManager.fillReport(jr, parameters, jrEDS);
229. } catch (JRException e) { throw e; }
230. }
234. /**
235. * Exibe o relatório na tela.
236. */
237. public void exibirRelatorio() {
238. // emite o relatório na tela
239. // false indica que a aplicação não será finalizada caso o relatório seja fechado
240. JasperViewer.viewReport(this.jasperPrint_, false);
241. }
245. /**
246. * Grava o relatório em um arquivo de formato pdf.
247. *
248. * @param caminhoDestino Caminho onde o arquivo será gravado.
249. */
250. public void exportaParaPdf(String caminhoDestino) throws JRException {
252. try {
253. // Gera o arquivo PDF
254. JasperExportManager.exportReportToPdfFile(this.jasperPrint_, caminhoDestino);
255. } catch (JRException e) { throw e; }
257. }
261. /**
262. * Grava o relatório em um arquivo de formato html.
263. *
264. * @param caminhoDestino Caminho onde o arquivo será gravado.
265. */
266. public void exportaParaHtml(String caminhoDestino) throws JRException {
268. try {
269. // Gera o arquivo PDF
270. JasperExportManager.exportReportToHtmlFile(this.jasperPrint_, caminhoDestino);
271. } catch (JRException e) { throw e; }
273. }
277. /**
278. * Envia o relatório para impressão, exibindo uma caixa de dialogo de impressão ou não.
279. *
280. * @param exibeCaixaDialogo Boolean indicando se será exibida uma caixa de diálogo ou não.
281. */
282. public void imprimir(boolean exibeCaixaDialogo) throws JRException {
284. try {
285. // Imprime o relatório
286. // o segundo parâmetro indica se existirá uma caixa de dialogo antes ou nao
287. JasperPrintManager.printReport(this.jasperPrint_, exibeCaixaDialogo);
288. } catch (JRException e) { throw e; }
290. }
294. }

Primeiro vc deve criar um relatório atraves de um dos metodos disponiveis, depois basta chamar algum metodo....

Esse objeto conexao representa uma conexao com o banco de dados, e o método getConn retorna o objeto Connection associado a ele. No caso, vc deve implementar o seu, pois não sei qual bd vc está utilizando.