Programacion en java
1.1 . ¿Por qué tener Convenciones de Codificación?
2 . Nombres de Ficheros y sus Localizaciones
3 . Organización de Ficheros
3.1 . Ficheros JSP / Ficheros de Fragmento JSP
3.1.1 . Comentarios Iniciales
3.1.2 . Directiva(s) JSP Page
3.1.3 . Directiva(s) Tag Library Opcionales
3.1.4 . Declaraciones JSP Opcionales 3.1.5 . Código HTML y JSP
3.1.6 . Descriptor de Librería de Etiquetas
4 . Identación
4.1 . Identación de Elementos de Script
4.2 . Identación Compuesta con JSP, HTML y Java
5 . comentarios
5.1 . Comentarios
5.2 . Comentarios del Lado del Cliente
5.3 . Bloques de Comentarios Multi-línea
6 . Declaraciones JSP
7 . Scriptlets JSP
8 . Expresiones JSP
9 .Espacios en Blanco
9.1 . Líneas en Blanco
9.2 . Espacios en Blanco
10 . Convenciones de Nombres
10.1 . Nombres JSP
10.2 . Nombres de Etiquetas
10.3 . Nombres de Prefijos de Etiquetas
11 . Páginas JSP con Sintaxis XML
11.1 . Estructura de un Documento JSP
11.2 . Comentarios XML
11.3 . Código Java en Documentos JSP
12 . Prácticas de Programación 12.1 . Inicialización de JavaBeans
12.2 . Objetos Implícitos de JSP
12.3 . Entrecomillado
12.4 . Usar Etiquetas Personalizadas
12.5 . Uso de TagExtraInfo y TagLibraryValidator
12.6 . Usar JavaScript
12.7 . Hojas de Estilo en Cascada (CSS)
12.8 . Usar Patrones de Vistas Compuestos
12.9 . Otras Recomendaciones |
Este Artículo es una traducción deloriginal en Inglés escrito por Kam Hay Fung y que puedes encontrar en http://developer.java.sun.com/developer/technicalArticles/javaserverpages/code_convention/. |
Introducción
A medida que se han ido adoptando las JavaServer Pages (JSP) en la aplicaciones basadas en la Web, muchos programadores y desarrolladores embarcados en el desarrollo y mantenimiento de estas aplicaciones se encuentran con undilema igual que el de muchos programadores Java, "¿Cómo estructuramos el código JSP para que sea fácil de leer, de escribir y de mantener?
En este artículo, se propone un conjunto de convenciones estándar para escribir JSPs (versiones 1.1 y 1.2) que se deberían seguir en un proyecto típico de desarrollo de software que utiliza componentes web. Utiliza Code Conventions for the Java ProgrammingLanguage (de las que puedes encontrar una traducción en esta misma site, en http://programacion.com/java/tutorial/convenciones/) como plantilla para identificar varios elementos importantes que se deberían corregir en una especificación de convenciones de codificación (relevante para JSP). En particular, corrige los nombres y la organización de los ficheros, la identación, los comentarios, lasdirectivas, las declaraciones, los scriptlets, las expresiones, los espacios en blanco, las convenciones de nombres y las prácticas de programación. Como este es el primer intento de de presentar un conjunto de convenciones de codificación JSP, están muy interesados en recibir cualquier feedbak sobre estas recomendaciones. Puedes escribirles a jsp-codeconv-comments@sun.com.
La especificaciónJavaServer Pages 2.0, aunque es totalmente compatible con la versión 1.2, permite un estilo de programación libre de scripts (sin declaraciones, scriptles y expresiones) y tiene varias nuevas características que esperamos que hagan evolucionar estas convenciones. Siempre que ha sido posible este artículo ha elegido convenciones que permanecerán con las nuevas características de JSP 2.0.
Finalmente,asumen que estás familiarizado con JSP, Java y las convenciones de codificación Java.
¿Por qué tener Convenciones de Codificación?
Las convenciones de codificación son importantes y los desarrolladores de contenido Web por varias razones:
1. Mejoran la legibilidad de los artefactos software.
2. Reducen el tiempo y el esfuerzo del entrenamiento
3. Lideran hacia la...
Regístrate para leer el documento completo.