Vamos a actualizar nuestra Política de privacidad próximamente. Te recomendamos consultar el avance.

Java avanzado: Buenas prácticas

Cómo crear comentarios en Java y cómo manejarlos

¡Prueba gratis durante 10 días

nuestros 1290 cursos !

Prueba gratis Mostrar modalidades de suscripción
Crearemos algunos comentarios para ver las diferentes posibilidades que tenemos a la hora de realizarlos y cómo podemos aprovechar al máximo la utilización de los comentarios dentro del código. Aprenderemos las dos posibilidades disponibles para poder crearlos.

Transcripción

Veamos en qué consisten los comentarios pero sobre todo, orientado a las buenas prácticas. Comenzaré diciendo que los comentarios pueden parecer sin importancia, pero en realidad, son una fuente de apoyo valiosísima para el desarrollo y, sobre todo, para la comunicación, no solamente entre programadores, sino también entre programa y desarrollador. ¿Por qué? Porque podemos dejar una huella, un mensaje o algo que le vaya a servir a las personas o al equipo de desarrollo que van a retomar ese proyecto, a lo mejor, más adelante. Lo primero es que vamos aquí a ver las dos formas rápidas y breves de colocar comentarios. Lo primero es poner // (doble diagonal) y puedes poner, en este caso, aquí cualquier texto en donde estoy colocando el guión. Después, otra forma para colocar un bloque es poner /* (diagonal asterísco) das varios "enters", dependiendo del tamaño que tu quieras de código, y cuando terminas se coloca de manera automática un asterisco diagonal. ¿Esto qué es? Esto es el fin del bloque de comentarios y esto es el inicio del bloque de comentarios. Tú decidirás cuál quieres utilizar. En este caso, este bloque es acostumbrado para una línea y este bloque es para más de una línea. Esto, digamos, que es el funcionamiento básico. Entonces, ¿qué es lo que va a suceder? A veces, cuando estamos en pequeños bloques del código, por ejemplo, vamos a escribir uno, vamos a escribir aquí, un "If", abrimos paréntesis por ejemplo, preguntamos si 1 es mayor a 10, y abrimos llaves y cerramos. Aquí adentro, si quisiéramos tener una instrucción que explique qué es lo que estamos haciendo aquí porque solamente vemos un 1 y un 10 pero no sabemos qué significa el 1 ni qué significa el 10 ni mucho menos para qué lo estamos haciendo. No es muy clara la instrucción. Entonces, lo que podemos hacer es colocarnos en donde inicia la instrucción, dar un "Enter", es decir, dejar un espacio y arriba, colocar un comentario que lo que haga sea describir lo que he comentado, es decir, un comentario que nos diga por qué tenemos esa condicional, por qué estamos evaluando el 1 y por qué estamos evaluando con el 10. Eso es algo recomendable de hacer, y sobre todo cuando suceden este tipo de cosas, donde el 1 no nos dice mucho, y el 10 nos dice igual o menos. Entonces, es buena idea poner un comentario ahí. Normalmente, los comentarios donde están escritos, es porque lo que viene a continuación es en realidad lo que estamos explicando. Por eso, se recomienda colocar ahí, no debes de colocar una explicación nunca por debajo, porque se da por hecho que cuando alguien escribe un comentario, lo que viene es lo que estás explicando. Así que siempre se explica antes que ejecutar, esa sería, digamos, la parte lógica, y por lo tanto, no lo vas a hacer así. Y también existe una forma más, vamos a colocar aquí, por ejemplo, una impresión... en la consola, bueno, en lo que tenemos aquí abajo que es la consola, podemos ver aquí... vamos a ponerle acá... Sí, supongamos que queremos imprimir la palabra "Sí". A veces esta línea, como está adentro de otro bloque, para explicar podemos colocarnos a un lado y dar aquí una explicación, colocar el asterisco diagonal y listo. Si tú quieres colocar mejor, porque bueno... se te acomoda más la doble diagonal, tampoco pasa nada, puedes utilizar las dos combinaciones, pero si te das cuenta, esta línea únicamente está explicando en teoría lo que sucede aquí y esta línea estaría explicando todo el bloque, así que depende de cómo coloques tus comentarios como se debe de interpretar.

Java avanzado: Buenas prácticas

Aprende a dirigir tu código del mejor modo con conceptos importantes en Java, útiles para todo profesional, y conoce a detalle la mejor forma de llevarlos a cabo en tu trabajo.

3:08 horas (39 Videos)
Actualmente no hay comentarios.
 
Software:
Fecha de publicación:30/01/2017

Este curso video2brain está disponible como descarga y para ser visualizado online. ¡Pero no hace falta que decidas entre las dos opciones! Al comprar el curso, disfrutarás de ambas posibilidades.

La descarga te permite ver las lecciones sin estar conectado/a a internet y supone una navegación fácil y ágil entre capítulo y capítulo. Si vas a trabajar en diferentes ordenadores o si no quieres descargarte el curso completo, entra en la web con tus datos de acceso y disfruta directamente de tus vídeos online. Te deseamos que disfrutes de este curso y te resulte de mucha utilidad.

Estamos a tu disposición si tienes cualquier tipo de duda o pregunta.