Añadir al entorno visual Java Eclipse la clase "Visual Editor"

Explicaré una forma sencilla rápida y automática de instalar la clase visual (visual class) en Eclipse 3.4

Una vez instalado Eclipse, accederemos a él, pulsaremos en el menú "Ayuda" – “Software Update…”:

Nos posesionamos en la pestaña Available Software y pulsamos el botón Add Site…

En este paso podremos indicar los sitios de actualizaciones para buscar nuevas características, también podremos añadir nuevos sitios remotos. En este caso agregaremos la clase Visual Editor marcaremos Callisto Discovery Site y The Eclipse Project Updates, pulsaremos

Al pulsar el boton Add Site nos aparecerá como se muestra en la siguiente ventana donde introduciremos la url del sitio a agregar en este caso seria http://download.eclipse.org/callisto/releases/ que es el correspondiente a Callisto Discovery Site y pulsamos aceptar. (En esta foto me aparece el botón Aceptar desactivado porque el sitio ya lo tengo agregado)

Al dar al botón aceptar regresaremos a la ventana anterior donde se encuentran todos los sitios que tenemos agregados Como dijimos anterior mente los que nos interesan en este caso son los de Callisto Discovery Site y The Eclipse Project Updates.

Para instalar Visual Editor de Eclipse marcaremos las opciones:

• Graphical Editors and frameworks o Visual Editor 1.2.1 o Graphical Editing Framework 3.2.2

• Models and Model Development o Eclipse Modeling Framework (EMF) Runtime + End-User Tools 2.2.2

Pulsaremos Install para continuar :

Puesto que algunas de las descargas que hemos seleccionado tienen licencia de característica, deberemos aceptarla para continuar con la instalación, para ello marcaremos "Acepto los términos de los acuerdos de licencia". Pulsaremos "Siguiente" para continuar con la instalación de Visual Editor de Eclipse:

Puesto que algunas de las características de las opciones marcadas para la instalación (Visual Editor) no están firmadas nos mostrará este aviso. Pulsaremos "Instalar todo" para continuar:

Antes de iniciar la descarga de las actualizaciones, el asistente de Eclipse nos pedirá la ubicación donde queramos instalar cada uno de los paquetes seleccionados, por defecto los instalará en C:/eclipse. Pulsaremos "Finalizar" para continuar:

El asistente de actualización de Eclipse inicará la descarga de las actualizaciones seleccionadas:

Una vez finalizada la descarga e instalada, el asistente de instalación y actualización de Eclipse nos mostrará una aviso indicando que es recomendable reiniciar el entorno de trabajo Eclipse para que se apliquen los cambios. Pulsaremos "Sí" para reiniciar Eclipse:

Con el texto: Es recomendable reiniciar el entorno de trabajo para que los cambios surtan efecto, pero es posible aplicar los cambios en la configuración actual sin reiniciar. ¿Desea reiniciar ahora?

APLICACIÓN VISUAL DE EJEMPLO CON VISUAL EDITOR Y EC LIPSE

Una vez instalada la clase Visual Editor de Eclipse, realizaremos una aplicación de ejemplo para explicar cómo usarla. Desde Eclipse, pulsaremos en el menú "Archivo" - "Nuevo" - "Proyecto...":

Seleccionaremos el tipo de proyecto nuevo (en nuestro caso Proyecto Java), pulsaremos "Siguiente" para continuar:

Indicaremos el nombre del proyecto (en nuestro caso pruebaAplicacionVisual), también podremos indicar la versión de JRE (Java Runtime Environmet), en nuestro caso jre1.6.0_01, indicaremos la ruta de la aplicación y pulsaremos "Finalizar":

Seleccionaremos el nuevo proyecto creado y pulsaremos con el botón derecho del ratón sobre él, pulsaremos en "Nuevo" - "Visual class":

En caso de no aparecer "Visual Class" pulsaremos sobre "Otros..." y seleccionaremos "Java" - "Visual Class":

Introduciremos el nombre del Paquete, el nombre del Tipo, seleccionaremos la superclase javax.swing.JFrame y pulsaremos "Finalizar":

Eclipse creará automáticamente un JFrame que será el contenedor principal de nuestra aplicación. También mostrará la Paleta de componentes visuales (Palette) con:

• Componentes (Swing Components) como: JButton, JCheckBox, JRadioButton, JLabel, JTextField, JPasswordField, JTextArea, JSlider, JScrollBar, JList, JComboBox, JTree, JTable, JProgressBar, JOptionPane, JTextPane, JEditorPane.

• Contenedores (Swing Container) como: JFrame, JPanel, JScrollPane, JSplitPane, JTabbedPane, JDesktopPane, JInternalFrame, JDialog, JWindow, JToolBar, JApplet.

• Menús (Swing Menus) como: JMenuBar, JToolBar, JMenu, JPopupMenu, JMenuItem, JCheckBoxMenuItem, JRadioButtonMenuItem.

Mostrará la ventana de Propiedades, donde se mostrarán las características configurables propias de cada control seleccionado. En la parte inferior mostrará la ventana de código de la aplicación:

Como ejemplo insertaremos un componente de tipo JButton y otro de tipo JTextField, para mostrar en un mensaje el contenido del JTextField. Para añadiremos un contenedor llamado JPanel que será el contenedor de nuestro JButton y JTextField. Seleccionaremos la solapa Swing Containers de la ventana de Palette y pulsaremos sobre JPanel, a continación nos posicionaremos con el cursor del ratón sobre el área "Center" del JFrame y haremos clic:

Nos mostrará una ventana donde podremos indicar el nombre del componente JPanel que hemos insertado, en nuestro caso jPanel, pulsaremos "Aceptar" para continuar :

Antes de insertar el JButton y el JTextField, si queremos tener libertad absoluta a la hora de posicionar un control en el contenedor JPanel deberemos cambiar la propiedad layout a null. Esto se hace pulsando sobre el JPanel insertado anteriormente y seleccionando esta propiedad en la ventana de Propiedades, tal y como se muestra en la imagen:

Ahora añadiremos el componente JTextField de la ventana Palette, solapa Swing Components y lo soltaremos en la parte del JPanel que deseemos:

Indicaremos el nombre, en nuestro caso txtMensaje y pulsaremos "Aceptar":

Ajustaremos el tamaño y la posición y le añadiremos un JLabel informativo en la parte izquierda, en la propiedad text del JLabel pondremos "Mensaje":

Añadiremos también el JButton de la misma forma, con el nombre bMostrarMensaje y la propiedad text a Mostrar:

A continuación añadiremos el siguiente código fuente Java al JButton añadido, para ello pulsaremos con el botón derecho del ratón sobre el JButton bMostrarMensaje, seleccionaremos "Events" - "actionPerformed":

El entorno Eclipse nos creará el evento actionPerformed de la clase java.awt.event.ActionEvent, que se ejecutará cuando se haga clic sobre el JButton. En este procedimiento crea, por defecto, la siguiente línea de código:

System.out.println("actionPerformed()"); // TODO Auto-generated Event stub actionPerformed()

que no hace otra cosa que mostrar un mensaje en la consola de depuración con el texto actionPerformed() y también ha añadido un comentario de tipo TODO que nos indica que el evento ha sido autogenerado:

Si compilamos la aplicación en este momento, seleccionando el triángulo invertido que aparece a la derecha de , "Ejecutar como" - "Java Bean":

y probamos a pulsar el botón "Mostrar" obtendremos este resultado:

"actionPerformed()" en la Consola.

En nuestro caso eliminaremos la línea de código creada por Eclipse para el evento actionPerformed del JButton y añadiremos lo siguiente:

System.out.println(txtMensaje.getText());

con el método "getText" obtendremos el valor de la propiedad "text" del componente JTextField.

Quedará algo así:

public void actionPerformed(java.awt.event.ActionEvent e) { System.out.println(txtMensaje.getText()); }

Si compilamos la aplicación, cuando pulsemos el botón "Mostrar" visualizará en la Consola el texto introducido en el JTextField:

"Prueba aplicación Eclipse" en la Consola.

El código fuente Java completo de la aplicación (casi todo generado automáticamente por Eclipse):

package pruebaAplicacionVisual; import java.awt.BorderLayout; import javax.swing.JPanel; import javax.swing.JFrame; import javax.swing.JButton; import java.awt.Rectangle; import javax.swing.JTextField; import javax.swing.JLabel; import java.awt.Dimension; public class PruebaAplicacionVisual extends JFrame { private static final long serialVersionUID = 1L; private JPanel jContentPane = null; private JPanel jPanel = null; private JTextField txtMensaje = null; private JLabel jLabel = null; private JButton bMostrarMensaje = null; /** * This is the default constructor */ public PruebaAplicacionVisual() { super(); initialize(); }

/** * This method initializes this * * @return void */ private void initialize() { this.setSize(new Dimension(304, 121)); this.setContentPane(getJContentPane()); this.setSize(300, 200); this.setContentPane(getJContentPane()); this.setTitle("JFrame"); } /** * This method initializes jContentPane * * @return javax.swing.JPanel */ private JPanel getJContentPane() { if (jContentPane == null) { jContentPane = new JPanel(); jContentPane.setLayout(new BorderLayout()); jContentPane.add(getJPanel(), BorderLayout.CENTER); } return jContentPane; } /** * This method initializes jPanel * * @return javax.swing.JPanel */ private JPanel getJPanel() { if (jPanel == null) { jLabel = new JLabel(); jLabel.setBounds(new Rectangle(7, 18, 59, 16)); jLabel.setText("Mensaje"); jPanel = new JPanel(); jPanel.setLayout(null); jPanel.add(getTxtMensaje(), null); jPanel.add(jLabel, null); jPanel.add(getBMostrarMensaje(), null); } return jPanel; } /** * This method initializes txtMensaje * * @return javax.swing.JTextField */ private JTextField getTxtMensaje() { if (txtMensaje == null) { txtMensaje = new JTextField(); txtMensaje.setBounds(new Rectangle(68, 15, 133, 20)); } return txtMensaje; } /**

* This method initializes bMostrarMensaje * * @return javax.swing.JButton */ private JButton getBMostrarMensaje() { if (bMostrarMensaje == null) { bMostrarMensaje = new JButton(); bMostrarMensaje.setBounds(new Rectangle(203, 15, 81, 21)); bMostrarMensaje.setText("Mostrar"); bMostrarMensaje.addActionListener( new java.awt.event.ActionListener() { public void actionPerformed( java.awt.event.ActionEvent e) { System.out.println(txtMensaje.getText()); } }); } return bMostrarMensaje; } } // @jve:decl-index=0:visual-constraint="10,10"

Los ficheros generados por Eclipse para nuestra aplicación visual de ejemplo con Visual Editor son:

• F:/Programas/Java/pruebaAplicacionVisual (carpeta) o pruebaAplicacionVisual (carpeta)

� PruebaAplicacionVisual$1.class � PruebaAplicacionVisual.class � PruebaAplicacionVisual.java

o .classpath o .project

Para realizar este manual / artículo hemos utilizado:

• SDK Eclipse 3.2.0. • Microsoft Windows XP Profesional. • Visual Editor 1.2.1. • Graphical Editing Framework 3.2.2. • Eclipse Modeling Framework (EMF) Runtime + End-User Tools 2.2.2.