Documentación de librería Report en Java SE

Contenido del curso

Introducción al Curso

1
Java SE Avanzado: Programación Modular y Persistencia con JDBC
03:17 min

Clases avanzadas

JavaDocs

Clases Anidadas

Interfaces Avanzadas

Colecciones Avanzadas

21
Implementaciones y uso de Map en Java
01:42 min

Excepciones

JDBC

Lambdas

Fin del Curso

40
Programación Avanzada en Java: Clases e Interfaces
01:30 min

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

Ahora que ya conoces las tags y su uso para documentar, te pongo el siguiente reto que consiste en general la documentación para librería Report, que creamos en el Curso Básico de Java SE el proyecto lo encuentras aquí: https://github.com/anncode1/JavaSEBasico/tree/26.EscribirArchivos

Genera la librería documentada e implementala en el proyecto. Compártenos pantallazos de qué etiquetas usaste y cómo se ve ahora.

Documentación de librería Report en Java SE

Curso Avanzado de Java SE

Clase 8 de 40

Clase 8 / 40

José Francisco Casales Huerta

Hace 8 años

Asi quedo mi libreria documentada

package com.codecasales.makereport;

import java.io.BufferedWriter;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStreamWriter;

/**
 * <h1>Make Report</h1>
 * Clase que se encarga de escribir archivos de texto
 * <br>
 * Escribe documentos de texto a partir de los atributos {@code nameFile}, {@code title}
 * y {@code content}, donde {@code nameFile} es el nombre del archivo, {@code title} es el titulo del mismo 
 * y {@code content} el contenido de este.
 * 
 * @author Francisco Casales (codecasales)
 * @version 1.0
 * @since Enero 2019
 * */

public class Report {
	
	private String nameFile;
	private String title;
	private String content;
	private String extension;
	
	/**
	 * Metodo que obtiene el nombre del archivo a generar
	 * 
	 * @return nameFile es un objeto {@code String} con el nombre del archivo sin extencion.
	 * */
	public String getNameFile() {
		return nameFile;
	}
	/**
	 * Metodo que establece el nombre del archivo sin extencion
	 * 
	 * @param nameFile es un objeto de tipo {@code String} que contiene el nombre del archivo sin extencion.
	 * */
	public void setNameFile(String nameFile) {
		this.nameFile = nameFile;
	}
	/**
	 * Metodo que obtiene el titulo del archivo.
	 * 
	 * @return title es un objeto {@code String} con el titulo del archivo.
	 * */
	public String getTitle() {
		return title;
	}
	/**
	 * Metodo que establece el titulo del archivo sin extencion
	 * 
	 * @param title es un objeto de tipo {@code String} que contiene el titulo del archivo.
	 * */
	public void setTitle(String title) {
		this.title = title;
	}
	/**
	 * Metodo que obtiene el contenido del archivo a generar
	 * 
	 * @return content es un objeto {@code String} con el contenido del archivo sin incluir el titulo.
	 * */
	public String getContent() {
		return content;
	}
	/**
	 * Metodo que establece el contenido del archivo sin extencion
	 * 
	 * @param content es un objeto de tipo {@code String} que tiene el contenido del archivo sin titulo.
	 * */
	public void setContent(String content) {
		this.content = content;
	}
	/**
	 * <h1>Metodo makeReport</h1>
	 * Metodo que se encarga de generar los archivos .txt utilizando los datos establecidos por los setters
	 * <br>
	 * Hace una comprobacion, si {@code nameFile}, {@code title} o {@code content} son nulos no genera el archivo
	 * y le pide al usuario proporcionar los datos necesarios.
	 * */
	public void makeReport() {
		if ( (getNameFile() != null) && (getTitle() != null) && (getContent() != null) ) {
			//Crear el archivo
			try {
				
				File file = new File(getNameFile()+"."+getExtension());
				FileOutputStream fos = new FileOutputStream(file);
				OutputStreamWriter osw = new OutputStreamWriter(fos);
				BufferedWriter bw = new BufferedWriter(osw);
				bw.write(getContent());
				bw.close();
				
			} catch (IOException e) {
				// TODO Auto-generated catch block
				e.printStackTrace();
			}
			 
		} else {
			System.out.println("Ingresa los datos del archivo");
		}
	}
	/**
	 * Metodo que obtiene la extension del archivo a generar
	 * 
	 * @return extension es un objeto {@code String} con la extension del archivo 
	 * sin incluir el nombre del archivo.
	 * */
	public String getExtension() {
		return extension;
	}
	/**
	 * Metodo que establece la extension del archivo
	 * 
	 * @param extension es un objeto de tipo {@code String} que contiene la extension del archivo 
	 * sin incluir el nombre del archivo.
	 * */
	public void setExtension(String extension) {
		this.extension = extension;
	}

}

Ricardo Betancourt

Hace 7 años

Esta genial felicidades

Comentarios (90)90 comentarios

Johan Charris

Jose David Garzon

Hace 6 años

Gilberto A. Guerrero Caballero

Angelica Leung

Danner Adib Uribe

Curso 2Innovateit

Camilo Guevara

Francisco Javier Suarez Verdugo

Masrtin Gutierrez

Carlos Naveda

Hace 10 meses

Pablo Villegas Palacio

Hace un año

Jesús Alejandro Marrón Legorreta

Daniel Eduardo Espitia Corredor

Yossijaki Jorge Astilleros Chávez

Luis David López Berber

Alessandro Morales

Jhon Martinez

movigostudio movigostudio

Introducción al Curso

Java SE Avanzado: Programación Modular y Persistencia con JDBC

Clases avanzadas

Clases Abstractas y Polimorfismo en Java: Avances y Aplicaciones

Reducción de Código con Clases Abstractas en Java

Sobrescritura de métodos en clases derivadas en Java

Polimorfismo y Abstracción en Clases Java

JavaDocs

Generación de Documentación Java con Javadocs

Documentación en Java: Uso de Etiquetas y Comentarios HTML

Documentación de librería Report en Java SE

Documentación de Clases Heredadas en Java

Generación de Documentación JavaDoc en HTML

Clases Anidadas

Clases Anidadas en Java: Conceptos y Aplicaciones Prácticas

Clase Song como clase interna en Album en Java

Implementación de Clases Anidadas en Java: Ejemplo Práctico con Page y Book

Simulación de Lectura con Clases Anidadas en Java

Uso de Enumerations en Programación

Interfaces Avanzadas

Interfaces Avanzadas en Java: Métodos Default y Private

Creación de Interfaces DAO en Java para Gestión de Bases de Datos

Encapsulación y Abstracción en Diseño de APIs

Diferencias entre Clases Abstractas e Interfaces en Programación

Herencia y métodos en interfaces de Java 8 y 9

Colecciones Avanzadas

Implementaciones y uso de Map en Java

Excepciones

Manejo de Excepciones en Java: Errores Checked y Unchecked

Manejo de Excepciones en Java: Try-Catch y Try-With-Resources

JDBC

Conexión a Bases de Datos con JDBC en Java

Uso de PreparedStatement para consultas con filtros en JDBC

Configuración de phpMyAdmin y XAMPP para Bases de Datos

Conexión a MySQL usando Java JDBC: Configuración y Prácticas

Conexión y Lectura de Datos con JDBC en Java

Persistencia de Datos en Aplicaciones de Películas

Inserción y Visualización de Películas Vistas en Base de Datos SQL

Generación de Reportes Diarios con Fechas en Java

Lambdas

Modificación de tablas y manejo de fechas en MySQL

Interfaces Funcionales en Java: Conceptos y Ejemplos Prácticos

Programación Funcional: Paradigmas y Lambdas en Java

Lambdas en Java: Sintaxis y Aplicaciones Prácticas

Elementos clickeables en interfaz gráfica

Declaración de Lambdas y Recursividad en Java

Streams y Filters en Java para Optimizar Colecciones

Uso de Lambdas y Predicados en Streams Java

Fin del Curso

Programación Avanzada en Java: Clases e Interfaces

Documentación de librería Report en Java SE