Sun Code Conventions - Historial de revisiones

Admin: /* Ver también */

2012-07-30T15:23:22Z

‎Ver también

Admin: Revertidos los cambios de 209.202.9.10 (disc.) a la última edición de Admin

2012-07-30T15:22:43Z

Revertidos los cambios de 209.202.9.10 (disc.) a la última edición de Admin

209.202.9.10: Deshecha la ediciÃ³n 2971 de Admin (disc.)

2011-09-07T05:56:23Z

Deshecha la ediciÃ³n 2971 de Admin (disc.)

Admin en 18:02 26 ago 2009

2009-08-26T18:02:32Z

Admin en 14:21 18 ago 2008

2008-08-18T14:21:34Z

Admin: Página nueva: Las convenciones de codificación en Java de Sun (Sun Code Conventions) es un documento que contiene convenciones estandard que Sun recomienda seguir. Las reglas cubren nombres de arc...

2008-07-22T17:59:04Z

Página nueva: Las convenciones de codificación en Java de Sun (Sun Code Conventions) es un documento que contiene convenciones estandard que Sun recomienda seguir. Las reglas cubren nombres de arc...

Página nueva

Las convenciones de codificación en Java de Sun (Sun Code Conventions) es un documento que contiene convenciones estandard que Sun recomienda seguir. Las reglas cubren nombres de archivos, organizacion de directorios, identación, comentarios, declaraciones, sentencias, espacios en blanco, nomenclaturas, prácticas de programación e incluye un ejemplo de código.

== ¿Por qué tener una convención de codificación? ==
Las convenciones de codificación son importantes para los programadores por varias razones:
* el 80% del costo del software ocurre en el mantenimiento.
* prácticamente ningún software es mantenido toda su vida por el autor original.
* las convenciones mejoran la lectura del software, permitiendo a los ingenieros comprender el código nuevo de manera más rápida y completa.

==Clase de ejemplo==
La siguiente clase de ejemplo trata de resumir en modo concreto el uso de la reglas. No abarca todas las situaciones ni reemplaza la lectura de las convenciones, sino que sirve como un recordatorio rápido de las situaciones más comunes

<pre>
package java.blah;

import java.blah.blahdy.BlahBlah;

/**
* La descripcion de la clase va aqui.
*
* @version 1.82 18 Mar 1999
* @author Nombre Apellido
*/
public class Blah extends SomeClass {
/* Un comentario sobre la implementacion de esta clase podria ir aqui. */

/** Documentacion de la variable classVar1 */
public static int classVar1;

/**
* La documentacion de classVar2 es mas larga y compleja, y puede
* abarcar mas de una linea de esta manera
*/
private static Object classVar2;

/** Documentacion de instanceVar1 */
public Object instanceVar1;

/** Documentacion de instanceVar2 */
protected int instanceVar2;

/** Documentacion de instanceVar3 */
private Object[] instanceVar3;

/**
* ...documentacion del constructor Blah...
*/
public Blah() {
// ...la implementacion va aca...
}

/**
* ...documentacion del metodo doSomething...
*/
public void doSomething() {
// ...implementation goes here...
}

/**
* ...documentacion del metodo doSomethingElse...
* @param unParam descripcion
*/
public void doSomethingElse(Object unParam) {
// ...implementacion aca...
}

/**
* ...un metodo con ejemplos de sentencias...
*/
public void mostrarEjemplosDeSentencias() {
int maxloops = 10;
int a = 0;
int b = 0;
int c = 0;
int d = 0;

a += c + d;
a = (a + b) / (c * d);
System.out.println("el valor de a es " + a + "\n");

unMetodo((byte) a, (Object) x);

if (condition) {
statements;
} else if (condition) {
statements;
} else {
statements;
}

for (int i = 0; i < maxLoops; i++) {
statements;
}

switch (condition) {
case ABC:
statements;
/* falls through */

case DEF:
statements;
break;

case XYZ:
statements;
break;

default:
statements;
break;
}

try {
statements;
} catch (ExceptionClass e) {
statements;
} catch (OtraExceptionClass e) {
statements;
} finally {
statements;
}
}
}
</pre>

==Ver también==
* [http://java.sun.com/docs/codeconv/ Sun Code Conventions]
* [http://www.programacion.net/java/tutorial/convenciones/ Sun Code Conventions (traducido al castellano)]

← Revisión anterior		Revisión del 05:56 7 sep 2011
Línea 1:		Línea 1:
−	~~[[Category:Diseño De Software]]~~	+	This could not possibly have been more hlefupl!
−	~~[[Category:Java]]~~
−	Las convenciones de codificación en [[Java]] de Sun (Sun Code Conventions) es un documento que contiene convenciones estandard que Sun recomienda seguir. Las reglas cubren nombres de archivos, organizacion de directorios, identación, comentarios, declaraciones, sentencias, espacios en blanco, nomenclaturas, prácticas de programación e incluye un ejemplo de código.
−
−	~~== ¿Por qué tener una convención de codificación? ==~~
−	~~Las convenciones de codificación son importantes para los programadores por varias razones:~~
−	* el 80% del costo del software ocurre en el mantenimiento.
−	* prácticamente ningún software es mantenido toda su vida por el autor original.
−	* las convenciones mejoran la lectura del software, permitiendo a los ingenieros comprender el código nuevo de manera más rápida y completa.
−
−	~~==Clase de ejemplo==~~
−	La siguiente clase de ejemplo trata de resumir en modo concreto el uso de la reglas. No abarca todas las situaciones ni reemplaza la lectura de las convenciones, sino que sirve como un recordatorio rápido de las situaciones más comunes
−
−
−	~~<code java>~~
−	~~package java.blah;~~
−
−	~~import java.blah.blahdy.BlahBlah;~~
−
−	/**
−	* La descripcion de la clase va aqui.
−	*
−	* @version 1.82 18 Mar 1999
−	* @author Nombre Apellido
−	*/
−	~~public class Blah extends SomeClass {~~
−	~~/* Un comentario sobre la implementacion de esta clase podria ir aqui. */~~
−
−	~~/** Documentacion de la variable classVar1 */~~
−	~~public static int classVar1;~~
−
−	/**
−	* La documentacion de classVar2 es mas larga y compleja, y puede
−	* abarcar mas de una linea de esta manera
−	*/
−	~~private static Object classVar2;~~
−
−	~~/** Documentacion de instanceVar1 */~~
−	~~public Object instanceVar1;~~
−
−	~~/** Documentacion de instanceVar2 */~~
−	~~protected int instanceVar2;~~
−
−	~~/** Documentacion de instanceVar3 */~~
−	~~private Object[] instanceVar3;~~
−
−	/**
−	* ...documentacion del constructor Blah...
−	*/
−	~~public Blah() {~~
−	~~// ...la implementacion va aca...~~
−	}
−
−	/**
−	* ...documentacion del metodo doSomething...
−	*/
−	~~public void doSomething() {~~
−	~~// ...implementation goes here...~~
−	}
−
−	/**
−	* ...documentacion del metodo doSomethingElse...
−	* @param unParam descripcion
−	*/
−	~~public void doSomethingElse(Object unParam) {~~
−	~~// ...implementacion aca...~~
−	}
−
−	/**
−	* ...un metodo con ejemplos de sentencias...
−	*/
−	~~public void mostrarEjemplosDeSentencias() {~~
−	~~int maxloops = 10;~~
−	~~int a = 0;~~
−	~~int b = 0;~~
−	~~int c = 0;~~
−	~~int d = 0;~~
−
−	~~a += c + d;~~
−	~~a = (a + b) / (c * d);~~
−	~~System.out.println("el valor de a es " + a + "\n");~~
−
−	~~unMetodo((byte) a, (Object) x);~~
−
−	~~if (condition) {~~
−	~~statements;~~
−	~~} else if (condition) {~~
−	~~statements;~~
−	~~} else {~~
−	~~statements;~~
−	}
−
−	~~for (int i = 0; i < maxLoops; i++) {~~
−	~~statements;~~
−	}
−
−	~~switch (condition) {~~
−	~~case ABC:~~
−	~~statements;~~
−	~~/* falls through */~~
−
−	~~case DEF:~~
−	~~statements;~~
−	~~break;~~
−
−	~~case XYZ:~~
−	~~statements;~~
−	~~break;~~
−
−	~~default:~~
−	~~statements;~~
−	~~break;~~
−	}
−
−	~~try {~~
−	~~statements;~~
−	~~} catch (ExceptionClass e) {~~
−	~~statements;~~
−	~~} catch (OtraExceptionClass e) {~~
−	~~statements;~~
−	~~} finally {~~
−	~~statements;~~
−	}
−	}
−	}
−	~~</code>~~
−
−
−	~~==Ver también==~~
−	* [http://java.sun.com/docs/codeconv/ Sun Code Conventions]
−	* [http://www.programacion.net/java/tutorial/convenciones/ Sun Code Conventions (traducido al castellano)]

← Revisión anterior		Revisión del 18:02 26 ago 2009
Línea 1:		Línea 1:
		+	[[Category:Diseño De Software]]
		+	[[Category:Java]]
	Las convenciones de codificación en [[Java]] de Sun (Sun Code Conventions) es un documento que contiene convenciones estandard que Sun recomienda seguir. Las reglas cubren nombres de archivos, organizacion de directorios, identación, comentarios, declaraciones, sentencias, espacios en blanco, nomenclaturas, prácticas de programación e incluye un ejemplo de código.		Las convenciones de codificación en [[Java]] de Sun (Sun Code Conventions) es un documento que contiene convenciones estandard que Sun recomienda seguir. Las reglas cubren nombres de archivos, organizacion de directorios, identación, comentarios, declaraciones, sentencias, espacios en blanco, nomenclaturas, prácticas de programación e incluye un ejemplo de código.

@@ Línea 1: / Línea 1: @@
-Las convenciones de codificación en Java de Sun (Sun Code Conventions) es un documento que contiene convenciones estandard que Sun recomienda seguir. Las reglas cubren nombres de archivos, organizacion de directorios, identación, comentarios, declaraciones, sentencias, espacios en blanco, nomenclaturas, prácticas de programación e incluye un ejemplo de código.
+Las convenciones de codificación en [[Java]] de Sun (Sun Code Conventions) es un documento que contiene convenciones estandard que Sun recomienda seguir. Las reglas cubren nombres de archivos, organizacion de directorios, identación, comentarios, declaraciones, sentencias, espacios en blanco, nomenclaturas, prácticas de programación e incluye un ejemplo de código.
 == ¿Por qué tener una convención de codificación? ==
@@ Línea 11: / Línea 11: @@
-<pre>
+<code java>
   package java.blah;
@@ Línea 122: / Línea 122: @@
+      }
+  }
-</pre>
+</code>

@@ Línea 128: / Línea 128: @@
 ==Ver también==
-* [http://java.sun.com/docs/codeconv/ Sun Code Conventions]
+* [http://www.oracle.com/technetwork/java/javase/documentation/codeconvtoc-136057.html Code Conventions for the Java Programming Language]
 * [http://www.programacion.net/java/tutorial/convenciones/ Sun Code Conventions (traducido al castellano)]

← Revisión anterior		Revisión del 15:22 30 jul 2012
Línea 1:		Línea 1:
−	~~This could not possibly have been more hlefupl!~~	+	[[Category:Diseño De Software]]
		+	[[Category:Java]]
		+	Las convenciones de codificación en [[Java]] de Sun (Sun Code Conventions) es un documento que contiene convenciones estandard que Sun recomienda seguir. Las reglas cubren nombres de archivos, organizacion de directorios, identación, comentarios, declaraciones, sentencias, espacios en blanco, nomenclaturas, prácticas de programación e incluye un ejemplo de código.
		+
		+	== ¿Por qué tener una convención de codificación? ==
		+	Las convenciones de codificación son importantes para los programadores por varias razones:
		+	* el 80% del costo del software ocurre en el mantenimiento.
		+	* prácticamente ningún software es mantenido toda su vida por el autor original.
		+	* las convenciones mejoran la lectura del software, permitiendo a los ingenieros comprender el código nuevo de manera más rápida y completa.
		+
		+	==Clase de ejemplo==
		+	La siguiente clase de ejemplo trata de resumir en modo concreto el uso de la reglas. No abarca todas las situaciones ni reemplaza la lectura de las convenciones, sino que sirve como un recordatorio rápido de las situaciones más comunes
		+
		+
		+	<code java>
		+	package java.blah;
		+
		+	import java.blah.blahdy.BlahBlah;
		+
		+	/**
		+	* La descripcion de la clase va aqui.
		+	*
		+	* @version 1.82 18 Mar 1999
		+	* @author Nombre Apellido
		+	*/
		+	public class Blah extends SomeClass {
		+	/* Un comentario sobre la implementacion de esta clase podria ir aqui. */
		+
		+	/** Documentacion de la variable classVar1 */
		+	public static int classVar1;
		+
		+	/**
		+	* La documentacion de classVar2 es mas larga y compleja, y puede
		+	* abarcar mas de una linea de esta manera
		+	*/
		+	private static Object classVar2;
		+
		+	/** Documentacion de instanceVar1 */
		+	public Object instanceVar1;
		+
		+	/** Documentacion de instanceVar2 */
		+	protected int instanceVar2;
		+
		+	/** Documentacion de instanceVar3 */
		+	private Object[] instanceVar3;
		+
		+	/**
		+	* ...documentacion del constructor Blah...
		+	*/
		+	public Blah() {
		+	// ...la implementacion va aca...
		+	}
		+
		+	/**
		+	* ...documentacion del metodo doSomething...
		+	*/
		+	public void doSomething() {
		+	// ...implementation goes here...
		+	}
		+
		+	/**
		+	* ...documentacion del metodo doSomethingElse...
		+	* @param unParam descripcion
		+	*/
		+	public void doSomethingElse(Object unParam) {
		+	// ...implementacion aca...
		+	}
		+
		+	/**
		+	* ...un metodo con ejemplos de sentencias...
		+	*/
		+	public void mostrarEjemplosDeSentencias() {
		+	int maxloops = 10;
		+	int a = 0;
		+	int b = 0;
		+	int c = 0;
		+	int d = 0;
		+
		+	a += c + d;
		+	a = (a + b) / (c * d);
		+	System.out.println("el valor de a es " + a + "\n");
		+
		+	unMetodo((byte) a, (Object) x);
		+
		+	if (condition) {
		+	statements;
		+	} else if (condition) {
		+	statements;
		+	} else {
		+	statements;
		+	}
		+
		+	for (int i = 0; i < maxLoops; i++) {
		+	statements;
		+	}
		+
		+	switch (condition) {
		+	case ABC:
		+	statements;
		+	/* falls through */
		+
		+	case DEF:
		+	statements;
		+	break;
		+
		+	case XYZ:
		+	statements;
		+	break;
		+
		+	default:
		+	statements;
		+	break;
		+	}
		+
		+	try {
		+	statements;
		+	} catch (ExceptionClass e) {
		+	statements;
		+	} catch (OtraExceptionClass e) {
		+	statements;
		+	} finally {
		+	statements;
		+	}
		+	}
		+	}
		+	</code>
		+
		+
		+	==Ver también==
		+	* [http://java.sun.com/docs/codeconv/ Sun Code Conventions]
		+	* [http://www.programacion.net/java/tutorial/convenciones/ Sun Code Conventions (traducido al castellano)]