Apoyando el Software Libre, a un mundo libre!

Holas!!
Aqui va un poco de mala experiencia y mala suerte:

Porfin!!! Aprobé todo en mi universidad!!! (Siii, también aprobé Matemática Aplicada), pero ahora comienza el verdadero trabajo, montando el servidor de la comunidad Java Chile con openSolaris, cosa que me da mucho gusto, instalar openSolaris en los nuevos equipos del laboratorio Linux(Yieaa, van a tener booteo dual Linux/openSolaris y Windows solo virtualizado) y documentar todo lo de LDAP en un super TWiki. Espero terminar estas tareas antes de que cierren la U :-D Demas!! Eso es todo por hoy, cambio y fuera!!
Imagen: (r)Derechos reservados a comunidad Java Chile

Holas!!

Para pasar los ratos de ocio les recomiendo este buen juego, se llama Treuolous y tiene la trama de aliens contra humanos. No es tan avanzado como AVP, peroresulta entretenido, sobre todo porque puedes construir tu base con torres te autodefenza. Lo pueden descargar aquí. Tambien dejo aquí algunas imagenes para quen se entucianmen. Ahh y por su puesto, esta disponible para GNU/Linux y Windows(al parecer hay un port para openSolaris), ya que esta basado en el motor del Quake 3. Esto le entrega un gran rendimiento, sea cual sea la tarjeta gráfica. Tambien como datos os dejo un link muy bueno: nada mas ni nada menos que un sitio dedicado a los Juegos Libres, pensando principalmente en Linux.

• Solaris 11 Nevada b76 en ZFS
• Ubuntu 7.10 64bits en ReiserFS
• ArchLinux 32bits en ReiserFS

Hola !!!

Un día como hoy, hace 30 años atrás estrenaron la Guerra de las galaxias [yo ni nacia ;-( ], y por este motivo y mi relación con Java, les muestro una pic interesante ;-) Saludos!!!

Copyright de las fotos a sus respectivos autores, así como el logotipo de Java, a Sun Microsystems Inc.
La idea fue mía, y hecha en OpenOffice.org Draw ;-)

Hola nuevamente!!!

Aqui voy a mostrar las ventajas que tiene usar NetBeans con Javadocs, las cuales son muchas. Pero primero, vamos a explicar lo que es Javadocs.

Javadocs

Es una herramienta que nos provee el SDK de Java para generar la documentacion de nuestras ropias clases, de manera rapide y efectiva. Lo que que hace javadocs es basicamente tomar los comentarios marcados de manera especifica y los enlaza, generando una pagina en formato HTML con todos los comentarios, dependencias y parametros de clases, atributos y metodos que se encuentren en el codigo. Al ejecutar java docs sobre un codigo bien comentado, quedara al mismo estilo que la documentacion de la API de Java.

Comentarios, al puro estilo Javadocs

Los comentario que procesa Javadocs se estructuran así:

/**
* Este comentario sera procesado por Javadocs
* @etiqueta [dato_opcional] Etiqueta procesada por Javadocs
*
*/
// Aqui el codigo que corresponde el comentario de arriba

Lo anterior, y como es la idea de Javadocs, es que el código fuente este muy enlazado a los comentarios, cosa de que la documentación sea clara y comprensible para quien la lee. TambiénJavadocs procesa etiquetas, y de acuerdo a ellas, y su contenido, genera informacion mas precisa. No es obligatorio ponerlas, pero si se quiere buena documentación, si lo son.

Javadocs con NetBeans

¿Que tiene de bueno? Muchas cosas, es tan simple como 2 clicks para generar toda la documentacion, sin contar los asistentes que nos ayudan a comentar bien nuestro codigo y nos avisan en caso de estar incompletos. Los principales objetos de Javados en NetBenas son:

Auto comment... : Es un asistente que analiza todas las clases, subclases, atributos y metodos, verificando que esten bien comentados, asi como permitirnos agregar comentarios facilmente. Lo encontramos en en menu 'Tools' -> 'Auto comment'. Tambien podemos desplegar esta herramienta haciendo click con el boton secundario en un archivo .java, seleccionando el manu 'Tools' y luego 'Auto comment'.

Generate Javadocs for Proyect : Genera la ayuda javadocs para todas las clases de nuestro proyecto. Podemos hacer que la genere en el menu 'Build'->'Generate Javadocs for [proyecto]' o bien, desplegando el menú contextual en el nombre el proyecto y clickear en 'Generate Javadocs for proyect'.


También, dentro del proyecto, al examinar el código fuente, encontraremos en la ventana de propiedades una clausula que nos permitirá insertar comentarios Javadocs a gusto, así como etiquetas, dependiendo de donde se encuentre el cursos del editor de código.

Así al colocar el cursos en el cuerpo de un método de una clase, con permitirá documentar ese método especifico. Si nos colocamos fuera de un método o atributo, pero dentro de la clase, podremos documentar la clase en si.


Espero, nuevamente sea de su agrado esto y que tenga mucha utilidad. Good Bytes!!

Fuentes:

• http://www.lab.dit.upm.es/~lprg/material/apuntes/packages/packages.htm
• http://javabasico.osmosislatina.com/curso/progbasico/genpack.htm
• http://javabasico.osmosislatina.com/curso/progbasico/usopack.htm
• http://javabasico.osmosislatina.com/curso/progbasico/jars.htm
  

Ahora, vista de las mismas necesidades de conocimiento, voy a mostrar como trabajar con los paquetes de Java o packages.
Un paquete en Java es lo que su nombre lo indica, un paquete o conjunto de clases, lógicamente, que tienen cosas en común. Lógicamente un programado puede agruparlas con o sin criterio, pero lo ideal es que se dediquen a funciones especificas. También los paquetes definen una jerarquía de directorios, que permiten igualmente agrupas las clases, cosa de desplegar los archivos mas ordenadamente.
También, cuando necesitamos librerías de java, igualmente estamos llamando a una clase especifica o a todo un paquete. Por ejemplo, cuando ponemos esto:

import System.io.*;

estamos importando todas las clases del paquete System.io. Ahora, si hacemos esto:

import org.usach.abo.ABO;

Estamos importando la clase ABO del paquete org.usach.abo.

Para definir un paquete solo tenemos que incluir antes que los paquetes a importar, la definición del paquete al que pertenece la clase, de la forma siguiente:

package org.ruta.del.paquete;

lo que implica que el paquete tiene que estar en la ruta:

org/ruta/del/paquete

o en windows, suponiendo que el proyecto fue creado en c:\mi_proyecto\

c:\mi_proyecto\org\ruta\del\paquete\

En ese directorio tenemos que crear nuestra clase con el identificador de package. Si queremos compilar o ejecutar algo, solo tenemos que ubicarnos en el directorio del proyecto y poner:

java org.ruta.del.paquete.MiClase
javac org.ruta.del.paquete.MiClase.java

El asume estomáticamente la ruta hacia la clase o conjunto de clases.

Los famosos JARs

Los JAR o archivos con extensión .jar, corresponden a archivos ZIP, que contienen un conjunto de clases organizadas en paquetes. Esto resulta muy útil cuando tenemos una gran cantidad de clases, lo que implica una gran cantidad de archivos, por lo que empaquetarlas en un JAR resulta practico al momento de la distribución de nuestro software o despliegue.
Para crear un JAR de nuestros paquetes, solo tenemos que ubicarnos en la raiz de los paquetes y llamar al ejecutable jar, que viene includo en el SDK de Java, asi:

jar cvf mipaquete.jar *
y con esto obtendremos todas las clases y paquetes en un solo y practico archivo JAR.Asi mismo, para extraer el contenido de un .jar solo hay que hacer:

jar xvf mipaquete.jar

y recrea la estructura del paquete que teníamos cuando empaquetamos.

JARs y Netbeans 5.5

Al trabajar con NetBeans 5.5 tambien podemos decirle que nos genere un archivo JAR para distribuir nuestro proyecto. Para hacer esto, hacemos click secundario en el proyecto y vamos a "Properties" y luego a la seccion "Packaging". Deberian ver algo como esto:El primer cuadro nos muestra cual ba a ser el nombre del archvo JAR a generar. El segundo muestra que archivos va a excluir al empaquetar, que como predeterminado excluye los fuentes. Tambien, nos da la opcion de comprimir el archivo JAR, usando comprension ZIP.

Extra Bonus!!

Para Windows:

Les recomiendo que al momento de trabajar con estas utilidades, ya sea al trabajar con JARs o compilar y ejecutar usando la liea de comandos, agreguen en su variable de entorno el directorio en donde tienen instalado su SDK, al directoio "bin". Así, si yo tengo instalado mi SDK en:
c:\Archivos de programas\J2SDK_\

Nota: si tienen la ultima(a la fecha de escribir esto), es 1.6.0 y es 1.
En su variable PATH, deberían tener agregado:

c:\Archivos de programas\J2SDK_\bin

Verifiquenlo abrindo la consola(Menu Inicio->Ejecutar->'cmd') y tecleando:

echo %PATH%

y debería estar en su ruta.
Espero que os sea de mucha utilidad. Salu2!!!

• Los nombre de clases se comienzan con mayuscula y continuan con minuscula hasta el inicio de otra palabra, en donde se inicia con mayuscuala, continuando con minuscula, y asi sucesivamente. Ejemplo: ABO, ArbolBinarioOrdenado, ABOExceptions, Clase.
• Los nombres de atributos y metodos comienzan con minuscula y continuan asi hasta la nueva palabra, en donde se inicia con mayuscula y continua nuevamente con minuscula, y así sucesivamente. Ejemplos: definirABO, definirArbol, nuevoArbol, archivo.

Usando una nomenclatura estandar permite a los desarrolladores entenderse mejor y obtener un codigo fuente mucho mas legible. Otras recomendaciones, como el usar nombre significatibos al momento de definir clases, atributos o metodos (nombreArchivo) y no nombre tontos (nA), estan de más.

Usando SubVersioN en NetBenas 5.5

NetBeans hace de front-end para el comando svn, por lo tanto al apretar el boton de commit, por ejemplo, lo que hace es hacer un commit de lo que tenemos guardado, por lo que antes de cualquier sincronizacion que queramos hacer, SIEMPRE debemos GUARDAR TODO.

• Show All Changes : Muestra una ventana donde podemos ver lo cambios tanto locales como remotos y hasi escoger cuales queremos y cuales no.
• Diff All Files : Al momento de haber divergencias en archivos remotos y locales, y sobre todo, cuando se modifica por dos o mas personas el mismo archivo, conviene hacer un diff, el cual consiste en compara las diferencias entre los archivos y ver cuales se conservan y cuales no. Esta operacion del menu permite hacer un diff a todo los archivos y muestra todas las diferencias.
• Update All Files : Descarga todos los archivos del servidor SVN, sobrescribiendo los cambios locales.
• Commit All Files : Sube todos los archivos al servidor SVN sobreescribiendo cualquier modificacion remota.
• Checkout : Abre el asistente para obtener los archivos de un servidor SVN. Generalmente es la operacion inicial para cargar el proeycto remoto y despues solo ir modificando algunos archivos y no todos.
• Import to repository : Permite subir un nuevo proyecto en el servidor.
• Update proyect with Dependences : No hare descripcion de esta opcion, pues no se usa comunmente.
• Show changes : Muestra una ventana con un resumen de las modificacion de un objeto especifico.
• Diff : Hace diff de un objeto especifico.
• Update : Hace Update de un objeto especifico.
• Commit : Efectua los cambio en un objeto especifico.
• Export Diff Patch : Genera un diff patch o parche, que permite parchar las modificaciones de un programa, en base a sus diferencias.
• Copy to : Copia objetos especificos a otro lugar.
• Switch to : Permite subir o bajar de revision un objeto, de acuerdo a la historia guardada.
• Merge to : Permite mezclar objetos de diferentes revisiones.
• Show annotations : Muestra notas dejadas al momento de crear una revision especifica.
• Serach History : Permite buscar en las diferentes revisiones de un objeto especifico.
• Revert Modifications : Revierte las modificaiones de un objeto seleccionado, ya sea modificaciones locales, o de revisiones anteriores.
• Resolve Conflicts : Asistente que permite resolver conflictos entre archivos locales y los del servidor, asi como moficicaciones entre diferentes usuarios.
• Ignore : Premite ignorar alguna modificacion y dejarla pasar (No es muy recomendable).

Hola!!

1. Una ves instalado NetBeans, arranquen el Update Center, del menú Tools.
2. Sigan el asistente e instalen el modulo de Subversion, ya sea global, si tienen privilegios o no global si tienen cuentas de usuario restringidas.
3. Bajen e Instalen SubVersioN de su sitio oficial.
4. Ejecuten NetBeans, vayan al menú Subversion y que tengan un feliz chekout!!!

• Google Browser Sync: Que permite sincronizar nuestra cuenta google remota todo el contenido de nuestro navegador, como las paginas visitadas, cookies, contraseñas guardadas, y las paginas que visitaste por ultima vez, permitiendo que, al instalar la extensión, podemos recuperar todos estos datos y continuar navegando como en casa, sin perder el hilo de nuestra navegación.
  
• Blogger Web Commnents: Permite hacer comentarios sobre la Web que estamos visitando, y ver comentarios de otras personas.