viernes, 29 de agosto de 2008

Tú puedes hacer que NetBeans 6.5 salga en español

Si te gusta Java, hablas español/castellano, y quieres que haya más gente hispana que programe en Java.. ¡este post es para ti!

¡Estamos buscando gente entusiasta como tú!

Parece un anuncio que busca gente para que venda algún producto. Pues algo así es este post.

Como lo mencioné en mi anterior post NetBeans 6.5 en Español, deseamos que el NetBeans 6.5 - el único IDE que necesitas - salga en nuestro idioma.

Quizás te preguntes ¿Por qué traducirlo?. Bueno, piensa: tu sistema operativo, tu suite de ofimática, tu correo electrónico, los software que usas en tu trabajo ¿están en español? Y si no estuvieran, ¿no te gustaría que lo estén?

Pues es la misma razón por la que varios desarrolladores nos caería bien que el NetBeans estuviera en español: es más cómodo usar un producto en nuestro idioma que en inglés.

Tienes la oportunidad de participar en este gran proyecto: Traducción del NetBeans 6.5 al Español

Somos varios países que hablamos español/castellano ¡Qué grandioso sería que tengamos un IDE traducido por nosotros mismos! ¿No te parece?

El lanzamiento oficial del NetBeans 6.5 está programado para el 15 de Octubre.

Y estamos trabajando duro para lanzar el producto en español en la misma fecha.

En este cuadro se puede apreciar cuánto estamos avanzado (columna es)
http://translatedfiles.netbeans.org/6.5/status.html

La traducción es fácil, aunque un poco laboriosa. Pero si entre todos ponemos el hombro, llegaremos a la meta sin ningún problema.

Arístides Villarreal de Panamá, miembro del NetBeans Dream Team, es el líder y coordinador del Equipo de Traducción al Español de NetBeans.

Para que sepas cómo participar, visita nuestra web: http://wiki.netbeans.org/SpanishTranslation

También te puedes suscribir a la lista: http://groups.google.com/group/traduccionnetbeans

¡Te esperamos!

martes, 26 de agosto de 2008

¿Para que los EJB?

Si hacemos una aplicación Web ¿para qué necesitamos los EJB, si todo lo podemos programar en los Servlets y los JSP?... y si programos una aplicación Desktop ¿para qué los EJB si todo lo podemos programar en las clases Swing? Pero si queremos una aplicación que sea funcional tanto en Web como en Desktop, donde la lógica de negocio debe ser la misma, y si se cambia la forma de realizar alguna rutina debe ser reflejada en en las dos aplicaciones. ¿qué hacemos?
¿Aún no está claro lo que hablo? Bueno, vayamos directo a la aplicación.

Haciendo una aplicación Web que calcula áreas

Supongamos que queremos una aplicación web llamada AreasWeb que haga cálculos de área geométricas: el área del círculo, del pentágono regular, del triángulo y del trapecio. Los parámetros que necesitamos son los siguientes:
  • Para calcular el círculo necesitamos el radio.
  • Para el pentágono, la altura
  • Para el triángulo, la base y la altura
  • Y para el trapecio, la base menor, la base mayor y la altura.

La solución usando un JSP

Haremos cuatro formularios en un solo .jsp y en ese mismo .jsp mostraremos el resultado. Este es el JSP para nuestra solución:
<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>


<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
  <meta equiv="Content-Type" content="text/html; charset=UTF-8">
  <title>JSP Page</title>
</head>
<body>
<h1>Calculando áreas</h1>
<form action="index.jsp?area=circulo" method="post">
  <fieldset>
      <legend>Área del círculo</legend>
      Radio: <input type="text" name="radio" value="${param.radio}">
      <input type="submit" value="Calcular">
      <%if ("circulo".equals(request.getParameter("area"))) {
      double radio=Double.parseDouble(request.getParameter("radio"));
      double area=Math.PI*Math.pow( radio,2.0);
      %><br/>
      El área es: <%=area%>
      <%}%>
  </fieldset>
</form>

<form action="index.jsp?area=pentagono" method="post">
  <fieldset>
      <legend>Área del pentágono</legend>
      Altura: <input type="text" name="altura" value="${param.altura}">
      <input type="submit" value="Calcular">
      <%if ("pentagono".equals(request.getParameter("area"))) {
      double altura=Double.parseDouble(request.getParameter("altura"));
      double area=((5.0*Math.pow(altura, 2))/4.0)*(1.0/Math.tan(Math.PI/5.0));
      %><br/>
      El área es: <%=area%>
      <%}%>
  </fieldset>
</form>
<form action="index.jsp?area=triangulo" method="post">
  <fieldset>
      <legend>Área del Triángulo</legend>
      Altura: <input type="text" name="altura" value="${param.altura}"><br/>
      Base: <input type="text" name="base" value="${param.base}"><br/>
      <input type="submit" value="Calcular">
      <%if ("triangulo".equals(request.getParameter("area"))) {
      double altura=Double.parseDouble(request.getParameter("altura"));
      double base=Double.parseDouble(request.getParameter("base"));
      double area=(base*altura)/2.0;
      %><br/>
      El área es: <%=area%>
      <%}%>
  </fieldset>
</form>

<form action="index.jsp?area=trapecio" method="post">
  <fieldset>
      <legend>Área del Trapecio</legend>
      Altura: <input type="text" name="altura" value="${param.altura}"><br/>
      Base 1: <input type="text" name="base1" value="${param.base1}"><br/>
      Base 2: <input type="text" name="base2" value="${param.base2}"><br/>
      <input type="submit" value="Calcular">
      <%if ("trapecio".equals(request.getParameter("area"))) {
      double altura=Double.parseDouble(request.getParameter("altura"));
      double base1=Double.parseDouble(request.getParameter("base1"));
      double base2=Double.parseDouble(request.getParameter("base2"));
      double area=(altura*(base1+base2))/2.0;
      %><br/>
      El área es: <%=area%>
      <%}%>
  </fieldset>
</form>


</body>
</html>
Toda la lógica de negocio está aquí. Ahorramos bastante código, ahorramos esfuerzo. Nada más hemos logrado.
Problemas:
  1. Si queremos otra página en nuestra aplicación que querramos usar alguna de esas fórmulas, tendremos que volver a pegar las fórmulas en esa nueva página.
  2. Si hay que hacer alguna modificación o corrección en una de las fórmulas, tendremos que revisar en todas las páginas que lo utilizan. De hecho, uno se nos podría escapar a nuestra revisión.
Bueno, podriamos hacer un servlet que siempre reciba los parámetros y guardar el resultado del área en una variable de sesión y mostrarlo en la página resultante.

La solución usando Servlet

Pues aquí está el servlet, la clase se llama web.AreaServlet y su URL es /AreaServlet:
      String tipoArea = request.getParameter("area");
    double area = 0.0;
    if ("circulo".equals(tipoArea)) {
        double radio = Double.parseDouble(request.getParameter("radio"));
        area = Math.PI * Math.pow(radio, 2.0);

    } else if ("pentagono".equals(tipoArea)) {
        double altura = Double.parseDouble(request.getParameter("altura"));
        area = ((5.0 * Math.pow(altura, 2)) / 4.0) * (1.0 / Math.tan(Math.PI / 5.0));
    } else if ("triangulo".equals(tipoArea)) {
        double altura = Double.parseDouble(request.getParameter("altura"));
        double base = Double.parseDouble(request.getParameter("base"));
        area = (base * altura) / 2.0;
    } else if ("trapecio".equals(tipoArea)) {
        double altura = Double.parseDouble(request.getParameter("altura"));
        double base1 = Double.parseDouble(request.getParameter("base1"));
        double base2 = Double.parseDouble(request.getParameter("base2"));
        area = (altura * (base1 + base2)) / 2.0;
    }
    request.setAttribute("area", area);
    request.setAttribute("formula", tipoArea);
    RequestDispatcher rd = request.getRequestDispatcher("respuesta.jsp");
    rd.forward(request, response);
El index.jsp ahora tiene menos código:
<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>


<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
    <meta equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>JSP Page</title>
</head>
<body>
<h1>Calculando áreas</h1>
<form action="AreaServlet?area=circulo" method="post">
    <fieldset>
        <legend>Área del círculo</legend>
        Radio: <input type="text" name="radio" value="${param.radio}">
        <input type="submit" value="Calcular">
  
    </fieldset>
</form>

 <form action="AreaServlet?area=pentagono" method="post">
    <fieldset>
        <legend>Área del pentágono</legend>
        Altura: <input type="text" name="altura" value="${param.altura}">
        <input type="submit" value="Calcular">
    
    </fieldset>
</form>
<form action="AreaServlet?area=triangulo" method="post">
    <fieldset>
        <legend>Área del Triángulo</legend>
        Altura: <input type="text" name="altura" value="${param.altura}"><br/>
        Base: <input type="text" name="base" value="${param.base}"><br/>
        <input type="submit" value="Calcular">
   
    </fieldset>
</form>

<form action="AreaServlet?area=trapecio" method="post">
    <fieldset>
        <legend>Área del Trapecio</legend>
        Altura: <input type="text" name="altura" value="${param.altura}"><br/>
        Base 1: <input type="text" name="base1" value="${param.base1}"><br/>
        Base 2: <input type="text" name="base2" value="${param.base2}"><br/>
        <input type="submit" value="Calcular">
   
    </fieldset>
</form>


</body>
</html> 
Funciona, ahora cualquier página que llamemos a ese Servlet utilizando los respectivos parámetros, nos mostrará el resultado. Es más, puede ser llamado desde cualquier aplicación web, así no sea del mismo servidor.
Problemas:
  1. Si queremos usar la misma lógica para calcular las áreas para una aplicación Desktop con Swing, no podremos, ya que un Swing no soporta servlets y nada web.
  2. El resultado siempre se mostrará en respuesta.jsp, si queremos utilizar el mismo resultado en otra página, dependeríamos del formato utilizado en respuesta.jsp.

Creando una biblioteca que contenga la lógica del cálculo

Trataremos de solucionar el primer problema cuestionado en el anterior párrafo.
Crearemos una nueva biblioteca Java desde NetBeans:
Y la llamaremos BibliotecaAreas
Dentro crearemos una clase llamada areas.CalculaAreas la cual tendrá el siguiente código:
package areas;

public class CalculaAreas {

  public static double circulo(double radio) {
      return Math.PI * Math.pow(radio, 2.0);
  }

  public static double pentagono(double altura) {
      return ((5.0 * Math.pow(altura, 2)) / 4.0) * (1.0 / Math.tan(Math.PI / 5.0));
  }

  public static double trapecio(double altura, double base1, double base2) {
      return (altura * (base1 + base2)) / 2.0;
  }

  public static double triangulo(double altura, double base) {
      return (base * altura) / 2.0;
  }
}
Agregamos este proyecto como biblioteca del proyecto Web:
Y el método de nuestro servlet cambiará un poco así:
 protected void processRequest(HttpServletRequest request, HttpServletResponse response)
          throws ServletException, IOException {
      String tipoArea = request.getParameter("area");
      double area = 0.0;
      if ("circulo".equals(tipoArea)) {
          double radio = Double.parseDouble(request.getParameter("radio"));
          area = CalculaAreas.circulo(radio);

      } else if ("pentagono".equals(tipoArea)) {
          double altura = Double.parseDouble(request.getParameter("altura"));
          area = CalculaAreas.pentagono(altura);
      } else if ("triangulo".equals(tipoArea)) {
          double altura = Double.parseDouble(request.getParameter("altura"));
          double base = Double.parseDouble(request.getParameter("base"));
          area = CalculaAreas.triangulo(altura, base);
      } else if ("trapecio".equals(tipoArea)) {
          double altura = Double.parseDouble(request.getParameter("altura"));
          double base1 = Double.parseDouble(request.getParameter("base1"));
          double base2 = Double.parseDouble(request.getParameter("base2"));
          area = CalculaAreas.trapecio(altura, base1, base2);
      }
      request.setAttribute("area", area);
      request.setAttribute("formula", tipoArea);
      RequestDispatcher rd = request.getRequestDispatcher("respuesta.jsp");
      rd.forward(request, response);

  }
¿Qué ganamos? Pues que ahora la lógica que calcula las áreas está en fuera de nuestra aplicación principal, y tenemos las siguientes ventajas:
  1. Podemos agregar esta biblioteca a otros proyectos, de la misma manera cómo la agregamos a la aplicación web.
  2. Si deseamos modificar la fórmula de alguna área, lo haremos en la biblioteca, y los demás proyectos que utilizan nuestra biblioteca no sufrirán cambios.
Problema:
Si hacemos cambios en esta biblioteca, habría que actualizar todas las aplicaciones con el nuevo .jar de nuestra biblioteca.

La solución usando EJB

Usando una analogía: podemos decir que es mucho más eficiente y económico tener una impresora en red para N equipos, que una impresora por cada computador. Es más fácil dar mantenimiento a un solo recurso, que a varios sabiendo que están todos sobre una red.
De la misma manera funcionan los EJB. Los EJB tienen la lógica de negocio para una determinada tarea. Es muy similar a la biblioteca que hemos creado, pero se aloja sobre un Contenedor de EJB, de tal manera que cualquier aplicación Java EE pueda utilizarlo. Si se hace alguna modificación en el EJB, no tendremos que actualizar las aplicaciones que lo utiliza, ya que estas siempre obtendrán el EJB que está en el Contenedor EJB.
Crearemos un nuevo proyecto (Mayúscula+Ctrl+N) que consistirá en un módulo EJB:
y llamaremos AreasEJBModule.
Luego creamos un nuevo archivo (Ctrl+N) que será un Session bean
Tendrá las siguientes propiedades:
  • Nombre: Calculadora
  • Paquete: ejb
  • Tipo de sesión: Stateless
  • Create Interface: remote
Nuestra interfaz CalculadoraRemote debe tener las siguientes declaraciones:
package ejb;

import javax.ejb.Remote;

@Remote
public interface CalculadoraRemote {

  double pentagono(double altura);

  double circulo(double radio);

  double trapecio(double altura, double base1, double base2);

  double triangulo(double altura, double base);
}
Y nuestra clase CalculadoraBean debe estar implementado de la siguiente manera:
package ejb;

import javax.ejb.Stateless;

@Stateless
public class CalculadoraBean implements CalculadoraRemote  {

 public  double circulo(double radio) {
      return Math.PI * Math.pow(radio, 2.0);
  }

  public  double pentagono(double altura) {
      return ((5.0 * Math.pow(altura, 2)) / 4.0) * (1.0 / Math.tan(Math.PI / 5.0));
  }

  public  double trapecio(double altura, double base1, double base2) {
      return (altura * (base1 + base2)) / 2.0;
  }

  public  double triangulo(double altura, double base) {
      return (base * altura) / 2.0;
  }
}
Sugerencia: También se pudo haber agregado el proyecto BibliotecaAreas a nuestro EJB para reutilizar los métodos.
Seleccionamos clic derecho sobre el nodo del proyecto EJB, y seleccionamos Undeploy and Deploy para desplegar el módulo en nuestro contenedor EJB (por ejemplo, Glassfish). deploy.jpg
Después de haber desplegado el EJB, vayamos a nuestro proyecto web, y quitamos la referencia al proyecto BibliotecaAreas de la sección Libraries de las propiedades del proyecto Web.
Ahora, abrimos el Servlet, hagamos clic derecho sobre el fondo del editor del código fuente y seleccionemos Enterprise Resources > Call Enterprise Bean. En la ventana que aparece, seleccionamos CalculadoraBean call-bean.jpg
Vemos que se agregado una nueva propiedad con una anotación en nuestro servlet:
 @EJB
  private CalculadoraRemote calculadoraBean;
Con esta anotación, la aplicación obtendrá las referencia a nuestra lógica de cálculos. Así, nuestro servlet tendrá este nuevo código:
package web;


import ejb.CalculadoraRemote;
import java.io.IOException;
import javax.ejb.EJB;
import javax.servlet.RequestDispatcher;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class AreaServlet extends HttpServlet {

  @EJB
  private CalculadoraRemote calculadoraBean;

  /**
   * Processes requests for both HTTP GET and POST methods.
   * @param request servlet request
   * @param response servlet response
   */
  protected void processRequest(HttpServletRequest request, HttpServletResponse response)
          throws ServletException, IOException {
      String tipoArea = request.getParameter("area");
      double area = 0.0;
      if ("circulo".equals(tipoArea)) {
          double radio = Double.parseDouble(request.getParameter("radio"));
          area = calculadoraBean.circulo(radio);

      } else if ("pentagono".equals(tipoArea)) {
          double altura = Double.parseDouble(request.getParameter("altura"));
          area = calculadoraBean.pentagono(altura);
      } else if ("triangulo".equals(tipoArea)) {
          double altura = Double.parseDouble(request.getParameter("altura"));
          double base = Double.parseDouble(request.getParameter("base"));
          area = calculadoraBean.triangulo(altura, base);
      } else if ("trapecio".equals(tipoArea)) {
          double altura = Double.parseDouble(request.getParameter("altura"));
          double base1 = Double.parseDouble(request.getParameter("base1"));
          double base2 = Double.parseDouble(request.getParameter("base2"));
          area = calculadoraBean.trapecio(altura, base1, base2);
      }
      request.setAttribute("area", area);
      request.setAttribute("formula", tipoArea);
      RequestDispatcher rd = request.getRequestDispatcher("respuesta.jsp");
      rd.forward(request, response);

  }
//.... sigue
Ejecutamos la aplicación y Voila!

Un paso más adelante... con Web Services

Pero, si queremos usar la lógica de negocio en una aplicación que no sea web, y más aún, que no sea Java. Aquí entran los Web Services
No entraremos en detalle sobre la historia de esta tecnología.
Hacemos clic derecho sobre el nodo del proyecto AreasEJBModule y seleccionamos New > Other. Seleccionamos Web Services | Web Service
Y tendrá las siguientes propiedades:
  • Web Service Name: Calculadora
  • Package: ws
  • Create Web Service from Session Bean: Enterprise Beans#CalculadoraBean (hacemos clic en el botón Browse para seleccionar CalculadoraBean)
Hacemos nuevamente clic derecho sobre el ícono del proyecto AreasEJBModule y seleccionamos Undeploy and deploy para desplegar el módulo en Glassfish.
Para probar si funciona bien nuestro Web Service, hacemos clic derecho sobre el ícono de nuestro Servicio Web y seleccionamos Test Web Service: test-ws.jpg
Se abrirá nuestro navegador web mostrando una página donde se muestran todos nuestros métodos de nuestro Servicio Web, con entradas de texto que podemos escribir para enviar parámetros:
Podemos escribir algunos valores para probar si funcionan correctamente nuestros métodos.
En la misma página de prueba hay un enlace (http://localhost:8080/CalculadoraService/Calculadora?WSDL) al WSDL (Lenguaje descriptor del Servicio web) de nuestro servicio web. Este WSDL es el que se utilizará en otras aplicaciones (como .Net, Delphi, etc) que desean consumir nuestro servicio web.

Los proyectos

A continuación se listan los proyectos utilizados en este artículo:

jueves, 14 de agosto de 2008

NetBeans 6.5 Beta

La versión Beta de NetBeans IDE 6.5 ya está disponible.
Dentro de sus principales características, están las siguientes:
  • PHP



    • Autocompletado de código
    • Corrección rápida y verificación de semántica
    • Generador de código
    • Compatibilidad con FRP
    • Depuración con Xdebug
    • Compatibilidad con Servicios Web populares
  • Ajax/JavaScript
    • Depuración en Firefox e IE
    • Monitoreo HTTP del cliente
    • Contiene bibliotecas populares de JavaScript
  • Java
    • Compatibilidad con Groovy / Grails
    • Compilación en la grabación
    • Sincronizador e importador de proyectos de Eclipse
    • Creación de proyectos utilizando Hibernate
    • Generador CRUD (Create/Read/Update/Delete) de JSF ahora con Ajax
  • Base de datos
    • Nueva ventana de diálogo para conección a la base de datos
    • Editor de SQL mejorado
  • C/C++
    • Completación de código mejorado y resaltado de errores
    • Desarrollo remoto
    • Compatibilidad para empaquetado
  • Ruby
    • Nuevo paquete de Ruby/Glassfish ve
    • Compatibilidad para pruebas Ruby
    • Rails actualizado a 2.1.0

Ver más sobre la nueva versión, aquí: http://www.netbeans.org/community/releases/65/

viernes, 8 de agosto de 2008

SDK Preliminar de JavaFX

Sun ha lanzado la versión preliminar del SDK de JavaFX.

Nandini Ramani, directora ingeniera, presenta este vídeo, además de cómo se puede usar desde NetBeans 6.1

http://www.netbeans.tv/screencasts/Nandini-Ramani-Introduces-the-JavaFX-Preview-SDK-372/

Reportes en NetBeans 6.1 con iReport/JasperReports y Visual Web JavaServer Faces

[Este tutorial también se encuentra en los tutoriales en Español de NetBeans. Ya que es un Wiki, se puede tener el tutorial actualizado]

Introducción

Microsoft tiene su Visual Studio, Java tiene a NetBeans.


Microsoft tiene su Crystal Reports, Java tiene JasperReports.

Java no tiene nada qué envidiar a Visual Studio. Ni menos en los reportes.

JasperReports es un framework bastante completo para desarrollar reportes tanto web como desktop en Java.

Aunque el formato fuente de un reporte en JasperReports es un archivo XML, existe una herramienta que permite crear un reporte de manera visual. Su nombre: iReport.

Pero como estamos usando como IDE a NetBeans, podemos elaborar nuestro reporte sin salir del IDE. Para ello, existe un plugin (archivo .nbm) para NetBeans que muestra el iReport dentro del mismo IDE.

http://downloads.sourceforge.net/ireport/iReport-nb-0.9.2.nbm



Instalando el plugin

Después de descargar el archivo .nbm, abrimos el IDE NetBeans. Entramos al menú Tools > Plugins, y en la ficha Downloaded, hacemos clic en el botón Add plugins...

Seleccionamos el archivo .nbm que previamente hemos descargado. Después de esto se mostrará la ventana lista para instalarse el plugin:

Image:Pantallazo-Plugins_ReportesEnNetBeansConIReport.png

Y hacemos clic en el botón Install. Se nos mostrará la siguiente ventana:

File:Pantallazo-NetBeans IDE Installer.png


Clic en Next. Aceptamos los términos de la licencia, y hacemos clic en Install. Nos mostrará la ventana de advertencia ya que el plugin es posible que no sea confiable:

File:Pantallazo-Verify Certificate.png

Pero como sabemos de dónde lo hemos descargado, hacemos clic en Continue.

Al finalizar la instalación del plugin, veremos que hay una opción nueva en la barra de herramientas,

Image:ireportnb1_ReportesEnNetBeansConIReport.jpg

y se muestra un panel nuevo de salida llamado "iReport output"

Image:ireportnb2_ReportesEnNetBeansConIReport.jpg


Verificando la biblioteca instalada.


Entremos a Tools > Libraries y seleccionemos la biblioteca JasperReports 2.0.5-snapshot. Revisemos el panel del classpath y veremos que hay una referencia marcada de rojo.



Pues bien, significa que según la ubicación donde se instaló el módulo no encuentra la ubicación del .jar que necesitamos para nuestra aplicación. Por tanto, lo configuraremos manualmente.

Hacemos clic en el botón Add Jar/Folder.. y buscamos la carpeta donde está instalada el NetBeans. Veremos que dentro hay una carpeta llamada ireport



Entramos a esa carpeta, luego a modules > ext.

Buscamos el archivo jasperreports-3.0.1.jar,lo seleccionamos



y hacemos clic en Add JAR/Folder.

Como podemos deducir, el problema que no encontraba el archivo jasperreports-2.0.5.jar era porque no existía.





Creando un proyecto

Lo que haremos en esta aplicación es mostrar en una lista todas las personas registradas en la base de datos TRAVEL. El usuario seleccionará uno de ellos, y hará clic en un botón llamado Mostrar Viajes para mostrar en un reporte todos los viajes relacionados a esta persona. Además, habrá un botón de opción (Radio Button) que permitirá escoger el formato del reporte: en PDF o en HTML.

Crearemos un proyecto web llamado TravelReport el cual utilizará el framework Visual Web JavaServer Faces.


Además, agregamos la biblioteca 'JasperReports 2.0.5-snapshot'

File:Pantallazo-Project Properties - TravelReport.png


La página con la lista de personas

De la paleta de componentes seleccionamos un Label y lo soltamos en el Page1.jsp. El texto que tendrá el componente label será "Seleccione una persona:".

Además, de la paleta de componentes arrastramos un Listbox y lo soltamos debajo del label que acabamos de pegar. En el panel de propiedades escribimos como id de este componente el valor personasLB.


También pegaremos un Radio button group al costado de la lista. Pondremos formatoCG como valor de la propiedad id.




Luego le damos clic derecho sobre el Radio button group que acabamos de pegar y seleccionamos la opción Configure Default Options... Editamos las opciones para que tengan como en la siguiente imagen:


File:Pantallazo-Options Customizer - formatoCG.png

Le damos nuevamente clic derecho y seleccionamos Add Binding attribute. Hacemos lo mismo con el componente personasLB.

Para finalizar con el diseño de esta página, pegaremos un componente button y tendrá como texto "Mostrar Reporte".

El diseño de la página debe quedar así:

File:Pantallazo-TravelReport - Page1.png


Accediendo a la base de datos


Entramos al panel de Services del panel izquierdo, o presionando Ctrl+5. Abrimos el nodo Databases, hacemos clic derecho sobre la conexión a la base de datos travel y seleccionamos Connect...

Seleccionamos el nodo Tables >> PERSON, lo arrastramos y lo soltamos sobre el componente personasLB. Sabremos que se realizó ya que las opciones que se mostrarán en el diseño serán "abc" tres veces.


Hacemos clic derecho sobre personasLB y seleccionamos Bind to data... Debe lucir así:

File:Pantallazo-Bind to Data - personasLB.png


Diseñando el reporte

Lo que necesitamos antes de programar cómo debe mostrarse el reporte, es, justamente, diseñar el reporte.

Presionamos Ctrl+N para mostrar el asistente para crear un nuevo archivo. Seleccionamos la categoría Report y el tipo de archivo Report.


File:Pantallazo-New File.png

Clic en el botón Next.

Escribimos viajes.jrxml como nombre del archivo, y en el campo Folder seleccionamos a través del botón Browse la carpeta src/java/travelreport


File:Pantallazo-New Report.png

Clic en el botón Next.

En la ventana donde se selecciona el Datasource, hacemos clic en el botón New.., y en la ventana de diálogo que se muestra, seleccionamos NetBeans Database JDBC Connection

Image:Pantallazo-nbjdbconn_ReportesEnNetBeansConIReport.png

Clic en el botón Next.

Escribimos 'travelDB como nombre, y de la lista desplegable seleccionamos la conexión para la base de datos travel.


Image:Pantallazo-nbjdbconn1_ReportesEnNetBeansConIReport.png

Podemos hacer clic en el botón Test para comprobar que esté correcta la conexión.

Clic en el botón Save.

Clic en el botón Design query para diseñar la consulta del reporte.

En este diseñador de consultas, desplegamos la lista que se encuentra en la parte media izquierda y seleccionamos la base de datos TRAVEL. Con esto se mostrarán las tablas de la base de datos.

File:Pantallazo- query1.png


Hacemos doble clic en la tabla TRIP. Un ícono que representa a la tabla TRIP se mostrará en el panel derecho de la ventana. Hacemos doble clic también en la tabla TRIPTYPE. Veremos que se mostró la asociación existente entre ambas tablas.

Activamos las casillas de verificación de los campos DEPDATE, DEPCITY y DESTCITY de la TRIP, y DESCRIPTION de la tabla TRIPTYPE.




Clic en el botón Ok

El diseño de la consulta va a quedar así:

File:Pantallazo- query3.png

Clic en el botón Ok

Ahora vemos el comando SQL generada por el diseñador.

File:Pantallazo-New File-2.png

Clic en el botón Next.

En la selección de campos, hacemos clic en el botón ">>" para agregar todos los campos en el reporte.


File:Pantallazo-New File-3.png

Clic en el botón Next.

En la selección de grupos, hacemos clic en el botón Next, ya que no haremos alguna agrupación en el reporte.

En la selección de diseño ("Layout") del reporte, seleccionamos Tabular Layout.

File:Pantallazo-New File-4.png

Clic en el botón Next. Finalmente, clic en el botón Finish.


El IDE nos mostrará el diseño del reporte que acabamos de crear utilizando el asistente. Podemos editarlo para que luzca como en la siguiente imagen:

File:Pantallazo-NetBeans IDE 6.1-reporte1.png


Modificando el reporte para que permita parámetros.

Entramos a la opción Window > Navigating > Report Inspector. Se abrirá un panel llamado Report Inspector en la parte lateral izquierda inferior.


Hacemos clic derecho sobre el nodo Parameters y Add parameter. Con esto se agregará un nuevo nodo llamado parameter1.

Lo seleccionamos y modificamos las propiedades colocando lo siguiente:

  • name: personId
  • Default value expresion: "1"
  • use as a prompt: (sin seleccionar)

File:Pantallazo-NetBeans IDE 6.1-parameterPersonId.png

Hacemos clic derecho en una zona en blanco del diseñador de reportes, y seleccionamos Edit query. Se nos presentará el diseñador de consultas para el reporte actual.

File:Pantallazo-Report query.png

Tenemos dos caminos para agregar el parámetro personId en la consulta

  1. Agregando el valor WHERE TRIP.PERSONID = $P{personId} desde la misma ventana de edición del comando SQL.

  2. Utilizando el diseñador de reporte, haciendo clic en el botón Query designer. Para ello, desde el diseñador de consulta, damos clic derecho sobre el nodo WHERE y seleccionamos add condition
Image:Pantallazo-condition_ReportesEnNetBeansConIReport.edit-1.png

De cualquier manera, el query debe ser similar a este:

SELECT
     TRIP."DEPDATE" AS TRIP_DEPDATE,
     TRIP."DEPCITY" AS TRIP_DEPCITY,
     TRIP."DESTCITY" AS TRIP_DESTCITY,
     TRIPTYPE."DESCRIPTION" AS TRIPTYPE_DESCRIPTION
FROM
     "TRAVEL"."TRIPTYPE" TRIPTYPE INNER JOIN "TRAVEL"."TRIP" TRIP ON TRIPTYPE."TRIPTYPEID" = TRIP."TRIPTYPEID"

WHERE
     TRIP.PERSONID = $P{personId}
Hacemos clic en el botón Ok para cerrar la ventana Report query

Podemos hacer clic en el botón Preview de la barra de herramientas del diseño del reporte para ver una muestra de cómo se visualizaría el reporte.


Adicionando ImageServlet a la aplicación

Los reportes HTML de JasperReports utilizan algunos recursos propios como ciertas imágenes que ayudan a mostrarse un reporte correctamente. Para ello, debemos agregar un Servlet de JasperReports para que interprete las peticiones de imágenes usando sus propios recursos.


Abrimos el archivo web.xml, seleccionamos la sección Servlets, y hacemos clic en el botón Add Servlet Element que se encuentra en la parte superior derecha. En la ventana de diálogo que se muestra, escribimos los siguientes valores:

Image:AddImageServlet_ReportesEnNetBeansConIReport.jpg

Clic en el botón OK


Programando el lanzamiento del reporte.

Hasta ahora hemos hecho todo el diseño visual. Ahora haremos la parte de la programación del botón Mostrar reporte.


Regresamos a la ventana Page1.jsp y estando en el modo "Design" vamos a la ventana Navigator. Examinamos los nodos y le damos doble clic en el nodo ApplicationBean1. El código fuente de ApplicationBean1.java se abrirá en el editor.

sugerencia: podemos escribir las siguientes líneas de código presionando Ctrl+Espacio cuando se desea escribir una clase o un método de tal manera que el IDE nos pueda sugerir cuáles son las clases que se utilizará y agregará los imports necesarios. También se puede copiar estas líneas de código y pegarlas en el editor del IDE, y luego presionar Ctrl+Mayúscula+I para importar las clases que se utilizan en la clase

.



Agregemos el siguiente método:

public void jasperReport(String tipo, String dataSourceName, Map<String, String> params) throws ClassNotFoundException {
        ExternalContext econtext = getExternalContext();
        InputStream inputStream = ApplicationBean1.class.getResourceAsStream("/travelreport/viajes.jasper");
        if (inputStream == null) {
            throw new ClassNotFoundException("Archivo viajes.jasper no se encontró");
        }
        FacesContext fcontext = FacesContext.getCurrentInstance();
        try {
            JRExporter exporter = null;
            Context  ctx=new InitialContext();
            DataSource ds=(DataSource) ctx.lookup(dataSourceName);
            Connection conn=ds.getConnection();
            
            JasperPrint jasperPrint = JasperFillManager.fillReport(inputStream, params, conn);
            HttpServletResponse response = (HttpServletResponse) econtext.getResponse();

            HttpServletRequest request = (HttpServletRequest) econtext.getRequest();

            response.setContentType(tipo);
            if ("application/pdf".equals(tipo)) {
                exporter = new JRPdfExporter();
                exporter.setParameter(JRExporterParameter.JASPER_PRINT, jasperPrint);
                exporter.setParameter(JRExporterParameter.OUTPUT_STREAM, response.getOutputStream());
            } else if ("text/html".equals(tipo)) {
                exporter = new JRHtmlExporter();
                exporter.setParameter(JRExporterParameter.JASPER_PRINT, jasperPrint);
                exporter.setParameter(JRExporterParameter.OUTPUT_WRITER, response.getWriter());
                exporter.setParameter(JRHtmlExporterParameter.IMAGES_URI, request.getContextPath() + "/image?image=");
            }
            if (exporter != null) {
                exporter.exportReport();
            }
        } catch (Exception ex) {
            Logger.getLogger(ApplicationBean1.class.getName()).log(Level.SEVERE, null, ex);
            throw new FacesException(ex);
        }
        fcontext.responseComplete();


    }

Ahora, desde la ventana Page1.jsp hacemos doble clic en el botón Mostrar reporte. Con esto se mostrará el método button1_action(). Editemos el método para que luzca así:

public String button1_action() {
        try {
            Map<String, String> params = new HashMap<String, String>();
            params.put("personId", getPersonasLB().getSelected().toString());
            String dataSourceName = getSessionBean1().getPersonRowSet().getDataSourceName();

            String tipo = (String) formatoCG.getSelected();
            getApplicationBean1().jasperReport(tipo, dataSourceName, params);

        } catch (Exception ex) {
            Logger.getLogger(Page1.class.getName()).log(Level.SEVERE, null, ex);
            error(ex.toString());
        }
        return null;
    }



Ejecutando la aplicación

Ejecutamos el proyecto con la tecla F6.

Image:Pantallazo-ProjectRunning_ReportesEnNetBeansConIReport.png

Seleccionemos una persona de la lista, seleccionamos una opción del tipo de reporte (html o pdf) y hacemos clic en el botón "Mostrar reporte".

Reporte en HTML:

Image:reporte-html1_ReportesEnNetBeansConIReport.jpg

Reporte en PDF:

Image:reporte-pdf1_ReportesEnNetBeansConIReport.jpg


Recursos

El código fuente del proyecto utilizado en este tutorial se encuentra aquí http://diesil-java.googlecode.com/files/TravelReport.tar.gz






Ver también

domingo, 3 de agosto de 2008

Blogs de programación!!!

Después de muchas lunas por fin he podido lanzar el sitio:

http://blogsdeprogramacion.com/

La idea de este sitio es la de recopilar todos los blogs de programación que existen en la red.

No importa de qué lenguaje de programación se trate. Lo importante es tener un lugar donde los usuarios puedan consultar todo lo referente a programación.

Si tienes un de programación que te gustaría compartir, regístralo aquí:

http://blogsdeprogramacion.com/

Se recomienda que cada post que se publique tenga al menos un tag o una categoría, a fin de catalogarlo en la nube de tags.

PD.: Mis disculpas a los editores de blogs que registré en este sitio. Quería lanzarlo con un contenido.

sábado, 2 de agosto de 2008

Navegación de Páginas usando Visual JSF (NetBeans 6.1 / 6.5)

Acabo de publicar un tutorial en el Wiki de NetBeans sobre cómo programar la navegación de las páginas en JSF utilizando Visual JSF.

Navegación de Páginas usando Visual JSF (NetBeans 6.1 / 6.5)

Espero que sea de su agrado.