Buenas practicas de programación [4]

La entrada del día de hoy es corta pero importante, se trata de la declaración un tema muy importante.

Este tema comprende:

+El numero de declaraciones por linea, es recomendado hacer solo una declaración por linea, ejemplo:

int edad; // Edad del estudiante
int nombre; // Nombre del estudiante

Es preferible sobre

int edad, nombre;

Lo que si se debe evitar a toda costa es declarar diferentes tipos de atributos:

int edad, calificaciones [];

+Inicialización: todas las variables deben ser inicializadas a no ser que dependan de un calculo que ya ha ocurrido.

+Se deben colocar las variables locales después de la inicialización del bloque de código(un bloque de código inicia con un "{"), ejemplo:

public void calcularEdad(){
      int edad = 0;
   
     if(condición){
     int aux = 0;
     }
}

Una cosa para evitar es declarar variables locales con nombres iguales a variables de alto nivel, ejemplo:

int contador = 0;

public void calcularCalificacion(){
     if(condicion){
     int contador = 0;
     }
}

+ Cuando se declaran los métodos hay que evitar espacios entre el nombre del método y el paréntesis "(" .
+ Es recomendable separar los métodos por una linea en blanco.
+ Los corchetes se ubican: El primero "{" en la misma linea de la declaración y el de cerrar "}" en una linea aparte.

Pagina recomendada [3]

Un objetivo común debería ser que nuestras aplicaciones luzcan bien, para ello el manejo de los colores es muy importante, por ello hoy les recomiendo HTML Color Code.

HTML Color Code es una excelente pagina para usar los colores HTML de una forma muy gráfica, la pagina permite un uso muy intuitivo.

Esta dividida en dos categorías:

"Tabla de colores", para seleccionar los colores de un cuadro.

"Selector de colores" que permite crear nuestro color o buscar un color ya sea por código HTML o por codigo RGB.

Muy útil, recordemos algo de uso de color en java.

Queremos usar el color #013ADF

new Color(0x013ADF);

El RGB es 1, 58, 223.

new color (int r, int g, int b);
new color (1, 58, 223);

No olviden visitar HTML Color Code, a mi me sirvió mucho espero que a uds también.

Buenas practicas de programación [3]

Lineas y espacios en blancos, aunque para algunos este tema no tiene importancia, hace parte de la estética y el orden en el código, saber usar estos elementos permite tener un código más legible y ordenado.

Lineas en blanco:

Una linea:

* Entre métodos
* Entre variables locales en un método y su primera declaración
* Después de un comentario
* Entre secciones lógicas de un método, para que sea más fácil leerlo y entenderlo(si tienes muchos puede indicar que deberias dividir el método).

Dos lineas:

* Entre secciones de un archivo fuente
* Entre definiciones de clases e interfaces

Espacios en blanco:

- Después de una de las palabras reservadas (de las que ya hablamos) que este seguida por un paréntesis.

   if () {
   }

- Cuando se tiene una lista de elementos separados por comas después de cada coma debe haber un espacio.

   String [] lista = new String [] {"Hola", "Mundo", "?"};

- Todos los operadores binarios excepto el (.) deben ser separados de sus operandos con espacios. Los únicos que no se separan son los operadores de incremento y decremento (++ y --).

a += c - b;

a = (c + b) * (x - y);

if (a++ == b--) {
}

- En los for entre sus condiciones e incremento, recuerden:

for (int i = 0; i < lista.length; i++) { }

- En las conversiones ("cast").

metodo((int) (salario + 5));

Yo también ignoraba estas buenas practicas, pero ahora no soporto ver un código sin ellas, un consejo es irlas implementado de a poco en su código, así no se complican.

Buenas practicas de programación [2]

Hoy vamos a hablar de documentación, tema demasiado importante y que siempre se deja de lado.

Siempre sucede lo mismo, como generalmente desarrollamos solos, no nos interesa que otros lean nuestro código, pero en el sector productivo es muy importante el trabajo en equipo y por lo tanto la documentación,  tenemos que pensar que nuestro código sera una parte del producto final y que no va a ser una pieza asilada.

Para documentar un método se pueden tener en cuenta 6 partes.

1. Nombre completo del método. 
2. Propósito del método. 
3. Descripción del método. 
4. Autor original. 
5. Modificaciones que se le han hecho. 
6. Autores que realizan las modificaciones.

Además es necesario mencionar si existe algún problema con el método, explicar brevemente las entras y salidas.

Otra recomendación es usar un lenguaje sencillo pero utilizando términos técnicos. También evitar comentarios obvios, comentar los sets y gets. Por ultimo es recomendable agrupar las notas, a no ser que sea una anotación muy importante para una linea.

Ah se me olvidaba un buen ejercicio es documentar en ingles por obvias razones.

Pagina recomendada [2]

Nombre: TechOnTheNet.

Descripción: Una nueva semana una nueva pagina recomendada, esta vez hablo de TechOnTheNet.com una excelente pagina llena de interesantes recursos.

En esta pagina no solo encontraremos tutoriales de diferentes lenguajes de programación, lo más importante es su sección de "chuletas", que vienen a ser la explicación de funciones (para la suite MS Oficce, Oracle SQL/Pl, SQL Linux, entre otros) con ejemplos muy sencillos de comprender.

Muy recomendad cuando se inicia a trabajar con bases de datos.

No se olviden de visitar http://www.techonthenet.com/index.php y de recomendarnos otras paginas en sus comentarios.

Buenas practicas de programación [1]

Para programar correctamente hay que seguir algunos consejos, que no solo hace que los programas sean más eficientes sino que tambien permiten mejorar la presentación del código y hacerlo más fácil de entender.

Estos consejos son denominados oficialmente "buenas practicas en programación", la idea es ir recopilando estos consejos, así que vamos con el primero.

Algo muy importante son los nombres, llamados identificadores, a la hora de nombrar un elemento (ya sea clase, atributo o método), es necesario ser muy claros.

Hay que evitar nombrar un elemento como "a" o "variable", estos nombres son ambiguos y no dan una idea de lo que son, nombres más claros serian "Carro" o "numeroEstudiantes", estos nombre si dan una idea clara   de la naturaleza del elemento.

Hay que evitar usar símbolos y palabras reservadas, estas palabras son propias del lenguaje de programación (en este caso Java) y no se deben usar.

abstract	boolean	break	byte	case	catch
char	class	const	continue	default	do
double	else	extends	final	finally	float
for	goto	if	implements	import	instanceof
int	interface	long	native	new	package
private	protected	public	return	short	static
strictfp	super	switch	synchronized	this	throw
throws	transient	try	void	volatile	while
assert	enum

Por otra parte para nombrar elementos de programación en Java hay que tener en cuenta los siguientes consejos.

- Para clase: la primera letra en mayúscula y luego usar notación camelCase (primera letra de cada palabra en mayúscula), los nombres deben ser sustantivos y estar en singular.

-Para interfaces: aplica lo mismo que clases excepto que los nombres deben ser adjetivos.

-Para métodos:  la primera letra en minúscula y luego usar notación camelCase, los nombres deben ser o un verbo o una mezcla de verbo y sustantivo.

-Para variables: la primera letra en minúscula y luego usar notación camelCase, deberían ser nombres con significados claros y en lo posible corto.

- Las constantes: en este caso todas las letras deben estar en mayúscula y se debe separar cada palabra con un "_".

Con este consejo ya sera más fácil entender su código, no es lo mismo ver la variable "x" que la variable "nombreUsuario".

Pagina recomendada [1]

Nombre: java2s

Descripción: Esta pagina contiene información de muchas cosas relacionadas con la programación, pero lo mas importante es que contiene la explicación de como usar diferentes clases, métodos y librerías, lo mejor es que se explica usando ejemplos del funcionamiento de cada método, el código es muy claro y generalmente esta documentado.

Aunque su interfaz no es la mejor, cumple su cometido, para entender mejor como funciona, veamos un ejemplo, queremos buscar como colocar un icono a un botón en Java:

1. Se selecciona el lenguaje de programación.

2. Se selecciona la clase de la que se quiere más información.

3. Se selecciona el método.

4. Se obtiene el código que necesitamos.

No se olviden de visitar http://www.java2s.com/ y de recomendarnos otras paginas en sus comentarios.