36
Capítulo 2 Introducción a las aplicaciones en Java
Un comentario que comienza con
//
se llama
comentario de fi n de línea
(o
de una sola línea
), ya que
termina al fi nal de la línea en la que aparece. Un comentario que se especifi ca con
//
puede empezar también en
medio de una línea, y continuar solamente hasta el fi nal de esa línea (como en las líneas 11 y 13).
Los
comentarios tradicionales
(también conocidos como
comentarios de múltiples líneas
), como el que
se muestra a continuación
/* Éste es un comentario
Tradicional.
Puede
dividirse en muchas líneas */
se distribuyen en varias líneas. Este tipo de comentario comienza con el delimitador
/*
y termina con
*/
. El com-
pilador ignora todo el texto que esté entre los delimitadores. Java incorporó los comentarios tradicionales y los
comentarios de fi n de línea de los lenguajes de programación C y C++, respectivamente. En este libro utilizamos co-
mentarios de fi n de línea.
Java también cuenta con
comentarios Javadoc
, que están delimitados por
/**
y
*/
. Al igual que con los
comentarios tradicionales, el compilador ignora todo el texto entre los delimitadores de los comentarios Javadoc.
Estos comentarios permiten a los programadores incrustar la documentación del programa directamente en éste.
Dichos comentarios son el formato preferido en la industria. El programa de utilería
javadoc
(parte del Kit de
Desarrollo de Java SE) lee esos comentarios y los utiliza para preparar la documentación de su programa, en for-
mato HTML. Hay algunas sutilezas en cuanto al uso apropiado de los comentarios estilo Java. En el apéndice K,
Creación de documentación con
javadoc
, demostramos el uso de los comentarios Javadoc y la herramienta
javadoc
. Para obtener información completa, visite la página de herramientas de
javadoc
de Sun en
java.sun.
com/javase/6/docs/technotes/guides/javadoc/index.html
.
Error común de programación 2.1
Olvidar uno de los delimitadores de un comentario tradicional o Javadoc es un error de sintaxis. La
sintaxis
de un
lenguaje de programación que especifi ca las reglas para crear un programa apropiado en ese lenguaje. Un
error de
sintaxis
ocurre cuando el compilador encuentra código que viola las reglas del lenguaje Java (es decir, su sintaxis).
En este caso, el compilador muestra un mensaje de error para ayudar al programador a identifi car y corregir el código
incorrecto. Los errores de sintaxis se conocen también como
errores del compilador
,
errores en tiempo de com-
pilación
o errores de compilación, ya que el compilador los detecta durante la fase de compilación. Usted no podrá
ejecutar su programa sino hasta que corrija todos los errores de sintaxis que éste contenga.
La línea 2
// Programa para imprimir texto.
es un comentario de fi n de línea que describe el propósito del programa.
1
// Fig. 2.1: Bienvenido1.java
2
// Programa para imprimir texto.
3
4
public class
Bienvenido1
5
{
6
// el método main empieza la ejecución de la aplicación en Java
7
public static void
main( String args[] )
8
{
9
System.out.println(
"Bienvenido a la programacion en Java!"
);
10
11
}
// fin del método main
12
13
}
// fin de la clase Bienvenido1
Figura 2.1
| Programa para imprimir texto.
Bienvenido a la programacion en Java!
02_MAQ_CAP_02.indd36
4/19/081:18:55AM