COMENTARIOS

Para poner comentarios en nuestro cdigo fuente java tenemos tres opciones:

Una lnea de comentario que empiece por //

// Esto es un comentario
System.out.println ("Hola mundo");

Varias lneas encerradas entre /* y */

/* Todo esto
tambin es un
comentario */
System.out.println ("Hola mundo");

Finalmente, podemos hacer varias lneas de comentario entre /** y */

/** Todo esto

tambin es un
comentario */
public void unMedodo (int unParametro) {
...
}

La diferencia entre el comentario que empieza por /** y el que empieza por /* es que el primero
sale en la documentacin generada por javadoc y en la mayora de herramientas que hacen
documentacin a partir del cdigo. El comentario que empieza por /* no sale en la documentacin.

Hay unos detalles, sin embargo, que conviene tener en cuenta para comentarios que van a salir en
la documentacin. Conviene poner uno de estos comentarios delante de cada clase, cada mtodo
y cada atributo, de esta forma, en la documentacin aparecern convenientemente documentados
las clases, mtodos y atributos. Lo siguiente puede ser un ejemplo.

/**
Montones de funciones matemticas.
Realiza operaciones trigonomtricas, ecuaciones diferenciales
e integrales */
public class Matematicas {

/** PI.
Pues eso, PI=3.14 y pico */
public static final double PI = 3.1416;

/** Devuelve el seno del ngulo que se le pasa.

El ngulo debe estar en radianes. */
 public double sin(double angulo) {
...
}
}

Es importante tener en cuenta que dentro de cada comentario, la primera frase -hasta el primer
punto- saldr como resumen de la clase, mtodo o atributo. Conviene, por tanto, que esa frase
tenga sentido por s sola.

En el ejemplo, si generamos la documentacin, saldr como resumen de

La clase Matematicas : "Montones de funciones matemticas"

El atributo PI : "PI"
El mtodo sin() : "Devuelve el seno del ngulo que se le pasa"
Si en la documentacin vamos a la parte de detalle de la clase, mtodo o atributo, veremos el resto
del comentario.

En la documentacin de la clase EscalaGraficaCartesiana puedes ver el resumen -que es el texto

que aparece en el lista de mtodos dentro de la caja- y el comentario detallado -lo que aparece en
los mtodos que van despus de la tabla-.

Escrito por Alex Rodrguez

Resumen: Entrega n21 del curso "Aprender programacin Java desde cero".
Codificacin aprenderaprogramar.com: CU00621B

TIPOS DE DATOS (VARIABLES) EN JAVA. TIPOS PRIMITIVOS (INT, ETC.) Y

OBJETO.

Los primeros lenguajes de programacin no usaban objetos, solo variables. Una variable
podramos decir que es un espacio de la memoria del ordenador a la que asignamos un
contenido que puede ser un valor numrico (slo nmeros, con su valor de clculo) o de
tipo carcter o cadena de caracteres (valor alfanumrico que constar slo de texto o de
texto mezclado con nmeros).
Como ejemplo podemos definir una variable a que contenga 32 y esto lo escribimos como a
= 32. Posteriormente podemos cambiar el valor de a y hacer a = 78. O hacer a
equivalente al valor de otra variable b as: a = b.

Dado que antes hemos dicho que un objeto tambin ocupa un espacio de memoria: en qu
se parecen y en qu se diferencia un objeto de una variable? Consideraremos que las
variables son entidades elementales: un nmero, un carcter, un valor verdadero o falso
mientras que los objetos son entidades complejas que pueden estar formadas por la
agrupacin de muchas variables y mtodos. Pero ambas cosas ocupan lo mismo: un espacio
de memoria (que puede ser ms o menos grande).

En los programas en Java puede ser necesario tanto el uso de datos elementales como de
datos complejos. Por eso en Java se usa el trmino Tipos de datos para englobar a
cualquier cosa que ocupa un espacio de memoria y que puede ir tomando distintos valores o
caractersticas durante la ejecucin del programa. Es decir, en vez de hablar de tipos de
variables o de tipos de objetos, hablaremos simplemente de tipos de datos. Sin embargo, a
veces coloquialmente no se utiliza la terminologa de forma estricta: puedes encontrarte
textos o pginas web donde se habla de una variable en alusin a un objeto.

En Java diferenciamos dos tipos de datos: por un lado, los tipos primitivos, que se
corresponden con los tipos de variables en lenguajes como C y que son los datos
elementales que hemos citado. Por otro lado, los tipos objeto (que normalmente incluyen
mtodos).

Veamos los tipos de datos en Java sobre un esquema de sntesis:

TIPOS DE COMENTARIOS
 RANGO
NOMBRE TIPO OCUPA
APROXIMADO
byte Entero 1 byte -128 a 127

TIPOS short Entero 2 bytes -32768 a 32767

TIPOS
DE PRIMITIVOS int Entero 4 bytes 2*109
DATOS (sin mtodos; no son
EN JAVA objetos; no necesitan long Entero 8 bytes Muy grande
una invocacin para
Decimal
ser creados) float 4 bytes Muy grande
simple
double Decimal 8 bytes Muy grande
 doble
Carcter
char 2 bytes ---
simple
Valor
boolean true o 1 byte ---
false