Escolar Documentos
Profissional Documentos
Cultura Documentos
01 transitional//en"
"http://www.w3.org/tr/html4/loose.dtd">
<html>
<head>
<title>javadoc</title>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<style type="text/css">
<!--
.estilo1 {
font-family: verdana;
color: #ffff80;
}
.estilo2 {
font-family: "book antiqua";
color: #0000ff;
}
.estilo3 {
font-size: x-large;
color: #000080;
}
.estilo4 {color: #ff0000}
-->
</style>
</head>
<body>
<table width="990" border="0" cellpadding="0" cellspacing="0" bgcolor="#ffffff">
<!--dwlayouttable-->
<tr>
<td width="990" height="105" valign="top"><table width="100%" border="0"
cellpadding="0" cellspacing="0" bgcolor="#0080c0">
<!--dwlayouttable-->
<tr>
<td width="990" height="105" valign="top"><div align="right">
<h2 class="estilo1">universidad de panamá <br>
centro regional de veraguas <br>
facultad de informática, electrónica y comunicaciones
<br>
licenciatura en ingeniería en informática </h2>
</div></td>
</tr>
</table></td>
</tr>
<tr>
<td height="48" valign="top"><table width="100%" border="0" cellpadding="0"
cellspacing="0">
<!--dwlayouttable-->
<tr>
<td width="990" height="48" valign="top" bgcolor="#c0c0c0"><!--
dwlayoutemptycell--> </td>
</tr>
</table></td>
</tr>
<tr>
<td height="269" valign="top"><div align="center">
<table width="100%" border="0" cellpadding="0" cellspacing="0">
<!--dwlayouttable-->
<tr>
<td width="990" height="269" valign="top"> <p>
__________________________________________________________________________________
___________________ </p>
<h2 class="estilo2 estilo3"><strong> javadoc como herramienta para
la documentacion de programas en java</strong></h2>
<p align="right"
class="estilo2">__________________________________________________________________
___________________________________</p>
<p align="right" class="estilo2">carlos de gracia</p>
<p align="right" class="estilo2">fátima hernández </p>
<p align="right"
class="estilo2">__________________________________________________________________
__________________________________________________________</p> <p
align="center"><strong>índice<a name="indice"></a></strong></p>
<p align="center"> </p> <ul>
<li>
<div align="left"><a href="#intro">introducci�n</a></div>
</li>
<li>
<div align="left"><a href="#general">generalidades</a></div>
</li>
<li>
<div align="left"><a href="#teor">fundamentacion
teorica</a></div>
</li>
<li>
<div align="left"><a href="#exper">experimentaci�n</a></div>
</li>
<li>
<div align="left"><a href="#resul">resultados</a></div>
</li>
<li>
<div align="left"><a href="#discu">discusi�n</a></div>
</li>
<li>
<div align="left"><a href="#refer">referencias
electronicas</a></div>
</li>
<li>
<div align="left"><a href="#anex">anexos </a></div>
</li>
</ul>
<p> </p>
<p> </p>
<p>_________________________________________________________*********_____________
_____________________________________________</p>
<p align="center"><strong>introducción<a
name="intro"></a></strong></p>
<p align="center"> </p>
<p align="justify"> javadoc es una herramienta de java para generar
documentación básica para el programador a partir del código
fuente. la herramienta javadoc analiza los comentarios del código fuente y
genera con ello una documentación en formato html, en donde se encuentra la
descripción de las clases, la estructura jerárquica, los
métodos de todas las clases y sus características.</p> <p
align="justify"> la transformación de código fuente a formato html
la realiza utilizando un mecanismo extensible llamado doclet. un doclet es una
clase que es llamada por el programa javadoc para que genere la
documentación.</p>
<p align="justify"> el presente trabajo forma parte de una
investigación en donde se pretende conocer los aspectos que involucran la
implementación de la herramienta javadoc. aquí se presentará
una percepción sobre la implementación de esta tecnología y
la importancia de la misma para incrementar la calidad de los programas basados en
el lenguaje de programación java.</p>
<p align="justify"> los ejes a abordar en esta investigación
son los siguientes: en un primer capitulo analizaremos las generalidades de esta
investigación; seguidamente se presenta el segundo capitulo en donde se
presenta toda la fundamentacion teórica referente al tema de
investigación. <br>
como tercera parte se presentará la experimentación
que hace referencia a la implementación de la herramienta javadoc,
así como los respectivos resultados obtenidos. en una parte final se
presentarán las conclusiones que se formularán con el desarrollo del
tema en estudio, así como las respectivas recomendaciones que
servirán de apoyo para la mejora del tema en investigación. </p>
<p align="justify"> estos ejes se corresponden con algunos aportes y
ejemplos presentados.</p>
<p align="right"><a href="#indice">�ndice</a></p>
<p align="right"> </p>
<p align="center"><strong><u>i. generalidades<a
name="general"></a></u></strong></p>
<p align="justify"> </p>
<p align="justify"><strong>1.1. estado del problema</strong></p>
<p align="justify">documentar el código de un programa es
añadir suficiente información como para explicar lo que hace, punto
por punto, de forma que todos entiendan qué están haciendo y por
qué. <br>
documentar un programa es una necesidad que sólo se aprecia en su
debida magnitud cuando hay errores que reparar o hay que extender el programa con
nuevas capacidades o adaptarlo a un nuevo escenario.<br>
la investigación e implementación de la herramienta javadoc en
los programas ha permitido responder a interrogantes como lo son : <br>
¿de qué se encarga una clase? <br>
¿qué hace un método? <br>
¿cuál es el uso esperado de un método? <br>
¿para qué se usa una variable? <br>
¿cuál es el uso esperado de una variable?<br>
¿qué algoritmo estamos usando? ¿de dónde lo hemos
sacado? <br>
¿qué limitaciones tiene el algoritmo? ¿... la
implementación? <br>
¿qué se debería mejorar ... si hubiera tiempo? </p>
<p align="justify"><strong>1.2. objetivos</strong></p>
<p align="justify">entre los objetivos de esta investigación,
podemos enunciar los siguientes:</p>
<div align="justify">
<ul>
<li> orientar la investigación hacia la
consecución de metas. </li>
<li>conocer el funcionamiento y aplicación de la
herramienta javadoc.</li>
<li> determinar los beneficios que se pueden obtener con la
implementación de la herramienta javadoc.</li>
</ul>
<p><strong>1.3. alcance</strong></p>
<p> el trabajo presentado a continuación es un estudio
sobre la herramienta para la documentacion de programas en java, javadoc, que
abarca desde la definición de sus conceptos hasta su aplicación en
un ejemplo práctico, en el mismo veremos como esta poderosa herramienta nos
permite generar la correspondiente documentacion para nuestas aplicaciones. </p>
<p> este trabajo contiene la siguiente documentacion:</p>
<ul>
<li> que es javadoc</li>
<li>elementos de comportamiento</li>
</ul>
<p><strong>1.4. metodología</strong> </p>
<p>el tipo de estudio de investigación es descriptivo, ya
que el tema se centra en describir como se implementa javadoc en la generacion de
documentacion de programas.</p>
<p> en esta etapa se realizarán consultas
bibliográficas relacionadas con el análisis e implementacion de esta
herramienta, con el fin de obtener los resultados previstos. <br>
<br>
</p>
</div> <p align="right"><a
href="#indice">�ndice</a></p>
<p align="right"> </p>
<p align="center"><u><strong>ii. fundamentación
teórica<a name="teor"></a></strong></u></p>
<p align="center"> </p>
<p align="justify"><strong>2.1. javadoc</strong></p>
<p align="justify">el paquete de desarrollo java incluye una
herramienta de software, javadoc, para generar la documentación del api, en
formato html, del código fuente de java. <br>
la mayoría de los entornos de desarrollo integrados generan
automáticamente la documentación en formato html. javadoc
también proporciona un api para crear doclets y taglets, que permite que
analices la estructura de una aplicación java. </p>
<p align="justify">esta herramienta toma en consideración
algunos comentarios para generar una documentación bien presentada de
clases y componentes de clases (variables y métodos).</p>
<p align="justify">se dice que javadoc se centra en la interfaz (api
- application programming interface) de las clases y paquetes java.</p>
<p align="justify">javadoc realza algunos comentarios, de los que
exige una sintaxis especial. deben comenzar por "/**" y terminar por
"*/", incluyendo una descripción y algunas etiquetas
especiales:</p>
<p align="justify"><br>
<span class="estilo4">/**<br>
* parte descriptiva.<br>
* que puede consistir de varias frases o párrafos.<br>
*<br>
* @etiqueta texto específico de la etiqueta<br>
*/</span></p> <p align="justify">estos comentarios especiales
deben aparecer justo antes de la declaración de una clase, un atributo o un
método en el mismo código fuente. en las siguientes secciones se
detallan las etiquetas (tags) que javadoc sabe interpretar en cada uno de los
casos. <br>
como regla general, hay que destacar que la primera frase (el
texto hasta el primer punto) recibirá un tratamiento detacado, por lo que
debe aportar una explicación concisa y contundente del elemento
documentado. las demás frases entrarán en detalles. </p>
<p align="justify"><strong>2.2. documentación</strong></p>
<div align="justify">
<blockquote>
</blockquote>
</div> <blockquote><p align="justify"><em>2.2.1. clases e
interfaces</em> </p>
<p align="justify">deben usarse al menos las etiquetas:</p>
<div align="justify">
<ul>
<li>@autor</li>
<li>@version</li>
</ul>
</div>
<p align="justify">a continuacion se muestran todas las etiquetas y su
interpretación:</p>
<div align="justify">
<ul>
<li> @autor nombre del autor</li>
<li> @versión identificación de la versión y
fecha </li>
<li> @see referencia a otras clases y métodos</li>
<li> @since indica desde qué versión o fecha existe
esta clase o interfaz en el paquete</li>
<li>@deprecated esta clase no debería usarse pues puede
desaparecer en próximas versiones </li>
</ul>
<blockquote>
<p>veámos un ejemplo del comentario de una clase:</p>
<p class="estilo4">/**<br>
* a class representing a window on the screen.<br>
* for example:<br>
* <pre><br>
* window win = new window(parent);<br>
* win.show();<br>
* </pre><br>
*<br>
* @author sami shaio<br>
* @version %i%, %g%<br>
* @see java.awt.basewindow<br>
* @see java.awt.button<br>
*/<br>
class window extends basewindow {<br>
...<br>
}</p>
</blockquote>
</div>
<p align="justify"><em>2.2.2. constructores y métodos</em></p>
<p align="justify">deben usarse al menos las etiquetas</p>
<div align="justify">
<ul>
<li> @param: una por argumento de entrada</li>
<li> @return: si el método no es void</li>
<li> @exception: una por tipo de exception que se puede
lanzar</li>
</ul>
</div>
<p align="justify">a continuacion se muestran todas las etiquetas y su
interpretación</p>
<div align="justify">
<ul>
<li>@param : nombre del parámetro - descripción de
su significado y uso </li>
<li>@return : descripción de lo que se devuelve </li>
<li>@exception : nombre de la excepción - excepciones que
pueden lanzarse </li>
<li>@since : indica desde qué versión o fecha existe
este constructor o método en la clase </li>
<li>@deprecated : este método no debería usarse pues
puede desaparecer en proximas versiones </li>
</ul>
<p>un ejemplo:</p>
<p class="estilo4">/**<br>
* returns the character at the specified index. an index<br>
* ranges from <code>0</code> to <code>length() -
1</code>.<br>
*<br>
* @param index the index of the desired character.<br>
* @return the desired character.<br>
* @exception stringindexoutofrangeexception if the index is not in
the<br>
range <code>0</code><br>
* to <code>length()-1</code>.<br>
* @see java.lang.character#charvalue()<br>
*/<br>
public char charat(int index) {<br>
...</p>
<p class="estilo4">}</p>
<p><em>2.2.3. comentario de variables</em></p>
<p>las etiquetas que podemos utilizar en esta ocasión son:</p>
<ul>
<li>@see</li>
<li>{@link</li>
<li>@since</li>
<li>@deprecated</li>
<li>@serial</li>
<li>@serialfield</li>
</ul>
<p>un ejemplo:</p>
<p class="estilo4">/**<br>
* the x-coordinate of the component.<br>
*<br>
* @see #getlocation()<br>
*/<br>
int x = 1263732;</p>
</div>
<blockquote><p align="justify"> </p>
</blockquote>
</blockquote>
<p align="right"><a href="#indice">�ndice</a></p>
<p align="right"> </p>
<p align="center"><u><strong>iii. experimentación<a
name="exper"></a></strong></u></p>
<p align="justify">en esta fase presentaremos un ejemplo que consiste en
la experimentacion de un ejemplo al cual le aplicamos la herramienta javadoc el
cual nos permitirá generar la respectiva documentacion referente al codigo
del programa.</p>
<p align="justify">para ejecutar el archivo puede acceder a la siguiente
direccion en donde se encuentra el archivo ejecutable java <a
href="http://esnips.com/web/monografiajavadoc
">http://esnips.com/web/monografiajavadoc </a></p>
<p align="justify">el nombre del archivo es : <em>fase de experimentacion
y resultados</em> </p> <p align="left"> </p>
<p align="left"> </p>
<p align="center"> </p>
<p align="center"> </p>
<p align="right"><a href="#indice">�ndice </a></p>
<p align="right"> </p>
<p align="center"><u><strong>iv. resultados<a
name="resul"></a></strong></u></p>
<p align="center"> </p>
<p align="left"><strong>4.1. presentacion de resultados</strong></p>
<p align="justify">a continuación se presentan los resultados
obtenidos de los ejemplos presentados.</p>
<p align="justify">para acceder a la documentacion generada por la
herramienta javadoc acceda al siguiente enlace: <a
href="http://esnips.com/web/monografiajavadoc">http://esnips.com/web/monografiajav
adoc</a> </p>
<p align="justify">el nombre del archivo es <em>empresa.java</em></p>
<p align="justify"> </p>
<p align="center"> </p>
<p align="right"><a href="#indice">�ndice</a></p>
<p align="right"> </p>
<p align="center"><u><strong>v. discusión<a
name="discu"></a></strong></u></p>
<p align="center"> </p>
<p align="left"><strong>5.1. conclusiones </strong></p>
<p align="justify">como conclusion podemos decir que que este tipo de
investigaciones orientan al estudiante a conocer nuevas metodologias y
herramientas referentes a la programacion, con lo que se adquiere un gardo de
conocimiento mas desarrollado, dependiendo del empeño y esfurzo que se
imponga en el trabajo.</p>
<p align="justify">la elaboracion de este trabajo nos ha incitado a
profundizar mucho mas en el estudio de este lenguaje, ya que es muy amplio, y
exije un esfurzo muy grande, para adquirir todo el conocimiento referente a la
programacion java. </p>
<p align="left"><strong>5.2. recomendaciones</strong></p>
<p align="justify">entre las recomendaciones que podemos mencionar
tenemos:</p>
<div align="justify">
<ul>
<li>que siempre que se diseñe una aplicacion java , seria
de muy buena practica, utilizar esta herramienta javadoc, ya que nos da una
ventaja a la hora de generar la documentacion de nuestro codigo.</li>
<li>tambien podriamos decir que se recomienda ampliar la
fase investigativa y de analisis de este trabajo, ya que la aplicacion de este
tipo de herramientas rquieren un estudi mas extenso. </li>
</ul>
</div> <ul>
</ul> <ul>
</ul> <ul>
</ul> <p> </p>
<p> </p>
<p align="center"> </p>
<p align="right"><a href="#indice">�nicio</a></p>
<p align="right"> </p>
<p align="center"><u><strong>vi. referencia electronica<a
name="refer"></a></strong></u></p>
<p align="left"><strong>documentacion javadoc</strong></p>
<p align="justify">excelente pagina que contiene un detallado manual con
informacion referente a la generacion de documentacion de los programas java,
utilizando la herramienta javadoc. en esta pagina se decribe paso a paso todo el
procedimiento de generacion de documentacion. </p>
<p align="justify">documentacion con javadoc [en linea] : adictos al
trabajo.<u><a
href="http://www.adictosaltrabajo.com/tutoriales/tutoriales.php?pagina=javadoc">ht
tp://www.adictosaltrabajo.com/tutoriales/tutoriales.php?pagina=javadoc</a></u> [12
diciembre 2006] .</p>
<p align="left"> </p>
<p align="left"><strong>javadoc tool</strong></p>
<p align="justify">muy buena pagina de los creadores de java, sun
microsystem. contiene mucha informacion y enlaces ,con respecto a la herramienta
javadoc. en esta pagina podemos encontrar informacion sobre las especificaciones
para escribir comentarios en java, asi como la implementacion de esta herramienta.
se las recomiendo ya que es muy interesante, su unico inconveniente es que solo se
encuentra en ingles. </p>
<p align="justify">javadoc tool [en linea]. sun developer network. <u><a
href="http://java.sun.com/j2se/javadoc/">http://java.sun.com/j2se/javadoc/</a></u>
<strong> . </strong>[12 diciembre 2006] </p> <p align="left"> </p>
<p align="left"> </p> <p align="center"> </p>
<p align="center"> </p>
<p align="right"><a href="#indice">�nicio</a></p>
<p align="right"> </p>
<p align="center"><u><strong>vii. anexos<a
name="anex"></a></strong></u></p>
<p align="left"><strong>glosario</strong></p>
<p align="justify"><strong>javadoc</strong>:
una etiqueta es una marca que se deja en un texto para que el interpretador
digaque debe realizar alguna acción sobre ese texto que este marcado. </p>
<p align="justify"><strong>sentencia</strong>: es