Estandarizando los codigos internos de error
07 feb 2007
Sera deformacion profesional heredada de mi experiencia laboral anterior, pero cuando nos hemos decidido a crear un Java5 enum en nuestras librerias de desarrollo para la estandarizacion de los codigos de error, me he empeñado en reservar/usar los codigos de respuesta del estandard SIP (Session Initiation Protocol). Realmente son un superconjunto de los codigos de respuesta estandard del protocolo HTTP, con los que la mayoria estamos mas que familiarizados, aunque solo sea de navegar en busca del fin de internet (sic).
Basicamente mi idea ha sido reservar todos los codigos de error entre 100 y 699 para codigos compatibles con el estandard SIP:
1xx: Provisional — Respuestas provisionales, de caracter informativo. Se envia un 1xx si se espera que la respuesta final tarde mas de 200ms.
2xx: Success — Para los casos en que todo ha ido bien.
3xx: Redirection — Hacen falta acciones adicionales para completar correctamente la petición.
4xx: Client Error — Errores en capa cliente, o peticiones mal formadas.
5xx: Server Error — Fallos en servidor ante una peticion aparentemente correcta.
6xx: Global Failure — Fallo global.
Obviamente, para un enum que contenga codigos de error, las respuestas informativas o de exito no nos interesan, pero en cualquier caso decidimos reservar esos rangos y no usarlos. Simple cuestion de compatibilidad hacia delante.
Estos codigos no son ningun secreto y estan disponibles en cientos de paginas en internet, pero picarselos en un enum resulta bastante co~azo, la verdad… asi que aqui estan por si alguien quiere reutilizar…
public enum CodigoError{
//Especial
/* Copyrighted */
//0xx - General (Viavansi)
/* Copyrighted */
//1xx - Provisional (Standard) - Informativo de progreso - No usar como codigo de error!
//2xx - Success (Standard) - No usar como codigo de error!
//3xx - Redirection (Standard)
SIP_MULTIPLE_CHOICES(300,"Multiple Choices."),//SIP
SIP_MOVED_PERMANENTLY(301,"Moved Permanently."),//SIP
SIP_MOVED_TEMPORARILY(302,"Moved Temporarily."),//SIP
SIP_USE_PROXY(305,"Use Proxy."),//SIP
SIP_ALTERNATIVE_SERVICE(380,"Alternative Service."),//SIP
//4xx - Client or Request (Standard)
SIP_BAD_REQUEST(400,"Bad Request."),//SIP
SIP_UNAUTHORIZED(401,"Unauthorized. Need to register."),//SIP Proxys should use proxy authorization 407
SIP_PAYMENT_REQUIRED(402,"Payment Required"),//SIP
SIP_FORBIDDEN(403,"Forbidden."),//SIP
SIP_NOT_FOUND(404,"Not Found."),//SIP
SIP_METHOD_NOT_ALLOWED(405,"Method Not Allowed."),//SIP
SIP_REQ_NOT_ACCEPTABLE(406,"Not Acceptable."),//SIP
SIP_PROXY_AUTH_REQ(407,"Proxy Authentication Required."),//SIP
SIP_REQUEST_TIME_OUT(408,"Request Timeout."),//SIP
SIP_GONE(410,"Gone: The user existed once, but is not available here any more."),//SIP
SIP_ENTITY_TOO_LARGE(413,"Request Entity Too Large."),//SIP
SIP_URI_TOO_LONG(414,"Request-URI Too Long."),//SIP
SIP_UNSOPPORTED_MEDIA(415,"Unsupported Media Type."),//SIP
SIP_UNSOPPORTED_URI_SCHEME(416,"Unsupported URI Scheme."),//SIP
SIP_BAD_EXTENSION(420,"Bad Extension."),//SIP
SIP_EXTENSION_REQUIRED(421,"Extension Required."),//SIP
SIP_INTERVAL_TOO_SHORT(423,"Interval Too Brief."),//SIP
SIP_TEMPORARILY_UNAVAILABLE(480,"Temporarily Unavailable."),//SIP
SIP_TRANSACTION_NOT_EXISTS(481,"Transaction Does Not Exist."),//SIP
SIP_LOOP(482,"Loop Detected."),//SIP
SIP_TOO_MANY_HOPS(483,"Too Many Hops."),//SIP
SIP_WRONG_ADDRESS(484,"Address Incomplete."),//SIP
SIP_AMBIGUOUS(485,"Ambiguous."),//SIP
SIP_BUSY(486,"Busy Here."),//SIP
SIP_REQUEST_TERMINATED(487,"Request Terminated."),//SIP
SIP_REQ_NOT_ACCEPTABLE_HERE(488,"Not Acceptable Here."),//SIP
SIP_REQ_PENDING(491,"Request Pending."),//SIP
SIP_UNDECIPHERABLE(493,"Undecipherable: Could not decrypt."),//SIP
//5xx - Server (Standard)
SIP_SERVER_ERROR(500,"Server Internal Error."),//SIP
SIP_NOT_IMPLEMENTED_HERE(501,"Not Implemented: The request method is not implemented here"),//SIP
SIP_BAD_GATEWAY(502,"Bad Gateway."),//SIP
SIP_SERVICE_UNAVAILABLE(503,"Service Unavailable."),//SIP
SIP_SERVER_TIME_OUT(504,"Server Time-out."),//SIP
SIP_VERSION_NOT_SUPPORTED(505,"Version Not Supported:The server does not support this version"),//SIP
SIP_MESSAGE_TOO_LARGE(513,"Message Too Large."),//SIP
//6xx - Global (Standard)
SIP_BUSY_EVERYWHERE(600,"Busy Everywhere."),//SIP
SIP_DECLINE(603,"Decline."),//SIP
SIP_NOT_EXISTS(604,"Does Not Exist Anywhere."),//SIP
SIP_NOT_ACCEPTABLE(606,"Not Acceptable."),//SIP
//10xx - Base de Datos (Viavansi)
/* Copyrighted */
//11xx - XML (Viavansi)
/* Copyrighted */;
private final int codigo;
private final String mensaje;
CodigoError(int cod, String mensaje) {
this.codigo = cod;
this.mensaje = mensaje;
}
/**
* @return Devuelve el mensaje por defecto.
*/
public String getMensaje() {
return mensaje;
}
/**
* @return Devuelve el codigo de error asociado.
*/
public int getCodigo() {
return codigo;
}
/* (non-Javadoc)
* @see java.lang.Enum#toString()
*/
@Override
public String toString() {
return mensaje+"[codigo error:"+codigo+"]";
}
}
