Reino: API Abuse

Un API es un contrato entre un autor de llamada y un receptor de llamada. Las formas de abuso de API más comunes los produce el autor de llamada cuando no consigue atender su fin de este contrato. Por ejemplo, si un programa no consigue llamar chdir() después de llamar chroot(), se viola el contrato que especifica cómo cambiar el directorio de origen activo de una forma segura. Otro buen ejemplo de un abuso de manual es esperar que el receptor devuelva una información de DNS de confianza al autor de llamada. En este caso, el autor de llamada abusa el API del receptor haciendo determinadas suposiciones sobre su comportamiento (que el valor de retorno se puede usar con fines de autenticación). También se puede violar el contrato entre el autor de llamada y el receptor desde el otro lado. Por ejemplo, si un codificador envía SecureRandom y devuelve un valor no aleatorio, se viola el contrato.

Object Model Violation: Just one of equals() and hashCode() Defined

Abstract
Esta clase ignora solo uno de equals() y hashCode().
Explanation
Se espera que los objetos Java obedezcan un número de invariables relacionadas con la igualdad. Una de estas invariables es que los objetos iguales deben tener códigos hash iguales. En otras palabras, si a.equals(b) == true, entonces a.hashCode() == b.hashCode().

En caso de no mantenerse esta invariable, es probable que se produzcan problemas si los objetos de esta clase se almacenan en una colección. Si los objetos de la clase en cuestión se usan como clave en una tabla hash o si se insertan en un Map o Set, es esencial que los objetos iguales tengan los códigos hash iguales.

Ejemplo 1: La clase siguiente ignora equals() pero no hashCode().


public class halfway() {
public boolean equals(Object obj) {
...
}
}
References
[1] D. H. Hovermeyer FindBugs User Manual
[2] MET09-J. Classes that define an equals() method must also define a hashCode() method CERT
[3] Standards Mapping - Common Weakness Enumeration CWE ID 581
desc.structural.java.object_model_violation_just_one_of_equals_hashcode_defined