Reglas de codificación
En general, el código de los comportamientos del servidor debe ser compacto y robusto. Los desarrolladores de aplicaciones Web son muy sensibles al código añadido a sus páginas. Aplique prácticas de codificación generalmente aceptadas para el lenguaje de los tipos de documento (ColdFusion, JavaScript, VBScript o PHP). Al escribir comentarios, tenga en cuenta las diferencias en cuanto a conocimientos técnicos de las personas que tienen que comprender el código, como son diseñadores Web y de interacción u otros desarrolladores de aplicaciones Web. Incluya comentarios que describan con precisión la finalidad del código y cualquier instrucción especial para su inclusión en una página.
Tenga presentes las siguientes reglas de codificación al crear comportamientos de servidor:
- Comprobación de errores
- Un requisito importante. El código del comportamiento de servidor debe gestionar los casos de error de forma correcta. Intente prever cualquier posibilidad: Por ejemplo, ¿qué ocurre si falla la petición de un parámetro? ¿Qué ocurre si una consulta no devuelve ningún registro?
- Nombres exclusivos
- Le ayudan a asegurarse de que su código es claramente identificable y evita conflictos de nombres con el código ya existente. Si la página contiene, por ejemplo, una función llamada hideLayer() y una variable global llamada ERROR_STRING y el comportamiento del servidor inserta código que también usa esos nombres, el comportamiento de servidor puede originar un conflicto con el código existente.
- Prefijos de código
- Le permiten identificar sus propias funciones de tiempo de ejecución y variables globales en una página. Una posible convención consiste en usar sus iniciales. No utilice nunca el prefijo MM_, ya que está reservado para uso exclusivo de Dreamweaver. En el código de Dreamweaver, todas las funciones y variables globales van precedidas por el prefijo MM_ para evitar que se produzcan conflictos con el código que escriba.
var MM_ERROR_STRING = "...";
function MM_hideLayer() {
- Evite bloques de código similares
- para que el código que escriba no se parezca demasiado al código de otros bloques. Si un bloque de código se parece demasiado a otro bloque de código de la página, el panel Comportamientos del servidor podría identificar erróneamente el primer bloque de códigos como una instancia del segundo bloque de códigos (o al contrario). Una solución simple consiste en añadir un comentario a un bloque de código para hacerlo más exclusivo.
PDF (adobe.com)
