Qué Es Java
Qué Es Java
Qué Es Java
El primer proyecto
El código fuente se debe escribir en un archivo de texto plano, es decir sin formato, para lo
que recomiendo usar el Bloc de Notas o WordPad en caso de Windows. Éste debe ser
guardado en un archivo, de nombre el de la clase que estemos creando, y de extensión
'.java'.
Habrá que tener en cuenta al escribir el código que Java es sensible a las mayúsculas y
minúsculas, lo que quiere decir que 'Hola' no es lo mismo que 'hola'. Al escribir código es
muy conveniente comentarlo, sobre todo si vamos a compartirlo con otros desarrolladores o
para futuras actualizaciones.
Comentar y documentar el código
En Java existen tres tipos de comentarios: los que soportan sus antecesores C y C++ y uno
muy importante y novedoso: el cometario de documentación.
//Esta línea será omitida por el compilador así que saltará directamente a la siguiente. /*Así
que esta cabecera de comentario no la verá
y se creerá que esta línea es código
y esta también*/Existe un tipo de comentario muy, muy útil que es introducido por Java: se
trata del comentrio de documentación que usa el programa javadoc para crear
documentación en formato HTML. De esta forma podremos documentar elegante y
rápidamente nuestras clases.
Un comentario de documentación comienza con "/**" y termina con "*/" y cada línea debe
comenzar con "*".
En un comentario de este tipo podremos insertar etiquetas HTML aunque esto no sea
necesario, ya que el programa javadoc crea documentos muy vistosos.
Para indicarle al programa sobre qué estamos escribiendo existen las "etiquetas de
documentación" que son básicamente las siguientes:
@param parametro1
linea 1
(...)
Indica que a continuación se
linea n
@param explica el valor de un
@param parmetro2
parámetro.
linea1
(...)
linea n
/**
*@version Version 1.0 de mi primera clase
*@author Yo pr supuesto
*<a href="mailto:yo@micompania.com">Mi e-mail</a>
*(...)
*/