• Saltar a la navegación principal
  • Saltar al contenido principal

CARLOSZR.COM

Mi blog personal, CarlosZR

  • Blog
  • Contacto
  • Curso de SwiftUI por CarlosZR

Java / 17/11/2019

Comentarios en Java

Los comentarios tienen gran importancia para describir lo que hace un programa.

Por mucho que implementemos un buen código y lo mejoremos con revisiones, la tarea se hará más difícil si el código fuente no está bien documentado.

Los comentarios en Java pueden ser de tres tipos diferentes:

  • Comentarios de una sola línea. Se utiliza la barra doble // y posteriormente escribimos el comentario. Lo podemos hacer sobre la línea de código que queremos comentar o justo al lado. Ejemplo de comentario de una línea.
String nombre; // Variable para el nombre del cliente
  • Comentarios de múltiples líneas. Es cuando comentamos varias líneas. Se usa para comantarios más largos. Se comienza con barra inclinada y asterisco (/*) y se termina con (*/). Veamos un ejemplo de varias líneas comentadas.
String nombre; /* Aquí todas las demás variables para los datos del cliente incluyendo el DNI */
  • Comentarios Javadoc. Aquí los delimitadores que vamos a usar son /** y */. Al igual que el resto de comentarios, el texto que se haya generado entre estos delimitadores no lo tendrá en cuenta el compilador.
/** Comentario de documentación. Javadoc extrae los comentarios del código y genera un archivo html a partir de este tipo de comentarios */

Veamos un ejemplo donde usamos comentarios Javadoc:

comentario javadoc
Ejemplo de comentario Javadoc

En este ejemplo de Javadoc hemos usado dos etiquetas o anotaciones. Veamos que significan.

  • @author. Nombre del desarrollador.
  • @version. En este caso es la versión de la clase.

Hay muchas más. Con ayuda del entorno de desarrollo que estés usando puedes ver todas las disponibles.

Etiquetas Javadoc en Eclipse
Vista de las etiquetas Javadoc de Eclipse.

No olvidemos una cosa. Los comentarios en Java son una ayuda para entender el código. Es muy importante hacer un código legible. Tienen que preocuparte dos cosas.

  • Que en el futuro alguien pueda entender el código gracias a unos buenos comentarios.
  • Que en el futuro tú puedas entender el código gracias a unos buenos comentarios.

Por muy raro que te parezca, te puedes perder. Cuando retomas un proyecto después de un tiempo puede ser difícil recordar lo que hacía.

Recuerda que todos los lenguajes de programación tienen comentarios. Puede habar similitudes, pero cada uno los implementa a su modo particular.

Si te he sido de ayuda, déjame un «comentario», jeje.

Publicado en: Java Etiquetado como: programación

Interacciones con los lectores

Deja una respuesta Cancelar la respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

Carlos ZR

  • Sígueme en Twitter
  • Política de Cookies
  • Política de Privacidad
  • Aviso Legal

Utilizamos cookies para ofrecerte la mejor experiencia en nuestra web.

Puedes aprender más sobre qué cookies utilizamos o desactivarlas en los ajustes.

CARLOSZR.COM
Powered by  GDPR Cookie Compliance
Resumen de privacidad

Esta web utiliza cookies para que podamos ofrecerte la mejor experiencia de usuario posible. La información de las cookies se almacena en tu navegador y realiza funciones tales como reconocerte cuando vuelves a nuestra web o ayudar a nuestro equipo a comprender qué secciones de la web encuentras más interesantes y útiles.

Cookies estrictamente necesarias

Las cookies estrictamente necesarias tiene que activarse siempre para que podamos guardar tus preferencias de ajustes de cookies.

Si desactivas esta cookie no podremos guardar tus preferencias. Esto significa que cada vez que visites esta web tendrás que activar o desactivar las cookies de nuevo.