En PC Resumen hablaremos de como instalar una aplicación en Java, su compilación, la ejecución del programa y la generación de su documentación.
La compilación de un programa
Una vez creado el archivo nombrePrograma con la extensión .java, la compilación se hace por medio de la instrucción siguiente:
- javac NombrePrograma.java - javac [opciones] nombreFichero1.java [nombreFichero2.java ...]
A continuación vemos algunas de las opciones disponibles:
- -classpath path: Permite especificar el directorio en el que se van a buscar las clases necesarias para ejecutar javac y otras clases referenciadas por las clases que compilamos.
- -d directory: Permite especificar el directorio raíz de la jerarquía de clases y deja los archivos compilados.
- -g: Dice al compilador que genere tablas de depuración para facilitar información al depurador.
- -deprecation: Genera un aviso cuando utilizamos una clase o miembro desaprobado (deprecated).
- -nowarn: Desactiva los avisos (warnings).
- -O: Aplica optimización independiente de la plataforma.
- -verbose: Muestra mensajes sobre los archivos que se compilan y los que se cargan.
- -dependiente: Recompila las clases de las que dependen nuestro código.
Si el compilador no devuelve ningún mensaje, automáticamente se generará un fichero NombrePrograma.class, que podrá ser interpretado por el intérprete de Java. En caso contrario si hay algún error compilando la aplicación, aparecerá un mensaje por pantalla del error producido, que habrá que enmendar.
La ejecución de un programa
Con el fin de ejecutar la aplicación que hemos creado, hay que utilizar el intérprete de Java, Java, que se encuentra en el mismo directorio que el compilador.
- java NombrePrograma
java. Intérprete de Java. Ejecuta los códigos byte producidos por el compilador, es decir, archivos .class.
- java [options] classname <args>
Las opciones disponibles para todas las plataformas son las siguientes:
- -classpath path: Permite especificar el directorio en el que se van a buscar las clases necesarias para ejecutar y otras clases referenciadas por las clases que ejecutamos.
- -D variable = valor: Modifica el valor a una de las variables del sistema.
- -jar: Permite ejecutar todo un programa encapsulado dentro de un archivo JAR. Con esta opción sólo se utilizarán clases que están dentro del JAR.
- -version: Muestra información de la versión.
- -help: Muestra un mensaje informativo sobre el uso del programa.
- -verbose: Muestra un mensaje cada vez que se carga un fichero class.
- -X: Muestra información sobre las opciones no estándar.
En el caso de crear programas para ejecutarlos como applets: appletviewer. Visor de applets. Permite ejecutar applets sin un navegador a partir de la URL (uniform resource locator) del archivo. Por lo tanto, toma como entrada un archivo HTML.
- appletviewer [opciones] urls
La Generación de la documentación
javadoc. Generador de documentación. A partir del código fuente de un programa, genera documentación de todas las clases que lo componen, en un archivo de texto, normalmente en formato HTML.
Los comentarios que el analizador busca dentro del código fuente están dentro de bloques que comienzan con "/**" y terminan con "*/".
Hay un conjunto de indicadores que javadoc reconoce como especiales y que comienzan con @.
La utilidad de los indicadores radica que permiten decidir si la información que los acompaña debe figurar en el fichero de documentación generado.
- javadoc [opciones] [package | fitxer.java] *
Las opciones disponibles son las siguientes:-publicado: sólo muestra clases y miembros públicos.
- -protected: Sólo muestra clases y miembros protegidos.
- -private: Sólo muestra clases y miembros privados.
- -package: Sólo muestra paquetes y clases, y miembros públicos y protegidos.
- -classpath path: Permite especificar el directorio en el que se van a buscar se clases necesarias para ejecutar javadoc.
- -d directory: Especifica el directorio en el que se dejan los archivos HTML generados.
- -notree: Ignora la jerarquía clase / interfaz.
- -noindex: Ignora el índice del paquete.
- -verbose: Genera mensajes al cargar el código fuente que especifican el número de milisegundos para tratar cada fichero fuente.
- -sourcepath path: Especifica donde hay que buscar los archivos fuente.
- -nodeprecated: Excluye párrafos con el indicador @deprecated.
- -version: Incluye los indicadores @version.
- -author: Incluye los indicadores @author.
- -encodingname: Especifica el nombre codificado de la fuente.
- -docencodingname: Especifica el nombre codificado del fichero HTML generado.
- -docletname: especifica el doclet que se quiere utilizar en la creación de la documentación.
Algunos de los indicadores que javadoc reconoce como especiales:
- --@author
- --@version
- --@deprecated
