Comentarios en Java (y II)

Comentarios en JAVA

Ya conocemos dos tipos de comentarios ¿Acaso hay mas?

Pues la respuesta es "true", en Java existe un tercer tipo de comentario llamados comentarios Javadoc.
Estos comentarios tienen la característica especial de que sirven para crear la documentación del programa con solo escribirlos. Esta documentación se crea con una utilidad llamada Javadoc del Kit de desarrollo de Java SE y se nos presenta en formato HTML.

¿y como los uso?

Un comentario Javadoc se escribirá igual que un comentario multilinea, con la diferencia de que no comenzará con /*, sino con /**.

Los comentarios Javadoc tienen 2 partes bien diferenciadas:

1. Descripción: Donde se aporta la descripción y datos importantes que facilitan la comprensión del elemento comentado.
2. Indicación: En la segunda parte del comentario se utiliza el indicador @ con ciertas palabras clave para que el programa, a la hora de realizar la documentación, sepa correctamente que estamos describiendo.

Normalmente se coloca un comentario Javadoc al inicio del programa en el que se describe que es lo que hará el mismo, la versión de la aplicación y el autor.

Este comentario quedaría así:

/**
 * Aquí iría una descripción sobre que va a hacer nuestro programa.
 * Podemos seguir la descripción en esta linea.
 * @version 1.0, 31/01/14
 * @author Sonando Java
 */

Las palabras reservadas para los indicadores son:


@author nombreDelAutor descripción --> Indica quién escribió el código al que se refiere el comentario. Si son varias personas se escriben los nombres separados por comas o se repite el indicador, según se prefiera. Es normal incluir este indicador en el comentario de la clase y no repetirlo para cada método, a no ser que algún método haya sido escrito por otra persona. 


@version númeroVersión descripción --> Si se quiere indicar la versión. Normalmente se usa para clases, pero en ocasiones también para métodos. 


@param nombreParámetro descripción --> Para describir un parámetro de un método. 


@return descripción --> Describe el valor de salida de un método. 


@see nombre descripción --> Cuando el trozo de código comentado se encuentra relacionada con otra clase o método, cuyo nombre se indica en nombre.


@throws nombreClaseExcepción descripción --> Cuando un método puede lanzar una excepción ("romperse" si se da alguna circunstancia) se indica así. 


@deprecated descripción --> Indica que el método (es más raro encontrarlos para una clase) ya no se usa y se ha sustituido por otro. 

Operadores aritméticos en Java

Operadores aritméticos en JAVA

Java cuenta con 5 operadores aritméticos tanto para números enteros como en coma flotante. Estos son:

Tipos de datos simples en Java

Tipos de datos simples

Los tipos de datos generalmente se utilizan al declarar las variables y sirven para decirle al compilador o al intérprete, de antemano, el tipo de dato que se guardará en la variable.

Los tipos de datos simples en Java son:

Tipo de dato	Información representada	Rango	Descripción
byte	Datos enteros	-128 ←→ +127	Se utilizan 8 bits (1 byte) para almacenar el dato.
short	Datos enteros	-32768 ←→ +32767	Dato de 16 bits de longitud (independientemente de la plataforma).
int	Datos enteros	-2147483648 ←→ +2147483647	Dato de 32 bits de longitud (independientemente de la plataforma).
long	Datos enteros	-9223372036854775808 ←→ +9223372036854775807	Dato de 64 bits de longitud (independientemente de la plataforma).
char	Datos enteros y caracteres	0 ←→ 65535	Este rango es para representar números en Unicode, los ASCII se representan con valores del 0 al 127.*
float	Datos con coma flotante de 32 bits	Precisión aproximada de 7 dígitos	Dato en coma flotante de 32 bits en formato IEEE 754 (1 bit de signo, 8 para el exponente y 24 para la mantisa).
double	Datos con coma flotante de 64 bits	Precisión aproximada de 16 dígitos	Dato en coma flotante de 64 bits en formato IEEE 754 (1 bit de signo, 11 para el exponente y 52 para la mantisa).
boolean	Valores booleanos	true/false	Utilizado para evaluar si el resultado de una expresión booleana es verdadero (true) o falso (false).

* ASCII es un subconjunto de caracteres Unicode.

Enlaces del día (23/10/2012)

Enlaces del día (23/10/2012)

Dejo colgada una relación de enlaces a sitios interesantes descubiertos hoy por mi.

Espero que les gusten, a mi al menos me resultaron útiles e interesantes:

1. Un enlace a una página de la universidad de Euskal Herria en la que se tratan temas tan interesantes como física o el lenguaje de programación JAVA: http://www.sc.ehu.es/sbweb/fisica//curso.htm
2. También dejo la página web de la que cuelga la anterior, esta tiene más de física que de JAVA, pero también resulta interesante: http://www.sc.ehu.es/sbweb/fisica/
3. Una breve explicacion sobre la clase java.lang.Math : http://lefunes.wordpress.com/2009/03/14/la-clase-javalangmath-i/
4. Explicación de parseInt: http://msdn.microsoft.com/es-es/library/1kc6b02f(v=vs.80).aspx
5. Y un blog interesante para mantenernos entretenidos: http://www.cyberhades.com/

A todo esto, ¿que es JAVA?

A todo esto, ¿que es JAVA?

Java es un lenguaje de programación de alto nivel orientado a objetos desarrollado a principios de los años 90.

El lenguaje en sí mismo toma mucha de su sintaxis de C y C++, pero tiene un modelo de objetos más simple y elimina herramientas de bajo nivel.

Es independiente  de la plataforma . Las primeras implementaciones de Java rezaban:“write once, run 

anywhere”.

Posee un sistema de administración de memoria automático, el Garbage Collector.

La plataforma JAVA.

Una plataforma es el ambiente en el que corre un determinado programa. En el caso de JAVA este cuenta con dos componentes:

• La máquina virtual de JAVA (JVM)
• La API de JAVA. La API de JAVA es una colección de componentes de software que dotan de funciones útiles al lenguaje.

El proceso de obtención de un programa JAVA.

En java el código fuente se escribe en un archivo de texto plano con extensión ".java"

Una vez escrito el código fuente es necesario compilarlo en archivos de tipo ".class". Un archivo ".class" no contiene instrucciones entendibles para el procesador, en cambio, contiene bytecodes, que son entendibles por la máquina virtual de JAVA (JVM) y es esta la que se encarga en el momento de su ejecución de transformar esos bytecodes en instrucciones comprensibles para el procesador en el que se está ejecutando.

De esta manera un mismo programa escrito en JAVA es utilizable por cualquier dispositivo en el que se tenga instalada la JVM.

Tipos de lenguajes de programación (Cercanía a lenguaje máquina)

Tipos de lenguajes de programación según su cercanía al lenguaje máquina.

El ordenador solo entiende un lenguaje, el lenguaje máquina, formado por 1 (si hay un pulso de corriente) o 0 (si no lo hay).

El programar así es una tarea demasiado pesada, demasiado larga y demasiado tediosa como para que sea el lenguaje habitual en el que se programa, por lo que aparecieron posteriormente los distintos tipos de lenguajes que paso a explicar.


Lenguajes de bajo nivel 

Dentro de este grupo se encuentran: 

• El lenguaje maquina: este lenguaje ordena a la máquina las operaciones fundamentales para su funcionamiento. Cnsiste en la combinación de 0's y 1's para formar las ordenes entendibles por el hardware de la maquina.
  Este lenguaje es mucho más rápido que los lenguajes de alto nivel.
  La desventaja es que son bastantes difíciles de manejar y usar, además de tener códigos fuente enormes donde encontrar un fallo es casi imposible.
• El lenguaje ensamblador es un derivado del lenguaje maquina y esta formado por abreviaturas de letras y números llamadas mnemotécnicos. Con la aparición de este lenguaje se crearon los programas traductores para poder pasar los programas escritos en lenguaje ensamblador a lenguaje máquina. Como ventaja con respecto al código máquina es que los códigos fuentes eran más cortos y los programas creados ocupaban menos memoria. Las desventajas de este lenguaje siguen siendo prácticamente las mismas que las del lenguaje ensamblador, añadiendo la dificultad de tener que aprender un nuevo lenguaje difícil de probar y mantener.

Lenguajes de alto nivel 

Son aquellos que se encuentran más cercanos al lenguaje natural que al lenguaje máquina. 
Están dirigidos a solucionar problemas mediante el uso de EDD's (Estructuras Dinámicas de Datos). 

Se tratan de lenguajes independientes de la arquitectura del ordenador. Por lo que, en principio, un programa escrito en un lenguaje de alto nivel, lo puedes migrar de una máquina a otra sin ningún tipo de problema. 

Estos lenguajes permiten al programador olvidarse por completo del funcionamiento interno de la maquina/s para la que están diseñando el programa. Tan solo necesitan un traductor que entiendan el código fuente como las características de la maquina. 

Suelen usar tipos de datos para la programación y hay lenguajes de propósito general (cualquier tipo de aplicación) y de propósito especifico (como FORTRAN para trabajos científicos). 

Lenguajes de Medio nivel 

Se trata de un termino no aceptado por todos, pero q seguramente habrás oído. Estos lenguajes se encuentran en un punto medio entre los dos anteriores. Dentro de estos lenguajes podría situarse C ya que puede acceder a los registros del sistema, trabajar con direcciones de memoria, todas ellas características de lenguajes de bajo nivel y a la vez realizar operaciones de alto nivel. 

Comentarios en Java (I)

Comentarios en JAVA

Vamos a ver algo básico, básico, básico de JAVA (y de cualquier otro lenguaje de programación) como son los comentarios.