2.

Estructura de un programa en Java

Objetivos:
a) Describir la estructura del cdigo fuente de una aplicacin Java
b) Presentar los conceptos de comentario y de identificador dentro del cdigo
fuente de un programa
Este captulo tiene como objetivo presentar la estructura de un programa mediante un
ejemplo sencillo y mostrar dos elementos tpicos del cdigo fuente: los comentarios y los
identificadores. La estructura de un programa de Java es similar a la de un programa de C/C++. Por
su diseo, permite a los programadores de cualquier otro lenguaje leer cdigo en Java sin mucha
dificultad. Java emplea siempre la Programacin Orientada a Objetos por lo que todo el cdigo se
incluye dentro de las clases. Aunque ya se explicarn detenidamente ms adelante, las clases son
combinaciones de datos (constantes y variables) y rutinas (mtodos).

2.1. La clase principal y el mtodo main

Un programa puede construirse empleando varias clases. En el caso ms simple se utilizar
una nica clase. Esta clase contiene el programa, rutina o mtodo principal: main() y en ste se
incluyen las sentencias del programa principal. Estas sentencias se separan entre s por caracteres de
punto y coma.
La estructura de un programa simple en Java es la siguiente:
public class ClasePrincipal {
public static void main(String[] args) {
sentencia_1;
sentencia_2;
// ...
sentencia_N;
}
}

Como primer ejemplo sencillo de programa escrito en Java se va a utilizar uno que muestra
un mensaje por la pantalla del ordenador. Por ejemplo, el programa Hola.java:
/**
* La clase hola construye un programa que
* muestra un mensaje en pantalla
*/
public class Hola {
public static void main(String[] args) {
System.out.println("Hola, ");
System.out.println("me llamo Angel");
System.out.println("Hasta luego");
}
}

Como se ha indicado anteriormente, en un programa de Java todo se organiza dentro de las

clases. En el ejemplo anterior, Hola es el nombre de la clase principal y del archivo que contiene el
cdigo fuente. Todos los programas o aplicaciones independientes escritas en Java tienen un mtodo

main o principal que, a su vez, contiene un conjunto de sentencias. En Java los conjuntos o bloques
de sentencias se indican entre llaves { }. En el caso anterior, el conjunto de sentencias se reduce a
tres sentencias, que son llamadas a dos mtodos predefinidos en Java (print y println) que
permiten visualizar texto por el dispositivo de salida de datos por defecto (la pantalla).
Por el momento y hasta que se explique con detalle el concepto de clase, los ejemplos de
programa que se utilizarn constarn de una sla clase en la que se declara el mtodo main. Este
mtodo es el punto de arranque de la ejecucin de todo programa en Java.

2.2. Comentarios
Los comentarios se emplean para facilitar la tarea de los programadores humanos ya que no
realizan ningn papel activo en la generacin del cdigo. Los comentarios que se pueden introducir
en el cdigo fuente de un programa de Java son del estilo de C y C++. As, el compilador ignora
todo lo que se incluya entre la secuencia de caracteres // y el final de la lnea. Por ejemplo:
// Este es un comentario estilo C++, llega al final de la linea

La pareja de caracteres / hay que escribirla sin dejar ningn espacio en blanco entre ellos. El
segundo tipo de comentario es el que se utiliza tambin en el lenguaje de programacin C: el
compilador tambin ignora todo lo que se incluya entre las secuencias de caracteres /* y */. Por
ejemplo:
/* En este otro comentario estilo C, el final
lo indica la marca */

El comentario con // es ms fcil de teclear si slo ocupa una lnea, pero si ocupa varias,
entonces el ms sencillo es el de /* ... */. Los comentarios pueden incluir cualquier carcter vlido
en Unicode y no pueden anidarse.
Estos dos formatos de comentario se emplean para los denominados comentarios de
implementacin. Los comentarios de implementacin se utilizan en el programa fuente para resaltar
cdigo o para aclarar un desarrollo en particular.
Adems, en Java existe un tercer tipo de comentario (doc comments) que facilita la
generacin de documentacin en formato HTML al emplear algunas herramientas de documentacin
(por ejemplo, javadoc incluida en el Kit de Desarrollo de Java). Los comentarios para la
documentacin se emplean para describir la especificacin del cdigo, desde una perspectiva
independiente cmo se ha implementado y ser leido por desarrolladores que no tengan
necesariamente el cdigo fuente a la vista. Debe evitarse emplear los comentarios para dar
panormicas del cdigo y facilitar informacin que no facilite la propia lectura del cdigo. Ejemplos
de este tipo de comentarios:
/** Comentario estilo javadoc, se incluye
automaticamente en documentacion HTML */
/**
* Muchos programadores
* suelen incluir un asterisco
* al principio de cada linea del
* comentario para facilitar su lectura
*/

Los comentarios deberan contener slo informacin relevante para la lectura y comprensin
del programa. Todos los programas deben empezar por un comentario que describa el propsito del
programa. La discusin de decisiones de diseo que no sean obvias (triviales) es apropiada, pero
debe evitarse la duplicidad de informacin dada por el propio cdigo. Es muy comn que los
comentarios redundantes se desactualicen. En general, se debe evitar incluir comentarios que puedan
quedarse obsoletos conforme el cdigo se desarrolle. Por ejemplo, dentro de un comentario no
debera incluirse informacin acerca de cmo se ha construido un archivo fuente determinado o en
que directorio se haya el cdigo.
A veces la frecuencia de los comentarios refleja una peor calidad de cdigo. Cuando se sienta
la necesidad de aadir un comentario, debe considerarse la reescritura del cdigo para hacerlo ms
claro.
Convencin para los comentarios al inicio de los programas
Todos los archivos fuente deberan comenzar con un comentario estilo C que liste el nombre
de la clase, informacin de la versin, fecha y el aviso de copyright:
/*
* Nombre de la clase
*
* Informacin de la version
*
* Fecha
*
* Aviso de Copyright
*/

2.3. Identificadores
Los identificadores son nombres que se les asignan a variables, mtodos, clases en el
cdigo fuente de un programa. Los identificadores slo existen en el cdigo del programa fuente y no en
el programa objeto (resultado de la compilacin del programa fuente). Todo nuevo identificador que se
emplee en un programa Java debe definirse previamente a su utilizacin. Las normas para la
construccin de un identificador empleando el lenguaje de programacin Java son las siguientes:

Un identificador comienza por una letra, un carcter de subrayado (_) o un carcter de dlar
($). Aunque no se recomienda emplear el carcter $, ya que el compilador suele utilizarlos de
forma interna para crear identificadores propios.
Los siguientes caracteres pueden ser tambin dgitos. Pero no pueden emplearse espacios en
blanco u otros caracteres como el signo de interrogacin (?) o el signo del tanto por ciento
(%).
No hay lmite mximo de caracteres.
En los identificadores del cdigo fuente de un programa en Java se distinguen las maysculas
de las minsculas. Por ejemplo, casa, CASA y Casa son tres identificadores diferentes.
Pueden incluir caracteres Unicode, con lo que se pueden emplear secuencias de escape
/uxxxx para representar estos caracteres.
No puede emplearse el identificador de una variable o cualquier otro elemento del cdigo
fuente del programa para otro ya existente en el mismo bloque. Excepcin: variable miembro
y local con el mismo identificador.

Existe una serie de palabras reservadas que no pueden emplearse como identificadores por
el programador en el cdigo fuente para otros usos. Por ejemplo, la palabra double se
utiliza para definir un tipo de dato real y la palabra for se emplea para construir un tipo
determinado de bucle. En la Tabla 2.1 se muestran las palabras reservadas en Java.
Tabla 2.1. Palabras reservadas en Java

abstract
boolean
break
byte
case
catch
char
class
const*
continue
default

do
double
else
extends
false
final
finally
float
for
goto*
if

implements
import
instanceof
int
interface
long
native
new
null
package
private

protected
public
rest
return
short
static
strictfp
super
switch
synchronized
this

throw
throws
transient
true
try
void
volatile
while

Algunos de estos identificadores reservados no tienen todava uso en la implementacin

actual del lenguaje Java. En concreto, los identificadores marcados con un asterisco * no se utilizan
actualmente. Por otro lado en la Tabla 2.2 se muestran los nombres de mtodos reservados en Java
cuyo significado y utilizacin se explicar ms adelante cuando se menciones la clase predefinida
Object.
Tabla 2.2. Identificadores de mtodos reservados en Java

clone
notify

equals
notifyAll

finalize
toString

getClass
wait

hashCode

Aunque la forma de escribir los identificadores en Java no est normalizada, a continuacin

se dan algunas recomendaciones para la eleccin de estos identificadores:

Es conveniente utilizar identificadores autoexplicativos para orientar al usuario o a cualquier otra

persona que accede al cdigo fuente de un programa sobre lo que representan, sin necesidad de
utilizar los comentarios en el propio cdigo fuente. Por ejemplo, para almacenar el valor del radio
de una esfera podra declararse una variable con el identificador radio, radioesfera o
radiodeunaesfera.
Si el identificador se compone de ms de una palabra, stas se agrupan y despus de la
primera el resto comienza con una letra mayscula, como por ejemplo: esVisible o
radioEsfera.
El signo de subrayado se acepta en cualquier identificador pero por convencin slo se
emplea para separar palabras en identificadores en constantes (por convencin las constantes
se escriben completamente en maysculas y esto dificulta la separacin de los nombres). Por
ejemplo, para un valor constante que almacena un valor numrico que representa el nmero
mximo de alumnos con los que trabaja el programa se podra declarar el identificador de la
constante NUMERO_MAXIMO_ALUMNOS.

Aunque la definicin exacta de la indentacin (espacios vs tabuladores) no se especifica en el

lenguaje Java, se recomienda emplear una secuencia de cuatro espacios como unidad de indentacin.
Por otro lado se recomienda evitar las lineas de ms de 80 caracteres en el cdigo fuente ya que
no se manejan correctamente por muchos terminales y herramientas de edicin.