Escribí tu currículum vitae en XML

La problemática

A lo mejor a alguno de ustedes le pasa como a mi, que odio escribir un CV en Word/Writer o cualquier otro procesador de textos que ande por ahí.

Así que la primera vez que tuve que escribir un CV, lo hice en HTML puro y estático. Esto mezclaba contenido con presentación, pero era bien simple y quedaba tal cual yo quería. El problema con los procesadores de texto es que uno nunca termina de saber exactamente qué es lo que pone internamente para darle el formato y a veces es difícil lograr el formato deseado.

XML al rescate

Cuando trabajaba en Zauber me mostraron el xmlresume, que permitía escribir el CV en un archivo xml y luego procesarlo para presentarlo en formato HTML o PDF según se requiriera.

Como xmlresume parece no tener más soporte desde hace tiempo, decidí cambiarme a otro y es así como actualmente utilizo hr-xsl.

Cual de los dos utilizar es realmente una cuestión de gustos, porque hr-xsl tampoco parece estar muy activo hoy en día, pero bueno, ya me amoldé a este último y les quiero compartir la forma en que yo lo utilizo.

Cómo uso hr-xsl

Tengo todo el programa para generar el CV en un repositorio de Subversion propio con la siguiente jerarquía de carpetas (y algunos comentarios):

.
|-- bin                         // aca está el soft de hr-xsl
|   |-- HRXML
|   |   `-- HRXML200704
|   |       `-- HR-XML-2_5
|   `-- hr-xsl
|       `-- hr-xsl-0.11
|-- releases
|   |-- 1.0.0-pre-xml           // esto era en HTML
|   |   |-- 2005-03-31
|   |   |-- 2005-12-21
|   |   |-- 2007-03-20
|   |   `-- 2007-04-03
|   |-- 2.0.0-xmlresume-zauber  // esto era xmlresume
|   |   `-- 2007-05-07
|   `-- 3.0.0-hr-xsl            // este es el actual, hr-xsl
|       |-- 2007-09-04
|       |-- 2008-01-14
|       `-- 2008-04-16
`-- trunk
    |-- .project                // proyecto de eclipse (lo edito con eclipse)
    |-- generator-en            // scripts de ant para construir el CV en ingles
    |   |-- build.xml
    |   `-- parameters.xsl
    |-- generator-es            // scripts de ant para construir el CV en español
    |   |-- build.xml
    |   `-- parameters.xsl
    `-- src
        |-- currVitae.htm    // html con frames que encuadra la presentacion
        |-- epereda-en.html  // autogenerado html en inglés
        |-- epereda-en.pdf   // autogenerado pdf en inglés
        |-- epereda-en.txt   // autogenerado texto en inglés
        |-- epereda-en.xml   // codigo fuente del cv en inglés
        |-- epereda-es.html  // autogenerado html en español
        |-- epereda-es.pdf   // autogenerado pdf en español
        |-- epereda-es.txt   // autogenerado texto en español
        |-- epereda-es.xml   // codigo fuente del cv en español
        |-- style.css        // hoja de estilos para el html
        `-- top.html         // frame superior con links a las diferentes versiones

La idea es que edito lo que está en la carpeta trunk/src usando Eclipse (obviamente se puede editar con lo que quieran, pero yo estoy acostumbrado a usar Eclipse). Luego corro los scripts de ant localizados en trunk/generator-en y trunk/generator-es y cuando estoy contento con el resultado de los archivos generados hago una copia a la carpeta de releases/3.0.0-hr-xs con la fecha actual.

Requerimentos de hr-xsl

Los requerimentos de hr-xsl están detallados en la documentación del sitio oficial, pero se resumen en lo siguiente:

• Java 5.0 o superior


• Ant 1.6 o superior


• Lynx: sólo si se quiere generar archivo .txt

Decargar fuentes

Pueden descargar mi código fuente desde acá. Es posible que sea lento porque la conexión de internet de ese server no es muy buena.

La idea de brindarles el código fuente es que a lo mejor les es útil basarse en él para hacer su propio CV.

Resultado final

El producto terminado puede verse acá: epere4.com.ar/cv

Eclipse Quick Access (aka Ctrl + 3)

Ya que les estuve comentando algo de Eclipse Europa en el post anterior, les paso otro tip. Este me lo pasó mi amigo Claudio.

Se trata de la madre de todos los atajos. Si te gusta usar atajos de teclado, entonces probá Ctrl + 3 en Eclipse Europa.

Con eso se abre la ventana del Quick Access. Permite acceder a cualquier Vista, Perspectiva, Comando, Editor, etc con sólo tipear su nombre (o parte de él, porque, por supuesto, al igual que el buscador de clases Ctrl+Shif+T, soporta caracteres comodines, escribir sólo las iniciales de lo que se busca, etc, etc).

Básicamente, se puede acceder a casi todo con el Ctrl+3!!!

Save Actions en Eclipse Europa

A esta altura, esta característica de Eclipse Europa no es nada nueva, pero vale la pena comentarla.

A partir de la versión Europa de Eclipse existe la posibilidad de definir ciertas acciones a ejecutar automáticamente cada vez que se grabe un archivo.

Yo en general sólo uso las que están marcadas en la figura, que te autoformatean el código (como hacer Ctrl+Shif+F, digamos) y te organizan los import (análogo a Ctrl+Shif+O).


Pero hay un montón de cosas que se pueden configurar como Additional Actions. En la figura de abajo se ven algunas, pero esta es la lista simplificada (para más detalles mirá directamente en Eclipse que está todo muy claro):

• Que automáticamente ponga o no bloques en los if/else/for/while.
• Automáticamente convertir los for en foreachs (cuando se pueda, claro).
  
• Rodear las condiciones (o no) con paréntesis.
• Hacer que automáticamente se agregue la palabrita final a los métodos, variables privadas y/o variables locales.
• Usar o no el this para acceder a métodos y variables de instancia.
• Forzar que automáticamente se use el nombre de la clase cuando se utilicen métodos o campos estáticos.
• Remover automáticamente miembros privados que no sean usados (ojo con este porque te hace desaparecer las cosas si las dejaste de usar temporalmente).
• Remover casteos innecesarios
• Agregar automáticamente las anotaciones @Deprecated y @Override.
• Remover espacios en blanco al final de las líneas.
• Ordenar los métodos (de acuerdo a cómo se configure en Members Sort Order)
  

Eso es todo, ojalá les sirva!

¿Por qué la gente hace e.printStackTrace() en vez de relanzar como RuntimeException?

¿No les pasó de ver código similar a este?

try {
    InputStream input = new FileInputStream("myFile.txt");
} catch (FileNotFoundException e) {
    // TODO Auto-generated catch block
    e.printStackTrace();
}

Seguro que sí. Desde verlo en ejemplos en libros de texto (porque "total, es un ejemplo, se entiende que no es lo correcto") hasta en códigos de programas reales. ¡Pero si hasta eclipse autogenera ese try-catch!

Es una porquería. No sirve para nada y oculta bugs. La razón más común por la que se lo hace creo que es porque no se quiere manejar la excepción. Esto puede ser porque ese error nunca ocurre, porque no quiero que mi método tenga que tener un throws, o por desconocimiento, no se.

La forma correcta es esta:

try {
    InputStream input = new FileInputStream("myFile.txt");
} catch (FileNotFoundException e) {
    e.printStackTrace(); // esto es opcional, obviamente
    throw new RuntimeException(e);
}

De esta manera, al relanzar la excepción como RuntimeException nuestro método no tiene que declarar throws FileNotFoundException (para este ejemplo, claro está) y si el error ocurre lo vamos a ver enseguida porque nuestra aplicación va a fallar con un hermoso stack trace.

Podemos hacer que eclipse nos ayude con esto, modificando el code template. Vamos a Windows->Preferences->Java->Code Style->Code Templates y buscamos el que se llama Catch Block Body.

El valor por default es:

// ${todo} Auto-generated catch block
${exception_var}.printStackTrace();

Yo sugiero cambiarlo a:

${exception_var}.printStackTrace();
throw new RuntimeException(${exception_var});

Ah, de paso les comento, con respecto a lo que comenté hace un tiempo, que ya salió el Eclipse Europa.

Disfruten!

Se viene el nuevo Eclipse Europa

Así como el año pasado salió el Eclipse Callisto, este año sale el Eclipse Europa. Como dice en el sitio web, Europa es la salida en simultáneo de 21 proyectos con el objetivo de eliminar las posibilidades de incompatibilidades entre ellos.

Faltan 16 días...