| Index: doc/bugDescriptions_fr.html
|
| diff --git a/doc/bugDescriptions_fr.html b/doc/bugDescriptions_fr.html
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..356331db6619cd42850d946ff37fe3215c663bb0
|
| --- /dev/null
|
| +++ b/doc/bugDescriptions_fr.html
|
| @@ -0,0 +1,4318 @@
|
| +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
| +<html><head><title>FindBugs Bug Descriptions</title>
|
| +<link rel="stylesheet" type="text/css" href="findbugs.css"/>
|
| +<link rel="shortcut icon" href="favicon.ico" type="image/x-icon"/>
|
| +</head><body>
|
| +
|
| +<table width="100%"><tr>
|
| +
|
| +<td bgcolor="#b9b9fe" valign="top" align="left" width="20%">
|
| +<table width="100%" cellspacing="0" border="0">
|
| +<tr><td><a class="sidebar" href="index.html"><img src="umdFindbugs.png" alt="FindBugs"></a></td></tr>
|
| +
|
| +<tr><td> </td></tr>
|
| +
|
| +<tr><td><b>Docs and Info</b></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="findbugs2.html">FindBugs 2.0</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="demo.html">Demo and data</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="users.html">Users and supporters</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="http://findbugs.blogspot.com/">FindBugs blog</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="factSheet.html">Fact sheet</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="manual/index.html">Manual</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="ja/manual/index.html">Manual(ja/日本語)</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="FAQ.html">FAQ</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="bugDescriptions.html">Bug descriptions</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="bugDescriptions_ja.html">Bug descriptions(ja/日本語)</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="bugDescriptions_fr.html">Bug descriptions(fr)</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="mailingLists.html">Mailing lists</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="publications.html">Documents and Publications</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="links.html">Links</a></font></td></tr>
|
| +
|
| +<tr><td> </td></tr>
|
| +
|
| +<tr><td><a class="sidebar" href="downloads.html"><b>Downloads</b></a></td></tr>
|
| +
|
| +<tr><td> </td></tr>
|
| +
|
| +<tr><td><a class="sidebar" href="http://www.cafeshops.com/findbugs"><b>FindBugs Swag</b></a></td></tr>
|
| +
|
| +<tr><td> </td></tr>
|
| +
|
| +<tr><td><b>Development</b></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="http://sourceforge.net/tracker/?group_id=96405">Open bugs</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="reportingBugs.html">Reporting bugs</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="contributing.html">Contributing</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="team.html">Dev team</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="api/index.html">API</a> <a class="sidebar" href="api/overview-summary.html">[no frames]</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="Changes.html">Change log</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="http://sourceforge.net/projects/findbugs">SF project page</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="http://code.google.com/p/findbugs/source/browse/">Browse source</a></font></td></tr>
|
| +<tr><td><font size="-1"> <a class="sidebar" href="http://code.google.com/p/findbugs/source/list">Latest code changes</a></font></td></tr>
|
| +</table>
|
| +</td>
|
| +<td align="left" valign="top">
|
| +<h1>FindBugs Bug Descriptions</h1>
|
| +<p>This document lists the standard bug patterns reported by
|
| +<a href="http://findbugs.sourceforge.net">FindBugs</a> version 3.0.0.</p>
|
| +<h2>Summary</h2>
|
| +<table width="100%">
|
| +<tr bgcolor="#b9b9fe"><th>Description</th><th>Category</th></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#BC_EQUALS_METHOD_SHOULD_WORK_FOR_ALL_OBJECTS">BC: Equals method should not assume anything about the type of its argument</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#BIT_SIGNED_CHECK">BIT: Check for sign of bitwise operation</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#CN_IDIOM">CN: La classe implémente Cloneable mais ne définit et n'utilise pas la méthode clone()</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#CN_IDIOM_NO_SUPER_CALL">CN: La méthode clone() n'appelle pas super.clone()</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#CN_IMPLEMENTS_CLONE_BUT_NOT_CLONEABLE">CN: Class defines clone() but doesn't implement Cloneable</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#CNT_ROUGH_CONSTANT_VALUE">CNT: Rough value of known constant found</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#CO_ABSTRACT_SELF">Co: Une classe abstraite définit une méthode compareTo() covariante</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#CO_SELF_NO_OBJECT">Co: Définition d'une méthode compareTo() covariante</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DE_MIGHT_DROP">DE: La méthode peut déclencher une exception</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DE_MIGHT_IGNORE">DE: La méthode peut ignorer une exception</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DMI_ENTRY_SETS_MAY_REUSE_ENTRY_OBJECTS">DMI: Adding elements of an entry set may fail due to reuse of Entry objects</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DMI_RANDOM_USED_ONLY_ONCE">DMI: Random object created and used only once</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DMI_USING_REMOVEALL_TO_CLEAR_COLLECTION">DMI: Don't use removeAll to clear a collection</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DM_EXIT">Dm: La méthode invoque System.exit(...)</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DM_RUN_FINALIZERS_ON_EXIT">Dm: Méthode invoquant runFinalizersOnExit, l'une des plus dangeureuses méthodes des librairies Java</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#ES_COMPARING_PARAMETER_STRING_WITH_EQ">ES: Comparison of String parameter using == or !=</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#ES_COMPARING_STRINGS_WITH_EQ">ES: Comparaison d'objets String utilisant == ou !=</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EQ_ABSTRACT_SELF">Eq: Une classe abstraite définit une méthode equals() covariante</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#EQ_CHECK_FOR_OPERAND_NOT_COMPATIBLE_WITH_THIS">Eq: Equals checks for incompatible operand</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EQ_COMPARETO_USE_OBJECT_EQUALS">Eq: Class defines compareTo(...) and uses Object.equals()</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#EQ_GETCLASS_AND_CLASS_CONSTANT">Eq: equals method fails for subtypes</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EQ_SELF_NO_OBJECT">Eq: Définition d'une méthode equals() covariante</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#FI_EMPTY">FI: Un finaliseur vide devrait être supprimé</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#FI_EXPLICIT_INVOCATION">FI: Invocation explicite d'un finaliseur</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#FI_FINALIZER_NULLS_FIELDS">FI: Finalizer nulls fields</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#FI_FINALIZER_ONLY_NULLS_FIELDS">FI: Finalizer only nulls fields</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#FI_MISSING_SUPER_CALL">FI: Le finaliseur n'appelle pas le finaliseur de la super-classe</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#FI_NULLIFY_SUPER">FI: Un finaliseur rend inutile celui de sa super-classe</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#FI_USELESS">FI: Le finaliseur ne fait rien sauf appeler celui de la super-classe</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#VA_FORMAT_STRING_USES_NEWLINE">FS: Format string should use %n rather than \n</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#GC_UNCHECKED_TYPE_IN_GENERIC_CALL">GC: Unchecked type in generic call</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#HE_EQUALS_NO_HASHCODE">HE: La classe définit equals() mais pas hashCode()</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#HE_EQUALS_USE_HASHCODE">HE: La classe définit equals() et utilise Object.hashCode()</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#HE_HASHCODE_NO_EQUALS">HE: La classe définit hashCode() mais pas equals()</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#HE_HASHCODE_USE_OBJECT_EQUALS">HE: La classe définit hashCode() et utilise Object.equals()</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#HE_INHERITS_EQUALS_USE_HASHCODE">HE: La classe hérite de equals() et utilise Object.hashCode()</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#IC_SUPERCLASS_USES_SUBCLASS_DURING_INITIALIZATION">IC: Classe mère utilisant une sous-classe durant son initialisation</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#IMSE_DONT_CATCH_IMSE">IMSE: Interception douteuse d'une IllegalMonitorStateException</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#ISC_INSTANTIATE_STATIC_CLASS">ISC: Instantiation inutile d'une classe qui n'a que des méthodes statiques</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#IT_NO_SUCH_ELEMENT">It: La méthode next() de Iterator ne peut pas déclencher une exception NoSuchElement</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#J2EE_STORE_OF_NON_SERIALIZABLE_OBJECT_INTO_SESSION">J2EE: Stockage d'un objet non serialisable dans une session Http</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#JCIP_FIELD_ISNT_FINAL_IN_IMMUTABLE_CLASS">JCIP: Les champs d'une classe immuable devraient être finaux.</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_BOOLEAN_RETURN_NULL">NP: Method with Boolean return type returns explicit null</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_CLONE_COULD_RETURN_NULL">NP: Clone method may return null</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_EQUALS_SHOULD_HANDLE_NULL_ARGUMENT">NP: Méthode equals() ne vérifiant pas la nullité</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_TOSTRING_COULD_RETURN_NULL">NP: toString method may return null</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NM_CLASS_NAMING_CONVENTION">Nm: Nom de classe devant commencer par une majuscule</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NM_CLASS_NOT_EXCEPTION">Nm: Cette classe ne dérive pas d'Exception, même si son nom le sous-entend</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NM_CONFUSING">Nm: Noms de méthodes ambigus</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NM_FIELD_NAMING_CONVENTION">Nm: Nom de champ devant commencer par une minuscule</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NM_FUTURE_KEYWORD_USED_AS_IDENTIFIER">Nm: Use of identifier that is a keyword in later versions of Java</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NM_FUTURE_KEYWORD_USED_AS_MEMBER_IDENTIFIER">Nm: Use of identifier that is a keyword in later versions of Java</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NM_METHOD_NAMING_CONVENTION">Nm: Nom de méthode devant commencer par une minuscule</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NM_SAME_SIMPLE_NAME_AS_INTERFACE">Nm: Class names shouldn't shadow simple name of implemented interface</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NM_SAME_SIMPLE_NAME_AS_SUPERCLASS">Nm: Class names shouldn't shadow simple name of superclass</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NM_VERY_CONFUSING_INTENTIONAL">Nm: Very confusing method names (but perhaps intentional)</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NM_WRONG_PACKAGE_INTENTIONAL">Nm: Method doesn't override method in superclass due to wrong package for parameter</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#ODR_OPEN_DATABASE_RESOURCE">ODR: La méthode peut ne pas fermer une ressource base de données</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#ODR_OPEN_DATABASE_RESOURCE_EXCEPTION_PATH">ODR: La méthode peut ne pas fermer une ressource base de données sur une exception</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#OS_OPEN_STREAM">OS: La méthode peut ne pas fermer un flux</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#OS_OPEN_STREAM_EXCEPTION_PATH">OS: La méthode peut oublier de fermer un flux en cas d'exception</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#PZ_DONT_REUSE_ENTRY_OBJECTS_IN_ITERATORS">PZ: Don't reuse entry objects in iterators</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RC_REF_COMPARISON_BAD_PRACTICE">RC: Suspicious reference comparison to constant</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RC_REF_COMPARISON_BAD_PRACTICE_BOOLEAN">RC: Suspicious reference comparison of Boolean values</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RR_NOT_CHECKED">RR: La méthode ignore le résultat de InputStream.read()</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SR_NOT_CHECKED">RR: La méthode ignore le résultat de InputStream.skip()</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RV_NEGATING_RESULT_OF_COMPARETO">RV: Negating the result of compareTo()/compare()</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RV_RETURN_VALUE_IGNORED_BAD_PRACTICE">RV: Method ignores exceptional return value</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SI_INSTANCE_BEFORE_FINALS_ASSIGNED">SI: Initialiseur statique de classe créant une instance avant que tous les champs static final soient alimentés</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SW_SWING_METHODS_INVOKED_IN_SWING_THREAD">SW: Certaines méthodes Swing ne doivent être invoquées qu'à partir du thread Swing</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SE_BAD_FIELD">Se: Champ d'instance non transient et non sérialisable dans une classe sérialisable</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SE_BAD_FIELD_INNER_CLASS">Se: Non-serializable class has a serializable inner class</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SE_BAD_FIELD_STORE">Se: Valeur non sérialisable stockée dans un champ d'instance de classe sérialisable</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SE_COMPARATOR_SHOULD_BE_SERIALIZABLE">Se: Comparateur n'implémentant pas Serializable</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SE_INNER_CLASS">Se: Serializable inner class</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SE_NONFINAL_SERIALVERSIONID">Se: serialVersionUID n'est pas final</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SE_NONLONG_SERIALVERSIONID">Se: serialVersionUID n'est pas de type long</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SE_NONSTATIC_SERIALVERSIONID">Se: serialVersionUID n'est pas static</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SE_NO_SUITABLE_CONSTRUCTOR">Se: La classe est Serializable mais sa super-classe ne possède pas de constructeur par défaut visible</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SE_NO_SUITABLE_CONSTRUCTOR_FOR_EXTERNALIZATION">Se: La classe est Externalizable mais ne définit pas de constructeur par défaut</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SE_READ_RESOLVE_MUST_RETURN_OBJECT">Se: La méthode readResolve doit retourner un Object</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SE_TRANSIENT_FIELD_NOT_RESTORED">Se: Champ "transient" non positionné lors de la désérialisation</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SE_NO_SERIALVERSIONID">SnVI: La classe est Serializable, mais ne définit pas serialVersionUID</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#UI_INHERITANCE_UNSAFE_GETRESOURCE">UI: L'utilisation de GetResource peut-être instable si la classe est étendue</a></td><td>Bad practice</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#BC_IMPOSSIBLE_CAST">BC: Transtypage impossible</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#BC_IMPOSSIBLE_DOWNCAST">BC: Impossible downcast</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#BC_IMPOSSIBLE_DOWNCAST_OF_TOARRAY">BC: Impossible downcast of toArray() result</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#BC_IMPOSSIBLE_INSTANCEOF">BC: instanceof renverra toujours faux</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#BIT_ADD_OF_SIGNED_BYTE">BIT: Bitwise add of signed byte value</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#BIT_AND">BIT: Masques binaires incompatibles</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#BIT_AND_ZZ">BIT: Masques binaires incompatibles</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#BIT_IOR">BIT: Masques binaires incompatibles</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#BIT_IOR_OF_SIGNED_BYTE">BIT: Ou binaire d'un octet signé</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#BIT_SIGNED_CHECK_HIGH_BIT">BIT: Check for sign of bitwise operation</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#BOA_BADLY_OVERRIDDEN_ADAPTER">BOA: La classe surcharge mal une méthode implémentée dans une superclasse Adapter</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#ICAST_BAD_SHIFT_AMOUNT">BSHIFT: Décalage d'un int hors de proportion (0..31)</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#BX_UNBOXED_AND_COERCED_FOR_TERNARY_OPERATOR">Bx: Primitive value is unboxed and coerced for ternary operator</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#CO_COMPARETO_RESULTS_MIN_VALUE">Co: compareTo()/compare() returns Integer.MIN_VALUE</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DLS_DEAD_LOCAL_INCREMENT_IN_RETURN">DLS: Useless increment in return statement</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DLS_DEAD_STORE_OF_CLASS_LITERAL">DLS: Dead store of class literal</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DLS_OVERWRITTEN_INCREMENT">DLS: Incrémentation annulée</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DMI_ARGUMENTS_WRONG_ORDER">DMI: Reversed method arguments</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DMI_BAD_MONTH">DMI: Valeur constante pour un mois en dehors de l'intervalle attendu de 0 à 11</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DMI_BIGDECIMAL_CONSTRUCTED_FROM_DOUBLE">DMI: BigDecimal constructed from double that isn't represented precisely</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DMI_CALLING_NEXT_FROM_HASNEXT">DMI: Méthode hasNext() appelant next()</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DMI_COLLECTIONS_SHOULD_NOT_CONTAIN_THEMSELVES">DMI: Collections should not contain themselves</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DMI_DOH">DMI: D'oh! A nonsensical method invocation</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DMI_INVOKING_HASHCODE_ON_ARRAY">DMI: Invocation of hashCode on an array</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DMI_LONG_BITS_TO_DOUBLE_INVOKED_ON_INT">DMI: Double.longBitsToDouble invoked on an int</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DMI_VACUOUS_SELF_COLLECTION_CALL">DMI: Vacuous call to collections</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DMI_ANNOTATION_IS_NOT_VISIBLE_TO_REFLECTION">Dm: La réflexion ne peut pas être utilisée pour vérifier la présence d'une annotation avec la rétention par défaut</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DMI_FUTILE_ATTEMPT_TO_CHANGE_MAXPOOL_SIZE_OF_SCHEDULED_THREAD_POOL_EXECUTOR">Dm: Futile attempt to change max pool size of ScheduledThreadPoolExecutor</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DMI_SCHEDULED_THREAD_POOL_EXECUTOR_WITH_ZERO_CORE_THREADS">Dm: Creation of ScheduledThreadPoolExecutor with zero core threads</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DMI_VACUOUS_CALL_TO_EASYMOCK_METHOD">Dm: Useless/vacuous call to EasyMock method</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#EC_ARRAY_AND_NONARRAY">EC: Utilisation de equals() pour comparer un tableau et un objet</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EC_BAD_ARRAY_COMPARE">EC: Appel à equals() sur un tableau équivalent à ==</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#EC_INCOMPATIBLE_ARRAY_COMPARE">EC: equals(...) used to compare incompatible arrays</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EC_NULL_ARG">EC: Appel de equals() avec un argument à null</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#EC_UNRELATED_CLASS_AND_INTERFACE">EC: Appel de equals() comparant une classe et une interface sans relation</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EC_UNRELATED_INTERFACES">EC: Appel de equals() comparant différentes interfaces</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#EC_UNRELATED_TYPES">EC: Appel de equals() comparant des types différents</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EC_UNRELATED_TYPES_USING_POINTER_EQUALITY">EC: Using pointer equality to compare different types</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#EQ_ALWAYS_FALSE">Eq: equals method always returns false</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EQ_ALWAYS_TRUE">Eq: equals method always returns true</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#EQ_COMPARING_CLASS_NAMES">Eq: equals method compares class names rather than class objects</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EQ_DONT_DEFINE_EQUALS_FOR_ENUM">Eq: Covariant equals() method defined for enum</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#EQ_OTHER_NO_OBJECT">Eq: equals() method defined that doesn't override equals(Object)</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EQ_OTHER_USE_OBJECT">Eq: equals() method defined that doesn't override Object.equals(Object)</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#EQ_OVERRIDING_EQUALS_NOT_SYMMETRIC">Eq: equals method overrides equals in superclass and may not be symmetric</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EQ_SELF_USE_OBJECT">Eq: Définition d'une méthode equals() covariante, Object.equals(Object) est hérité</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#FE_TEST_IF_EQUAL_TO_NOT_A_NUMBER">FE: Test d'égalité avec NaN erroné</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#VA_FORMAT_STRING_BAD_ARGUMENT">FS: Format string placeholder incompatible with passed argument</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#VA_FORMAT_STRING_BAD_CONVERSION">FS: The type of a supplied argument doesn't match format specifier</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#VA_FORMAT_STRING_EXPECTED_MESSAGE_FORMAT_SUPPLIED">FS: MessageFormat supplied where printf style format expected</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#VA_FORMAT_STRING_EXTRA_ARGUMENTS_PASSED">FS: More arguments are passed than are actually used in the format string</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#VA_FORMAT_STRING_ILLEGAL">FS: Illegal format string</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#VA_FORMAT_STRING_MISSING_ARGUMENT">FS: Format string references missing argument</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#VA_FORMAT_STRING_NO_PREVIOUS_ARGUMENT">FS: No previous argument for format string</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#GC_UNRELATED_TYPES">GC: No relationship between generic parameter and method argument</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#HE_SIGNATURE_DECLARES_HASHING_OF_UNHASHABLE_CLASS">HE: Signature declares use of unhashable class in hashed construct</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#HE_USE_OF_UNHASHABLE_CLASS">HE: Use of class without a hashCode() method in a hashed data structure</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#ICAST_INT_2_LONG_AS_INSTANT">ICAST: int value converted to long and used as absolute time</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#ICAST_INT_CAST_TO_DOUBLE_PASSED_TO_CEIL">ICAST: Valeur entière transtypée en nombre flottant passée à Math.ceil</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#ICAST_INT_CAST_TO_FLOAT_PASSED_TO_ROUND">ICAST: Valeur entière transtypée en flottant puis transmise à Math.round</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#IJU_ASSERT_METHOD_INVOKED_FROM_RUN_METHOD">IJU: JUnit assertion in run method will not be noticed by JUnit</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#IJU_BAD_SUITE_METHOD">IJU: TestCase declares a bad suite method </a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#IJU_NO_TESTS">IJU: TestCase sans tests</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#IJU_SETUP_NO_SUPER">IJU: Une classe dérivant de TestCase implémente setUp() sans appeler super.setUp()</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#IJU_SUITE_NOT_STATIC">IJU: Une classe dérivant de TestCase implémente une méthode suite() non statique</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#IJU_TEARDOWN_NO_SUPER">IJU: Une classe dérivant de TestCase implémente tearDown() sans appeler super.tearDown()</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#IL_CONTAINER_ADDED_TO_ITSELF">IL: Un conteneur est ajouté à lui-même</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#IL_INFINITE_LOOP">IL: Boucle apparemment inifinie</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#IL_INFINITE_RECURSIVE_LOOP">IL: Boucle récursive infinie</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#IM_MULTIPLYING_RESULT_OF_IREM">IM: Multiplication d'un entier avec le résulat entier d'un modulo</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#INT_BAD_COMPARISON_WITH_INT_VALUE">INT: Bad comparison of int value with long constant</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#INT_BAD_COMPARISON_WITH_NONNEGATIVE_VALUE">INT: Bad comparison of nonnegative value with negative constant</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#INT_BAD_COMPARISON_WITH_SIGNED_BYTE">INT: Bad comparison of signed byte</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#IO_APPENDING_TO_OBJECT_OUTPUT_STREAM">IO: Doomed attempt to append to an object output stream</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#IP_PARAMETER_IS_DEAD_BUT_OVERWRITTEN">IP: Un paramètre est ré-écrit avant d'être utilisé</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#MF_CLASS_MASKS_FIELD">MF: La classe définit un champ qui masque un champ d'une classe mère</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#MF_METHOD_MASKS_FIELD">MF: La méthode définit une variable qui masque un champ</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_ALWAYS_NULL">NP: Déréférencement d'un pointeur null dans la méthode</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_ALWAYS_NULL_EXCEPTION">NP: Déréférencement d'un pointeur null dans le chemin d'exception d'une méthode</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_ARGUMENT_MIGHT_BE_NULL">NP: Méthode ne testant pas les paramètres à null</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_CLOSING_NULL">NP: close() invoked on a value that is always null</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_GUARANTEED_DEREF">NP: Null déréférencé</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_GUARANTEED_DEREF_ON_EXCEPTION_PATH">NP: Value is null and guaranteed to be dereferenced on exception path</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_NONNULL_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR">NP: Nonnull field is not initialized</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_NONNULL_PARAM_VIOLATION">NP: Appel de méthode transmettant null à un paramètre déclaré @NonNull</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_NONNULL_RETURN_VIOLATION">NP: Méthode renvoyer null mais déclarée @NonNull</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_NULL_INSTANCEOF">NP: A known null value is checked to see if it is an instance of a type</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_NULL_ON_SOME_PATH">NP: Possible déréférencement d'un pointeur null dans une méthode</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_NULL_ON_SOME_PATH_EXCEPTION">NP: Possible déréférencement d'un pointeur null dans le chemin d'exception d'une méthode</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_NULL_PARAM_DEREF">NP: Méthode passant null à un paramètre déréférencé inconditionnellement</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_NULL_PARAM_DEREF_ALL_TARGETS_DANGEROUS">NP: Appel de méthode passant null à un paramètre déréférencé inconditionnellement</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_NULL_PARAM_DEREF_NONVIRTUAL">NP: Appel à une méthode non virtuelle passant null à un paramètre déréférencé de façon inconditionnelle</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_OPTIONAL_RETURN_NULL">NP: Method with Optional return type returns explicit null</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_STORE_INTO_NONNULL_FIELD">NP: Stocke une valeur null dans un champ annoté NonNull</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_UNWRITTEN_FIELD">NP: Lecture d'un champ jamais écrit</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NM_BAD_EQUAL">Nm: La classe définit equal() ; ne devrait-ce pas être equals() ?</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NM_LCASE_HASHCODE">Nm: La classe définit hashcode() ; ne devrait-ce pas être hashCode() ?</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NM_LCASE_TOSTRING">Nm: La classe définit tostring() ; ne devrait-ce pas être toString() ?</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NM_METHOD_CONSTRUCTOR_CONFUSION">Nm: Confusion apparente entre une méthode et un constructeur</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NM_VERY_CONFUSING">Nm: Noms de méthodes très ambigus</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NM_WRONG_PACKAGE">Nm: Method doesn't override method in superclass due to wrong package for parameter</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#QBA_QUESTIONABLE_BOOLEAN_ASSIGNMENT">QBA: Méthode assignant une valeur boléenne fixe dans une expression booléenne</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RC_REF_COMPARISON">RC: Comparaison de références suspecte</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RCN_REDUNDANT_NULLCHECK_WOULD_HAVE_BEEN_A_NPE">RCN: Test de nullité d'une valeur préalablement déréférencée</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RE_BAD_SYNTAX_FOR_REGULAR_EXPRESSION">RE: Syntaxe d'expression régulière invalide</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RE_CANT_USE_FILE_SEPARATOR_AS_REGULAR_EXPRESSION">RE: File.separator used for regular expression</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RE_POSSIBLE_UNINTENDED_PATTERN">RE: "." utilisé dans une expression régulière</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RV_01_TO_INT">RV: Les valeurs aléatoires entre 0 et 1 sont réduites à l'entier 0</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RV_ABSOLUTE_VALUE_OF_HASHCODE">RV: Bad attempt to compute absolute value of signed 32-bit hashcode </a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RV_ABSOLUTE_VALUE_OF_RANDOM_INT">RV: Bad attempt to compute absolute value of signed random integer</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RV_CHECK_COMPARETO_FOR_SPECIFIC_RETURN_VALUE">RV: Code checks for specific values returned by compareTo</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RV_EXCEPTION_NOT_THROWN">RV: Exception created and dropped rather than thrown</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RV_RETURN_VALUE_IGNORED">RV: La méthode ignore une valeur de retour</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RpC_REPEATED_CONDITIONAL_TEST">RpC: Repeated conditional tests</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SA_FIELD_SELF_ASSIGNMENT">SA: Auto-alimentation d'un champs</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SA_FIELD_SELF_COMPARISON">SA: Self comparison of field with itself</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SA_FIELD_SELF_COMPUTATION">SA: Nonsensical self computation involving a field (e.g., x & x)</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SA_LOCAL_SELF_ASSIGNMENT_INSTEAD_OF_FIELD">SA: Self assignment of local rather than assignment to field</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SA_LOCAL_SELF_COMPARISON">SA: Self comparison of value with itself</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SA_LOCAL_SELF_COMPUTATION">SA: Nonsensical self computation involving a variable (e.g., x & x)</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SF_DEAD_STORE_DUE_TO_SWITCH_FALLTHROUGH">SF: Dead store due to switch statement fall through</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SF_DEAD_STORE_DUE_TO_SWITCH_FALLTHROUGH_TO_THROW">SF: Dead store due to switch statement fall through to throw</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SIC_THREADLOCAL_DEADLY_EMBRACE">SIC: Deadly embrace of non-static inner class and thread local</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SIO_SUPERFLUOUS_INSTANCEOF">SIO: Vérification de type inutile avec l'opérateur instanceof</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SQL_BAD_PREPARED_STATEMENT_ACCESS">SQL: Méthode essayant au paramêtre d'indice 0 d'un PreparedStatement</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SQL_BAD_RESULTSET_ACCESS">SQL: Méthode essayant d'accèder à un champ de ResultSet d'indice 0</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#STI_INTERRUPTED_ON_CURRENTTHREAD">STI: Utilisation superflue d'un appel à currentThread() pour appeler interrupted()</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#STI_INTERRUPTED_ON_UNKNOWNTHREAD">STI: Thread.interrupted() appelée par erreur sur un objet Thread arbitraire</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SE_METHOD_MUST_BE_PRIVATE">Se: Méthode devant être privée pour que la sérialisation fonctionne</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SE_READ_RESOLVE_IS_STATIC">Se: The readResolve method must not be declared as a static method. </a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#TQ_ALWAYS_VALUE_USED_WHERE_NEVER_REQUIRED">TQ: Value annotated as carrying a type qualifier used where a value that must not carry that qualifier is required</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#TQ_COMPARING_VALUES_WITH_INCOMPATIBLE_TYPE_QUALIFIERS">TQ: Comparing values with incompatible type qualifiers</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#TQ_MAYBE_SOURCE_VALUE_REACHES_ALWAYS_SINK">TQ: Value that might not carry a type qualifier is always used in a way requires that type qualifier</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#TQ_MAYBE_SOURCE_VALUE_REACHES_NEVER_SINK">TQ: Value that might carry a type qualifier is always used in a way prohibits it from having that type qualifier</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#TQ_NEVER_VALUE_USED_WHERE_ALWAYS_REQUIRED">TQ: Value annotated as never carrying a type qualifier used where value carrying that qualifier is required</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#TQ_UNKNOWN_VALUE_USED_WHERE_ALWAYS_STRICTLY_REQUIRED">TQ: Value without a type qualifier used where a value is required to have that qualifier</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#UMAC_UNCALLABLE_METHOD_OF_ANONYMOUS_CLASS">UMAC: Méthode non appelable définie dans une classe anonyme</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#UR_UNINIT_READ">UR: Lecture d'un champ non initialisé dans un constructeur</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#UR_UNINIT_READ_CALLED_FROM_SUPER_CONSTRUCTOR">UR: Uninitialized read of field method called from constructor of superclass</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DMI_INVOKING_TOSTRING_ON_ANONYMOUS_ARRAY">USELESS_STRING: Invocation of toString on an unnamed array</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DMI_INVOKING_TOSTRING_ON_ARRAY">USELESS_STRING: Invocation de toString sur un tableau</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#VA_FORMAT_STRING_BAD_CONVERSION_FROM_ARRAY">USELESS_STRING: Array formatted in useless way using format string</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#UWF_NULL_FIELD">UwF: Champ uniquement mis à null</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#UWF_UNWRITTEN_FIELD">UwF: Champ jamais écrit</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#VA_PRIMITIVE_ARRAY_PASSED_TO_OBJECT_VARARG">VA: Tableau de primitives passé à une fonction attendant un nombre variable d'objets en argument</a></td><td>Correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#LG_LOST_LOGGER_DUE_TO_WEAK_REFERENCE">LG: Potential lost logger changes due to weak reference in OpenJDK</a></td><td>Experimental</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#OBL_UNSATISFIED_OBLIGATION">OBL: Method may fail to clean up stream or resource</a></td><td>Experimental</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#OBL_UNSATISFIED_OBLIGATION_EXCEPTION_EDGE">OBL: Method may fail to clean up stream or resource on checked exception</a></td><td>Experimental</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DM_CONVERT_CASE">Dm: La méthode appelle les String.toUpperCase() ou String.toLowerCase ; utilisez plutôt la version paramètrée par une Locale</a></td><td>Internationalization</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DM_DEFAULT_ENCODING">Dm: Reliance on default encoding</a></td><td>Internationalization</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DP_CREATE_CLASSLOADER_INSIDE_DO_PRIVILEGED">DP: Les chargeurs de classes ne doivent être créés qu'à partir de block doPrivileged</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DP_DO_INSIDE_DO_PRIVILEGED">DP: Méthode invoquée alors qu'elle ne devrait l'être qu'à partir d'un block doPrivileged</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#EI_EXPOSE_REP">EI: Une méthode peut exposer sa représentation interne en renvoyant une référence à un objet modifiable</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EI_EXPOSE_REP2">EI2: Une méthode expose sa représentation interne en incorporant une référence à un objet modifiable</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#FI_PUBLIC_SHOULD_BE_PROTECTED">FI: Un finaliseur devrait être protégé, pas public</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EI_EXPOSE_STATIC_REP2">MS: Une méthode peut exposer un état interne statique en stockant un objet modifiable dans un champs statique</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#MS_CANNOT_BE_FINAL">MS: Un champ n'est pas final et ne peut pas être protégé face à du code malveillant</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#MS_EXPOSE_REP">MS: Une méthode statique publique risque d'exposer une représentation interne en renvoyant un tableau</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#MS_FINAL_PKGPROTECT">MS: Le champ devrait être à la fois final et package protected</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#MS_MUTABLE_ARRAY">MS: Un champ est un tableau modifiable</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#MS_MUTABLE_HASHTABLE">MS: Un champ modifiable est une Hashtable</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#MS_OOI_PKGPROTECT">MS: Le champ devrait être sorti de l'interface et mis en package protected</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#MS_PKGPROTECT">MS: Un champ devrait être package protected</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#MS_SHOULD_BE_FINAL">MS: Un champ n'est pas final alors qu'il devrait l'être</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#MS_SHOULD_BE_REFACTORED_TO_BE_FINAL">MS: Field isn't final but should be refactored to be so</a></td><td>Malicious code vulnerability</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#AT_OPERATION_SEQUENCE_ON_CONCURRENT_ABSTRACTION">AT: Sequence of calls to concurrent abstraction may not be atomic</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DC_DOUBLECHECK">DC: Possible double vérification d'un champ</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DL_SYNCHRONIZATION_ON_BOOLEAN">DL: Synchronization on Boolean</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DL_SYNCHRONIZATION_ON_BOXED_PRIMITIVE">DL: Synchronization on boxed primitive</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DL_SYNCHRONIZATION_ON_SHARED_CONSTANT">DL: Synchronization on interned String </a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DL_SYNCHRONIZATION_ON_UNSHARED_BOXED_PRIMITIVE">DL: Synchronization on boxed primitive values</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DM_MONITOR_WAIT_ON_CONDITION">Dm: Wait() appelé sur une Condition</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DM_USELESS_THREAD">Dm: Thread créé avec la méthode run vide par défaut</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#ESync_EMPTY_SYNC">ESync: Bloc synchronisé vide</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#IS2_INCONSISTENT_SYNC">IS: Synchronisation incohérente</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#IS_FIELD_NOT_GUARDED">IS: Champ non protégé contre les accès concurrents</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#JLM_JSR166_LOCK_MONITORENTER">JLM: Synchronisation effectuée sur un Lock java.util.concurrent</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#JLM_JSR166_UTILCONCURRENT_MONITORENTER">JLM: Synchronization performed on util.concurrent instance</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#JML_JSR166_CALLING_WAIT_RATHER_THAN_AWAIT">JLM: Using monitor style wait methods on util.concurrent abstraction</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#LI_LAZY_INIT_STATIC">LI: Initialisation paresseuse incorrecte d'un champ statique</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#LI_LAZY_INIT_UPDATE_STATIC">LI: Incorrect lazy initialization and update of static field</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#ML_SYNC_ON_FIELD_TO_GUARD_CHANGING_THAT_FIELD">ML: Synchronization on field in futile attempt to guard that field</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#ML_SYNC_ON_UPDATED_FIELD">ML: La méthode se synchronise sur un champ mis à jour</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#MSF_MUTABLE_SERVLET_FIELD">MSF: Mutable servlet field</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#MWN_MISMATCHED_NOTIFY">MWN: notify() non appareillé</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#MWN_MISMATCHED_WAIT">MWN: wait() non appareillé</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NN_NAKED_NOTIFY">NN: Appel notify() isolé dans une méthode</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_SYNC_AND_NULL_CHECK_FIELD">NP: Synchronize and null check on the same field.</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NO_NOTIFY_NOT_NOTIFYALL">No: Utilisation de notify() plutôt que notifyAll() dans une méthode</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RS_READOBJECT_SYNC">RS: Seule la méthode readObject() est synchronisée</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RV_RETURN_VALUE_OF_PUTIFABSENT_IGNORED">RV: Return value of putIfAbsent ignored, value passed to putIfAbsent reused</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RU_INVOKE_RUN">Ru: Invocation de run() sur un thread (Vouliez-vous plutôt dire start() ?)</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SC_START_IN_CTOR">SC: Un constructeur invoque Thread.start()</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SP_SPIN_ON_FIELD">SP: Méthode bouclant sur un champ</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#STCAL_INVOKE_ON_STATIC_CALENDAR_INSTANCE">STCAL: Call to static Calendar</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#STCAL_INVOKE_ON_STATIC_DATE_FORMAT_INSTANCE">STCAL: Call to static DateFormat</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#STCAL_STATIC_CALENDAR_INSTANCE">STCAL: Static Calendar field</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#STCAL_STATIC_SIMPLE_DATE_FORMAT_INSTANCE">STCAL: Static DateFormat</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SWL_SLEEP_WITH_LOCK_HELD">SWL: Appel de la méthode Thread.sleep() avec un verrou</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#TLW_TWO_LOCK_WAIT">TLW: wait() avec deux verrous en attente</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#UG_SYNC_SET_UNSYNC_GET">UG: Méthode getXXX non synchronisée, méthode setXXX synchronisée</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#UL_UNRELEASED_LOCK">UL: La méthode ne libère pas un verrou dans tous les chemins d'exécution</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#UL_UNRELEASED_LOCK_EXCEPTION_PATH">UL: La méthode ne libère pas un verrou dans tous les chemins d'exception</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#UW_UNCOND_WAIT">UW: Méthode contenant un wait() non conditionné</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#VO_VOLATILE_INCREMENT">VO: An increment to a volatile field isn't atomic</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#VO_VOLATILE_REFERENCE_TO_ARRAY">VO: Une référence volatile à un tableau ne traite pas les éléments du tableau comme volatiles</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#WL_USING_GETCLASS_RATHER_THAN_CLASS_LITERAL">WL: Synchronization on getClass rather than class literal</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#WS_WRITEOBJECT_SYNC">WS: Seule la méthode writeObject() est synchronisée</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#WA_AWAIT_NOT_IN_LOOP">Wa: Condition.await() en dehors d'une boucle</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#WA_NOT_IN_LOOP">Wa: Méthode contenant un wait() en dehors d'une boucle</a></td><td>Multithreaded correctness</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#BX_BOXING_IMMEDIATELY_UNBOXED">Bx: Primitive value is boxed and then immediately unboxed</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#BX_BOXING_IMMEDIATELY_UNBOXED_TO_PERFORM_COERCION">Bx: Primitive value is boxed then unboxed to perform primitive coercion</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#BX_UNBOXING_IMMEDIATELY_REBOXED">Bx: Boxed value is unboxed and then immediately reboxed</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DM_BOXED_PRIMITIVE_FOR_PARSING">Bx: Boxing/unboxing to parse a primitive</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DM_BOXED_PRIMITIVE_TOSTRING">Bx: Méthode allouant une primitive boxed pour appeler toString</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DM_FP_NUMBER_CTOR">Bx: Method invokes inefficient floating-point Number constructor; use static valueOf instead</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DM_NUMBER_CTOR">Bx: Method invokes inefficient Number constructor; use static valueOf instead</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DMI_BLOCKING_METHODS_ON_URL">Dm: The equals and hashCode methods of URL are blocking</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DMI_COLLECTION_OF_URLS">Dm: Maps and sets of URLs can be performance hogs</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DM_BOOLEAN_CTOR">Dm: La méthode invoque le constructeur inutile Boolean() ; utilisez Boolean.valueOf(...) à la place</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DM_GC">Dm: Ramasse-miettes explicite ; extrêmement douteux sauf dans du code de banc d'essai</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DM_NEW_FOR_GETCLASS">Dm: Méthode allouant un objet juste pour obtenir la classe</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DM_NEXTINT_VIA_NEXTDOUBLE">Dm: Utiliser la méthode nextInt de Random plutôt que nextDouble pour générer un entier aléatoire</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DM_STRING_CTOR">Dm: La méthode invoque le constructeur inutile String(String) ; utilisez juste l'argument</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DM_STRING_TOSTRING">Dm: La méthode appel toString() sur un objet String ; utilisez directement l'objet String</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DM_STRING_VOID_CTOR">Dm: La méthode invoque le constructeur inutile String() ; utilisez juste ""</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#HSC_HUGE_SHARED_STRING_CONSTANT">HSC: Huge string constants is duplicated across multiple class files</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#IIO_INEFFICIENT_INDEX_OF">IIO: Inefficient use of String.indexOf(String)</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#IIO_INEFFICIENT_LAST_INDEX_OF">IIO: Inefficient use of String.lastIndexOf(String)</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#ITA_INEFFICIENT_TO_ARRAY">ITA: La méthode utilise toArray() avec un tableau vide en paramètre</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SBSC_USE_STRINGBUFFER_CONCATENATION">SBSC: La méthode concatène des chaînes au moyen de + en boucle</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SIC_INNER_SHOULD_BE_STATIC">SIC: Devrait être une classe interne statique</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SIC_INNER_SHOULD_BE_STATIC_ANON">SIC: Peut-être transformée en classe interne statique nommée</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SIC_INNER_SHOULD_BE_STATIC_NEEDS_THIS">SIC: Pourrait-être transformée en classe interne statique</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SS_SHOULD_BE_STATIC">SS: Champ non lu : devrait-il être statique ?</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#UM_UNNECESSARY_MATH">UM: Appel d'une méthode statique de la classe Math sur une valeur constante</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#UPM_UNCALLED_PRIVATE_METHOD">UPM: Méthode privée jamais appelée</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#URF_UNREAD_FIELD">UrF: Champ inutilisé</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#UUF_UNUSED_FIELD">UuF: Champ inutilisé</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#WMI_WRONG_MAP_ITERATOR">WMI: Utilisation inefficace d'un itérateur sur keySet au lieu de entrySet</a></td><td>Performance</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DMI_CONSTANT_DB_PASSWORD">Dm: Hardcoded constant database password</a></td><td>Security</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DMI_EMPTY_DB_PASSWORD">Dm: Empty database password</a></td><td>Security</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#HRS_REQUEST_PARAMETER_TO_COOKIE">HRS: HTTP cookie formed from untrusted input</a></td><td>Security</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#HRS_REQUEST_PARAMETER_TO_HTTP_HEADER">HRS: HTTP Response splitting vulnerability</a></td><td>Security</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#PT_ABSOLUTE_PATH_TRAVERSAL">PT: Absolute path traversal in servlet</a></td><td>Security</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#PT_RELATIVE_PATH_TRAVERSAL">PT: Relative path traversal in servlet</a></td><td>Security</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SQL_NONCONSTANT_STRING_PASSED_TO_EXECUTE">SQL: Une chaîne non constante est passée à la méthode execute d'une commande SQL</a></td><td>Security</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SQL_PREPARED_STATEMENT_GENERATED_FROM_NONCONSTANT_STRING">SQL: Une requète est préparée à partir d'une chaine non constante</a></td><td>Security</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#XSS_REQUEST_PARAMETER_TO_JSP_WRITER">XSS: JSP reflected cross site scripting vulnerability</a></td><td>Security</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#XSS_REQUEST_PARAMETER_TO_SEND_ERROR">XSS: Servlet reflected cross site scripting vulnerability in error page</a></td><td>Security</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#XSS_REQUEST_PARAMETER_TO_SERVLET_WRITER">XSS: Servlet reflected cross site scripting vulnerability</a></td><td>Security</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#BC_BAD_CAST_TO_ABSTRACT_COLLECTION">BC: Transtypage douteux d'un type Collection vers une classe abstraite</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#BC_BAD_CAST_TO_CONCRETE_COLLECTION">BC: Transtypage douteux vers une collection concrète</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#BC_UNCONFIRMED_CAST">BC: Transtypage non vérifié/non confirmé</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#BC_UNCONFIRMED_CAST_OF_RETURN_VALUE">BC: Unchecked/unconfirmed cast of return value from method</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#BC_VACUOUS_INSTANCEOF">BC: instanceof renverra toujours vrai</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#ICAST_QUESTIONABLE_UNSIGNED_RIGHT_SHIFT">BSHIFT: Décalage à droite non signé et transtypage short/byte</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#CI_CONFUSED_INHERITANCE">CI: Classe finale déclarant un champ protégé</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DB_DUPLICATE_BRANCHES">DB: Méthode utilsant le même code pour deux branches</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DB_DUPLICATE_SWITCH_CLAUSES">DB: Méthode utilisant le même code pour deux clauses switch</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DLS_DEAD_LOCAL_STORE">DLS: Alimentation à perte d'une variable locale</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DLS_DEAD_LOCAL_STORE_IN_RETURN">DLS: Useless assignment in return statement</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DLS_DEAD_LOCAL_STORE_OF_NULL">DLS: Alimentation à null d'une variable</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DLS_DEAD_LOCAL_STORE_SHADOWS_FIELD">DLS: Dead store to local variable that shadows field</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DMI_HARDCODED_ABSOLUTE_FILENAME">DMI: Chemin absolu codé en dur dans le code</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DMI_NONSERIALIZABLE_OBJECT_WRITTEN">DMI: Objet non sérialisable écrit dans un ObjectOutput</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#DMI_USELESS_SUBSTRING">DMI: Appel de substring(0) qui retourne la valeur originale</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#DMI_THREAD_PASSED_WHERE_RUNNABLE_EXPECTED">Dm: Thread passed where Runnable expected</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#EQ_DOESNT_OVERRIDE_EQUALS">Eq: Class doesn't override equals in superclass</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#EQ_UNUSUAL">Eq: Unusual equals method </a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#FE_FLOATING_POINT_EQUALITY">FE: Test d'égalité en virgule flottante.</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#VA_FORMAT_STRING_BAD_CONVERSION_TO_BOOLEAN">FS: Non-Boolean argument formatted using %b format specifier</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#IA_AMBIGUOUS_INVOCATION_OF_INHERITED_OR_OUTER_METHOD">IA: Appel ambigu d'une méthode hérité ou externe</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#IC_INIT_CIRCULARITY">IC: Initialisation circulaire</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#ICAST_IDIV_CAST_TO_DOUBLE">ICAST: Résultat d'une division entière transtypé en nombre flottant</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#ICAST_INTEGER_MULTIPLY_CAST_TO_LONG">ICAST: Résultat d'une multiplication entière transtypée en long</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#IM_AVERAGE_COMPUTATION_COULD_OVERFLOW">IM: Possibilité de débordement du calcul d'une moyenne</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#IM_BAD_CHECK_FOR_ODD">IM: Test d'impaire ne fonctionnant pas avec les négatifs</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#INT_BAD_REM_BY_1">INT: Reste entier modulo 1</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#INT_VACUOUS_BIT_OPERATION">INT: Vacuous bit mask operation on integer value</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#INT_VACUOUS_COMPARISON">INT: Comparaison inutile de valeurs entières</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#MTIA_SUSPECT_SERVLET_INSTANCE_FIELD">MTIA: La classe hérite de Servlet et utilise les variables de l'instance.</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#MTIA_SUSPECT_STRUTS_INSTANCE_FIELD">MTIA: La classe hérite d'une classe action Struts et utilise les variables de l'instance.</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_DEREFERENCE_OF_READLINE_VALUE">NP: Dereference of the result of readLine() without nullcheck</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_IMMEDIATE_DEREFERENCE_OF_READLINE">NP: Déréférencement immédiat du résultat d'un readLine()</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_LOAD_OF_KNOWN_NULL_VALUE">NP: Chargement d'une valeur connue pour être à null</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_METHOD_PARAMETER_TIGHTENS_ANNOTATION">NP: Method tightens nullness annotation on parameter</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_METHOD_RETURN_RELAXING_ANNOTATION">NP: Method relaxes nullness annotation on return value</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_NULL_ON_SOME_PATH_FROM_RETURN_VALUE">NP: Pointeur à null renvoyé par une méthode qui risque d'être déréférencé</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_NULL_ON_SOME_PATH_MIGHT_BE_INFEASIBLE">NP: Possible null pointer dereference on branch that might be infeasible</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NP_PARAMETER_MUST_BE_NONNULL_BUT_MARKED_AS_NULLABLE">NP: Parameter must be nonnull but is marked as nullable</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NP_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD">NP: Read of unwritten public or protected field</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#NS_DANGEROUS_NON_SHORT_CIRCUIT">NS: Potentially dangerous use of non-short-circuit logic</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#NS_NON_SHORT_CIRCUIT">NS: Utilisation discutable de logique binaire</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#PZLA_PREFER_ZERO_LENGTH_ARRAYS">PZLA: Envisagez de renvoyer un tableau vide plutôt que null</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#QF_QUESTIONABLE_FOR_LOOP">QF: Incrémentation compliquée, subtile au incorrecte dans une boucle for</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RCN_REDUNDANT_COMPARISON_OF_NULL_AND_NONNULL_VALUE">RCN: Comparaison redondante d'une valeur non nulle avec null</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RCN_REDUNDANT_COMPARISON_TWO_NULL_VALUES">RCN: Comparaison redondante de deux valeurs nulles</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RCN_REDUNDANT_NULLCHECK_OF_NONNULL_VALUE">RCN: Test de nullité redondant sur une valeur non nulle</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RCN_REDUNDANT_NULLCHECK_OF_NULL_VALUE">RCN: Test de nullité redondant sur une valeur connue pour être à null</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#REC_CATCH_EXCEPTION">REC: java.lang.Exception est intercepté alors qu'Exception n'est jamais lancé</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RI_REDUNDANT_INTERFACES">RI: Classe implémentant la même interface que sa super-classe</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RV_CHECK_FOR_POSITIVE_INDEXOF">RV: Méthode vérifiant que le résultat d'un String.indexOf() est positif</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RV_DONT_JUST_NULL_CHECK_READLINE">RV: Méthode ignorant le résultat d'un readLine() après avoir vérifié qu'il est non nul</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RV_REM_OF_HASHCODE">RV: Reste d'un hashCode pouvant être négatif</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#RV_REM_OF_RANDOM_INT">RV: Reste d'un entier signé 32 bits aléeatoire</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#RV_RETURN_VALUE_IGNORED_INFERRED">RV: Method ignores return value, is this OK?</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SA_FIELD_DOUBLE_ASSIGNMENT">SA: Double assignment of field</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SA_LOCAL_DOUBLE_ASSIGNMENT">SA: Double assignment of local variable </a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SA_LOCAL_SELF_ASSIGNMENT">SA: Auto-alimentation d'une variable locale</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SF_SWITCH_FALLTHROUGH">SF: Un switch comporte un cas qui déborde sur le suivant</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SF_SWITCH_NO_DEFAULT">SF: Switch statement found where default case is missing</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#ST_WRITE_TO_STATIC_FROM_INSTANCE_METHOD">ST: Ecriture d'un champ statique depuis la méthode d'une instance</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#SE_PRIVATE_READ_RESOLVE_NOT_INHERITED">Se: Private readResolve method not inherited by subclasses</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#SE_TRANSIENT_FIELD_OF_NONSERIALIZABLE_CLASS">Se: Transient field of class that isn't Serializable. </a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#TQ_EXPLICIT_UNKNOWN_SOURCE_VALUE_REACHES_ALWAYS_SINK">TQ: Value required to have type qualifier, but marked as unknown</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#TQ_EXPLICIT_UNKNOWN_SOURCE_VALUE_REACHES_NEVER_SINK">TQ: Value required to not have type qualifier, but marked as unknown</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#UCF_USELESS_CONTROL_FLOW">UCF: Instruction de contrôle du flux inutile</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#UCF_USELESS_CONTROL_FLOW_NEXT_LINE">UCF: Useless control flow to next line</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#URF_UNREAD_PUBLIC_OR_PROTECTED_FIELD">UrF: Unread public/protected field</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#UUF_UNUSED_PUBLIC_OR_PROTECTED_FIELD">UuF: Unused public or protected field</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#UWF_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR">UwF: Champ non initialisé dans le constructeur</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#eeeeee"><td><a href="#UWF_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD">UwF: Unwritten public or protected field</a></td><td>Dodgy code</td></tr>
|
| +<tr bgcolor="#ffffff"><td><a href="#XFB_XML_FACTORY_BYPASS">XFB: Méthode instanciant directement une implémentation spécifique des interfaces XML</a></td><td>Dodgy code</td></tr>
|
| +</table>
|
| +<h2>Descriptions</h2>
|
| +<h3><a name="BC_EQUALS_METHOD_SHOULD_WORK_FOR_ALL_OBJECTS">BC: Equals method should not assume anything about the type of its argument (BC_EQUALS_METHOD_SHOULD_WORK_FOR_ALL_OBJECTS)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +The <code>equals(Object o)</code> method shouldn't make any assumptions
|
| +about the type of <code>o</code>. It should simply return
|
| +false if <code>o</code> is not the same type as <code>this</code>.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="BIT_SIGNED_CHECK">BIT: Check for sign of bitwise operation (BIT_SIGNED_CHECK)</a></h3>
|
| +
|
| +
|
| +<p> This method compares an expression such as</p>
|
| +<pre>((event.detail & SWT.SELECTED) > 0)</pre>.
|
| +<p>Using bit arithmetic and then comparing with the greater than operator can
|
| +lead to unexpected results (of course depending on the value of
|
| +SWT.SELECTED). If SWT.SELECTED is a negative number, this is a candidate
|
| +for a bug. Even when SWT.SELECTED is not negative, it seems good practice
|
| +to use '!= 0' instead of '> 0'.
|
| +</p>
|
| +<p>
|
| +<em>Boris Bokowski</em>
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="CN_IDIOM">CN: La classe implémente Cloneable mais ne définit et n'utilise pas la méthode clone() (CN_IDIOM)</a></h3>
|
| +
|
| +
|
| +<p>La classe implémente <code>Cloneable</code> sans définir ou utiliser la méthode <code>clone()</code>.</p>
|
| +
|
| +
|
| +<h3><a name="CN_IDIOM_NO_SUPER_CALL">CN: La méthode clone() n'appelle pas super.clone() (CN_IDIOM_NO_SUPER_CALL)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit une méthode <code>clone()</code> qui n'appelle pas <code>super.clone()</code>, et n'est pas finale. Si cette classe ("<i>A</i>") est étendue par une classe fille ("<i>B</i>"), et que la classe fille <i>B</i> appelle <code>super.clone()</code>, alors il est probable que la méthode <code>clone()</code> de <i>B</i> retournera un objet de type <i>A</i>, ce qui viole le contrat standard de <code>clone()</code>.</p>
|
| +<p>Si toutes les méthodes <code>clone()</code> appellent <code>super.clone()</code>, elles ont alors la garantie d'utiliser <code>Object.clone()</code>, qui retourne toujours un objet du type correct.</p>
|
| +
|
| +
|
| +<h3><a name="CN_IMPLEMENTS_CLONE_BUT_NOT_CLONEABLE">CN: Class defines clone() but doesn't implement Cloneable (CN_IMPLEMENTS_CLONE_BUT_NOT_CLONEABLE)</a></h3>
|
| +
|
| +
|
| +<p> This class defines a clone() method but the class doesn't implement Cloneable.
|
| +There are some situations in which this is OK (e.g., you want to control how subclasses
|
| +can clone themselves), but just make sure that this is what you intended.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="CNT_ROUGH_CONSTANT_VALUE">CNT: Rough value of known constant found (CNT_ROUGH_CONSTANT_VALUE)</a></h3>
|
| +
|
| +
|
| + <p>It's recommended to use the predefined library constant for code clarity and better precision.</p>
|
| +
|
| +
|
| +<h3><a name="CO_ABSTRACT_SELF">Co: Une classe abstraite définit une méthode compareTo() covariante (CO_ABSTRACT_SELF)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit une version covariante de <code>compareTo()</code>. Pour surcharger correctement la méthode <code>compareTo()</code> de l'interface <code>Comparable</code>, le paramètre de <code>compareTo()</code> doit être du type <code>java.lang.Object</code>.</p>
|
| +
|
| +
|
| +<h3><a name="CO_SELF_NO_OBJECT">Co: Définition d'une méthode compareTo() covariante (CO_SELF_NO_OBJECT)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit une version covariante de <code>compareTo()</code>. Pour correctement surcharger la méthode <code>compareTo() </code>de l'interface <code>Comparable</code>, le paramètre de <code>compareTo()</code> doit être du type <code>java.lang.Object</code>.</p>
|
| +
|
| +
|
| +<h3><a name="DE_MIGHT_DROP">DE: La méthode peut déclencher une exception (DE_MIGHT_DROP)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode peut déclencher une exception. En général, les exceptions doivent être gérées ou transmises hors de la méthode.</p>
|
| +
|
| +
|
| +<h3><a name="DE_MIGHT_IGNORE">DE: La méthode peut ignorer une exception (DE_MIGHT_IGNORE)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode peut ignorer une exception. En général, les exceptions doivent être gérées ou transmises hors de la méthode.</p>
|
| +
|
| +
|
| +<h3><a name="DMI_ENTRY_SETS_MAY_REUSE_ENTRY_OBJECTS">DMI: Adding elements of an entry set may fail due to reuse of Entry objects (DMI_ENTRY_SETS_MAY_REUSE_ENTRY_OBJECTS)</a></h3>
|
| +
|
| +
|
| + <p> The entrySet() method is allowed to return a view of the
|
| + underlying Map in which a single Entry object is reused and returned
|
| + during the iteration. As of Java 1.6, both IdentityHashMap
|
| + and EnumMap did so. When iterating through such a Map,
|
| + the Entry value is only valid until you advance to the next iteration.
|
| + If, for example, you try to pass such an entrySet to an addAll method,
|
| + things will go badly wrong.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="DMI_RANDOM_USED_ONLY_ONCE">DMI: Random object created and used only once (DMI_RANDOM_USED_ONLY_ONCE)</a></h3>
|
| +
|
| +
|
| +<p> This code creates a java.util.Random object, uses it to generate one random number, and then discards
|
| +the Random object. This produces mediocre quality random numbers and is inefficient.
|
| +If possible, rewrite the code so that the Random object is created once and saved, and each time a new random number
|
| +is required invoke a method on the existing Random object to obtain it.
|
| +</p>
|
| +
|
| +<p>If it is important that the generated Random numbers not be guessable, you <em>must</em> not create a new Random for each random
|
| +number; the values are too easily guessable. You should strongly consider using a java.security.SecureRandom instead
|
| +(and avoid allocating a new SecureRandom for each random number needed).
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="DMI_USING_REMOVEALL_TO_CLEAR_COLLECTION">DMI: Don't use removeAll to clear a collection (DMI_USING_REMOVEALL_TO_CLEAR_COLLECTION)</a></h3>
|
| +
|
| +
|
| + <p> If you want to remove all elements from a collection <code>c</code>, use <code>c.clear</code>,
|
| +not <code>c.removeAll(c)</code>. Calling <code>c.removeAll(c)</code> to clear a collection
|
| +is less clear, susceptible to errors from typos, less efficient and
|
| +for some collections, might throw a <code>ConcurrentModificationException</code>.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="DM_EXIT">Dm: La méthode invoque System.exit(...) (DM_EXIT)</a></h3>
|
| +
|
| +
|
| +<p>Invoquer <code>System.exit()</code> arrête toute la JVM. Cela ne doit être fait que lorsque c'est nécessaire. De tels appels rendent difficile ou impossible l'invocation de votre code par d'autre code. Envisagez de déclencher une <code>RuntimeException</code> à la place.</p>
|
| +
|
| +
|
| +<h3><a name="DM_RUN_FINALIZERS_ON_EXIT">Dm: Méthode invoquant runFinalizersOnExit, l'une des plus dangeureuses méthodes des librairies Java (DM_RUN_FINALIZERS_ON_EXIT)</a></h3>
|
| +
|
| +
|
| +<p>N'appelez jamais <code>System.runFinalizersOnExit</code> ou <code>Runtime.runFinalizersOnExit</code> pour quelque raison que ce soit : elles font partie des méthodes les plus dangeureuses des librairies Java</p>
|
| +<p>Joshua Bloch</p>
|
| +
|
| +
|
| +<h3><a name="ES_COMPARING_PARAMETER_STRING_WITH_EQ">ES: Comparison of String parameter using == or != (ES_COMPARING_PARAMETER_STRING_WITH_EQ)</a></h3>
|
| +
|
| +
|
| + <p>This code compares a <code>java.lang.String</code> parameter for reference
|
| +equality using the == or != operators. Requiring callers to
|
| +pass only String constants or interned strings to a method is unnecessarily
|
| +fragile, and rarely leads to measurable performance gains. Consider
|
| +using the <code>equals(Object)</code> method instead.</p>
|
| +
|
| +
|
| +<h3><a name="ES_COMPARING_STRINGS_WITH_EQ">ES: Comparaison d'objets String utilisant == ou != (ES_COMPARING_STRINGS_WITH_EQ)</a></h3>
|
| +
|
| +
|
| +<p>Ce code compare des objets <code>java.lang.String</code> au moyen de l'égalité par référence des opérateurs <code>==</code> ou <code>!=</code>. A moins que les deux chaînes ne soient des constantes dans le fichier source ou aient été internalisées au moyen de la méthode <code>String.intern()</code>, deux chaînes identiques peuvent être représentées par deux objets <code>String</code> différents. Envisagez d'utiliser la méthode <code>equals(Object)</code> à la place.</p>
|
| +
|
| +
|
| +<h3><a name="EQ_ABSTRACT_SELF">Eq: Une classe abstraite définit une méthode equals() covariante (EQ_ABSTRACT_SELF)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit une version covariante de la méthode <code>equals()</code>. Pour surcharger correctement la méthode <code>equals()</code> de <code>java.lang.Object</code>, le paramètre de <code>equals()</code> doit être du type <code>java.lang.Object</code>.</p>
|
| +
|
| +
|
| +<h3><a name="EQ_CHECK_FOR_OPERAND_NOT_COMPATIBLE_WITH_THIS">Eq: Equals checks for incompatible operand (EQ_CHECK_FOR_OPERAND_NOT_COMPATIBLE_WITH_THIS)</a></h3>
|
| +
|
| +
|
| + <p> This equals method is checking to see if the argument is some incompatible type
|
| +(i.e., a class that is neither a supertype nor subtype of the class that defines
|
| +the equals method). For example, the Foo class might have an equals method
|
| +that looks like:
|
| +</p>
|
| +<pre>
|
| +public boolean equals(Object o) {
|
| + if (o instanceof Foo)
|
| + return name.equals(((Foo)o).name);
|
| + else if (o instanceof String)
|
| + return name.equals(o);
|
| + else return false;
|
| +</pre>
|
| +
|
| +<p>This is considered bad practice, as it makes it very hard to implement an equals method that
|
| +is symmetric and transitive. Without those properties, very unexpected behavoirs are possible.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="EQ_COMPARETO_USE_OBJECT_EQUALS">Eq: Class defines compareTo(...) and uses Object.equals() (EQ_COMPARETO_USE_OBJECT_EQUALS)</a></h3>
|
| +
|
| +
|
| + <p> This class defines a <code>compareTo(...)</code> method but inherits its
|
| + <code>equals()</code> method from <code>java.lang.Object</code>.
|
| + Generally, the value of compareTo should return zero if and only if
|
| + equals returns true. If this is violated, weird and unpredictable
|
| + failures will occur in classes such as PriorityQueue.
|
| + In Java 5 the PriorityQueue.remove method uses the compareTo method,
|
| + while in Java 6 it uses the equals method.
|
| +
|
| +<p>From the JavaDoc for the compareTo method in the Comparable interface:
|
| +<blockquote>
|
| +It is strongly recommended, but not strictly required that <code>(x.compareTo(y)==0) == (x.equals(y))</code>.
|
| +Generally speaking, any class that implements the Comparable interface and violates this condition
|
| +should clearly indicate this fact. The recommended language
|
| +is "Note: this class has a natural ordering that is inconsistent with equals."
|
| +</blockquote>
|
| +
|
| +
|
| +<h3><a name="EQ_GETCLASS_AND_CLASS_CONSTANT">Eq: equals method fails for subtypes (EQ_GETCLASS_AND_CLASS_CONSTANT)</a></h3>
|
| +
|
| +
|
| + <p> This class has an equals method that will be broken if it is inherited by subclasses.
|
| +It compares a class literal with the class of the argument (e.g., in class <code>Foo</code>
|
| +it might check if <code>Foo.class == o.getClass()</code>).
|
| +It is better to check if <code>this.getClass() == o.getClass()</code>.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="EQ_SELF_NO_OBJECT">Eq: Définition d'une méthode equals() covariante (EQ_SELF_NO_OBJECT)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit une version covariante de <code>equals()</code>. Pour surcharger correctement la méthode <code>equals()</code> de <code>java.lang.Object</code>, le paramètre de <code>equals()</code> doit être du type <code>java.lang.Object</code>.</p>
|
| +
|
| +
|
| +<h3><a name="FI_EMPTY">FI: Un finaliseur vide devrait être supprimé (FI_EMPTY)</a></h3>
|
| +
|
| +
|
| +<p>Les méthodes <code>finalize()</code> vides sont inutiles, donc elles devraient être supprimées.</p>
|
| +
|
| +
|
| +<h3><a name="FI_EXPLICIT_INVOCATION">FI: Invocation explicite d'un finaliseur (FI_EXPLICIT_INVOCATION)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient un appel explicite à la méthode <code>finalize()</code> d'un objet. Les méthodes <code>finalize()</code> étant sensées n'être appelées qu'une fois, et uniquement par la JVM, c'est une mauvaise idée.</p>
|
| +
|
| +
|
| +<h3><a name="FI_FINALIZER_NULLS_FIELDS">FI: Finalizer nulls fields (FI_FINALIZER_NULLS_FIELDS)</a></h3>
|
| +
|
| +
|
| + <p> This finalizer nulls out fields. This is usually an error, as it does not aid garbage collection,
|
| + and the object is going to be garbage collected anyway.
|
| +
|
| +
|
| +<h3><a name="FI_FINALIZER_ONLY_NULLS_FIELDS">FI: Finalizer only nulls fields (FI_FINALIZER_ONLY_NULLS_FIELDS)</a></h3>
|
| +
|
| +
|
| + <p> This finalizer does nothing except null out fields. This is completely pointless, and requires that
|
| +the object be garbage collected, finalized, and then garbage collected again. You should just remove the finalize
|
| +method.
|
| +
|
| +
|
| +<h3><a name="FI_MISSING_SUPER_CALL">FI: Le finaliseur n'appelle pas le finaliseur de la super-classe (FI_MISSING_SUPER_CALL)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode <code>finalize()</code> n'appelle pas la méthode <code>finalize()</code> de sa classe mère ; donc toutes les actions définies au niveau de la classe mère seront ignorées. Ajoutez un appel à <code>super.finalize()</code>.</p>
|
| +
|
| +
|
| +<h3><a name="FI_NULLIFY_SUPER">FI: Un finaliseur rend inutile celui de sa super-classe (FI_NULLIFY_SUPER)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode <code>finalize()</code> vide rend explicitement inutile tout finaliseur défini dans les super-classes. Toute action définie dans un finaliseur d'une superclasse sera ignorée. A moins que cela ne soit voulu, supprimer cette méthode.</p>
|
| +
|
| +
|
| +<h3><a name="FI_USELESS">FI: Le finaliseur ne fait rien sauf appeler celui de la super-classe (FI_USELESS)</a></h3>
|
| +
|
| +
|
| +<p>La seule chose que cette méthode <code>finalize()</code> fait est d'appeler la méthode <code>finalize()</code> de la super-classe, ce qui la rend redondante. Supprimez la.</p>
|
| +
|
| +
|
| +<h3><a name="VA_FORMAT_STRING_USES_NEWLINE">FS: Format string should use %n rather than \n (VA_FORMAT_STRING_USES_NEWLINE)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +This format string include a newline character (\n). In format strings, it is generally
|
| + preferable better to use %n, which will produce the platform-specific line separator.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="GC_UNCHECKED_TYPE_IN_GENERIC_CALL">GC: Unchecked type in generic call (GC_UNCHECKED_TYPE_IN_GENERIC_CALL)</a></h3>
|
| +
|
| +
|
| + <p> This call to a generic collection method passes an argument
|
| + while compile type Object where a specific type from
|
| + the generic type parameters is expected.
|
| + Thus, neither the standard Java type system nor static analysis
|
| + can provide useful information on whether the
|
| + object being passed as a parameter is of an appropriate type.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="HE_EQUALS_NO_HASHCODE">HE: La classe définit equals() mais pas hashCode() (HE_EQUALS_NO_HASHCODE)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe surcharge <code>equals(Object)</code>, mais pas <code>hashCode()</code>. C'est pourquoi la classe peut violer le contrat indiquant que des objets égaux doivent avoir des codes de hachage identiques.</p>
|
| +
|
| +
|
| +<h3><a name="HE_EQUALS_USE_HASHCODE">HE: La classe définit equals() et utilise Object.hashCode() (HE_EQUALS_USE_HASHCODE)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe surcharge <code>equals(Object)</code>, pas <code>hashCode()</code>, et hérite de l'implémentation de <code>hashCode()</code> issue de <code>java.lang.Object</code> (qui renvoie le code de hachage d'identité, une valeur arbitraire assignée à l'objet par la JVM). C'est pourquoi la classe a des chances de violer le contrat impliquant que des objets égaux doivent avoir des codes de hachage identiques.</p>
|
| +<p>Si vous ne pensez pas que des instances de cette classe soient un jour insérés dans des<code>HashMap</code>/<code>Hashtable</code>, l'implémentation recommendée est du type :</p>
|
| +<p><pre>
|
| +public int hashCode() {
|
| + assert false : "hashCode not designed";
|
| + return 42; // any arbitrary constant will do
|
| +}
|
| +</pre></p>
|
| +
|
| +
|
| +<h3><a name="HE_HASHCODE_NO_EQUALS">HE: La classe définit hashCode() mais pas equals() (HE_HASHCODE_NO_EQUALS)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit une méthode <code>hashCode()</code> mais pas de méthode <code>equals()</code>. C'est pourquoi cette classe peut violer le contrat indiquant que des objets identiques doivent avoir des codes de hachage identiques.</p>
|
| +
|
| +
|
| +<h3><a name="HE_HASHCODE_USE_OBJECT_EQUALS">HE: La classe définit hashCode() et utilise Object.equals() (HE_HASHCODE_USE_OBJECT_EQUALS)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit une méthode <code>hashCode()</code> mais hérite la méthode <code>equals()</code> de <code>java.lang.Object</code> (qui définit l'égalité par comparaison des références des objets). Bien que cela satisfasse certainement le contrat indiquant que les objets égaux doivent avoir des codes de hachage égaux, ce n'est certainement pas ce qui était voulu lors de la surcharge de la méthode <code>hashCode()</code> (Surcharger <code>hashCode()</code> implique que l'identité des objets soit basée sur des critères plus compliqués qu'une simple égalités des références.)</p>
|
| +<p>Si vous ne pensez pas que des instances de cette classe soient un jour insérées dans des <code>HashMap</code>/<code>HashTable</code>, l'implémentation recommendée de <code>hashCode</code> est :</p>
|
| +<p><pre>
|
| +public int hashCode() {
|
| + assert false : "hashCode not designed";
|
| + return 42; // any arbitrary constant will do
|
| + }
|
| +</pre></p>
|
| +
|
| +
|
| +<h3><a name="HE_INHERITS_EQUALS_USE_HASHCODE">HE: La classe hérite de equals() et utilise Object.hashCode() (HE_INHERITS_EQUALS_USE_HASHCODE)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe hérite de la méthode <code>equals((Object)</code> d'une super-classe abstraite, et de la méthode <code>hashCode()</code> de l'objet <code>java.lang.Object</code> (qui renvoi le code de hachage d'identité, une valeur arbitraire assignée à l'objet par la JVM). C'est pourquoi la classe viole probablement le contrat indiquant que des objets égaux doivent avoir des codes de hachage identiques.</p>
|
| +<p>Si vous ne souhaitez pas définir une méthode <code>hashCode()</code> et/ou ne pensez pas que l'objet puisse un jour être mis dans des <code>HashMap</code>/<code>Hashtable</code>, définissez une méthode <code>hashCode()</code> déclenchant une <code>UnsupportedOperationException</code>.</p>
|
| +
|
| +
|
| +<h3><a name="IC_SUPERCLASS_USES_SUBCLASS_DURING_INITIALIZATION">IC: Classe mère utilisant une sous-classe durant son initialisation (IC_SUPERCLASS_USES_SUBCLASS_DURING_INITIALIZATION)</a></h3>
|
| +
|
| +
|
| +<p>Durant l'intialisation, une classe utilise activement l'une de ses sous-classes. Cette sous-classe ne sera pas encore initialisée lors de la première utilisation. Par exemple, dans le code suivant, <code>foo</code> sera à <code>null</code>.</p>
|
| +<p><code><pre>
|
| +public class CircularClassInitialization {
|
| + static class InnerClassSingleton extends CircularClassInitialization {
|
| + static InnerClassSingleton singleton = new InnerClassSingleton();
|
| + }
|
| + static CircularClassInitialization foo = InnerClassSingleton.singleton;
|
| +}
|
| +</pre></code></p>
|
| +
|
| +
|
| +<h3><a name="IMSE_DONT_CATCH_IMSE">IMSE: Interception douteuse d'une IllegalMonitorStateException (IMSE_DONT_CATCH_IMSE)</a></h3>
|
| +
|
| +
|
| +<p><code>IllegalMonitorStateException</code> n'est généralement déclenchée que dans le cas d'une faille dans la conception du code (appeler <code>wait()</code> ou <code>notify()</code> sur un objet dont on ne possède pas le verrou).</p>
|
| +
|
| +
|
| +<h3><a name="ISC_INSTANTIATE_STATIC_CLASS">ISC: Instantiation inutile d'une classe qui n'a que des méthodes statiques (ISC_INSTANTIATE_STATIC_CLASS)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe alloue un objet basé sur une classe qui n'a que des méthodes statiques. Cet objet n'a pas besoin d'être créé, accédez directement aux méthodes en utilisant le nom de la classe.</p>
|
| +
|
| +
|
| +<h3><a name="IT_NO_SUCH_ELEMENT">It: La méthode next() de Iterator ne peut pas déclencher une exception NoSuchElement (IT_NO_SUCH_ELEMENT)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe implémente l'interface <code>java.util.Iterator</code>. Néanmoins, sa méthode <code>next()</code> n'est pas capable de déclencher <code>java.util.NoSuchElementException</code>. La méthode <code>next()</code> devrait être modifiée pour déclencher <code>NoSuchElementException</code> si elle est appelée alors qu'il n'y a plus d'éléments à renvoyer.</p>
|
| +
|
| +
|
| +<h3><a name="J2EE_STORE_OF_NON_SERIALIZABLE_OBJECT_INTO_SESSION">J2EE: Stockage d'un objet non serialisable dans une session Http (J2EE_STORE_OF_NON_SERIALIZABLE_OBJECT_INTO_SESSION)</a></h3>
|
| +
|
| +
|
| +<p>Ce code semble stocker un objet non sérialisable dans un <code>HttpSession</code>. Une erreur se produira si cette session est rendue passive ou migrée.</p>
|
| +
|
| +
|
| +<h3><a name="JCIP_FIELD_ISNT_FINAL_IN_IMMUTABLE_CLASS">JCIP: Les champs d'une classe immuable devraient être finaux. (JCIP_FIELD_ISNT_FINAL_IN_IMMUTABLE_CLASS)</a></h3>
|
| +
|
| +
|
| +La classe est annotée avec <code>net.jcip.annotations.Immutable</code>, et la règle liée à cette annotation réclame que tous les champs soient marqués <code>final</code>.
|
| +
|
| +
|
| +<h3><a name="NP_BOOLEAN_RETURN_NULL">NP: Method with Boolean return type returns explicit null (NP_BOOLEAN_RETURN_NULL)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + A method that returns either Boolean.TRUE, Boolean.FALSE or null is an accident waiting to happen.
|
| + This method can be invoked as though it returned a value of type boolean, and
|
| + the compiler will insert automatic unboxing of the Boolean value. If a null value is returned,
|
| + this will result in a NullPointerException.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="NP_CLONE_COULD_RETURN_NULL">NP: Clone method may return null (NP_CLONE_COULD_RETURN_NULL)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + This clone method seems to return null in some circumstances, but clone is never
|
| + allowed to return a null value. If you are convinced this path is unreachable, throw an AssertionError
|
| + instead.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="NP_EQUALS_SHOULD_HANDLE_NULL_ARGUMENT">NP: Méthode equals() ne vérifiant pas la nullité (NP_EQUALS_SHOULD_HANDLE_NULL_ARGUMENT)</a></h3>
|
| +
|
| +
|
| +<p>Cette implémentation de <code>equals(Object)</code> ne respecte pas le contrat défini par <code>java.lang.Object.equals()</code> car elle ne vérifie la nullité du paramètre reçu en argument. Toutes les méthodes <code>equals()</code> doivent renvoyer <code>false</code> quand elles reçoivent une valeur à <code>null</code>.</p>
|
| +
|
| +
|
| +<h3><a name="NP_TOSTRING_COULD_RETURN_NULL">NP: toString method may return null (NP_TOSTRING_COULD_RETURN_NULL)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + This toString method seems to return null in some circumstances. A liberal reading of the
|
| + spec could be interpreted as allowing this, but it is probably a bad idea and could cause
|
| + other code to break. Return the empty string or some other appropriate string rather than null.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="NM_CLASS_NAMING_CONVENTION">Nm: Nom de classe devant commencer par une majuscule (NM_CLASS_NAMING_CONVENTION)</a></h3>
|
| +
|
| +
|
| +<p>Les noms de classe doivent être en minuscules avec la première lettre de chaque mot en majuscules. Essayez de conserver vos noms de classes simples et explicites. Utilisez des mots entiers et évitez acronymes et abbréviations (à moins que l'abbréviation soit plus largement utilisée que la forme longue, comme "URL" ou "HTML").</p>
|
| +
|
| +
|
| +<h3><a name="NM_CLASS_NOT_EXCEPTION">Nm: Cette classe ne dérive pas d'Exception, même si son nom le sous-entend (NM_CLASS_NOT_EXCEPTION)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe n'est pas dérivée d'une autre <code>Exception</code> alors que son nom se termine par 'Exception'. Ceci risque de porter à confusion les utilisateurs de cette classe.</p>
|
| +
|
| +
|
| +<h3><a name="NM_CONFUSING">Nm: Noms de méthodes ambigus (NM_CONFUSING)</a></h3>
|
| +
|
| +
|
| +<p>Les méthodes indiquées ont des noms qui ne diffèrent que par les majuscules.</p>
|
| +
|
| +
|
| +<h3><a name="NM_FIELD_NAMING_CONVENTION">Nm: Nom de champ devant commencer par une minuscule (NM_FIELD_NAMING_CONVENTION)</a></h3>
|
| +
|
| +
|
| +<p>Les noms de champs qui ne sont pas finaux devraient être en minuscules avec la première lettre des mots, après le premier, en majuscule.</p>
|
| +
|
| +
|
| +<h3><a name="NM_FUTURE_KEYWORD_USED_AS_IDENTIFIER">Nm: Use of identifier that is a keyword in later versions of Java (NM_FUTURE_KEYWORD_USED_AS_IDENTIFIER)</a></h3>
|
| +
|
| +
|
| +<p>The identifier is a word that is reserved as a keyword in later versions of Java, and your code will need to be changed
|
| +in order to compile it in later versions of Java.</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="NM_FUTURE_KEYWORD_USED_AS_MEMBER_IDENTIFIER">Nm: Use of identifier that is a keyword in later versions of Java (NM_FUTURE_KEYWORD_USED_AS_MEMBER_IDENTIFIER)</a></h3>
|
| +
|
| +
|
| +<p>This identifier is used as a keyword in later versions of Java. This code, and
|
| +any code that references this API,
|
| +will need to be changed in order to compile it in later versions of Java.</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="NM_METHOD_NAMING_CONVENTION">Nm: Nom de méthode devant commencer par une minuscule (NM_METHOD_NAMING_CONVENTION)</a></h3>
|
| +
|
| +
|
| +<p>Les noms de méthodes devraient être des verbes en minuscules, avec la première lettre des mots, après le premier, en majuscules.</p>
|
| +
|
| +
|
| +<h3><a name="NM_SAME_SIMPLE_NAME_AS_INTERFACE">Nm: Class names shouldn't shadow simple name of implemented interface (NM_SAME_SIMPLE_NAME_AS_INTERFACE)</a></h3>
|
| +
|
| +
|
| + <p> This class/interface has a simple name that is identical to that of an implemented/extended interface, except
|
| +that the interface is in a different package (e.g., <code>alpha.Foo</code> extends <code>beta.Foo</code>).
|
| +This can be exceptionally confusing, create lots of situations in which you have to look at import statements
|
| +to resolve references and creates many
|
| +opportunities to accidently define methods that do not override methods in their superclasses.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="NM_SAME_SIMPLE_NAME_AS_SUPERCLASS">Nm: Class names shouldn't shadow simple name of superclass (NM_SAME_SIMPLE_NAME_AS_SUPERCLASS)</a></h3>
|
| +
|
| +
|
| + <p> This class has a simple name that is identical to that of its superclass, except
|
| +that its superclass is in a different package (e.g., <code>alpha.Foo</code> extends <code>beta.Foo</code>).
|
| +This can be exceptionally confusing, create lots of situations in which you have to look at import statements
|
| +to resolve references and creates many
|
| +opportunities to accidently define methods that do not override methods in their superclasses.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="NM_VERY_CONFUSING_INTENTIONAL">Nm: Very confusing method names (but perhaps intentional) (NM_VERY_CONFUSING_INTENTIONAL)</a></h3>
|
| +
|
| +
|
| + <p> The referenced methods have names that differ only by capitalization.
|
| +This is very confusing because if the capitalization were
|
| +identical then one of the methods would override the other. From the existence of other methods, it
|
| +seems that the existence of both of these methods is intentional, but is sure is confusing.
|
| +You should try hard to eliminate one of them, unless you are forced to have both due to frozen APIs.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="NM_WRONG_PACKAGE_INTENTIONAL">Nm: Method doesn't override method in superclass due to wrong package for parameter (NM_WRONG_PACKAGE_INTENTIONAL)</a></h3>
|
| +
|
| +
|
| + <p> The method in the subclass doesn't override a similar method in a superclass because the type of a parameter doesn't exactly match
|
| +the type of the corresponding parameter in the superclass. For example, if you have:</p>
|
| +
|
| +<blockquote>
|
| +<pre>
|
| +import alpha.Foo;
|
| +public class A {
|
| + public int f(Foo x) { return 17; }
|
| +}
|
| +----
|
| +import beta.Foo;
|
| +public class B extends A {
|
| + public int f(Foo x) { return 42; }
|
| + public int f(alpha.Foo x) { return 27; }
|
| +}
|
| +</pre>
|
| +</blockquote>
|
| +
|
| +<p>The <code>f(Foo)</code> method defined in class <code>B</code> doesn't
|
| +override the
|
| +<code>f(Foo)</code> method defined in class <code>A</code>, because the argument
|
| +types are <code>Foo</code>'s from different packages.
|
| +</p>
|
| +
|
| +<p>In this case, the subclass does define a method with a signature identical to the method in the superclass,
|
| +so this is presumably understood. However, such methods are exceptionally confusing. You should strongly consider
|
| +removing or deprecating the method with the similar but not identical signature.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="ODR_OPEN_DATABASE_RESOURCE">ODR: La méthode peut ne pas fermer une ressource base de données (ODR_OPEN_DATABASE_RESOURCE)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode crée une ressource base de données (telle qu'une connexion ou un <code>RowSet</code>), ne l'affecte à aucun champ, ne la passe à aucune autre méthode, ne la renvoie pas, et ne semble pas la fermer dans tous les chemins d'exécution. Ne pas fermer une ressource base de données dans tous les chemins d'exécution peut entraîner de faibles performances et poser des problèmes de communication entre la base de données et l'application.</p>
|
| +
|
| +
|
| +<h3><a name="ODR_OPEN_DATABASE_RESOURCE_EXCEPTION_PATH">ODR: La méthode peut ne pas fermer une ressource base de données sur une exception (ODR_OPEN_DATABASE_RESOURCE_EXCEPTION_PATH)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode crée une ressource base de données (telle qu'une connexion ou un <code>RowSet</code>), ne l'affecte à aucun champ, ne la passe à aucune autre méthode, ne la renvoie pas, et ne semble pas la fermer dans tous les chemins d'exception. Ne pas fermer une ressource base de données peut entraîner de faibles performances et poser des problèmes de communication entre la base de données et l'application.</p>
|
| +
|
| +
|
| +<h3><a name="OS_OPEN_STREAM">OS: La méthode peut ne pas fermer un flux (OS_OPEN_STREAM)</a></h3>
|
| +
|
| +
|
| +<p>La méthode crée un objet de flux d'E/S, ne l'assigne à aucun champ, ne le passe à aucune méthode, ne le renvoit pas et ne semble pas le fermer dans tous les chemins d'exécution. Ceci peut entraîner le blocage d'un descripteur de fichier. C'est généralement une bonne idée d'utiliser un bloc <code>finally</code> pour s'assurer de la fermeture des flux.</p>
|
| +
|
| +
|
| +<h3><a name="OS_OPEN_STREAM_EXCEPTION_PATH">OS: La méthode peut oublier de fermer un flux en cas d'exception (OS_OPEN_STREAM_EXCEPTION_PATH)</a></h3>
|
| +
|
| +
|
| +<p>La méthode crée un flux d'E/S, ne l'affecte à aucun champ, ne le passe à aucune méthode, ne le renvoit pas, et ne semble pas le fermer dans tous les chemins d'exception possibles. Ceci peut provoquer le blocage d'un descripteur de fichier. C'est généralement une bonne idée d'utiliser un bloc <code>finally</code> pour garantir la fermeture des flux.</p>
|
| +
|
| +
|
| +<h3><a name="PZ_DONT_REUSE_ENTRY_OBJECTS_IN_ITERATORS">PZ: Don't reuse entry objects in iterators (PZ_DONT_REUSE_ENTRY_OBJECTS_IN_ITERATORS)</a></h3>
|
| +
|
| +
|
| + <p> The entrySet() method is allowed to return a view of the
|
| + underlying Map in which an Iterator and Map.Entry. This clever
|
| + idea was used in several Map implementations, but introduces the possibility
|
| + of nasty coding mistakes. If a map <code>m</code> returns
|
| + such an iterator for an entrySet, then
|
| + <code>c.addAll(m.entrySet())</code> will go badly wrong. All of
|
| + the Map implementations in OpenJDK 1.7 have been rewritten to avoid this,
|
| + you should to.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="RC_REF_COMPARISON_BAD_PRACTICE">RC: Suspicious reference comparison to constant (RC_REF_COMPARISON_BAD_PRACTICE)</a></h3>
|
| +
|
| +
|
| +<p> This method compares a reference value to a constant using the == or != operator,
|
| +where the correct way to compare instances of this type is generally
|
| +with the equals() method.
|
| +It is possible to create distinct instances that are equal but do not compare as == since
|
| +they are different objects.
|
| +Examples of classes which should generally
|
| +not be compared by reference are java.lang.Integer, java.lang.Float, etc.</p>
|
| +
|
| +
|
| +<h3><a name="RC_REF_COMPARISON_BAD_PRACTICE_BOOLEAN">RC: Suspicious reference comparison of Boolean values (RC_REF_COMPARISON_BAD_PRACTICE_BOOLEAN)</a></h3>
|
| +
|
| +
|
| +<p> This method compares two Boolean values using the == or != operator.
|
| +Normally, there are only two Boolean values (Boolean.TRUE and Boolean.FALSE),
|
| +but it is possible to create other Boolean objects using the <code>new Boolean(b)</code>
|
| +constructor. It is best to avoid such objects, but if they do exist,
|
| +then checking Boolean objects for equality using == or != will give results
|
| +than are different than you would get using <code>.equals(...)</code>
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="RR_NOT_CHECKED">RR: La méthode ignore le résultat de InputStream.read() (RR_NOT_CHECKED)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode ignore le code retour d'une des variantes de <code>java.io.InputStream.read()</code> qui peut renvoyer de multiples octets. Si la valeur renvoyée n'est pas vérifiée, l'appelant ne sera pas capable de gérer correctement le cas ou moins d'octets que prévu auront été lus. C'est un bogue particulièrement insidieux car dans la plupart des programmes les lectures renvoient effectivement souvent le nombre d'octets demandé, les plantages restant sporadiques.</p>
|
| +
|
| +
|
| +<h3><a name="SR_NOT_CHECKED">RR: La méthode ignore le résultat de InputStream.skip() (SR_NOT_CHECKED)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode ignore la valeur renvoyée par <code>java.io.InputStream.skip()</code>, qui peut sauter de multiples octets. Si la valeur renvoyée n'est pas vérifiée, l'appelant n'est pas capable de gérer correctement les cas ou moins d'octets que prévu auront été sautés. C'est un type de bogue particulièrement insidieux car la plupart du temps le bon nombre d'octet sera effectivement sauté, et les plantages seront sporadiques. Néanmoins, sur les flux bufferisés, <code>skip()</code> ne s'applique qu'aux données du buffer et échoue fréquemment à sauter le nombre d'octets demandé.</p>
|
| +
|
| +
|
| +<h3><a name="RV_NEGATING_RESULT_OF_COMPARETO">RV: Negating the result of compareTo()/compare() (RV_NEGATING_RESULT_OF_COMPARETO)</a></h3>
|
| +
|
| +
|
| + <p> This code negatives the return value of a compareTo or compare method.
|
| +This is a questionable or bad programming practice, since if the return
|
| +value is Integer.MIN_VALUE, negating the return value won't
|
| +negate the sign of the result. You can achieve the same intended result
|
| +by reversing the order of the operands rather than by negating the results.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="RV_RETURN_VALUE_IGNORED_BAD_PRACTICE">RV: Method ignores exceptional return value (RV_RETURN_VALUE_IGNORED_BAD_PRACTICE)</a></h3>
|
| +
|
| +
|
| + <p> This method returns a value that is not checked. The return value should be checked
|
| +since it can indicate an unusual or unexpected function execution. For
|
| +example, the <code>File.delete()</code> method returns false
|
| +if the file could not be successfully deleted (rather than
|
| +throwing an Exception).
|
| +If you don't check the result, you won't notice if the method invocation
|
| +signals unexpected behavior by returning an atypical return value.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="SI_INSTANCE_BEFORE_FINALS_ASSIGNED">SI: Initialiseur statique de classe créant une instance avant que tous les champs static final soient alimentés (SI_INSTANCE_BEFORE_FINALS_ASSIGNED)</a></h3>
|
| +
|
| +
|
| +<p>L'initialiseur <code>static</code> de la classe crée une instance de la classe avant que tous les champs <code>static final</code> soient alimentés.</p>
|
| +
|
| +
|
| +<h3><a name="SW_SWING_METHODS_INVOKED_IN_SWING_THREAD">SW: Certaines méthodes Swing ne doivent être invoquées qu'à partir du thread Swing (SW_SWING_METHODS_INVOKED_IN_SWING_THREAD)</a></h3>
|
| +
|
| +
|
| +<p>(<a href="http://java.sun.com/developer/JDCTechTips/2003/tt1208.html#1">Conseil technique JDC</a>) : les méthodes Swing <code>show()</code>, <code>setVisible()</code> et <code>pack()</code> créent les ressources associées à la fenêtre. En même temps que la création de ces ressources, le système crée le processus Swing de répartition de évènements.</p>
|
| +<p>Ceci pose problème car le processus de répartition des évènements peut notifier des écouteurs alors que <code>pack()</code> et <code>validate()</code> sont toujours en cours de traitement. Cette situation peut conduire à ce que deux processus essayent d'accèder en même temps au composant, ce qui est une faille sérieuse qui peut provoquer des interblocages et autres problèmes de synchronisation.</p>
|
| +<p>Un appel à <code>pack()</code> provoque l'initialisation du composant. Quand ils s'initialisent (sans être forcément visibles), les composants peuvent émettre des évènements vers le processus de répartition des évènements de Swing.</p>
|
| +
|
| +
|
| +<h3><a name="SE_BAD_FIELD">Se: Champ d'instance non transient et non sérialisable dans une classe sérialisable (SE_BAD_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe <code>Serializable</code> définit un champ d'instance non primitif qui n'est ni <code>transient</code>, ni <code>Serializable</code> ou <code>java.lang.Object</code>, et qui ne semble pas implémenter l'interface <code>Externalizable</code> ou les méthodes <code>readObject()</code> et <code>writeObject()</code>. Les objets de cette classe ne seront pas désérialisés correctement si un objet non <code>Serializable</code> est stocké dans ce champ.</p>
|
| +
|
| +
|
| +<h3><a name="SE_BAD_FIELD_INNER_CLASS">Se: Non-serializable class has a serializable inner class (SE_BAD_FIELD_INNER_CLASS)</a></h3>
|
| +
|
| +
|
| +<p> This Serializable class is an inner class of a non-serializable class.
|
| +Thus, attempts to serialize it will also attempt to associate instance of the outer
|
| +class with which it is associated, leading to a runtime error.
|
| +</p>
|
| +<p>If possible, making the inner class a static inner class should solve the
|
| +problem. Making the outer class serializable might also work, but that would
|
| +mean serializing an instance of the inner class would always also serialize the instance
|
| +of the outer class, which it often not what you really want.
|
| +
|
| +
|
| +<h3><a name="SE_BAD_FIELD_STORE">Se: Valeur non sérialisable stockée dans un champ d'instance de classe sérialisable (SE_BAD_FIELD_STORE)</a></h3>
|
| +
|
| +
|
| +<p>Une valeur non sérialisable est stockée dans un champ non <code>transient</code> d'une classe sérialisable.</p>
|
| +
|
| +
|
| +<h3><a name="SE_COMPARATOR_SHOULD_BE_SERIALIZABLE">Se: Comparateur n'implémentant pas Serializable (SE_COMPARATOR_SHOULD_BE_SERIALIZABLE)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe implémente l'interface <code>Comparator</code>. Vous devriez vérifier si elle doit ou pas également implémenter l'interface <code>Serializable</code>. Si un comparateur est utilisé pour construire une collection triée, telle que <code>TreeMap</code>, alors le <code>TreeMap</code> ne sera sérialisable uniquement si le compareteur l'est aussi. Puisque la plupart des comparateurs ont de petits voire aucun états, les rendre sérialisables est généralement une technique de programmation défensive simple et bénéfique.</p>
|
| +
|
| +
|
| +<h3><a name="SE_INNER_CLASS">Se: Serializable inner class (SE_INNER_CLASS)</a></h3>
|
| +
|
| +
|
| +<p> This Serializable class is an inner class. Any attempt to serialize
|
| +it will also serialize the associated outer instance. The outer instance is serializable,
|
| +so this won't fail, but it might serialize a lot more data than intended.
|
| +If possible, making the inner class a static inner class (also known as a nested class) should solve the
|
| +problem.
|
| +
|
| +
|
| +<h3><a name="SE_NONFINAL_SERIALVERSIONID">Se: serialVersionUID n'est pas final (SE_NONFINAL_SERIALVERSIONID)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit un champ <code>serialVersionUID</code> qui n'est pas <code>final</code>. Ce champ devrait être rendu <code>final</code> si son but est de préciser l'identifiant de version utilisé pour la sérialisation.</p>
|
| +
|
| +
|
| +<h3><a name="SE_NONLONG_SERIALVERSIONID">Se: serialVersionUID n'est pas de type long (SE_NONLONG_SERIALVERSIONID)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit un champ <code>serialVersionUID</code> qui n'est pas de type <code>long</code>. Ce champ devrait être de type <code>long</code> si son but est de préciser l'identifiant de version utilisé pour la sérialisation.</p>
|
| +
|
| +
|
| +<h3><a name="SE_NONSTATIC_SERIALVERSIONID">Se: serialVersionUID n'est pas static (SE_NONSTATIC_SERIALVERSIONID)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit un champ <code>serialVersionUID</code> qui n'est pas statique. Le champ devrait être rendu statique si son but est de préciser l'identifiant de version utilisé pour la sérialisation.</p>
|
| +
|
| +
|
| +<h3><a name="SE_NO_SUITABLE_CONSTRUCTOR">Se: La classe est Serializable mais sa super-classe ne possède pas de constructeur par défaut visible (SE_NO_SUITABLE_CONSTRUCTOR)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe implémente l'interface <code>Serializable</code> mais pas sa super-classe. Quand un tel objet est désérialisé, les champs de la classe mère doivent être initialisés en invoquant le constructeur par défaut de la super-classe. Comme la super-classe n'en a pas, sérialisation et désérialisation échoueront à l'exécution.</p>
|
| +
|
| +
|
| +<h3><a name="SE_NO_SUITABLE_CONSTRUCTOR_FOR_EXTERNALIZATION">Se: La classe est Externalizable mais ne définit pas de constructeur par défaut (SE_NO_SUITABLE_CONSTRUCTOR_FOR_EXTERNALIZATION)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe implémente l'interface <code>Externalizable</code>, mais ne définit pas de constructeur par défaut. Quand les objets <code>Externalizable</code> sont déserialisés, ils doivent d'abord être construit au moyen du constructeur par défaut. Cette classe n'en ayant pas, sérialisation et désérialisation échoueront à l'exécution.</p>
|
| +
|
| +
|
| +<h3><a name="SE_READ_RESOLVE_MUST_RETURN_OBJECT">Se: La méthode readResolve doit retourner un Object (SE_READ_RESOLVE_MUST_RETURN_OBJECT)</a></h3>
|
| +
|
| +
|
| +<p>Pour que la méthode <code>readResolve</code> soit prise en compte pas le mécanisme de sérialisation, elle doit avoir Object comme type de retour.</p>
|
| +
|
| +
|
| +<h3><a name="SE_TRANSIENT_FIELD_NOT_RESTORED">Se: Champ "transient" non positionné lors de la désérialisation (SE_TRANSIENT_FIELD_NOT_RESTORED)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe contient un champ qui est mis-à-jour à de nombreux endrois dans la classe, et qui semble faire parti du démarrage de la classe. Mais, ce champ étant marqué comme <code>transient</code> et n'étant pas alimenté par les méthodes <code>readObject</code> et <code>readResolve</code>, il contiendra la valeur par défaut dans toutes les instances désérialisées de la classe.</p>
|
| +
|
| +
|
| +<h3><a name="SE_NO_SERIALVERSIONID">SnVI: La classe est Serializable, mais ne définit pas serialVersionUID (SE_NO_SERIALVERSIONID)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe implémente l'interface <code>Serializable</code> mais ne définit pas de champ <code>serialVersionUID</code>. Une modification aussi simple qu'ajouter une référence vers un objet <code>.class</code> ajoutera des champs synthétiques à la classe, ce qui malheureusement changera la valeur implicite de <code>serialVersionUID</code> (Ex. : ajouter une référence à <code>String.class</code> générera un champ statique <code>class$java$lang$String</code>). De plus, différents compilateurs source vers bytecode peuvent utiliser différentes conventions de nommage pour les variables synthétiques générées pour référencer les objets classes et les classes internes. Afin de garantir l'interopérabilité de <code>Serializable</code> suivant les versions, pensez à ajouter un champ <code>serialVersionUID</code> explicite.</p>
|
| +
|
| +
|
| +<h3><a name="UI_INHERITANCE_UNSAFE_GETRESOURCE">UI: L'utilisation de GetResource peut-être instable si la classe est étendue (UI_INHERITANCE_UNSAFE_GETRESOURCE)</a></h3>
|
| +
|
| +
|
| +<p>Appeler <code>this.getClass().getResource(...)</code> peut rendre des résultats différents de ceux attendus si la classe est étendue par une classe d'un autre paquetage.</p>
|
| +
|
| +
|
| +<h3><a name="BC_IMPOSSIBLE_CAST">BC: Transtypage impossible (BC_IMPOSSIBLE_CAST)</a></h3>
|
| +
|
| +
|
| +<p>Ce trantypage lancera toujours une exception <code>ClassCastException</code>.</p>
|
| +
|
| +
|
| +<h3><a name="BC_IMPOSSIBLE_DOWNCAST">BC: Impossible downcast (BC_IMPOSSIBLE_DOWNCAST)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +This cast will always throw a ClassCastException.
|
| +The analysis believes it knows
|
| +the precise type of the value being cast, and the attempt to
|
| +downcast it to a subtype will always fail by throwing a ClassCastException.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="BC_IMPOSSIBLE_DOWNCAST_OF_TOARRAY">BC: Impossible downcast of toArray() result (BC_IMPOSSIBLE_DOWNCAST_OF_TOARRAY)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +This code is casting the result of calling <code>toArray()</code> on a collection
|
| +to a type more specific than <code>Object[]</code>, as in:</p>
|
| +<pre>
|
| +String[] getAsArray(Collection<String> c) {
|
| + return (String[]) c.toArray();
|
| + }
|
| +</pre>
|
| +<p>This will usually fail by throwing a ClassCastException. The <code>toArray()</code>
|
| +of almost all collections return an <code>Object[]</code>. They can't really do anything else,
|
| +since the Collection object has no reference to the declared generic type of the collection.
|
| +<p>The correct way to do get an array of a specific type from a collection is to use
|
| + <code>c.toArray(new String[]);</code>
|
| + or <code>c.toArray(new String[c.size()]);</code> (the latter is slightly more efficient).
|
| +<p>There is one common/known exception exception to this. The <code>toArray()</code>
|
| +method of lists returned by <code>Arrays.asList(...)</code> will return a covariantly
|
| +typed array. For example, <code>Arrays.asArray(new String[] { "a" }).toArray()</code>
|
| +will return a <code>String []</code>. FindBugs attempts to detect and suppress
|
| +such cases, but may miss some.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="BC_IMPOSSIBLE_INSTANCEOF">BC: instanceof renverra toujours faux (BC_IMPOSSIBLE_INSTANCEOF)</a></h3>
|
| +
|
| +
|
| +<p>Ce test <code>instanceof</code> renverra toujours faux. Même s'il est sûr, assurez-vous qu'il ne s'agisse pas d'une erreur logique ou d'une mauvaise compréhension.</p>
|
| +
|
| +
|
| +<h3><a name="BIT_ADD_OF_SIGNED_BYTE">BIT: Bitwise add of signed byte value (BIT_ADD_OF_SIGNED_BYTE)</a></h3>
|
| +
|
| +
|
| +<p> Adds a byte value and a value which is known to have the 8 lower bits clear.
|
| +Values loaded from a byte array are sign extended to 32 bits
|
| +before any any bitwise operations are performed on the value.
|
| +Thus, if <code>b[0]</code> contains the value <code>0xff</code>, and
|
| +<code>x</code> is initially 0, then the code
|
| +<code>((x << 8) + b[0])</code> will sign extend <code>0xff</code>
|
| +to get <code>0xffffffff</code>, and thus give the value
|
| +<code>0xffffffff</code> as the result.
|
| +</p>
|
| +
|
| +<p>In particular, the following code for packing a byte array into an int is badly wrong: </p>
|
| +<pre>
|
| +int result = 0;
|
| +for(int i = 0; i < 4; i++)
|
| + result = ((result << 8) + b[i]);
|
| +</pre>
|
| +
|
| +<p>The following idiom will work instead: </p>
|
| +<pre>
|
| +int result = 0;
|
| +for(int i = 0; i < 4; i++)
|
| + result = ((result << 8) + (b[i] & 0xff));
|
| +</pre>
|
| +
|
| +
|
| +
|
| +<h3><a name="BIT_AND">BIT: Masques binaires incompatibles (BIT_AND)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode compare une expression de la forme (a <code>&</code> C) avec D, qui est toujours inégale en raison des valeurs spécifiques des constantes C et D. Cela peut indiquer une faute de frappe ou une erreur logique.</p>
|
| +
|
| +
|
| +<h3><a name="BIT_AND_ZZ">BIT: Masques binaires incompatibles (BIT_AND_ZZ)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode compare une expression de la forme (a <code>&</code> 0) avec 0, qui est toujours égale. Ceci peut indiquer une faute de frappe ou une erreur logique.</p>
|
| +
|
| +
|
| +<h3><a name="BIT_IOR">BIT: Masques binaires incompatibles (BIT_IOR)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode compare une expression de la forme (a <code>|</code> C) avec D, qui est toujours inégale en raison des valeurs spécifiques des constantes C et D. Ceci peut indiquer une erreur logique ou une faute de frappe.</p>
|
| +<p>Typiquement, ce bogue arrive quand du code essaye d'effectuer un test d'apparition d'un bit mais utilise l'opérateur OU ("<code>|</code>") au lieu de l'opérateur ET ("<code>&</code>").</p>
|
| +
|
| +
|
| +<h3><a name="BIT_IOR_OF_SIGNED_BYTE">BIT: Ou binaire d'un octet signé (BIT_IOR_OF_SIGNED_BYTE)</a></h3>
|
| +
|
| +
|
| +<p>Charge une valeur à partir d'un tableau d'octets et effectue un ou binaire sur cette valeur. Les valeurs venant d'un tableau d'octet sont signées et risquent donc de ne pas se comporter comme prévue.</p>
|
| +
|
| +
|
| +<h3><a name="BIT_SIGNED_CHECK_HIGH_BIT">BIT: Check for sign of bitwise operation (BIT_SIGNED_CHECK_HIGH_BIT)</a></h3>
|
| +
|
| +
|
| +<p> This method compares an expression such as</p>
|
| +<pre>((event.detail & SWT.SELECTED) > 0)</pre>.
|
| +<p>Using bit arithmetic and then comparing with the greater than operator can
|
| +lead to unexpected results (of course depending on the value of
|
| +SWT.SELECTED). If SWT.SELECTED is a negative number, this is a candidate
|
| +for a bug. Even when SWT.SELECTED is not negative, it seems good practice
|
| +to use '!= 0' instead of '> 0'.
|
| +</p>
|
| +<p>
|
| +<em>Boris Bokowski</em>
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="BOA_BADLY_OVERRIDDEN_ADAPTER">BOA: La classe surcharge mal une méthode implémentée dans une superclasse Adapter (BOA_BADLY_OVERRIDDEN_ADAPTER)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode surcharge une méthode provenant d'une classe mère qui est un <code>Adapter</code> qui implémente un <code>Listener</code> défini dans le paquetage <code>java.awt.event</code> ou <code>javax.swing.event</code>. En conséquence, cette méthode ne sera pas appelée quand l'évènement se produira.</p>
|
| +
|
| +
|
| +<h3><a name="ICAST_BAD_SHIFT_AMOUNT">BSHIFT: Décalage d'un int hors de proportion (0..31) (ICAST_BAD_SHIFT_AMOUNT)</a></h3>
|
| +
|
| +
|
| +<p>Un décalage de n bits est effectué avec n hors des limites (0..31). Ceci résulte en l'utilisation des 5 bits inférieurs de l'entier pour décider de la valeur du décalage. Ce n'est sans doute pas l'effet recherché et est pour le moins source de confusion.</p>
|
| +
|
| +
|
| +<h3><a name="BX_UNBOXED_AND_COERCED_FOR_TERNARY_OPERATOR">Bx: Primitive value is unboxed and coerced for ternary operator (BX_UNBOXED_AND_COERCED_FOR_TERNARY_OPERATOR)</a></h3>
|
| +
|
| +
|
| + <p>A wrapped primitive value is unboxed and converted to another primitive type as part of the
|
| +evaluation of a conditional ternary operator (the <code> b ? e1 : e2</code> operator). The
|
| +semantics of Java mandate that if <code>e1</code> and <code>e2</code> are wrapped
|
| +numeric values, the values are unboxed and converted/coerced to their common type (e.g,
|
| +if <code>e1</code> is of type <code>Integer</code>
|
| +and <code>e2</code> is of type <code>Float</code>, then <code>e1</code> is unboxed,
|
| +converted to a floating point value, and boxed. See JLS Section 15.25.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="CO_COMPARETO_RESULTS_MIN_VALUE">Co: compareTo()/compare() returns Integer.MIN_VALUE (CO_COMPARETO_RESULTS_MIN_VALUE)</a></h3>
|
| +
|
| +
|
| + <p> In some situation, this compareTo or compare method returns
|
| +the constant Integer.MIN_VALUE, which is an exceptionally bad practice.
|
| + The only thing that matters about the return value of compareTo is the sign of the result.
|
| + But people will sometimes negate the return value of compareTo, expecting that this will negate
|
| + the sign of the result. And it will, except in the case where the value returned is Integer.MIN_VALUE.
|
| + So just return -1 rather than Integer.MIN_VALUE.
|
| +
|
| +
|
| +<h3><a name="DLS_DEAD_LOCAL_INCREMENT_IN_RETURN">DLS: Useless increment in return statement (DLS_DEAD_LOCAL_INCREMENT_IN_RETURN)</a></h3>
|
| +
|
| +
|
| +<p>This statement has a return such as <code>return x++;</code>.
|
| +A postfix increment/decrement does not impact the value of the expression,
|
| +so this increment/decrement has no effect.
|
| +Please verify that this statement does the right thing.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="DLS_DEAD_STORE_OF_CLASS_LITERAL">DLS: Dead store of class literal (DLS_DEAD_STORE_OF_CLASS_LITERAL)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +This instruction assigns a class literal to a variable and then never uses it.
|
| +<a href="//java.sun.com/j2se/1.5.0/compatibility.html#literal">The behavior of this differs in Java 1.4 and in Java 5.</a>
|
| +In Java 1.4 and earlier, a reference to <code>Foo.class</code> would force the static initializer
|
| +for <code>Foo</code> to be executed, if it has not been executed already.
|
| +In Java 5 and later, it does not.
|
| +</p>
|
| +<p>See Sun's <a href="//java.sun.com/j2se/1.5.0/compatibility.html#literal">article on Java SE compatibility</a>
|
| +for more details and examples, and suggestions on how to force class initialization in Java 5.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="DLS_OVERWRITTEN_INCREMENT">DLS: Incrémentation annulée (DLS_OVERWRITTEN_INCREMENT)</a></h3>
|
| +
|
| +
|
| +<p>Ce code incrémente une valeur (ex., <code>i++</code>) et en annule immédiatement l'effet. Par exemple, <code>i = i++</code> réécrit de façon immédiate la valeur incrémentée avec la valeur originale.</p>
|
| +
|
| +
|
| +<h3><a name="DMI_ARGUMENTS_WRONG_ORDER">DMI: Reversed method arguments (DMI_ARGUMENTS_WRONG_ORDER)</a></h3>
|
| +
|
| +
|
| +<p> The arguments to this method call seem to be in the wrong order.
|
| +For example, a call <code>Preconditions.checkNotNull("message", message)</code>
|
| +has reserved arguments: the value to be checked is the first argument.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="DMI_BAD_MONTH">DMI: Valeur constante pour un mois en dehors de l'intervalle attendu de 0 à 11 (DMI_BAD_MONTH)</a></h3>
|
| +
|
| +
|
| +<p>Ce code passe une constante mois en dehors de l'intervalle de 0 à 11.</p>
|
| +
|
| +
|
| +<h3><a name="DMI_BIGDECIMAL_CONSTRUCTED_FROM_DOUBLE">DMI: BigDecimal constructed from double that isn't represented precisely (DMI_BIGDECIMAL_CONSTRUCTED_FROM_DOUBLE)</a></h3>
|
| +
|
| +
|
| + <p>
|
| +This code creates a BigDecimal from a double value that doesn't translate well to a
|
| +decimal number.
|
| +For example, one might assume that writing new BigDecimal(0.1) in Java creates a BigDecimal which is exactly equal to 0.1 (an unscaled value of 1, with a scale of 1), but it is actually equal to 0.1000000000000000055511151231257827021181583404541015625.
|
| +You probably want to use the BigDecimal.valueOf(double d) method, which uses the String representation
|
| +of the double to create the BigDecimal (e.g., BigDecimal.valueOf(0.1) gives 0.1).
|
| +</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="DMI_CALLING_NEXT_FROM_HASNEXT">DMI: Méthode hasNext() appelant next() (DMI_CALLING_NEXT_FROM_HASNEXT)</a></h3>
|
| +
|
| +
|
| +<p>La méthode <code>hasNext()</code> appelle la méthode <code>next()</code>. C'est très probablement faux puisque la méthode <code>hasNext()</code> n'est pas changer l'état de l'itérateur tandis que la méthode <code>next()</code> doit changer cet état.</p>
|
| +
|
| +
|
| +<h3><a name="DMI_COLLECTIONS_SHOULD_NOT_CONTAIN_THEMSELVES">DMI: Collections should not contain themselves (DMI_COLLECTIONS_SHOULD_NOT_CONTAIN_THEMSELVES)</a></h3>
|
| +
|
| +
|
| + <p> This call to a generic collection's method would only make sense if a collection contained
|
| +itself (e.g., if <code>s.contains(s)</code> were true). This is unlikely to be true and would cause
|
| +problems if it were true (such as the computation of the hash code resulting in infinite recursion).
|
| +It is likely that the wrong value is being passed as a parameter.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="DMI_DOH">DMI: D'oh! A nonsensical method invocation (DMI_DOH)</a></h3>
|
| +
|
| +
|
| + <p>
|
| +This partical method invocation doesn't make sense, for reasons that should be apparent from inspection.
|
| +</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="DMI_INVOKING_HASHCODE_ON_ARRAY">DMI: Invocation of hashCode on an array (DMI_INVOKING_HASHCODE_ON_ARRAY)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +The code invokes hashCode on an array. Calling hashCode on
|
| +an array returns the same value as System.identityHashCode, and ingores
|
| +the contents and length of the array. If you need a hashCode that
|
| +depends on the contents of an array <code>a</code>,
|
| +use <code>java.util.Arrays.hashCode(a)</code>.
|
| +
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="DMI_LONG_BITS_TO_DOUBLE_INVOKED_ON_INT">DMI: Double.longBitsToDouble invoked on an int (DMI_LONG_BITS_TO_DOUBLE_INVOKED_ON_INT)</a></h3>
|
| +
|
| +
|
| +<p> The Double.longBitsToDouble method is invoked, but a 32 bit int value is passed
|
| + as an argument. This almostly certainly is not intended and is unlikely
|
| + to give the intended result.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="DMI_VACUOUS_SELF_COLLECTION_CALL">DMI: Vacuous call to collections (DMI_VACUOUS_SELF_COLLECTION_CALL)</a></h3>
|
| +
|
| +
|
| + <p> This call doesn't make sense. For any collection <code>c</code>, calling <code>c.containsAll(c)</code> should
|
| +always be true, and <code>c.retainAll(c)</code> should have no effect.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="DMI_ANNOTATION_IS_NOT_VISIBLE_TO_REFLECTION">Dm: La réflexion ne peut pas être utilisée pour vérifier la présence d'une annotation avec la rétention par défaut (DMI_ANNOTATION_IS_NOT_VISIBLE_TO_REFLECTION)</a></h3>
|
| +
|
| +
|
| +<p>A moins qu'une annotation ait elle même été annotée avec une <code>@Retention</code> différente de la rétention "source uniquement" par défaut, l'annotation n'est pas conservée dans le fichier .class et ne peut pas être utilisée par réflexion (par exemple avec la méthode <code>isAnnotationPresent()</code>).</p>
|
| +
|
| +
|
| +<h3><a name="DMI_FUTILE_ATTEMPT_TO_CHANGE_MAXPOOL_SIZE_OF_SCHEDULED_THREAD_POOL_EXECUTOR">Dm: Futile attempt to change max pool size of ScheduledThreadPoolExecutor (DMI_FUTILE_ATTEMPT_TO_CHANGE_MAXPOOL_SIZE_OF_SCHEDULED_THREAD_POOL_EXECUTOR)</a></h3>
|
| +
|
| +
|
| + <p>(<a href="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ScheduledThreadPoolExecutor.html">Javadoc</a>)
|
| +While ScheduledThreadPoolExecutor inherits from ThreadPoolExecutor, a few of the inherited tuning methods are not useful for it. In particular, because it acts as a fixed-sized pool using corePoolSize threads and an unbounded queue, adjustments to maximumPoolSize have no useful effect.
|
| + </p>
|
| +
|
| +
|
| +
|
| +<h3><a name="DMI_SCHEDULED_THREAD_POOL_EXECUTOR_WITH_ZERO_CORE_THREADS">Dm: Creation of ScheduledThreadPoolExecutor with zero core threads (DMI_SCHEDULED_THREAD_POOL_EXECUTOR_WITH_ZERO_CORE_THREADS)</a></h3>
|
| +
|
| +
|
| + <p>(<a href="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ScheduledThreadPoolExecutor.html#ScheduledThreadPoolExecutor(int)">Javadoc</a>)
|
| +A ScheduledThreadPoolExecutor with zero core threads will never execute anything; changes to the max pool size are ignored.
|
| +</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="DMI_VACUOUS_CALL_TO_EASYMOCK_METHOD">Dm: Useless/vacuous call to EasyMock method (DMI_VACUOUS_CALL_TO_EASYMOCK_METHOD)</a></h3>
|
| +
|
| +
|
| + <p>This call doesn't pass any objects to the EasyMock method, so the call doesn't do anything.
|
| +</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="EC_ARRAY_AND_NONARRAY">EC: Utilisation de equals() pour comparer un tableau et un objet (EC_ARRAY_AND_NONARRAY)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode appelle <code>equals(Object o)</code> pour comparer un tableau et une référence qui ne semble pas être un tableau. Si les choses comparées sont de type différents, il est garanti qu'elles seront non égales et la comparaison est probablement une erreur. Même si les deux sont des tableaux, la méthode <code>equals()</code> détermine seulement si les deux tableaux sont le même objet. Pour comparer le contenu de deux tableaux, utilisez <code>java.util.Arrays.equals(Object[], Object[])</code>.</p>
|
| +
|
| +
|
| +<h3><a name="EC_BAD_ARRAY_COMPARE">EC: Appel à equals() sur un tableau équivalent à == (EC_BAD_ARRAY_COMPARE)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode invoque la méthode <code>equals(Object o)</code> d'un tableau. Comme les tableaux ne surchargent pas la méthode <code>equals()</code> de <code>Object</code>, cet appel revient à comparer les adresses. Pour comparer les contenus de tableaux, utilisez <code>java.util.Arrays.equals(Object[], Object[])</code>.</p>
|
| +
|
| +
|
| +<h3><a name="EC_INCOMPATIBLE_ARRAY_COMPARE">EC: equals(...) used to compare incompatible arrays (EC_INCOMPATIBLE_ARRAY_COMPARE)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +This method invokes the .equals(Object o) to compare two arrays, but the arrays of
|
| +of incompatible types (e.g., String[] and StringBuffer[], or String[] and int[]).
|
| +They will never be equal. In addition, when equals(...) is used to compare arrays it
|
| +only checks to see if they are the same array, and ignores the contents of the arrays.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="EC_NULL_ARG">EC: Appel de equals() avec un argument à null (EC_NULL_ARG)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode appelle <code>equals(Object)</code>, passant une valeur à <code>null</code> comme argument. D'après le contrat de la méthode <code>equals()</code>, cet appel devrait systématiquement renvoyer <code>false</code>.</p>
|
| +
|
| +
|
| +<h3><a name="EC_UNRELATED_CLASS_AND_INTERFACE">EC: Appel de equals() comparant une classe et une interface sans relation (EC_UNRELATED_CLASS_AND_INTERFACE)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode appelle <code>equals(Object)</code> sur deux références, l'une de classe, l'autre d'interface, alors que ni la classe, ni aucune de ses sous classes abstraites n'implémente l'interface. Les objets comparés ne font donc probablement pas partie de la même hiérarchie de classe à l'exécution (à moins que certaines classes de l'application n'est pas été analysées ou soient chargées dynamiquement à l'exécution). En accord avec le contrat de <code>equals()</code>, des objets de classes différentes doivent toujours être non égaux, donc le résultat de cette comparaison par <code>java.lang.Object.equals(Object)</code> renverra systèmatiquement <code>false</code> à l'exécution.</p>
|
| +
|
| +
|
| +<h3><a name="EC_UNRELATED_INTERFACES">EC: Appel de equals() comparant différentes interfaces (EC_UNRELATED_INTERFACES)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode appelle <code>equals(Object)</code> pour deux références d'interfaces sans rapport, aucune n'étant un sous-type de l'autre et aucune classe non abstraite implémentant les deux interfaces. Les objets comparés ne sont donc probablement pas de la même classe à l'éxécution (au moins que certaines classes de l'application n'aient pas été analysées ou qu'il y ait des chargements dynamiques). D'après le contrat de <code>equals()</code>, les objets de classes différentes devraient toujours être inégaux.</p>
|
| +
|
| +
|
| +<h3><a name="EC_UNRELATED_TYPES">EC: Appel de equals() comparant des types différents (EC_UNRELATED_TYPES)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode appelle <code>equals(Object)</code> pour deux références de type différents, sans sous-classe commune. Les objets comparés ne sont donc probablement pas de la même classe à l'éxécution (au moins que certaines classes de l'application n'aient pas été analysées ou qu'il y ait des chargements dynamiques). D'après le contrat de <code>equals()</code>, les objets de classes différentes devraient toujours être inégaux, c'est pourquoi la comparaison a de fortes chances de toujours renvoyer <code>false</code> à l'exécution.</p>
|
| +
|
| +
|
| +<h3><a name="EC_UNRELATED_TYPES_USING_POINTER_EQUALITY">EC: Using pointer equality to compare different types (EC_UNRELATED_TYPES_USING_POINTER_EQUALITY)</a></h3>
|
| +
|
| +
|
| +<p> This method uses using pointer equality to compare two references that seem to be of
|
| +different types. The result of this comparison will always be false at runtime.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="EQ_ALWAYS_FALSE">Eq: equals method always returns false (EQ_ALWAYS_FALSE)</a></h3>
|
| +
|
| +
|
| + <p> This class defines an equals method that always returns false. This means that an object is not equal to itself, and it is impossible to create useful Maps or Sets of this class. More fundamentally, it means
|
| +that equals is not reflexive, one of the requirements of the equals method.</p>
|
| +<p>The likely intended semantics are object identity: that an object is equal to itself. This is the behavior inherited from class <code>Object</code>. If you need to override an equals inherited from a different
|
| +superclass, you can use use:</p>
|
| +<pre>
|
| +public boolean equals(Object o) { return this == o; }
|
| +</pre>
|
| +
|
| +
|
| +<h3><a name="EQ_ALWAYS_TRUE">Eq: equals method always returns true (EQ_ALWAYS_TRUE)</a></h3>
|
| +
|
| +
|
| + <p> This class defines an equals method that always returns true. This is imaginative, but not very smart.
|
| +Plus, it means that the equals method is not symmetric.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="EQ_COMPARING_CLASS_NAMES">Eq: equals method compares class names rather than class objects (EQ_COMPARING_CLASS_NAMES)</a></h3>
|
| +
|
| +
|
| + <p> This method checks to see if two objects are the same class by checking to see if the names
|
| +of their classes are equal. You can have different classes with the same name if they are loaded by
|
| +different class loaders. Just check to see if the class objects are the same.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="EQ_DONT_DEFINE_EQUALS_FOR_ENUM">Eq: Covariant equals() method defined for enum (EQ_DONT_DEFINE_EQUALS_FOR_ENUM)</a></h3>
|
| +
|
| +
|
| + <p> This class defines an enumeration, and equality on enumerations are defined
|
| +using object identity. Defining a covariant equals method for an enumeration
|
| +value is exceptionally bad practice, since it would likely result
|
| +in having two different enumeration values that compare as equals using
|
| +the covariant enum method, and as not equal when compared normally.
|
| +Don't do it.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="EQ_OTHER_NO_OBJECT">Eq: equals() method defined that doesn't override equals(Object) (EQ_OTHER_NO_OBJECT)</a></h3>
|
| +
|
| +
|
| + <p> This class defines an <code>equals()</code>
|
| + method, that doesn't override the normal <code>equals(Object)</code> method
|
| + defined in the base <code>java.lang.Object</code> class. Instead, it
|
| + inherits an <code>equals(Object)</code> method from a superclass.
|
| + The class should probably define a <code>boolean equals(Object)</code> method.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="EQ_OTHER_USE_OBJECT">Eq: equals() method defined that doesn't override Object.equals(Object) (EQ_OTHER_USE_OBJECT)</a></h3>
|
| +
|
| +
|
| + <p> This class defines an <code>equals()</code>
|
| + method, that doesn't override the normal <code>equals(Object)</code> method
|
| + defined in the base <code>java.lang.Object</code> class.
|
| + The class should probably define a <code>boolean equals(Object)</code> method.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="EQ_OVERRIDING_EQUALS_NOT_SYMMETRIC">Eq: equals method overrides equals in superclass and may not be symmetric (EQ_OVERRIDING_EQUALS_NOT_SYMMETRIC)</a></h3>
|
| +
|
| +
|
| + <p> This class defines an equals method that overrides an equals method in a superclass. Both equals methods
|
| +methods use <code>instanceof</code> in the determination of whether two objects are equal. This is fraught with peril,
|
| +since it is important that the equals method is symmetrical (in other words, <code>a.equals(b) == b.equals(a)</code>).
|
| +If B is a subtype of A, and A's equals method checks that the argument is an instanceof A, and B's equals method
|
| +checks that the argument is an instanceof B, it is quite likely that the equivalence relation defined by these
|
| +methods is not symmetric.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="EQ_SELF_USE_OBJECT">Eq: Définition d'une méthode equals() covariante, Object.equals(Object) est hérité (EQ_SELF_USE_OBJECT)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit une version covariante de la méthode <code>equals()</code>, mais appelle la méthode normale <code>equals(Object)</code> définie dans la classe de base <code>java.lang.Object</code>. La classe devrait probablement définir une version non covariante de <code>equals()</code>. (C'est-à-dire une méthode avec la signature <code>boolean equals(java.lang.Object)</code>.</p>
|
| +
|
| +
|
| +<h3><a name="FE_TEST_IF_EQUAL_TO_NOT_A_NUMBER">FE: Test d'égalité avec NaN erroné (FE_TEST_IF_EQUAL_TO_NOT_A_NUMBER)</a></h3>
|
| +
|
| +
|
| +<p>Ce code vérifie si une valeur flottante est égale à la valeur spéciale "Not A Number" (Ex. : <code>if (x == Double.NaN)</code>). La sémantique de <code>NaN</code> fait que, par définition, aucune valeur n'est égale à <code>Nan</code>, y compris <code>NaN</code>. Donc <code>x == Double.NaN</code> renvoi systématiquement <code>false</code>.</p>
|
| +<p>Pour savoir si la valeur contenu dans <code>x</code> est la valeur particulière "Not A Number", utilisez <code>Double.isNaN(x)</code> (ou <code>Float.isNaN(x)</code> si <code>x</code> est en simple précision).</p>
|
| +
|
| +
|
| +<h3><a name="VA_FORMAT_STRING_BAD_ARGUMENT">FS: Format string placeholder incompatible with passed argument (VA_FORMAT_STRING_BAD_ARGUMENT)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +The format string placeholder is incompatible with the corresponding
|
| +argument. For example,
|
| +<code>
|
| + System.out.println("%d\n", "hello");
|
| +</code>
|
| +<p>The %d placeholder requires a numeric argument, but a string value is
|
| +passed instead.
|
| +A runtime exception will occur when
|
| +this statement is executed.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="VA_FORMAT_STRING_BAD_CONVERSION">FS: The type of a supplied argument doesn't match format specifier (VA_FORMAT_STRING_BAD_CONVERSION)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +One of the arguments is uncompatible with the corresponding format string specifier.
|
| +As a result, this will generate a runtime exception when executed.
|
| +For example, <code>String.format("%d", "1")</code> will generate an exception, since
|
| +the String "1" is incompatible with the format specifier %d.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="VA_FORMAT_STRING_EXPECTED_MESSAGE_FORMAT_SUPPLIED">FS: MessageFormat supplied where printf style format expected (VA_FORMAT_STRING_EXPECTED_MESSAGE_FORMAT_SUPPLIED)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +A method is called that expects a Java printf format string and a list of arguments.
|
| +However, the format string doesn't contain any format specifiers (e.g., %s) but
|
| +does contain message format elements (e.g., {0}). It is likely
|
| +that the code is supplying a MessageFormat string when a printf-style format string
|
| +is required. At runtime, all of the arguments will be ignored
|
| +and the format string will be returned exactly as provided without any formatting.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="VA_FORMAT_STRING_EXTRA_ARGUMENTS_PASSED">FS: More arguments are passed than are actually used in the format string (VA_FORMAT_STRING_EXTRA_ARGUMENTS_PASSED)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +A format-string method with a variable number of arguments is called,
|
| +but more arguments are passed than are actually used by the format string.
|
| +This won't cause a runtime exception, but the code may be silently omitting
|
| +information that was intended to be included in the formatted string.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="VA_FORMAT_STRING_ILLEGAL">FS: Illegal format string (VA_FORMAT_STRING_ILLEGAL)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +The format string is syntactically invalid,
|
| +and a runtime exception will occur when
|
| +this statement is executed.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="VA_FORMAT_STRING_MISSING_ARGUMENT">FS: Format string references missing argument (VA_FORMAT_STRING_MISSING_ARGUMENT)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +Not enough arguments are passed to satisfy a placeholder in the format string.
|
| +A runtime exception will occur when
|
| +this statement is executed.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="VA_FORMAT_STRING_NO_PREVIOUS_ARGUMENT">FS: No previous argument for format string (VA_FORMAT_STRING_NO_PREVIOUS_ARGUMENT)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +The format string specifies a relative index to request that the argument for the previous format specifier
|
| +be reused. However, there is no previous argument.
|
| +For example,
|
| +</p>
|
| +<p><code>formatter.format("%<s %s", "a", "b")</code>
|
| +</p>
|
| +<p>would throw a MissingFormatArgumentException when executed.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="GC_UNRELATED_TYPES">GC: No relationship between generic parameter and method argument (GC_UNRELATED_TYPES)</a></h3>
|
| +
|
| +
|
| + <p> This call to a generic collection method contains an argument
|
| + with an incompatible class from that of the collection's parameter
|
| + (i.e., the type of the argument is neither a supertype nor a subtype
|
| + of the corresponding generic type argument).
|
| + Therefore, it is unlikely that the collection contains any objects
|
| + that are equal to the method argument used here.
|
| + Most likely, the wrong value is being passed to the method.</p>
|
| + <p>In general, instances of two unrelated classes are not equal.
|
| + For example, if the <code>Foo</code> and <code>Bar</code> classes
|
| + are not related by subtyping, then an instance of <code>Foo</code>
|
| + should not be equal to an instance of <code>Bar</code>.
|
| + Among other issues, doing so will likely result in an equals method
|
| + that is not symmetrical. For example, if you define the <code>Foo</code> class
|
| + so that a <code>Foo</code> can be equal to a <code>String</code>,
|
| + your equals method isn't symmetrical since a <code>String</code> can only be equal
|
| + to a <code>String</code>.
|
| + </p>
|
| + <p>In rare cases, people do define nonsymmetrical equals methods and still manage to make
|
| + their code work. Although none of the APIs document or guarantee it, it is typically
|
| + the case that if you check if a <code>Collection<String></code> contains
|
| + a <code>Foo</code>, the equals method of argument (e.g., the equals method of the
|
| + <code>Foo</code> class) used to perform the equality checks.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="HE_SIGNATURE_DECLARES_HASHING_OF_UNHASHABLE_CLASS">HE: Signature declares use of unhashable class in hashed construct (HE_SIGNATURE_DECLARES_HASHING_OF_UNHASHABLE_CLASS)</a></h3>
|
| +
|
| +
|
| + <p> A method, field or class declares a generic signature where a non-hashable class
|
| +is used in context where a hashable class is required.
|
| +A class that declares an equals method but inherits a hashCode() method
|
| +from Object is unhashable, since it doesn't fulfill the requirement that
|
| +equal objects have equal hashCodes.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="HE_USE_OF_UNHASHABLE_CLASS">HE: Use of class without a hashCode() method in a hashed data structure (HE_USE_OF_UNHASHABLE_CLASS)</a></h3>
|
| +
|
| +
|
| + <p> A class defines an equals(Object) method but not a hashCode() method,
|
| +and thus doesn't fulfill the requirement that equal objects have equal hashCodes.
|
| +An instance of this class is used in a hash data structure, making the need to
|
| +fix this problem of highest importance.
|
| +
|
| +
|
| +<h3><a name="ICAST_INT_2_LONG_AS_INSTANT">ICAST: int value converted to long and used as absolute time (ICAST_INT_2_LONG_AS_INSTANT)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +This code converts a 32-bit int value to a 64-bit long value, and then
|
| +passes that value for a method parameter that requires an absolute time value.
|
| +An absolute time value is the number
|
| +of milliseconds since the standard base time known as "the epoch", namely January 1, 1970, 00:00:00 GMT.
|
| +For example, the following method, intended to convert seconds since the epoc into a Date, is badly
|
| +broken:</p>
|
| +<pre>
|
| +Date getDate(int seconds) { return new Date(seconds * 1000); }
|
| +</pre>
|
| +<p>The multiplication is done using 32-bit arithmetic, and then converted to a 64-bit value.
|
| +When a 32-bit value is converted to 64-bits and used to express an absolute time
|
| +value, only dates in December 1969 and January 1970 can be represented.</p>
|
| +
|
| +<p>Correct implementations for the above method are:</p>
|
| +
|
| +<pre>
|
| +// Fails for dates after 2037
|
| +Date getDate(int seconds) { return new Date(seconds * 1000L); }
|
| +
|
| +// better, works for all dates
|
| +Date getDate(long seconds) { return new Date(seconds * 1000); }
|
| +</pre>
|
| +
|
| +
|
| +<h3><a name="ICAST_INT_CAST_TO_DOUBLE_PASSED_TO_CEIL">ICAST: Valeur entière transtypée en nombre flottant passée à Math.ceil (ICAST_INT_CAST_TO_DOUBLE_PASSED_TO_CEIL)</a></h3>
|
| +
|
| +
|
| +<p>Ce code convertit une valeur entière en nombre flottant à double précision et passe le résultat à la méthode <code>Math.ceil()</code>, qui arrondit un nombre flottant à sa valeur entière immédiatement supérieure. Cette opération n'a pas de raison d'être, puisque le transtypage d'un entier en double donne un nombre sans valeur après la virgule. Il est vraissemblable que l'opération qui a créé la valeur pour la passer à <code>Math.ceil</code> visait l'utilisation de l'arithmétique sur un nombre flottant en double précision.</p>
|
| +
|
| +
|
| +<h3><a name="ICAST_INT_CAST_TO_FLOAT_PASSED_TO_ROUND">ICAST: Valeur entière transtypée en flottant puis transmise à Math.round (ICAST_INT_CAST_TO_FLOAT_PASSED_TO_ROUND)</a></h3>
|
| +
|
| +
|
| +<p>Ce code converti une valeur entière en flottant simple précision puis la passe à la méthode <code>Math.round()</code> qui renvoi l'<code>int</code> ou le <code>long</code> le plus proche de son paramètre. Cette opération doit toujours revenir à ne rien faire, puisque le transtypage d'un entier en un flottant devrait systématiquement donner un flottant sans partie décimale. Il est probable que l'opération gérant la valeur passée à <code>Math.round()</code> devrait être effectuée en arithmétique flottante.</p>
|
| +
|
| +
|
| +<h3><a name="IJU_ASSERT_METHOD_INVOKED_FROM_RUN_METHOD">IJU: JUnit assertion in run method will not be noticed by JUnit (IJU_ASSERT_METHOD_INVOKED_FROM_RUN_METHOD)</a></h3>
|
| +
|
| +
|
| +<p> A JUnit assertion is performed in a run method. Failed JUnit assertions
|
| +just result in exceptions being thrown.
|
| +Thus, if this exception occurs in a thread other than the thread that invokes
|
| +the test method, the exception will terminate the thread but not result
|
| +in the test failing.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="IJU_BAD_SUITE_METHOD">IJU: TestCase declares a bad suite method (IJU_BAD_SUITE_METHOD)</a></h3>
|
| +
|
| +
|
| +<p> Class is a JUnit TestCase and defines a suite() method.
|
| +However, the suite method needs to be declared as either</p>
|
| +<pre>public static junit.framework.Test suite()</pre>
|
| +or
|
| +<pre>public static junit.framework.TestSuite suite()</pre>
|
| +
|
| +
|
| +<h3><a name="IJU_NO_TESTS">IJU: TestCase sans tests (IJU_NO_TESTS)</a></h3>
|
| +
|
| +
|
| +<p>La classe JUnit <code>TestCase</code> n'implémente aucune méthode de test.</p>
|
| +
|
| +
|
| +<h3><a name="IJU_SETUP_NO_SUPER">IJU: Une classe dérivant de TestCase implémente setUp() sans appeler super.setUp() (IJU_SETUP_NO_SUPER)</a></h3>
|
| +
|
| +
|
| +<p>La classe dérive de la classe <code>TestCase</code> de JUnit est implémente la méthode <code>setUp()</code>. La méthode <code>setUp()</code> devrait appeler <code>super.setUp()</code>, mais ne le fait pas.</p>
|
| +
|
| +
|
| +<h3><a name="IJU_SUITE_NOT_STATIC">IJU: Une classe dérivant de TestCase implémente une méthode suite() non statique (IJU_SUITE_NOT_STATIC)</a></h3>
|
| +
|
| +
|
| +<p>La classe dérive de <code>TestCase</code> de JUnit et implémente une méthode <code>suite()</code>. La méthode <code>suite()</code> devrait-être déclarée comme étant <code>static</code>, ce qui n'est pas fait.</p>
|
| +
|
| +
|
| +<h3><a name="IJU_TEARDOWN_NO_SUPER">IJU: Une classe dérivant de TestCase implémente tearDown() sans appeler super.tearDown() (IJU_TEARDOWN_NO_SUPER)</a></h3>
|
| +
|
| +
|
| +<p>La classe dérive de la classe <code>TestCase</code> de JUnit et implémente la méthode <code>tearDown()</code>. La méthode <code>tearDown()</code> devrait appeler <code>super.tearDown()</code>, mais ne le fait pas.</p>
|
| +
|
| +
|
| +<h3><a name="IL_CONTAINER_ADDED_TO_ITSELF">IL: Un conteneur est ajouté à lui-même (IL_CONTAINER_ADDED_TO_ITSELF)</a></h3>
|
| +
|
| +
|
| +<p>Un conteneur est ajouté à lui-même. Il en résulte que le calcul du code de hachage de cet ensemble provequera une <code>StackOverflowEception</code>.</p>
|
| +
|
| +
|
| +<h3><a name="IL_INFINITE_LOOP">IL: Boucle apparemment inifinie (IL_INFINITE_LOOP)</a></h3>
|
| +
|
| +
|
| +<p>Cette boucle ne semble pas avoir un moyen de se terminer (autrement que, peut être, en déclenchant une exception).</p>
|
| +
|
| +
|
| +<h3><a name="IL_INFINITE_RECURSIVE_LOOP">IL: Boucle récursive infinie (IL_INFINITE_RECURSIVE_LOOP)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode s'appelle elle-même sans condition. Cela semble indiquer une boucle récursive infinie qui se terminera sur un débordement de la pile.</p>
|
| +
|
| +
|
| +<h3><a name="IM_MULTIPLYING_RESULT_OF_IREM">IM: Multiplication d'un entier avec le résulat entier d'un modulo (IM_MULTIPLYING_RESULT_OF_IREM)</a></h3>
|
| +
|
| +
|
| +<p>Ce code mutilplie le résultat d'un modulo avec une constante entière. Faîtes attention à la précédence des opérateurs. Par exemple, <code>i % 60 * 1000</code> correspond à <code>(i % 60) * 1000</code>, non à <code>i % (60 * 1000)</code>.</p>
|
| +
|
| +
|
| +<h3><a name="INT_BAD_COMPARISON_WITH_INT_VALUE">INT: Bad comparison of int value with long constant (INT_BAD_COMPARISON_WITH_INT_VALUE)</a></h3>
|
| +
|
| +
|
| +<p> This code compares an int value with a long constant that is outside
|
| +the range of values that can be represented as an int value.
|
| +This comparison is vacuous and possibily to be incorrect.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="INT_BAD_COMPARISON_WITH_NONNEGATIVE_VALUE">INT: Bad comparison of nonnegative value with negative constant (INT_BAD_COMPARISON_WITH_NONNEGATIVE_VALUE)</a></h3>
|
| +
|
| +
|
| +<p> This code compares a value that is guaranteed to be non-negative with a negative constant.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="INT_BAD_COMPARISON_WITH_SIGNED_BYTE">INT: Bad comparison of signed byte (INT_BAD_COMPARISON_WITH_SIGNED_BYTE)</a></h3>
|
| +
|
| +
|
| +<p> Signed bytes can only have a value in the range -128 to 127. Comparing
|
| +a signed byte with a value outside that range is vacuous and likely to be incorrect.
|
| +To convert a signed byte <code>b</code> to an unsigned value in the range 0..255,
|
| +use <code>0xff & b</code>
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="IO_APPENDING_TO_OBJECT_OUTPUT_STREAM">IO: Doomed attempt to append to an object output stream (IO_APPENDING_TO_OBJECT_OUTPUT_STREAM)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + This code opens a file in append mode and then wraps the result in an object output stream.
|
| + This won't allow you to append to an existing object output stream stored in a file. If you want to be
|
| + able to append to an object output stream, you need to keep the object output stream open.
|
| + </p>
|
| + <p>The only situation in which opening a file in append mode and the writing an object output stream
|
| + could work is if on reading the file you plan to open it in random access mode and seek to the byte offset
|
| + where the append started.
|
| + </p>
|
| +
|
| + <p>
|
| + TODO: example.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="IP_PARAMETER_IS_DEAD_BUT_OVERWRITTEN">IP: Un paramètre est ré-écrit avant d'être utilisé (IP_PARAMETER_IS_DEAD_BUT_OVERWRITTEN)</a></h3>
|
| +
|
| +
|
| +<p>La valeur initiale de ce paramètre est ignorée, et le paramètre est écrasé. Ceci indique généralement une erreur provenant de la croyance infondée qu'une écriture sur ce paramètre sera transmise à l'appelant.</p>
|
| +
|
| +
|
| +<h3><a name="MF_CLASS_MASKS_FIELD">MF: La classe définit un champ qui masque un champ d'une classe mère (MF_CLASS_MASKS_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit un champ avec le même nom qu'un champ visible d'instance d'une classe mère. C'est ambigu et peut entraîner une erreur si des méthodes mettent à jour ou accèdent à un des champs alors qu'elles souhaitaient utiliser l'autre.</p>
|
| +
|
| +
|
| +<h3><a name="MF_METHOD_MASKS_FIELD">MF: La méthode définit une variable qui masque un champ (MF_METHOD_MASKS_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode définit une variable locale ayant le même nom qu'un champ de la classe ou d'une classe mère. Ceci peut pousser la méthode à lire une valeur non initialisée dans le champs, à le laisser non initialisé ou les deux.</p>
|
| +
|
| +
|
| +<h3><a name="NP_ALWAYS_NULL">NP: Déréférencement d'un pointeur null dans la méthode (NP_ALWAYS_NULL)</a></h3>
|
| +
|
| +
|
| +<p>Un pointeur à <code>null</code> est déréférencé ici. Ceci va mener à une <code>NullPointerException</code> quand le code sera exécuté.</p>
|
| +
|
| +
|
| +<h3><a name="NP_ALWAYS_NULL_EXCEPTION">NP: Déréférencement d'un pointeur null dans le chemin d'exception d'une méthode (NP_ALWAYS_NULL_EXCEPTION)</a></h3>
|
| +
|
| +
|
| +<p>Un pointeur à <code>null</code> dans le chemin d'exception est déréférencé ici. Cela va mener à une <code>NullPointerException</code> quand le code sera exécuté. Notez que puisque FindBugs ne détecte pas les chemins d'exception irréalisables, il est possible que cette alarme soit injustifiée.</p>
|
| +<p>Notez aussi que FindBugs considère le choix par défaut d'un <code>switch</code> comme étant dans le chemin d'exception, puisque ce choix est souvent irréalisable.</p>
|
| +
|
| +
|
| +<h3><a name="NP_ARGUMENT_MIGHT_BE_NULL">NP: Méthode ne testant pas les paramètres à null (NP_ARGUMENT_MIGHT_BE_NULL)</a></h3>
|
| +
|
| +
|
| +<p>Un paramètre de cette méthode a été identifié comme une valeur pouvant être à <code>null</code>, mais qui est déréférencée sans test de nullité.</p>
|
| +
|
| +
|
| +<h3><a name="NP_CLOSING_NULL">NP: close() invoked on a value that is always null (NP_CLOSING_NULL)</a></h3>
|
| +
|
| +
|
| +<p> close() is being invoked on a value that is always null. If this statement is executed,
|
| +a null pointer exception will occur. But the big risk here you never close
|
| +something that should be closed.
|
| +
|
| +
|
| +<h3><a name="NP_GUARANTEED_DEREF">NP: Null déréférencé (NP_GUARANTEED_DEREF)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient une valeur à <code>null</code> qui est déréférencée (sauf dans les chemins impliquant une RuntimeException).</p>
|
| +
|
| +
|
| +<h3><a name="NP_GUARANTEED_DEREF_ON_EXCEPTION_PATH">NP: Value is null and guaranteed to be dereferenced on exception path (NP_GUARANTEED_DEREF_ON_EXCEPTION_PATH)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + There is a statement or branch on an exception path
|
| + that if executed guarantees that
|
| + a value is null at this point, and that
|
| + value that is guaranteed to be dereferenced
|
| + (except on forward paths involving runtime exceptions).
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="NP_NONNULL_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR">NP: Nonnull field is not initialized (NP_NONNULL_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR)</a></h3>
|
| +
|
| +
|
| + <p> The field is marked as nonnull, but isn't written to by the constructor.
|
| + The field might be initialized elsewhere during constructor, or might always
|
| + be initialized before use.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="NP_NONNULL_PARAM_VIOLATION">NP: Appel de méthode transmettant null à un paramètre déclaré @NonNull (NP_NONNULL_PARAM_VIOLATION)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode passe une valeur à <code>null</code> en paramètre d'une méthode qui a déclaré ce paramètre comme <code>@NonNull</code>.</p>
|
| +<p>Notez que la méthode avec l'annotation <code>@NonNull</code> peut être dans une sous-classe de l'objet appelé.</p>
|
| +
|
| +
|
| +<h3><a name="NP_NONNULL_RETURN_VIOLATION">NP: Méthode renvoyer null mais déclarée @NonNull (NP_NONNULL_RETURN_VIOLATION)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode peut renvoyer une valeur à <code>null</code> alors que cette méthode (ou une méthode dérivée d'une de ses classes mère) est déclarée comme renvoyant <code>@NonNull</code>.</p>
|
| +
|
| +
|
| +<h3><a name="NP_NULL_INSTANCEOF">NP: A known null value is checked to see if it is an instance of a type (NP_NULL_INSTANCEOF)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +This instanceof test will always return false, since the value being checked is guaranteed to be null.
|
| +Although this is safe, make sure it isn't
|
| +an indication of some misunderstanding or some other logic error.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="NP_NULL_ON_SOME_PATH">NP: Possible déréférencement d'un pointeur null dans une méthode (NP_NULL_ON_SOME_PATH)</a></h3>
|
| +
|
| +
|
| +<p>Une valeur par référence déréférencée ici peut-être à <code>null</code> à l'exécution. Cela peut conduire à une <code>NullPointerException</code> quand le code est exécuté.</p>
|
| +
|
| +
|
| +<h3><a name="NP_NULL_ON_SOME_PATH_EXCEPTION">NP: Possible déréférencement d'un pointeur null dans le chemin d'exception d'une méthode (NP_NULL_ON_SOME_PATH_EXCEPTION)</a></h3>
|
| +
|
| +
|
| +<p>Une valeur par référence qui est à <code>null</code> dans un des chemins d'exception est déréférencée ici. Ceci peut conduire à une <code>NullPointerException</code> à l'exécution du code. Notez que comme FindBugs ne repère pas les chemins d'exception irréalisables, il est possible que cette alarme soit injustifiée.</p>
|
| +<p>Notez également que FindBugs considère le cas par défaut d'un <code>switch</code> comme faisant partie du chemin d'exception puisque ce cas est souvent inattendu.</p>
|
| +
|
| +
|
| +<h3><a name="NP_NULL_PARAM_DEREF">NP: Méthode passant null à un paramètre déréférencé inconditionnellement (NP_NULL_PARAM_DEREF)</a></h3>
|
| +
|
| +
|
| +<p>Cet appel de méthode envoie <code>null</code> à une méthode qui peut déréférencer ce paramètre de façon inconditionnelle.</p>
|
| +
|
| +
|
| +<h3><a name="NP_NULL_PARAM_DEREF_ALL_TARGETS_DANGEROUS">NP: Appel de méthode passant null à un paramètre déréférencé inconditionnellement (NP_NULL_PARAM_DEREF_ALL_TARGETS_DANGEROUS)</a></h3>
|
| +
|
| +
|
| +<p>Une valeur pouvant être à <code>null</code> est passée lors d'un appel alors que toutes les méthodes cibles possibles le déréférence inconditionnellement. Cela a de fortes chances de provoquer une <code>NullPointerException</code>.</p>
|
| +
|
| +
|
| +<h3><a name="NP_NULL_PARAM_DEREF_NONVIRTUAL">NP: Appel à une méthode non virtuelle passant null à un paramètre déréférencé de façon inconditionnelle (NP_NULL_PARAM_DEREF_NONVIRTUAL)</a></h3>
|
| +
|
| +
|
| +<p>Une valeur pouvant être à <code>null</code> est passée à une méthode qui déréférence ce paramètre de façon inconditionnelle. Cela peut se terminer en <code>NullPointerException</code>.</p>
|
| +
|
| +
|
| +<h3><a name="NP_OPTIONAL_RETURN_NULL">NP: Method with Optional return type returns explicit null (NP_OPTIONAL_RETURN_NULL)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + The usage of Optional return type always mean that explicit null returns were not desired by design.
|
| + Returning a null value in such case is a contract violation and will most likely break clients code.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="NP_STORE_INTO_NONNULL_FIELD">NP: Stocke une valeur null dans un champ annoté NonNull (NP_STORE_INTO_NONNULL_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Une valeur qui pourrait être à <code>null</code> est stockée dans un champ qui a été annoté comme <code>NonNull</code>.</p>
|
| +
|
| +
|
| +<h3><a name="NP_UNWRITTEN_FIELD">NP: Lecture d'un champ jamais écrit (NP_UNWRITTEN_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Le programme déréférence un champ qui ne semble jamais alimenté par une valeur non nulle. Déréférencer cette valeur provoquera une <code>NullPointerException</code>.</p>
|
| +
|
| +
|
| +<h3><a name="NM_BAD_EQUAL">Nm: La classe définit equal() ; ne devrait-ce pas être equals() ? (NM_BAD_EQUAL)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit une méthode <code>equal(Object)</code>. Cette méthode ne surcharge pas la méthode <code>equals(Object)</code> de <code>java.lang.Object</code>, surchage qui était pourtant sans doute le but visé.</p>
|
| +
|
| +
|
| +<h3><a name="NM_LCASE_HASHCODE">Nm: La classe définit hashcode() ; ne devrait-ce pas être hashCode() ? (NM_LCASE_HASHCODE)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit une méthode nommée <code>hashcode()</code>. Cette méthode ne surcharge pas la méthode <code>hashCode()</code> de <code>java.lang.Object</code>, surchage qui était pourtant sans doute le but visé.</p>
|
| +
|
| +
|
| +<h3><a name="NM_LCASE_TOSTRING">Nm: La classe définit tostring() ; ne devrait-ce pas être toString() ? (NM_LCASE_TOSTRING)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe définit une méthode appelée <code>tostring()</code>. Cette méthode ne surcharge pas la méthode <code>toString()</code> de <code>java.lang.Object</code>, surchage qui était pourtant sans doute le but visé.</p>
|
| +
|
| +
|
| +<h3><a name="NM_METHOD_CONSTRUCTOR_CONFUSION">Nm: Confusion apparente entre une méthode et un constructeur (NM_METHOD_CONSTRUCTOR_CONFUSION)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode a le même nom que la classe dans laquelle elle est déclarée. Il est probable qu'elle devait être un constructeur.
|
| +Si c'est bien le cas, retirez la déclaration d'une valeur de retour.</p>
|
| +
|
| +
|
| +<h3><a name="NM_VERY_CONFUSING">Nm: Noms de méthodes très ambigus (NM_VERY_CONFUSING)</a></h3>
|
| +
|
| +
|
| +<p>Les méthodes indiquées ont des noms qui ne diffèrent que par les majuscules. C'est d'autant plus ambigu que les classes comportant ces méthodes sont liées par héritage.</p>
|
| +
|
| +
|
| +<h3><a name="NM_WRONG_PACKAGE">Nm: Method doesn't override method in superclass due to wrong package for parameter (NM_WRONG_PACKAGE)</a></h3>
|
| +
|
| +
|
| + <p> The method in the subclass doesn't override a similar method in a superclass because the type of a parameter doesn't exactly match
|
| +the type of the corresponding parameter in the superclass. For example, if you have:</p>
|
| +
|
| +<blockquote>
|
| +<pre>
|
| +import alpha.Foo;
|
| +public class A {
|
| + public int f(Foo x) { return 17; }
|
| +}
|
| +----
|
| +import beta.Foo;
|
| +public class B extends A {
|
| + public int f(Foo x) { return 42; }
|
| +}
|
| +</pre>
|
| +</blockquote>
|
| +
|
| +<p>The <code>f(Foo)</code> method defined in class <code>B</code> doesn't
|
| +override the
|
| +<code>f(Foo)</code> method defined in class <code>A</code>, because the argument
|
| +types are <code>Foo</code>'s from different packages.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="QBA_QUESTIONABLE_BOOLEAN_ASSIGNMENT">QBA: Méthode assignant une valeur boléenne fixe dans une expression booléenne (QBA_QUESTIONABLE_BOOLEAN_ASSIGNMENT)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode assigne une valeur booléenne fixe (<code>true</code> ou <code>false</code>) à une variable booléenne dans une expression <code>if</code> ou <code>while</code>. Il est probable que le but était d'effectuer une comparaison booléenne utilisant <code>==</code> et non pas une affectation avec <code>=</code>.</p>
|
| +
|
| +
|
| +<h3><a name="RC_REF_COMPARISON">RC: Comparaison de références suspecte (RC_REF_COMPARISON)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode compare deux références avec l'opérateur <code>==</code> ou <code>!=</code>, alors que la façon correcte de comparer les instances de ce type est généralement d'utiliser la méthode <code>equals()</code>. Des exemples de classes qui ne doivent généralement pas être comparées par référence sont <code>java.lang.Integer</code>, <code>java.lang.Float</code>, etc...</p>
|
| +
|
| +
|
| +<h3><a name="RCN_REDUNDANT_NULLCHECK_WOULD_HAVE_BEEN_A_NPE">RCN: Test de nullité d'une valeur préalablement déréférencée (RCN_REDUNDANT_NULLCHECK_WOULD_HAVE_BEEN_A_NPE)</a></h3>
|
| +
|
| +
|
| +<p>Une valeur est testée ici pour savoir si elle est à <code>null</code> alors que cette valeur ne peut pas être à <code>null</code> puisqu'elle a été déréférencée et qu'une <code>NullPointerException</code> se serait alors produite à ce moment. Ce code est en contradiction avec le déréférencement préalable au sujet de la capacité de cette valeur d'être à <code>null</code>. Soit le test est redondant, soit le déréférencement préalable est erroné.</p>
|
| +
|
| +
|
| +<h3><a name="RE_BAD_SYNTAX_FOR_REGULAR_EXPRESSION">RE: Syntaxe d'expression régulière invalide (RE_BAD_SYNTAX_FOR_REGULAR_EXPRESSION)</a></h3>
|
| +
|
| +
|
| +<p>Le code utilise une expression régulière qui est invalide selon la syntaxe des expressions régulières. Lors de l'exécution, une exception <code>PatternSyntaxException</code> sera lancée.</p>
|
| +
|
| +
|
| +<h3><a name="RE_CANT_USE_FILE_SEPARATOR_AS_REGULAR_EXPRESSION">RE: File.separator used for regular expression (RE_CANT_USE_FILE_SEPARATOR_AS_REGULAR_EXPRESSION)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +The code here uses <code>File.separator</code>
|
| +where a regular expression is required. This will fail on Windows
|
| +platforms, where the <code>File.separator</code> is a backslash, which is interpreted in a
|
| +regular expression as an escape character. Amoung other options, you can just use
|
| +<code>File.separatorChar=='\\' ? "\\\\" : File.separator</code> instead of
|
| +<code>File.separator</code>
|
| +
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="RE_POSSIBLE_UNINTENDED_PATTERN">RE: "." utilisé dans une expression régulière (RE_POSSIBLE_UNINTENDED_PATTERN)</a></h3>
|
| +
|
| +
|
| +<p>Une fonction <code>String</code> attendant une expression régulière reçoit "." en paramètre. Est-ce voulu ? Par exemple, <code>s.replaceAll(".", "/")</code> renverra une chaine dont <b>chaque</b> caractère aura été remplacé par le caractère '/'.</p>
|
| +
|
| +
|
| +<h3><a name="RV_01_TO_INT">RV: Les valeurs aléatoires entre 0 et 1 sont réduites à l'entier 0 (RV_01_TO_INT)</a></h3>
|
| +
|
| +
|
| +<p>Une valeur aléatoire comprise entre 0 et 1 est réduite à la valeur entière 0. Vous souhaitez probablement multiplier cette valeur aléatoire par quelque chose avant de la réduire à un entier, ou utiliser la méthode <code>Random.nextInt(n)</code>.</p>
|
| +
|
| +
|
| +<h3><a name="RV_ABSOLUTE_VALUE_OF_HASHCODE">RV: Bad attempt to compute absolute value of signed 32-bit hashcode (RV_ABSOLUTE_VALUE_OF_HASHCODE)</a></h3>
|
| +
|
| +
|
| +<p> This code generates a hashcode and then computes
|
| +the absolute value of that hashcode. If the hashcode
|
| +is <code>Integer.MIN_VALUE</code>, then the result will be negative as well (since
|
| +<code>Math.abs(Integer.MIN_VALUE) == Integer.MIN_VALUE</code>).
|
| +</p>
|
| +<p>One out of 2^32 strings have a hashCode of Integer.MIN_VALUE,
|
| +including "polygenelubricants" "GydZG_" and ""DESIGNING WORKHOUSES".
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="RV_ABSOLUTE_VALUE_OF_RANDOM_INT">RV: Bad attempt to compute absolute value of signed random integer (RV_ABSOLUTE_VALUE_OF_RANDOM_INT)</a></h3>
|
| +
|
| +
|
| +<p> This code generates a random signed integer and then computes
|
| +the absolute value of that random integer. If the number returned by the random number
|
| +generator is <code>Integer.MIN_VALUE</code>, then the result will be negative as well (since
|
| +<code>Math.abs(Integer.MIN_VALUE) == Integer.MIN_VALUE</code>). (Same problem arised for long values as well).
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="RV_CHECK_COMPARETO_FOR_SPECIFIC_RETURN_VALUE">RV: Code checks for specific values returned by compareTo (RV_CHECK_COMPARETO_FOR_SPECIFIC_RETURN_VALUE)</a></h3>
|
| +
|
| +
|
| + <p> This code invoked a compareTo or compare method, and checks to see if the return value is a specific value,
|
| +such as 1 or -1. When invoking these methods, you should only check the sign of the result, not for any specific
|
| +non-zero value. While many or most compareTo and compare methods only return -1, 0 or 1, some of them
|
| +will return other values.
|
| +
|
| +
|
| +<h3><a name="RV_EXCEPTION_NOT_THROWN">RV: Exception created and dropped rather than thrown (RV_EXCEPTION_NOT_THROWN)</a></h3>
|
| +
|
| +
|
| + <p> This code creates an exception (or error) object, but doesn't do anything with it. For example,
|
| +something like </p>
|
| +<blockquote>
|
| +<pre>
|
| +if (x < 0)
|
| + new IllegalArgumentException("x must be nonnegative");
|
| +</pre>
|
| +</blockquote>
|
| +<p>It was probably the intent of the programmer to throw the created exception:</p>
|
| +<blockquote>
|
| +<pre>
|
| +if (x < 0)
|
| + throw new IllegalArgumentException("x must be nonnegative");
|
| +</pre>
|
| +</blockquote>
|
| +
|
| +
|
| +<h3><a name="RV_RETURN_VALUE_IGNORED">RV: La méthode ignore une valeur de retour (RV_RETURN_VALUE_IGNORED)</a></h3>
|
| +
|
| +
|
| +<p>La valeur renvoyée par cette méthode devrait-être vérifiée. Une cause habituelle de cette alarme est d'invoquer une méthode sur un objet constant en pensant que cela modifiera l'objet. Par exemple :</p>
|
| +<blockquote>
|
| +<pre>
|
| +String dateString = getHeaderField(name);
|
| +dateString.trim();
|
| +</pre>
|
| +</blockquote>
|
| +<p>Le programmeur semble croire que la méthode <code>trim()</code> mettra à jour l'objet <code>String</code> référencé par <code>dateString</code>. Mais, les objets <code>String</code> étant constants, la fonction renvoi une nouvelle valeur qui est ici ignorée. Le code devrait être corrigé en :</p>
|
| +<blockquote>
|
| +<pre>
|
| +String dateString = getHeaderField(name);
|
| +dateString = dateString.trim();
|
| +</pre>
|
| +</blockquote>
|
| +
|
| +
|
| +<h3><a name="RpC_REPEATED_CONDITIONAL_TEST">RpC: Repeated conditional tests (RpC_REPEATED_CONDITIONAL_TEST)</a></h3>
|
| +
|
| +
|
| +<p>The code contains a conditional test is performed twice, one right after the other
|
| +(e.g., <code>x == 0 || x == 0</code>). Perhaps the second occurrence is intended to be something else
|
| +(e.g., <code>x == 0 || y == 0</code>).
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="SA_FIELD_SELF_ASSIGNMENT">SA: Auto-alimentation d'un champs (SA_FIELD_SELF_ASSIGNMENT)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient un champ s'auto-alimentant; par exemple :</p>
|
| +<pre>
|
| +int x;
|
| +public void foo() {
|
| + x = x;
|
| +}
|
| +</pre>
|
| +<p>De telles affectations sont inutiles et peuvent indiquer une faute de frappe ou une erreur logique.</p>
|
| +
|
| +
|
| +<h3><a name="SA_FIELD_SELF_COMPARISON">SA: Self comparison of field with itself (SA_FIELD_SELF_COMPARISON)</a></h3>
|
| +
|
| +
|
| +<p> This method compares a field with itself, and may indicate a typo or
|
| +a logic error. Make sure that you are comparing the right things.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="SA_FIELD_SELF_COMPUTATION">SA: Nonsensical self computation involving a field (e.g., x & x) (SA_FIELD_SELF_COMPUTATION)</a></h3>
|
| +
|
| +
|
| +<p> This method performs a nonsensical computation of a field with another
|
| +reference to the same field (e.g., x&x or x-x). Because of the nature
|
| +of the computation, this operation doesn't seem to make sense,
|
| +and may indicate a typo or
|
| +a logic error. Double check the computation.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="SA_LOCAL_SELF_ASSIGNMENT_INSTEAD_OF_FIELD">SA: Self assignment of local rather than assignment to field (SA_LOCAL_SELF_ASSIGNMENT_INSTEAD_OF_FIELD)</a></h3>
|
| +
|
| +
|
| +<p> This method contains a self assignment of a local variable, and there
|
| +is a field with an identical name.
|
| +assignment appears to have been ; e.g.</p>
|
| +<pre>
|
| + int foo;
|
| + public void setFoo(int foo) {
|
| + foo = foo;
|
| + }
|
| +</pre>
|
| +<p>The assignment is useless. Did you mean to assign to the field instead?</p>
|
| +
|
| +
|
| +<h3><a name="SA_LOCAL_SELF_COMPARISON">SA: Self comparison of value with itself (SA_LOCAL_SELF_COMPARISON)</a></h3>
|
| +
|
| +
|
| +<p> This method compares a local variable with itself, and may indicate a typo or
|
| +a logic error. Make sure that you are comparing the right things.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="SA_LOCAL_SELF_COMPUTATION">SA: Nonsensical self computation involving a variable (e.g., x & x) (SA_LOCAL_SELF_COMPUTATION)</a></h3>
|
| +
|
| +
|
| +<p> This method performs a nonsensical computation of a local variable with another
|
| +reference to the same variable (e.g., x&x or x-x). Because of the nature
|
| +of the computation, this operation doesn't seem to make sense,
|
| +and may indicate a typo or
|
| +a logic error. Double check the computation.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="SF_DEAD_STORE_DUE_TO_SWITCH_FALLTHROUGH">SF: Dead store due to switch statement fall through (SF_DEAD_STORE_DUE_TO_SWITCH_FALLTHROUGH)</a></h3>
|
| +
|
| +
|
| + <p> A value stored in the previous switch case is overwritten here due to a switch fall through. It is likely that
|
| + you forgot to put a break or return at the end of the previous case.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="SF_DEAD_STORE_DUE_TO_SWITCH_FALLTHROUGH_TO_THROW">SF: Dead store due to switch statement fall through to throw (SF_DEAD_STORE_DUE_TO_SWITCH_FALLTHROUGH_TO_THROW)</a></h3>
|
| +
|
| +
|
| + <p> A value stored in the previous switch case is ignored here due to a switch fall through to a place where
|
| + an exception is thrown. It is likely that
|
| + you forgot to put a break or return at the end of the previous case.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="SIC_THREADLOCAL_DEADLY_EMBRACE">SIC: Deadly embrace of non-static inner class and thread local (SIC_THREADLOCAL_DEADLY_EMBRACE)</a></h3>
|
| +
|
| +
|
| + <p> This class is an inner class, but should probably be a static inner class.
|
| + As it is, there is a serious danger of a deadly embrace between the inner class
|
| + and the thread local in the outer class. Because the inner class isn't static,
|
| + it retains a reference to the outer class.
|
| + If the thread local contains a reference to an instance of the inner
|
| + class, the inner and outer instance will both be reachable
|
| + and not eligible for garbage collection.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="SIO_SUPERFLUOUS_INSTANCEOF">SIO: Vérification de type inutile avec l'opérateur instanceof (SIO_SUPERFLUOUS_INSTANCEOF)</a></h3>
|
| +
|
| +
|
| +<p>Vérification de type effectuée avec l'opérateur <code>instanceof</code> alors que cela pourrait-être déterminé statiquement.</p>
|
| +
|
| +
|
| +<h3><a name="SQL_BAD_PREPARED_STATEMENT_ACCESS">SQL: Méthode essayant au paramêtre d'indice 0 d'un PreparedStatement (SQL_BAD_PREPARED_STATEMENT_ACCESS)</a></h3>
|
| +
|
| +
|
| +<p>Un appel à une méthode <code>setXXX</code> d'un <code>PreparedStatement</code> est réalisé sur l'indice 0. Puisque les indices des paramêtres d'un <code>PreparedStatement</code> commencent à 1, c'est toujours une erreur.</p>
|
| +
|
| +
|
| +<h3><a name="SQL_BAD_RESULTSET_ACCESS">SQL: Méthode essayant d'accèder à un champ de ResultSet d'indice 0 (SQL_BAD_RESULTSET_ACCESS)</a></h3>
|
| +
|
| +
|
| +<p>Un appel à une méthode <code>getXXX</code> ou <code>updateXXX</code> d'un <code>ResultSet</code> est réalisé pour l'indice 0. Puisque les indices de <code>ResultSet</code> commencent à 1, c'est toujours une erreur.</p>
|
| +
|
| +
|
| +<h3><a name="STI_INTERRUPTED_ON_CURRENTTHREAD">STI: Utilisation superflue d'un appel à currentThread() pour appeler interrupted() (STI_INTERRUPTED_ON_CURRENTTHREAD)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode invoque <code>Thread.currentThread()</code> juste pour appeler la méthode <code>interrupted()</code>. Comme <code>interrupted()</code> est une méthode statique, il est plus simple et facile d'utiliser <code>Thread.interrupted()</code>.</p>
|
| +
|
| +
|
| +<h3><a name="STI_INTERRUPTED_ON_UNKNOWNTHREAD">STI: Thread.interrupted() appelée par erreur sur un objet Thread arbitraire (STI_INTERRUPTED_ON_UNKNOWNTHREAD)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode invoque <code>Thread.interrupted()</code> sur un objet <code>Thread</code> qui n'est pas le thread actif. Pusique la méthode <code>interrupted()</code> est statique, la méthode <code>interrupted()</code> sera appelée sur un objet différent de celui auquel l'auteur du code pensait.</p>
|
| +
|
| +
|
| +<h3><a name="SE_METHOD_MUST_BE_PRIVATE">Se: Méthode devant être privée pour que la sérialisation fonctionne (SE_METHOD_MUST_BE_PRIVATE)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe implémente l'interface <code>Serializable</code> et défini une méthode pour personnaliser la sérialisation/désérialisation. Mais cette méthode n'étant pas déclarée privée elle sera ignorée silencieusement par les API de sérialisation/désérialisation.</p>
|
| +
|
| +
|
| +<h3><a name="SE_READ_RESOLVE_IS_STATIC">Se: The readResolve method must not be declared as a static method. (SE_READ_RESOLVE_IS_STATIC)</a></h3>
|
| +
|
| +
|
| + <p> In order for the readResolve method to be recognized by the serialization
|
| +mechanism, it must not be declared as a static method.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="TQ_ALWAYS_VALUE_USED_WHERE_NEVER_REQUIRED">TQ: Value annotated as carrying a type qualifier used where a value that must not carry that qualifier is required (TQ_ALWAYS_VALUE_USED_WHERE_NEVER_REQUIRED)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + A value specified as carrying a type qualifier annotation is
|
| + consumed in a location or locations requiring that the value not
|
| + carry that annotation.
|
| + </p>
|
| +
|
| + <p>
|
| + More precisely, a value annotated with a type qualifier specifying when=ALWAYS
|
| + is guaranteed to reach a use or uses where the same type qualifier specifies when=NEVER.
|
| + </p>
|
| +
|
| + <p>
|
| + For example, say that @NonNegative is a nickname for
|
| + the type qualifier annotation @Negative(when=When.NEVER).
|
| + The following code will generate this warning because
|
| + the return statement requires a @NonNegative value,
|
| + but receives one that is marked as @Negative.
|
| + </p>
|
| + <blockquote>
|
| +<pre>
|
| +public @NonNegative Integer example(@Negative Integer value) {
|
| + return value;
|
| +}
|
| +</pre>
|
| + </blockquote>
|
| +
|
| +
|
| +<h3><a name="TQ_COMPARING_VALUES_WITH_INCOMPATIBLE_TYPE_QUALIFIERS">TQ: Comparing values with incompatible type qualifiers (TQ_COMPARING_VALUES_WITH_INCOMPATIBLE_TYPE_QUALIFIERS)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + A value specified as carrying a type qualifier annotation is
|
| + compared with a value that doesn't ever carry that qualifier.
|
| + </p>
|
| +
|
| + <p>
|
| + More precisely, a value annotated with a type qualifier specifying when=ALWAYS
|
| + is compared with a value that where the same type qualifier specifies when=NEVER.
|
| + </p>
|
| +
|
| + <p>
|
| + For example, say that @NonNegative is a nickname for
|
| + the type qualifier annotation @Negative(when=When.NEVER).
|
| + The following code will generate this warning because
|
| + the return statement requires a @NonNegative value,
|
| + but receives one that is marked as @Negative.
|
| + </p>
|
| + <blockquote>
|
| +<pre>
|
| +public boolean example(@Negative Integer value1, @NonNegative Integer value2) {
|
| + return value1.equals(value2);
|
| +}
|
| +</pre>
|
| + </blockquote>
|
| +
|
| +
|
| +<h3><a name="TQ_MAYBE_SOURCE_VALUE_REACHES_ALWAYS_SINK">TQ: Value that might not carry a type qualifier is always used in a way requires that type qualifier (TQ_MAYBE_SOURCE_VALUE_REACHES_ALWAYS_SINK)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + A value that is annotated as possibility not being an instance of
|
| + the values denoted by the type qualifier, and the value is guaranteed to be used
|
| + in a way that requires values denoted by that type qualifier.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="TQ_MAYBE_SOURCE_VALUE_REACHES_NEVER_SINK">TQ: Value that might carry a type qualifier is always used in a way prohibits it from having that type qualifier (TQ_MAYBE_SOURCE_VALUE_REACHES_NEVER_SINK)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + A value that is annotated as possibility being an instance of
|
| + the values denoted by the type qualifier, and the value is guaranteed to be used
|
| + in a way that prohibits values denoted by that type qualifier.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="TQ_NEVER_VALUE_USED_WHERE_ALWAYS_REQUIRED">TQ: Value annotated as never carrying a type qualifier used where value carrying that qualifier is required (TQ_NEVER_VALUE_USED_WHERE_ALWAYS_REQUIRED)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + A value specified as not carrying a type qualifier annotation is guaranteed
|
| + to be consumed in a location or locations requiring that the value does
|
| + carry that annotation.
|
| + </p>
|
| +
|
| + <p>
|
| + More precisely, a value annotated with a type qualifier specifying when=NEVER
|
| + is guaranteed to reach a use or uses where the same type qualifier specifies when=ALWAYS.
|
| + </p>
|
| +
|
| + <p>
|
| + TODO: example
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="TQ_UNKNOWN_VALUE_USED_WHERE_ALWAYS_STRICTLY_REQUIRED">TQ: Value without a type qualifier used where a value is required to have that qualifier (TQ_UNKNOWN_VALUE_USED_WHERE_ALWAYS_STRICTLY_REQUIRED)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + A value is being used in a way that requires the value be annotation with a type qualifier.
|
| + The type qualifier is strict, so the tool rejects any values that do not have
|
| + the appropriate annotation.
|
| + </p>
|
| +
|
| + <p>
|
| + To coerce a value to have a strict annotation, define an identity function where the return value is annotated
|
| + with the strict annotation.
|
| + This is the only way to turn a non-annotated value into a value with a strict type qualifier annotation.
|
| + </p>
|
| +
|
| +
|
| +
|
| +<h3><a name="UMAC_UNCALLABLE_METHOD_OF_ANONYMOUS_CLASS">UMAC: Méthode non appelable définie dans une classe anonyme (UMAC_UNCALLABLE_METHOD_OF_ANONYMOUS_CLASS)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe anonyme définie une méthode qui n'est pas directement appelée et qui ne surcharge pas une méthode de la classe mère. Puisque les méthodes des autres classes ne peuvent pas directement invoquer les méthodes des classes anonymes, il apparaît que cette méthode est inaccessible. Cette méthode est probablement du code mort, mais il est aussi possible qu'elle essaye de surcharger une méthode déclarée dans la classe mère et échoue à le faire en raison d'une erreur de type ou autre.</p>
|
| +
|
| +
|
| +<h3><a name="UR_UNINIT_READ">UR: Lecture d'un champ non initialisé dans un constructeur (UR_UNINIT_READ)</a></h3>
|
| +
|
| +
|
| +<p>Ce constructeur lit un champ qui n'a pas encore été initialisé. Une des causes les plus fréquentes est l'utilisation accidentelle par le développeur du champ au lieu d'un des paramètres du constructeur.</p>
|
| +
|
| +
|
| +<h3><a name="UR_UNINIT_READ_CALLED_FROM_SUPER_CONSTRUCTOR">UR: Uninitialized read of field method called from constructor of superclass (UR_UNINIT_READ_CALLED_FROM_SUPER_CONSTRUCTOR)</a></h3>
|
| +
|
| +
|
| + <p> This method is invoked in the constructor of of the superclass. At this point,
|
| + the fields of the class have not yet initialized.</p>
|
| +<p>To make this more concrete, consider the following classes:</p>
|
| +<pre>abstract class A {
|
| + int hashCode;
|
| + abstract Object getValue();
|
| + A() {
|
| + hashCode = getValue().hashCode();
|
| + }
|
| + }
|
| +class B extends A {
|
| + Object value;
|
| + B(Object v) {
|
| + this.value = v;
|
| + }
|
| + Object getValue() {
|
| + return value;
|
| + }
|
| + }</pre>
|
| +<p>When a <code>B</code> is constructed,
|
| +the constructor for the <code>A</code> class is invoked
|
| +<em>before</em> the constructor for <code>B</code> sets <code>value</code>.
|
| +Thus, when the constructor for <code>A</code> invokes <code>getValue</code>,
|
| +an uninitialized value is read for <code>value</code>
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="DMI_INVOKING_TOSTRING_ON_ANONYMOUS_ARRAY">USELESS_STRING: Invocation of toString on an unnamed array (DMI_INVOKING_TOSTRING_ON_ANONYMOUS_ARRAY)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +The code invokes toString on an (anonymous) array. Calling toString on an array generates a fairly useless result
|
| +such as [C@16f0472. Consider using Arrays.toString to convert the array into a readable
|
| +String that gives the contents of the array. See Programming Puzzlers, chapter 3, puzzle 12.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="DMI_INVOKING_TOSTRING_ON_ARRAY">USELESS_STRING: Invocation de toString sur un tableau (DMI_INVOKING_TOSTRING_ON_ARRAY)</a></h3>
|
| +
|
| +
|
| +<p>Le code invoque <code>toString</code> sur un tableau, ce qui va générer un résultat assez inutile du genre <code>[C@16f0472</code>. Envisagez d'utiliser <code>String.valueOf</code> pour convertir un tableau en une chaine lisible contenant les valeurs du tableau. Cf Programming Puzzlers, chapitre 3, problème 12.</p>
|
| +
|
| +
|
| +<h3><a name="VA_FORMAT_STRING_BAD_CONVERSION_FROM_ARRAY">USELESS_STRING: Array formatted in useless way using format string (VA_FORMAT_STRING_BAD_CONVERSION_FROM_ARRAY)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +One of the arguments being formatted with a format string is an array. This will be formatted
|
| +using a fairly useless format, such as [I@304282, which doesn't actually show the contents
|
| +of the array.
|
| +Consider wrapping the array using <code>Arrays.asList(...)</code> before handling it off to a formatted.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="UWF_NULL_FIELD">UwF: Champ uniquement mis à null (UWF_NULL_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Ce champ est uniquement alimenté par la constante <code>null</code> et donc toutes les lectures de ce champ renverront <code>null</code>. Vérifiez si c'est une erreur ou alors supprimez ce champ qui est inutile.</p>
|
| +
|
| +
|
| +<h3><a name="UWF_UNWRITTEN_FIELD">UwF: Champ jamais écrit (UWF_UNWRITTEN_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Ce champ n'est jamais alimenté. Toutes les lectures vont renvoyer sa valeur par défaut. Recherchez les erreurs (devrait-il avoir été initialisé ?) ou supprimez le s'il est inutile.</p>
|
| +
|
| +
|
| +<h3><a name="VA_PRIMITIVE_ARRAY_PASSED_TO_OBJECT_VARARG">VA: Tableau de primitives passé à une fonction attendant un nombre variable d'objets en argument (VA_PRIMITIVE_ARRAY_PASSED_TO_OBJECT_VARARG)</a></h3>
|
| +
|
| +
|
| +<p>Ce code envoie un tableau de primitives à une fonction qui attend un nombre variable d'objets en arguments. Ceci créé un tableau de longueur 1 pour contenir le tableau de primitives puis le passe à la fonction.</p>
|
| +
|
| +
|
| +<h3><a name="LG_LOST_LOGGER_DUE_TO_WEAK_REFERENCE">LG: Potential lost logger changes due to weak reference in OpenJDK (LG_LOST_LOGGER_DUE_TO_WEAK_REFERENCE)</a></h3>
|
| +
|
| +
|
| +<p>OpenJDK introduces a potential incompatibility.
|
| + In particular, the java.util.logging.Logger behavior has
|
| + changed. Instead of using strong references, it now uses weak references
|
| + internally. That's a reasonable change, but unfortunately some code relies on
|
| + the old behavior - when changing logger configuration, it simply drops the
|
| + logger reference. That means that the garbage collector is free to reclaim
|
| + that memory, which means that the logger configuration is lost. For example,
|
| +consider:
|
| +</p>
|
| +
|
| +<pre>public static void initLogging() throws Exception {
|
| + Logger logger = Logger.getLogger("edu.umd.cs");
|
| + logger.addHandler(new FileHandler()); // call to change logger configuration
|
| + logger.setUseParentHandlers(false); // another call to change logger configuration
|
| +}</pre>
|
| +
|
| +<p>The logger reference is lost at the end of the method (it doesn't
|
| +escape the method), so if you have a garbage collection cycle just
|
| +after the call to initLogging, the logger configuration is lost
|
| +(because Logger only keeps weak references).</p>
|
| +
|
| +<pre>public static void main(String[] args) throws Exception {
|
| + initLogging(); // adds a file handler to the logger
|
| + System.gc(); // logger configuration lost
|
| + Logger.getLogger("edu.umd.cs").info("Some message"); // this isn't logged to the file as expected
|
| +}</pre>
|
| +<p><em>Ulf Ochsenfahrt and Eric Fellheimer</em></p>
|
| +
|
| +
|
| +<h3><a name="OBL_UNSATISFIED_OBLIGATION">OBL: Method may fail to clean up stream or resource (OBL_UNSATISFIED_OBLIGATION)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + This method may fail to clean up (close, dispose of) a stream,
|
| + database object, or other
|
| + resource requiring an explicit cleanup operation.
|
| + </p>
|
| +
|
| + <p>
|
| + In general, if a method opens a stream or other resource,
|
| + the method should use a try/finally block to ensure that
|
| + the stream or resource is cleaned up before the method
|
| + returns.
|
| + </p>
|
| +
|
| + <p>
|
| + This bug pattern is essentially the same as the
|
| + OS_OPEN_STREAM and ODR_OPEN_DATABASE_RESOURCE
|
| + bug patterns, but is based on a different
|
| + (and hopefully better) static analysis technique.
|
| + We are interested is getting feedback about the
|
| + usefulness of this bug pattern.
|
| + To send feedback, either:
|
| + </p>
|
| + <ul>
|
| + <li>send email to findbugs@cs.umd.edu</li>
|
| + <li>file a bug report: <a href="http://findbugs.sourceforge.net/reportingBugs.html">http://findbugs.sourceforge.net/reportingBugs.html</a></li>
|
| + </ul>
|
| +
|
| + <p>
|
| + In particular,
|
| + the false-positive suppression heuristics for this
|
| + bug pattern have not been extensively tuned, so
|
| + reports about false positives are helpful to us.
|
| + </p>
|
| +
|
| + <p>
|
| + See Weimer and Necula, <i>Finding and Preventing Run-Time Error Handling Mistakes</i>, for
|
| + a description of the analysis technique.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="OBL_UNSATISFIED_OBLIGATION_EXCEPTION_EDGE">OBL: Method may fail to clean up stream or resource on checked exception (OBL_UNSATISFIED_OBLIGATION_EXCEPTION_EDGE)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + This method may fail to clean up (close, dispose of) a stream,
|
| + database object, or other
|
| + resource requiring an explicit cleanup operation.
|
| + </p>
|
| +
|
| + <p>
|
| + In general, if a method opens a stream or other resource,
|
| + the method should use a try/finally block to ensure that
|
| + the stream or resource is cleaned up before the method
|
| + returns.
|
| + </p>
|
| +
|
| + <p>
|
| + This bug pattern is essentially the same as the
|
| + OS_OPEN_STREAM and ODR_OPEN_DATABASE_RESOURCE
|
| + bug patterns, but is based on a different
|
| + (and hopefully better) static analysis technique.
|
| + We are interested is getting feedback about the
|
| + usefulness of this bug pattern.
|
| + To send feedback, either:
|
| + </p>
|
| + <ul>
|
| + <li>send email to findbugs@cs.umd.edu</li>
|
| + <li>file a bug report: <a href="http://findbugs.sourceforge.net/reportingBugs.html">http://findbugs.sourceforge.net/reportingBugs.html</a></li>
|
| + </ul>
|
| +
|
| + <p>
|
| + In particular,
|
| + the false-positive suppression heuristics for this
|
| + bug pattern have not been extensively tuned, so
|
| + reports about false positives are helpful to us.
|
| + </p>
|
| +
|
| + <p>
|
| + See Weimer and Necula, <i>Finding and Preventing Run-Time Error Handling Mistakes</i>, for
|
| + a description of the analysis technique.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="DM_CONVERT_CASE">Dm: La méthode appelle les String.toUpperCase() ou String.toLowerCase ; utilisez plutôt la version paramètrée par une Locale (DM_CONVERT_CASE)</a></h3>
|
| +
|
| +
|
| +<p>Une chaîne est mise en majuscules ou minuscules en fonction de jeu de caractères par défaut de la machine. Ceci peut entraîner des conversions erronées sur les caractères internationaux. Utilisez <code>String.toUpperCase(Locale l)</code> ou <code>String.toLowerCase(Locale l)</code> à la place.</p>
|
| +
|
| +
|
| +<h3><a name="DM_DEFAULT_ENCODING">Dm: Reliance on default encoding (DM_DEFAULT_ENCODING)</a></h3>
|
| +
|
| +
|
| +<p> Found a call to a method which will perform a byte to String (or String to byte) conversion, and will assume that the default platform encoding is suitable. This will cause the application behaviour to vary between platforms. Use an alternative API and specify a charset name or Charset object explicitly. </p>
|
| +
|
| +
|
| +<h3><a name="DP_CREATE_CLASSLOADER_INSIDE_DO_PRIVILEGED">DP: Les chargeurs de classes ne doivent être créés qu'à partir de block doPrivileged (DP_CREATE_CLASSLOADER_INSIDE_DO_PRIVILEGED)</a></h3>
|
| +
|
| +
|
| +<p>Ce code créé un chargeur de classes, ce qui nécessite un test de sécurité. Même si ce code possède des droits suffisants, la création du chargeur de classes devrait être effectuée dans un block <code>doPrivileged</code> au cas ou il serait appelé par du code ne possédant pas les droits requis.</p>
|
| +
|
| +
|
| +<h3><a name="DP_DO_INSIDE_DO_PRIVILEGED">DP: Méthode invoquée alors qu'elle ne devrait l'être qu'à partir d'un block doPrivileged (DP_DO_INSIDE_DO_PRIVILEGED)</a></h3>
|
| +
|
| +
|
| +<p>Ce code invoque une méthode qui nécessite un test de sécurité sur les permissions. Si ce code, bien qu'ayant les droits suffisants, peut être invoqué par du code n'ayant pas les droits requis l'appel doit alors être effectué à l'intérieur d'un block <code>doPrivileged</code>.</p>
|
| +
|
| +
|
| +<h3><a name="EI_EXPOSE_REP">EI: Une méthode peut exposer sa représentation interne en renvoyant une référence à un objet modifiable (EI_EXPOSE_REP)</a></h3>
|
| +
|
| +
|
| +<p>Renvoyer une référence à un objet modifiable stocké dans les champs d'un objet expose la représentation interne de l'objet. Si des instances sont accédées par du code non fiable, et que des modifications non vérifiées peuvent compromettre la sécurité ou d'autres propriétés importantes, vous devez faire autre chose. Renvoyer une nouvelle copie de l'objet est une meilleur approche dans de nombreuses situations.</p>
|
| +
|
| +
|
| +<h3><a name="EI_EXPOSE_REP2">EI2: Une méthode expose sa représentation interne en incorporant une référence à un objet modifiable (EI_EXPOSE_REP2)</a></h3>
|
| +
|
| +
|
| +<p>Ce code stocke une référence à un objet externe modifiable dans la représentation interne de l'objet. Si des instances sont accédées par du code non fiable, et que des modifications non vérifiées peuvent compromettre la sécurité ou d'autres propriétés importantes, vous devez faire autre chose. Stocker une copie de l'objet est une meilleur approche dans de nombreuses situations.</p>
|
| +
|
| +
|
| +<h3><a name="FI_PUBLIC_SHOULD_BE_PROTECTED">FI: Un finaliseur devrait être protégé, pas public (FI_PUBLIC_SHOULD_BE_PROTECTED)</a></h3>
|
| +
|
| +
|
| +<p>La méthode <code>finalize()</code> d'une classe devrait avoir un accès protégé, pas public.</p>
|
| +
|
| +
|
| +<h3><a name="EI_EXPOSE_STATIC_REP2">MS: Une méthode peut exposer un état interne statique en stockant un objet modifiable dans un champs statique (EI_EXPOSE_STATIC_REP2)</a></h3>
|
| +
|
| +
|
| +<p>Ce code stocke une référence à un objet modifiable externe dans un champs statique. Si des modifications non vérifiées de l'objet modifiable peuvent compromettre la sécurité ou d'autres propriétés importantes, vous devez faire autre chose. Stocker une copie de l'objet est souvent une meilleur approche.</p>
|
| +
|
| +
|
| +<h3><a name="MS_CANNOT_BE_FINAL">MS: Un champ n'est pas final et ne peut pas être protégé face à du code malveillant (MS_CANNOT_BE_FINAL)</a></h3>
|
| +
|
| +
|
| +<p>Un champ statique modifiable peut-être modifié par accident ou par du code malveillant. Malheureusement, la façon dont ce champ est utilisé ne permet une correction aisée de ce problème.</p>
|
| +
|
| +
|
| +<h3><a name="MS_EXPOSE_REP">MS: Une méthode statique publique risque d'exposer une représentation interne en renvoyant un tableau (MS_EXPOSE_REP)</a></h3>
|
| +
|
| +
|
| +<p>Une méthode statique publique renvoit une référence à un tableau faisant partie de l'état statique de la classe. Tout code appelant cette méthode peut librement modifier le tableau sous-jacent. Une correction possible serait de renvoyer une copie du tableau.</p>
|
| +
|
| +
|
| +<h3><a name="MS_FINAL_PKGPROTECT">MS: Le champ devrait être à la fois final et package protected (MS_FINAL_PKGPROTECT)</a></h3>
|
| +
|
| +
|
| +<p>Un champ statique modifiable peut-être changé par accident ou par du code malveillant d'un autre paquetage. Le champ devrait être package protected et/ou final pour éviter cette vulnérabilité.</p>
|
| +
|
| +
|
| +<h3><a name="MS_MUTABLE_ARRAY">MS: Un champ est un tableau modifiable (MS_MUTABLE_ARRAY)</a></h3>
|
| +
|
| +
|
| +<p>Le champ est une référence final static à un tableau et peut-être modifié par accident ou par du code malveillant d'un autre paquetage. Ce code peut librement modifier le contenu du tableau.</p>
|
| +
|
| +
|
| +<h3><a name="MS_MUTABLE_HASHTABLE">MS: Un champ modifiable est une Hashtable (MS_MUTABLE_HASHTABLE)</a></h3>
|
| +
|
| +
|
| +<p>Le champ est une référence final static à une <code>Hashtable</code> et peut-être modifié par accident ou par du code malveillant d'un autre paquetage. Ce code peut librement modifier le contenu de la <code>Hashtable</code>.</p>
|
| +
|
| +
|
| +<h3><a name="MS_OOI_PKGPROTECT">MS: Le champ devrait être sorti de l'interface et mis en package protected (MS_OOI_PKGPROTECT)</a></h3>
|
| +
|
| +
|
| +<p>Un champ final static défini dans une interface référence un objet modifiable tel qu'un tableau ou une table de hachage. Cet objet pourrait être modifié par accident ou par du code sournois d'un autre paquetage. Pour résoudre cela et éviter cette vulnérabilité, le champ doit être intégré dans une classe et sa visibilité modifiée en package protected.</p>
|
| +
|
| +
|
| +<h3><a name="MS_PKGPROTECT">MS: Un champ devrait être package protected (MS_PKGPROTECT)</a></h3>
|
| +
|
| +
|
| +<p>Un champ statique modifiable peut-être changé par accident ou par du code malveillant d'un autre paquetage. Le champ devrait être package protected pour éviter cette vulnérabilité.</p>
|
| +
|
| +
|
| +<h3><a name="MS_SHOULD_BE_FINAL">MS: Un champ n'est pas final alors qu'il devrait l'être (MS_SHOULD_BE_FINAL)</a></h3>
|
| +
|
| +
|
| +<p>Un champ statique modifiable peut-être changé par accident ou par du code malveillant d'un autre paquetage. Le champ devrait être final pour éviter cette vulnérabilité.</p>
|
| +
|
| +
|
| +<h3><a name="MS_SHOULD_BE_REFACTORED_TO_BE_FINAL">MS: Field isn't final but should be refactored to be so (MS_SHOULD_BE_REFACTORED_TO_BE_FINAL)</a></h3>
|
| +
|
| +
|
| + <p>
|
| +This static field public but not final, and
|
| +could be changed by malicious code or
|
| +by accident from another package.
|
| +The field could be made final to avoid
|
| +this vulnerability. However, the static initializer contains more than one write
|
| +to the field, so doing so will require some refactoring.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="AT_OPERATION_SEQUENCE_ON_CONCURRENT_ABSTRACTION">AT: Sequence of calls to concurrent abstraction may not be atomic (AT_OPERATION_SEQUENCE_ON_CONCURRENT_ABSTRACTION)</a></h3>
|
| +
|
| +
|
| + <p>This code contains a sequence of calls to a concurrent abstraction
|
| + (such as a concurrent hash map).
|
| + These calls will not be executed atomically.
|
| +
|
| +
|
| +<h3><a name="DC_DOUBLECHECK">DC: Possible double vérification d'un champ (DC_DOUBLECHECK)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient peut-être une instance de verrou par double vérification. Cet idiome n'est pas correct vis-à-vis de la sémantique du modèle de mémoire Java. Pour plus d'informations, cf. la page <a href="http://www.cs.umd.edu/~pugh/java/memoryModel/DoubleCheckedLocking.html">http://www.cs.umd.edu/~pugh/java/memoryModel/DoubleCheckedLocking.html</a>.</p>
|
| +
|
| +
|
| +<h3><a name="DL_SYNCHRONIZATION_ON_BOOLEAN">DL: Synchronization on Boolean (DL_SYNCHRONIZATION_ON_BOOLEAN)</a></h3>
|
| +
|
| +
|
| + <p> The code synchronizes on a boxed primitive constant, such as an Boolean.</p>
|
| +<pre>
|
| +private static Boolean inited = Boolean.FALSE;
|
| +...
|
| + synchronized(inited) {
|
| + if (!inited) {
|
| + init();
|
| + inited = Boolean.TRUE;
|
| + }
|
| + }
|
| +...
|
| +</pre>
|
| +<p>Since there normally exist only two Boolean objects, this code could be synchronizing on the same object as other, unrelated code, leading to unresponsiveness
|
| +and possible deadlock</p>
|
| +<p>See CERT <a href="https://www.securecoding.cert.org/confluence/display/java/CON08-J.+Do+not+synchronize+on+objects+that+may+be+reused">CON08-J. Do not synchronize on objects that may be reused</a> for more information.</p>
|
| +
|
| +
|
| +<h3><a name="DL_SYNCHRONIZATION_ON_BOXED_PRIMITIVE">DL: Synchronization on boxed primitive (DL_SYNCHRONIZATION_ON_BOXED_PRIMITIVE)</a></h3>
|
| +
|
| +
|
| + <p> The code synchronizes on a boxed primitive constant, such as an Integer.</p>
|
| +<pre>
|
| +private static Integer count = 0;
|
| +...
|
| + synchronized(count) {
|
| + count++;
|
| + }
|
| +...
|
| +</pre>
|
| +<p>Since Integer objects can be cached and shared,
|
| +this code could be synchronizing on the same object as other, unrelated code, leading to unresponsiveness
|
| +and possible deadlock</p>
|
| +<p>See CERT <a href="https://www.securecoding.cert.org/confluence/display/java/CON08-J.+Do+not+synchronize+on+objects+that+may+be+reused">CON08-J. Do not synchronize on objects that may be reused</a> for more information.</p>
|
| +
|
| +
|
| +<h3><a name="DL_SYNCHRONIZATION_ON_SHARED_CONSTANT">DL: Synchronization on interned String (DL_SYNCHRONIZATION_ON_SHARED_CONSTANT)</a></h3>
|
| +
|
| +
|
| + <p> The code synchronizes on interned String.</p>
|
| +<pre>
|
| +private static String LOCK = "LOCK";
|
| +...
|
| + synchronized(LOCK) { ...}
|
| +...
|
| +</pre>
|
| +<p>Constant Strings are interned and shared across all other classes loaded by the JVM. Thus, this could
|
| +is locking on something that other code might also be locking. This could result in very strange and hard to diagnose
|
| +blocking and deadlock behavior. See <a href="http://www.javalobby.org/java/forums/t96352.html">http://www.javalobby.org/java/forums/t96352.html</a> and <a href="http://jira.codehaus.org/browse/JETTY-352">http://jira.codehaus.org/browse/JETTY-352</a>.
|
| +</p>
|
| +<p>See CERT <a href="https://www.securecoding.cert.org/confluence/display/java/CON08-J.+Do+not+synchronize+on+objects+that+may+be+reused">CON08-J. Do not synchronize on objects that may be reused</a> for more information.</p>
|
| +
|
| +
|
| +<h3><a name="DL_SYNCHRONIZATION_ON_UNSHARED_BOXED_PRIMITIVE">DL: Synchronization on boxed primitive values (DL_SYNCHRONIZATION_ON_UNSHARED_BOXED_PRIMITIVE)</a></h3>
|
| +
|
| +
|
| + <p> The code synchronizes on an apparently unshared boxed primitive,
|
| +such as an Integer.</p>
|
| +<pre>
|
| +private static final Integer fileLock = new Integer(1);
|
| +...
|
| + synchronized(fileLock) {
|
| + .. do something ..
|
| + }
|
| +...
|
| +</pre>
|
| +<p>It would be much better, in this code, to redeclare fileLock as</p>
|
| +<pre>
|
| +private static final Object fileLock = new Object();
|
| +</pre>
|
| +<p>
|
| +The existing code might be OK, but it is confusing and a
|
| +future refactoring, such as the "Remove Boxing" refactoring in IntelliJ,
|
| +might replace this with the use of an interned Integer object shared
|
| +throughout the JVM, leading to very confusing behavior and potential deadlock.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="DM_MONITOR_WAIT_ON_CONDITION">Dm: Wait() appelé sur une Condition (DM_MONITOR_WAIT_ON_CONDITION)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode appelle <code>wait()</code> sur un objet <code>java.util.concurrent.locks.Condition</code>. L'attente d'une <code>Condition</code> devrait être faite en utilisant l'une des méthodes <code>await()</code> définies dans l'interface <code>Condition</code>.</p>
|
| +
|
| +
|
| +<h3><a name="DM_USELESS_THREAD">Dm: Thread créé avec la méthode run vide par défaut (DM_USELESS_THREAD)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode crée un thread sans spécifier de méthode <code>run</code>, soit par dérivation de la classe <code>Thread</code>, soit en transmettant un objet <code>Runnable</code>. Ce thread ne fait donc rien sauf perdre du temps.</p>
|
| +
|
| +
|
| +<h3><a name="ESync_EMPTY_SYNC">ESync: Bloc synchronisé vide (ESync_EMPTY_SYNC)</a></h3>
|
| +
|
| +
|
| +<p>Présence d'un bloc synchronisé vide:</p>
|
| +<pre>
|
| +synchronized() {}
|
| +</pre>
|
| +<p>L'utilisation de blocs synchronisés vides est bien plus subtile et dure à réaliser correctement que bien des gens ne le reconnaissent, et de plus ne correspond que rarement à la meilleure des solutions.</p>
|
| +
|
| +
|
| +<h3><a name="IS2_INCONSISTENT_SYNC">IS: Synchronisation incohérente (IS2_INCONSISTENT_SYNC)</a></h3>
|
| +
|
| +
|
| +<p>Les champs de cette classe semblent être accédés de façon incohérente vis-à-vis de la synchronisation. Le détecteur de bogue juge que :</p>
|
| +<ol>
|
| + <li>la classe contient un mélange d'accès verrouillés et non verrouillés,</li>
|
| + <li>au moins un des accès verrouillés est effectué par une des propres méthodes de la classe,</li>
|
| + <li>le nombre d'accès (lectures et écritures) non synchronisés ne représente pas plus d'un tiers de tous les accès, avec plus de deux fois plus d'écritures que de lectures.</li>
|
| +</ol>
|
| +<p>Un bogue typique déclenchant ce détecteur est l'oubli de la synchronisation sur l'une des méthodes d'une classe qui essaye d'être sûre vis-à-vis des threads.</p>
|
| +<p>Vous pouvez sélectionner les noeuds nommés "Accès non synchronisés" pour avoir la position exacte dans le code où le détecteur pense qu'un champ est accédé sans synchronisation.</p>
|
| +<p>Notez qu'il y a diverses sources d'inexactitude dans ce détecteur ; par exemple, le détecteur ne peut pas repérer statiquement toutes les situations dans lesquelles un verrou est obtenu. En fait, même lorsque le détecteur repère effectivement des accès avec et sans verrou, le code concerné peut quand même être correct.</p>
|
| +<p>Cette description se réfère à la version "IS2" du détecteur, qui est plus précise pour détecter les accès avec et sans verrous que l'ancien détecteur "IS".</p>
|
| +
|
| +
|
| +<h3><a name="IS_FIELD_NOT_GUARDED">IS: Champ non protégé contre les accès concurrents (IS_FIELD_NOT_GUARDED)</a></h3>
|
| +
|
| +
|
| +<p>Ce champ est annoté avec <code>net.jcip.annotations.GuardedBy</code>, mais peut être utilisé d'une façon qui contredit l'annotation.</p>
|
| +
|
| +
|
| +<h3><a name="JLM_JSR166_LOCK_MONITORENTER">JLM: Synchronisation effectuée sur un Lock java.util.concurrent (JLM_JSR166_LOCK_MONITORENTER)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode se synchronise au moyen d'une implémentation de <code>java.util.concurrent.locks.Lock</code>. Vous devriez plutôt utiliser les méthodes <code>lock()</code> et <code>unlock()</code>.</p>
|
| +
|
| +
|
| +<h3><a name="JLM_JSR166_UTILCONCURRENT_MONITORENTER">JLM: Synchronization performed on util.concurrent instance (JLM_JSR166_UTILCONCURRENT_MONITORENTER)</a></h3>
|
| +
|
| +
|
| +<p> This method performs synchronization an object that is an instance of
|
| +a class from the java.util.concurrent package (or its subclasses). Instances
|
| +of these classes have their own concurrency control mechanisms that are orthogonal to
|
| +the synchronization provided by the Java keyword <code>synchronized</code>. For example,
|
| +synchronizing on an <code>AtomicBoolean</code> will not prevent other threads
|
| +from modifying the <code>AtomicBoolean</code>.</p>
|
| +<p>Such code may be correct, but should be carefully reviewed and documented,
|
| +and may confuse people who have to maintain the code at a later date.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="JML_JSR166_CALLING_WAIT_RATHER_THAN_AWAIT">JLM: Using monitor style wait methods on util.concurrent abstraction (JML_JSR166_CALLING_WAIT_RATHER_THAN_AWAIT)</a></h3>
|
| +
|
| +
|
| +<p> This method calls
|
| +<code>wait()</code>,
|
| +<code>notify()</code> or
|
| +<code>notifyAll()()</code>
|
| +on an object that also provides an
|
| +<code>await()</code>,
|
| +<code>signal()</code>,
|
| +<code>signalAll()</code> method (such as util.concurrent Condition objects).
|
| +This probably isn't what you want, and even if you do want it, you should consider changing
|
| +your design, as other developers will find it exceptionally confusing.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="LI_LAZY_INIT_STATIC">LI: Initialisation paresseuse incorrecte d'un champ statique (LI_LAZY_INIT_STATIC)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient une initialisation paresseuse non synchronisée d'un champ statique non <code>volatile</code>. Comme le compilateur ou le processeur peuvent réordonner les instructions, les threads ne sont pas certains de voir un objet complètement initialisé, <em>si la méthode peut-être appelée par de multiples threads</em>. Vous pouvez rendre le champs <code>volatile</code> pour corriger le problème. Pour plus d'informations, cf. <a href="http://www.cs.umd.edu/~pugh/java/memoryModel/">site Web sur le modèle mémoire de Java</a>.</p>
|
| +
|
| +
|
| +<h3><a name="LI_LAZY_INIT_UPDATE_STATIC">LI: Incorrect lazy initialization and update of static field (LI_LAZY_INIT_UPDATE_STATIC)</a></h3>
|
| +
|
| +
|
| +<p> This method contains an unsynchronized lazy initialization of a static field.
|
| +After the field is set, the object stored into that location is further updated or accessed.
|
| +The setting of the field is visible to other threads as soon as it is set. If the
|
| +futher accesses in the method that set the field serve to initialize the object, then
|
| +you have a <em>very serious</em> multithreading bug, unless something else prevents
|
| +any other thread from accessing the stored object until it is fully initialized.
|
| +</p>
|
| +<p>Even if you feel confident that the method is never called by multiple
|
| +threads, it might be better to not set the static field until the value
|
| +you are setting it to is fully populated/initialized.
|
| +
|
| +
|
| +<h3><a name="ML_SYNC_ON_FIELD_TO_GUARD_CHANGING_THAT_FIELD">ML: Synchronization on field in futile attempt to guard that field (ML_SYNC_ON_FIELD_TO_GUARD_CHANGING_THAT_FIELD)</a></h3>
|
| +
|
| +
|
| + <p> This method synchronizes on a field in what appears to be an attempt
|
| +to guard against simultaneous updates to that field. But guarding a field
|
| +gets a lock on the referenced object, not on the field. This may not
|
| +provide the mutual exclusion you need, and other threads might
|
| +be obtaining locks on the referenced objects (for other purposes). An example
|
| +of this pattern would be:</p>
|
| +<pre>
|
| +private Long myNtfSeqNbrCounter = new Long(0);
|
| +private Long getNotificationSequenceNumber() {
|
| + Long result = null;
|
| + synchronized(myNtfSeqNbrCounter) {
|
| + result = new Long(myNtfSeqNbrCounter.longValue() + 1);
|
| + myNtfSeqNbrCounter = new Long(result.longValue());
|
| + }
|
| + return result;
|
| + }
|
| +</pre>
|
| +
|
| +
|
| +<h3><a name="ML_SYNC_ON_UPDATED_FIELD">ML: La méthode se synchronise sur un champ mis à jour (ML_SYNC_ON_UPDATED_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode se synchronise sur le champ modifiable d'une référence objet. Il y a peu de chances que cela ait un sens puisque les différents threads se synchroniserons par rapport à différents objets.</p>
|
| +
|
| +
|
| +<h3><a name="MSF_MUTABLE_SERVLET_FIELD">MSF: Mutable servlet field (MSF_MUTABLE_SERVLET_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>A web server generally only creates one instance of servlet or jsp class (i.e., treats
|
| +the class as a Singleton),
|
| +and will
|
| +have multiple threads invoke methods on that instance to service multiple
|
| +simultaneous requests.
|
| +Thus, having a mutable instance field generally creates race conditions.
|
| +
|
| +
|
| +<h3><a name="MWN_MISMATCHED_NOTIFY">MWN: notify() non appareillé (MWN_MISMATCHED_NOTIFY)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode appelle <code>Object.notify()</code> ou <code>Object.notifyAll()</code> sans détenir, visiblement, de verrou sur l'objet. Appeler <code>notify()</code> ou <code>notifyAll()</code> sans détenir de verrou entraîne le déclenchement d'une <code>IllegalMonitorStateException</code>.</p>
|
| +
|
| +
|
| +<h3><a name="MWN_MISMATCHED_WAIT">MWN: wait() non appareillé (MWN_MISMATCHED_WAIT)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode appelle <code>Object.wait()</code> sans détenir, visiblement, de verrou sur l'objet. Appeler <code>wait()</code> sans détenir de verrou entraîne le déclenchement d'une <code>IllegalMonitorStateException</code>.</p>
|
| +
|
| +
|
| +<h3><a name="NN_NAKED_NOTIFY">NN: Appel notify() isolé dans une méthode (NN_NAKED_NOTIFY)</a></h3>
|
| +
|
| +
|
| +<p>Un appel à <code>notify()</code> ou <code>notifyAll()</code> est effectué sans aucun changement (apparent) de l'état d'un objet modifiable. En général, appeler une méthode <code>notify()</code> dans un moniteur est effectué parce qu'une condition quelconque attendue par un autre thread est devenue vraie. Dans tous les cas, pour que la condition ait un sens, elle doit porter sur un objet visible des deux threads.</p>
|
| +<p>Ce bogue n'indique pas nécessairement une erreur puisque la modification de l'état de l'objet peut avoir eu lieu dans une méthode qui appelle la méthode contenant la notification.</p>
|
| +
|
| +
|
| +<h3><a name="NP_SYNC_AND_NULL_CHECK_FIELD">NP: Synchronize and null check on the same field. (NP_SYNC_AND_NULL_CHECK_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Since the field is synchronized on, it seems not likely to be null.
|
| +If it is null and then synchronized on a NullPointerException will be
|
| +thrown and the check would be pointless. Better to synchronize on
|
| +another field.</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="NO_NOTIFY_NOT_NOTIFYALL">No: Utilisation de notify() plutôt que notifyAll() dans une méthode (NO_NOTIFY_NOT_NOTIFYALL)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode appelle <code>notify()</code> plutôt que <code>notifyAll()</code>. Le moniteur Java est souvent utilisé pour de multiples conditions. Appeler <code>notify()</code> ne réveille qu'un thread, ce qui signifie que le thread réveillé peut ne pas être celui qui attend la condition que l'appelant vient de remplir.</p>
|
| +
|
| +
|
| +<h3><a name="RS_READOBJECT_SYNC">RS: Seule la méthode readObject() est synchronisée (RS_READOBJECT_SYNC)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe <code>Serializable</code> définit une méthode <code>readObject()</code> qui est synchronisée. Par définition, un objet créé par désérialisation n'est accessible que par un unique thread, donc il n'y a aucun intérêt à synchroniser <code>readObject()</code>. Si la méthode <code>readObject()</code> en elle-même rend l'objet visible d'un autre thread, vous avez un exemple de style de code très douteux.</p>
|
| +
|
| +
|
| +<h3><a name="RV_RETURN_VALUE_OF_PUTIFABSENT_IGNORED">RV: Return value of putIfAbsent ignored, value passed to putIfAbsent reused (RV_RETURN_VALUE_OF_PUTIFABSENT_IGNORED)</a></h3>
|
| +
|
| +
|
| + The <code>putIfAbsent</code> method is typically used to ensure that a
|
| + single value is associated with a given key (the first value for which put
|
| + if absent succeeds).
|
| + If you ignore the return value and retain a reference to the value passed in,
|
| + you run the risk of retaining a value that is not the one that is associated with the key in the map.
|
| + If it matters which one you use and you use the one that isn't stored in the map,
|
| + your program will behave incorrectly.
|
| +
|
| +
|
| +<h3><a name="RU_INVOKE_RUN">Ru: Invocation de run() sur un thread (Vouliez-vous plutôt dire start() ?) (RU_INVOKE_RUN)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode appelle explicitement <code>run()</code> sur un objet. En général, les classes implémentent l'interface <code>Runnable</code> parce qu'elles vont avoir leur méthode <code>run()</code> invoquée dans un nouveau thread, auquel cas <code>Thread.start()</code> est la bonne méthode à appeler.</p>
|
| +
|
| +
|
| +<h3><a name="SC_START_IN_CTOR">SC: Un constructeur invoque Thread.start() (SC_START_IN_CTOR)</a></h3>
|
| +
|
| +
|
| +<p>Le constructeur lance un thread. Il y a de fortes chances que ce soit une erreur si cette classe est un jour dérivée ou étendue puisque que le thread sera alors lancé avant que le constructeur de la classe dérivée ne soit appelé.</p>
|
| +
|
| +
|
| +<h3><a name="SP_SPIN_ON_FIELD">SP: Méthode bouclant sur un champ (SP_SPIN_ON_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode tourne en rond sur une boucle qui lit un champ. Le compilateur est autorisé à sortir la lecture de la boucle, créant ainsi une boucle infinie. La classe devrait être modifiée afin d'être correctement synchronisée (avec des appels à <code>wait()</code> et <code>notify()</code>).</p>
|
| +
|
| +
|
| +<h3><a name="STCAL_INVOKE_ON_STATIC_CALENDAR_INSTANCE">STCAL: Call to static Calendar (STCAL_INVOKE_ON_STATIC_CALENDAR_INSTANCE)</a></h3>
|
| +
|
| +
|
| +<p>Even though the JavaDoc does not contain a hint about it, Calendars are inherently unsafe for multihtreaded use.
|
| +The detector has found a call to an instance of Calendar that has been obtained via a static
|
| +field. This looks suspicous.</p>
|
| +<p>For more information on this see <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6231579">Sun Bug #6231579</a>
|
| +and <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6178997">Sun Bug #6178997</a>.</p>
|
| +
|
| +
|
| +<h3><a name="STCAL_INVOKE_ON_STATIC_DATE_FORMAT_INSTANCE">STCAL: Call to static DateFormat (STCAL_INVOKE_ON_STATIC_DATE_FORMAT_INSTANCE)</a></h3>
|
| +
|
| +
|
| +<p>As the JavaDoc states, DateFormats are inherently unsafe for multithreaded use.
|
| +The detector has found a call to an instance of DateFormat that has been obtained via a static
|
| +field. This looks suspicous.</p>
|
| +<p>For more information on this see <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6231579">Sun Bug #6231579</a>
|
| +and <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6178997">Sun Bug #6178997</a>.</p>
|
| +
|
| +
|
| +<h3><a name="STCAL_STATIC_CALENDAR_INSTANCE">STCAL: Static Calendar field (STCAL_STATIC_CALENDAR_INSTANCE)</a></h3>
|
| +
|
| +
|
| +<p>Even though the JavaDoc does not contain a hint about it, Calendars are inherently unsafe for multihtreaded use.
|
| +Sharing a single instance across thread boundaries without proper synchronization will result in erratic behavior of the
|
| +application. Under 1.4 problems seem to surface less often than under Java 5 where you will probably see
|
| +random ArrayIndexOutOfBoundsExceptions or IndexOutOfBoundsExceptions in sun.util.calendar.BaseCalendar.getCalendarDateFromFixedDate().</p>
|
| +<p>You may also experience serialization problems.</p>
|
| +<p>Using an instance field is recommended.</p>
|
| +<p>For more information on this see <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6231579">Sun Bug #6231579</a>
|
| +and <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6178997">Sun Bug #6178997</a>.</p>
|
| +
|
| +
|
| +<h3><a name="STCAL_STATIC_SIMPLE_DATE_FORMAT_INSTANCE">STCAL: Static DateFormat (STCAL_STATIC_SIMPLE_DATE_FORMAT_INSTANCE)</a></h3>
|
| +
|
| +
|
| +<p>As the JavaDoc states, DateFormats are inherently unsafe for multithreaded use.
|
| +Sharing a single instance across thread boundaries without proper synchronization will result in erratic behavior of the
|
| +application.</p>
|
| +<p>You may also experience serialization problems.</p>
|
| +<p>Using an instance field is recommended.</p>
|
| +<p>For more information on this see <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6231579">Sun Bug #6231579</a>
|
| +and <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6178997">Sun Bug #6178997</a>.</p>
|
| +
|
| +
|
| +<h3><a name="SWL_SLEEP_WITH_LOCK_HELD">SWL: Appel de la méthode Thread.sleep() avec un verrou (SWL_SLEEP_WITH_LOCK_HELD)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode appelle <code>Thread.sleep()</code> en tenant un verrou. Ceci peut résulter en de faibles performances, peu de capacité à monter en charge ou un inter-blocage puisque d'autres processus pourraient être en attente du verrou. C'est une meilleure idée d'appeler <code>wait()</code> sur le verrou, afin de le libérer et de permettre à d'autre processus de tourner.</p>
|
| +
|
| +
|
| +<h3><a name="TLW_TWO_LOCK_WAIT">TLW: wait() avec deux verrous en attente (TLW_TWO_LOCK_WAIT)</a></h3>
|
| +
|
| +
|
| +<p>Attendre sur on moniteur alors que deux verrous sont détenus peut entraîner un blocage fatal (deadlock). Exécuter un <code>wait()</code> ne libère que le verrou sur l'objet accueillant le <code>wait()</code>, mais aucun autre verrou. Ce n'est pas obligatoirement un bogue, mais il vaut mieux examiner ça en détails.</p>
|
| +
|
| +
|
| +<h3><a name="UG_SYNC_SET_UNSYNC_GET">UG: Méthode getXXX non synchronisée, méthode setXXX synchronisée (UG_SYNC_SET_UNSYNC_GET)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe contient des méthodes <code>getXXX</code> et <code>setXXX</code> similaires dont la méthode <code>setXXX</code> est synchronisée tandis que la méthode <code>getXXX</code> ne l'est pas. Ceci peut entraîner un comportement incorrect à l'exécution car l'appelant de la méthode <code>getXXX</code> ne verra pas obligatoirement l'objet dans un état consistant. La méthode <code>getXXX</code> devrait être synchronisée.</p>
|
| +
|
| +
|
| +<h3><a name="UL_UNRELEASED_LOCK">UL: La méthode ne libère pas un verrou dans tous les chemins d'exécution (UL_UNRELEASED_LOCK)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode acquière un verrou JSR-166 (<code>java.util.concurrent</code>), mais ne le libère pas dans tous les chemins d'exécution. En général, l'idiome correct pour utiliser un verrou JSR-166 est :</p>
|
| +<pre>
|
| +Lock l = ...;
|
| +l.lock();
|
| +try {
|
| + // do something
|
| +} finally {
|
| + l.unlock();
|
| +}
|
| +</pre>
|
| +
|
| +
|
| +<h3><a name="UL_UNRELEASED_LOCK_EXCEPTION_PATH">UL: La méthode ne libère pas un verrou dans tous les chemins d'exception (UL_UNRELEASED_LOCK_EXCEPTION_PATH)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode acquière un verrou JSR-166 (<code>java.util.concurrent</code>), mais ne le libère pas dans tous les chemins d'exception. En général, l'idiome correct pour utiliser un verrou JSR-166 est :</p>
|
| +<pre>
|
| +Lock l = ...;
|
| +l.lock();
|
| +try {
|
| + // do something
|
| +} finally {
|
| + l.unlock();
|
| +}
|
| +</pre>
|
| +
|
| +
|
| +<h3><a name="UW_UNCOND_WAIT">UW: Méthode contenant un wait() non conditionné (UW_UNCOND_WAIT)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient un appel à <code>java.lang.Object.wait()</code> qui n'est pas protégé par une condition. Si la condition que la méthode essaye d'attendre a déjà été remplie, le thread risque d'attendre indéfiniment.</p>
|
| +
|
| +
|
| +<h3><a name="VO_VOLATILE_INCREMENT">VO: An increment to a volatile field isn't atomic (VO_VOLATILE_INCREMENT)</a></h3>
|
| +
|
| +
|
| +<p>This code increments a volatile field. Increments of volatile fields aren't
|
| +atomic. If more than one thread is incrementing the field at the same time,
|
| +increments could be lost.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="VO_VOLATILE_REFERENCE_TO_ARRAY">VO: Une référence volatile à un tableau ne traite pas les éléments du tableau comme volatiles (VO_VOLATILE_REFERENCE_TO_ARRAY)</a></h3>
|
| +
|
| +
|
| +<p>Ceci déclare une référence volatile à un tableau, ce qui n'est peut-être pas ce que vous voulez. Avec une référence volatile à un tableau, les lectures et écritures de la référence au tableau sont traitées comme volatiles, mais les éléments ne sont pas volatiles. Pour obtenir des éléments volatiles, vous devez utiliser l'une des classes de tableaux atomiques de <code>java.util.concurrent</code> (inclus dans Java 5.0).</p>
|
| +
|
| +
|
| +<h3><a name="WL_USING_GETCLASS_RATHER_THAN_CLASS_LITERAL">WL: Synchronization on getClass rather than class literal (WL_USING_GETCLASS_RATHER_THAN_CLASS_LITERAL)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + This instance method synchronizes on <code>this.getClass()</code>. If this class is subclassed,
|
| + subclasses will synchronize on the class object for the subclass, which isn't likely what was intended.
|
| + For example, consider this code from java.awt.Label:</p>
|
| + <pre>
|
| + private static final String base = "label";
|
| + private static int nameCounter = 0;
|
| + String constructComponentName() {
|
| + synchronized (getClass()) {
|
| + return base + nameCounter++;
|
| + }
|
| + }
|
| + </pre>
|
| + <p>Subclasses of <code>Label</code> won't synchronize on the same subclass, giving rise to a datarace.
|
| + Instead, this code should be synchronizing on <code>Label.class</code></p>
|
| + <pre>
|
| + private static final String base = "label";
|
| + private static int nameCounter = 0;
|
| + String constructComponentName() {
|
| + synchronized (Label.class) {
|
| + return base + nameCounter++;
|
| + }
|
| + }
|
| + </pre>
|
| + <p>Bug pattern contributed by Jason Mehrens</p>
|
| +
|
| +
|
| +<h3><a name="WS_WRITEOBJECT_SYNC">WS: Seule la méthode writeObject() est synchronisée (WS_WRITEOBJECT_SYNC)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe a une méthode <code>writeObject()</code> qui est synchronisée ; mais aucune autre méthode de cette classe n'est synchronisée.</p>
|
| +
|
| +
|
| +<h3><a name="WA_AWAIT_NOT_IN_LOOP">Wa: Condition.await() en dehors d'une boucle (WA_AWAIT_NOT_IN_LOOP)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient un appel à <code>java.util.concurrent.await()</code> (ou une variante) qui n'est pas dans une boucle. Si cet objet est utilisé pour de multiples conditions, la condition que l'appelant espère réveiller pourra être ou ne pas être celle qui le sera effectivement.</p>
|
| +
|
| +
|
| +<h3><a name="WA_NOT_IN_LOOP">Wa: Méthode contenant un wait() en dehors d'une boucle (WA_NOT_IN_LOOP)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient un appel à <code>java.lang.Object.wait()</code> qui n'est pas dans une boucle. Si le moniteur est utilisé pour des conditions multiples, la condition que l'appelant attend peut ne pas être celle qui s'est réellement déclenchée.</p>
|
| +
|
| +
|
| +<h3><a name="BX_BOXING_IMMEDIATELY_UNBOXED">Bx: Primitive value is boxed and then immediately unboxed (BX_BOXING_IMMEDIATELY_UNBOXED)</a></h3>
|
| +
|
| +
|
| + <p>A primitive is boxed, and then immediately unboxed. This probably is due to a manual
|
| + boxing in a place where an unboxed value is required, thus forcing the compiler
|
| +to immediately undo the work of the boxing.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="BX_BOXING_IMMEDIATELY_UNBOXED_TO_PERFORM_COERCION">Bx: Primitive value is boxed then unboxed to perform primitive coercion (BX_BOXING_IMMEDIATELY_UNBOXED_TO_PERFORM_COERCION)</a></h3>
|
| +
|
| +
|
| + <p>A primitive boxed value constructed and then immediately converted into a different primitive type
|
| +(e.g., <code>new Double(d).intValue()</code>). Just perform direct primitive coercion (e.g., <code>(int) d</code>).</p>
|
| +
|
| +
|
| +<h3><a name="BX_UNBOXING_IMMEDIATELY_REBOXED">Bx: Boxed value is unboxed and then immediately reboxed (BX_UNBOXING_IMMEDIATELY_REBOXED)</a></h3>
|
| +
|
| +
|
| + <p>A boxed value is unboxed and then immediately reboxed.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="DM_BOXED_PRIMITIVE_FOR_PARSING">Bx: Boxing/unboxing to parse a primitive (DM_BOXED_PRIMITIVE_FOR_PARSING)</a></h3>
|
| +
|
| +
|
| + <p>A boxed primitive is created from a String, just to extract the unboxed primitive value.
|
| + It is more efficient to just call the static parseXXX method.</p>
|
| +
|
| +
|
| +<h3><a name="DM_BOXED_PRIMITIVE_TOSTRING">Bx: Méthode allouant une primitive boxed pour appeler toString (DM_BOXED_PRIMITIVE_TOSTRING)</a></h3>
|
| +
|
| +
|
| +<p>Une primitive "boxed" est allouée juste pour appeler <code>toString()</code>. Il est plus efficace de simplement utiliser la forme statique de <code>toString</code> qui accepte la valeur primitive. Donc,</p>
|
| + <table>
|
| + <tr><th>Remplacer...</th><th>Avec...</th></tr>
|
| + <tr><td><code>new Integer(1).toString()</code></td><td><code>Integer.toString(1)</code></td></tr>
|
| + <tr><td><code>new Long(1).toString()</code></td><td><code>Long.toString(1)</code></td></tr>
|
| + <tr><td><code>new Float(1.0).toString()</code></td><td><code>Float.toString(1.0)</code></td></tr>
|
| + <tr><td><code>new Double(1.0).toString()</code></td><td><code>Double.toString(1.0)</code></td></tr>
|
| + <tr><td><code>new Byte(1).toString()</code></td><td><code>Byte.toString(1)</code></td></tr>
|
| + <tr><td><code>new Short(1).toString()</code></td><td><code>Short.toString(1)</code></td></tr>
|
| + <tr><td><code>Boolean.valueOf(true).toString()</code></td><td><code>Boolean.toString(true)</code></td></tr>
|
| + </table>
|
| +
|
| +
|
| +<h3><a name="DM_FP_NUMBER_CTOR">Bx: Method invokes inefficient floating-point Number constructor; use static valueOf instead (DM_FP_NUMBER_CTOR)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + Using <code>new Double(double)</code> is guaranteed to always result in a new object whereas
|
| + <code>Double.valueOf(double)</code> allows caching of values to be done by the compiler, class library, or JVM.
|
| + Using of cached values avoids object allocation and the code will be faster.
|
| + </p>
|
| + <p>
|
| + Unless the class must be compatible with JVMs predating Java 1.5,
|
| + use either autoboxing or the <code>valueOf()</code> method when creating instances of <code>Double</code> and <code>Float</code>.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="DM_NUMBER_CTOR">Bx: Method invokes inefficient Number constructor; use static valueOf instead (DM_NUMBER_CTOR)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + Using <code>new Integer(int)</code> is guaranteed to always result in a new object whereas
|
| + <code>Integer.valueOf(int)</code> allows caching of values to be done by the compiler, class library, or JVM.
|
| + Using of cached values avoids object allocation and the code will be faster.
|
| + </p>
|
| + <p>
|
| + Values between -128 and 127 are guaranteed to have corresponding cached instances
|
| + and using <code>valueOf</code> is approximately 3.5 times faster than using constructor.
|
| + For values outside the constant range the performance of both styles is the same.
|
| + </p>
|
| + <p>
|
| + Unless the class must be compatible with JVMs predating Java 1.5,
|
| + use either autoboxing or the <code>valueOf()</code> method when creating instances of
|
| + <code>Long</code>, <code>Integer</code>, <code>Short</code>, <code>Character</code>, and <code>Byte</code>.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="DMI_BLOCKING_METHODS_ON_URL">Dm: The equals and hashCode methods of URL are blocking (DMI_BLOCKING_METHODS_ON_URL)</a></h3>
|
| +
|
| +
|
| + <p> The equals and hashCode
|
| +method of URL perform domain name resolution, this can result in a big performance hit.
|
| +See <a href="http://michaelscharf.blogspot.com/2006/11/javaneturlequals-and-hashcode-make.html">http://michaelscharf.blogspot.com/2006/11/javaneturlequals-and-hashcode-make.html</a> for more information.
|
| +Consider using <code>java.net.URI</code> instead.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="DMI_COLLECTION_OF_URLS">Dm: Maps and sets of URLs can be performance hogs (DMI_COLLECTION_OF_URLS)</a></h3>
|
| +
|
| +
|
| + <p> This method or field is or uses a Map or Set of URLs. Since both the equals and hashCode
|
| +method of URL perform domain name resolution, this can result in a big performance hit.
|
| +See <a href="http://michaelscharf.blogspot.com/2006/11/javaneturlequals-and-hashcode-make.html">http://michaelscharf.blogspot.com/2006/11/javaneturlequals-and-hashcode-make.html</a> for more information.
|
| +Consider using <code>java.net.URI</code> instead.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="DM_BOOLEAN_CTOR">Dm: La méthode invoque le constructeur inutile Boolean() ; utilisez Boolean.valueOf(...) à la place (DM_BOOLEAN_CTOR)</a></h3>
|
| +
|
| +
|
| +<p>Créer de nouvelles instances de <code>java.lang.Boolean</code> gaspille la mémoire puisque les objets <code>Boolean</code> sont immuables et qu'il n'y a que deux valeurs utiles de ce type. Utilisez à la place la méthode <code>Boolean.valueOf()</code> pour créer des objets <code>Boolean</code>.</p>
|
| +
|
| +
|
| +<h3><a name="DM_GC">Dm: Ramasse-miettes explicite ; extrêmement douteux sauf dans du code de banc d'essai (DM_GC)</a></h3>
|
| +
|
| +
|
| +<p>Le code appelle explicitement le ramasse-miettes. Mis à part l'emploi spécifique dans un banc d'essai, c'est très douteux.</p>
|
| +<p>Dans le passé, les cas où des personnes ont explicitement invoqué le ramasse-miettes dans des méthodes telles que <code>close()</code> ou <code>finalize()</code> ont creusés des gouffres dans les performances. Le ramasse-miettes peut-être très coûteux. Toute situation qui force des centaines ou des milliers de ramasse-miettes mettra à genoux une machine.</p>
|
| +
|
| +
|
| +<h3><a name="DM_NEW_FOR_GETCLASS">Dm: Méthode allouant un objet juste pour obtenir la classe (DM_NEW_FOR_GETCLASS)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode alloue un objet juste pour appeler sa méthode <code>getClass()</code> afin d'obtenir l'objet <code>Class</code> correspondant. Il est plus simple d'accèder directement à la propriété <code>.class</code> de la classe.</p>
|
| +
|
| +
|
| +<h3><a name="DM_NEXTINT_VIA_NEXTDOUBLE">Dm: Utiliser la méthode nextInt de Random plutôt que nextDouble pour générer un entier aléatoire (DM_NEXTINT_VIA_NEXTDOUBLE)</a></h3>
|
| +
|
| +
|
| +<p>Si <code>r</code> est un <code>java.util.Random</code>, vous pouvez générer un nombre aléatoire entre 0 et n-1 en utilisant <code>r.nextInt(n)</code> plutôt que <code>(int)(r.nextDouble() * n)</code>.</p>
|
| +
|
| +
|
| +<h3><a name="DM_STRING_CTOR">Dm: La méthode invoque le constructeur inutile String(String) ; utilisez juste l'argument (DM_STRING_CTOR)</a></h3>
|
| +
|
| +
|
| +<p>Utiliser le constructeur <code>java.lang.String(String)</code> gaspille de la mémoire puisque l'objet ainsi construit serait fonctionnellement identique à la chaîne passée en paramètre. Utilisez juste la chaîne en argument directement.</p>
|
| +
|
| +
|
| +<h3><a name="DM_STRING_TOSTRING">Dm: La méthode appel toString() sur un objet String ; utilisez directement l'objet String (DM_STRING_TOSTRING)</a></h3>
|
| +
|
| +
|
| +<p>Appeler <code>String.toString()</code> est juste une opération redondante. Utilisez directement l'objet <code>String</code>.</p>
|
| +
|
| +
|
| +<h3><a name="DM_STRING_VOID_CTOR">Dm: La méthode invoque le constructeur inutile String() ; utilisez juste "" (DM_STRING_VOID_CTOR)</a></h3>
|
| +
|
| +
|
| +<p>Créer un nouveau objet <code>java.lang.String</code> en utilisant le constructeur sans argument gaspille de la mémoire parce que l'objet ainsi créé serait fonctionnellement identique à la constante de chaîne vide "". Java garantie que les chaînes constantes identiques seront représentées par le même objet <code>String</code>. C'est pourquoi vous devriez directement utiliser la constante de chaîne vide.</p>
|
| +
|
| +
|
| +<h3><a name="HSC_HUGE_SHARED_STRING_CONSTANT">HSC: Huge string constants is duplicated across multiple class files (HSC_HUGE_SHARED_STRING_CONSTANT)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + A large String constant is duplicated across multiple class files.
|
| + This is likely because a final field is initialized to a String constant, and the Java language
|
| + mandates that all references to a final field from other classes be inlined into
|
| +that classfile. See <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6447475">JDK bug 6447475</a>
|
| + for a description of an occurrence of this bug in the JDK and how resolving it reduced
|
| + the size of the JDK by 1 megabyte.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="IIO_INEFFICIENT_INDEX_OF">IIO: Inefficient use of String.indexOf(String) (IIO_INEFFICIENT_INDEX_OF)</a></h3>
|
| +
|
| +
|
| +<p> This code passes a constant string of length 1 to String.indexOf().
|
| +It is more efficient to use the integer implementations of String.indexOf().
|
| +f. e. call <code>myString.indexOf('.')</code> instead of <code>myString.indexOf(".")</code></p>
|
| +
|
| +
|
| +<h3><a name="IIO_INEFFICIENT_LAST_INDEX_OF">IIO: Inefficient use of String.lastIndexOf(String) (IIO_INEFFICIENT_LAST_INDEX_OF)</a></h3>
|
| +
|
| +
|
| +<p> This code passes a constant string of length 1 to String.lastIndexOf().
|
| +It is more efficient to use the integer implementations of String.lastIndexOf().
|
| +f. e. call <code>myString.lastIndexOf('.')</code> instead of <code>myString.lastIndexOf(".")</code></p>
|
| +
|
| +
|
| +<h3><a name="ITA_INEFFICIENT_TO_ARRAY">ITA: La méthode utilise toArray() avec un tableau vide en paramètre (ITA_INEFFICIENT_TO_ARRAY)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode utilise la méthode <code>toArray()</code> d'une classe dérivant de <code>Collection</code>, en lui passant en paramètre un tableau vide. Il est plus efficace d'utiliser <code>myCollection.toArray(new Foo[myCollection.size()])</code>. Si le tableau transmis est assez grand pour stocker tous les éléments de la collection, alors il est alimenté et renvoyé directement. Ceci évite la nécessité de créer un nouveau tableau (par réflexion) pour renvoyer le résultat.</p>
|
| +
|
| +
|
| +<h3><a name="SBSC_USE_STRINGBUFFER_CONCATENATION">SBSC: La méthode concatène des chaînes au moyen de + en boucle (SBSC_USE_STRINGBUFFER_CONCATENATION)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode semble construire une <ocde>String</code> en utilisant une concaténation en boucle. A chaque itération, l'objet <code>String</code> est converti en <code>StringBuffer</code>/<code>StringBuilder</code>, complété, puis de nouveau converti en <code>String</code>. Ceci a un coût exponentiel en fonction du nombre d'itérations, puisque la chaîne est recopiée à chaque itération.</p>
|
| +<p>De meilleurs performances peuvent être obtenues en utilisant explicitement <code>StringBuffer</code> (ou <code>StringBuilder</code> en Java 5).</p>
|
| +<p>Par exemple :</p>
|
| +<pre>
|
| +// C'est mal !
|
| +String s = "";
|
| +for (int i = 0; i < field.length; ++i) {
|
| + s = s + field[i];
|
| +}
|
| +
|
| +// C'est mieux...
|
| +StringBuffer buf = new StringBuffer();
|
| +for (int i = 0; i < field.length; ++i) {
|
| + buf.append(field[i]);
|
| +}
|
| +String s = buf.toString();
|
| +</pre>
|
| +
|
| +
|
| +<h3><a name="SIC_INNER_SHOULD_BE_STATIC">SIC: Devrait être une classe interne statique (SIC_INNER_SHOULD_BE_STATIC)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe est une classe interne, mais n'utilise pas sa référence vers l'objet qui l'a créée. Cette référence rend les instances de cette classe plus grosses et peut garder active la référence à l'objet créateur plus longtemps que nécessaire. Si possible, la classe devrait être transformée en classe interne <code>static</code>.</p>
|
| +
|
| +
|
| +<h3><a name="SIC_INNER_SHOULD_BE_STATIC_ANON">SIC: Peut-être transformée en classe interne statique nommée (SIC_INNER_SHOULD_BE_STATIC_ANON)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe est une classe interne qui n'utilise pas sa référence vers l'objet qui l'a créée. Cette référence rend l'objet plus gros et peut garder active la référence de l'objet créateur plus longtemps que nécessaire. Si possible, la classe devrait être transformée en classe interne <code>static</code>. Puisque les classes anonymes ne peuvent pas être marquées comme <code>static</code>, il faudrait également nommer cette classe.</p>
|
| +
|
| +
|
| +<h3><a name="SIC_INNER_SHOULD_BE_STATIC_NEEDS_THIS">SIC: Pourrait-être transformée en classe interne statique (SIC_INNER_SHOULD_BE_STATIC_NEEDS_THIS)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe est une classe interne mais elle n'utilise pas sa référence vers l'objet qui l'a créée, à part durant la création de l'objet interne. Cette référence rend les instances de cette classe plus grosses et peut forcer à garder active la référence de l'objet créateur plus longtemps que nécessaire. Si possible, la classe devrait-être transformée en classe interne <code>static</code>. Puisque la référence à l'objet créateur est requise durant la construction de la classe interne, le constructeur de celle-ci devrait-être modifié afin d'accepter en argument cette référence.</p>
|
| +
|
| +
|
| +<h3><a name="SS_SHOULD_BE_STATIC">SS: Champ non lu : devrait-il être statique ? (SS_SHOULD_BE_STATIC)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe contient un champ d'instance <code>final</code> qui est initialisé par une valeur statique déterminée à la compilation. Envisagez de rendre ce champ <code>static</code>.</p>
|
| +
|
| +
|
| +<h3><a name="UM_UNNECESSARY_MATH">UM: Appel d'une méthode statique de la classe Math sur une valeur constante (UM_UNNECESSARY_MATH)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode utilise une méthode statique de <code>java.lang.Math</code> sur une valeur constante. Dans ce cas, le résultat de cet appel peut être déterminé statiquement, ce qui est plus rapide et souvent plus précis. Les méthodes détectées sont :</p>
|
| +<table>
|
| +<tr><th>Méthode</th><th>Paramètre</th></tr>
|
| +<tr><td>abs</td><td>-tous-</td></tr>
|
| +<tr><td>acos</td><td>0.0 ou 1.0</td></tr>
|
| +<tr><td>asin</td><td>0.0 ou 1.0</td></tr>
|
| +<tr><td>atan</td><td>0.0 ou 1.0</td></tr>
|
| +<tr><td>atan2</td><td>0.0</td></tr>
|
| +<tr><td>cbrt</td><td>0.0 ou 1.0</td></tr>
|
| +<tr><td>ceil</td><td>-tous-</td></tr>
|
| +<tr><td>cos</td><td>0.0</td></tr>
|
| +<tr><td>cosh</td><td>0.0</td></tr>
|
| +<tr><td>exp</td><td>0.0 ou 1.0</td></tr>
|
| +<tr><td>expm1</td><td>0.0</td></tr>
|
| +<tr><td>floor</td><td>-tous-</td></tr>
|
| +<tr><td>log</td><td>0.0 ou 1.0</td></tr>
|
| +<tr><td>log10</td><td>0.0 ou 1.0</td></tr>
|
| +<tr><td>rint</td><td>-tous-</td></tr>
|
| +<tr><td>round</td><td>-tous-</td></tr>
|
| +<tr><td>sin</td><td>0.0</td></tr>
|
| +<tr><td>sinh</td><td>0.0</td></tr>
|
| +<tr><td>sqrt</td><td>0.0 ou 1.0</td></tr>
|
| +<tr><td>tan</td><td>0.0</td></tr>
|
| +<tr><td>tanh</td><td>0.0</td></tr>
|
| +<tr><td>toDegrees</td><td>0.0 ou 1.0</td></tr>
|
| +<tr><td>toRadians</td><td>0.0</td></tr>
|
| +</table>
|
| +
|
| +
|
| +<h3><a name="UPM_UNCALLED_PRIVATE_METHOD">UPM: Méthode privée jamais appelée (UPM_UNCALLED_PRIVATE_METHOD)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode privée n'est jamais appelée. Bien qu'il soit possible que cette méthode soit appelée par réflexion, il y a plus de chances qu'elle ne soit jamais utilisée et qu'elle puisse être supprimée.</p>
|
| +
|
| +
|
| +<h3><a name="URF_UNREAD_FIELD">UrF: Champ inutilisé (URF_UNREAD_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Ce champ n'est jamais lu. Envisagez de le supprimer de la classe.</p>
|
| +
|
| +
|
| +<h3><a name="UUF_UNUSED_FIELD">UuF: Champ inutilisé (UUF_UNUSED_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Ce champ n'est jamais utilisé. Envisagez de le supprimer de la classe.</p>
|
| +
|
| +
|
| +<h3><a name="WMI_WRONG_MAP_ITERATOR">WMI: Utilisation inefficace d'un itérateur sur keySet au lieu de entrySet (WMI_WRONG_MAP_ITERATOR)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode accède à la valeur d'une entrée de <code>Map</code> au moyen d'une clé provenant d'un itérateur sur <code>keySet</code>. Il est plus efficace d'utiliser un itérateur sur l'<code>entrySet</code> de la <code>Map</code>, pour éviter la recherche par <code>Map.get(clé)</code>.</p>
|
| +
|
| +
|
| +<h3><a name="DMI_CONSTANT_DB_PASSWORD">Dm: Hardcoded constant database password (DMI_CONSTANT_DB_PASSWORD)</a></h3>
|
| +
|
| +
|
| + <p>This code creates a database connect using a hardcoded, constant password. Anyone with access to either the source code or the compiled code can
|
| + easily learn the password.
|
| +</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="DMI_EMPTY_DB_PASSWORD">Dm: Empty database password (DMI_EMPTY_DB_PASSWORD)</a></h3>
|
| +
|
| +
|
| + <p>This code creates a database connect using a blank or empty password. This indicates that the database is not protected by a password.
|
| +</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="HRS_REQUEST_PARAMETER_TO_COOKIE">HRS: HTTP cookie formed from untrusted input (HRS_REQUEST_PARAMETER_TO_COOKIE)</a></h3>
|
| +
|
| +
|
| + <p>This code constructs an HTTP Cookie using an untrusted HTTP parameter. If this cookie is added to an HTTP response, it will allow a HTTP response splitting
|
| +vulnerability. See <a href="http://en.wikipedia.org/wiki/HTTP_response_splitting">http://en.wikipedia.org/wiki/HTTP_response_splitting</a>
|
| +for more information.</p>
|
| +<p>FindBugs looks only for the most blatant, obvious cases of HTTP response splitting.
|
| +If FindBugs found <em>any</em>, you <em>almost certainly</em> have more
|
| +vulnerabilities that FindBugs doesn't report. If you are concerned about HTTP response splitting, you should seriously
|
| +consider using a commercial static analysis or pen-testing tool.
|
| +</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="HRS_REQUEST_PARAMETER_TO_HTTP_HEADER">HRS: HTTP Response splitting vulnerability (HRS_REQUEST_PARAMETER_TO_HTTP_HEADER)</a></h3>
|
| +
|
| +
|
| + <p>This code directly writes an HTTP parameter to an HTTP header, which allows for a HTTP response splitting
|
| +vulnerability. See <a href="http://en.wikipedia.org/wiki/HTTP_response_splitting">http://en.wikipedia.org/wiki/HTTP_response_splitting</a>
|
| +for more information.</p>
|
| +<p>FindBugs looks only for the most blatant, obvious cases of HTTP response splitting.
|
| +If FindBugs found <em>any</em>, you <em>almost certainly</em> have more
|
| +vulnerabilities that FindBugs doesn't report. If you are concerned about HTTP response splitting, you should seriously
|
| +consider using a commercial static analysis or pen-testing tool.
|
| +</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="PT_ABSOLUTE_PATH_TRAVERSAL">PT: Absolute path traversal in servlet (PT_ABSOLUTE_PATH_TRAVERSAL)</a></h3>
|
| +
|
| +
|
| + <p>The software uses an HTTP request parameter to construct a pathname that should be within a restricted directory,
|
| +but it does not properly neutralize absolute path sequences such as "/abs/path" that can resolve to a location that is outside of that directory.
|
| +
|
| +See <a href="http://cwe.mitre.org/data/definitions/36.html">http://cwe.mitre.org/data/definitions/36.html</a>
|
| +for more information.</p>
|
| +<p>FindBugs looks only for the most blatant, obvious cases of absolute path traversal.
|
| +If FindBugs found <em>any</em>, you <em>almost certainly</em> have more
|
| +vulnerabilities that FindBugs doesn't report. If you are concerned about absolute path traversal, you should seriously
|
| +consider using a commercial static analysis or pen-testing tool.
|
| +</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="PT_RELATIVE_PATH_TRAVERSAL">PT: Relative path traversal in servlet (PT_RELATIVE_PATH_TRAVERSAL)</a></h3>
|
| +
|
| +
|
| + <p>The software uses an HTTP request parameter to construct a pathname that should be within a restricted directory, but it does not properly neutralize sequences such as ".." that can resolve to a location that is outside of that directory.
|
| +
|
| +See <a href="http://cwe.mitre.org/data/definitions/23.html">http://cwe.mitre.org/data/definitions/23.html</a>
|
| +for more information.</p>
|
| +<p>FindBugs looks only for the most blatant, obvious cases of relative path traversal.
|
| +If FindBugs found <em>any</em>, you <em>almost certainly</em> have more
|
| +vulnerabilities that FindBugs doesn't report. If you are concerned about relative path traversal, you should seriously
|
| +consider using a commercial static analysis or pen-testing tool.
|
| +</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="SQL_NONCONSTANT_STRING_PASSED_TO_EXECUTE">SQL: Une chaîne non constante est passée à la méthode execute d'une commande SQL (SQL_NONCONSTANT_STRING_PASSED_TO_EXECUTE)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode invoque la méthode <code>execute</code> d'une commande SQL (statement) avec une chaîne qui semble générée dynamiquement. Préférer la préparation de la commande avec un <code>PreparedStatement</code>, c'est plus efficace et bien moins vulnérable aux attaques par injection SQL (insertion de code SQL malveillant au sein d'une requête).</p>
|
| +
|
| +
|
| +<h3><a name="SQL_PREPARED_STATEMENT_GENERATED_FROM_NONCONSTANT_STRING">SQL: Une requète est préparée à partir d'une chaine non constante (SQL_PREPARED_STATEMENT_GENERATED_FROM_NONCONSTANT_STRING)</a></h3>
|
| +
|
| +
|
| +<p>Ce code créé une requète SQL préparée à partir d'une chaine non constante. Les données qui permettent de construire cette chaine venant de l'utilisateur, elles pourraient, sans vérification, servir à faire de l'injection de SQL et ainsi modifier la requète afin qu'elle produise des résultats inattendus et indésirables.</p>
|
| +
|
| +
|
| +<h3><a name="XSS_REQUEST_PARAMETER_TO_JSP_WRITER">XSS: JSP reflected cross site scripting vulnerability (XSS_REQUEST_PARAMETER_TO_JSP_WRITER)</a></h3>
|
| +
|
| +
|
| + <p>This code directly writes an HTTP parameter to JSP output, which allows for a cross site scripting
|
| +vulnerability. See <a href="http://en.wikipedia.org/wiki/Cross-site_scripting">http://en.wikipedia.org/wiki/Cross-site_scripting</a>
|
| +for more information.</p>
|
| +<p>FindBugs looks only for the most blatant, obvious cases of cross site scripting.
|
| +If FindBugs found <em>any</em>, you <em>almost certainly</em> have more cross site scripting
|
| +vulnerabilities that FindBugs doesn't report. If you are concerned about cross site scripting, you should seriously
|
| +consider using a commercial static analysis or pen-testing tool.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="XSS_REQUEST_PARAMETER_TO_SEND_ERROR">XSS: Servlet reflected cross site scripting vulnerability in error page (XSS_REQUEST_PARAMETER_TO_SEND_ERROR)</a></h3>
|
| +
|
| +
|
| + <p>This code directly writes an HTTP parameter to a Server error page (using HttpServletResponse.sendError). Echoing this untrusted input allows
|
| +for a reflected cross site scripting
|
| +vulnerability. See <a href="http://en.wikipedia.org/wiki/Cross-site_scripting">http://en.wikipedia.org/wiki/Cross-site_scripting</a>
|
| +for more information.</p>
|
| +<p>FindBugs looks only for the most blatant, obvious cases of cross site scripting.
|
| +If FindBugs found <em>any</em>, you <em>almost certainly</em> have more cross site scripting
|
| +vulnerabilities that FindBugs doesn't report. If you are concerned about cross site scripting, you should seriously
|
| +consider using a commercial static analysis or pen-testing tool.
|
| +</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="XSS_REQUEST_PARAMETER_TO_SERVLET_WRITER">XSS: Servlet reflected cross site scripting vulnerability (XSS_REQUEST_PARAMETER_TO_SERVLET_WRITER)</a></h3>
|
| +
|
| +
|
| + <p>This code directly writes an HTTP parameter to Servlet output, which allows for a reflected cross site scripting
|
| +vulnerability. See <a href="http://en.wikipedia.org/wiki/Cross-site_scripting">http://en.wikipedia.org/wiki/Cross-site_scripting</a>
|
| +for more information.</p>
|
| +<p>FindBugs looks only for the most blatant, obvious cases of cross site scripting.
|
| +If FindBugs found <em>any</em>, you <em>almost certainly</em> have more cross site scripting
|
| +vulnerabilities that FindBugs doesn't report. If you are concerned about cross site scripting, you should seriously
|
| +consider using a commercial static analysis or pen-testing tool.
|
| +</p>
|
| +
|
| +
|
| +
|
| +<h3><a name="BC_BAD_CAST_TO_ABSTRACT_COLLECTION">BC: Transtypage douteux d'un type Collection vers une classe abstraite (BC_BAD_CAST_TO_ABSTRACT_COLLECTION)</a></h3>
|
| +
|
| +
|
| +<p>Ce code transtype un object de type <code>Collection</code> vers un type de collection abstrait (tel que <code>Collection</code>). Assurez vous que l'objet est bien du type précisé. Si vous désirez par exemple faire une itération sur une collection, le transtypage vers <code>Set</code> ou <code>List</code> est inutile.</p>
|
| +
|
| +
|
| +<h3><a name="BC_BAD_CAST_TO_CONCRETE_COLLECTION">BC: Transtypage douteux vers une collection concrète (BC_BAD_CAST_TO_CONCRETE_COLLECTION)</a></h3>
|
| +
|
| +
|
| +<p>Ce code transtype une collection abstraite (telles que <code>Collection</code>, <code>List</code>, ou <code>Set</code>) vers une implémentation concrète spécifique (telles que <code>ArrayList</code> ou <code>HashSet</code>). Ceci n'est pas forcément correct, et peut rendre votre code plus fragile, puisqu'il un éventuel refactoring futur avec une autre implémentation concrète plus difficile. A défaut d'une raison valable, l'utilisation des classes abstraites est recommandée.</p>
|
| +
|
| +
|
| +<h3><a name="BC_UNCONFIRMED_CAST">BC: Transtypage non vérifié/non confirmé (BC_UNCONFIRMED_CAST)</a></h3>
|
| +
|
| +
|
| +<p>La faisablité du transtypage n'est pas vérifiée, et tous les objets candidats au transtypage ne sont pas légitimes. Assurez vous que la logique du programme est correcte et que le transtypage n'échouera pas.</p>
|
| +
|
| +
|
| +<h3><a name="BC_UNCONFIRMED_CAST_OF_RETURN_VALUE">BC: Unchecked/unconfirmed cast of return value from method (BC_UNCONFIRMED_CAST_OF_RETURN_VALUE)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +This code performs an unchecked cast of the return value of a method.
|
| +The code might be calling the method in such a way that the cast is guaranteed to be
|
| +safe, but FindBugs is unable to verify that the cast is safe. Check that your program logic ensures that this
|
| +cast will not fail.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="BC_VACUOUS_INSTANCEOF">BC: instanceof renverra toujours vrai (BC_VACUOUS_INSTANCEOF)</a></h3>
|
| +
|
| +
|
| +<p>Ce test <code>instanceof</code> renverra toujours vrai. Même s'il est sûr, assurez-vous qu'il ne s'agit pas d'une erreur logique ou d'une mauvaise compréhension.</p>
|
| +
|
| +
|
| +<h3><a name="ICAST_QUESTIONABLE_UNSIGNED_RIGHT_SHIFT">BSHIFT: Décalage à droite non signé et transtypage short/byte (ICAST_QUESTIONABLE_UNSIGNED_RIGHT_SHIFT)</a></h3>
|
| +
|
| +
|
| +<p>Le code effectue un décalage à droite non signé, dont le résultat est transtypé vers un <code>short</code> ou un <code>byte</code>, ce qui élimine les bits supérieurs du résultat. Puisque les bits supérieurs sont éliminés, il peut ne pas y avoir de différence entre un décalage à droite signé ou non signé (ceci dépend de la taille du décalage)</p>
|
| +
|
| +
|
| +<h3><a name="CI_CONFUSED_INHERITANCE">CI: Classe finale déclarant un champ protégé (CI_CONFUSED_INHERITANCE)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe est déclarée <code>final</code> mais comporte des champs <code>protected</code>. Cette classe étant finale, elle ne pourra jamais être dérivée et donc l'utilisation de <code>protected</code> est troublante. Le modificateur d'accès devrait être modifié à <code>private</code> ou <code>public</code> pour mettre en évidence la véritable utilisation du champ.</p>
|
| +
|
| +
|
| +<h3><a name="DB_DUPLICATE_BRANCHES">DB: Méthode utilsant le même code pour deux branches (DB_DUPLICATE_BRANCHES)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode utilise le même code pour implémenter deux branches d'une condition. Vérifiez pour vous assurer que ce n'est pas une erreur de codage.</p>
|
| +
|
| +
|
| +<h3><a name="DB_DUPLICATE_SWITCH_CLAUSES">DB: Méthode utilisant le même code pour deux clauses switch (DB_DUPLICATE_SWITCH_CLAUSES)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode utilise le même code pour implémenter deux cas différents d'un <code>switch</code>. Ce peut être normal mais il vaut mieux vérifier que ce n'est pas une erreur de codage.</p>
|
| +
|
| +
|
| +<h3><a name="DLS_DEAD_LOCAL_STORE">DLS: Alimentation à perte d'une variable locale (DLS_DEAD_LOCAL_STORE)</a></h3>
|
| +
|
| +
|
| +<p>Cette instruction assigne une valeur à une variable locale mais cette variable n'est pas lue par la suite. Ceci indique souvent une erreur puisque la valeur calculée n'est jamais utilisée.</p>
|
| +<p>Notez que le compilateur javac de Sun génère fréquemment ce genre d'affectations à perte. FindBugs analysant le byte-code généré, il n'y a pas de façon simple d'éliminer ces fausses alarmes.</p>
|
| +
|
| +
|
| +<h3><a name="DLS_DEAD_LOCAL_STORE_IN_RETURN">DLS: Useless assignment in return statement (DLS_DEAD_LOCAL_STORE_IN_RETURN)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +This statement assigns to a local variable in a return statement. This assignment
|
| +has effect. Please verify that this statement does the right thing.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="DLS_DEAD_LOCAL_STORE_OF_NULL">DLS: Alimentation à null d'une variable (DLS_DEAD_LOCAL_STORE_OF_NULL)</a></h3>
|
| +
|
| +
|
| +<p>Le code alimente une variable locale avec null, la valeur n'étant jamais lue par la suite. Cette alimentation a pu être introduite pour faciliter le travail du ramasse-miettes, mais cela n'a plus aucun intérêt avec Java SE 6.</p>
|
| +
|
| +
|
| +<h3><a name="DLS_DEAD_LOCAL_STORE_SHADOWS_FIELD">DLS: Dead store to local variable that shadows field (DLS_DEAD_LOCAL_STORE_SHADOWS_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +This instruction assigns a value to a local variable,
|
| +but the value is not read or used in any subsequent instruction.
|
| +Often, this indicates an error, because the value computed is never
|
| +used. There is a field with the same name as the local variable. Did you
|
| +mean to assign to that variable instead?
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="DMI_HARDCODED_ABSOLUTE_FILENAME">DMI: Chemin absolu codé en dur dans le code (DMI_HARDCODED_ABSOLUTE_FILENAME)</a></h3>
|
| +
|
| +
|
| +<p>Ce code construit un objet <code>File</code> en utilisant un chemin absolu de fichier codé en dur (Ex. : <code>new File("/home/dannyc/workspace/j2ee/src/share/com/sun/enterprise/deployment");)</code>.</p>
|
| +
|
| +
|
| +<h3><a name="DMI_NONSERIALIZABLE_OBJECT_WRITTEN">DMI: Objet non sérialisable écrit dans un ObjectOutput (DMI_NONSERIALIZABLE_OBJECT_WRITTEN)</a></h3>
|
| +
|
| +
|
| +<p>Ce code semble transmettre un objet non sérialisable à la méthode <code>ObjectOutput.writeObject</code>. Une erreur se produira si cet objet est effectivement non sérialisable.</p>
|
| +
|
| +
|
| +<h3><a name="DMI_USELESS_SUBSTRING">DMI: Appel de substring(0) qui retourne la valeur originale (DMI_USELESS_SUBSTRING)</a></h3>
|
| +
|
| +
|
| +<p>Ce code appelle <code>substring(0)</code> sur une chaine, ce qui renvoit la valeur originale.</p>
|
| +
|
| +
|
| +<h3><a name="DMI_THREAD_PASSED_WHERE_RUNNABLE_EXPECTED">Dm: Thread passed where Runnable expected (DMI_THREAD_PASSED_WHERE_RUNNABLE_EXPECTED)</a></h3>
|
| +
|
| +
|
| + <p> A Thread object is passed as a parameter to a method where
|
| +a Runnable is expected. This is rather unusual, and may indicate a logic error
|
| +or cause unexpected behavior.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="EQ_DOESNT_OVERRIDE_EQUALS">Eq: Class doesn't override equals in superclass (EQ_DOESNT_OVERRIDE_EQUALS)</a></h3>
|
| +
|
| +
|
| + <p> This class extends a class that defines an equals method and adds fields, but doesn't
|
| +define an equals method itself. Thus, equality on instances of this class will
|
| +ignore the identity of the subclass and the added fields. Be sure this is what is intended,
|
| +and that you don't need to override the equals method. Even if you don't need to override
|
| +the equals method, consider overriding it anyway to document the fact
|
| +that the equals method for the subclass just return the result of
|
| +invoking super.equals(o).
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="EQ_UNUSUAL">Eq: Unusual equals method (EQ_UNUSUAL)</a></h3>
|
| +
|
| +
|
| + <p> This class doesn't do any of the patterns we recognize for checking that the type of the argument
|
| +is compatible with the type of the <code>this</code> object. There might not be anything wrong with
|
| +this code, but it is worth reviewing.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="FE_FLOATING_POINT_EQUALITY">FE: Test d'égalité en virgule flottante. (FE_FLOATING_POINT_EQUALITY)</a></h3>
|
| +
|
| +
|
| +<p>Cette opération teste l'égalité de deux valeurs en virgule flottante. Les calculs en virgule flottante pouvant introduire des arrondis, les valeurs flottantes ou doubles peuvent être imprécises. Pour les valeurs qui doivent être précises, telles que les valeurs monétaires, pensez à utiliser un type à précision fixe tel qu'un <code>BigDecimal</code>. Pour les valeurs qui n'ont pas besoin d'être précises, pensez à tester l'égalité sur une portée quelconque, par exemple : <code>if ( Math.abs(x - y) < .0000001 )</code>. Cf section 4.2.4 des spécifications du langage Java.</p>
|
| +
|
| +
|
| +<h3><a name="VA_FORMAT_STRING_BAD_CONVERSION_TO_BOOLEAN">FS: Non-Boolean argument formatted using %b format specifier (VA_FORMAT_STRING_BAD_CONVERSION_TO_BOOLEAN)</a></h3>
|
| +
|
| +
|
| +<p>
|
| +An argument not of type Boolean is being formatted with a %b format specifier. This won't throw an
|
| +exception; instead, it will print true for any nonnull value, and false for null.
|
| +This feature of format strings is strange, and may not be what you intended.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="IA_AMBIGUOUS_INVOCATION_OF_INHERITED_OR_OUTER_METHOD">IA: Appel ambigu d'une méthode hérité ou externe (IA_AMBIGUOUS_INVOCATION_OF_INHERITED_OR_OUTER_METHOD)</a></h3>
|
| +
|
| +
|
| +<p>Une classe interne invoque une méthode qui peut être résolue comme une méthode héritée ou comme une méthode définie dans une classe externe. La sémantique de Java fait qu'elle sera résolue en invoquant la méthode héritée, mais ce n'est peut être pas votre intention. Si vous souhaitez réellement invoquer la méthode héritée, faite le en utilisant <code>super</code> (Ex : appelé <code>super.foo(17)</code>) ce qui clarifiera votre code pour les autres lecteurs et pour FindBugs.</p>
|
| +
|
| +
|
| +<h3><a name="IC_INIT_CIRCULARITY">IC: Initialisation circulaire (IC_INIT_CIRCULARITY)</a></h3>
|
| +
|
| +
|
| +<p>Une initialisation circulaire a été détectée dans les initialisations de variables statiques de deux classes référencées par l'instance en erreur. De nombreuses sortes de comportements inattendus peuvent surgir d'une telle situation.</p>
|
| +
|
| +
|
| +<h3><a name="ICAST_IDIV_CAST_TO_DOUBLE">ICAST: Résultat d'une division entière transtypé en nombre flottant (ICAST_IDIV_CAST_TO_DOUBLE)</a></h3>
|
| +
|
| +
|
| +<p>Ce code transtype le résultat d'une division entière en un nombre flottant à double précision. Effectuer une division sur des nombres entiers n'est pas précis. Le fait que le résultat soit transtypé en <code>double</code> suggère que cette précision était voulue dès le départ. Peut être l'un ou l'autre des opérandes, ou les deux opérandes, auraient du être transtypé avant d'effectuer la division. Voici un exemple :</p>
|
| +<blockquote>
|
| +<pre>
|
| +int x = 2;
|
| +int y = 5;
|
| +// Faux: renvoi 0.0
|
| +double value1 = x / y;
|
| +
|
| +// Juste: renvoi 0.4
|
| +double value2 = x / (double) y;
|
| +</pre>
|
| +</blockquote>
|
| +
|
| +
|
| +<h3><a name="ICAST_INTEGER_MULTIPLY_CAST_TO_LONG">ICAST: Résultat d'une multiplication entière transtypée en long (ICAST_INTEGER_MULTIPLY_CAST_TO_LONG)</a></h3>
|
| +
|
| +
|
| +<p>Ce code effectue des multiplications entières et transtype le résultat en <code>long</code>, comme dans :
|
| +<code>long convertDaysToMilliseconds(int days) { return 1000*3600*24*days; }</code>. Si la multiplication était réalisée en utilisant l'arithmétique <code>long</code>, vous pourriez éviter le risque de débordement de capacité du calcul. Vous pouvez par exemple corriger le code précédent par : <code>long convertDaysToMilliseconds(int days) { return 1000L*3600*24*days; }</code> ou <code><pre>
|
| +static final long MILLISECONDS_PER_DAY = 24L*3600*1000;
|
| +long convertDaysToMilliseconds(int days) { return days * MILLISECONDS_PER_DAY; }
|
| +</pre></code></p>
|
| +
|
| +
|
| +<h3><a name="IM_AVERAGE_COMPUTATION_COULD_OVERFLOW">IM: Possibilité de débordement du calcul d'une moyenne (IM_AVERAGE_COMPUTATION_COULD_OVERFLOW)</a></h3>
|
| +
|
| +
|
| +<p>Le code calcule la moyenne de deux entiers au moyen d'une division ou d'un décalage signé vers la droite, puis utilise le résultat comme indice d'un tableau. Si les valeurs moyennées sont très grandes, le calcul peut déborder (résultant en un très grand négatif). En supposant que le résultat doive toujours être positif, vous devriez plutôt utiliser un décalage à droite non signé. En d'autres termes, utilisez plutôt <code>(low+high) >>> 1</code> au lieu de <code>(low+high)/2</code>.</p>
|
| +<p>Le bug existe dans de nombreuses implémentations des recherches binaires et des tris fusion. Martin Buchholz <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6412541"> l'a recherché et corrigé </a> dans les librairies du JDK et Joshua Bloch <a href="http://googleresearch.blogspot.com/2006/06/extra-extra-read-all-about-it-nearly.html"> a largement publié ce modèle de bug</a>.</p>
|
| +
|
| +
|
| +<h3><a name="IM_BAD_CHECK_FOR_ODD">IM: Test d'impaire ne fonctionnant pas avec les négatifs (IM_BAD_CHECK_FOR_ODD)</a></h3>
|
| +
|
| +
|
| +<p>Le code utilise <code>x % 2 == 1</code> pour véifier si une valeur est impaire, mais cela ne fonctionera pas avec une valeur négative (Ex. : <code>(-5) % 2 == -1</code>). Si ce code doit tester si une valeur est impaire, envisagez d'utiliser <code>x & 1 == 1</code> ou <code>x % 2 != 0</code>.</p>
|
| +
|
| +
|
| +<h3><a name="INT_BAD_REM_BY_1">INT: Reste entier modulo 1 (INT_BAD_REM_BY_1)</a></h3>
|
| +
|
| +
|
| +<p>Cette expression (Ex. : <code>exp % 1</code>) est assurée de toujours renvoyer 0. Vouliez-vous plutot dire <code>(exp & 1)</code> ou <code>(exp % 2)</code> ?</p>
|
| +
|
| +
|
| +<h3><a name="INT_VACUOUS_BIT_OPERATION">INT: Vacuous bit mask operation on integer value (INT_VACUOUS_BIT_OPERATION)</a></h3>
|
| +
|
| +
|
| +<p> This is an integer bit operation (and, or, or exclusive or) that doesn't do any useful work
|
| +(e.g., <code>v & 0xffffffff</code>).
|
| +
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="INT_VACUOUS_COMPARISON">INT: Comparaison inutile de valeurs entières (INT_VACUOUS_COMPARISON)</a></h3>
|
| +
|
| +
|
| +<p>Il y a une comparaison entière qui renvoie toujours la même valeur (Ex. : <code>x <= Integer.MAX_VALUE</code>).</p>
|
| +
|
| +
|
| +<h3><a name="MTIA_SUSPECT_SERVLET_INSTANCE_FIELD">MTIA: La classe hérite de Servlet et utilise les variables de l'instance. (MTIA_SUSPECT_SERVLET_INSTANCE_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe hérite de la classe <code>Servlet</code>, et utilise une variable de l'instance. Puisqu'une seule instance d'une classe <code>Servlet</code> est créée par le cadre de travail J2EE, et est utilisée dans un environnement multitâche, ce paradigme est très fortement découragé et très certainement problématique. Considérer l'emploi seul de variables propres à la méthode.</p>
|
| +
|
| +
|
| +<h3><a name="MTIA_SUSPECT_STRUTS_INSTANCE_FIELD">MTIA: La classe hérite d'une classe action Struts et utilise les variables de l'instance. (MTIA_SUSPECT_STRUTS_INSTANCE_FIELD)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe hérite d'une classe <code>Action</code> Struts, et utilise une variable de cette instance. Puisqu'une seule instance de la classe <code>Action</code> Struts est créée par le cadre de travail Struts, et est utilisée dans un environnement multitâche, ce paradigme est très fortement découragé et très certainement problématique. Considérer l'emploi seul de variables propres à la méthode.</p>
|
| +
|
| +
|
| +<h3><a name="NP_DEREFERENCE_OF_READLINE_VALUE">NP: Dereference of the result of readLine() without nullcheck (NP_DEREFERENCE_OF_READLINE_VALUE)</a></h3>
|
| +
|
| +
|
| + <p> The result of invoking readLine() is dereferenced without checking to see if the result is null. If there are no more lines of text
|
| +to read, readLine() will return null and dereferencing that will generate a null pointer exception.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="NP_IMMEDIATE_DEREFERENCE_OF_READLINE">NP: Déréférencement immédiat du résultat d'un readLine() (NP_IMMEDIATE_DEREFERENCE_OF_READLINE)</a></h3>
|
| +
|
| +
|
| +<p>Le résultat d'un appel à <code>readLine()</code> est immédiatement déréférencé. S'il n'y a plus d'autre lignes de texte à lire, <code>readLine()</code> retournera <code>null</code> ce qui provoquera une <code>NullPointerException</code> lors du déréférencement.</p>
|
| +
|
| +
|
| +<h3><a name="NP_LOAD_OF_KNOWN_NULL_VALUE">NP: Chargement d'une valeur connue pour être à null (NP_LOAD_OF_KNOWN_NULL_VALUE)</a></h3>
|
| +
|
| +
|
| +<p>La variable référencée est connue pour être à <code>null</code> suite à une vérification précédente. Bien que cela soit valide, ce peut être une erreur (peut-être vouliez-vous référencer une autre valeur ou le test précédent aurait-il due vérifier non-null plutôt que null).</p>
|
| +
|
| +
|
| +<h3><a name="NP_METHOD_PARAMETER_TIGHTENS_ANNOTATION">NP: Method tightens nullness annotation on parameter (NP_METHOD_PARAMETER_TIGHTENS_ANNOTATION)</a></h3>
|
| +
|
| + <p>
|
| + A method should always implement the contract of a method it overrides. Thus, if a method takes a parameter
|
| + that is marked as @Nullable, you shouldn't override that method in a subclass with a method where that parameter is @Nonnull.
|
| + Doing so violates the contract that the method should handle a null parameter.
|
| + </p>
|
| +
|
| +<h3><a name="NP_METHOD_RETURN_RELAXING_ANNOTATION">NP: Method relaxes nullness annotation on return value (NP_METHOD_RETURN_RELAXING_ANNOTATION)</a></h3>
|
| +
|
| + <p>
|
| + A method should always implement the contract of a method it overrides. Thus, if a method takes is annotated
|
| + as returning a @Nonnull value,
|
| + you shouldn't override that method in a subclass with a method annotated as returning a @Nullable or @CheckForNull value.
|
| + Doing so violates the contract that the method shouldn't return null.
|
| + </p>
|
| +
|
| +<h3><a name="NP_NULL_ON_SOME_PATH_FROM_RETURN_VALUE">NP: Pointeur à null renvoyé par une méthode qui risque d'être déréférencé (NP_NULL_ON_SOME_PATH_FROM_RETURN_VALUE)</a></h3>
|
| +
|
| +
|
| +<p>La valeur renvoyée par une méthode est déréférencée alors que cette méthode peut renvoyer <code>null</code>. Ceci peut conduire à une <code>NullPointerException</code> quand le code sera exécuté.</p>
|
| +
|
| +
|
| +<h3><a name="NP_NULL_ON_SOME_PATH_MIGHT_BE_INFEASIBLE">NP: Possible null pointer dereference on branch that might be infeasible (NP_NULL_ON_SOME_PATH_MIGHT_BE_INFEASIBLE)</a></h3>
|
| +
|
| +
|
| +<p> There is a branch of statement that, <em>if executed,</em> guarantees that
|
| +a null value will be dereferenced, which
|
| +would generate a <code>NullPointerException</code> when the code is executed.
|
| +Of course, the problem might be that the branch or statement is infeasible and that
|
| +the null pointer exception can't ever be executed; deciding that is beyond the ability of FindBugs.
|
| +Due to the fact that this value had been previously tested for nullness,
|
| +this is a definite possibility.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="NP_PARAMETER_MUST_BE_NONNULL_BUT_MARKED_AS_NULLABLE">NP: Parameter must be nonnull but is marked as nullable (NP_PARAMETER_MUST_BE_NONNULL_BUT_MARKED_AS_NULLABLE)</a></h3>
|
| +
|
| +
|
| +<p> This parameter is always used in a way that requires it to be nonnull,
|
| +but the parameter is explicitly annotated as being Nullable. Either the use
|
| +of the parameter or the annotation is wrong.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="NP_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD">NP: Read of unwritten public or protected field (NP_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD)</a></h3>
|
| +
|
| +
|
| + <p> The program is dereferencing a public or protected
|
| +field that does not seem to ever have a non-null value written to it.
|
| +Unless the field is initialized via some mechanism not seen by the analysis,
|
| +dereferencing this value will generate a null pointer exception.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="NS_DANGEROUS_NON_SHORT_CIRCUIT">NS: Potentially dangerous use of non-short-circuit logic (NS_DANGEROUS_NON_SHORT_CIRCUIT)</a></h3>
|
| +
|
| +
|
| + <p> This code seems to be using non-short-circuit logic (e.g., &
|
| +or |)
|
| +rather than short-circuit logic (&& or ||). In addition,
|
| +it seem possible that, depending on the value of the left hand side, you might not
|
| +want to evaluate the right hand side (because it would have side effects, could cause an exception
|
| +or could be expensive.</p>
|
| +<p>
|
| +Non-short-circuit logic causes both sides of the expression
|
| +to be evaluated even when the result can be inferred from
|
| +knowing the left-hand side. This can be less efficient and
|
| +can result in errors if the left-hand side guards cases
|
| +when evaluating the right-hand side can generate an error.
|
| +</p>
|
| +
|
| +<p>See <a href="http://java.sun.com/docs/books/jls/third_edition/html/expressions.html#15.22.2">the Java
|
| +Language Specification</a> for details
|
| +
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="NS_NON_SHORT_CIRCUIT">NS: Utilisation discutable de logique binaire (NS_NON_SHORT_CIRCUIT)</a></h3>
|
| +
|
| +
|
| +<p>Ce code semble utiliser de la logique binaire (Ex. : <code>&</code> ou <code>|</code>) plutôt que les opérateurs booléens (<code>&&</code> ou <code>||</code>). La logique binaire entraîne l'évaluation systématique de toute l'expression, même quand le résultat pourrait être immédiatement déduit. Ceci est moins performant et peut provoquer des erreurs lorsque la partie gauche de l'expression masque des cas de la partie droite.</p>
|
| +
|
| +
|
| +<h3><a name="PZLA_PREFER_ZERO_LENGTH_ARRAYS">PZLA: Envisagez de renvoyer un tableau vide plutôt que null (PZLA_PREFER_ZERO_LENGTH_ARRAYS)</a></h3>
|
| +
|
| +
|
| +<p>Renvoyer un tableau vide constitue souvent une meilleure approche plutôt que de renvoyer une référence à <code>null</code> pour signaler qu'il n'y a pas de résultat (c'est-à-dire, une liste vide de résultats). De cette façon, aucune vérification explicite du <code>null</code> n'est nécessaire dans les méthodes clientes.</p>
|
| +<p>D'un autre côté, utiliser <code>null</code> signifie "il n'y a pas de réponse à cette question". Cela peut donc être approprié. Par exemple, <code>File.listFiles()</code> renvoi une liste vide si un répertoire donné ne contient pas de fichiers, et renvoi <code>null</code> si le fichier n'est pas un répertoire.</p>
|
| +
|
| +
|
| +<h3><a name="QF_QUESTIONABLE_FOR_LOOP">QF: Incrémentation compliquée, subtile au incorrecte dans une boucle for (QF_QUESTIONABLE_FOR_LOOP)</a></h3>
|
| +
|
| +
|
| +<p>Etes vous certain que cette boucle incrémente la variable voulue ? Il sembleraît qu'une autre variable est initialisée et vérifiée par la boucle.</p>
|
| +
|
| +
|
| +<h3><a name="RCN_REDUNDANT_COMPARISON_OF_NULL_AND_NONNULL_VALUE">RCN: Comparaison redondante d'une valeur non nulle avec null (RCN_REDUNDANT_COMPARISON_OF_NULL_AND_NONNULL_VALUE)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient une comparaison entre une référence connue pour être non nulle avec une autre référence connue pour être à <code>null</code>.</p>
|
| +
|
| +
|
| +<h3><a name="RCN_REDUNDANT_COMPARISON_TWO_NULL_VALUES">RCN: Comparaison redondante de deux valeurs nulles (RCN_REDUNDANT_COMPARISON_TWO_NULL_VALUES)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient une comparaison redondante entre deux références connues pour être obligatoirement à <code>null</code>.</p>
|
| +
|
| +
|
| +<h3><a name="RCN_REDUNDANT_NULLCHECK_OF_NONNULL_VALUE">RCN: Test de nullité redondant sur une valeur non nulle (RCN_REDUNDANT_NULLCHECK_OF_NONNULL_VALUE)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient un test redondant de nullité sur une valeur connue pour être non nulle.</p>
|
| +
|
| +
|
| +<h3><a name="RCN_REDUNDANT_NULLCHECK_OF_NULL_VALUE">RCN: Test de nullité redondant sur une valeur connue pour être à null (RCN_REDUNDANT_NULLCHECK_OF_NULL_VALUE)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient un test redondant de nullité sur une valeur ne pouvant qu'être à <code>null</code>.</p>
|
| +
|
| +
|
| +<h3><a name="REC_CATCH_EXCEPTION">REC: java.lang.Exception est intercepté alors qu'Exception n'est jamais lancé (REC_CATCH_EXCEPTION)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode utilise un block <code>try-catch</code> qui intercepte les objets <code>Exception</code>, mais <code>Exception</code> n'est jamais déclenché dans ce bloc, et <code>RuntimeException</code> n'est pas explicitement intercepté. C'est une erreur commune de dire que <code>try / catch (Exception e)</code> est identique à plusieurs <code>try / catch</code>, mais cette tournure intercepte également les <code>RuntimeException</code>, masquant des bugs potentiels.</p>
|
| +
|
| +
|
| +<h3><a name="RI_REDUNDANT_INTERFACES">RI: Classe implémentant la même interface que sa super-classe (RI_REDUNDANT_INTERFACES)</a></h3>
|
| +
|
| +
|
| +<p>Cette classe déclare implémenter une interface qui est aussi implémentée par une de ses classes mères. Ceci est redondant : dès qu'une super-classe implémente une interface, toutes les sous-classes le font aussi par défaut. Cela peut indiquer que la hiérarchie d'héritage a changé depuis la création de cette classe et la cible de l'implémentation de l'interface doit peut-être être reprise en considération.</p>
|
| +
|
| +
|
| +<h3><a name="RV_CHECK_FOR_POSITIVE_INDEXOF">RV: Méthode vérifiant que le résultat d'un String.indexOf() est positif (RV_CHECK_FOR_POSITIVE_INDEXOF)</a></h3>
|
| +
|
| +
|
| +<p>La méthode appelle <code>String.indexOf()</code> et vérifie si le résultat est strictement positif ou pas. Il est plus habituel de vérifier si le résultat est négatif. Il n'est strictement positif que lorsque la sous-chaine recherchée apparaît ailleurs qu'au début de la chaine.</p>
|
| +
|
| +
|
| +<h3><a name="RV_DONT_JUST_NULL_CHECK_READLINE">RV: Méthode ignorant le résultat d'un readLine() après avoir vérifié qu'il est non nul (RV_DONT_JUST_NULL_CHECK_READLINE)</a></h3>
|
| +
|
| +
|
| +<p>La valeur renvoyée par <code>readLine()</code> est ignorée après avoir vérifié s'il n'est pas à <code>null</code>. Dans quasiment tous les cas, si le résultat n'est pas à <code>null</code>, vous souhaiterez utiliser cette valeur. Appeler de nouveau <code>readLine()</code> vous renverra une ligne différente.</p>
|
| +
|
| +
|
| +<h3><a name="RV_REM_OF_HASHCODE">RV: Reste d'un hashCode pouvant être négatif (RV_REM_OF_HASHCODE)</a></h3>
|
| +
|
| +
|
| +<p>Ce code calcule le code de hachage, puis son reste modulo une certaine valeur. Puisque le code de hachage peut être négatif, le reste peut également l'être.</p>
|
| +<p>En supposant que vous vouliez garantir que le résultat de votre opération ne soit pas négatif, vous devriez modifier votre code. Si le diviseur est une puissance de 2, vous pourriez utiliser un décalage binaire à la place (c'est-à-dire <code>x.hashCode()&(n-1)</code> au lieu de <code>x.hashCode()%n</code>). Cela est probablement plus rapide que de calculer le reste. Si le diviseur n'est pas une puissance de 2, vous devriez prendre la valeur absolue du reste (<code>Math.abs(x.hashCode()%n)</code>).</p>
|
| +
|
| +
|
| +<h3><a name="RV_REM_OF_RANDOM_INT">RV: Reste d'un entier signé 32 bits aléeatoire (RV_REM_OF_RANDOM_INT)</a></h3>
|
| +
|
| +
|
| +<p>Ce code génère un entier signé aléatoire puis calcule le reste de cette valeur modulo une autre valeur. Puisque ce nombre aléatoire peut être négatif, le reste de l'opération peut également l'être. Soyez sûr que c'est voulu, et envisagez d'utiliser à la place la méthode <code>Random.nextInt(int)</code>.</p>
|
| +
|
| +
|
| +<h3><a name="RV_RETURN_VALUE_IGNORED_INFERRED">RV: Method ignores return value, is this OK? (RV_RETURN_VALUE_IGNORED_INFERRED)</a></h3>
|
| +
|
| +
|
| +<p>This code calls a method and ignores the return value. The return value
|
| +is the same type as the type the method is invoked on, and from our analysis it looks
|
| +like the return value might be important (e.g., like ignoring the
|
| +return value of <code>String.toLowerCase()</code>).
|
| +</p>
|
| +<p>We are guessing that ignoring the return value might be a bad idea just from
|
| +a simple analysis of the body of the method. You can use a @CheckReturnValue annotation
|
| +to instruct FindBugs as to whether ignoring the return value of this method
|
| +is important or acceptable.
|
| +</p>
|
| +<p>Please investigate this closely to decide whether it is OK to ignore the return value.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="SA_FIELD_DOUBLE_ASSIGNMENT">SA: Double assignment of field (SA_FIELD_DOUBLE_ASSIGNMENT)</a></h3>
|
| +
|
| +
|
| +<p> This method contains a double assignment of a field; e.g.
|
| +</p>
|
| +<pre>
|
| + int x,y;
|
| + public void foo() {
|
| + x = x = 17;
|
| + }
|
| +</pre>
|
| +<p>Assigning to a field twice is useless, and may indicate a logic error or typo.</p>
|
| +
|
| +
|
| +<h3><a name="SA_LOCAL_DOUBLE_ASSIGNMENT">SA: Double assignment of local variable (SA_LOCAL_DOUBLE_ASSIGNMENT)</a></h3>
|
| +
|
| +
|
| +<p> This method contains a double assignment of a local variable; e.g.
|
| +</p>
|
| +<pre>
|
| + public void foo() {
|
| + int x,y;
|
| + x = x = 17;
|
| + }
|
| +</pre>
|
| +<p>Assigning the same value to a variable twice is useless, and may indicate a logic error or typo.</p>
|
| +
|
| +
|
| +<h3><a name="SA_LOCAL_SELF_ASSIGNMENT">SA: Auto-alimentation d'une variable locale (SA_LOCAL_SELF_ASSIGNMENT)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient une auto-alimentation d'une variable locale, par exemple :</p>
|
| +<pre>
|
| +public vida foo() {
|
| + int x = 3;
|
| + x = x;
|
| +}
|
| +</pre>
|
| +<p>De telles affectations sont inutiles et peuvent indiquer une faute de frappe ou une erreur de logique.</p>
|
| +
|
| +
|
| +<h3><a name="SF_SWITCH_FALLTHROUGH">SF: Un switch comporte un cas qui déborde sur le suivant (SF_SWITCH_FALLTHROUGH)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient un <code>switch</code> dont l'un des cas déborde sur le suivant. Normalement, vous devez terminer chaque cas avec une instruction <code>break</code> ou <code>return</code>.</p>
|
| +
|
| +
|
| +<h3><a name="SF_SWITCH_NO_DEFAULT">SF: Switch statement found where default case is missing (SF_SWITCH_NO_DEFAULT)</a></h3>
|
| +
|
| +
|
| + <p> This method contains a switch statement where default case is missing.
|
| + Usually you need to provide a default case.</p>
|
| + <p>Because the analysis only looks at the generated bytecode, this warning can be incorrect triggered if
|
| +the default case is at the end of the switch statement and doesn't end with a break statement.
|
| +
|
| +
|
| +<h3><a name="ST_WRITE_TO_STATIC_FROM_INSTANCE_METHOD">ST: Ecriture d'un champ statique depuis la méthode d'une instance (ST_WRITE_TO_STATIC_FROM_INSTANCE_METHOD)</a></h3>
|
| +
|
| +
|
| +<p>La méthode de l'instance écrit la valeur d'un champ statique. Cela peut être difficile à gérer si plusieurs instances ont la possibilité d'écrire cette valeur et cela ressemble surtout à une mauvaise pratique.</p>
|
| +
|
| +
|
| +<h3><a name="SE_PRIVATE_READ_RESOLVE_NOT_INHERITED">Se: Private readResolve method not inherited by subclasses (SE_PRIVATE_READ_RESOLVE_NOT_INHERITED)</a></h3>
|
| +
|
| +
|
| + <p> This class defines a private readResolve method. Since it is private, it won't be inherited by subclasses.
|
| +This might be intentional and OK, but should be reviewed to ensure it is what is intended.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="SE_TRANSIENT_FIELD_OF_NONSERIALIZABLE_CLASS">Se: Transient field of class that isn't Serializable. (SE_TRANSIENT_FIELD_OF_NONSERIALIZABLE_CLASS)</a></h3>
|
| +
|
| +
|
| + <p> The field is marked as transient, but the class isn't Serializable, so marking it as transient
|
| +has absolutely no effect.
|
| +This may be leftover marking from a previous version of the code in which the class was transient, or
|
| +it may indicate a misunderstanding of how serialization works.
|
| +</p>
|
| +
|
| +
|
| +<h3><a name="TQ_EXPLICIT_UNKNOWN_SOURCE_VALUE_REACHES_ALWAYS_SINK">TQ: Value required to have type qualifier, but marked as unknown (TQ_EXPLICIT_UNKNOWN_SOURCE_VALUE_REACHES_ALWAYS_SINK)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + A value is used in a way that requires it to be always be a value denoted by a type qualifier, but
|
| + there is an explicit annotation stating that it is not known where the value is required to have that type qualifier.
|
| + Either the usage or the annotation is incorrect.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="TQ_EXPLICIT_UNKNOWN_SOURCE_VALUE_REACHES_NEVER_SINK">TQ: Value required to not have type qualifier, but marked as unknown (TQ_EXPLICIT_UNKNOWN_SOURCE_VALUE_REACHES_NEVER_SINK)</a></h3>
|
| +
|
| +
|
| + <p>
|
| + A value is used in a way that requires it to be never be a value denoted by a type qualifier, but
|
| + there is an explicit annotation stating that it is not known where the value is prohibited from having that type qualifier.
|
| + Either the usage or the annotation is incorrect.
|
| + </p>
|
| +
|
| +
|
| +<h3><a name="UCF_USELESS_CONTROL_FLOW">UCF: Instruction de contrôle du flux inutile (UCF_USELESS_CONTROL_FLOW)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode contient une instruction de contrôle du flux inutile. Ceci est souvent provoqué par inadvertance, en utilisant un paragraphe vide comme corps d'une condition. Exemple :</p>
|
| +<pre>
|
| +if (argv.length == 1);
|
| + System.out.println("Hello, " + argv[0]);
|
| +</pre>
|
| +
|
| +
|
| +<h3><a name="UCF_USELESS_CONTROL_FLOW_NEXT_LINE">UCF: Useless control flow to next line (UCF_USELESS_CONTROL_FLOW_NEXT_LINE)</a></h3>
|
| +
|
| +
|
| +<p> This method contains a useless control flow statement in which control
|
| +flow follows to the same or following line regardless of whether or not
|
| +the branch is taken.
|
| +Often, this is caused by inadvertently using an empty statement as the
|
| +body of an <code>if</code> statement, e.g.:</p>
|
| +<pre>
|
| + if (argv.length == 1);
|
| + System.out.println("Hello, " + argv[0]);
|
| +</pre>
|
| +
|
| +
|
| +<h3><a name="URF_UNREAD_PUBLIC_OR_PROTECTED_FIELD">UrF: Unread public/protected field (URF_UNREAD_PUBLIC_OR_PROTECTED_FIELD)</a></h3>
|
| +
|
| +
|
| + <p> This field is never read.
|
| +The field is public or protected, so perhaps
|
| + it is intended to be used with classes not seen as part of the analysis. If not,
|
| +consider removing it from the class.</p>
|
| +
|
| +
|
| +<h3><a name="UUF_UNUSED_PUBLIC_OR_PROTECTED_FIELD">UuF: Unused public or protected field (UUF_UNUSED_PUBLIC_OR_PROTECTED_FIELD)</a></h3>
|
| +
|
| +
|
| + <p> This field is never used.
|
| +The field is public or protected, so perhaps
|
| + it is intended to be used with classes not seen as part of the analysis. If not,
|
| +consider removing it from the class.</p>
|
| +
|
| +
|
| +<h3><a name="UWF_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR">UwF: Champ non initialisé dans le constructeur (UWF_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR)</a></h3>
|
| +
|
| +
|
| +<p>Ce champ n'est jamais initialisé dans aucun constructeur, et est de ce fait <code>null</code> une fois l'objet initialisé. Soit il s'agit d'une erreur, soit il s'agit d'un design douteux puisque ce champ génèra une exception s'il est déréférencé avant toute initialisation.</p>
|
| +
|
| +
|
| +<h3><a name="UWF_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD">UwF: Unwritten public or protected field (UWF_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD)</a></h3>
|
| +
|
| +
|
| + <p> No writes were seen to this public/protected field. All reads of it will return the default
|
| +value. Check for errors (should it have been initialized?), or remove it if it is useless.</p>
|
| +
|
| +
|
| +<h3><a name="XFB_XML_FACTORY_BYPASS">XFB: Méthode instanciant directement une implémentation spécifique des interfaces XML (XFB_XML_FACTORY_BYPASS)</a></h3>
|
| +
|
| +
|
| +<p>Cette méthode instancie une implémentation spécifique de l'interface XML. Il est préférable d'utiliser les classes 'Factory' fournies pour créer ces objets, ce qui permet de changer d'implémentation à l'exécution. Pour des détails, cf. :</p>
|
| +<p>
|
| +<ul>
|
| + <li>javax.xml.parsers.DocumentBuilderFactory</li>
|
| + <li>javax.xml.parsers.SAXParserFactory</li>
|
| + <li>javax.xml.transform.TransformerFactory</li>
|
| + <li>org.w3c.dom.Document.create<i>XXXX</i></li>
|
| +</ul>
|
| +</p>
|
| +
|
| +
|
| +
|
| +
|
| +<hr> <p>
|
| +<script language="JavaScript" type="text/javascript">
|
| +<!---//hide script from old browsers
|
| +document.write( "Last updated "+ document.lastModified + "." );
|
| +//end hiding contents --->
|
| +</script>
|
| +<p> Send comments to <a class="sidebar" href="mailto:findbugs@cs.umd.edu">findbugs@cs.umd.edu</a>
|
| +<p>
|
| +<A href="http://sourceforge.net"><IMG src="http://sourceforge.net/sflogo.php?group_id=96405&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>
|
| +</td></tr></table>
|
| +</body></html>
|
|
|
Chromium Code Reviews
Issue 594833004:
Roll FindBugs from 2.0.3 to 3.0.0 (Closed)
Base URL: https://chromium.googlesource.com/chromium/deps/findbugs.git@master