jueves, 24 de febrero de 2011

jueves, 17 de febrero de 2011

Documentación y herramientas de desarrollo


Documentación y herramientas de desarrollo - Taller

hola en esta entrada ahora mostrare el resultado de la documentación con javadoc.

Recordando que para poder crear la documentación con el entorno de desarrollo Eclipse es muy sencillo solo se tiene que ir ala pestaña "Project" después se muestra un menu donde seleccionas la opción de "Generate Javadoc" y despues "finish".

Bueno aquí les dejo una tablas con algunas etiquetas:
TagDescripciónUsoVersión
@authorNombre del desarrollador.nombre_autor1.0
@deprecatedIndica que el método o clase es antigua y que no se recomienda su uso porque posiblemente desaparecerá en versiones posteriores.descripción1.0
@paramDefinición de un parámetro de un método, es requerido para todos los parámetros del método.nombre_parametro descripción1.0
@returnInforma de lo que devuelve el método, no se puede usar en constructores o métodos "void".descripción1.0
@seeAsocia con otro método o clase.referencia (#método(); clase#método(); paquete.clase; paquete.clase#método()).1.0
@throwsExcepción lanzada por el métodonombre_clase descripción1.2
@versionVersión del método o clase.versión1.0



Bueno y aquí les dejo unas capturas de pantalla de mi proyecto y sus clases con la parte de la documentación:



Bueno y aquí les dejo unas capturas de como quedo la documentación ya en el explorador wen en HTML junto con CSS los archivos que genera automaticamente con javadoc.




Espero y les aya gustado un saludo a todos...

Documentación y herramientas



Documentación y herramientas - Clase

Hola que tal esta entrada trata acerca de la documentación y las herramientas que se pueden utilizar para documentar nuestros métodos clases de nuestro proyecto.

Bueno la idea de esta entrada es explicar el por que es bueno usar la documentación es bueno porque documentemos nuestro trabajo por que puede ser útil para otra persona o para nosotros mismo también es importante por que en un futuro nos puede servir de referencia para utilizarlas.

Bueno para todo esto existe Javadoc es una utilidad de Sun Microsystems para la generación de documentación de APIs en formato HTML a partir de código fuente Java. Javadoc es el estándar de la industria para documentar clases de Java. La mayoría de los IDEs los generan automáticamente.
Javadoc también proporciona una API para crear doclets y taglets, que le permite analizar la estructura de una aplicación Java. Así es como JDiff puede generar informes de lo que ha cambiado entre dos versiones de una API.

Bueno ya que mi aplicación la estoy desarrollando en Eclipse solo basta con ir ala pestaña "Project" y se mostrara un menu donde seleccionamos la opción de "Generate Javadoc" y después "finish" y es todo con esto hemos generado la documentación.


Para poder ver la documentación se guardan los archivos en la carpeta "doc" del workspace de Eclipse.

Links:


Un saludo a todos...

martes, 15 de febrero de 2011

Avances


Presentación de temas - Clase

Hola que tal estas son las diapositivas de mi presentación explicando de lo que consiste mi proyecto espero y sea de su agrado (:






Aquí les dejo un pdf con la presentación.

Un saludo a todos...

jueves, 10 de febrero de 2011

Código - Taller

Código herencia y polimorfismo - Taller

Hola a todos en esta entrada trata de la aplicación de lo antes mencionado de lo que es la herencia y el polimorfismo ya codificado y también explica las relaciones de herencia utilizadas en mi proyecto.

Bueno esta es la clase Resistor que es la clase padre de todas las de mas clases.

package resistencias;

public class Resistor() {

// Explicado en la nota de la entrada de la clase
// de herencia y polimorfismo
}

Esta es la clase Colors que hereda de la clase padre Resistor

public class Colors(){

protected int black;
protected int brown;
protected int red;
//etc.

}
Entonces como vemos la clase Colors es hija de la clase Resistor por que hereda ya que la clase Resistor es la clase padre.

Bueno la clase CheckC hereda de la clase Colors y la clase Colors heredo de la clase padre Resistor.

public class CheckC extends Colors(){
// Metodos
// dibuja la resistencia dependiendo del
// valor de ohms de la resistencia.
}
Bueno pero en el caso de la clase Graphics esa clase hereda de la clase padre Resistor.

package resistencias;

public class Graphics(){
// Metodos de la interfaz grafica
// botones, tipo de ventana etc.
}
Y las demás clases como CheckV y PaintR también son hijas de la clase Colors.

package resistencias;

public class CheckV extends Colors (){
// Metodos
}

package resistencias;

public class PaintR extends Colors (){
// Metodos
}
Bueno esto es todo (:

Un saludo a todos...


martes, 8 de febrero de 2011

Herencia y polimorfismo


Herencia y polimorfismo - Clase

Hola a todos en esta entrada trata de una descripción textual y también explica las relaciones de herencia utilizadas en mi proyecto.
Bueno primero seria explicar que es herencia

Herencia en programación orientada a objetos la herencia es el mecanismo fundamental para implementar la reutilización y extensibilidad del software. Es la relación entre una clase general y otra clase más especifica.

Un ejemplo de herencia sería si declaramos una clase párrafo derivada de una clase texto, todos los métodos y variables asociadas con la clase texto, son automáticamente heredados por la subclase párrafo.

Y en polimorfismo se refiere a la capacidad para que varias clases derivadas de una antecesora utilicen un mismo método de forma diferente.

Bueno en mi proyecto yo utilice la herencia en la clase padre Resistor 'Agregada recientemente' y de esa clase hereda la clase Colors de la cual hereda los métodos y sus atributos a las clases CheckC, CheckV, PaintR.
  • En la clase Colors hereda la clase CheckC con sus atributos y métodos.
  • En la clase Colors hereda la clase CheckV con sus atributos y métodos.
  • En la clase Colors hereda la clase PaintR con sus atributos y métodos.
  • En la clase Resistor hereda la clase Graphics con sus atributos y métodos.
Bueno y todo esto hereda de la clase padre llamada Resistor.

Nota: En realidad la clase padre Resistor fue creada recientemente porque en realidad este es un proyecto en el cual me gustaría trabajar un tiempo incluso después de terminar el semestre e iré agregando mas opciones no solo de resistencias para intentar hacerlo un software mas completo de electrónica para eso agrege la clase Resistor para aprovechar de una vez lo que es la herencia y el polimorfismo para ir complementando la aplicación a futuro ya que mi objetivo en el proyecto es solo realizar el calculador de las resistencias.

Un saludo a todos ...

miércoles, 2 de febrero de 2011

Sintaxis de clases

Sintaxis de clases: métodos, atributos - Taller

Bueno estas son las clases que comente en la entrada anterior ya en código.

Todo estará contenido en el package resistencias.

Esta clase será que dependiendo del orden de las bandas de colores y dependiendo de los colores que tenga la banda será el valor de la resistencia.

package resistencias;

public class Colors(){

// Atributos serán los colores ósea los tipos
// De colores que se manejan en el código.

protected int black;
protected int brown;
protected int red;
//etc.

// Métodos
public void CheckC(){

// Calcula el valor de la resistencia
// Dependiendo el código de colores.
return;
}
}


Esta clase será que dependiendo el valor de la resistencia que tengas te diga el código de colores de la resistencia en el orden de las bandas.

package resistencias;

public class Values(){

// Métodos
public void CheckV(){

// Dibuja la resistencia dependiendo del
// Valor de ohm de la resistencia.
return;
}
}


Esta clase será manejar todo lo que es la interfaz grafica de la aplicación tanto como de botones como la opción de que se dibujara la resistencia dependiendo del valor de la resistencia que se haya introducido en la aplicación.

package resistencias;

public class Graphics(){
// Métodos de la interfaz gráfica
// Botones, tipo de ventana etc.
}


Bueno esto es todo un saludo a todos...