Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(364)

Side by Side Diff: doc/bugDescriptions_fr.html

Issue 1232833004: Update findbugs from 3.0.0 to 3.0.1. (Closed) Base URL: https://chromium.googlesource.com/chromium/deps/findbugs.git@master
Patch Set: Created 5 years, 5 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
(Empty)
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.or g/TR/html4/loose.dtd">
2 <html><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8">
3 <title>FindBugs Bug Descriptions</title>
4 <link rel="stylesheet" type="text/css" href="findbugs.css"/>
5 <link rel="shortcut icon" href="favicon.ico" type="image/x-icon"/>
6 </head><body>
7
8 <table width="100%"><tr>
9
10 <td bgcolor="#b9b9fe" valign="top" align="left" width="20%">
11 <table width="100%" cellspacing="0" border="0">
12 <tr><td><a class="sidebar" href="index.html"><img src="umdFindbugs.png" alt="Fin dBugs"></a></td></tr>
13
14 <tr><td>&nbsp;</td></tr>
15
16 <tr><td><b>Docs and Info</b></td></tr>
17 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="findbugs2.html">FindBugs 2.0</a></font></td></tr>
18 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="demo.html">Demo and data< /a></font></td></tr>
19 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="users.html">Users and sup porters</a></font></td></tr>
20 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="http://findbugs.blogspot. com/">FindBugs blog</a></font></td></tr>
21 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="factSheet.html">Fact shee t</a></font></td></tr>
22 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="manual/index.html">Manual </a></font></td></tr>
23 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="ja/manual/index.html">Man ual(ja/&#26085;&#26412;&#35486;)</a></font></td></tr>
24 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="FAQ.html">FAQ</a></font>< /td></tr>
25 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="bugDescriptions.html">Bug descriptions</a></font></td></tr>
26 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="bugDescriptions_ja.html"> Bug descriptions(ja/&#26085;&#26412;&#35486;)</a></font></td></tr>
27 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="bugDescriptions_fr.html"> Bug descriptions(fr)</a></font></td></tr>
28 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="mailingLists.html">Mailin g lists</a></font></td></tr>
29 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="publications.html">Docume nts and Publications</a></font></td></tr>
30 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="links.html">Links</a></fo nt></td></tr>
31
32 <tr><td>&nbsp;</td></tr>
33
34 <tr><td><a class="sidebar" href="downloads.html"><b>Downloads</b></a></td></tr>
35
36 <tr><td>&nbsp;</td></tr>
37
38 <tr><td><a class="sidebar" href="http://www.cafeshops.com/findbugs"><b>FindBugs Swag</b></a></td></tr>
39
40 <tr><td>&nbsp;</td></tr>
41
42 <tr><td><b>Development</b></td></tr>
43 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="http://sourceforge.net/p/ findbugs/bugs/">Open bugs</a></font></td></tr>
44 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="reportingBugs.html">Repor ting bugs</a></font></td></tr>
45 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="contributing.html">Contri buting</a></font></td></tr>
46 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="team.html">Dev team</a></ font></td></tr>
47 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="api/index.html">API</a> < a class="sidebar" href="api/overview-summary.html">[no frames]</a></font></td></ tr>
48 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="Changes.html">Change log< /a></font></td></tr>
49 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="http://sourceforge.net/pr ojects/findbugs">SF project page</a></font></td></tr>
50 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="http://code.google.com/p/ findbugs/source/browse/">Browse source</a></font></td></tr>
51 <tr><td><font size="-1">&nbsp;<a class="sidebar" href="http://code.google.com/p/ findbugs/source/list">Latest code changes</a></font></td></tr>
52 </table>
53 </td>
54 <td align="left" valign="top">
55 <h1>FindBugs Bug Descriptions</h1>
56 <p>This document lists the standard bug patterns reported by
57 <a href="http://findbugs.sourceforge.net">FindBugs</a> version 3.0.1.</p>
58 <h2>Summary</h2>
59 <table width="100%">
60 <tr bgcolor="#b9b9fe"><th>Description</th><th>Category</th></tr>
61 <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>
62 <tr bgcolor="#ffffff"><td><a href="#BIT_SIGNED_CHECK">BIT: Check for sign of bit wise operation</a></td><td>Bad practice</td></tr>
63 <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</t d></tr>
64 <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>
65 <tr bgcolor="#eeeeee"><td><a href="#CN_IMPLEMENTS_CLONE_BUT_NOT_CLONEABLE">CN: C lass defines clone() but doesn't implement Cloneable</a></td><td>Bad practice</t d></tr>
66 <tr bgcolor="#ffffff"><td><a href="#CNT_ROUGH_CONSTANT_VALUE">CNT: Rough value o f known constant found</a></td><td>Bad practice</td></tr>
67 <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>
68 <tr bgcolor="#ffffff"><td><a href="#CO_COMPARETO_INCORRECT_FLOATING">Co: compare To()/compare() incorrectly handles float or double value</a></td><td>Bad practic e</td></tr>
69 <tr bgcolor="#eeeeee"><td><a href="#CO_COMPARETO_RESULTS_MIN_VALUE">Co: compareT o()/compare() returns Integer.MIN_VALUE</a></td><td>Bad practice</td></tr>
70 <tr bgcolor="#ffffff"><td><a href="#CO_SELF_NO_OBJECT">Co: Définition d'une méth ode compareTo() covariante</a></td><td>Bad practice</td></tr>
71 <tr bgcolor="#eeeeee"><td><a href="#DE_MIGHT_DROP">DE: La méthode peut déclenche r une exception</a></td><td>Bad practice</td></tr>
72 <tr bgcolor="#ffffff"><td><a href="#DE_MIGHT_IGNORE">DE: La méthode peut ignorer une exception</a></td><td>Bad practice</td></tr>
73 <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>
74 <tr bgcolor="#ffffff"><td><a href="#DMI_RANDOM_USED_ONLY_ONCE">DMI: Random objec t created and used only once</a></td><td>Bad practice</td></tr>
75 <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>
76 <tr bgcolor="#ffffff"><td><a href="#DM_EXIT">Dm: La méthode invoque System.exit( ...)</a></td><td>Bad practice</td></tr>
77 <tr bgcolor="#eeeeee"><td><a href="#DM_RUN_FINALIZERS_ON_EXIT">Dm: Méthode invoq uant runFinalizersOnExit, l'une des plus dangeureuses méthodes des librairies Ja va</a></td><td>Bad practice</td></tr>
78 <tr bgcolor="#ffffff"><td><a href="#ES_COMPARING_PARAMETER_STRING_WITH_EQ">ES: C omparison of String parameter using == or !=</a></td><td>Bad practice</td></tr>
79 <tr bgcolor="#eeeeee"><td><a href="#ES_COMPARING_STRINGS_WITH_EQ">ES: Comparaiso n d'objets String utilisant == ou !=</a></td><td>Bad practice</td></tr>
80 <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>
81 <tr bgcolor="#eeeeee"><td><a href="#EQ_CHECK_FOR_OPERAND_NOT_COMPATIBLE_WITH_THI S">Eq: Equals checks for incompatible operand</a></td><td>Bad practice</td></tr>
82 <tr bgcolor="#ffffff"><td><a href="#EQ_COMPARETO_USE_OBJECT_EQUALS">Eq: Class de fines compareTo(...) and uses Object.equals()</a></td><td>Bad practice</td></tr>
83 <tr bgcolor="#eeeeee"><td><a href="#EQ_GETCLASS_AND_CLASS_CONSTANT">Eq: equals m ethod fails for subtypes</a></td><td>Bad practice</td></tr>
84 <tr bgcolor="#ffffff"><td><a href="#EQ_SELF_NO_OBJECT">Eq: Définition d'une méth ode equals() covariante</a></td><td>Bad practice</td></tr>
85 <tr bgcolor="#eeeeee"><td><a href="#FI_EMPTY">FI: Un finaliseur vide devrait êtr e supprimé</a></td><td>Bad practice</td></tr>
86 <tr bgcolor="#ffffff"><td><a href="#FI_EXPLICIT_INVOCATION">FI: Invocation expli cite d'un finaliseur</a></td><td>Bad practice</td></tr>
87 <tr bgcolor="#eeeeee"><td><a href="#FI_FINALIZER_NULLS_FIELDS">FI: Finalizer nul ls fields</a></td><td>Bad practice</td></tr>
88 <tr bgcolor="#ffffff"><td><a href="#FI_FINALIZER_ONLY_NULLS_FIELDS">FI: Finalize r only nulls fields</a></td><td>Bad practice</td></tr>
89 <tr bgcolor="#eeeeee"><td><a href="#FI_MISSING_SUPER_CALL">FI: Le finaliseur n'a ppelle pas le finaliseur de la super-classe</a></td><td>Bad practice</td></tr>
90 <tr bgcolor="#ffffff"><td><a href="#FI_NULLIFY_SUPER">FI: Un finaliseur rend inu tile celui de sa super-classe</a></td><td>Bad practice</td></tr>
91 <tr bgcolor="#eeeeee"><td><a href="#FI_USELESS">FI: Le finaliseur ne fait rien s auf appeler celui de la super-classe</a></td><td>Bad practice</td></tr>
92 <tr bgcolor="#ffffff"><td><a href="#VA_FORMAT_STRING_USES_NEWLINE">FS: Format st ring should use %n rather than \n</a></td><td>Bad practice</td></tr>
93 <tr bgcolor="#eeeeee"><td><a href="#GC_UNCHECKED_TYPE_IN_GENERIC_CALL">GC: Unche cked type in generic call</a></td><td>Bad practice</td></tr>
94 <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>
95 <tr bgcolor="#eeeeee"><td><a href="#HE_EQUALS_USE_HASHCODE">HE: La classe défini t equals() et utilise Object.hashCode()</a></td><td>Bad practice</td></tr>
96 <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>
97 <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 >
98 <tr bgcolor="#ffffff"><td><a href="#HE_INHERITS_EQUALS_USE_HASHCODE">HE: La clas se hérite de equals() et utilise Object.hashCode()</a></td><td>Bad practice</td> </tr>
99 <tr bgcolor="#eeeeee"><td><a href="#IC_SUPERCLASS_USES_SUBCLASS_DURING_INITIALIZ ATION">IC: Classe mère utilisant une sous-classe durant son initialisation</a></ td><td>Bad practice</td></tr>
100 <tr bgcolor="#ffffff"><td><a href="#IMSE_DONT_CATCH_IMSE">IMSE: Interception dou teuse d'une IllegalMonitorStateException</a></td><td>Bad practice</td></tr>
101 <tr bgcolor="#eeeeee"><td><a href="#ISC_INSTANTIATE_STATIC_CLASS">ISC: Instantia tion inutile d'une classe qui n'a que des méthodes statiques</a></td><td>Bad pra ctice</td></tr>
102 <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 pra ctice</td></tr>
103 <tr bgcolor="#eeeeee"><td><a href="#J2EE_STORE_OF_NON_SERIALIZABLE_OBJECT_INTO_S ESSION">J2EE: Stockage d'un objet non serialisable dans une session Http</a></td ><td>Bad practice</td></tr>
104 <tr bgcolor="#ffffff"><td><a href="#JCIP_FIELD_ISNT_FINAL_IN_IMMUTABLE_CLASS">JC IP: Les champs d'une classe immuable devraient être finaux.</a></td><td>Bad prac tice</td></tr>
105 <tr bgcolor="#eeeeee"><td><a href="#ME_ENUM_FIELD_SETTER">ME: Public enum method unconditionally sets its field</a></td><td>Bad practice</td></tr>
106 <tr bgcolor="#ffffff"><td><a href="#ME_MUTABLE_ENUM_FIELD">ME: Enum field is pub lic and mutable</a></td><td>Bad practice</td></tr>
107 <tr bgcolor="#eeeeee"><td><a href="#NP_BOOLEAN_RETURN_NULL">NP: Method with Bool ean return type returns explicit null</a></td><td>Bad practice</td></tr>
108 <tr bgcolor="#ffffff"><td><a href="#NP_CLONE_COULD_RETURN_NULL">NP: Clone method may return null</a></td><td>Bad practice</td></tr>
109 <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>
110 <tr bgcolor="#ffffff"><td><a href="#NP_TOSTRING_COULD_RETURN_NULL">NP: toString method may return null</a></td><td>Bad practice</td></tr>
111 <tr bgcolor="#eeeeee"><td><a href="#NM_CLASS_NAMING_CONVENTION">Nm: Nom de class e devant commencer par une majuscule</a></td><td>Bad practice</td></tr>
112 <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>
113 <tr bgcolor="#eeeeee"><td><a href="#NM_CONFUSING">Nm: Noms de méthodes ambigus</ a></td><td>Bad practice</td></tr>
114 <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>
115 <tr bgcolor="#eeeeee"><td><a href="#NM_FUTURE_KEYWORD_USED_AS_IDENTIFIER">Nm: Us e of identifier that is a keyword in later versions of Java</a></td><td>Bad prac tice</td></tr>
116 <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>B ad practice</td></tr>
117 <tr bgcolor="#eeeeee"><td><a href="#NM_METHOD_NAMING_CONVENTION">Nm: Nom de méth ode devant commencer par une minuscule</a></td><td>Bad practice</td></tr>
118 <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 prac tice</td></tr>
119 <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>
120 <tr bgcolor="#ffffff"><td><a href="#NM_VERY_CONFUSING_INTENTIONAL">Nm: Very conf using method names (but perhaps intentional)</a></td><td>Bad practice</td></tr>
121 <tr bgcolor="#eeeeee"><td><a href="#NM_WRONG_PACKAGE_INTENTIONAL">Nm: Method doe sn't override method in superclass due to wrong package for parameter</a></td><t d>Bad practice</td></tr>
122 <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>
123 <tr bgcolor="#eeeeee"><td><a href="#ODR_OPEN_DATABASE_RESOURCE_EXCEPTION_PATH">O DR: La méthode peut ne pas fermer une ressource base de données sur une exceptio n</a></td><td>Bad practice</td></tr>
124 <tr bgcolor="#ffffff"><td><a href="#OS_OPEN_STREAM">OS: La méthode peut ne pas f ermer un flux</a></td><td>Bad practice</td></tr>
125 <tr bgcolor="#eeeeee"><td><a href="#OS_OPEN_STREAM_EXCEPTION_PATH">OS: La méthod e peut oublier de fermer un flux en cas d'exception</a></td><td>Bad practice</td ></tr>
126 <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>
127 <tr bgcolor="#eeeeee"><td><a href="#RC_REF_COMPARISON_BAD_PRACTICE">RC: Suspicio us reference comparison to constant</a></td><td>Bad practice</td></tr>
128 <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>
129 <tr bgcolor="#eeeeee"><td><a href="#RR_NOT_CHECKED">RR: La méthode ignore le rés ultat de InputStream.read()</a></td><td>Bad practice</td></tr>
130 <tr bgcolor="#ffffff"><td><a href="#SR_NOT_CHECKED">RR: La méthode ignore le rés ultat de InputStream.skip()</a></td><td>Bad practice</td></tr>
131 <tr bgcolor="#eeeeee"><td><a href="#RV_NEGATING_RESULT_OF_COMPARETO">RV: Negatin g the result of compareTo()/compare()</a></td><td>Bad practice</td></tr>
132 <tr bgcolor="#ffffff"><td><a href="#RV_RETURN_VALUE_IGNORED_BAD_PRACTICE">RV: Me thod ignores exceptional return value</a></td><td>Bad practice</td></tr>
133 <tr bgcolor="#eeeeee"><td><a href="#SI_INSTANCE_BEFORE_FINALS_ASSIGNED">SI: Init ialiseur statique de classe créant une instance avant que tous les champs static final soient alimentés</a></td><td>Bad practice</td></tr>
134 <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>
135 <tr bgcolor="#eeeeee"><td><a href="#SE_BAD_FIELD">Se: Champ d'instance non trans ient et non sérialisable dans une classe sérialisable</a></td><td>Bad practice</ td></tr>
136 <tr bgcolor="#ffffff"><td><a href="#SE_BAD_FIELD_INNER_CLASS">Se: Non-serializab le class has a serializable inner class</a></td><td>Bad practice</td></tr>
137 <tr bgcolor="#eeeeee"><td><a href="#SE_BAD_FIELD_STORE">Se: Valeur non sérialisa ble stockée dans un champ d'instance de classe sérialisable</a></td><td>Bad prac tice</td></tr>
138 <tr bgcolor="#ffffff"><td><a href="#SE_COMPARATOR_SHOULD_BE_SERIALIZABLE">Se: Co mparateur n'implémentant pas Serializable</a></td><td>Bad practice</td></tr>
139 <tr bgcolor="#eeeeee"><td><a href="#SE_INNER_CLASS">Se: Serializable inner class </a></td><td>Bad practice</td></tr>
140 <tr bgcolor="#ffffff"><td><a href="#SE_NONFINAL_SERIALVERSIONID">Se: serialVersi onUID n'est pas final</a></td><td>Bad practice</td></tr>
141 <tr bgcolor="#eeeeee"><td><a href="#SE_NONLONG_SERIALVERSIONID">Se: serialVersio nUID n'est pas de type long</a></td><td>Bad practice</td></tr>
142 <tr bgcolor="#ffffff"><td><a href="#SE_NONSTATIC_SERIALVERSIONID">Se: serialVers ionUID n'est pas static</a></td><td>Bad practice</td></tr>
143 <tr bgcolor="#eeeeee"><td><a href="#SE_NO_SUITABLE_CONSTRUCTOR">Se: La classe es t Serializable mais sa super-classe ne possède pas de constructeur par défaut vi sible</a></td><td>Bad practice</td></tr>
144 <tr bgcolor="#ffffff"><td><a href="#SE_NO_SUITABLE_CONSTRUCTOR_FOR_EXTERNALIZATI ON">Se: La classe est Externalizable mais ne définit pas de constructeur par déf aut</a></td><td>Bad practice</td></tr>
145 <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>
146 <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</t d></tr>
147 <tr bgcolor="#eeeeee"><td><a href="#SE_NO_SERIALVERSIONID">SnVI: La classe est S erializable, mais ne définit pas serialVersionUID</a></td><td>Bad practice</td>< /tr>
148 <tr bgcolor="#ffffff"><td><a href="#UI_INHERITANCE_UNSAFE_GETRESOURCE">UI: L'uti lisation de GetResource peut-être instable si la classe est étendue</a></td><td> Bad practice</td></tr>
149 <tr bgcolor="#eeeeee"><td><a href="#BC_IMPOSSIBLE_CAST">BC: Transtypage impossib le</a></td><td>Correctness</td></tr>
150 <tr bgcolor="#ffffff"><td><a href="#BC_IMPOSSIBLE_DOWNCAST">BC: Impossible downc ast</a></td><td>Correctness</td></tr>
151 <tr bgcolor="#eeeeee"><td><a href="#BC_IMPOSSIBLE_DOWNCAST_OF_TOARRAY">BC: Impos sible downcast of toArray() result</a></td><td>Correctness</td></tr>
152 <tr bgcolor="#ffffff"><td><a href="#BC_IMPOSSIBLE_INSTANCEOF">BC: instanceof ren verra toujours faux</a></td><td>Correctness</td></tr>
153 <tr bgcolor="#eeeeee"><td><a href="#BIT_ADD_OF_SIGNED_BYTE">BIT: Bitwise add of signed byte value</a></td><td>Correctness</td></tr>
154 <tr bgcolor="#ffffff"><td><a href="#BIT_AND">BIT: Masques binaires incompatibles </a></td><td>Correctness</td></tr>
155 <tr bgcolor="#eeeeee"><td><a href="#BIT_AND_ZZ">BIT: Masques binaires incompatib les</a></td><td>Correctness</td></tr>
156 <tr bgcolor="#ffffff"><td><a href="#BIT_IOR">BIT: Masques binaires incompatibles </a></td><td>Correctness</td></tr>
157 <tr bgcolor="#eeeeee"><td><a href="#BIT_IOR_OF_SIGNED_BYTE">BIT: Ou binaire d'un octet signé</a></td><td>Correctness</td></tr>
158 <tr bgcolor="#ffffff"><td><a href="#BIT_SIGNED_CHECK_HIGH_BIT">BIT: Check for si gn of bitwise operation</a></td><td>Correctness</td></tr>
159 <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>
160 <tr bgcolor="#ffffff"><td><a href="#BSHIFT_WRONG_ADD_PRIORITY">BSHIFT: Possible bad parsing of shift operation</a></td><td>Correctness</td></tr>
161 <tr bgcolor="#eeeeee"><td><a href="#ICAST_BAD_SHIFT_AMOUNT">BSHIFT: Décalage d'u n int hors de proportion (0..31)</a></td><td>Correctness</td></tr>
162 <tr bgcolor="#ffffff"><td><a href="#DLS_DEAD_LOCAL_INCREMENT_IN_RETURN">DLS: Use less increment in return statement</a></td><td>Correctness</td></tr>
163 <tr bgcolor="#eeeeee"><td><a href="#DLS_DEAD_STORE_OF_CLASS_LITERAL">DLS: Dead s tore of class literal</a></td><td>Correctness</td></tr>
164 <tr bgcolor="#ffffff"><td><a href="#DLS_OVERWRITTEN_INCREMENT">DLS: Incrémentati on annulée</a></td><td>Correctness</td></tr>
165 <tr bgcolor="#eeeeee"><td><a href="#DMI_ARGUMENTS_WRONG_ORDER">DMI: Reversed met hod arguments</a></td><td>Correctness</td></tr>
166 <tr bgcolor="#ffffff"><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>
167 <tr bgcolor="#eeeeee"><td><a href="#DMI_BIGDECIMAL_CONSTRUCTED_FROM_DOUBLE">DMI: BigDecimal constructed from double that isn't represented precisely</a></td><td >Correctness</td></tr>
168 <tr bgcolor="#ffffff"><td><a href="#DMI_CALLING_NEXT_FROM_HASNEXT">DMI: Méthode hasNext() appelant next()</a></td><td>Correctness</td></tr>
169 <tr bgcolor="#eeeeee"><td><a href="#DMI_COLLECTIONS_SHOULD_NOT_CONTAIN_THEMSELVE S">DMI: Collections should not contain themselves</a></td><td>Correctness</td></ tr>
170 <tr bgcolor="#ffffff"><td><a href="#DMI_DOH">DMI: D'oh! A nonsensical method inv ocation</a></td><td>Correctness</td></tr>
171 <tr bgcolor="#eeeeee"><td><a href="#DMI_INVOKING_HASHCODE_ON_ARRAY">DMI: Invocat ion of hashCode on an array</a></td><td>Correctness</td></tr>
172 <tr bgcolor="#ffffff"><td><a href="#DMI_LONG_BITS_TO_DOUBLE_INVOKED_ON_INT">DMI: Double.longBitsToDouble invoked on an int</a></td><td>Correctness</td></tr>
173 <tr bgcolor="#eeeeee"><td><a href="#DMI_VACUOUS_SELF_COLLECTION_CALL">DMI: Vacuo us call to collections</a></td><td>Correctness</td></tr>
174 <tr bgcolor="#ffffff"><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 anno tation avec la rétention par défaut</a></td><td>Correctness</td></tr>
175 <tr bgcolor="#eeeeee"><td><a href="#DMI_FUTILE_ATTEMPT_TO_CHANGE_MAXPOOL_SIZE_OF _SCHEDULED_THREAD_POOL_EXECUTOR">Dm: Futile attempt to change max pool size of S cheduledThreadPoolExecutor</a></td><td>Correctness</td></tr>
176 <tr bgcolor="#ffffff"><td><a href="#DMI_SCHEDULED_THREAD_POOL_EXECUTOR_WITH_ZERO _CORE_THREADS">Dm: Creation of ScheduledThreadPoolExecutor with zero core thread s</a></td><td>Correctness</td></tr>
177 <tr bgcolor="#eeeeee"><td><a href="#DMI_VACUOUS_CALL_TO_EASYMOCK_METHOD">Dm: Use less/vacuous call to EasyMock method</a></td><td>Correctness</td></tr>
178 <tr bgcolor="#ffffff"><td><a href="#DM_INVALID_MIN_MAX">Dm: Incorrect combinatio n of Math.max and Math.min</a></td><td>Correctness</td></tr>
179 <tr bgcolor="#eeeeee"><td><a href="#EC_ARRAY_AND_NONARRAY">EC: Utilisation de eq uals() pour comparer un tableau et un objet</a></td><td>Correctness</td></tr>
180 <tr bgcolor="#ffffff"><td><a href="#EC_BAD_ARRAY_COMPARE">EC: Appel à equals() s ur un tableau équivalent à ==</a></td><td>Correctness</td></tr>
181 <tr bgcolor="#eeeeee"><td><a href="#EC_INCOMPATIBLE_ARRAY_COMPARE">EC: equals(.. .) used to compare incompatible arrays</a></td><td>Correctness</td></tr>
182 <tr bgcolor="#ffffff"><td><a href="#EC_NULL_ARG">EC: Appel de equals() avec un a rgument à null</a></td><td>Correctness</td></tr>
183 <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>Corr ectness</td></tr>
184 <tr bgcolor="#ffffff"><td><a href="#EC_UNRELATED_INTERFACES">EC: Appel de equals () comparant différentes interfaces</a></td><td>Correctness</td></tr>
185 <tr bgcolor="#eeeeee"><td><a href="#EC_UNRELATED_TYPES">EC: Appel de equals() co mparant des types différents</a></td><td>Correctness</td></tr>
186 <tr bgcolor="#ffffff"><td><a href="#EC_UNRELATED_TYPES_USING_POINTER_EQUALITY">E C: Using pointer equality to compare different types</a></td><td>Correctness</td ></tr>
187 <tr bgcolor="#eeeeee"><td><a href="#EQ_ALWAYS_FALSE">Eq: equals method always re turns false</a></td><td>Correctness</td></tr>
188 <tr bgcolor="#ffffff"><td><a href="#EQ_ALWAYS_TRUE">Eq: equals method always ret urns true</a></td><td>Correctness</td></tr>
189 <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>
190 <tr bgcolor="#ffffff"><td><a href="#EQ_DONT_DEFINE_EQUALS_FOR_ENUM">Eq: Covarian t equals() method defined for enum</a></td><td>Correctness</td></tr>
191 <tr bgcolor="#eeeeee"><td><a href="#EQ_OTHER_NO_OBJECT">Eq: equals() method defi ned that doesn't override equals(Object)</a></td><td>Correctness</td></tr>
192 <tr bgcolor="#ffffff"><td><a href="#EQ_OTHER_USE_OBJECT">Eq: equals() method def ined that doesn't override Object.equals(Object)</a></td><td>Correctness</td></t r>
193 <tr bgcolor="#eeeeee"><td><a href="#EQ_OVERRIDING_EQUALS_NOT_SYMMETRIC">Eq: equa ls method overrides equals in superclass and may not be symmetric</a></td><td>Co rrectness</td></tr>
194 <tr bgcolor="#ffffff"><td><a href="#EQ_SELF_USE_OBJECT">Eq: Définition d'une mét hode equals() covariante, Object.equals(Object) est hérité</a></td><td>Correctne ss</td></tr>
195 <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>
196 <tr bgcolor="#ffffff"><td><a href="#VA_FORMAT_STRING_BAD_ARGUMENT">FS: Format st ring placeholder incompatible with passed argument</a></td><td>Correctness</td>< /tr>
197 <tr bgcolor="#eeeeee"><td><a href="#VA_FORMAT_STRING_BAD_CONVERSION">FS: The typ e of a supplied argument doesn't match format specifier</a></td><td>Correctness< /td></tr>
198 <tr bgcolor="#ffffff"><td><a href="#VA_FORMAT_STRING_EXPECTED_MESSAGE_FORMAT_SUP PLIED">FS: MessageFormat supplied where printf style format expected</a></td><td >Correctness</td></tr>
199 <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>
200 <tr bgcolor="#ffffff"><td><a href="#VA_FORMAT_STRING_ILLEGAL">FS: Illegal format string</a></td><td>Correctness</td></tr>
201 <tr bgcolor="#eeeeee"><td><a href="#VA_FORMAT_STRING_MISSING_ARGUMENT">FS: Forma t string references missing argument</a></td><td>Correctness</td></tr>
202 <tr bgcolor="#ffffff"><td><a href="#VA_FORMAT_STRING_NO_PREVIOUS_ARGUMENT">FS: N o previous argument for format string</a></td><td>Correctness</td></tr>
203 <tr bgcolor="#eeeeee"><td><a href="#GC_UNRELATED_TYPES">GC: No relationship betw een generic parameter and method argument</a></td><td>Correctness</td></tr>
204 <tr bgcolor="#ffffff"><td><a href="#HE_SIGNATURE_DECLARES_HASHING_OF_UNHASHABLE_ CLASS">HE: Signature declares use of unhashable class in hashed construct</a></t d><td>Correctness</td></tr>
205 <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>
206 <tr bgcolor="#ffffff"><td><a href="#ICAST_INT_2_LONG_AS_INSTANT">ICAST: int valu e converted to long and used as absolute time</a></td><td>Correctness</td></tr>
207 <tr bgcolor="#eeeeee"><td><a href="#ICAST_INT_CAST_TO_DOUBLE_PASSED_TO_CEIL">ICA ST: Valeur entière transtypée en nombre flottant passée à Math.ceil</a></td><td> Correctness</td></tr>
208 <tr bgcolor="#ffffff"><td><a href="#ICAST_INT_CAST_TO_FLOAT_PASSED_TO_ROUND">ICA ST: Valeur entière transtypée en flottant puis transmise à Math.round</a></td><t d>Correctness</td></tr>
209 <tr bgcolor="#eeeeee"><td><a href="#IJU_ASSERT_METHOD_INVOKED_FROM_RUN_METHOD">I JU: JUnit assertion in run method will not be noticed by JUnit</a></td><td>Corre ctness</td></tr>
210 <tr bgcolor="#ffffff"><td><a href="#IJU_BAD_SUITE_METHOD">IJU: TestCase declares a bad suite method </a></td><td>Correctness</td></tr>
211 <tr bgcolor="#eeeeee"><td><a href="#IJU_NO_TESTS">IJU: TestCase sans tests</a></ td><td>Correctness</td></tr>
212 <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>Correctne ss</td></tr>
213 <tr bgcolor="#eeeeee"><td><a href="#IJU_SUITE_NOT_STATIC">IJU: Une classe dériva nt de TestCase implémente une méthode suite() non statique</a></td><td>Correctne ss</td></tr>
214 <tr bgcolor="#ffffff"><td><a href="#IJU_TEARDOWN_NO_SUPER">IJU: Une classe dériv ant de TestCase implémente tearDown() sans appeler super.tearDown()</a></td><td> Correctness</td></tr>
215 <tr bgcolor="#eeeeee"><td><a href="#IL_CONTAINER_ADDED_TO_ITSELF">IL: Un contene ur est ajouté à lui-même</a></td><td>Correctness</td></tr>
216 <tr bgcolor="#ffffff"><td><a href="#IL_INFINITE_LOOP">IL: Boucle apparemment ini finie</a></td><td>Correctness</td></tr>
217 <tr bgcolor="#eeeeee"><td><a href="#IL_INFINITE_RECURSIVE_LOOP">IL: Boucle récur sive infinie</a></td><td>Correctness</td></tr>
218 <tr bgcolor="#ffffff"><td><a href="#IM_MULTIPLYING_RESULT_OF_IREM">IM: Multiplic ation d'un entier avec le résulat entier d'un modulo</a></td><td>Correctness</td ></tr>
219 <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>
220 <tr bgcolor="#ffffff"><td><a href="#INT_BAD_COMPARISON_WITH_NONNEGATIVE_VALUE">I NT: Bad comparison of nonnegative value with negative constant or zero</a></td>< td>Correctness</td></tr>
221 <tr bgcolor="#eeeeee"><td><a href="#INT_BAD_COMPARISON_WITH_SIGNED_BYTE">INT: Ba d comparison of signed byte</a></td><td>Correctness</td></tr>
222 <tr bgcolor="#ffffff"><td><a href="#IO_APPENDING_TO_OBJECT_OUTPUT_STREAM">IO: Do omed attempt to append to an object output stream</a></td><td>Correctness</td></ tr>
223 <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>
224 <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>
225 <tr bgcolor="#eeeeee"><td><a href="#MF_METHOD_MASKS_FIELD">MF: La méthode défini t une variable qui masque un champ</a></td><td>Correctness</td></tr>
226 <tr bgcolor="#ffffff"><td><a href="#NP_ALWAYS_NULL">NP: Déréférencement d'un poi nteur null dans la méthode</a></td><td>Correctness</td></tr>
227 <tr bgcolor="#eeeeee"><td><a href="#NP_ALWAYS_NULL_EXCEPTION">NP: Déréférencemen t d'un pointeur null dans le chemin d'exception d'une méthode</a></td><td>Correc tness</td></tr>
228 <tr bgcolor="#ffffff"><td><a href="#NP_ARGUMENT_MIGHT_BE_NULL">NP: Méthode ne te stant pas les paramètres à null</a></td><td>Correctness</td></tr>
229 <tr bgcolor="#eeeeee"><td><a href="#NP_CLOSING_NULL">NP: close() invoked on a va lue that is always null</a></td><td>Correctness</td></tr>
230 <tr bgcolor="#ffffff"><td><a href="#NP_GUARANTEED_DEREF">NP: Null déréférencé</a ></td><td>Correctness</td></tr>
231 <tr bgcolor="#eeeeee"><td><a href="#NP_GUARANTEED_DEREF_ON_EXCEPTION_PATH">NP: V alue is null and guaranteed to be dereferenced on exception path</a></td><td>Cor rectness</td></tr>
232 <tr bgcolor="#ffffff"><td><a href="#NP_NONNULL_FIELD_NOT_INITIALIZED_IN_CONSTRUC TOR">NP: Non-null field is not initialized</a></td><td>Correctness</td></tr>
233 <tr bgcolor="#eeeeee"><td><a href="#NP_NONNULL_PARAM_VIOLATION">NP: Appel de mét hode transmettant null à un paramètre déclaré @NonNull</a></td><td>Correctness</ td></tr>
234 <tr bgcolor="#ffffff"><td><a href="#NP_NONNULL_RETURN_VIOLATION">NP: Méthode ren voyer null mais déclarée @NonNull</a></td><td>Correctness</td></tr>
235 <tr bgcolor="#eeeeee"><td><a href="#NP_NULL_INSTANCEOF">NP: A known null value i s checked to see if it is an instance of a type</a></td><td>Correctness</td></tr >
236 <tr bgcolor="#ffffff"><td><a href="#NP_NULL_ON_SOME_PATH">NP: Possible déréféren cement d'un pointeur null dans une méthode</a></td><td>Correctness</td></tr>
237 <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>
238 <tr bgcolor="#ffffff"><td><a href="#NP_NULL_PARAM_DEREF">NP: Méthode passant nul l à un paramètre déréférencé inconditionnellement</a></td><td>Correctness</td></ tr>
239 <tr bgcolor="#eeeeee"><td><a href="#NP_NULL_PARAM_DEREF_ALL_TARGETS_DANGEROUS">N P: Appel de méthode passant null à un paramètre déréférencé inconditionnellement </a></td><td>Correctness</td></tr>
240 <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 incon ditionnelle</a></td><td>Correctness</td></tr>
241 <tr bgcolor="#eeeeee"><td><a href="#NP_OPTIONAL_RETURN_NULL">NP: Method with Opt ional return type returns explicit null</a></td><td>Correctness</td></tr>
242 <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>
243 <tr bgcolor="#eeeeee"><td><a href="#NP_UNWRITTEN_FIELD">NP: Lecture d'un champ j amais écrit</a></td><td>Correctness</td></tr>
244 <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>
245 <tr bgcolor="#eeeeee"><td><a href="#NM_LCASE_HASHCODE">Nm: La classe définit has hcode() ; ne devrait-ce pas être hashCode() ?</a></td><td>Correctness</td></tr>
246 <tr bgcolor="#ffffff"><td><a href="#NM_LCASE_TOSTRING">Nm: La classe définit tos tring() ; ne devrait-ce pas être toString() ?</a></td><td>Correctness</td></tr>
247 <tr bgcolor="#eeeeee"><td><a href="#NM_METHOD_CONSTRUCTOR_CONFUSION">Nm: Confusi on apparente entre une méthode et un constructeur</a></td><td>Correctness</td></ tr>
248 <tr bgcolor="#ffffff"><td><a href="#NM_VERY_CONFUSING">Nm: Noms de méthodes très ambigus</a></td><td>Correctness</td></tr>
249 <tr bgcolor="#eeeeee"><td><a href="#NM_WRONG_PACKAGE">Nm: Method doesn't overrid e method in superclass due to wrong package for parameter</a></td><td>Correctnes s</td></tr>
250 <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>
251 <tr bgcolor="#eeeeee"><td><a href="#RANGE_ARRAY_INDEX">RANGE: Array index is out of bounds</a></td><td>Correctness</td></tr>
252 <tr bgcolor="#ffffff"><td><a href="#RANGE_ARRAY_LENGTH">RANGE: Array length is o ut of bounds</a></td><td>Correctness</td></tr>
253 <tr bgcolor="#eeeeee"><td><a href="#RANGE_ARRAY_OFFSET">RANGE: Array offset is o ut of bounds</a></td><td>Correctness</td></tr>
254 <tr bgcolor="#ffffff"><td><a href="#RANGE_STRING_INDEX">RANGE: String index is o ut of bounds</a></td><td>Correctness</td></tr>
255 <tr bgcolor="#eeeeee"><td><a href="#RC_REF_COMPARISON">RC: Comparaison de référe nces suspecte</a></td><td>Correctness</td></tr>
256 <tr bgcolor="#ffffff"><td><a href="#RCN_REDUNDANT_NULLCHECK_WOULD_HAVE_BEEN_A_NP E">RCN: Test de nullité d'une valeur préalablement déréférencée</a></td><td>Corr ectness</td></tr>
257 <tr bgcolor="#eeeeee"><td><a href="#RE_BAD_SYNTAX_FOR_REGULAR_EXPRESSION">RE: Sy ntaxe d'expression régulière invalide</a></td><td>Correctness</td></tr>
258 <tr bgcolor="#ffffff"><td><a href="#RE_CANT_USE_FILE_SEPARATOR_AS_REGULAR_EXPRES SION">RE: File.separator used for regular expression</a></td><td>Correctness</td ></tr>
259 <tr bgcolor="#eeeeee"><td><a href="#RE_POSSIBLE_UNINTENDED_PATTERN">RE: "." util isé dans une expression régulière</a></td><td>Correctness</td></tr>
260 <tr bgcolor="#ffffff"><td><a href="#RV_01_TO_INT">RV: Les valeurs aléatoires ent re 0 et 1 sont réduites à l'entier 0</a></td><td>Correctness</td></tr>
261 <tr bgcolor="#eeeeee"><td><a href="#RV_ABSOLUTE_VALUE_OF_HASHCODE">RV: Bad attem pt to compute absolute value of signed 32-bit hashcode </a></td><td>Correctness< /td></tr>
262 <tr bgcolor="#ffffff"><td><a href="#RV_ABSOLUTE_VALUE_OF_RANDOM_INT">RV: Bad att empt to compute absolute value of signed random integer</a></td><td>Correctness< /td></tr>
263 <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>Correctn ess</td></tr>
264 <tr bgcolor="#ffffff"><td><a href="#RV_EXCEPTION_NOT_THROWN">RV: Exception creat ed and dropped rather than thrown</a></td><td>Correctness</td></tr>
265 <tr bgcolor="#eeeeee"><td><a href="#RV_RETURN_VALUE_IGNORED">RV: La méthode igno re une valeur de retour</a></td><td>Correctness</td></tr>
266 <tr bgcolor="#ffffff"><td><a href="#RpC_REPEATED_CONDITIONAL_TEST">RpC: Repeated conditional tests</a></td><td>Correctness</td></tr>
267 <tr bgcolor="#eeeeee"><td><a href="#SA_FIELD_SELF_ASSIGNMENT">SA: Auto-alimentat ion d'un champs</a></td><td>Correctness</td></tr>
268 <tr bgcolor="#ffffff"><td><a href="#SA_FIELD_SELF_COMPARISON">SA: Self compariso n of field with itself</a></td><td>Correctness</td></tr>
269 <tr bgcolor="#eeeeee"><td><a href="#SA_FIELD_SELF_COMPUTATION">SA: Nonsensical s elf computation involving a field (e.g., x & x)</a></td><td>Correctness</td></tr >
270 <tr bgcolor="#ffffff"><td><a href="#SA_LOCAL_SELF_ASSIGNMENT_INSTEAD_OF_FIELD">S A: Self assignment of local rather than assignment to field</a></td><td>Correctn ess</td></tr>
271 <tr bgcolor="#eeeeee"><td><a href="#SA_LOCAL_SELF_COMPARISON">SA: Self compariso n of value with itself</a></td><td>Correctness</td></tr>
272 <tr bgcolor="#ffffff"><td><a href="#SA_LOCAL_SELF_COMPUTATION">SA: Nonsensical s elf computation involving a variable (e.g., x & x)</a></td><td>Correctness</td>< /tr>
273 <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></t r>
274 <tr bgcolor="#ffffff"><td><a href="#SF_DEAD_STORE_DUE_TO_SWITCH_FALLTHROUGH_TO_T HROW">SF: Dead store due to switch statement fall through to throw</a></td><td>C orrectness</td></tr>
275 <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>
276 <tr bgcolor="#ffffff"><td><a href="#SIO_SUPERFLUOUS_INSTANCEOF">SIO: Vérificatio n de type inutile avec l'opérateur instanceof</a></td><td>Correctness</td></tr>
277 <tr bgcolor="#eeeeee"><td><a href="#SQL_BAD_PREPARED_STATEMENT_ACCESS">SQL: Méth ode essayant au paramêtre d'indice 0 d'un PreparedStatement</a></td><td>Correctn ess</td></tr>
278 <tr bgcolor="#ffffff"><td><a href="#SQL_BAD_RESULTSET_ACCESS">SQL: Méthode essay ant d'accèder à un champ de ResultSet d'indice 0</a></td><td>Correctness</td></t r>
279 <tr bgcolor="#eeeeee"><td><a href="#STI_INTERRUPTED_ON_CURRENTTHREAD">STI: Utili sation superflue d'un appel à currentThread() pour appeler interrupted()</a></td ><td>Correctness</td></tr>
280 <tr bgcolor="#ffffff"><td><a href="#STI_INTERRUPTED_ON_UNKNOWNTHREAD">STI: Threa d.interrupted() appelée par erreur sur un objet Thread arbitraire</a></td><td>Co rrectness</td></tr>
281 <tr bgcolor="#eeeeee"><td><a href="#SE_METHOD_MUST_BE_PRIVATE">Se: Méthode devan t être privée pour que la sérialisation fonctionne</a></td><td>Correctness</td>< /tr>
282 <tr bgcolor="#ffffff"><td><a href="#SE_READ_RESOLVE_IS_STATIC">Se: The readResol ve method must not be declared as a static method. </a></td><td>Correctness</td ></tr>
283 <tr bgcolor="#eeeeee"><td><a href="#TQ_ALWAYS_VALUE_USED_WHERE_NEVER_REQUIRED">T Q: 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>
284 <tr bgcolor="#ffffff"><td><a href="#TQ_COMPARING_VALUES_WITH_INCOMPATIBLE_TYPE_Q UALIFIERS">TQ: Comparing values with incompatible type qualifiers</a></td><td>Co rrectness</td></tr>
285 <tr bgcolor="#eeeeee"><td><a href="#TQ_MAYBE_SOURCE_VALUE_REACHES_ALWAYS_SINK">T Q: Value that might not carry a type qualifier is always used in a way requires that type qualifier</a></td><td>Correctness</td></tr>
286 <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 f rom having that type qualifier</a></td><td>Correctness</td></tr>
287 <tr bgcolor="#eeeeee"><td><a href="#TQ_NEVER_VALUE_USED_WHERE_ALWAYS_REQUIRED">T Q: Value annotated as never carrying a type qualifier used where value carrying that qualifier is required</a></td><td>Correctness</td></tr>
288 <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 h ave that qualifier</a></td><td>Correctness</td></tr>
289 <tr bgcolor="#eeeeee"><td><a href="#UMAC_UNCALLABLE_METHOD_OF_ANONYMOUS_CLASS">U MAC: Méthode non appelable définie dans une classe anonyme</a></td><td>Correctne ss</td></tr>
290 <tr bgcolor="#ffffff"><td><a href="#UR_UNINIT_READ">UR: Lecture d'un champ non i nitialisé dans un constructeur</a></td><td>Correctness</td></tr>
291 <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>
292 <tr bgcolor="#ffffff"><td><a href="#DMI_INVOKING_TOSTRING_ON_ANONYMOUS_ARRAY">US ELESS_STRING: Invocation of toString on an unnamed array</a></td><td>Correctness </td></tr>
293 <tr bgcolor="#eeeeee"><td><a href="#DMI_INVOKING_TOSTRING_ON_ARRAY">USELESS_STRI NG: Invocation de toString sur un tableau</a></td><td>Correctness</td></tr>
294 <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>C orrectness</td></tr>
295 <tr bgcolor="#eeeeee"><td><a href="#UWF_NULL_FIELD">UwF: Champ uniquement mis à null</a></td><td>Correctness</td></tr>
296 <tr bgcolor="#ffffff"><td><a href="#UWF_UNWRITTEN_FIELD">UwF: Champ jamais écrit </a></td><td>Correctness</td></tr>
297 <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'ob jets en argument</a></td><td>Correctness</td></tr>
298 <tr bgcolor="#ffffff"><td><a href="#LG_LOST_LOGGER_DUE_TO_WEAK_REFERENCE">LG: Po tential lost logger changes due to weak reference in OpenJDK</a></td><td>Experim ental</td></tr>
299 <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>
300 <tr bgcolor="#ffffff"><td><a href="#OBL_UNSATISFIED_OBLIGATION_EXCEPTION_EDGE">O BL: Method may fail to clean up stream or resource on checked exception</a></td> <td>Experimental</td></tr>
301 <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>
302 <tr bgcolor="#ffffff"><td><a href="#DM_DEFAULT_ENCODING">Dm: Reliance on default encoding</a></td><td>Internationalization</td></tr>
303 <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 doPrivil eged</a></td><td>Malicious code vulnerability</td></tr>
304 <tr bgcolor="#ffffff"><td><a href="#DP_DO_INSIDE_DO_PRIVILEGED">DP: Méthode invo quée alors qu'elle ne devrait l'être qu'à partir d'un block doPrivileged</a></td ><td>Malicious code vulnerability</td></tr>
305 <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>
306 <tr bgcolor="#ffffff"><td><a href="#EI_EXPOSE_REP2">EI2: Une méthode expose sa r eprésentation interne en incorporant une référence à un objet modifiable</a></td ><td>Malicious code vulnerability</td></tr>
307 <tr bgcolor="#eeeeee"><td><a href="#FI_PUBLIC_SHOULD_BE_PROTECTED">FI: Un finali seur devrait être protégé, pas public</a></td><td>Malicious code vulnerability</ td></tr>
308 <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>
309 <tr bgcolor="#eeeeee"><td><a href="#MS_CANNOT_BE_FINAL">MS: Un champ n'est pas f inal et ne peut pas être protégé face à du code malveillant</a></td><td>Maliciou s code vulnerability</td></tr>
310 <tr bgcolor="#ffffff"><td><a href="#MS_EXPOSE_REP">MS: Une méthode statique publ ique risque d'exposer une représentation interne en renvoyant un tableau</a></td ><td>Malicious code vulnerability</td></tr>
311 <tr bgcolor="#eeeeee"><td><a href="#MS_FINAL_PKGPROTECT">MS: Le champ devrait êt re à la fois final et package protected</a></td><td>Malicious code vulnerability </td></tr>
312 <tr bgcolor="#ffffff"><td><a href="#MS_MUTABLE_ARRAY">MS: Un champ est un tablea u modifiable</a></td><td>Malicious code vulnerability</td></tr>
313 <tr bgcolor="#eeeeee"><td><a href="#MS_MUTABLE_COLLECTION">MS: Field is a mutabl e collection</a></td><td>Malicious code vulnerability</td></tr>
314 <tr bgcolor="#ffffff"><td><a href="#MS_MUTABLE_COLLECTION_PKGPROTECT">MS: Field is a mutable collection which should be package protected</a></td><td>Malicious code vulnerability</td></tr>
315 <tr bgcolor="#eeeeee"><td><a href="#MS_MUTABLE_HASHTABLE">MS: Un champ modifiabl e est une Hashtable</a></td><td>Malicious code vulnerability</td></tr>
316 <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 vul nerability</td></tr>
317 <tr bgcolor="#eeeeee"><td><a href="#MS_PKGPROTECT">MS: Un champ devrait être pac kage protected</a></td><td>Malicious code vulnerability</td></tr>
318 <tr bgcolor="#ffffff"><td><a href="#MS_SHOULD_BE_FINAL">MS: Un champ n'est pas f inal alors qu'il devrait l'être</a></td><td>Malicious code vulnerability</td></t r>
319 <tr bgcolor="#eeeeee"><td><a href="#MS_SHOULD_BE_REFACTORED_TO_BE_FINAL">MS: Fie ld isn't final but should be refactored to be so</a></td><td>Malicious code vuln erability</td></tr>
320 <tr bgcolor="#ffffff"><td><a href="#AT_OPERATION_SEQUENCE_ON_CONCURRENT_ABSTRACT ION">AT: Sequence of calls to concurrent abstraction may not be atomic</a></td>< td>Multithreaded correctness</td></tr>
321 <tr bgcolor="#eeeeee"><td><a href="#DC_DOUBLECHECK">DC: Possible double vérifica tion d'un champ</a></td><td>Multithreaded correctness</td></tr>
322 <tr bgcolor="#ffffff"><td><a href="#DC_PARTIALLY_CONSTRUCTED">DC: Possible expos ure of partially initialized object</a></td><td>Multithreaded correctness</td></ tr>
323 <tr bgcolor="#eeeeee"><td><a href="#DL_SYNCHRONIZATION_ON_BOOLEAN">DL: Synchroni zation on Boolean</a></td><td>Multithreaded correctness</td></tr>
324 <tr bgcolor="#ffffff"><td><a href="#DL_SYNCHRONIZATION_ON_BOXED_PRIMITIVE">DL: S ynchronization on boxed primitive</a></td><td>Multithreaded correctness</td></tr >
325 <tr bgcolor="#eeeeee"><td><a href="#DL_SYNCHRONIZATION_ON_SHARED_CONSTANT">DL: S ynchronization on interned String </a></td><td>Multithreaded correctness</td></t r>
326 <tr bgcolor="#ffffff"><td><a href="#DL_SYNCHRONIZATION_ON_UNSHARED_BOXED_PRIMITI VE">DL: Synchronization on boxed primitive values</a></td><td>Multithreaded corr ectness</td></tr>
327 <tr bgcolor="#eeeeee"><td><a href="#DM_MONITOR_WAIT_ON_CONDITION">Dm: Wait() app elé sur une Condition</a></td><td>Multithreaded correctness</td></tr>
328 <tr bgcolor="#ffffff"><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>
329 <tr bgcolor="#eeeeee"><td><a href="#ESync_EMPTY_SYNC">ESync: Bloc synchronisé vi de</a></td><td>Multithreaded correctness</td></tr>
330 <tr bgcolor="#ffffff"><td><a href="#IS2_INCONSISTENT_SYNC">IS: Synchronisation i ncohérente</a></td><td>Multithreaded correctness</td></tr>
331 <tr bgcolor="#eeeeee"><td><a href="#IS_FIELD_NOT_GUARDED">IS: Champ non protégé contre les accès concurrents</a></td><td>Multithreaded correctness</td></tr>
332 <tr bgcolor="#ffffff"><td><a href="#JLM_JSR166_LOCK_MONITORENTER">JLM: Synchroni sation effectuée sur un Lock java.util.concurrent</a></td><td>Multithreaded corr ectness</td></tr>
333 <tr bgcolor="#eeeeee"><td><a href="#JLM_JSR166_UTILCONCURRENT_MONITORENTER">JLM: Synchronization performed on util.concurrent instance</a></td><td>Multithreaded correctness</td></tr>
334 <tr bgcolor="#ffffff"><td><a href="#JML_JSR166_CALLING_WAIT_RATHER_THAN_AWAIT">J LM: Using monitor style wait methods on util.concurrent abstraction</a></td><td> Multithreaded correctness</td></tr>
335 <tr bgcolor="#eeeeee"><td><a href="#LI_LAZY_INIT_STATIC">LI: Initialisation pare sseuse incorrecte d'un champ statique</a></td><td>Multithreaded correctness</td> </tr>
336 <tr bgcolor="#ffffff"><td><a href="#LI_LAZY_INIT_UPDATE_STATIC">LI: Incorrect la zy initialization and update of static field</a></td><td>Multithreaded correctne ss</td></tr>
337 <tr bgcolor="#eeeeee"><td><a href="#ML_SYNC_ON_FIELD_TO_GUARD_CHANGING_THAT_FIEL D">ML: Synchronization on field in futile attempt to guard that field</a></td><t d>Multithreaded correctness</td></tr>
338 <tr bgcolor="#ffffff"><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>
339 <tr bgcolor="#eeeeee"><td><a href="#MSF_MUTABLE_SERVLET_FIELD">MSF: Mutable serv let field</a></td><td>Multithreaded correctness</td></tr>
340 <tr bgcolor="#ffffff"><td><a href="#MWN_MISMATCHED_NOTIFY">MWN: notify() non app areillé</a></td><td>Multithreaded correctness</td></tr>
341 <tr bgcolor="#eeeeee"><td><a href="#MWN_MISMATCHED_WAIT">MWN: wait() non apparei llé</a></td><td>Multithreaded correctness</td></tr>
342 <tr bgcolor="#ffffff"><td><a href="#NN_NAKED_NOTIFY">NN: Appel notify() isolé da ns une méthode</a></td><td>Multithreaded correctness</td></tr>
343 <tr bgcolor="#eeeeee"><td><a href="#NP_SYNC_AND_NULL_CHECK_FIELD">NP: Synchroniz e and null check on the same field.</a></td><td>Multithreaded correctness</td></ tr>
344 <tr bgcolor="#ffffff"><td><a href="#NO_NOTIFY_NOT_NOTIFYALL">No: Utilisation de notify() plutôt que notifyAll() dans une méthode</a></td><td>Multithreaded corre ctness</td></tr>
345 <tr bgcolor="#eeeeee"><td><a href="#RS_READOBJECT_SYNC">RS: Seule la méthode rea dObject() est synchronisée</a></td><td>Multithreaded correctness</td></tr>
346 <tr bgcolor="#ffffff"><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>
347 <tr bgcolor="#eeeeee"><td><a href="#RU_INVOKE_RUN">Ru: Invocation de run() sur u n thread (Vouliez-vous plutôt dire start() ?)</a></td><td>Multithreaded correctn ess</td></tr>
348 <tr bgcolor="#ffffff"><td><a href="#SC_START_IN_CTOR">SC: Un constructeur invoqu e Thread.start()</a></td><td>Multithreaded correctness</td></tr>
349 <tr bgcolor="#eeeeee"><td><a href="#SP_SPIN_ON_FIELD">SP: Méthode bouclant sur u n champ</a></td><td>Multithreaded correctness</td></tr>
350 <tr bgcolor="#ffffff"><td><a href="#STCAL_INVOKE_ON_STATIC_CALENDAR_INSTANCE">ST CAL: Call to static Calendar</a></td><td>Multithreaded correctness</td></tr>
351 <tr bgcolor="#eeeeee"><td><a href="#STCAL_INVOKE_ON_STATIC_DATE_FORMAT_INSTANCE" >STCAL: Call to static DateFormat</a></td><td>Multithreaded correctness</td></tr >
352 <tr bgcolor="#ffffff"><td><a href="#STCAL_STATIC_CALENDAR_INSTANCE">STCAL: Stati c Calendar field</a></td><td>Multithreaded correctness</td></tr>
353 <tr bgcolor="#eeeeee"><td><a href="#STCAL_STATIC_SIMPLE_DATE_FORMAT_INSTANCE">ST CAL: Static DateFormat</a></td><td>Multithreaded correctness</td></tr>
354 <tr bgcolor="#ffffff"><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>
355 <tr bgcolor="#eeeeee"><td><a href="#TLW_TWO_LOCK_WAIT">TLW: wait() avec deux ver rous en attente</a></td><td>Multithreaded correctness</td></tr>
356 <tr bgcolor="#ffffff"><td><a href="#UG_SYNC_SET_UNSYNC_GET">UG: Méthode getXXX n on synchronisée, méthode setXXX synchronisée</a></td><td>Multithreaded correctne ss</td></tr>
357 <tr bgcolor="#eeeeee"><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 corre ctness</td></tr>
358 <tr bgcolor="#ffffff"><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>Mult ithreaded correctness</td></tr>
359 <tr bgcolor="#eeeeee"><td><a href="#UW_UNCOND_WAIT">UW: Méthode contenant un wai t() non conditionné</a></td><td>Multithreaded correctness</td></tr>
360 <tr bgcolor="#ffffff"><td><a href="#VO_VOLATILE_INCREMENT">VO: An increment to a volatile field isn't atomic</a></td><td>Multithreaded correctness</td></tr>
361 <tr bgcolor="#eeeeee"><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 volatile s</a></td><td>Multithreaded correctness</td></tr>
362 <tr bgcolor="#ffffff"><td><a href="#WL_USING_GETCLASS_RATHER_THAN_CLASS_LITERAL" >WL: Synchronization on getClass rather than class literal</a></td><td>Multithre aded correctness</td></tr>
363 <tr bgcolor="#eeeeee"><td><a href="#WS_WRITEOBJECT_SYNC">WS: Seule la méthode wr iteObject() est synchronisée</a></td><td>Multithreaded correctness</td></tr>
364 <tr bgcolor="#ffffff"><td><a href="#WA_AWAIT_NOT_IN_LOOP">Wa: Condition.await() en dehors d'une boucle</a></td><td>Multithreaded correctness</td></tr>
365 <tr bgcolor="#eeeeee"><td><a href="#WA_NOT_IN_LOOP">Wa: Méthode contenant un wai t() en dehors d'une boucle</a></td><td>Multithreaded correctness</td></tr>
366 <tr bgcolor="#ffffff"><td><a href="#BX_BOXING_IMMEDIATELY_UNBOXED">Bx: Primitive value is boxed and then immediately unboxed</a></td><td>Performance</td></tr>
367 <tr bgcolor="#eeeeee"><td><a href="#BX_BOXING_IMMEDIATELY_UNBOXED_TO_PERFORM_COE RCION">Bx: Primitive value is boxed then unboxed to perform primitive coercion</ a></td><td>Performance</td></tr>
368 <tr bgcolor="#ffffff"><td><a href="#BX_UNBOXED_AND_COERCED_FOR_TERNARY_OPERATOR" >Bx: Primitive value is unboxed and coerced for ternary operator</a></td><td>Per formance</td></tr>
369 <tr bgcolor="#eeeeee"><td><a href="#BX_UNBOXING_IMMEDIATELY_REBOXED">Bx: Boxed v alue is unboxed and then immediately reboxed</a></td><td>Performance</td></tr>
370 <tr bgcolor="#ffffff"><td><a href="#DM_BOXED_PRIMITIVE_FOR_COMPARE">Bx: Boxing a primitive to compare</a></td><td>Performance</td></tr>
371 <tr bgcolor="#eeeeee"><td><a href="#DM_BOXED_PRIMITIVE_FOR_PARSING">Bx: Boxing/u nboxing to parse a primitive</a></td><td>Performance</td></tr>
372 <tr bgcolor="#ffffff"><td><a href="#DM_BOXED_PRIMITIVE_TOSTRING">Bx: Méthode all ouant une primitive boxed pour appeler toString</a></td><td>Performance</td></tr >
373 <tr bgcolor="#eeeeee"><td><a href="#DM_FP_NUMBER_CTOR">Bx: Method invokes ineffi cient floating-point Number constructor; use static valueOf instead</a></td><td> Performance</td></tr>
374 <tr bgcolor="#ffffff"><td><a href="#DM_NUMBER_CTOR">Bx: Method invokes inefficie nt Number constructor; use static valueOf instead</a></td><td>Performance</td></ tr>
375 <tr bgcolor="#eeeeee"><td><a href="#DMI_BLOCKING_METHODS_ON_URL">Dm: The equals and hashCode methods of URL are blocking</a></td><td>Performance</td></tr>
376 <tr bgcolor="#ffffff"><td><a href="#DMI_COLLECTION_OF_URLS">Dm: Maps and sets of URLs can be performance hogs</a></td><td>Performance</td></tr>
377 <tr bgcolor="#eeeeee"><td><a href="#DM_BOOLEAN_CTOR">Dm: La méthode invoque le c onstructeur inutile Boolean() ; utilisez Boolean.valueOf(...) à la place</a></td ><td>Performance</td></tr>
378 <tr bgcolor="#ffffff"><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></t r>
379 <tr bgcolor="#eeeeee"><td><a href="#DM_NEW_FOR_GETCLASS">Dm: Méthode allouant un objet juste pour obtenir la classe</a></td><td>Performance</td></tr>
380 <tr bgcolor="#ffffff"><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>
381 <tr bgcolor="#eeeeee"><td><a href="#DM_STRING_CTOR">Dm: La méthode invoque le co nstructeur inutile String(String) ; utilisez juste l'argument</a></td><td>Perfor mance</td></tr>
382 <tr bgcolor="#ffffff"><td><a href="#DM_STRING_TOSTRING">Dm: La méthode appel toS tring() sur un objet String ; utilisez directement l'objet String</a></td><td>Pe rformance</td></tr>
383 <tr bgcolor="#eeeeee"><td><a href="#DM_STRING_VOID_CTOR">Dm: La méthode invoque le constructeur inutile String() ; utilisez juste ""</a></td><td>Performance</td ></tr>
384 <tr bgcolor="#ffffff"><td><a href="#HSC_HUGE_SHARED_STRING_CONSTANT">HSC: Huge s tring constants is duplicated across multiple class files</a></td><td>Performanc e</td></tr>
385 <tr bgcolor="#eeeeee"><td><a href="#SBSC_USE_STRINGBUFFER_CONCATENATION">SBSC: L a méthode concatène des chaînes au moyen de + en boucle</a></td><td>Performance< /td></tr>
386 <tr bgcolor="#ffffff"><td><a href="#SIC_INNER_SHOULD_BE_STATIC">SIC: Devrait êtr e une classe interne statique</a></td><td>Performance</td></tr>
387 <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>
388 <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>
389 <tr bgcolor="#eeeeee"><td><a href="#SS_SHOULD_BE_STATIC">SS: Champ non lu : devr ait-il être statique ?</a></td><td>Performance</td></tr>
390 <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>
391 <tr bgcolor="#eeeeee"><td><a href="#UPM_UNCALLED_PRIVATE_METHOD">UPM: Méthode pr ivée jamais appelée</a></td><td>Performance</td></tr>
392 <tr bgcolor="#ffffff"><td><a href="#URF_UNREAD_FIELD">UrF: Champ inutilisé</a></ td><td>Performance</td></tr>
393 <tr bgcolor="#eeeeee"><td><a href="#UUF_UNUSED_FIELD">UuF: Champ inutilisé</a></ td><td>Performance</td></tr>
394 <tr bgcolor="#ffffff"><td><a href="#WMI_WRONG_MAP_ITERATOR">WMI: Utilisation ine fficace d'un itérateur sur keySet au lieu de entrySet</a></td><td>Performance</t d></tr>
395 <tr bgcolor="#eeeeee"><td><a href="#DMI_CONSTANT_DB_PASSWORD">Dm: Hardcoded cons tant database password</a></td><td>Security</td></tr>
396 <tr bgcolor="#ffffff"><td><a href="#DMI_EMPTY_DB_PASSWORD">Dm: Empty database pa ssword</a></td><td>Security</td></tr>
397 <tr bgcolor="#eeeeee"><td><a href="#HRS_REQUEST_PARAMETER_TO_COOKIE">HRS: HTTP c ookie formed from untrusted input</a></td><td>Security</td></tr>
398 <tr bgcolor="#ffffff"><td><a href="#HRS_REQUEST_PARAMETER_TO_HTTP_HEADER">HRS: H TTP Response splitting vulnerability</a></td><td>Security</td></tr>
399 <tr bgcolor="#eeeeee"><td><a href="#PT_ABSOLUTE_PATH_TRAVERSAL">PT: Absolute pat h traversal in servlet</a></td><td>Security</td></tr>
400 <tr bgcolor="#ffffff"><td><a href="#PT_RELATIVE_PATH_TRAVERSAL">PT: Relative pat h traversal in servlet</a></td><td>Security</td></tr>
401 <tr bgcolor="#eeeeee"><td><a href="#SQL_NONCONSTANT_STRING_PASSED_TO_EXECUTE">SQ L: Une chaîne non constante est passée à la méthode execute d'une commande SQL</ a></td><td>Security</td></tr>
402 <tr bgcolor="#ffffff"><td><a href="#SQL_PREPARED_STATEMENT_GENERATED_FROM_NONCON STANT_STRING">SQL: Une requète est préparée à partir d'une chaine non constante< /a></td><td>Security</td></tr>
403 <tr bgcolor="#eeeeee"><td><a href="#XSS_REQUEST_PARAMETER_TO_JSP_WRITER">XSS: JS P reflected cross site scripting vulnerability</a></td><td>Security</td></tr>
404 <tr bgcolor="#ffffff"><td><a href="#XSS_REQUEST_PARAMETER_TO_SEND_ERROR">XSS: Se rvlet reflected cross site scripting vulnerability in error page</a></td><td>Sec urity</td></tr>
405 <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>
406 <tr bgcolor="#ffffff"><td><a href="#BC_BAD_CAST_TO_ABSTRACT_COLLECTION">BC: Tran stypage douteux d'un type Collection vers une classe abstraite</a></td><td>Dodgy code</td></tr>
407 <tr bgcolor="#eeeeee"><td><a href="#BC_BAD_CAST_TO_CONCRETE_COLLECTION">BC: Tran stypage douteux vers une collection concrète</a></td><td>Dodgy code</td></tr>
408 <tr bgcolor="#ffffff"><td><a href="#BC_UNCONFIRMED_CAST">BC: Transtypage non vér ifié/non confirmé</a></td><td>Dodgy code</td></tr>
409 <tr bgcolor="#eeeeee"><td><a href="#BC_UNCONFIRMED_CAST_OF_RETURN_VALUE">BC: Unc hecked/unconfirmed cast of return value from method</a></td><td>Dodgy code</td>< /tr>
410 <tr bgcolor="#ffffff"><td><a href="#BC_VACUOUS_INSTANCEOF">BC: instanceof renver ra toujours vrai</a></td><td>Dodgy code</td></tr>
411 <tr bgcolor="#eeeeee"><td><a href="#ICAST_QUESTIONABLE_UNSIGNED_RIGHT_SHIFT">BSH IFT: Décalage à droite non signé et transtypage short/byte</a></td><td>Dodgy cod e</td></tr>
412 <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>
413 <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>
414 <tr bgcolor="#ffffff"><td><a href="#DB_DUPLICATE_SWITCH_CLAUSES">DB: Méthode uti lisant le même code pour deux clauses switch</a></td><td>Dodgy code</td></tr>
415 <tr bgcolor="#eeeeee"><td><a href="#DLS_DEAD_LOCAL_STORE">DLS: Alimentation à pe rte d'une variable locale</a></td><td>Dodgy code</td></tr>
416 <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>
417 <tr bgcolor="#eeeeee"><td><a href="#DLS_DEAD_LOCAL_STORE_OF_NULL">DLS: Alimentat ion à null d'une variable</a></td><td>Dodgy code</td></tr>
418 <tr bgcolor="#ffffff"><td><a href="#DLS_DEAD_LOCAL_STORE_SHADOWS_FIELD">DLS: Dea d store to local variable that shadows field</a></td><td>Dodgy code</td></tr>
419 <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>
420 <tr bgcolor="#ffffff"><td><a href="#DMI_NONSERIALIZABLE_OBJECT_WRITTEN">DMI: Obj et non sérialisable écrit dans un ObjectOutput</a></td><td>Dodgy code</td></tr>
421 <tr bgcolor="#eeeeee"><td><a href="#DMI_USELESS_SUBSTRING">DMI: Appel de substri ng(0) qui retourne la valeur originale</a></td><td>Dodgy code</td></tr>
422 <tr bgcolor="#ffffff"><td><a href="#DMI_THREAD_PASSED_WHERE_RUNNABLE_EXPECTED">D m: Thread passed where Runnable expected</a></td><td>Dodgy code</td></tr>
423 <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>
424 <tr bgcolor="#ffffff"><td><a href="#EQ_UNUSUAL">Eq: Unusual equals method </a></ td><td>Dodgy code</td></tr>
425 <tr bgcolor="#eeeeee"><td><a href="#FE_FLOATING_POINT_EQUALITY">FE: Test d'égali té en virgule flottante.</a></td><td>Dodgy code</td></tr>
426 <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 c ode</td></tr>
427 <tr bgcolor="#eeeeee"><td><a href="#IA_AMBIGUOUS_INVOCATION_OF_INHERITED_OR_OUTE R_METHOD">IA: Appel ambigu d'une méthode hérité ou externe</a></td><td>Dodgy cod e</td></tr>
428 <tr bgcolor="#ffffff"><td><a href="#IC_INIT_CIRCULARITY">IC: Initialisation circ ulaire</a></td><td>Dodgy code</td></tr>
429 <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>
430 <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>
431 <tr bgcolor="#eeeeee"><td><a href="#IM_AVERAGE_COMPUTATION_COULD_OVERFLOW">IM: P ossibilité de débordement du calcul d'une moyenne</a></td><td>Dodgy code</td></t r>
432 <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>
433 <tr bgcolor="#eeeeee"><td><a href="#INT_BAD_REM_BY_1">INT: Reste entier modulo 1 </a></td><td>Dodgy code</td></tr>
434 <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>
435 <tr bgcolor="#eeeeee"><td><a href="#INT_VACUOUS_COMPARISON">INT: Comparaison inu tile de valeurs entières</a></td><td>Dodgy code</td></tr>
436 <tr bgcolor="#ffffff"><td><a href="#MTIA_SUSPECT_SERVLET_INSTANCE_FIELD">MTIA: L a classe hérite de Servlet et utilise les variables de l'instance.</a></td><td>D odgy code</td></tr>
437 <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>
438 <tr bgcolor="#ffffff"><td><a href="#NP_DEREFERENCE_OF_READLINE_VALUE">NP: Derefe rence of the result of readLine() without nullcheck</a></td><td>Dodgy code</td>< /tr>
439 <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>
440 <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>
441 <tr bgcolor="#eeeeee"><td><a href="#NP_METHOD_PARAMETER_TIGHTENS_ANNOTATION">NP: Method tightens nullness annotation on parameter</a></td><td>Dodgy code</td></t r>
442 <tr bgcolor="#ffffff"><td><a href="#NP_METHOD_RETURN_RELAXING_ANNOTATION">NP: Me thod relaxes nullness annotation on return value</a></td><td>Dodgy code</td></tr >
443 <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><t d>Dodgy code</td></tr>
444 <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>
445 <tr bgcolor="#eeeeee"><td><a href="#NP_PARAMETER_MUST_BE_NONNULL_BUT_MARKED_AS_N ULLABLE">NP: Parameter must be non-null but is marked as nullable</a></td><td>Do dgy code</td></tr>
446 <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>
447 <tr bgcolor="#eeeeee"><td><a href="#NS_DANGEROUS_NON_SHORT_CIRCUIT">NS: Potentia lly dangerous use of non-short-circuit logic</a></td><td>Dodgy code</td></tr>
448 <tr bgcolor="#ffffff"><td><a href="#NS_NON_SHORT_CIRCUIT">NS: Utilisation discut able de logique binaire</a></td><td>Dodgy code</td></tr>
449 <tr bgcolor="#eeeeee"><td><a href="#PZLA_PREFER_ZERO_LENGTH_ARRAYS">PZLA: Envisa gez de renvoyer un tableau vide plutôt que null</a></td><td>Dodgy code</td></tr>
450 <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</t d></tr>
451 <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>
452 <tr bgcolor="#ffffff"><td><a href="#RCN_REDUNDANT_COMPARISON_TWO_NULL_VALUES">RC N: Comparaison redondante de deux valeurs nulles</a></td><td>Dodgy code</td></tr >
453 <tr bgcolor="#eeeeee"><td><a href="#RCN_REDUNDANT_NULLCHECK_OF_NONNULL_VALUE">RC N: Test de nullité redondant sur une valeur non nulle</a></td><td>Dodgy code</td ></tr>
454 <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>Dod gy code</td></tr>
455 <tr bgcolor="#eeeeee"><td><a href="#REC_CATCH_EXCEPTION">REC: java.lang.Exceptio n est intercepté alors qu'Exception n'est jamais lancé</a></td><td>Dodgy code</t d></tr>
456 <tr bgcolor="#ffffff"><td><a href="#RI_REDUNDANT_INTERFACES">RI: Classe implémen tant la même interface que sa super-classe</a></td><td>Dodgy code</td></tr>
457 <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 cod e</td></tr>
458 <tr bgcolor="#ffffff"><td><a href="#RV_DONT_JUST_NULL_CHECK_READLINE">RV: Méthod e ignorant le résultat d'un readLine() après avoir vérifié qu'il est non nul</a> </td><td>Dodgy code</td></tr>
459 <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>
460 <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>
461 <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>
462 <tr bgcolor="#ffffff"><td><a href="#RV_RETURN_VALUE_IGNORED_NO_SIDE_EFFECT">RV: Return value of method without side effect is ignored</a></td><td>Dodgy code</td ></tr>
463 <tr bgcolor="#eeeeee"><td><a href="#SA_FIELD_DOUBLE_ASSIGNMENT">SA: Double assig nment of field</a></td><td>Dodgy code</td></tr>
464 <tr bgcolor="#ffffff"><td><a href="#SA_LOCAL_DOUBLE_ASSIGNMENT">SA: Double assig nment of local variable </a></td><td>Dodgy code</td></tr>
465 <tr bgcolor="#eeeeee"><td><a href="#SA_LOCAL_SELF_ASSIGNMENT">SA: Auto-alimentat ion d'une variable locale</a></td><td>Dodgy code</td></tr>
466 <tr bgcolor="#ffffff"><td><a href="#SF_SWITCH_FALLTHROUGH">SF: Un switch comport e un cas qui déborde sur le suivant</a></td><td>Dodgy code</td></tr>
467 <tr bgcolor="#eeeeee"><td><a href="#SF_SWITCH_NO_DEFAULT">SF: Switch statement f ound where default case is missing</a></td><td>Dodgy code</td></tr>
468 <tr bgcolor="#ffffff"><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>
469 <tr bgcolor="#eeeeee"><td><a href="#SE_PRIVATE_READ_RESOLVE_NOT_INHERITED">Se: P rivate readResolve method not inherited by subclasses</a></td><td>Dodgy code</td ></tr>
470 <tr bgcolor="#ffffff"><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>
471 <tr bgcolor="#eeeeee"><td><a href="#TQ_EXPLICIT_UNKNOWN_SOURCE_VALUE_REACHES_ALW AYS_SINK">TQ: Value required to have type qualifier, but marked as unknown</a></ td><td>Dodgy code</td></tr>
472 <tr bgcolor="#ffffff"><td><a href="#TQ_EXPLICIT_UNKNOWN_SOURCE_VALUE_REACHES_NEV ER_SINK">TQ: Value required to not have type qualifier, but marked as unknown</a ></td><td>Dodgy code</td></tr>
473 <tr bgcolor="#eeeeee"><td><a href="#UC_USELESS_CONDITION">UC: Condition has no e ffect</a></td><td>Dodgy code</td></tr>
474 <tr bgcolor="#ffffff"><td><a href="#UC_USELESS_CONDITION_TYPE">UC: Condition has no effect due to the variable type</a></td><td>Dodgy code</td></tr>
475 <tr bgcolor="#eeeeee"><td><a href="#UC_USELESS_OBJECT">UC: Useless object create d</a></td><td>Dodgy code</td></tr>
476 <tr bgcolor="#ffffff"><td><a href="#UC_USELESS_OBJECT_STACK">UC: Useless object created on stack</a></td><td>Dodgy code</td></tr>
477 <tr bgcolor="#eeeeee"><td><a href="#UC_USELESS_VOID_METHOD">UC: Useless non-empt y void method</a></td><td>Dodgy code</td></tr>
478 <tr bgcolor="#ffffff"><td><a href="#UCF_USELESS_CONTROL_FLOW">UCF: Instruction d e contrôle du flux inutile</a></td><td>Dodgy code</td></tr>
479 <tr bgcolor="#eeeeee"><td><a href="#UCF_USELESS_CONTROL_FLOW_NEXT_LINE">UCF: Use less control flow to next line</a></td><td>Dodgy code</td></tr>
480 <tr bgcolor="#ffffff"><td><a href="#URF_UNREAD_PUBLIC_OR_PROTECTED_FIELD">UrF: U nread public/protected field</a></td><td>Dodgy code</td></tr>
481 <tr bgcolor="#eeeeee"><td><a href="#UUF_UNUSED_PUBLIC_OR_PROTECTED_FIELD">UuF: U nused public or protected field</a></td><td>Dodgy code</td></tr>
482 <tr bgcolor="#ffffff"><td><a href="#UWF_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR">Uw F: Champ non initialisé dans le constructeur</a></td><td>Dodgy code</td></tr>
483 <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>
484 <tr bgcolor="#ffffff"><td><a href="#XFB_XML_FACTORY_BYPASS">XFB: Méthode instanc iant directement une implémentation spécifique des interfaces XML</a></td><td>Do dgy code</td></tr>
485 </table>
486 <h2>Descriptions</h2>
487 <h3><a name="BC_EQUALS_METHOD_SHOULD_WORK_FOR_ALL_OBJECTS">BC: Equals method sho uld not assume anything about the type of its argument (BC_EQUALS_METHOD_SHOULD_ WORK_FOR_ALL_OBJECTS)</a></h3>
488
489
490 <p>
491 The <code>equals(Object o)</code> method shouldn't make any assumptions
492 about the type of <code>o</code>. It should simply return
493 false if <code>o</code> is not the same type as <code>this</code>.
494 </p>
495
496
497 <h3><a name="BIT_SIGNED_CHECK">BIT: Check for sign of bitwise operation (BIT_SIG NED_CHECK)</a></h3>
498
499
500 <p> This method compares an expression such as</p>
501 <pre>((event.detail &amp; SWT.SELECTED) &gt; 0)</pre>.
502 <p>Using bit arithmetic and then comparing with the greater than operator can
503 lead to unexpected results (of course depending on the value of
504 SWT.SELECTED). If SWT.SELECTED is a negative number, this is a candidate
505 for a bug. Even when SWT.SELECTED is not negative, it seems good practice
506 to use '!= 0' instead of '&gt; 0'.
507 </p>
508 <p>
509 <em>Boris Bokowski</em>
510 </p>
511
512
513 <h3><a name="CN_IDIOM">CN: La classe implémente Cloneable mais ne définit et n'u tilise pas la méthode clone() (CN_IDIOM)</a></h3>
514
515
516 <p>La classe implémente <code>Cloneable</code> sans définir ou utiliser la métho de <code>clone()</code>.</p>
517
518
519 <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>
520
521
522 <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 éte ndue 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>
523 <p>Si toutes les méthodes <code>clone()</code> appellent <code>super.clone()</co de>, elles ont alors la garantie d'utiliser <code>Object.clone()</code>, qui ret ourne toujours un objet du type correct.</p>
524
525
526 <h3><a name="CN_IMPLEMENTS_CLONE_BUT_NOT_CLONEABLE">CN: Class defines clone() bu t doesn't implement Cloneable (CN_IMPLEMENTS_CLONE_BUT_NOT_CLONEABLE)</a></h3>
527
528
529 <p> This class defines a clone() method but the class doesn't implement Cloneabl e.
530 There are some situations in which this is OK (e.g., you want to control how sub classes
531 can clone themselves), but just make sure that this is what you intended.
532 </p>
533
534
535 <h3><a name="CNT_ROUGH_CONSTANT_VALUE">CNT: Rough value of known constant found (CNT_ROUGH_CONSTANT_VALUE)</a></h3>
536
537
538 <p>It's recommended to use the predefined library constant for code clarity and better precision.</p>
539
540
541 <h3><a name="CO_ABSTRACT_SELF">Co: Une classe abstraite définit une méthode comp areTo() covariante (CO_ABSTRACT_SELF)</a></h3>
542
543
544 <p>Cette classe définit une version covariante de <code>compareTo()</code>. Pour surcharger correctement la méthode <code>compareTo()</code> de l'interface <cod e>Comparable</code>, le paramètre de <code>compareTo()</code> doit être du type <code>java.lang.Object</code>.</p>
545
546
547 <h3><a name="CO_COMPARETO_INCORRECT_FLOATING">Co: compareTo()/compare() incorrec tly handles float or double value (CO_COMPARETO_INCORRECT_FLOATING)</a></h3>
548
549
550 <p>This method compares double or float values using pattern like this: val1 & gt; val2 ? 1 : val1 &lt; val2 ? -1 : 0.
551 This pattern works incorrectly for -0.0 and NaN values which may result in incor rect sorting result or broken collection
552 (if compared values are used as keys). Consider using Double.compare or Float.co mpare static methods which handle all
553 the special cases correctly.</p>
554
555
556 <h3><a name="CO_COMPARETO_RESULTS_MIN_VALUE">Co: compareTo()/compare() returns I nteger.MIN_VALUE (CO_COMPARETO_RESULTS_MIN_VALUE)</a></h3>
557
558
559 <p> In some situation, this compareTo or compare method returns
560 the constant Integer.MIN_VALUE, which is an exceptionally bad practice.
561 The only thing that matters about the return value of compareTo is the sign of the result.
562 But people will sometimes negate the return value of compareTo, expecting th at this will negate
563 the sign of the result. And it will, except in the case where the value retu rned is Integer.MIN_VALUE.
564 So just return -1 rather than Integer.MIN_VALUE.
565
566
567 <h3><a name="CO_SELF_NO_OBJECT">Co: Définition d'une méthode compareTo() covaria nte (CO_SELF_NO_OBJECT)</a></h3>
568
569
570 <p>Cette classe définit une version covariante de <code>compareTo()</code>. Pour correctement surcharger la méthode <code>compareTo() </code>de l'interface <cod e>Comparable</code>, le paramètre de <code>compareTo()</code> doit être du type <code>java.lang.Object</code>.</p>
571
572
573 <h3><a name="DE_MIGHT_DROP">DE: La méthode peut déclencher une exception (DE_MIG HT_DROP)</a></h3>
574
575
576 <p>Cette méthode peut déclencher une exception. En général, les exceptions doive nt être gérées ou transmises hors de la méthode.</p>
577
578
579 <h3><a name="DE_MIGHT_IGNORE">DE: La méthode peut ignorer une exception (DE_MIGH T_IGNORE)</a></h3>
580
581
582 <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>
583
584
585 <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>
586
587
588 <p> The entrySet() method is allowed to return a view of the
589 underlying Map in which a single Entry object is reused and returned
590 during the iteration. As of Java 1.6, both IdentityHashMap
591 and EnumMap did so. When iterating through such a Map,
592 the Entry value is only valid until you advance to the next iteration.
593 If, for example, you try to pass such an entrySet to an addAll method,
594 things will go badly wrong.
595 </p>
596
597
598 <h3><a name="DMI_RANDOM_USED_ONLY_ONCE">DMI: Random object created and used only once (DMI_RANDOM_USED_ONLY_ONCE)</a></h3>
599
600
601 <p> This code creates a java.util.Random object, uses it to generate one random number, and then discards
602 the Random object. This produces mediocre quality random numbers and is ineffici ent.
603 If possible, rewrite the code so that the Random object is created once and save d, and each time a new random number
604 is required invoke a method on the existing Random object to obtain it.
605 </p>
606
607 <p>If it is important that the generated Random numbers not be guessable, you <e m>must</em> not create a new Random for each random
608 number; the values are too easily guessable. You should strongly consider using a java.security.SecureRandom instead
609 (and avoid allocating a new SecureRandom for each random number needed).
610 </p>
611
612
613 <h3><a name="DMI_USING_REMOVEALL_TO_CLEAR_COLLECTION">DMI: Don't use removeAll t o clear a collection (DMI_USING_REMOVEALL_TO_CLEAR_COLLECTION)</a></h3>
614
615
616 <p> If you want to remove all elements from a collection <code>c</code>, us e <code>c.clear</code>,
617 not <code>c.removeAll(c)</code>. Calling <code>c.removeAll(c)</code> to clear a collection
618 is less clear, susceptible to errors from typos, less efficient and
619 for some collections, might throw a <code>ConcurrentModificationException</code> .
620 </p>
621
622
623 <h3><a name="DM_EXIT">Dm: La méthode invoque System.exit(...) (DM_EXIT)</a></h3>
624
625
626 <p>Invoquer <code>System.exit()</code> arrête toute la JVM. Cela ne doit être fa it 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>R untimeException</code> à la place.</p>
627
628
629 <h3><a name="DM_RUN_FINALIZERS_ON_EXIT">Dm: Méthode invoquant runFinalizersOnExi t, l'une des plus dangeureuses méthodes des librairies Java (DM_RUN_FINALIZERS_O N_EXIT)</a></h3>
630
631
632 <p>N'appelez jamais <code>System.runFinalizersOnExit</code> ou <code>Runtime.run FinalizersOnExit</code> pour quelque raison que ce soit : elles font partie des méthodes les plus dangeureuses des librairies Java</p>
633 <p>Joshua Bloch</p>
634
635
636 <h3><a name="ES_COMPARING_PARAMETER_STRING_WITH_EQ">ES: Comparison of String par ameter using == or != (ES_COMPARING_PARAMETER_STRING_WITH_EQ)</a></h3>
637
638
639 <p>This code compares a <code>java.lang.String</code> parameter for reference
640 equality using the == or != operators. Requiring callers to
641 pass only String constants or interned strings to a method is unnecessarily
642 fragile, and rarely leads to measurable performance gains. Consider
643 using the <code>equals(Object)</code> method instead.</p>
644
645
646 <h3><a name="ES_COMPARING_STRINGS_WITH_EQ">ES: Comparaison d'objets String utili sant == ou != (ES_COMPARING_STRINGS_WITH_EQ)</a></h3>
647
648
649 <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 l es deux chaînes ne soient des constantes dans le fichier source ou aient été int ernalisées au moyen de la méthode <code>String.intern()</code>, deux chaînes ide ntiques 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>
650
651
652 <h3><a name="EQ_ABSTRACT_SELF">Eq: Une classe abstraite définit une méthode equa ls() covariante (EQ_ABSTRACT_SELF)</a></h3>
653
654
655 <p>Cette classe définit une version covariante de la méthode <code>equals()</cod e>. 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 <cod e>java.lang.Object</code>.</p>
656
657
658 <h3><a name="EQ_CHECK_FOR_OPERAND_NOT_COMPATIBLE_WITH_THIS">Eq: Equals checks fo r incompatible operand (EQ_CHECK_FOR_OPERAND_NOT_COMPATIBLE_WITH_THIS)</a></h3>
659
660
661 <p> This equals method is checking to see if the argument is some incompatible type
662 (i.e., a class that is neither a supertype nor subtype of the class that defines
663 the equals method). For example, the Foo class might have an equals method
664 that looks like:
665 </p>
666 <pre>
667 public boolean equals(Object o) {
668 if (o instanceof Foo)
669 return name.equals(((Foo)o).name);
670 else if (o instanceof String)
671 return name.equals(o);
672 else return false;
673 </pre>
674
675 <p>This is considered bad practice, as it makes it very hard to implement an equ als method that
676 is symmetric and transitive. Without those properties, very unexpected behavoirs are possible.
677 </p>
678
679
680 <h3><a name="EQ_COMPARETO_USE_OBJECT_EQUALS">Eq: Class defines compareTo(...) an d uses Object.equals() (EQ_COMPARETO_USE_OBJECT_EQUALS)</a></h3>
681
682
683 <p> This class defines a <code>compareTo(...)</code> method but inherits its
684 <code>equals()</code> method from <code>java.lang.Object</code>.
685 Generally, the value of compareTo should return zero if and only if
686 equals returns true. If this is violated, weird and unpredictable
687 failures will occur in classes such as PriorityQueue.
688 In Java 5 the PriorityQueue.remove method uses the compareTo method,
689 while in Java 6 it uses the equals method.</p>
690
691 <p>From the JavaDoc for the compareTo method in the Comparable interface:
692 <blockquote>
693 It is strongly recommended, but not strictly required that <code>(x.compareTo(y) ==0) == (x.equals(y))</code>.
694 Generally speaking, any class that implements the Comparable interface and viola tes this condition
695 should clearly indicate this fact. The recommended language
696 is "Note: this class has a natural ordering that is inconsistent with equals."
697 </blockquote></p>
698
699
700 <h3><a name="EQ_GETCLASS_AND_CLASS_CONSTANT">Eq: equals method fails for subtype s (EQ_GETCLASS_AND_CLASS_CONSTANT)</a></h3>
701
702
703 <p> This class has an equals method that will be broken if it is inherited by subclasses.
704 It compares a class literal with the class of the argument (e.g., in class <code >Foo</code>
705 it might check if <code>Foo.class == o.getClass()</code>).
706 It is better to check if <code>this.getClass() == o.getClass()</code>.
707 </p>
708
709
710 <h3><a name="EQ_SELF_NO_OBJECT">Eq: Définition d'une méthode equals() covariante (EQ_SELF_NO_OBJECT)</a></h3>
711
712
713 <p>Cette classe définit une version covariante de <code>equals()</code>. Pour su rcharger 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>
714
715
716 <h3><a name="FI_EMPTY">FI: Un finaliseur vide devrait être supprimé (FI_EMPTY)</ a></h3>
717
718
719 <p>Les méthodes <code>finalize()</code> vides sont inutiles, donc elles devraien t être supprimées.</p>
720
721
722 <h3><a name="FI_EXPLICIT_INVOCATION">FI: Invocation explicite d'un finaliseur (F I_EXPLICIT_INVOCATION)</a></h3>
723
724
725 <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>
726
727
728 <h3><a name="FI_FINALIZER_NULLS_FIELDS">FI: Finalizer nulls fields (FI_FINALIZER _NULLS_FIELDS)</a></h3>
729
730
731 <p> This finalizer nulls out fields. This is usually an error, as it does not aid garbage collection,
732 and the object is going to be garbage collected anyway.</p>
733
734
735 <h3><a name="FI_FINALIZER_ONLY_NULLS_FIELDS">FI: Finalizer only nulls fields (FI _FINALIZER_ONLY_NULLS_FIELDS)</a></h3>
736
737
738 <p> This finalizer does nothing except null out fields. This is completely poi ntless, and requires that
739 the object be garbage collected, finalized, and then garbage collected again. Yo u should just remove the finalize
740 method.</p>
741
742
743 <h3><a name="FI_MISSING_SUPER_CALL">FI: Le finaliseur n'appelle pas le finaliseu r de la super-classe (FI_MISSING_SUPER_CALL)</a></h3>
744
745
746 <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 c lasse mère seront ignorées. Ajoutez un appel à <code>super.finalize()</code>.</p >
747
748
749 <h3><a name="FI_NULLIFY_SUPER">FI: Un finaliseur rend inutile celui de sa super- classe (FI_NULLIFY_SUPER)</a></h3>
750
751
752 <p>Cette méthode <code>finalize()</code> vide rend explicitement inutile tout fi naliseur 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>
753
754
755 <h3><a name="FI_USELESS">FI: Le finaliseur ne fait rien sauf appeler celui de la super-classe (FI_USELESS)</a></h3>
756
757
758 <p>La seule chose que cette méthode <code>finalize()</code> fait est d'appeler l a méthode <code>finalize()</code> de la super-classe, ce qui la rend redondante. Supprimez la.</p>
759
760
761 <h3><a name="VA_FORMAT_STRING_USES_NEWLINE">FS: Format string should use %n rath er than \n (VA_FORMAT_STRING_USES_NEWLINE)</a></h3>
762
763
764 <p>
765 This format string include a newline character (\n). In format strings, it is ge nerally
766 preferable better to use %n, which will produce the platform-specific line sepa rator.
767 </p>
768
769
770 <h3><a name="GC_UNCHECKED_TYPE_IN_GENERIC_CALL">GC: Unchecked type in generic ca ll (GC_UNCHECKED_TYPE_IN_GENERIC_CALL)</a></h3>
771
772
773 <p> This call to a generic collection method passes an argument
774 while compile type Object where a specific type from
775 the generic type parameters is expected.
776 Thus, neither the standard Java type system nor static analysis
777 can provide useful information on whether the
778 object being passed as a parameter is of an appropriate type.
779 </p>
780
781
782 <h3><a name="HE_EQUALS_NO_HASHCODE">HE: La classe définit equals() mais pas hash Code() (HE_EQUALS_NO_HASHCODE)</a></h3>
783
784
785 <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 objet s égaux doivent avoir des codes de hachage identiques.</p>
786
787
788 <h3><a name="HE_EQUALS_USE_HASHCODE">HE: La classe définit equals() et utilise O bject.hashCode() (HE_EQUALS_USE_HASHCODE)</a></h3>
789
790
791 <p>Cette classe surcharge <code>equals(Object)</code>, pas <code>hashCode()</cod e>, 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 arbit raire 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 hac hage identiques.</p>
792 <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 recommen dée est du type :</p>
793 <p><pre>
794 public int hashCode() {
795 assert false : "hashCode not designed";
796 return 42; // any arbitrary constant will do
797 }
798 </pre></p>
799
800
801 <h3><a name="HE_HASHCODE_NO_EQUALS">HE: La classe définit hashCode() mais pas eq uals() (HE_HASHCODE_NO_EQUALS)</a></h3>
802
803
804 <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 indiqu ant que des objets identiques doivent avoir des codes de hachage identiques.</p>
805
806
807 <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>
808
809
810 <p>Cette classe définit une méthode <code>hashCode()</code> mais hérite la métho de <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 certaineme nt 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>
811 <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 recomm endée de <code>hashCode</code> est :</p>
812 <p><pre>
813 public int hashCode() {
814 assert false : "hashCode not designed";
815 return 42; // any arbitrary constant will do
816 }
817 </pre></p>
818
819
820 <h3><a name="HE_INHERITS_EQUALS_USE_HASHCODE">HE: La classe hérite de equals() e t utilise Object.hashCode() (HE_INHERITS_EQUALS_USE_HASHCODE)</a></h3>
821
822
823 <p>Cette classe hérite de la méthode <code>equals((Object)</code> d'une super-cl asse abstraite, et de la méthode <code>hashCode()</code> de l'objet <code>java.l ang.Object</code> (qui renvoi le code de hachage d'identité, une valeur arbitrai re assignée à l'objet par la JVM). C'est pourquoi la classe viole probablement l e contrat indiquant que des objets égaux doivent avoir des codes de hachage iden tiques.</p>
824 <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>/<c ode>Hashtable</code>, définissez une méthode <code>hashCode()</code> déclenchant une <code>UnsupportedOperationException</code>.</p>
825
826
827 <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>
828
829
830 <p>Durant l'intialisation, une classe utilise activement l'une de ses sous-class es. Cette sous-classe ne sera pas encore initialisée lors de la première utilisa tion. Par exemple, dans le code suivant, <code>foo</code> sera à <code>null</cod e>.</p>
831 <p><code><pre>
832 public class CircularClassInitialization {
833 static class InnerClassSingleton extends CircularClassInitialization {
834 static InnerClassSingleton singleton = new InnerClassSingleton();
835 }
836 static CircularClassInitialization foo = InnerClassSingleton.singleton;
837 }
838 </pre></code></p>
839
840
841 <h3><a name="IMSE_DONT_CATCH_IMSE">IMSE: Interception douteuse d'une IllegalMoni torStateException (IMSE_DONT_CATCH_IMSE)</a></h3>
842
843
844 <p><code>IllegalMonitorStateException</code> n'est généralement déclenchée que d ans 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>
845
846
847 <h3><a name="ISC_INSTANTIATE_STATIC_CLASS">ISC: Instantiation inutile d'une clas se qui n'a que des méthodes statiques (ISC_INSTANTIATE_STATIC_CLASS)</a></h3>
848
849
850 <p>Cette classe alloue un objet basé sur une classe qui n'a que des méthodes sta tiques. Cet objet n'a pas besoin d'être créé, accédez directement aux méthodes e n utilisant le nom de la classe.</p>
851
852
853 <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>
854
855
856 <p>Cette classe implémente l'interface <code>java.util.Iterator</code>. Néanmoin s, sa méthode <code>next()</code> n'est pas capable de déclencher <code>java.uti l.NoSuchElementException</code>. La méthode <code>next()</code> devrait être mod ifiée pour déclencher <code>NoSuchElementException</code> si elle est appelée al ors qu'il n'y a plus d'éléments à renvoyer.</p>
857
858
859 <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_SERIALIZABL E_OBJECT_INTO_SESSION)</a></h3>
860
861
862 <p>Ce code semble stocker un objet non sérialisable dans un <code>HttpSession</c ode>. Une erreur se produira si cette session est rendue passive ou migrée.</p>
863
864
865 <h3><a name="JCIP_FIELD_ISNT_FINAL_IN_IMMUTABLE_CLASS">JCIP: Les champs d'une cl asse immuable devraient être finaux. (JCIP_FIELD_ISNT_FINAL_IN_IMMUTABLE_CLASS)< /a></h3>
866
867
868 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>fin al</code>.
869
870
871 <h3><a name="ME_ENUM_FIELD_SETTER">ME: Public enum method unconditionally sets i ts field (ME_ENUM_FIELD_SETTER)</a></h3>
872
873
874 <p>This public method declared in public enum unconditionally sets enum field, thus this field can be changed by malicious code
875 or by accident from another package. Though mutable enum fields may be used fo r lazy initialization, it's a bad practice to expose them to the outer world.
876 Consider removing this method or declaring it package-private.</p>
877
878
879 <h3><a name="ME_MUTABLE_ENUM_FIELD">ME: Enum field is public and mutable (ME_MUT ABLE_ENUM_FIELD)</a></h3>
880
881
882 <p>A mutable public field is defined inside a public enum, thus can be changed by malicious code or by accident from another package.
883 Though mutable enum fields may be used for lazy initialization, it's a bad pra ctice to expose them to the outer world.
884 Consider declaring this field final and/or package-private.</p>
885
886
887 <h3><a name="NP_BOOLEAN_RETURN_NULL">NP: Method with Boolean return type returns explicit null (NP_BOOLEAN_RETURN_NULL)</a></h3>
888
889
890 <p>
891 A method that returns either Boolean.TRUE, Boolean.FALSE or null is an accid ent waiting to happen.
892 This method can be invoked as though it returned a value of type boolean, an d
893 the compiler will insert automatic unboxing of the Boolean value. If a null value is returned,
894 this will result in a NullPointerException.
895 </p>
896
897
898 <h3><a name="NP_CLONE_COULD_RETURN_NULL">NP: Clone method may return null (NP_CL ONE_COULD_RETURN_NULL)</a></h3>
899
900
901 <p>
902 This clone method seems to return null in some circumstances, but clone is n ever
903 allowed to return a null value. If you are convinced this path is unreachab le, throw an AssertionError
904 instead.
905 </p>
906
907
908 <h3><a name="NP_EQUALS_SHOULD_HANDLE_NULL_ARGUMENT">NP: Méthode equals() ne véri fiant pas la nullité (NP_EQUALS_SHOULD_HANDLE_NULL_ARGUMENT)</a></h3>
909
910
911 <p>Cette implémentation de <code>equals(Object)</code> ne respecte pas le contra t défini par <code>java.lang.Object.equals()</code> car elle ne vérifie la nulli té du paramètre reçu en argument. Toutes les méthodes <code>equals()</code> doiv ent renvoyer <code>false</code> quand elles reçoivent une valeur à <code>null</c ode>.</p>
912
913
914 <h3><a name="NP_TOSTRING_COULD_RETURN_NULL">NP: toString method may return null (NP_TOSTRING_COULD_RETURN_NULL)</a></h3>
915
916
917 <p>
918 This toString method seems to return null in some circumstances. A liberal r eading of the
919 spec could be interpreted as allowing this, but it is probably a bad idea an d could cause
920 other code to break. Return the empty string or some other appropriate strin g rather than null.
921 </p>
922
923
924 <h3><a name="NM_CLASS_NAMING_CONVENTION">Nm: Nom de classe devant commencer par une majuscule (NM_CLASS_NAMING_CONVENTION)</a></h3>
925
926
927 <p>Les noms de classe doivent être en minuscules avec la première lettre de chaq ue mot en majuscules. Essayez de conserver vos noms de classes simples et explic ites. Utilisez des mots entiers et évitez acronymes et abbréviations (à moins qu e l'abbréviation soit plus largement utilisée que la forme longue, comme "URL" o u "HTML").</p>
928
929
930 <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>
931
932
933 <p>Cette classe n'est pas dérivée d'une autre <code>Exception</code> alors que s on nom se termine par 'Exception'. Ceci risque de porter à confusion les utilisa teurs de cette classe.</p>
934
935
936 <h3><a name="NM_CONFUSING">Nm: Noms de méthodes ambigus (NM_CONFUSING)</a></h3>
937
938
939 <p>Les méthodes indiquées ont des noms qui ne diffèrent que par les majuscules.< /p>
940
941
942 <h3><a name="NM_FIELD_NAMING_CONVENTION">Nm: Nom de champ devant commencer par u ne minuscule (NM_FIELD_NAMING_CONVENTION)</a></h3>
943
944
945 <p>Les noms de champs qui ne sont pas finaux devraient être en minuscules avec l a première lettre des mots, après le premier, en majuscule.</p>
946
947
948 <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>
949
950
951 <p>The identifier is a word that is reserved as a keyword in later versions of J ava, and your code will need to be changed
952 in order to compile it in later versions of Java.</p>
953
954
955
956 <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_ID ENTIFIER)</a></h3>
957
958
959 <p>This identifier is used as a keyword in later versions of Java. This code, an d
960 any code that references this API,
961 will need to be changed in order to compile it in later versions of Java.</p>
962
963
964
965 <h3><a name="NM_METHOD_NAMING_CONVENTION">Nm: Nom de méthode devant commencer pa r une minuscule (NM_METHOD_NAMING_CONVENTION)</a></h3>
966
967
968 <p>Les noms de méthodes devraient être des verbes en minuscules, avec la premièr e lettre des mots, après le premier, en majuscules.</p>
969
970
971 <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>
972
973
974 <p> This class/interface has a simple name that is identical to that of an imp lemented/extended interface, except
975 that the interface is in a different package (e.g., <code>alpha.Foo</code> exten ds <code>beta.Foo</code>).
976 This can be exceptionally confusing, create lots of situations in which you have to look at import statements
977 to resolve references and creates many
978 opportunities to accidentally define methods that do not override methods in the ir superclasses.
979 </p>
980
981
982 <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>
983
984
985 <p> This class has a simple name that is identical to that of its superclass, except
986 that its superclass is in a different package (e.g., <code>alpha.Foo</code> exte nds <code>beta.Foo</code>).
987 This can be exceptionally confusing, create lots of situations in which you have to look at import statements
988 to resolve references and creates many
989 opportunities to accidentally define methods that do not override methods in the ir superclasses.
990 </p>
991
992
993 <h3><a name="NM_VERY_CONFUSING_INTENTIONAL">Nm: Very confusing method names (but perhaps intentional) (NM_VERY_CONFUSING_INTENTIONAL)</a></h3>
994
995
996 <p> The referenced methods have names that differ only by capitalization.
997 This is very confusing because if the capitalization were
998 identical then one of the methods would override the other. From the existence o f other methods, it
999 seems that the existence of both of these methods is intentional, but is sure is confusing.
1000 You should try hard to eliminate one of them, unless you are forced to have both due to frozen APIs.
1001 </p>
1002
1003
1004 <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>
1005
1006
1007 <p> The method in the subclass doesn't override a similar method in a supercla ss because the type of a parameter doesn't exactly match
1008 the type of the corresponding parameter in the superclass. For example, if you h ave:</p>
1009
1010 <blockquote>
1011 <pre>
1012 import alpha.Foo;
1013 public class A {
1014 public int f(Foo x) { return 17; }
1015 }
1016 ----
1017 import beta.Foo;
1018 public class B extends A {
1019 public int f(Foo x) { return 42; }
1020 public int f(alpha.Foo x) { return 27; }
1021 }
1022 </pre>
1023 </blockquote>
1024
1025 <p>The <code>f(Foo)</code> method defined in class <code>B</code> doesn't
1026 override the
1027 <code>f(Foo)</code> method defined in class <code>A</code>, because the argument
1028 types are <code>Foo</code>'s from different packages.
1029 </p>
1030
1031 <p>In this case, the subclass does define a method with a signature identical to the method in the superclass,
1032 so this is presumably understood. However, such methods are exceptionally confus ing. You should strongly consider
1033 removing or deprecating the method with the similar but not identical signature.
1034 </p>
1035
1036
1037 <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>
1038
1039
1040 <p>Cette méthode crée une ressource base de données (telle qu'une connexion ou u n <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 communic ation entre la base de données et l'application.</p>
1041
1042
1043 <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_RE SOURCE_EXCEPTION_PATH)</a></h3>
1044
1045
1046 <p>Cette méthode crée une ressource base de données (telle qu'une connexion ou u n <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 ception. Ne pas fermer une ressource base de données peut entraîner de faibles p erformances et poser des problèmes de communication entre la base de données et l'application.</p>
1047
1048
1049 <h3><a name="OS_OPEN_STREAM">OS: La méthode peut ne pas fermer un flux (OS_OPEN_ STREAM)</a></h3>
1050
1051
1052 <p>La méthode crée un objet de flux d'E/S, ne l'assigne à aucun champ, ne le pas se à 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>
1053
1054
1055 <h3><a name="OS_OPEN_STREAM_EXCEPTION_PATH">OS: La méthode peut oublier de ferme r un flux en cas d'exception (OS_OPEN_STREAM_EXCEPTION_PATH)</a></h3>
1056
1057
1058 <p>La méthode crée un flux d'E/S, ne l'affecte à aucun champ, ne le passe à aucu ne 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 fichie r. C'est généralement une bonne idée d'utiliser un bloc <code>finally</code> pou r garantir la fermeture des flux.</p>
1059
1060
1061 <h3><a name="PZ_DONT_REUSE_ENTRY_OBJECTS_IN_ITERATORS">PZ: Don't reuse entry obj ects in iterators (PZ_DONT_REUSE_ENTRY_OBJECTS_IN_ITERATORS)</a></h3>
1062
1063
1064 <p> The entrySet() method is allowed to return a view of the
1065 underlying Map in which an Iterator and Map.Entry. This clever
1066 idea was used in several Map implementations, but introduces the possibilit y
1067 of nasty coding mistakes. If a map <code>m</code> returns
1068 such an iterator for an entrySet, then
1069 <code>c.addAll(m.entrySet())</code> will go badly wrong. All of
1070 the Map implementations in OpenJDK 1.7 have been rewritten to avoid this,
1071 you should to.
1072 </p>
1073
1074
1075 <h3><a name="RC_REF_COMPARISON_BAD_PRACTICE">RC: Suspicious reference comparison to constant (RC_REF_COMPARISON_BAD_PRACTICE)</a></h3>
1076
1077
1078 <p> This method compares a reference value to a constant using the == or != oper ator,
1079 where the correct way to compare instances of this type is generally
1080 with the equals() method.
1081 It is possible to create distinct instances that are equal but do not compare as == since
1082 they are different objects.
1083 Examples of classes which should generally
1084 not be compared by reference are java.lang.Integer, java.lang.Float, etc.</p>
1085
1086
1087 <h3><a name="RC_REF_COMPARISON_BAD_PRACTICE_BOOLEAN">RC: Suspicious reference co mparison of Boolean values (RC_REF_COMPARISON_BAD_PRACTICE_BOOLEAN)</a></h3>
1088
1089
1090 <p> This method compares two Boolean values using the == or != operator.
1091 Normally, there are only two Boolean values (Boolean.TRUE and Boolean.FALSE),
1092 but it is possible to create other Boolean objects using the <code>new Boolean(b )</code>
1093 constructor. It is best to avoid such objects, but if they do exist,
1094 then checking Boolean objects for equality using == or != will give results
1095 than are different than you would get using <code>.equals(...)</code>
1096 </p>
1097
1098
1099 <h3><a name="RR_NOT_CHECKED">RR: La méthode ignore le résultat de InputStream.re ad() (RR_NOT_CHECKED)</a></h3>
1100
1101
1102 <p>Cette méthode ignore le code retour d'une des variantes de <code>java.io.Inpu tStream.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 c as ou moins d'octets que prévu auront été lus. C'est un bogue particulièrement i nsidieux car dans la plupart des programmes les lectures renvoient effectivement souvent le nombre d'octets demandé, les plantages restant sporadiques.</p>
1103
1104
1105 <h3><a name="SR_NOT_CHECKED">RR: La méthode ignore le résultat de InputStream.sk ip() (SR_NOT_CHECKED)</a></h3>
1106
1107
1108 <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ér ifiée, l'appelant n'est pas capable de gérer correctement les cas ou moins d'oct ets que prévu auront été sautés. C'est un type de bogue particulièrement insidie ux car la plupart du temps le bon nombre d'octet sera effectivement sauté, et le s 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>
1109
1110
1111 <h3><a name="RV_NEGATING_RESULT_OF_COMPARETO">RV: Negating the result of compare To()/compare() (RV_NEGATING_RESULT_OF_COMPARETO)</a></h3>
1112
1113
1114 <p> This code negatives the return value of a compareTo or compare method.
1115 This is a questionable or bad programming practice, since if the return
1116 value is Integer.MIN_VALUE, negating the return value won't
1117 negate the sign of the result. You can achieve the same intended result
1118 by reversing the order of the operands rather than by negating the results.
1119 </p>
1120
1121
1122 <h3><a name="RV_RETURN_VALUE_IGNORED_BAD_PRACTICE">RV: Method ignores exceptiona l return value (RV_RETURN_VALUE_IGNORED_BAD_PRACTICE)</a></h3>
1123
1124
1125 <p> This method returns a value that is not checked. The return value should be checked
1126 since it can indicate an unusual or unexpected function execution. For
1127 example, the <code>File.delete()</code> method returns false
1128 if the file could not be successfully deleted (rather than
1129 throwing an Exception).
1130 If you don't check the result, you won't notice if the method invocation
1131 signals unexpected behavior by returning an atypical return value.
1132 </p>
1133
1134
1135 <h3><a name="SI_INSTANCE_BEFORE_FINALS_ASSIGNED">SI: Initialiseur statique de cl asse créant une instance avant que tous les champs static final soient alimentés (SI_INSTANCE_BEFORE_FINALS_ASSIGNED)</a></h3>
1136
1137
1138 <p>L'initialiseur <code>static</code> de la classe crée une instance de la class e avant que tous les champs <code>static final</code> soient alimentés.</p>
1139
1140
1141 <h3><a name="SW_SWING_METHODS_INVOKED_IN_SWING_THREAD">SW: Certaines méthodes Sw ing ne doivent être invoquées qu'à partir du thread Swing (SW_SWING_METHODS_INVO KED_IN_SWING_THREAD)</a></h3>
1142
1143
1144 <p>(<a href="http://java.sun.com/developer/JDCTechTips/2003/tt1208.html#1">Conse il 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. E n même temps que la création de ces ressources, le système crée le processus Swi ng de répartition de évènements.</p>
1145 <p>Ceci pose problème car le processus de répartition des évènements peut notifi er des écouteurs alors que <code>pack()</code> et <code>validate()</code> sont t oujours en cours de traitement. Cette situation peut conduire à ce que deux proc essus essayent d'accèder en même temps au composant, ce qui est une faille série use qui peut provoquer des interblocages et autres problèmes de synchronisation. </p>
1146 <p>Un appel à <code>pack()</code> provoque l'initialisation du composant. Quand ils s'initialisent (sans être forcément visibles), les composants peuvent émettr e des évènements vers le processus de répartition des évènements de Swing.</p>
1147
1148
1149 <h3><a name="SE_BAD_FIELD">Se: Champ d'instance non transient et non sérialisabl e dans une classe sérialisable (SE_BAD_FIELD)</a></h3>
1150
1151
1152 <p>Cette classe <code>Serializable</code> définit un champ d'instance non primit if qui n'est ni <code>transient</code>, ni <code>Serializable</code> ou <code>ja va.lang.Object</code>, et qui ne semble pas implémenter l'interface <code>Extern alizable</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 u n objet non <code>Serializable</code> est stocké dans ce champ.</p>
1153
1154
1155 <h3><a name="SE_BAD_FIELD_INNER_CLASS">Se: Non-serializable class has a serializ able inner class (SE_BAD_FIELD_INNER_CLASS)</a></h3>
1156
1157
1158 <p> This Serializable class is an inner class of a non-serializable class.
1159 Thus, attempts to serialize it will also attempt to associate instance of the ou ter
1160 class with which it is associated, leading to a runtime error.
1161 </p>
1162 <p>If possible, making the inner class a static inner class should solve the
1163 problem. Making the outer class serializable might also work, but that would
1164 mean serializing an instance of the inner class would always also serialize the instance
1165 of the outer class, which it often not what you really want.
1166
1167
1168 <h3><a name="SE_BAD_FIELD_STORE">Se: Valeur non sérialisable stockée dans un cha mp d'instance de classe sérialisable (SE_BAD_FIELD_STORE)</a></h3>
1169
1170
1171 <p>Une valeur non sérialisable est stockée dans un champ non <code>transient</co de> d'une classe sérialisable.</p>
1172
1173
1174 <h3><a name="SE_COMPARATOR_SHOULD_BE_SERIALIZABLE">Se: Comparateur n'implémentan t pas Serializable (SE_COMPARATOR_SHOULD_BE_SERIALIZABLE)</a></h3>
1175
1176
1177 <p>Cette classe implémente l'interface <code>Comparator</code>. Vous devriez vér ifier 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 un iquement 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 techn ique de programmation défensive simple et bénéfique.</p>
1178
1179
1180 <h3><a name="SE_INNER_CLASS">Se: Serializable inner class (SE_INNER_CLASS)</a></ h3>
1181
1182
1183 <p> This Serializable class is an inner class. Any attempt to serialize
1184 it will also serialize the associated outer instance. The outer instance is seri alizable,
1185 so this won't fail, but it might serialize a lot more data than intended.
1186 If possible, making the inner class a static inner class (also known as a nested class) should solve the
1187 problem.
1188
1189
1190 <h3><a name="SE_NONFINAL_SERIALVERSIONID">Se: serialVersionUID n'est pas final ( SE_NONFINAL_SERIALVERSIONID)</a></h3>
1191
1192
1193 <p>Cette classe définit un champ <code>serialVersionUID</code> qui n'est pas <co de>final</code>. Ce champ devrait être rendu <code>final</code> si son but est d e préciser l'identifiant de version utilisé pour la sérialisation.</p>
1194
1195
1196 <h3><a name="SE_NONLONG_SERIALVERSIONID">Se: serialVersionUID n'est pas de type long (SE_NONLONG_SERIALVERSIONID)</a></h3>
1197
1198
1199 <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 b ut est de préciser l'identifiant de version utilisé pour la sérialisation.</p>
1200
1201
1202 <h3><a name="SE_NONSTATIC_SERIALVERSIONID">Se: serialVersionUID n'est pas static (SE_NONSTATIC_SERIALVERSIONID)</a></h3>
1203
1204
1205 <p>Cette classe définit un champ <code>serialVersionUID</code> qui n'est pas sta tique. Le champ devrait être rendu statique si son but est de préciser l'identif iant de version utilisé pour la sérialisation.</p>
1206
1207
1208 <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_C ONSTRUCTOR)</a></h3>
1209
1210
1211 <p>Cette classe implémente l'interface <code>Serializable</code> mais pas sa sup er-classe. Quand un tel objet est désérialisé, les champs de la classe mère doiv ent ê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>
1212
1213
1214 <h3><a name="SE_NO_SUITABLE_CONSTRUCTOR_FOR_EXTERNALIZATION">Se: La classe est E xternalizable mais ne définit pas de constructeur par défaut (SE_NO_SUITABLE_CON STRUCTOR_FOR_EXTERNALIZATION)</a></h3>
1215
1216
1217 <p>Cette classe implémente l'interface <code>Externalizable</code>, mais ne défi nit 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 échoue ront à l'exécution.</p>
1218
1219
1220 <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>
1221
1222
1223 <p>Pour que la méthode <code>readResolve</code> soit prise en compte pas le méca nisme de sérialisation, elle doit avoir Object comme type de retour.</p>
1224
1225
1226 <h3><a name="SE_TRANSIENT_FIELD_NOT_RESTORED">Se: Champ "transient" non position né lors de la désérialisation (SE_TRANSIENT_FIELD_NOT_RESTORED)</a></h3>
1227
1228
1229 <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éthode s <code>readObject</code> et <code>readResolve</code>, il contiendra la valeur p ar défaut dans toutes les instances désérialisées de la classe.</p>
1230
1231
1232 <h3><a name="SE_NO_SERIALVERSIONID">SnVI: La classe est Serializable, mais ne dé finit pas serialVersionUID (SE_NO_SERIALVERSIONID)</a></h3>
1233
1234
1235 <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'aj outer 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 convention s 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>S erializable</code> suivant les versions, pensez à ajouter un champ <code>serialV ersionUID</code> explicite.</p>
1236
1237
1238 <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>
1239
1240
1241 <p>Appeler <code>this.getClass().getResource(...)</code> peut rendre des résulta ts différents de ceux attendus si la classe est étendue par une classe d'un autr e paquetage.</p>
1242
1243
1244 <h3><a name="BC_IMPOSSIBLE_CAST">BC: Transtypage impossible (BC_IMPOSSIBLE_CAST) </a></h3>
1245
1246
1247 <p>Ce trantypage lancera toujours une exception <code>ClassCastException</code>. </p>
1248
1249
1250 <h3><a name="BC_IMPOSSIBLE_DOWNCAST">BC: Impossible downcast (BC_IMPOSSIBLE_DOWN CAST)</a></h3>
1251
1252
1253 <p>
1254 This cast will always throw a ClassCastException.
1255 The analysis believes it knows
1256 the precise type of the value being cast, and the attempt to
1257 downcast it to a subtype will always fail by throwing a ClassCastException.
1258 </p>
1259
1260
1261 <h3><a name="BC_IMPOSSIBLE_DOWNCAST_OF_TOARRAY">BC: Impossible downcast of toArr ay() result (BC_IMPOSSIBLE_DOWNCAST_OF_TOARRAY)</a></h3>
1262
1263
1264 <p>
1265 This code is casting the result of calling <code>toArray()</code> on a collectio n
1266 to a type more specific than <code>Object[]</code>, as in:</p>
1267 <pre>
1268 String[] getAsArray(Collection&lt;String&gt; c) {
1269 return (String[]) c.toArray();
1270 }
1271 </pre>
1272 <p>This will usually fail by throwing a ClassCastException. The <code>toArray()< /code>
1273 of almost all collections return an <code>Object[]</code>. They can't really do anything else,
1274 since the Collection object has no reference to the declared generic type of the collection.
1275 <p>The correct way to do get an array of a specific type from a collection is to use
1276 <code>c.toArray(new String[]);</code>
1277 or <code>c.toArray(new String[c.size()]);</code> (the latter is slightly more efficient).
1278 <p>There is one common/known exception exception to this. The <code>toArray()</c ode>
1279 method of lists returned by <code>Arrays.asList(...)</code> will return a covari antly
1280 typed array. For example, <code>Arrays.asArray(new String[] { "a" }).toArray()</ code>
1281 will return a <code>String []</code>. FindBugs attempts to detect and suppress
1282 such cases, but may miss some.
1283 </p>
1284
1285
1286 <h3><a name="BC_IMPOSSIBLE_INSTANCEOF">BC: instanceof renverra toujours faux (BC _IMPOSSIBLE_INSTANCEOF)</a></h3>
1287
1288
1289 <p>Ce test <code>instanceof</code> renverra toujours faux. Même s'il est sûr, as surez-vous qu'il ne s'agisse pas d'une erreur logique ou d'une mauvaise compréhe nsion.</p>
1290
1291
1292 <h3><a name="BIT_ADD_OF_SIGNED_BYTE">BIT: Bitwise add of signed byte value (BIT_ ADD_OF_SIGNED_BYTE)</a></h3>
1293
1294
1295 <p> Adds a byte value and a value which is known to have the 8 lower bits clear.
1296 Values loaded from a byte array are sign extended to 32 bits
1297 before any any bitwise operations are performed on the value.
1298 Thus, if <code>b[0]</code> contains the value <code>0xff</code>, and
1299 <code>x</code> is initially 0, then the code
1300 <code>((x &lt;&lt; 8) + b[0])</code> will sign extend <code>0xff</code>
1301 to get <code>0xffffffff</code>, and thus give the value
1302 <code>0xffffffff</code> as the result.
1303 </p>
1304
1305 <p>In particular, the following code for packing a byte array into an int is bad ly wrong: </p>
1306 <pre>
1307 int result = 0;
1308 for(int i = 0; i &lt; 4; i++)
1309 result = ((result &lt;&lt; 8) + b[i]);
1310 </pre>
1311
1312 <p>The following idiom will work instead: </p>
1313 <pre>
1314 int result = 0;
1315 for(int i = 0; i &lt; 4; i++)
1316 result = ((result &lt;&lt; 8) + (b[i] &amp; 0xff));
1317 </pre>
1318
1319
1320
1321 <h3><a name="BIT_AND">BIT: Masques binaires incompatibles (BIT_AND)</a></h3>
1322
1323
1324 <p>Cette méthode compare une expression de la forme (a <code>&amp;</code> C) ave c 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>
1325
1326
1327 <h3><a name="BIT_AND_ZZ">BIT: Masques binaires incompatibles (BIT_AND_ZZ)</a></h 3>
1328
1329
1330 <p>Cette méthode compare une expression de la forme (a <code>&amp;</code> 0) ave c 0, qui est toujours égale. Ceci peut indiquer une faute de frappe ou une erreu r logique.</p>
1331
1332
1333 <h3><a name="BIT_IOR">BIT: Masques binaires incompatibles (BIT_IOR)</a></h3>
1334
1335
1336 <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>
1337 <p>Typiquement, ce bogue arrive quand du code essaye d'effectuer un test d'appar ition d'un bit mais utilise l'opérateur OU ("<code>|</code>") au lieu de l'opéra teur ET ("<code>&amp;</code>").</p>
1338
1339
1340 <h3><a name="BIT_IOR_OF_SIGNED_BYTE">BIT: Ou binaire d'un octet signé (BIT_IOR_O F_SIGNED_BYTE)</a></h3>
1341
1342
1343 <p>Charge une valeur à partir d'un tableau d'octets et effectue un ou binaire su r 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>
1344
1345
1346 <h3><a name="BIT_SIGNED_CHECK_HIGH_BIT">BIT: Check for sign of bitwise operation (BIT_SIGNED_CHECK_HIGH_BIT)</a></h3>
1347
1348
1349 <p> This method compares an expression such as</p>
1350 <pre>((event.detail &amp; SWT.SELECTED) &gt; 0)</pre>.
1351 <p>Using bit arithmetic and then comparing with the greater than operator can
1352 lead to unexpected results (of course depending on the value of
1353 SWT.SELECTED). If SWT.SELECTED is a negative number, this is a candidate
1354 for a bug. Even when SWT.SELECTED is not negative, it seems good practice
1355 to use '!= 0' instead of '&gt; 0'.
1356 </p>
1357 <p>
1358 <em>Boris Bokowski</em>
1359 </p>
1360
1361
1362 <h3><a name="BOA_BADLY_OVERRIDDEN_ADAPTER">BOA: La classe surcharge mal une méth ode implémentée dans une superclasse Adapter (BOA_BADLY_OVERRIDDEN_ADAPTER)</a>< /h3>
1363
1364
1365 <p>Cette méthode surcharge une méthode provenant d'une classe mère qui est un <c ode>Adapter</code> qui implémente un <code>Listener</code> défini dans le paquet age <code>java.awt.event</code> ou <code>javax.swing.event</code>. En conséquenc e, cette méthode ne sera pas appelée quand l'évènement se produira.</p>
1366
1367
1368 <h3><a name="BSHIFT_WRONG_ADD_PRIORITY">BSHIFT: Possible bad parsing of shift op eration (BSHIFT_WRONG_ADD_PRIORITY)</a></h3>
1369
1370
1371 <p>
1372 The code performs an operation like (x &lt;&lt; 8 + y). Although this might be c orrect, probably it was meant
1373 to perform (x &lt;&lt; 8) + y, but shift operation has
1374 a lower precedence, so it's actually parsed as x &lt;&lt; (8 + y).
1375 </p>
1376
1377
1378 <h3><a name="ICAST_BAD_SHIFT_AMOUNT">BSHIFT: Décalage d'un int hors de proportio n (0..31) (ICAST_BAD_SHIFT_AMOUNT)</a></h3>
1379
1380
1381 <p>Un décalage de n bits est effectué avec n hors des limites (0..31). Ceci résu lte 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 sou rce de confusion.</p>
1382
1383
1384 <h3><a name="DLS_DEAD_LOCAL_INCREMENT_IN_RETURN">DLS: Useless increment in retur n statement (DLS_DEAD_LOCAL_INCREMENT_IN_RETURN)</a></h3>
1385
1386
1387 <p>This statement has a return such as <code>return x++;</code>.
1388 A postfix increment/decrement does not impact the value of the expression,
1389 so this increment/decrement has no effect.
1390 Please verify that this statement does the right thing.
1391 </p>
1392
1393
1394 <h3><a name="DLS_DEAD_STORE_OF_CLASS_LITERAL">DLS: Dead store of class literal ( DLS_DEAD_STORE_OF_CLASS_LITERAL)</a></h3>
1395
1396
1397 <p>
1398 This instruction assigns a class literal to a variable and then never uses it.
1399 <a href="//java.sun.com/j2se/1.5.0/compatibility.html#literal">The behavior of t his differs in Java 1.4 and in Java 5.</a>
1400 In Java 1.4 and earlier, a reference to <code>Foo.class</code> would force the s tatic initializer
1401 for <code>Foo</code> to be executed, if it has not been executed already.
1402 In Java 5 and later, it does not.
1403 </p>
1404 <p>See Sun's <a href="//java.sun.com/j2se/1.5.0/compatibility.html#literal">arti cle on Java SE compatibility</a>
1405 for more details and examples, and suggestions on how to force class initializat ion in Java 5.
1406 </p>
1407
1408
1409 <h3><a name="DLS_OVERWRITTEN_INCREMENT">DLS: Incrémentation annulée (DLS_OVERWRI TTEN_INCREMENT)</a></h3>
1410
1411
1412 <p>Ce code incrémente une valeur (ex., <code>i++</code>) et en annule immédiatem ent l'effet. Par exemple, <code>i = i++</code> réécrit de façon immédiate la val eur incrémentée avec la valeur originale.</p>
1413
1414
1415 <h3><a name="DMI_ARGUMENTS_WRONG_ORDER">DMI: Reversed method arguments (DMI_ARGU MENTS_WRONG_ORDER)</a></h3>
1416
1417
1418 <p> The arguments to this method call seem to be in the wrong order.
1419 For example, a call <code>Preconditions.checkNotNull("message", message)</code>
1420 has reserved arguments: the value to be checked is the first argument.
1421 </p>
1422
1423
1424 <h3><a name="DMI_BAD_MONTH">DMI: Valeur constante pour un mois en dehors de l'in tervalle attendu de 0 à 11 (DMI_BAD_MONTH)</a></h3>
1425
1426
1427 <p>Ce code passe une constante mois en dehors de l'intervalle de 0 à 11.</p>
1428
1429
1430 <h3><a name="DMI_BIGDECIMAL_CONSTRUCTED_FROM_DOUBLE">DMI: BigDecimal constructed from double that isn't represented precisely (DMI_BIGDECIMAL_CONSTRUCTED_FROM_D OUBLE)</a></h3>
1431
1432
1433 <p>
1434 This code creates a BigDecimal from a double value that doesn't translate well t o a
1435 decimal number.
1436 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.1000000000000000055511151231257827021181583 404541015625.
1437 You probably want to use the BigDecimal.valueOf(double d) method, which uses the String representation
1438 of the double to create the BigDecimal (e.g., BigDecimal.valueOf(0.1) gives 0.1) .
1439 </p>
1440
1441
1442
1443 <h3><a name="DMI_CALLING_NEXT_FROM_HASNEXT">DMI: Méthode hasNext() appelant next () (DMI_CALLING_NEXT_FROM_HASNEXT)</a></h3>
1444
1445
1446 <p>La méthode <code>hasNext()</code> appelle la méthode <code>next()</code>. C'e st très probablement faux puisque la méthode <code>hasNext()</code> n'est pas ch anger l'état de l'itérateur tandis que la méthode <code>next()</code> doit chang er cet état.</p>
1447
1448
1449 <h3><a name="DMI_COLLECTIONS_SHOULD_NOT_CONTAIN_THEMSELVES">DMI: Collections sho uld not contain themselves (DMI_COLLECTIONS_SHOULD_NOT_CONTAIN_THEMSELVES)</a></ h3>
1450
1451
1452 <p> This call to a generic collection's method would only make sense if a c ollection contained
1453 itself (e.g., if <code>s.contains(s)</code> were true). This is unlikely to be t rue and would cause
1454 problems if it were true (such as the computation of the hash code resulting in infinite recursion).
1455 It is likely that the wrong value is being passed as a parameter.
1456 </p>
1457
1458
1459 <h3><a name="DMI_DOH">DMI: D'oh! A nonsensical method invocation (DMI_DOH)</a></ h3>
1460
1461
1462 <p>
1463 This partical method invocation doesn't make sense, for reasons that should be a pparent from inspection.
1464 </p>
1465
1466
1467
1468 <h3><a name="DMI_INVOKING_HASHCODE_ON_ARRAY">DMI: Invocation of hashCode on an a rray (DMI_INVOKING_HASHCODE_ON_ARRAY)</a></h3>
1469
1470
1471 <p>
1472 The code invokes hashCode on an array. Calling hashCode on
1473 an array returns the same value as System.identityHashCode, and ingores
1474 the contents and length of the array. If you need a hashCode that
1475 depends on the contents of an array <code>a</code>,
1476 use <code>java.util.Arrays.hashCode(a)</code>.
1477
1478 </p>
1479
1480
1481 <h3><a name="DMI_LONG_BITS_TO_DOUBLE_INVOKED_ON_INT">DMI: Double.longBitsToDoubl e invoked on an int (DMI_LONG_BITS_TO_DOUBLE_INVOKED_ON_INT)</a></h3>
1482
1483
1484 <p> The Double.longBitsToDouble method is invoked, but a 32 bit int value is pas sed
1485 as an argument. This almostly certainly is not intended and is unlikely
1486 to give the intended result.
1487 </p>
1488
1489
1490 <h3><a name="DMI_VACUOUS_SELF_COLLECTION_CALL">DMI: Vacuous call to collections (DMI_VACUOUS_SELF_COLLECTION_CALL)</a></h3>
1491
1492
1493 <p> This call doesn't make sense. For any collection <code>c</code>, callin g <code>c.containsAll(c)</code> should
1494 always be true, and <code>c.retainAll(c)</code> should have no effect.
1495 </p>
1496
1497
1498 <h3><a name="DMI_ANNOTATION_IS_NOT_VISIBLE_TO_REFLECTION">Dm: La réflexion ne pe ut pas être utilisée pour vérifier la présence d'une annotation avec la rétentio n par défaut (DMI_ANNOTATION_IS_NOT_VISIBLE_TO_REFLECTION)</a></h3>
1499
1500
1501 <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éfl exion (par exemple avec la méthode <code>isAnnotationPresent()</code>).</p>
1502
1503
1504 <h3><a name="DMI_FUTILE_ATTEMPT_TO_CHANGE_MAXPOOL_SIZE_OF_SCHEDULED_THREAD_POOL_ EXECUTOR">Dm: Futile attempt to change max pool size of ScheduledThreadPoolExecu tor (DMI_FUTILE_ATTEMPT_TO_CHANGE_MAXPOOL_SIZE_OF_SCHEDULED_THREAD_POOL_EXECUTOR )</a></h3>
1505
1506
1507 <p>(<a href="http://java.sun.com/javase/6/docs/api/java/util/concurrent/Sche duledThreadPoolExecutor.html">Javadoc</a>)
1508 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, adjustm ents to maximumPoolSize have no useful effect.
1509 </p>
1510
1511
1512
1513 <h3><a name="DMI_SCHEDULED_THREAD_POOL_EXECUTOR_WITH_ZERO_CORE_THREADS">Dm: Crea tion of ScheduledThreadPoolExecutor with zero core threads (DMI_SCHEDULED_THREAD _POOL_EXECUTOR_WITH_ZERO_CORE_THREADS)</a></h3>
1514
1515
1516 <p>(<a href="http://java.sun.com/javase/6/docs/api/java/util/concurrent/Sche duledThreadPoolExecutor.html#ScheduledThreadPoolExecutor(int)">Javadoc</a>)
1517 A ScheduledThreadPoolExecutor with zero core threads will never execute anything ; changes to the max pool size are ignored.
1518 </p>
1519
1520
1521
1522 <h3><a name="DMI_VACUOUS_CALL_TO_EASYMOCK_METHOD">Dm: Useless/vacuous call to Ea syMock method (DMI_VACUOUS_CALL_TO_EASYMOCK_METHOD)</a></h3>
1523
1524
1525 <p>This call doesn't pass any objects to the EasyMock method, so the call do esn't do anything.
1526 </p>
1527
1528
1529
1530 <h3><a name="DM_INVALID_MIN_MAX">Dm: Incorrect combination of Math.max and Math. min (DM_INVALID_MIN_MAX)</a></h3>
1531
1532
1533 <p>This code tries to limit the value bounds using the construct like Math.min (0, Math.max(100, value)). However the order of
1534 the constants is incorrect: it should be Math.min(100, Math.max(0, value)). As the result this code always produces the same result
1535 (or NaN if the value is NaN).</p>
1536
1537
1538 <h3><a name="EC_ARRAY_AND_NONARRAY">EC: Utilisation de equals() pour comparer un tableau et un objet (EC_ARRAY_AND_NONARRAY)</a></h3>
1539
1540
1541 <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 <co de>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.equal s(Object[], Object[])</code>.</p>
1542
1543
1544 <h3><a name="EC_BAD_ARRAY_COMPARE">EC: Appel à equals() sur un tableau équivalen t à == (EC_BAD_ARRAY_COMPARE)</a></h3>
1545
1546
1547 <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 cont enus de tableaux, utilisez <code>java.util.Arrays.equals(Object[], Object[])</co de>.</p>
1548
1549
1550 <h3><a name="EC_INCOMPATIBLE_ARRAY_COMPARE">EC: equals(...) used to compare inco mpatible arrays (EC_INCOMPATIBLE_ARRAY_COMPARE)</a></h3>
1551
1552
1553 <p>
1554 This method invokes the .equals(Object o) to compare two arrays, but the arrays of
1555 of incompatible types (e.g., String[] and StringBuffer[], or String[] and int[]) .
1556 They will never be equal. In addition, when equals(...) is used to compare array s it
1557 only checks to see if they are the same array, and ignores the contents of the a rrays.
1558 </p>
1559
1560
1561 <h3><a name="EC_NULL_ARG">EC: Appel de equals() avec un argument à null (EC_NULL _ARG)</a></h3>
1562
1563
1564 <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()</co de>, cet appel devrait systématiquement renvoyer <code>false</code>.</p>
1565
1566
1567 <h3><a name="EC_UNRELATED_CLASS_AND_INTERFACE">EC: Appel de equals() comparant u ne classe et une interface sans relation (EC_UNRELATED_CLASS_AND_INTERFACE)</a>< /h3>
1568
1569
1570 <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 cl asses abstraites n'implémente l'interface. Les objets comparés ne font donc prob ablement pas partie de la même hiérarchie de classe à l'exécution (à moins que c ertaines classes de l'application n'est pas été analysées ou soient chargées dyn amiquement à l'exécution). En accord avec le contrat de <code>equals()</code>, d es objets de classes différentes doivent toujours être non égaux, donc le résult at de cette comparaison par <code>java.lang.Object.equals(Object)</code> renverr a systèmatiquement <code>false</code> à l'exécution.</p>
1571
1572
1573 <h3><a name="EC_UNRELATED_INTERFACES">EC: Appel de equals() comparant différente s interfaces (EC_UNRELATED_INTERFACES)</a></h3>
1574
1575
1576 <p>Cette méthode appelle <code>equals(Object)</code> pour deux références d'inte rfaces 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 pr obablement pas de la même classe à l'éxécution (au moins que certaines classes d e l'application n'aient pas été analysées ou qu'il y ait des chargements dynamiq ues). D'après le contrat de <code>equals()</code>, les objets de classes différe ntes devraient toujours être inégaux.</p>
1577
1578
1579 <h3><a name="EC_UNRELATED_TYPES">EC: Appel de equals() comparant des types diffé rents (EC_UNRELATED_TYPES)</a></h3>
1580
1581
1582 <p>Cette méthode appelle <code>equals(Object)</code> pour deux références de typ e différents, sans sous-classe commune. Les objets comparés ne sont donc probabl ement pas de la même classe à l'éxécution (au moins que certaines classes de l'a pplication 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 chanc es de toujours renvoyer <code>false</code> à l'exécution.</p>
1583
1584
1585 <h3><a name="EC_UNRELATED_TYPES_USING_POINTER_EQUALITY">EC: Using pointer equali ty to compare different types (EC_UNRELATED_TYPES_USING_POINTER_EQUALITY)</a></h 3>
1586
1587
1588 <p> This method uses using pointer equality to compare two references that seem to be of
1589 different types. The result of this comparison will always be false at runtime.
1590 </p>
1591
1592
1593 <h3><a name="EQ_ALWAYS_FALSE">Eq: equals method always returns false (EQ_ALWAYS_ FALSE)</a></h3>
1594
1595
1596 <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 Map s or Sets of this class. More fundamentally, it means
1597 that equals is not reflexive, one of the requirements of the equals method.</p>
1598 <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 n eed to override an equals inherited from a different
1599 superclass, you can use use:</p>
1600 <pre>
1601 public boolean equals(Object o) { return this == o; }
1602 </pre>
1603
1604
1605 <h3><a name="EQ_ALWAYS_TRUE">Eq: equals method always returns true (EQ_ALWAYS_TR UE)</a></h3>
1606
1607
1608 <p> This class defines an equals method that always returns true. This is imag inative, but not very smart.
1609 Plus, it means that the equals method is not symmetric.
1610 </p>
1611
1612
1613 <h3><a name="EQ_COMPARING_CLASS_NAMES">Eq: equals method compares class names ra ther than class objects (EQ_COMPARING_CLASS_NAMES)</a></h3>
1614
1615
1616 <p> This method checks to see if two objects are the same class by checking to see if the names
1617 of their classes are equal. You can have different classes with the same name if they are loaded by
1618 different class loaders. Just check to see if the class objects are the same.
1619 </p>
1620
1621
1622 <h3><a name="EQ_DONT_DEFINE_EQUALS_FOR_ENUM">Eq: Covariant equals() method defin ed for enum (EQ_DONT_DEFINE_EQUALS_FOR_ENUM)</a></h3>
1623
1624
1625 <p> This class defines an enumeration, and equality on enumerations are define d
1626 using object identity. Defining a covariant equals method for an enumeration
1627 value is exceptionally bad practice, since it would likely result
1628 in having two different enumeration values that compare as equals using
1629 the covariant enum method, and as not equal when compared normally.
1630 Don't do it.
1631 </p>
1632
1633
1634 <h3><a name="EQ_OTHER_NO_OBJECT">Eq: equals() method defined that doesn't overri de equals(Object) (EQ_OTHER_NO_OBJECT)</a></h3>
1635
1636
1637 <p> This class defines an <code>equals()</code>
1638 method, that doesn't override the normal <code>equals(Object)</code> method
1639 defined in the base <code>java.lang.Object</code> class.&nbsp; Instead, it
1640 inherits an <code>equals(Object)</code> method from a superclass.
1641 The class should probably define a <code>boolean equals(Object)</code> method.
1642 </p>
1643
1644
1645 <h3><a name="EQ_OTHER_USE_OBJECT">Eq: equals() method defined that doesn't overr ide Object.equals(Object) (EQ_OTHER_USE_OBJECT)</a></h3>
1646
1647
1648 <p> This class defines an <code>equals()</code>
1649 method, that doesn't override the normal <code>equals(Object)</code> method
1650 defined in the base <code>java.lang.Object</code> class.&nbsp;
1651 The class should probably define a <code>boolean equals(Object)</code> method.
1652 </p>
1653
1654
1655 <h3><a name="EQ_OVERRIDING_EQUALS_NOT_SYMMETRIC">Eq: equals method overrides equ als in superclass and may not be symmetric (EQ_OVERRIDING_EQUALS_NOT_SYMMETRIC)< /a></h3>
1656
1657
1658 <p> This class defines an equals method that overrides an equals method in a s uperclass. Both equals methods
1659 methods use <code>instanceof</code> in the determination of whether two objects are equal. This is fraught with peril,
1660 since it is important that the equals method is symmetrical (in other words, <co de>a.equals(b) == b.equals(a)</code>).
1661 If B is a subtype of A, and A's equals method checks that the argument is an ins tanceof A, and B's equals method
1662 checks that the argument is an instanceof B, it is quite likely that the equival ence relation defined by these
1663 methods is not symmetric.
1664 </p>
1665
1666
1667 <h3><a name="EQ_SELF_USE_OBJECT">Eq: Définition d'une méthode equals() covariant e, Object.equals(Object) est hérité (EQ_SELF_USE_OBJECT)</a></h3>
1668
1669
1670 <p>Cette classe définit une version covariante de la méthode <code>equals()</cod e>, 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éf inir une version non covariante de <code>equals()</code>. (C'est-à-dire une méth ode avec la signature <code>boolean equals(java.lang.Object)</code>.</p>
1671
1672
1673 <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>
1674
1675
1676 <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ématiquem ent <code>false</code>.</p>
1677 <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>
1678
1679
1680 <h3><a name="VA_FORMAT_STRING_BAD_ARGUMENT">FS: Format string placeholder incomp atible with passed argument (VA_FORMAT_STRING_BAD_ARGUMENT)</a></h3>
1681
1682
1683 <p>
1684 The format string placeholder is incompatible with the corresponding
1685 argument. For example,
1686 <code>
1687 System.out.println("%d\n", "hello");
1688 </code>
1689 <p>The %d placeholder requires a numeric argument, but a string value is
1690 passed instead.
1691 A runtime exception will occur when
1692 this statement is executed.
1693 </p>
1694
1695
1696 <h3><a name="VA_FORMAT_STRING_BAD_CONVERSION">FS: The type of a supplied argumen t doesn't match format specifier (VA_FORMAT_STRING_BAD_CONVERSION)</a></h3>
1697
1698
1699 <p>
1700 One of the arguments is uncompatible with the corresponding format string specif ier.
1701 As a result, this will generate a runtime exception when executed.
1702 For example, <code>String.format("%d", "1")</code> will generate an exception, s ince
1703 the String "1" is incompatible with the format specifier %d.
1704 </p>
1705
1706
1707 <h3><a name="VA_FORMAT_STRING_EXPECTED_MESSAGE_FORMAT_SUPPLIED">FS: MessageForma t supplied where printf style format expected (VA_FORMAT_STRING_EXPECTED_MESSAGE _FORMAT_SUPPLIED)</a></h3>
1708
1709
1710 <p>
1711 A method is called that expects a Java printf format string and a list of argume nts.
1712 However, the format string doesn't contain any format specifiers (e.g., %s) but
1713 does contain message format elements (e.g., {0}). It is likely
1714 that the code is supplying a MessageFormat string when a printf-style format str ing
1715 is required. At runtime, all of the arguments will be ignored
1716 and the format string will be returned exactly as provided without any formattin g.
1717 </p>
1718
1719
1720 <h3><a name="VA_FORMAT_STRING_EXTRA_ARGUMENTS_PASSED">FS: More arguments are pas sed than are actually used in the format string (VA_FORMAT_STRING_EXTRA_ARGUMENT S_PASSED)</a></h3>
1721
1722
1723 <p>
1724 A format-string method with a variable number of arguments is called,
1725 but more arguments are passed than are actually used by the format string.
1726 This won't cause a runtime exception, but the code may be silently omitting
1727 information that was intended to be included in the formatted string.
1728 </p>
1729
1730
1731 <h3><a name="VA_FORMAT_STRING_ILLEGAL">FS: Illegal format string (VA_FORMAT_STRI NG_ILLEGAL)</a></h3>
1732
1733
1734 <p>
1735 The format string is syntactically invalid,
1736 and a runtime exception will occur when
1737 this statement is executed.
1738 </p>
1739
1740
1741 <h3><a name="VA_FORMAT_STRING_MISSING_ARGUMENT">FS: Format string references mis sing argument (VA_FORMAT_STRING_MISSING_ARGUMENT)</a></h3>
1742
1743
1744 <p>
1745 Not enough arguments are passed to satisfy a placeholder in the format string.
1746 A runtime exception will occur when
1747 this statement is executed.
1748 </p>
1749
1750
1751 <h3><a name="VA_FORMAT_STRING_NO_PREVIOUS_ARGUMENT">FS: No previous argument for format string (VA_FORMAT_STRING_NO_PREVIOUS_ARGUMENT)</a></h3>
1752
1753
1754 <p>
1755 The format string specifies a relative index to request that the argument for th e previous format specifier
1756 be reused. However, there is no previous argument.
1757 For example,
1758 </p>
1759 <p><code>formatter.format("%&lt;s %s", "a", "b")</code>
1760 </p>
1761 <p>would throw a MissingFormatArgumentException when executed.
1762 </p>
1763
1764
1765 <h3><a name="GC_UNRELATED_TYPES">GC: No relationship between generic parameter a nd method argument (GC_UNRELATED_TYPES)</a></h3>
1766
1767
1768 <p> This call to a generic collection method contains an argument
1769 with an incompatible class from that of the collection's parameter
1770 (i.e., the type of the argument is neither a supertype nor a subtype
1771 of the corresponding generic type argument).
1772 Therefore, it is unlikely that the collection contains any objects
1773 that are equal to the method argument used here.
1774 Most likely, the wrong value is being passed to the method.</p>
1775 <p>In general, instances of two unrelated classes are not equal.
1776 For example, if the <code>Foo</code> and <code>Bar</code> classes
1777 are not related by subtyping, then an instance of <code>Foo</code>
1778 should not be equal to an instance of <code>Bar</code>.
1779 Among other issues, doing so will likely result in an equals method
1780 that is not symmetrical. For example, if you define the <code>Foo</code> cla ss
1781 so that a <code>Foo</code> can be equal to a <code>String</code>,
1782 your equals method isn't symmetrical since a <code>String</code> can only be equal
1783 to a <code>String</code>.
1784 </p>
1785 <p>In rare cases, people do define nonsymmetrical equals methods and still m anage to make
1786 their code work. Although none of the APIs document or guarantee it, it is t ypically
1787 the case that if you check if a <code>Collection&lt;String&gt;</code> contai ns
1788 a <code>Foo</code>, the equals method of argument (e.g., the equals method o f the
1789 <code>Foo</code> class) used to perform the equality checks.
1790 </p>
1791
1792
1793 <h3><a name="HE_SIGNATURE_DECLARES_HASHING_OF_UNHASHABLE_CLASS">HE: Signature de clares use of unhashable class in hashed construct (HE_SIGNATURE_DECLARES_HASHIN G_OF_UNHASHABLE_CLASS)</a></h3>
1794
1795
1796 <p> A method, field or class declares a generic signature where a non-hashable class
1797 is used in context where a hashable class is required.
1798 A class that declares an equals method but inherits a hashCode() method
1799 from Object is unhashable, since it doesn't fulfill the requirement that
1800 equal objects have equal hashCodes.
1801 </p>
1802
1803
1804 <h3><a name="HE_USE_OF_UNHASHABLE_CLASS">HE: Use of class without a hashCode() m ethod in a hashed data structure (HE_USE_OF_UNHASHABLE_CLASS)</a></h3>
1805
1806
1807 <p> A class defines an equals(Object) method but not a hashCode() method,
1808 and thus doesn't fulfill the requirement that equal objects have equal hashCodes .
1809 An instance of this class is used in a hash data structure, making the need to
1810 fix this problem of highest importance.
1811
1812
1813 <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>
1814
1815
1816 <p>
1817 This code converts a 32-bit int value to a 64-bit long value, and then
1818 passes that value for a method parameter that requires an absolute time value.
1819 An absolute time value is the number
1820 of milliseconds since the standard base time known as "the epoch", namely Januar y 1, 1970, 00:00:00 GMT.
1821 For example, the following method, intended to convert seconds since the epoch i nto a Date, is badly
1822 broken:</p>
1823 <pre>
1824 Date getDate(int seconds) { return new Date(seconds * 1000); }
1825 </pre>
1826 <p>The multiplication is done using 32-bit arithmetic, and then converted to a 6 4-bit value.
1827 When a 32-bit value is converted to 64-bits and used to express an absolute time
1828 value, only dates in December 1969 and January 1970 can be represented.</p>
1829
1830 <p>Correct implementations for the above method are:</p>
1831
1832 <pre>
1833 // Fails for dates after 2037
1834 Date getDate(int seconds) { return new Date(seconds * 1000L); }
1835
1836 // better, works for all dates
1837 Date getDate(long seconds) { return new Date(seconds * 1000); }
1838 </pre>
1839
1840
1841 <h3><a name="ICAST_INT_CAST_TO_DOUBLE_PASSED_TO_CEIL">ICAST: Valeur entière tran stypée en nombre flottant passée à Math.ceil (ICAST_INT_CAST_TO_DOUBLE_PASSED_TO _CEIL)</a></h3>
1842
1843
1844 <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 s ans 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>
1845
1846
1847 <h3><a name="ICAST_INT_CAST_TO_FLOAT_PASSED_TO_ROUND">ICAST: Valeur entière tran stypée en flottant puis transmise à Math.round (ICAST_INT_CAST_TO_FLOAT_PASSED_T O_ROUND)</a></h3>
1848
1849
1850 <p>Ce code converti une valeur entière en flottant simple précision puis la pass e à la méthode <code>Math.round()</code> qui renvoi l'<code>int</code> ou le <co de>long</code> le plus proche de son paramètre. Cette opération doit toujours re venir à 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 effe ctuée en arithmétique flottante.</p>
1851
1852
1853 <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_METH OD)</a></h3>
1854
1855
1856 <p> A JUnit assertion is performed in a run method. Failed JUnit assertions
1857 just result in exceptions being thrown.
1858 Thus, if this exception occurs in a thread other than the thread that invokes
1859 the test method, the exception will terminate the thread but not result
1860 in the test failing.
1861 </p>
1862
1863
1864 <h3><a name="IJU_BAD_SUITE_METHOD">IJU: TestCase declares a bad suite method (I JU_BAD_SUITE_METHOD)</a></h3>
1865
1866
1867 <p> Class is a JUnit TestCase and defines a suite() method.
1868 However, the suite method needs to be declared as either</p>
1869 <pre>public static junit.framework.Test suite()</pre>
1870 or
1871 <pre>public static junit.framework.TestSuite suite()</pre>
1872
1873
1874 <h3><a name="IJU_NO_TESTS">IJU: TestCase sans tests (IJU_NO_TESTS)</a></h3>
1875
1876
1877 <p>La classe JUnit <code>TestCase</code> n'implémente aucune méthode de test.</p >
1878
1879
1880 <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>
1881
1882
1883 <p>La classe dérive de la classe <code>TestCase</code> de JUnit est implémente l a méthode <code>setUp()</code>. La méthode <code>setUp()</code> devrait appeler <code>super.setUp()</code>, mais ne le fait pas.</p>
1884
1885
1886 <h3><a name="IJU_SUITE_NOT_STATIC">IJU: Une classe dérivant de TestCase implémen te une méthode suite() non statique (IJU_SUITE_NOT_STATIC)</a></h3>
1887
1888
1889 <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 comm e étant <code>static</code>, ce qui n'est pas fait.</p>
1890
1891
1892 <h3><a name="IJU_TEARDOWN_NO_SUPER">IJU: Une classe dérivant de TestCase impléme nte tearDown() sans appeler super.tearDown() (IJU_TEARDOWN_NO_SUPER)</a></h3>
1893
1894
1895 <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 app eler <code>super.tearDown()</code>, mais ne le fait pas.</p>
1896
1897
1898 <h3><a name="IL_CONTAINER_ADDED_TO_ITSELF">IL: Un conteneur est ajouté à lui-mêm e (IL_CONTAINER_ADDED_TO_ITSELF)</a></h3>
1899
1900
1901 <p>Un conteneur est ajouté à lui-même. Il en résulte que le calcul du code de ha chage de cet ensemble provequera une <code>StackOverflowEception</code>.</p>
1902
1903
1904 <h3><a name="IL_INFINITE_LOOP">IL: Boucle apparemment inifinie (IL_INFINITE_LOOP )</a></h3>
1905
1906
1907 <p>Cette boucle ne semble pas avoir un moyen de se terminer (autrement que, peut être, en déclenchant une exception).</p>
1908
1909
1910 <h3><a name="IL_INFINITE_RECURSIVE_LOOP">IL: Boucle récursive infinie (IL_INFINI TE_RECURSIVE_LOOP)</a></h3>
1911
1912
1913 <p>Cette méthode s'appelle elle-même sans condition. Cela semble indiquer une bo ucle récursive infinie qui se terminera sur un débordement de la pile.</p>
1914
1915
1916 <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>
1917
1918
1919 <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>
1920
1921
1922 <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>
1923
1924
1925 <p> This code compares an int value with a long constant that is outside
1926 the range of values that can be represented as an int value.
1927 This comparison is vacuous and possibily to be incorrect.
1928 </p>
1929
1930
1931 <h3><a name="INT_BAD_COMPARISON_WITH_NONNEGATIVE_VALUE">INT: Bad comparison of n onnegative value with negative constant or zero (INT_BAD_COMPARISON_WITH_NONNEGA TIVE_VALUE)</a></h3>
1932
1933
1934 <p> This code compares a value that is guaranteed to be non-negative with a nega tive constant or zero.
1935 </p>
1936
1937
1938 <h3><a name="INT_BAD_COMPARISON_WITH_SIGNED_BYTE">INT: Bad comparison of signed byte (INT_BAD_COMPARISON_WITH_SIGNED_BYTE)</a></h3>
1939
1940
1941 <p> Signed bytes can only have a value in the range -128 to 127. Comparing
1942 a signed byte with a value outside that range is vacuous and likely to be incorr ect.
1943 To convert a signed byte <code>b</code> to an unsigned value in the range 0..255 ,
1944 use <code>0xff &amp; b</code>
1945 </p>
1946
1947
1948 <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>
1949
1950
1951 <p>
1952 This code opens a file in append mode and then wraps the result in an objec t output stream.
1953 This won't allow you to append to an existing object output stream stored i n a file. If you want to be
1954 able to append to an object output stream, you need to keep the object outp ut stream open.
1955 </p>
1956 <p>The only situation in which opening a file in append mode and the writi ng an object output stream
1957 could work is if on reading the file you plan to open it in random access mode and seek to the byte offset
1958 where the append started.
1959 </p>
1960
1961 <p>
1962 TODO: example.
1963 </p>
1964
1965
1966 <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>
1967
1968
1969 <p>La valeur initiale de ce paramètre est ignorée, et le paramètre est écrasé. C eci indique généralement une erreur provenant de la croyance infondée qu'une écr iture sur ce paramètre sera transmise à l'appelant.</p>
1970
1971
1972 <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>
1973
1974
1975 <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 me ttent à jour ou accèdent à un des champs alors qu'elles souhaitaient utiliser l' autre.</p>
1976
1977
1978 <h3><a name="MF_METHOD_MASKS_FIELD">MF: La méthode définit une variable qui masq ue un champ (MF_METHOD_MASKS_FIELD)</a></h3>
1979
1980
1981 <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>
1982
1983
1984 <h3><a name="NP_ALWAYS_NULL">NP: Déréférencement d'un pointeur null dans la méth ode (NP_ALWAYS_NULL)</a></h3>
1985
1986
1987 <p>Un pointeur à <code>null</code> est déréférencé ici. Ceci va mener à une <cod e>NullPointerException</code> quand le code sera exécuté.</p>
1988
1989
1990 <h3><a name="NP_ALWAYS_NULL_EXCEPTION">NP: Déréférencement d'un pointeur null da ns le chemin d'exception d'une méthode (NP_ALWAYS_NULL_EXCEPTION)</a></h3>
1991
1992
1993 <p>Un pointeur à <code>null</code> dans le chemin d'exception est déréférencé ic i. Cela va mener à une <code>NullPointerException</code> quand le code sera exéc uté. Notez que puisque FindBugs ne détecte pas les chemins d'exception irréalisa bles, il est possible que cette alarme soit injustifiée.</p>
1994 <p>Notez aussi que FindBugs considère le choix par défaut d'un <code>switch</cod e> comme étant dans le chemin d'exception, puisque ce choix est souvent irréalis able.</p>
1995
1996
1997 <h3><a name="NP_ARGUMENT_MIGHT_BE_NULL">NP: Méthode ne testant pas les paramètre s à null (NP_ARGUMENT_MIGHT_BE_NULL)</a></h3>
1998
1999
2000 <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>
2001
2002
2003 <h3><a name="NP_CLOSING_NULL">NP: close() invoked on a value that is always null (NP_CLOSING_NULL)</a></h3>
2004
2005
2006 <p> close() is being invoked on a value that is always null. If this statement i s executed,
2007 a null pointer exception will occur. But the big risk here you never close
2008 something that should be closed.
2009
2010
2011 <h3><a name="NP_GUARANTEED_DEREF">NP: Null déréférencé (NP_GUARANTEED_DEREF)</a> </h3>
2012
2013
2014 <p>Cette méthode contient une valeur à <code>null</code> qui est déréférencée (s auf dans les chemins impliquant une RuntimeException).</p>
2015
2016
2017 <h3><a name="NP_GUARANTEED_DEREF_ON_EXCEPTION_PATH">NP: Value is null and guaran teed to be dereferenced on exception path (NP_GUARANTEED_DEREF_ON_EXCEPTION_PATH )</a></h3>
2018
2019
2020 <p>
2021 There is a statement or branch on an exception path
2022 that if executed guarantees that
2023 a value is null at this point, and that
2024 value that is guaranteed to be dereferenced
2025 (except on forward paths involving runtime exceptions).
2026 </p>
2027
2028
2029 <h3><a name="NP_NONNULL_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR">NP: Non-null field is not initialized (NP_NONNULL_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR)</a></h3>
2030
2031
2032 <p> The field is marked as non-null, but isn't written to by the construc tor.
2033 The field might be initialized elsewhere during constructor, or might always
2034 be initialized before use.
2035 </p>
2036
2037
2038 <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>
2039
2040
2041 <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>
2042 <p>Notez que la méthode avec l'annotation <code>@NonNull</code> peut être dans u ne sous-classe de l'objet appelé.</p>
2043
2044
2045 <h3><a name="NP_NONNULL_RETURN_VIOLATION">NP: Méthode renvoyer null mais déclaré e @NonNull (NP_NONNULL_RETURN_VIOLATION)</a></h3>
2046
2047
2048 <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 renv oyant <code>@NonNull</code>.</p>
2049
2050
2051 <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>
2052
2053
2054 <p>
2055 This instanceof test will always return false, since the value being checked is guaranteed to be null.
2056 Although this is safe, make sure it isn't
2057 an indication of some misunderstanding or some other logic error.
2058 </p>
2059
2060
2061 <h3><a name="NP_NULL_ON_SOME_PATH">NP: Possible déréférencement d'un pointeur nu ll dans une méthode (NP_NULL_ON_SOME_PATH)</a></h3>
2062
2063
2064 <p>Une valeur par référence déréférencée ici peut-être à <code>null</code> à l'e xécution. Cela peut conduire à une <code>NullPointerException</code> quand le co de est exécuté.</p>
2065
2066
2067 <h3><a name="NP_NULL_ON_SOME_PATH_EXCEPTION">NP: Possible déréférencement d'un p ointeur null dans le chemin d'exception d'une méthode (NP_NULL_ON_SOME_PATH_EXCE PTION)</a></h3>
2068
2069
2070 <p>Une valeur par référence qui est à <code>null</code> dans un des chemins d'ex ception est déréférencée ici. Ceci peut conduire à une <code>NullPointerExceptio n</code> à l'exécution du code. Notez que comme FindBugs ne repère pas les chemi ns d'exception irréalisables, il est possible que cette alarme soit injustifiée. </p>
2071 <p>Notez également que FindBugs considère le cas par défaut d'un <code>switch</c ode> comme faisant partie du chemin d'exception puisque ce cas est souvent inatt endu.</p>
2072
2073
2074 <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>
2075
2076
2077 <p>Cet appel de méthode envoie <code>null</code> à une méthode qui peut déréfére ncer ce paramètre de façon inconditionnelle.</p>
2078
2079
2080 <h3><a name="NP_NULL_PARAM_DEREF_ALL_TARGETS_DANGEROUS">NP: Appel de méthode pas sant null à un paramètre déréférencé inconditionnellement (NP_NULL_PARAM_DEREF_A LL_TARGETS_DANGEROUS)</a></h3>
2081
2082
2083 <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. Ce la a de fortes chances de provoquer une <code>NullPointerException</code>.</p>
2084
2085
2086 <h3><a name="NP_NULL_PARAM_DEREF_NONVIRTUAL">NP: Appel à une méthode non virtuel le passant null à un paramètre déréférencé de façon inconditionnelle (NP_NULL_PA RAM_DEREF_NONVIRTUAL)</a></h3>
2087
2088
2089 <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>N ullPointerException</code>.</p>
2090
2091
2092 <h3><a name="NP_OPTIONAL_RETURN_NULL">NP: Method with Optional return type retur ns explicit null (NP_OPTIONAL_RETURN_NULL)</a></h3>
2093
2094
2095 <p>
2096 The usage of Optional return type (java.util.Optional or com.google.common.b ase.Optiona)
2097 always mean that explicit null returns were not desired by design.
2098 Returning a null value in such case is a contract violation and will most li kely break clients code.
2099 </p>
2100
2101
2102 <h3><a name="NP_STORE_INTO_NONNULL_FIELD">NP: Stocke une valeur null dans un cha mp annoté NonNull (NP_STORE_INTO_NONNULL_FIELD)</a></h3>
2103
2104
2105 <p>Une valeur qui pourrait être à <code>null</code> est stockée dans un champ qu i a été annoté comme <code>NonNull</code>.</p>
2106
2107
2108 <h3><a name="NP_UNWRITTEN_FIELD">NP: Lecture d'un champ jamais écrit (NP_UNWRITT EN_FIELD)</a></h3>
2109
2110
2111 <p>Le programme déréférence un champ qui ne semble jamais alimenté par une valeu r non nulle. Déréférencer cette valeur provoquera une <code>NullPointerException </code>.</p>
2112
2113
2114 <h3><a name="NM_BAD_EQUAL">Nm: La classe définit equal() ; ne devrait-ce pas êtr e equals() ? (NM_BAD_EQUAL)</a></h3>
2115
2116
2117 <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>
2118
2119
2120 <h3><a name="NM_LCASE_HASHCODE">Nm: La classe définit hashcode() ; ne devrait-ce pas être hashCode() ? (NM_LCASE_HASHCODE)</a></h3>
2121
2122
2123 <p>Cette classe définit une méthode nommée <code>hashcode()</code>. Cette méthod e 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>
2124
2125
2126 <h3><a name="NM_LCASE_TOSTRING">Nm: La classe définit tostring() ; ne devrait-ce pas être toString() ? (NM_LCASE_TOSTRING)</a></h3>
2127
2128
2129 <p>Cette classe définit une méthode appelée <code>tostring()</code>. Cette métho de 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>
2130
2131
2132 <h3><a name="NM_METHOD_CONSTRUCTOR_CONFUSION">Nm: Confusion apparente entre une méthode et un constructeur (NM_METHOD_CONSTRUCTOR_CONFUSION)</a></h3>
2133
2134
2135 <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.
2136 Si c'est bien le cas, retirez la déclaration d'une valeur de retour.</p>
2137
2138
2139 <h3><a name="NM_VERY_CONFUSING">Nm: Noms de méthodes très ambigus (NM_VERY_CONFU SING)</a></h3>
2140
2141
2142 <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 pa r héritage.</p>
2143
2144
2145 <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>
2146
2147
2148 <p> The method in the subclass doesn't override a similar method in a supercla ss because the type of a parameter doesn't exactly match
2149 the type of the corresponding parameter in the superclass. For example, if you h ave:</p>
2150
2151 <blockquote>
2152 <pre>
2153 import alpha.Foo;
2154 public class A {
2155 public int f(Foo x) { return 17; }
2156 }
2157 ----
2158 import beta.Foo;
2159 public class B extends A {
2160 public int f(Foo x) { return 42; }
2161 }
2162 </pre>
2163 </blockquote>
2164
2165 <p>The <code>f(Foo)</code> method defined in class <code>B</code> doesn't
2166 override the
2167 <code>f(Foo)</code> method defined in class <code>A</code>, because the argument
2168 types are <code>Foo</code>'s from different packages.
2169 </p>
2170
2171
2172 <h3><a name="QBA_QUESTIONABLE_BOOLEAN_ASSIGNMENT">QBA: Méthode assignant une val eur boléenne fixe dans une expression booléenne (QBA_QUESTIONABLE_BOOLEAN_ASSIGN MENT)</a></h3>
2173
2174
2175 <p>Cette méthode assigne une valeur booléenne fixe (<code>true</code> ou <code>f alse</code>) à une variable booléenne dans une expression <code>if</code> ou <co de>while</code>. Il est probable que le but était d'effectuer une comparaison bo oléenne utilisant <code>==</code> et non pas une affectation avec <code>=</code> .</p>
2176
2177
2178 <h3><a name="RANGE_ARRAY_INDEX">RANGE: Array index is out of bounds (RANGE_ARRAY _INDEX)</a></h3>
2179
2180
2181 <p> Array operation is performed, but array index is out of bounds, which wil l result in ArrayIndexOutOfBoundsException at runtime.</p>
2182
2183
2184 <h3><a name="RANGE_ARRAY_LENGTH">RANGE: Array length is out of bounds (RANGE_ARR AY_LENGTH)</a></h3>
2185
2186
2187 <p> Method is called with array parameter and length parameter, but the lengt h is out of bounds. This will result in IndexOutOfBoundsException at runtime. </ p>
2188
2189
2190 <h3><a name="RANGE_ARRAY_OFFSET">RANGE: Array offset is out of bounds (RANGE_ARR AY_OFFSET)</a></h3>
2191
2192
2193 <p> Method is called with array parameter and offset parameter, but the offse t is out of bounds. This will result in IndexOutOfBoundsException at runtime. </ p>
2194
2195
2196 <h3><a name="RANGE_STRING_INDEX">RANGE: String index is out of bounds (RANGE_STR ING_INDEX)</a></h3>
2197
2198
2199 <p> String method is called and specified string index is out of bounds. This will result in StringIndexOutOfBoundsException at runtime. </p>
2200
2201
2202 <h3><a name="RC_REF_COMPARISON">RC: Comparaison de références suspecte (RC_REF_C OMPARISON)</a></h3>
2203
2204
2205 <p>Cette méthode compare deux références avec l'opérateur <code>==</code> ou <co de>!=</code>, alors que la façon correcte de comparer les instances de ce type e st généralement d'utiliser la méthode <code>equals()</code>. Des exemples de cla sses qui ne doivent généralement pas être comparées par référence sont <code>jav a.lang.Integer</code>, <code>java.lang.Float</code>, etc...</p>
2206
2207
2208 <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_BEE N_A_NPE)</a></h3>
2209
2210
2211 <p>Une valeur est testée ici pour savoir si elle est à <code>null</code> alors q ue cette valeur ne peut pas être à <code>null</code> puisqu'elle a été déréféren cée et qu'une <code>NullPointerException</code> se serait alors produite à ce mo ment. 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 redond ant, soit le déréférencement préalable est erroné.</p>
2212
2213
2214 <h3><a name="RE_BAD_SYNTAX_FOR_REGULAR_EXPRESSION">RE: Syntaxe d'expression régu lière invalide (RE_BAD_SYNTAX_FOR_REGULAR_EXPRESSION)</a></h3>
2215
2216
2217 <p>Le code utilise une expression régulière qui est invalide selon la syntaxe de s expressions régulières. Lors de l'exécution, une exception <code>PatternSyntax Exception</code> sera lancée.</p>
2218
2219
2220 <h3><a name="RE_CANT_USE_FILE_SEPARATOR_AS_REGULAR_EXPRESSION">RE: File.separato r used for regular expression (RE_CANT_USE_FILE_SEPARATOR_AS_REGULAR_EXPRESSION) </a></h3>
2221
2222
2223 <p>
2224 The code here uses <code>File.separator</code>
2225 where a regular expression is required. This will fail on Windows
2226 platforms, where the <code>File.separator</code> is a backslash, which is interp reted in a
2227 regular expression as an escape character. Amoung other options, you can just us e
2228 <code>File.separatorChar=='\\' ? "\\\\" : File.separator</code> instead of
2229 <code>File.separator</code>
2230
2231 </p>
2232
2233
2234 <h3><a name="RE_POSSIBLE_UNINTENDED_PATTERN">RE: "." utilisé dans une expression régulière (RE_POSSIBLE_UNINTENDED_PATTERN)</a></h3>
2235
2236
2237 <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>
2238
2239
2240 <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>
2241
2242
2243 <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>
2244
2245
2246 <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>
2247
2248
2249 <p> This code generates a hashcode and then computes
2250 the absolute value of that hashcode. If the hashcode
2251 is <code>Integer.MIN_VALUE</code>, then the result will be negative as well (sin ce
2252 <code>Math.abs(Integer.MIN_VALUE) == Integer.MIN_VALUE</code>).
2253 </p>
2254 <p>One out of 2^32 strings have a hashCode of Integer.MIN_VALUE,
2255 including "polygenelubricants" "GydZG_" and ""DESIGNING WORKHOUSES".
2256 </p>
2257
2258
2259 <h3><a name="RV_ABSOLUTE_VALUE_OF_RANDOM_INT">RV: Bad attempt to compute absolut e value of signed random integer (RV_ABSOLUTE_VALUE_OF_RANDOM_INT)</a></h3>
2260
2261
2262 <p> This code generates a random signed integer and then computes
2263 the absolute value of that random integer. If the number returned by the random number
2264 generator is <code>Integer.MIN_VALUE</code>, then the result will be negative as well (since
2265 <code>Math.abs(Integer.MIN_VALUE) == Integer.MIN_VALUE</code>). (Same problem ar ised for long values as well).
2266 </p>
2267
2268
2269 <h3><a name="RV_CHECK_COMPARETO_FOR_SPECIFIC_RETURN_VALUE">RV: Code checks for s pecific values returned by compareTo (RV_CHECK_COMPARETO_FOR_SPECIFIC_RETURN_VAL UE)</a></h3>
2270
2271
2272 <p> This code invoked a compareTo or compare method, and checks to see if the return value is a specific value,
2273 such as 1 or -1. When invoking these methods, you should only check the sign of the result, not for any specific
2274 non-zero value. While many or most compareTo and compare methods only return -1, 0 or 1, some of them
2275 will return other values.
2276
2277
2278 <h3><a name="RV_EXCEPTION_NOT_THROWN">RV: Exception created and dropped rather t han thrown (RV_EXCEPTION_NOT_THROWN)</a></h3>
2279
2280
2281 <p> This code creates an exception (or error) object, but doesn't do anything with it. For example,
2282 something like </p>
2283 <blockquote>
2284 <pre>
2285 if (x &lt; 0)
2286 new IllegalArgumentException("x must be nonnegative");
2287 </pre>
2288 </blockquote>
2289 <p>It was probably the intent of the programmer to throw the created exception:< /p>
2290 <blockquote>
2291 <pre>
2292 if (x &lt; 0)
2293 throw new IllegalArgumentException("x must be nonnegative");
2294 </pre>
2295 </blockquote>
2296
2297
2298 <h3><a name="RV_RETURN_VALUE_IGNORED">RV: La méthode ignore une valeur de retour (RV_RETURN_VALUE_IGNORED)</a></h3>
2299
2300
2301 <p>La valeur renvoyée par cette méthode devrait-être vérifiée. Une cause habitue lle de cette alarme est d'invoquer une méthode sur un objet constant en pensant que cela modifiera l'objet. Par exemple :</p>
2302 <blockquote>
2303 <pre>
2304 String dateString = getHeaderField(name);
2305 dateString.trim();
2306 </pre>
2307 </blockquote>
2308 <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 ob jets <code>String</code> étant constants, la fonction renvoi une nouvelle valeur qui est ici ignorée. Le code devrait être corrigé en :</p>
2309 <blockquote>
2310 <pre>
2311 String dateString = getHeaderField(name);
2312 dateString = dateString.trim();
2313 </pre>
2314 </blockquote>
2315
2316
2317 <h3><a name="RpC_REPEATED_CONDITIONAL_TEST">RpC: Repeated conditional tests (RpC _REPEATED_CONDITIONAL_TEST)</a></h3>
2318
2319
2320 <p>The code contains a conditional test is performed twice, one right after the other
2321 (e.g., <code>x == 0 || x == 0</code>). Perhaps the second occurrence is intended to be something else
2322 (e.g., <code>x == 0 || y == 0</code>).
2323 </p>
2324
2325
2326 <h3><a name="SA_FIELD_SELF_ASSIGNMENT">SA: Auto-alimentation d'un champs (SA_FIE LD_SELF_ASSIGNMENT)</a></h3>
2327
2328
2329 <p>Cette méthode contient un champ s'auto-alimentant; par exemple :</p>
2330 <pre>
2331 int x;
2332 public void foo() {
2333 x = x;
2334 }
2335 </pre>
2336 <p>De telles affectations sont inutiles et peuvent indiquer une faute de frappe ou une erreur logique.</p>
2337
2338
2339 <h3><a name="SA_FIELD_SELF_COMPARISON">SA: Self comparison of field with itself (SA_FIELD_SELF_COMPARISON)</a></h3>
2340
2341
2342 <p> This method compares a field with itself, and may indicate a typo or
2343 a logic error. Make sure that you are comparing the right things.
2344 </p>
2345
2346
2347 <h3><a name="SA_FIELD_SELF_COMPUTATION">SA: Nonsensical self computation involvi ng a field (e.g., x & x) (SA_FIELD_SELF_COMPUTATION)</a></h3>
2348
2349
2350 <p> This method performs a nonsensical computation of a field with another
2351 reference to the same field (e.g., x&x or x-x). Because of the nature
2352 of the computation, this operation doesn't seem to make sense,
2353 and may indicate a typo or
2354 a logic error. Double check the computation.
2355 </p>
2356
2357
2358 <h3><a name="SA_LOCAL_SELF_ASSIGNMENT_INSTEAD_OF_FIELD">SA: Self assignment of l ocal rather than assignment to field (SA_LOCAL_SELF_ASSIGNMENT_INSTEAD_OF_FIELD) </a></h3>
2359
2360
2361 <p> This method contains a self assignment of a local variable, and there
2362 is a field with an identical name.
2363 assignment appears to have been ; e.g.</p>
2364 <pre>
2365 int foo;
2366 public void setFoo(int foo) {
2367 foo = foo;
2368 }
2369 </pre>
2370 <p>The assignment is useless. Did you mean to assign to the field instead?</p>
2371
2372
2373 <h3><a name="SA_LOCAL_SELF_COMPARISON">SA: Self comparison of value with itself (SA_LOCAL_SELF_COMPARISON)</a></h3>
2374
2375
2376 <p> This method compares a local variable with itself, and may indicate a typo o r
2377 a logic error. Make sure that you are comparing the right things.
2378 </p>
2379
2380
2381 <h3><a name="SA_LOCAL_SELF_COMPUTATION">SA: Nonsensical self computation involvi ng a variable (e.g., x & x) (SA_LOCAL_SELF_COMPUTATION)</a></h3>
2382
2383
2384 <p> This method performs a nonsensical computation of a local variable with anot her
2385 reference to the same variable (e.g., x&x or x-x). Because of the nature
2386 of the computation, this operation doesn't seem to make sense,
2387 and may indicate a typo or
2388 a logic error. Double check the computation.
2389 </p>
2390
2391
2392 <h3><a name="SF_DEAD_STORE_DUE_TO_SWITCH_FALLTHROUGH">SF: Dead store due to swit ch statement fall through (SF_DEAD_STORE_DUE_TO_SWITCH_FALLTHROUGH)</a></h3>
2393
2394
2395 <p> A value stored in the previous switch case is overwritten here due to a sw itch fall through. It is likely that
2396 you forgot to put a break or return at the end of the previous case.
2397 </p>
2398
2399
2400 <h3><a name="SF_DEAD_STORE_DUE_TO_SWITCH_FALLTHROUGH_TO_THROW">SF: Dead store du e to switch statement fall through to throw (SF_DEAD_STORE_DUE_TO_SWITCH_FALLTHR OUGH_TO_THROW)</a></h3>
2401
2402
2403 <p> A value stored in the previous switch case is ignored here due to a switch fall through to a place where
2404 an exception is thrown. It is likely that
2405 you forgot to put a break or return at the end of the previous case.
2406 </p>
2407
2408
2409 <h3><a name="SIC_THREADLOCAL_DEADLY_EMBRACE">SIC: Deadly embrace of non-static i nner class and thread local (SIC_THREADLOCAL_DEADLY_EMBRACE)</a></h3>
2410
2411
2412 <p> This class is an inner class, but should probably be a static inner class.
2413 As it is, there is a serious danger of a deadly embrace between the inner clas s
2414 and the thread local in the outer class. Because the inner class isn't static,
2415 it retains a reference to the outer class.
2416 If the thread local contains a reference to an instance of the inner
2417 class, the inner and outer instance will both be reachable
2418 and not eligible for garbage collection.
2419 </p>
2420
2421
2422 <h3><a name="SIO_SUPERFLUOUS_INSTANCEOF">SIO: Vérification de type inutile avec l'opérateur instanceof (SIO_SUPERFLUOUS_INSTANCEOF)</a></h3>
2423
2424
2425 <p>Vérification de type effectuée avec l'opérateur <code>instanceof</code> alors que cela pourrait-être déterminé statiquement.</p>
2426
2427
2428 <h3><a name="SQL_BAD_PREPARED_STATEMENT_ACCESS">SQL: Méthode essayant au paramêt re d'indice 0 d'un PreparedStatement (SQL_BAD_PREPARED_STATEMENT_ACCESS)</a></h3 >
2429
2430
2431 <p>Un appel à une méthode <code>setXXX</code> d'un <code>PreparedStatement</cod e> est réalisé sur l'indice 0. Puisque les indices des paramêtres d'un <code>Pre paredStatement</code> commencent à 1, c'est toujours une erreur.</p>
2432
2433
2434 <h3><a name="SQL_BAD_RESULTSET_ACCESS">SQL: Méthode essayant d'accèder à un cham p de ResultSet d'indice 0 (SQL_BAD_RESULTSET_ACCESS)</a></h3>
2435
2436
2437 <p>Un appel à une méthode <code>getXXX</code> ou <code>updateXXX</code> d'un <co de>ResultSet</code> est réalisé pour l'indice 0. Puisque les indices de <code>Re sultSet</code> commencent à 1, c'est toujours une erreur.</p>
2438
2439
2440 <h3><a name="STI_INTERRUPTED_ON_CURRENTTHREAD">STI: Utilisation superflue d'un a ppel à currentThread() pour appeler interrupted() (STI_INTERRUPTED_ON_CURRENTTHR EAD)</a></h3>
2441
2442
2443 <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.interrupt ed()</code>.</p>
2444
2445
2446 <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>
2447
2448
2449 <p>Cette méthode invoque <code>Thread.interrupted()</code> sur un objet <code>Th read</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>
2450
2451
2452 <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>
2453
2454
2455 <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éri alisation/désérialisation.</p>
2456
2457
2458 <h3><a name="SE_READ_RESOLVE_IS_STATIC">Se: The readResolve method must not be d eclared as a static method. (SE_READ_RESOLVE_IS_STATIC)</a></h3>
2459
2460
2461 <p> In order for the readResolve method to be recognized by the serialization
2462 mechanism, it must not be declared as a static method.
2463 </p>
2464
2465
2466 <h3><a name="TQ_ALWAYS_VALUE_USED_WHERE_NEVER_REQUIRED">TQ: Value annotated as c arrying a type qualifier used where a value that must not carry that qualifier i s required (TQ_ALWAYS_VALUE_USED_WHERE_NEVER_REQUIRED)</a></h3>
2467
2468
2469 <p>
2470 A value specified as carrying a type qualifier annotation is
2471 consumed in a location or locations requiring that the value not
2472 carry that annotation.
2473 </p>
2474
2475 <p>
2476 More precisely, a value annotated with a type qualifier specifying when= ALWAYS
2477 is guaranteed to reach a use or uses where the same type qualifier speci fies when=NEVER.
2478 </p>
2479
2480 <p>
2481 For example, say that @NonNegative is a nickname for
2482 the type qualifier annotation @Negative(when=When.NEVER).
2483 The following code will generate this warning because
2484 the return statement requires a @NonNegative value,
2485 but receives one that is marked as @Negative.
2486 </p>
2487 <blockquote>
2488 <pre>
2489 public @NonNegative Integer example(@Negative Integer value) {
2490 return value;
2491 }
2492 </pre>
2493 </blockquote>
2494
2495
2496 <h3><a name="TQ_COMPARING_VALUES_WITH_INCOMPATIBLE_TYPE_QUALIFIERS">TQ: Comparin g values with incompatible type qualifiers (TQ_COMPARING_VALUES_WITH_INCOMPATIBL E_TYPE_QUALIFIERS)</a></h3>
2497
2498
2499 <p>
2500 A value specified as carrying a type qualifier annotation is
2501 compared with a value that doesn't ever carry that qualifier.
2502 </p>
2503
2504 <p>
2505 More precisely, a value annotated with a type qualifier specifying when= ALWAYS
2506 is compared with a value that where the same type qualifier specifies wh en=NEVER.
2507 </p>
2508
2509 <p>
2510 For example, say that @NonNegative is a nickname for
2511 the type qualifier annotation @Negative(when=When.NEVER).
2512 The following code will generate this warning because
2513 the return statement requires a @NonNegative value,
2514 but receives one that is marked as @Negative.
2515 </p>
2516 <blockquote>
2517 <pre>
2518 public boolean example(@Negative Integer value1, @NonNegative Integer value2) {
2519 return value1.equals(value2);
2520 }
2521 </pre>
2522 </blockquote>
2523
2524
2525 <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>
2526
2527
2528 <p>
2529 A value that is annotated as possibility not being an instance of
2530 the values denoted by the type qualifier, and the value is guaranteed to be used
2531 in a way that requires values denoted by that type qualifier.
2532 </p>
2533
2534
2535 <h3><a name="TQ_MAYBE_SOURCE_VALUE_REACHES_NEVER_SINK">TQ: Value that might carr y a type qualifier is always used in a way prohibits it from having that type qu alifier (TQ_MAYBE_SOURCE_VALUE_REACHES_NEVER_SINK)</a></h3>
2536
2537
2538 <p>
2539 A value that is annotated as possibility being an instance of
2540 the values denoted by the type qualifier, and the value is guaranteed to be used
2541 in a way that prohibits values denoted by that type qualifier.
2542 </p>
2543
2544
2545 <h3><a name="TQ_NEVER_VALUE_USED_WHERE_ALWAYS_REQUIRED">TQ: Value annotated as n ever carrying a type qualifier used where value carrying that qualifier is requi red (TQ_NEVER_VALUE_USED_WHERE_ALWAYS_REQUIRED)</a></h3>
2546
2547
2548 <p>
2549 A value specified as not carrying a type qualifier annotation is guarant eed
2550 to be consumed in a location or locations requiring that the value does
2551 carry that annotation.
2552 </p>
2553
2554 <p>
2555 More precisely, a value annotated with a type qualifier specifying when= NEVER
2556 is guaranteed to reach a use or uses where the same type qualifier speci fies when=ALWAYS.
2557 </p>
2558
2559 <p>
2560 TODO: example
2561 </p>
2562
2563
2564 <h3><a name="TQ_UNKNOWN_VALUE_USED_WHERE_ALWAYS_STRICTLY_REQUIRED">TQ: Value wit hout a type qualifier used where a value is required to have that qualifier (TQ_ UNKNOWN_VALUE_USED_WHERE_ALWAYS_STRICTLY_REQUIRED)</a></h3>
2565
2566
2567 <p>
2568 A value is being used in a way that requires the value be annotation wit h a type qualifier.
2569 The type qualifier is strict, so the tool rejects any values that do not hav e
2570 the appropriate annotation.
2571 </p>
2572
2573 <p>
2574 To coerce a value to have a strict annotation, define an identity functi on where the return value is annotated
2575 with the strict annotation.
2576 This is the only way to turn a non-annotated value into a value with a stric t type qualifier annotation.
2577 </p>
2578
2579
2580
2581 <h3><a name="UMAC_UNCALLABLE_METHOD_OF_ANONYMOUS_CLASS">UMAC: Méthode non appela ble définie dans une classe anonyme (UMAC_UNCALLABLE_METHOD_OF_ANONYMOUS_CLASS)< /a></h3>
2582
2583
2584 <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 au tres classes ne peuvent pas directement invoquer les méthodes des classes anonym es, il apparaît que cette méthode est inaccessible. Cette méthode est probableme nt du code mort, mais il est aussi possible qu'elle essaye de surcharger une mét hode déclarée dans la classe mère et échoue à le faire en raison d'une erreur de type ou autre.</p>
2585
2586
2587 <h3><a name="UR_UNINIT_READ">UR: Lecture d'un champ non initialisé dans un const ructeur (UR_UNINIT_READ)</a></h3>
2588
2589
2590 <p>Ce constructeur lit un champ qui n'a pas encore été initialisé. Une des cause s les plus fréquentes est l'utilisation accidentelle par le développeur du champ au lieu d'un des paramètres du constructeur.</p>
2591
2592
2593 <h3><a name="UR_UNINIT_READ_CALLED_FROM_SUPER_CONSTRUCTOR">UR: Uninitialized rea d of field method called from constructor of superclass (UR_UNINIT_READ_CALLED_F ROM_SUPER_CONSTRUCTOR)</a></h3>
2594
2595
2596 <p> This method is invoked in the constructor of of the superclass. At this po int,
2597 the fields of the class have not yet initialized.</p>
2598 <p>To make this more concrete, consider the following classes:</p>
2599 <pre>abstract class A {
2600 int hashCode;
2601 abstract Object getValue();
2602 A() {
2603 hashCode = getValue().hashCode();
2604 }
2605 }
2606 class B extends A {
2607 Object value;
2608 B(Object v) {
2609 this.value = v;
2610 }
2611 Object getValue() {
2612 return value;
2613 }
2614 }</pre>
2615 <p>When a <code>B</code> is constructed,
2616 the constructor for the <code>A</code> class is invoked
2617 <em>before</em> the constructor for <code>B</code> sets <code>value</code>.
2618 Thus, when the constructor for <code>A</code> invokes <code>getValue</code>,
2619 an uninitialized value is read for <code>value</code>
2620 </p>
2621
2622
2623 <h3><a name="DMI_INVOKING_TOSTRING_ON_ANONYMOUS_ARRAY">USELESS_STRING: Invocatio n of toString on an unnamed array (DMI_INVOKING_TOSTRING_ON_ANONYMOUS_ARRAY)</a> </h3>
2624
2625
2626 <p>
2627 The code invokes toString on an (anonymous) array. Calling toString on an array generates a fairly useless result
2628 such as [C@16f0472. Consider using Arrays.toString to convert the array into a r eadable
2629 String that gives the contents of the array. See Programming Puzzlers, chapter 3 , puzzle 12.
2630 </p>
2631
2632
2633 <h3><a name="DMI_INVOKING_TOSTRING_ON_ARRAY">USELESS_STRING: Invocation de toStr ing sur un tableau (DMI_INVOKING_TOSTRING_ON_ARRAY)</a></h3>
2634
2635
2636 <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 <cod e>String.valueOf</code> pour convertir un tableau en une chaine lisible contenan t les valeurs du tableau. Cf Programming Puzzlers, chapitre 3, problème 12.</p>
2637
2638
2639 <h3><a name="VA_FORMAT_STRING_BAD_CONVERSION_FROM_ARRAY">USELESS_STRING: Array f ormatted in useless way using format string (VA_FORMAT_STRING_BAD_CONVERSION_FRO M_ARRAY)</a></h3>
2640
2641
2642 <p>
2643 One of the arguments being formatted with a format string is an array. This will be formatted
2644 using a fairly useless format, such as [I@304282, which doesn't actually show th e contents
2645 of the array.
2646 Consider wrapping the array using <code>Arrays.asList(...)</code> before handlin g it off to a formatted.
2647 </p>
2648
2649
2650 <h3><a name="UWF_NULL_FIELD">UwF: Champ uniquement mis à null (UWF_NULL_FIELD)</ a></h3>
2651
2652
2653 <p>Ce champ est uniquement alimenté par la constante <code>null</code> et donc t outes les lectures de ce champ renverront <code>null</code>. Vérifiez si c'est u ne erreur ou alors supprimez ce champ qui est inutile.</p>
2654
2655
2656 <h3><a name="UWF_UNWRITTEN_FIELD">UwF: Champ jamais écrit (UWF_UNWRITTEN_FIELD)< /a></h3>
2657
2658
2659 <p>Ce champ n'est jamais alimenté. Toutes les lectures vont renvoyer sa valeur p ar défaut. Recherchez les erreurs (devrait-il avoir été initialisé ?) ou supprim ez le s'il est inutile.</p>
2660
2661
2662 <h3><a name="VA_PRIMITIVE_ARRAY_PASSED_TO_OBJECT_VARARG">VA: Tableau de primitiv es passé à une fonction attendant un nombre variable d'objets en argument (VA_PR IMITIVE_ARRAY_PASSED_TO_OBJECT_VARARG)</a></h3>
2663
2664
2665 <p>Ce code envoie un tableau de primitives à une fonction qui attend un nombre v ariable d'objets en arguments. Ceci créé un tableau de longueur 1 pour contenir le tableau de primitives puis le passe à la fonction.</p>
2666
2667
2668 <h3><a name="LG_LOST_LOGGER_DUE_TO_WEAK_REFERENCE">LG: Potential lost logger cha nges due to weak reference in OpenJDK (LG_LOST_LOGGER_DUE_TO_WEAK_REFERENCE)</a> </h3>
2669
2670
2671 <p>OpenJDK introduces a potential incompatibility.
2672 In particular, the java.util.logging.Logger behavior has
2673 changed. Instead of using strong references, it now uses weak references
2674 internally. That's a reasonable change, but unfortunately some code relies on
2675 the old behavior - when changing logger configuration, it simply drops the
2676 logger reference. That means that the garbage collector is free to reclaim
2677 that memory, which means that the logger configuration is lost. For example,
2678 consider:
2679 </p>
2680
2681 <pre>public static void initLogging() throws Exception {
2682 Logger logger = Logger.getLogger("edu.umd.cs");
2683 logger.addHandler(new FileHandler()); // call to change logger configuration
2684 logger.setUseParentHandlers(false); // another call to change logger configurat ion
2685 }</pre>
2686
2687 <p>The logger reference is lost at the end of the method (it doesn't
2688 escape the method), so if you have a garbage collection cycle just
2689 after the call to initLogging, the logger configuration is lost
2690 (because Logger only keeps weak references).</p>
2691
2692 <pre>public static void main(String[] args) throws Exception {
2693 initLogging(); // adds a file handler to the logger
2694 System.gc(); // logger configuration lost
2695 Logger.getLogger("edu.umd.cs").info("Some message"); // this isn't logged to th e file as expected
2696 }</pre>
2697 <p><em>Ulf Ochsenfahrt and Eric Fellheimer</em></p>
2698
2699
2700 <h3><a name="OBL_UNSATISFIED_OBLIGATION">OBL: Method may fail to clean up stream or resource (OBL_UNSATISFIED_OBLIGATION)</a></h3>
2701
2702
2703 <p>
2704 This method may fail to clean up (close, dispose of) a stream,
2705 database object, or other
2706 resource requiring an explicit cleanup operation.
2707 </p>
2708
2709 <p>
2710 In general, if a method opens a stream or other resource,
2711 the method should use a try/finally block to ensure that
2712 the stream or resource is cleaned up before the method
2713 returns.
2714 </p>
2715
2716 <p>
2717 This bug pattern is essentially the same as the
2718 OS_OPEN_STREAM and ODR_OPEN_DATABASE_RESOURCE
2719 bug patterns, but is based on a different
2720 (and hopefully better) static analysis technique.
2721 We are interested is getting feedback about the
2722 usefulness of this bug pattern.
2723 To send feedback, either:
2724 </p>
2725 <ul>
2726 <li>send email to findbugs@cs.umd.edu</li>
2727 <li>file a bug report: <a href="http://findbugs.sourceforge.net/repo rtingBugs.html">http://findbugs.sourceforge.net/reportingBugs.html</a></li>
2728 </ul>
2729
2730 <p>
2731 In particular,
2732 the false-positive suppression heuristics for this
2733 bug pattern have not been extensively tuned, so
2734 reports about false positives are helpful to us.
2735 </p>
2736
2737 <p>
2738 See Weimer and Necula, <i>Finding and Preventing Run-Time Error Handli ng Mistakes</i>, for
2739 a description of the analysis technique.
2740 </p>
2741
2742
2743 <h3><a name="OBL_UNSATISFIED_OBLIGATION_EXCEPTION_EDGE">OBL: Method may fail to clean up stream or resource on checked exception (OBL_UNSATISFIED_OBLIGATION_EXC EPTION_EDGE)</a></h3>
2744
2745
2746 <p>
2747 This method may fail to clean up (close, dispose of) a stream,
2748 database object, or other
2749 resource requiring an explicit cleanup operation.
2750 </p>
2751
2752 <p>
2753 In general, if a method opens a stream or other resource,
2754 the method should use a try/finally block to ensure that
2755 the stream or resource is cleaned up before the method
2756 returns.
2757 </p>
2758
2759 <p>
2760 This bug pattern is essentially the same as the
2761 OS_OPEN_STREAM and ODR_OPEN_DATABASE_RESOURCE
2762 bug patterns, but is based on a different
2763 (and hopefully better) static analysis technique.
2764 We are interested is getting feedback about the
2765 usefulness of this bug pattern.
2766 To send feedback, either:
2767 </p>
2768 <ul>
2769 <li>send email to findbugs@cs.umd.edu</li>
2770 <li>file a bug report: <a href="http://findbugs.sourceforge.net/repo rtingBugs.html">http://findbugs.sourceforge.net/reportingBugs.html</a></li>
2771 </ul>
2772
2773 <p>
2774 In particular,
2775 the false-positive suppression heuristics for this
2776 bug pattern have not been extensively tuned, so
2777 reports about false positives are helpful to us.
2778 </p>
2779
2780 <p>
2781 See Weimer and Necula, <i>Finding and Preventing Run-Time Error Handli ng Mistakes</i>, for
2782 a description of the analysis technique.
2783 </p>
2784
2785
2786 <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_C ONVERT_CASE)</a></h3>
2787
2788
2789 <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 l es caractères internationaux. Utilisez <code>String.toUpperCase(Locale l)</code> ou <code>String.toLowerCase(Locale l)</code> à la place.</p>
2790
2791
2792 <h3><a name="DM_DEFAULT_ENCODING">Dm: Reliance on default encoding (DM_DEFAULT_E NCODING)</a></h3>
2793
2794
2795 <p> Found a call to a method which will perform a byte to String (or String to b yte) conversion, and will assume that the default platform encoding is suitable. This will cause the application behaviour to vary between platforms. Use an alt ernative API and specify a charset name or Charset object explicitly. </p>
2796
2797
2798 <h3><a name="DP_CREATE_CLASSLOADER_INSIDE_DO_PRIVILEGED">DP: Les chargeurs de cl asses ne doivent être créés qu'à partir de block doPrivileged (DP_CREATE_CLASSLO ADER_INSIDE_DO_PRIVILEGED)</a></h3>
2799
2800
2801 <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 sera it appelé par du code ne possédant pas les droits requis.</p>
2802
2803
2804 <h3><a name="DP_DO_INSIDE_DO_PRIVILEGED">DP: Méthode invoquée alors qu'elle ne d evrait l'être qu'à partir d'un block doPrivileged (DP_DO_INSIDE_DO_PRIVILEGED)</ a></h3>
2805
2806
2807 <p>Ce code invoque une méthode qui nécessite un test de sécurité sur les permiss ions. 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érieu r d'un block <code>doPrivileged</code>.</p>
2808
2809
2810 <h3><a name="EI_EXPOSE_REP">EI: Une méthode peut exposer sa représentation inter ne en renvoyant une référence à un objet modifiable (EI_EXPOSE_REP)</a></h3>
2811
2812
2813 <p>Renvoyer une référence à un objet modifiable stocké dans les champs d'un obje t expose la représentation interne de l'objet. Si des instances sont accédées pa r du code non fiable, et que des modifications non vérifiées peuvent compromettr e 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 nombreu ses situations.</p>
2814
2815
2816 <h3><a name="EI_EXPOSE_REP2">EI2: Une méthode expose sa représentation interne e n incorporant une référence à un objet modifiable (EI_EXPOSE_REP2)</a></h3>
2817
2818
2819 <p>Ce code stocke une référence à un objet externe modifiable dans la représenta tion 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'aut res propriétés importantes, vous devez faire autre chose. Stocker une copie de l 'objet est une meilleur approche dans de nombreuses situations.</p>
2820
2821
2822 <h3><a name="FI_PUBLIC_SHOULD_BE_PROTECTED">FI: Un finaliseur devrait être proté gé, pas public (FI_PUBLIC_SHOULD_BE_PROTECTED)</a></h3>
2823
2824
2825 <p>La méthode <code>finalize()</code> d'une classe devrait avoir un accès protég é, pas public.</p>
2826
2827
2828 <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_STA TIC_REP2)</a></h3>
2829
2830
2831 <p>Ce code stocke une référence à un objet modifiable externe dans un champs sta tique. Si des modifications non vérifiées de l'objet modifiable peuvent comprome ttre la sécurité ou d'autres propriétés importantes, vous devez faire autre chos e. Stocker une copie de l'objet est souvent une meilleur approche.</p>
2832
2833
2834 <h3><a name="MS_CANNOT_BE_FINAL">MS: Un champ n'est pas final et ne peut pas êtr e protégé face à du code malveillant (MS_CANNOT_BE_FINAL)</a></h3>
2835
2836
2837 <p>Un champ statique modifiable peut-être modifié par accident ou par du code ma lveillant. Malheureusement, la façon dont ce champ est utilisé ne permet une cor rection aisée de ce problème.</p>
2838
2839
2840 <h3><a name="MS_EXPOSE_REP">MS: Une méthode statique publique risque d'exposer u ne représentation interne en renvoyant un tableau (MS_EXPOSE_REP)</a></h3>
2841
2842
2843 <p>Une méthode statique publique renvoit une référence à un tableau faisant part ie de l'état statique de la classe. Tout code appelant cette méthode peut librem ent modifier le tableau sous-jacent. Une correction possible serait de renvoyer une copie du tableau.</p>
2844
2845
2846 <h3><a name="MS_FINAL_PKGPROTECT">MS: Le champ devrait être à la fois final et p ackage protected (MS_FINAL_PKGPROTECT)</a></h3>
2847
2848
2849 <p>Un champ statique modifiable peut-être changé par accident ou par du code mal veillant d'un autre paquetage. Le champ devrait être package protected et/ou fin al pour éviter cette vulnérabilité.</p>
2850
2851
2852 <h3><a name="MS_MUTABLE_ARRAY">MS: Un champ est un tableau modifiable (MS_MUTABL E_ARRAY)</a></h3>
2853
2854
2855 <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 libremen t modifier le contenu du tableau.</p>
2856
2857
2858 <h3><a name="MS_MUTABLE_COLLECTION">MS: Field is a mutable collection (MS_MUTABL E_COLLECTION)</a></h3>
2859
2860
2861 <p>A mutable collection instance is assigned to a final static field,
2862 thus can be changed by malicious code or by accident from another package.
2863 Consider wrapping this field into Collections.unmodifiableSet/List/Map/etc.
2864 to avoid this vulnerability.</p>
2865
2866
2867 <h3><a name="MS_MUTABLE_COLLECTION_PKGPROTECT">MS: Field is a mutable collection which should be package protected (MS_MUTABLE_COLLECTION_PKGPROTECT)</a></h3>
2868
2869
2870 <p>A mutable collection instance is assigned to a final static field,
2871 thus can be changed by malicious code or by accident from another package.
2872 The field could be made package protected to avoid this vulnerability.
2873 Alternatively you may wrap this field into Collections.unmodifiableSet/List/M ap/etc.
2874 to avoid this vulnerability.</p>
2875
2876
2877 <h3><a name="MS_MUTABLE_HASHTABLE">MS: Un champ modifiable est une Hashtable (MS _MUTABLE_HASHTABLE)</a></h3>
2878
2879
2880 <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 co de peut librement modifier le contenu de la <code>Hashtable</code>.</p>
2881
2882
2883 <h3><a name="MS_OOI_PKGPROTECT">MS: Le champ devrait être sorti de l'interface e t mis en package protected (MS_OOI_PKGPROTECT)</a></h3>
2884
2885
2886 <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 évi ter cette vulnérabilité, le champ doit être intégré dans une classe et sa visibi lité modifiée en package protected.</p>
2887
2888
2889 <h3><a name="MS_PKGPROTECT">MS: Un champ devrait être package protected (MS_PKGP ROTECT)</a></h3>
2890
2891
2892 <p>Un champ statique modifiable peut-être changé par accident ou par du code mal veillant d'un autre paquetage. Le champ devrait être package protected pour évit er cette vulnérabilité.</p>
2893
2894
2895 <h3><a name="MS_SHOULD_BE_FINAL">MS: Un champ n'est pas final alors qu'il devrai t l'être (MS_SHOULD_BE_FINAL)</a></h3>
2896
2897
2898 <p>Un champ statique modifiable peut-être changé par accident ou par du code mal veillant d'un autre paquetage. Le champ devrait être final pour éviter cette vul nérabilité.</p>
2899
2900
2901 <h3><a name="MS_SHOULD_BE_REFACTORED_TO_BE_FINAL">MS: Field isn't final but shou ld be refactored to be so (MS_SHOULD_BE_REFACTORED_TO_BE_FINAL)</a></h3>
2902
2903
2904 <p>
2905 This static field public but not final, and
2906 could be changed by malicious code or
2907 by accident from another package.
2908 The field could be made final to avoid
2909 this vulnerability. However, the static initializer contains more than one write
2910 to the field, so doing so will require some refactoring.
2911 </p>
2912
2913
2914 <h3><a name="AT_OPERATION_SEQUENCE_ON_CONCURRENT_ABSTRACTION">AT: Sequence of ca lls to concurrent abstraction may not be atomic (AT_OPERATION_SEQUENCE_ON_CONCUR RENT_ABSTRACTION)</a></h3>
2915
2916
2917 <p>This code contains a sequence of calls to a concurrent abstraction
2918 (such as a concurrent hash map).
2919 These calls will not be executed atomically.
2920
2921
2922 <h3><a name="DC_DOUBLECHECK">DC: Possible double vérification d'un champ (DC_DOU BLECHECK)</a></h3>
2923
2924
2925 <p>Cette méthode contient peut-être une instance de verrou par double vérificati on. 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/~pug h/java/memoryModel/DoubleCheckedLocking.html">http://www.cs.umd.edu/~pugh/java/m emoryModel/DoubleCheckedLocking.html</a>.</p>
2926
2927
2928 <h3><a name="DC_PARTIALLY_CONSTRUCTED">DC: Possible exposure of partially initia lized object (DC_PARTIALLY_CONSTRUCTED)</a></h3>
2929
2930
2931 <p>Looks like this method uses lazy field initialization with double-checked l ocking.
2932 While the field is correctly declared as volatile, it's possible that the inte rnal structure of
2933 the object is changed after the field assignment, thus another thread may see the partially initialized object.</p>
2934 <p>To fix this problem consider storing the object into the local variable fir st
2935 and save it to the volatile field only after it's fully constructed.
2936 </p>
2937
2938
2939 <h3><a name="DL_SYNCHRONIZATION_ON_BOOLEAN">DL: Synchronization on Boolean (DL_S YNCHRONIZATION_ON_BOOLEAN)</a></h3>
2940
2941
2942 <p> The code synchronizes on a boxed primitive constant, such as an Boolean.</ p>
2943 <pre>
2944 private static Boolean inited = Boolean.FALSE;
2945 ...
2946 synchronized(inited) {
2947 if (!inited) {
2948 init();
2949 inited = Boolean.TRUE;
2950 }
2951 }
2952 ...
2953 </pre>
2954 <p>Since there normally exist only two Boolean objects, this code could be synch ronizing on the same object as other, unrelated code, leading to unresponsivenes s
2955 and possible deadlock</p>
2956 <p>See CERT <a href="https://www.securecoding.cert.org/confluence/display/java/C ON08-J.+Do+not+synchronize+on+objects+that+may+be+reused">CON08-J. Do not synchr onize on objects that may be reused</a> for more information.</p>
2957
2958
2959 <h3><a name="DL_SYNCHRONIZATION_ON_BOXED_PRIMITIVE">DL: Synchronization on boxed primitive (DL_SYNCHRONIZATION_ON_BOXED_PRIMITIVE)</a></h3>
2960
2961
2962 <p> The code synchronizes on a boxed primitive constant, such as an Integer.</ p>
2963 <pre>
2964 private static Integer count = 0;
2965 ...
2966 synchronized(count) {
2967 count++;
2968 }
2969 ...
2970 </pre>
2971 <p>Since Integer objects can be cached and shared,
2972 this code could be synchronizing on the same object as other, unrelated code, le ading to unresponsiveness
2973 and possible deadlock</p>
2974 <p>See CERT <a href="https://www.securecoding.cert.org/confluence/display/java/C ON08-J.+Do+not+synchronize+on+objects+that+may+be+reused">CON08-J. Do not synchr onize on objects that may be reused</a> for more information.</p>
2975
2976
2977 <h3><a name="DL_SYNCHRONIZATION_ON_SHARED_CONSTANT">DL: Synchronization on inter ned String (DL_SYNCHRONIZATION_ON_SHARED_CONSTANT)</a></h3>
2978
2979
2980 <p> The code synchronizes on interned String.</p>
2981 <pre>
2982 private static String LOCK = "LOCK";
2983 ...
2984 synchronized(LOCK) { ...}
2985 ...
2986 </pre>
2987 <p>Constant Strings are interned and shared across all other classes loaded by t he JVM. Thus, this could
2988 is locking on something that other code might also be locking. This could result in very strange and hard to diagnose
2989 blocking and deadlock behavior. See <a href="http://www.javalobby.org/java/forum s/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/JETT Y-352</a>.
2990 </p>
2991 <p>See CERT <a href="https://www.securecoding.cert.org/confluence/display/java/C ON08-J.+Do+not+synchronize+on+objects+that+may+be+reused">CON08-J. Do not synchr onize on objects that may be reused</a> for more information.</p>
2992
2993
2994 <h3><a name="DL_SYNCHRONIZATION_ON_UNSHARED_BOXED_PRIMITIVE">DL: Synchronization on boxed primitive values (DL_SYNCHRONIZATION_ON_UNSHARED_BOXED_PRIMITIVE)</a>< /h3>
2995
2996
2997 <p> The code synchronizes on an apparently unshared boxed primitive,
2998 such as an Integer.</p>
2999 <pre>
3000 private static final Integer fileLock = new Integer(1);
3001 ...
3002 synchronized(fileLock) {
3003 .. do something ..
3004 }
3005 ...
3006 </pre>
3007 <p>It would be much better, in this code, to redeclare fileLock as</p>
3008 <pre>
3009 private static final Object fileLock = new Object();
3010 </pre>
3011 <p>
3012 The existing code might be OK, but it is confusing and a
3013 future refactoring, such as the "Remove Boxing" refactoring in IntelliJ,
3014 might replace this with the use of an interned Integer object shared
3015 throughout the JVM, leading to very confusing behavior and potential deadlock.
3016 </p>
3017
3018
3019 <h3><a name="DM_MONITOR_WAIT_ON_CONDITION">Dm: Wait() appelé sur une Condition ( DM_MONITOR_WAIT_ON_CONDITION)</a></h3>
3020
3021
3022 <p>Cette méthode appelle <code>wait()</code> sur un objet <code>java.util.concur rent.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'inte rface <code>Condition</code>.</p>
3023
3024
3025 <h3><a name="DM_USELESS_THREAD">Dm: Thread créé avec la méthode run vide par déf aut (DM_USELESS_THREAD)</a></h3>
3026
3027
3028 <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>
3029
3030
3031 <h3><a name="ESync_EMPTY_SYNC">ESync: Bloc synchronisé vide (ESync_EMPTY_SYNC)</ a></h3>
3032
3033
3034 <p>Présence d'un bloc synchronisé vide:</p>
3035 <pre>
3036 synchronized() {}
3037 </pre>
3038 <p>L'utilisation de blocs synchronisés vides est bien plus subtile et dure à réa liser correctement que bien des gens ne le reconnaissent, et de plus ne correspo nd que rarement à la meilleure des solutions.</p>
3039
3040
3041 <h3><a name="IS2_INCONSISTENT_SYNC">IS: Synchronisation incohérente (IS2_INCONSI STENT_SYNC)</a></h3>
3042
3043
3044 <p>Les champs de cette classe semblent être accédés de façon incohérente vis-à-v is de la synchronisation. Le détecteur de bogue juge que :</p>
3045 <ol>
3046 <li>la classe contient un mélange d'accès verrouillés et non verrouillés,</li>
3047 <li>au moins un des accès verrouillés est effectué par une des propres méthode s de la classe,</li>
3048 <li>le nombre d'accès (lectures et écritures) non synchronisés ne représente p as plus d'un tiers de tous les accès, avec plus de deux fois plus d'écritures qu e de lectures.</li>
3049 </ol>
3050 <p>Un bogue typique déclenchant ce détecteur est l'oubli de la synchronisation s ur l'une des méthodes d'une classe qui essaye d'être sûre vis-à-vis des threads. </p>
3051 <p>Vous pouvez sélectionner les noeuds nommés "Accès non synchronisés" pour avoi r la position exacte dans le code où le détecteur pense qu'un champ est accédé s ans synchronisation.</p>
3052 <p>Notez qu'il y a diverses sources d'inexactitude dans ce détecteur ; par exemp le, le détecteur ne peut pas repérer statiquement toutes les situations dans les quelles un verrou est obtenu. En fait, même lorsque le détecteur repère effectiv ement des accès avec et sans verrou, le code concerné peut quand même être corre ct.</p>
3053 <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>
3054
3055
3056 <h3><a name="IS_FIELD_NOT_GUARDED">IS: Champ non protégé contre les accès concur rents (IS_FIELD_NOT_GUARDED)</a></h3>
3057
3058
3059 <p>Ce champ est annoté avec <code>net.jcip.annotations.GuardedBy</code>, mais pe ut être utilisé d'une façon qui contredit l'annotation.</p>
3060
3061
3062 <h3><a name="JLM_JSR166_LOCK_MONITORENTER">JLM: Synchronisation effectuée sur un Lock java.util.concurrent (JLM_JSR166_LOCK_MONITORENTER)</a></h3>
3063
3064
3065 <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>l ock()</code> et <code>unlock()</code>.</p>
3066
3067
3068 <h3><a name="JLM_JSR166_UTILCONCURRENT_MONITORENTER">JLM: Synchronization perfor med on util.concurrent instance (JLM_JSR166_UTILCONCURRENT_MONITORENTER)</a></h3 >
3069
3070
3071 <p> This method performs synchronization an object that is an instance of
3072 a class from the java.util.concurrent package (or its subclasses). Instances
3073 of these classes have their own concurrency control mechanisms that are orthogon al to
3074 the synchronization provided by the Java keyword <code>synchronized</code>. For example,
3075 synchronizing on an <code>AtomicBoolean</code> will not prevent other threads
3076 from modifying the <code>AtomicBoolean</code>.</p>
3077 <p>Such code may be correct, but should be carefully reviewed and documented,
3078 and may confuse people who have to maintain the code at a later date.
3079 </p>
3080
3081
3082 <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_THA N_AWAIT)</a></h3>
3083
3084
3085 <p> This method calls
3086 <code>wait()</code>,
3087 <code>notify()</code> or
3088 <code>notifyAll()()</code>
3089 on an object that also provides an
3090 <code>await()</code>,
3091 <code>signal()</code>,
3092 <code>signalAll()</code> method (such as util.concurrent Condition objects).
3093 This probably isn't what you want, and even if you do want it, you should consid er changing
3094 your design, as other developers will find it exceptionally confusing.
3095 </p>
3096
3097
3098 <h3><a name="LI_LAZY_INIT_STATIC">LI: Initialisation paresseuse incorrecte d'un champ statique (LI_LAZY_INIT_STATIC)</a></h3>
3099
3100
3101 <p>Cette méthode contient une initialisation paresseuse non synchronisée d'un ch amp statique non <code>volatile</code>. Comme le compilateur ou le processeur pe uvent réordonner les instructions, les threads ne sont pas certains de voir un o bjet complètement initialisé, <em>si la méthode peut-être appelée par de multipl es threads</em>. Vous pouvez rendre le champs <code>volatile</code> pour corrige r le problème. Pour plus d'informations, cf. <a href="http://www.cs.umd.edu/~pug h/java/memoryModel/">site Web sur le modèle mémoire de Java</a>.</p>
3102
3103
3104 <h3><a name="LI_LAZY_INIT_UPDATE_STATIC">LI: Incorrect lazy initialization and u pdate of static field (LI_LAZY_INIT_UPDATE_STATIC)</a></h3>
3105
3106
3107 <p> This method contains an unsynchronized lazy initialization of a static field .
3108 After the field is set, the object stored into that location is further updated or accessed.
3109 The setting of the field is visible to other threads as soon as it is set. If th e
3110 futher accesses in the method that set the field serve to initialize the object, then
3111 you have a <em>very serious</em> multithreading bug, unless something else preve nts
3112 any other thread from accessing the stored object until it is fully initialized.
3113 </p>
3114 <p>Even if you feel confident that the method is never called by multiple
3115 threads, it might be better to not set the static field until the value
3116 you are setting it to is fully populated/initialized.
3117
3118
3119 <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_CHANGI NG_THAT_FIELD)</a></h3>
3120
3121
3122 <p> This method synchronizes on a field in what appears to be an attempt
3123 to guard against simultaneous updates to that field. But guarding a field
3124 gets a lock on the referenced object, not on the field. This may not
3125 provide the mutual exclusion you need, and other threads might
3126 be obtaining locks on the referenced objects (for other purposes). An example
3127 of this pattern would be:</p>
3128 <pre>
3129 private Long myNtfSeqNbrCounter = new Long(0);
3130 private Long getNotificationSequenceNumber() {
3131 Long result = null;
3132 synchronized(myNtfSeqNbrCounter) {
3133 result = new Long(myNtfSeqNbrCounter.longValue() + 1);
3134 myNtfSeqNbrCounter = new Long(result.longValue());
3135 }
3136 return result;
3137 }
3138 </pre>
3139
3140
3141 <h3><a name="ML_SYNC_ON_UPDATED_FIELD">ML: La méthode se synchronise sur un cham p mis à jour (ML_SYNC_ON_UPDATED_FIELD)</a></h3>
3142
3143
3144 <p>Cette méthode se synchronise sur le champ modifiable d'une référence objet. I l y a peu de chances que cela ait un sens puisque les différents threads se sync hroniserons par rapport à différents objets.</p>
3145
3146
3147 <h3><a name="MSF_MUTABLE_SERVLET_FIELD">MSF: Mutable servlet field (MSF_MUTABLE_ SERVLET_FIELD)</a></h3>
3148
3149
3150 <p>A web server generally only creates one instance of servlet or jsp class (i.e ., treats
3151 the class as a Singleton),
3152 and will
3153 have multiple threads invoke methods on that instance to service multiple
3154 simultaneous requests.
3155 Thus, having a mutable instance field generally creates race conditions.
3156
3157
3158 <h3><a name="MWN_MISMATCHED_NOTIFY">MWN: notify() non appareillé (MWN_MISMATCHED _NOTIFY)</a></h3>
3159
3160
3161 <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éclench ement d'une <code>IllegalMonitorStateException</code>.</p>
3162
3163
3164 <h3><a name="MWN_MISMATCHED_WAIT">MWN: wait() non appareillé (MWN_MISMATCHED_WAI T)</a></h3>
3165
3166
3167 <p>Cette méthode appelle <code>Object.wait()</code> sans détenir, visiblement, d e verrou sur l'objet. Appeler <code>wait()</code> sans détenir de verrou entraîn e le déclenchement d'une <code>IllegalMonitorStateException</code>.</p>
3168
3169
3170 <h3><a name="NN_NAKED_NOTIFY">NN: Appel notify() isolé dans une méthode (NN_NAKE D_NOTIFY)</a></h3>
3171
3172
3173 <p>Un appel à <code>notify()</code> ou <code>notifyAll()</code> est effectué san s aucun changement (apparent) de l'état d'un objet modifiable. En général, appel er 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 l es cas, pour que la condition ait un sens, elle doit porter sur un objet visible des deux threads.</p>
3174 <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 cont enant la notification.</p>
3175
3176
3177 <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>
3178
3179
3180 <p>Since the field is synchronized on, it seems not likely to be null.
3181 If it is null and then synchronized on a NullPointerException will be
3182 thrown and the check would be pointless. Better to synchronize on
3183 another field.</p>
3184
3185
3186
3187 <h3><a name="NO_NOTIFY_NOT_NOTIFYALL">No: Utilisation de notify() plutôt que not ifyAll() dans une méthode (NO_NOTIFY_NOT_NOTIFYALL)</a></h3>
3188
3189
3190 <p>Cette méthode appelle <code>notify()</code> plutôt que <code>notifyAll()</cod e>. 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év eillé peut ne pas être celui qui attend la condition que l'appelant vient de rem plir.</p>
3191
3192
3193 <h3><a name="RS_READOBJECT_SYNC">RS: Seule la méthode readObject() est synchroni sée (RS_READOBJECT_SYNC)</a></h3>
3194
3195
3196 <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 à synchro niser <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 c ode très douteux.</p>
3197
3198
3199 <h3><a name="RV_RETURN_VALUE_OF_PUTIFABSENT_IGNORED">RV: Return value of putIfAb sent ignored, value passed to putIfAbsent reused (RV_RETURN_VALUE_OF_PUTIFABSENT _IGNORED)</a></h3>
3200
3201
3202 The <code>putIfAbsent</code> method is typically used to ensure that a
3203 single value is associated with a given key (the first value for which p ut
3204 if absent succeeds).
3205 If you ignore the return value and retain a reference to the value passe d in,
3206 you run the risk of retaining a value that is not the one that is associ ated with the key in the map.
3207 If it matters which one you use and you use the one that isn't stored in the map,
3208 your program will behave incorrectly.
3209
3210
3211 <h3><a name="RU_INVOKE_RUN">Ru: Invocation de run() sur un thread (Vouliez-vous plutôt dire start() ?) (RU_INVOKE_RUN)</a></h3>
3212
3213
3214 <p>Cette méthode appelle explicitement <code>run()</code> sur un objet. En génér al, les classes implémentent l'interface <code>Runnable</code> parce qu'elles vo nt 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>
3215
3216
3217 <h3><a name="SC_START_IN_CTOR">SC: Un constructeur invoque Thread.start() (SC_ST ART_IN_CTOR)</a></h3>
3218
3219
3220 <p>Le constructeur lance un thread. Il y a de fortes chances que ce soit une err eur si cette classe est un jour dérivée ou étendue puisque que le thread sera al ors lancé avant que le constructeur de la classe dérivée ne soit appelé.</p>
3221
3222
3223 <h3><a name="SP_SPIN_ON_FIELD">SP: Méthode bouclant sur un champ (SP_SPIN_ON_FIE LD)</a></h3>
3224
3225
3226 <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>
3227
3228
3229 <h3><a name="STCAL_INVOKE_ON_STATIC_CALENDAR_INSTANCE">STCAL: Call to static Cal endar (STCAL_INVOKE_ON_STATIC_CALENDAR_INSTANCE)</a></h3>
3230
3231
3232 <p>Even though the JavaDoc does not contain a hint about it, Calendars are inher ently unsafe for multihtreaded use.
3233 The detector has found a call to an instance of Calendar that has been obtained via a static
3234 field. This looks suspicous.</p>
3235 <p>For more information on this see <a href="http://bugs.sun.com/bugdatabase/vie w_bug.do?bug_id=6231579">Sun Bug #6231579</a>
3236 and <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6178997">Sun Bug #6178997</a>.</p>
3237
3238
3239 <h3><a name="STCAL_INVOKE_ON_STATIC_DATE_FORMAT_INSTANCE">STCAL: Call to static DateFormat (STCAL_INVOKE_ON_STATIC_DATE_FORMAT_INSTANCE)</a></h3>
3240
3241
3242 <p>As the JavaDoc states, DateFormats are inherently unsafe for multithreaded us e.
3243 The detector has found a call to an instance of DateFormat that has been obtaine d via a static
3244 field. This looks suspicous.</p>
3245 <p>For more information on this see <a href="http://bugs.sun.com/bugdatabase/vie w_bug.do?bug_id=6231579">Sun Bug #6231579</a>
3246 and <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6178997">Sun Bug #6178997</a>.</p>
3247
3248
3249 <h3><a name="STCAL_STATIC_CALENDAR_INSTANCE">STCAL: Static Calendar field (STCAL _STATIC_CALENDAR_INSTANCE)</a></h3>
3250
3251
3252 <p>Even though the JavaDoc does not contain a hint about it, Calendars are inher ently unsafe for multihtreaded use.
3253 Sharing a single instance across thread boundaries without proper synchronizatio n will result in erratic behavior of the
3254 application. Under 1.4 problems seem to surface less often than under Java 5 whe re you will probably see
3255 random ArrayIndexOutOfBoundsExceptions or IndexOutOfBoundsExceptions in sun.util .calendar.BaseCalendar.getCalendarDateFromFixedDate().</p>
3256 <p>You may also experience serialization problems.</p>
3257 <p>Using an instance field is recommended.</p>
3258 <p>For more information on this see <a href="http://bugs.sun.com/bugdatabase/vie w_bug.do?bug_id=6231579">Sun Bug #6231579</a>
3259 and <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6178997">Sun Bug #6178997</a>.</p>
3260
3261
3262 <h3><a name="STCAL_STATIC_SIMPLE_DATE_FORMAT_INSTANCE">STCAL: Static DateFormat (STCAL_STATIC_SIMPLE_DATE_FORMAT_INSTANCE)</a></h3>
3263
3264
3265 <p>As the JavaDoc states, DateFormats are inherently unsafe for multithreaded us e.
3266 Sharing a single instance across thread boundaries without proper synchronizatio n will result in erratic behavior of the
3267 application.</p>
3268 <p>You may also experience serialization problems.</p>
3269 <p>Using an instance field is recommended.</p>
3270 <p>For more information on this see <a href="http://bugs.sun.com/bugdatabase/vie w_bug.do?bug_id=6231579">Sun Bug #6231579</a>
3271 and <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6178997">Sun Bug #6178997</a>.</p>
3272
3273
3274 <h3><a name="SWL_SLEEP_WITH_LOCK_HELD">SWL: Appel de la méthode Thread.sleep() a vec un verrou (SWL_SLEEP_WITH_LOCK_HELD)</a></h3>
3275
3276
3277 <p>Cette méthode appelle <code>Thread.sleep()</code> en tenant un verrou. Ceci p eut résulter en de faibles performances, peu de capacité à monter en charge ou u n 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 l e libérer et de permettre à d'autre processus de tourner.</p>
3278
3279
3280 <h3><a name="TLW_TWO_LOCK_WAIT">TLW: wait() avec deux verrous en attente (TLW_TW O_LOCK_WAIT)</a></h3>
3281
3282
3283 <p>Attendre sur on moniteur alors que deux verrous sont détenus peut entraîner u n blocage fatal (deadlock). Exécuter un <code>wait()</code> ne libère que le ver rou 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>
3284
3285
3286 <h3><a name="UG_SYNC_SET_UNSYNC_GET">UG: Méthode getXXX non synchronisée, méthod e setXXX synchronisée (UG_SYNC_SET_UNSYNC_GET)</a></h3>
3287
3288
3289 <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 inc orrect à l'exécution car l'appelant de la méthode <code>getXXX</code> ne verra p as obligatoirement l'objet dans un état consistant. La méthode <code>getXXX</cod e> devrait être synchronisée.</p>
3290
3291
3292 <h3><a name="UL_UNRELEASED_LOCK">UL: La méthode ne libère pas un verrou dans tou s les chemins d'exécution (UL_UNRELEASED_LOCK)</a></h3>
3293
3294
3295 <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 c orrect pour utiliser un verrou JSR-166 est :</p>
3296 <pre>
3297 Lock l = ...;
3298 l.lock();
3299 try {
3300 // do something
3301 } finally {
3302 l.unlock();
3303 }
3304 </pre>
3305
3306
3307 <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>
3308
3309
3310 <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 c orrect pour utiliser un verrou JSR-166 est :</p>
3311 <pre>
3312 Lock l = ...;
3313 l.lock();
3314 try {
3315 // do something
3316 } finally {
3317 l.unlock();
3318 }
3319 </pre>
3320
3321
3322 <h3><a name="UW_UNCOND_WAIT">UW: Méthode contenant un wait() non conditionné (UW _UNCOND_WAIT)</a></h3>
3323
3324
3325 <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'atten dre a déjà été remplie, le thread risque d'attendre indéfiniment.</p>
3326
3327
3328 <h3><a name="VO_VOLATILE_INCREMENT">VO: An increment to a volatile field isn't a tomic (VO_VOLATILE_INCREMENT)</a></h3>
3329
3330
3331 <p>This code increments a volatile field. Increments of volatile fields aren't
3332 atomic. If more than one thread is incrementing the field at the same time,
3333 increments could be lost.
3334 </p>
3335
3336
3337 <h3><a name="VO_VOLATILE_REFERENCE_TO_ARRAY">VO: Une référence volatile à un tab leau ne traite pas les éléments du tableau comme volatiles (VO_VOLATILE_REFERENC E_TO_ARRAY)</a></h3>
3338
3339
3340 <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 éc ritures de la référence au tableau sont traitées comme volatiles, mais les éléme nts ne sont pas volatiles. Pour obtenir des éléments volatiles, vous devez utili ser l'une des classes de tableaux atomiques de <code>java.util.concurrent</code> (inclus dans Java 5.0).</p>
3341
3342
3343 <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>
3344
3345
3346 <p>
3347 This instance method synchronizes on <code>this.getClass()</code>. If this class is subclassed,
3348 subclasses will synchronize on the class object for the subclass, which isn 't likely what was intended.
3349 For example, consider this code from java.awt.Label:</p>
3350 <pre>
3351 private static final String base = "label";
3352 private static int nameCounter = 0;
3353 String constructComponentName() {
3354 synchronized (getClass()) {
3355 return base + nameCounter++;
3356 }
3357 }
3358 </pre>
3359 <p>Subclasses of <code>Label</code> won't synchronize on the same subclass, giving rise to a datarace.
3360 Instead, this code should be synchronizing on <code>Label.class</code></p>
3361 <pre>
3362 private static final String base = "label";
3363 private static int nameCounter = 0;
3364 String constructComponentName() {
3365 synchronized (Label.class) {
3366 return base + nameCounter++;
3367 }
3368 }
3369 </pre>
3370 <p>Bug pattern contributed by Jason Mehrens</p>
3371
3372
3373 <h3><a name="WS_WRITEOBJECT_SYNC">WS: Seule la méthode writeObject() est synchro nisée (WS_WRITEOBJECT_SYNC)</a></h3>
3374
3375
3376 <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>
3377
3378
3379 <h3><a name="WA_AWAIT_NOT_IN_LOOP">Wa: Condition.await() en dehors d'une boucle (WA_AWAIT_NOT_IN_LOOP)</a></h3>
3380
3381
3382 <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>
3383
3384
3385 <h3><a name="WA_NOT_IN_LOOP">Wa: Méthode contenant un wait() en dehors d'une bou cle (WA_NOT_IN_LOOP)</a></h3>
3386
3387
3388 <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 multiple s, la condition que l'appelant attend peut ne pas être celle qui s'est réellemen t déclenchée.</p>
3389
3390
3391 <h3><a name="BX_BOXING_IMMEDIATELY_UNBOXED">Bx: Primitive value is boxed and the n immediately unboxed (BX_BOXING_IMMEDIATELY_UNBOXED)</a></h3>
3392
3393
3394 <p>A primitive is boxed, and then immediately unboxed. This probably is due to a manual
3395 boxing in a place where an unboxed value is required, thus forcing the compi ler
3396 to immediately undo the work of the boxing.
3397 </p>
3398
3399
3400 <h3><a name="BX_BOXING_IMMEDIATELY_UNBOXED_TO_PERFORM_COERCION">Bx: Primitive va lue is boxed then unboxed to perform primitive coercion (BX_BOXING_IMMEDIATELY_U NBOXED_TO_PERFORM_COERCION)</a></h3>
3401
3402
3403 <p>A primitive boxed value constructed and then immediately converted into a d ifferent primitive type
3404 (e.g., <code>new Double(d).intValue()</code>). Just perform direct primitive coe rcion (e.g., <code>(int) d</code>).</p>
3405
3406
3407 <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_OP ERATOR)</a></h3>
3408
3409
3410 <p>A wrapped primitive value is unboxed and converted to another primitive typ e as part of the
3411 evaluation of a conditional ternary operator (the <code> b ? e1 : e2</code> oper ator). The
3412 semantics of Java mandate that if <code>e1</code> and <code>e2</code> are wrappe d
3413 numeric values, the values are unboxed and converted/coerced to their common typ e (e.g,
3414 if <code>e1</code> is of type <code>Integer</code>
3415 and <code>e2</code> is of type <code>Float</code>, then <code>e1</code> is unbox ed,
3416 converted to a floating point value, and boxed. See JLS Section 15.25.
3417 </p>
3418
3419
3420 <h3><a name="BX_UNBOXING_IMMEDIATELY_REBOXED">Bx: Boxed value is unboxed and the n immediately reboxed (BX_UNBOXING_IMMEDIATELY_REBOXED)</a></h3>
3421
3422
3423 <p>A boxed value is unboxed and then immediately reboxed.
3424 </p>
3425
3426
3427 <h3><a name="DM_BOXED_PRIMITIVE_FOR_COMPARE">Bx: Boxing a primitive to compare ( DM_BOXED_PRIMITIVE_FOR_COMPARE)</a></h3>
3428
3429
3430 <p>A boxed primitive is created just to call compareTo method. It's more effic ient to use static compare method
3431 (for double and float since Java 1.4, for other primitive types since Java 1.7 ) which works on primitives directly.
3432 </p>
3433
3434
3435 <h3><a name="DM_BOXED_PRIMITIVE_FOR_PARSING">Bx: Boxing/unboxing to parse a prim itive (DM_BOXED_PRIMITIVE_FOR_PARSING)</a></h3>
3436
3437
3438 <p>A boxed primitive is created from a String, just to extract the unboxed pri mitive value.
3439 It is more efficient to just call the static parseXXX method.</p>
3440
3441
3442 <h3><a name="DM_BOXED_PRIMITIVE_TOSTRING">Bx: Méthode allouant une primitive box ed pour appeler toString (DM_BOXED_PRIMITIVE_TOSTRING)</a></h3>
3443
3444
3445 <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>
3446 <table>
3447 <tr><th>Remplacer...</th><th>Avec...</th></tr>
3448 <tr><td><code>new Integer(1).toString()</code></td><td><code>Integer.toStri ng(1)</code></td></tr>
3449 <tr><td><code>new Long(1).toString()</code></td><td><code>Long.toString(1)< /code></td></tr>
3450 <tr><td><code>new Float(1.0).toString()</code></td><td><code>Float.toString (1.0)</code></td></tr>
3451 <tr><td><code>new Double(1.0).toString()</code></td><td><code>Double.toStri ng(1.0)</code></td></tr>
3452 <tr><td><code>new Byte(1).toString()</code></td><td><code>Byte.toString(1)< /code></td></tr>
3453 <tr><td><code>new Short(1).toString()</code></td><td><code>Short.toString(1 )</code></td></tr>
3454 <tr><td><code>Boolean.valueOf(true).toString()</code></td><td><code>Boolean .toString(true)</code></td></tr>
3455 </table>
3456
3457
3458 <h3><a name="DM_FP_NUMBER_CTOR">Bx: Method invokes inefficient floating-point Nu mber constructor; use static valueOf instead (DM_FP_NUMBER_CTOR)</a></h3>
3459
3460
3461 <p>
3462 Using <code>new Double(double)</code> is guaranteed to always result in a new object whereas
3463 <code>Double.valueOf(double)</code> allows caching of values to be done by the compiler, class library, or JVM.
3464 Using of cached values avoids object allocation and the code will be faste r.
3465 </p>
3466 <p>
3467 Unless the class must be compatible with JVMs predating Java 1.5,
3468 use either autoboxing or the <code>valueOf()</code> method when creating i nstances of <code>Double</code> and <code>Float</code>.
3469 </p>
3470
3471
3472 <h3><a name="DM_NUMBER_CTOR">Bx: Method invokes inefficient Number constructor; use static valueOf instead (DM_NUMBER_CTOR)</a></h3>
3473
3474
3475 <p>
3476 Using <code>new Integer(int)</code> is guaranteed to always result in a ne w object whereas
3477 <code>Integer.valueOf(int)</code> allows caching of values to be done by t he compiler, class library, or JVM.
3478 Using of cached values avoids object allocation and the code will be faste r.
3479 </p>
3480 <p>
3481 Values between -128 and 127 are guaranteed to have corresponding cached in stances
3482 and using <code>valueOf</code> is approximately 3.5 times faster than usin g constructor.
3483 For values outside the constant range the performance of both styles is th e same.
3484 </p>
3485 <p>
3486 Unless the class must be compatible with JVMs predating Java 1.5,
3487 use either autoboxing or the <code>valueOf()</code> method when creating i nstances of
3488 <code>Long</code>, <code>Integer</code>, <code>Short</code>, <code>Charact er</code>, and <code>Byte</code>.
3489 </p>
3490
3491
3492 <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>
3493
3494
3495 <p> The equals and hashCode
3496 method of URL perform domain name resolution, this can result in a big performan ce hit.
3497 See <a href="http://michaelscharf.blogspot.com/2006/11/javaneturlequals-and-hash code-make.html">http://michaelscharf.blogspot.com/2006/11/javaneturlequals-and-h ashcode-make.html</a> for more information.
3498 Consider using <code>java.net.URI</code> instead.
3499 </p>
3500
3501
3502 <h3><a name="DMI_COLLECTION_OF_URLS">Dm: Maps and sets of URLs can be performanc e hogs (DMI_COLLECTION_OF_URLS)</a></h3>
3503
3504
3505 <p> This method or field is or uses a Map or Set of URLs. Since both the equal s and hashCode
3506 method of URL perform domain name resolution, this can result in a big performan ce hit.
3507 See <a href="http://michaelscharf.blogspot.com/2006/11/javaneturlequals-and-hash code-make.html">http://michaelscharf.blogspot.com/2006/11/javaneturlequals-and-h ashcode-make.html</a> for more information.
3508 Consider using <code>java.net.URI</code> instead.
3509 </p>
3510
3511
3512 <h3><a name="DM_BOOLEAN_CTOR">Dm: La méthode invoque le constructeur inutile Boo lean() ; utilisez Boolean.valueOf(...) à la place (DM_BOOLEAN_CTOR)</a></h3>
3513
3514
3515 <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.val ueOf()</code> pour créer des objets <code>Boolean</code>.</p>
3516
3517
3518 <h3><a name="DM_GC">Dm: Ramasse-miettes explicite ; extrêmement douteux sauf dan s du code de banc d'essai (DM_GC)</a></h3>
3519
3520
3521 <p>Le code appelle explicitement le ramasse-miettes. Mis à part l'emploi spécifi que dans un banc d'essai, c'est très douteux.</p>
3522 <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()</c ode> ont creusés des gouffres dans les performances. Le ramasse-miettes peut-êtr e très coûteux. Toute situation qui force des centaines ou des milliers de ramas se-miettes mettra à genoux une machine.</p>
3523
3524
3525 <h3><a name="DM_NEW_FOR_GETCLASS">Dm: Méthode allouant un objet juste pour obten ir la classe (DM_NEW_FOR_GETCLASS)</a></h3>
3526
3527
3528 <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 simp le d'accèder directement à la propriété <code>.class</code> de la classe.</p>
3529
3530
3531 <h3><a name="DM_NEXTINT_VIA_NEXTDOUBLE">Dm: Utiliser la méthode nextInt de Rando m plutôt que nextDouble pour générer un entier aléatoire (DM_NEXTINT_VIA_NEXTDOU BLE)</a></h3>
3532
3533
3534 <p>Si <code>r</code> est un <code>java.util.Random</code>, vous pouvez générer u n 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>
3535
3536
3537 <h3><a name="DM_STRING_CTOR">Dm: La méthode invoque le constructeur inutile Stri ng(String) ; utilisez juste l'argument (DM_STRING_CTOR)</a></h3>
3538
3539
3540 <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>
3541
3542
3543 <h3><a name="DM_STRING_TOSTRING">Dm: La méthode appel toString() sur un objet St ring ; utilisez directement l'objet String (DM_STRING_TOSTRING)</a></h3>
3544
3545
3546 <p>Appeler <code>String.toString()</code> est juste une opération redondante. Ut ilisez directement l'objet <code>String</code>.</p>
3547
3548
3549 <h3><a name="DM_STRING_VOID_CTOR">Dm: La méthode invoque le constructeur inutile String() ; utilisez juste "" (DM_STRING_VOID_CTOR)</a></h3>
3550
3551
3552 <p>Créer un nouveau objet <code>java.lang.String</code> en utilisant le construc teur sans argument gaspille de la mémoire parce que l'objet ainsi créé serait fo nctionnellement identique à la constante de chaîne vide "". Java garantie que le s chaînes constantes identiques seront représentées par le même objet <code>Stri ng</code>. C'est pourquoi vous devriez directement utiliser la constante de chaî ne vide.</p>
3553
3554
3555 <h3><a name="HSC_HUGE_SHARED_STRING_CONSTANT">HSC: Huge string constants is dupl icated across multiple class files (HSC_HUGE_SHARED_STRING_CONSTANT)</a></h3>
3556
3557
3558 <p>
3559 A large String constant is duplicated across multiple class files.
3560 This is likely because a final field is initialized to a String constant, an d the Java language
3561 mandates that all references to a final field from other classes be inlined into
3562 that classfile. See <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id= 6447475">JDK bug 6447475</a>
3563 for a description of an occurrence of this bug in the JDK and how resolving it reduced
3564 the size of the JDK by 1 megabyte.
3565 </p>
3566
3567
3568 <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>
3569
3570
3571 <p>Cette méthode semble construire une <ocde>String</code> en utilisant une conc aténation en boucle. A chaque itération, l'objet <code>String</code> est convert i en <code>StringBuffer</code>/<code>StringBuilder</code>, complété, puis de nou veau 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>
3572 <p>De meilleurs performances peuvent être obtenues en utilisant explicitement <c ode>StringBuffer</code> (ou <code>StringBuilder</code> en Java 5).</p>
3573 <p>Par exemple :</p>
3574 <pre>
3575 // C'est mal !
3576 String s = "";
3577 for (int i = 0; i &lt; field.length; ++i) {
3578 s = s + field[i];
3579 }
3580
3581 // C'est mieux...
3582 StringBuffer buf = new StringBuffer();
3583 for (int i = 0; i &lt; field.length; ++i) {
3584 buf.append(field[i]);
3585 }
3586 String s = buf.toString();
3587 </pre>
3588
3589
3590 <h3><a name="SIC_INNER_SHOULD_BE_STATIC">SIC: Devrait être une classe interne st atique (SIC_INNER_SHOULD_BE_STATIC)</a></h3>
3591
3592
3593 <p>Cette classe est une classe interne, mais n'utilise pas sa référence vers l'o bjet qui l'a créée. Cette référence rend les instances de cette classe plus gros ses et peut garder active la référence à l'objet créateur plus longtemps que néc essaire. Si possible, la classe devrait être transformée en classe interne <code >static</code>.</p>
3594
3595
3596 <h3><a name="SIC_INNER_SHOULD_BE_STATIC_ANON">SIC: Peut-être transformée en clas se interne statique nommée (SIC_INNER_SHOULD_BE_STATIC_ANON)</a></h3>
3597
3598
3599 <p>Cette classe est une classe interne qui n'utilise pas sa référence vers l'obj et qui l'a créée. Cette référence rend l'objet plus gros et peut garder active l a référence de l'objet créateur plus longtemps que nécessaire. Si possible, la c lasse devrait être transformée en classe interne <code>static</code>. Puisque le s classes anonymes ne peuvent pas être marquées comme <code>static</code>, il fa udrait également nommer cette classe.</p>
3600
3601
3602 <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>
3603
3604
3605 <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 ac tive 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>. Puis que la référence à l'objet créateur est requise durant la construction de la cla sse interne, le constructeur de celle-ci devrait-être modifié afin d'accepter en argument cette référence.</p>
3606
3607
3608 <h3><a name="SS_SHOULD_BE_STATIC">SS: Champ non lu : devrait-il être statique ? (SS_SHOULD_BE_STATIC)</a></h3>
3609
3610
3611 <p>Cette classe contient un champ d'instance <code>final</code> qui est initiali sé par une valeur statique déterminée à la compilation. Envisagez de rendre ce c hamp <code>static</code>.</p>
3612
3613
3614 <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>
3615
3616
3617 <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étec tées sont :</p>
3618 <table>
3619 <tr><th>Méthode</th><th>Paramètre</th></tr>
3620 <tr><td>abs</td><td>-tous-</td></tr>
3621 <tr><td>acos</td><td>0.0 ou 1.0</td></tr>
3622 <tr><td>asin</td><td>0.0 ou 1.0</td></tr>
3623 <tr><td>atan</td><td>0.0 ou 1.0</td></tr>
3624 <tr><td>atan2</td><td>0.0</td></tr>
3625 <tr><td>cbrt</td><td>0.0 ou 1.0</td></tr>
3626 <tr><td>ceil</td><td>-tous-</td></tr>
3627 <tr><td>cos</td><td>0.0</td></tr>
3628 <tr><td>cosh</td><td>0.0</td></tr>
3629 <tr><td>exp</td><td>0.0 ou 1.0</td></tr>
3630 <tr><td>expm1</td><td>0.0</td></tr>
3631 <tr><td>floor</td><td>-tous-</td></tr>
3632 <tr><td>log</td><td>0.0 ou 1.0</td></tr>
3633 <tr><td>log10</td><td>0.0 ou 1.0</td></tr>
3634 <tr><td>rint</td><td>-tous-</td></tr>
3635 <tr><td>round</td><td>-tous-</td></tr>
3636 <tr><td>sin</td><td>0.0</td></tr>
3637 <tr><td>sinh</td><td>0.0</td></tr>
3638 <tr><td>sqrt</td><td>0.0 ou 1.0</td></tr>
3639 <tr><td>tan</td><td>0.0</td></tr>
3640 <tr><td>tanh</td><td>0.0</td></tr>
3641 <tr><td>toDegrees</td><td>0.0 ou 1.0</td></tr>
3642 <tr><td>toRadians</td><td>0.0</td></tr>
3643 </table>
3644
3645
3646 <h3><a name="UPM_UNCALLED_PRIVATE_METHOD">UPM: Méthode privée jamais appelée (UP M_UNCALLED_PRIVATE_METHOD)</a></h3>
3647
3648
3649 <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 jama is utilisée et qu'elle puisse être supprimée.</p>
3650
3651
3652 <h3><a name="URF_UNREAD_FIELD">UrF: Champ inutilisé (URF_UNREAD_FIELD)</a></h3>
3653
3654
3655 <p>Ce champ n'est jamais lu. Envisagez de le supprimer de la classe.</p>
3656
3657
3658 <h3><a name="UUF_UNUSED_FIELD">UuF: Champ inutilisé (UUF_UNUSED_FIELD)</a></h3>
3659
3660
3661 <p>Ce champ n'est jamais utilisé. Envisagez de le supprimer de la classe.</p>
3662
3663
3664 <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>
3665
3666
3667 <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>
3668
3669
3670 <h3><a name="DMI_CONSTANT_DB_PASSWORD">Dm: Hardcoded constant database password (DMI_CONSTANT_DB_PASSWORD)</a></h3>
3671
3672
3673 <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
3674 easily learn the password.
3675 </p>
3676
3677
3678
3679 <h3><a name="DMI_EMPTY_DB_PASSWORD">Dm: Empty database password (DMI_EMPTY_DB_PA SSWORD)</a></h3>
3680
3681
3682 <p>This code creates a database connect using a blank or empty password. Thi s indicates that the database is not protected by a password.
3683 </p>
3684
3685
3686
3687 <h3><a name="HRS_REQUEST_PARAMETER_TO_COOKIE">HRS: HTTP cookie formed from untru sted input (HRS_REQUEST_PARAMETER_TO_COOKIE)</a></h3>
3688
3689
3690 <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 splitti ng
3691 vulnerability. See <a href="http://en.wikipedia.org/wiki/HTTP_response_splitting ">http://en.wikipedia.org/wiki/HTTP_response_splitting</a>
3692 for more information.</p>
3693 <p>FindBugs looks only for the most blatant, obvious cases of HTTP response spli tting.
3694 If FindBugs found <em>any</em>, you <em>almost certainly</em> have more
3695 vulnerabilities that FindBugs doesn't report. If you are concerned about HTTP re sponse splitting, you should seriously
3696 consider using a commercial static analysis or pen-testing tool.
3697 </p>
3698
3699
3700
3701 <h3><a name="HRS_REQUEST_PARAMETER_TO_HTTP_HEADER">HRS: HTTP Response splitting vulnerability (HRS_REQUEST_PARAMETER_TO_HTTP_HEADER)</a></h3>
3702
3703
3704 <p>This code directly writes an HTTP parameter to an HTTP header, which allo ws for a HTTP response splitting
3705 vulnerability. See <a href="http://en.wikipedia.org/wiki/HTTP_response_splitting ">http://en.wikipedia.org/wiki/HTTP_response_splitting</a>
3706 for more information.</p>
3707 <p>FindBugs looks only for the most blatant, obvious cases of HTTP response spli tting.
3708 If FindBugs found <em>any</em>, you <em>almost certainly</em> have more
3709 vulnerabilities that FindBugs doesn't report. If you are concerned about HTTP re sponse splitting, you should seriously
3710 consider using a commercial static analysis or pen-testing tool.
3711 </p>
3712
3713
3714
3715 <h3><a name="PT_ABSOLUTE_PATH_TRAVERSAL">PT: Absolute path traversal in servlet (PT_ABSOLUTE_PATH_TRAVERSAL)</a></h3>
3716
3717
3718 <p>The software uses an HTTP request parameter to construct a pathname that should be within a restricted directory,
3719 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.
3720
3721 See <a href="http://cwe.mitre.org/data/definitions/36.html">http://cwe.mitre.org /data/definitions/36.html</a>
3722 for more information.</p>
3723 <p>FindBugs looks only for the most blatant, obvious cases of absolute path trav ersal.
3724 If FindBugs found <em>any</em>, you <em>almost certainly</em> have more
3725 vulnerabilities that FindBugs doesn't report. If you are concerned about absolut e path traversal, you should seriously
3726 consider using a commercial static analysis or pen-testing tool.
3727 </p>
3728
3729
3730
3731 <h3><a name="PT_RELATIVE_PATH_TRAVERSAL">PT: Relative path traversal in servlet (PT_RELATIVE_PATH_TRAVERSAL)</a></h3>
3732
3733
3734 <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 seq uences such as ".." that can resolve to a location that is outside of that direc tory.
3735
3736 See <a href="http://cwe.mitre.org/data/definitions/23.html">http://cwe.mitre.org /data/definitions/23.html</a>
3737 for more information.</p>
3738 <p>FindBugs looks only for the most blatant, obvious cases of relative path trav ersal.
3739 If FindBugs found <em>any</em>, you <em>almost certainly</em> have more
3740 vulnerabilities that FindBugs doesn't report. If you are concerned about relativ e path traversal, you should seriously
3741 consider using a commercial static analysis or pen-testing tool.
3742 </p>
3743
3744
3745
3746 <h3><a name="SQL_NONCONSTANT_STRING_PASSED_TO_EXECUTE">SQL: Une chaîne non const ante est passée à la méthode execute d'une commande SQL (SQL_NONCONSTANT_STRING_ PASSED_TO_EXECUTE)</a></h3>
3747
3748
3749 <p>Cette méthode invoque la méthode <code>execute</code> d'une commande SQL (sta tement) avec une chaîne qui semble générée dynamiquement. Préférer la préparatio n 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 malv eillant au sein d'une requête).</p>
3750
3751
3752 <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>
3753
3754
3755 <p>Ce code créé une requète SQL préparée à partir d'une chaine non constante. Le s données qui permettent de construire cette chaine venant de l'utilisateur, ell es 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ésirabl es.</p>
3756
3757
3758 <h3><a name="XSS_REQUEST_PARAMETER_TO_JSP_WRITER">XSS: JSP reflected cross site scripting vulnerability (XSS_REQUEST_PARAMETER_TO_JSP_WRITER)</a></h3>
3759
3760
3761 <p>This code directly writes an HTTP parameter to JSP output, which allows f or a cross site scripting
3762 vulnerability. See <a href="http://en.wikipedia.org/wiki/Cross-site_scripting">h ttp://en.wikipedia.org/wiki/Cross-site_scripting</a>
3763 for more information.</p>
3764 <p>FindBugs looks only for the most blatant, obvious cases of cross site scripti ng.
3765 If FindBugs found <em>any</em>, you <em>almost certainly</em> have more cross si te scripting
3766 vulnerabilities that FindBugs doesn't report. If you are concerned about cross s ite scripting, you should seriously
3767 consider using a commercial static analysis or pen-testing tool.
3768 </p>
3769
3770
3771 <h3><a name="XSS_REQUEST_PARAMETER_TO_SEND_ERROR">XSS: Servlet reflected cross s ite scripting vulnerability in error page (XSS_REQUEST_PARAMETER_TO_SEND_ERROR)< /a></h3>
3772
3773
3774 <p>This code directly writes an HTTP parameter to a Server error page (using HttpServletResponse.sendError). Echoing this untrusted input allows
3775 for a reflected cross site scripting
3776 vulnerability. See <a href="http://en.wikipedia.org/wiki/Cross-site_scripting">h ttp://en.wikipedia.org/wiki/Cross-site_scripting</a>
3777 for more information.</p>
3778 <p>FindBugs looks only for the most blatant, obvious cases of cross site scripti ng.
3779 If FindBugs found <em>any</em>, you <em>almost certainly</em> have more cross si te scripting
3780 vulnerabilities that FindBugs doesn't report. If you are concerned about cross s ite scripting, you should seriously
3781 consider using a commercial static analysis or pen-testing tool.
3782 </p>
3783
3784
3785
3786 <h3><a name="XSS_REQUEST_PARAMETER_TO_SERVLET_WRITER">XSS: Servlet reflected cro ss site scripting vulnerability (XSS_REQUEST_PARAMETER_TO_SERVLET_WRITER)</a></h 3>
3787
3788
3789 <p>This code directly writes an HTTP parameter to Servlet output, which allo ws for a reflected cross site scripting
3790 vulnerability. See <a href="http://en.wikipedia.org/wiki/Cross-site_scripting">h ttp://en.wikipedia.org/wiki/Cross-site_scripting</a>
3791 for more information.</p>
3792 <p>FindBugs looks only for the most blatant, obvious cases of cross site scripti ng.
3793 If FindBugs found <em>any</em>, you <em>almost certainly</em> have more cross si te scripting
3794 vulnerabilities that FindBugs doesn't report. If you are concerned about cross s ite scripting, you should seriously
3795 consider using a commercial static analysis or pen-testing tool.
3796 </p>
3797
3798
3799
3800 <h3><a name="BC_BAD_CAST_TO_ABSTRACT_COLLECTION">BC: Transtypage douteux d'un ty pe Collection vers une classe abstraite (BC_BAD_CAST_TO_ABSTRACT_COLLECTION)</a> </h3>
3801
3802
3803 <p>Ce code transtype un object de type <code>Collection</code> vers un type de c ollection abstrait (tel que <code>Collection</code>). Assurez vous que l'objet e st 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 inuti le.</p>
3804
3805
3806 <h3><a name="BC_BAD_CAST_TO_CONCRETE_COLLECTION">BC: Transtypage douteux vers un e collection concrète (BC_BAD_CAST_TO_CONCRETE_COLLECTION)</a></h3>
3807
3808
3809 <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éc ifique (telles que <code>ArrayList</code> ou <code>HashSet</code>). Ceci n'est p as forcément correct, et peut rendre votre code plus fragile, puisqu'il un évent uel 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>
3810
3811
3812 <h3><a name="BC_UNCONFIRMED_CAST">BC: Transtypage non vérifié/non confirmé (BC_U NCONFIRMED_CAST)</a></h3>
3813
3814
3815 <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>
3816
3817
3818 <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>
3819
3820
3821 <p>
3822 This code performs an unchecked cast of the return value of a method.
3823 The code might be calling the method in such a way that the cast is guaranteed t o be
3824 safe, but FindBugs is unable to verify that the cast is safe. Check that your p rogram logic ensures that this
3825 cast will not fail.
3826 </p>
3827
3828
3829 <h3><a name="BC_VACUOUS_INSTANCEOF">BC: instanceof renverra toujours vrai (BC_VA CUOUS_INSTANCEOF)</a></h3>
3830
3831
3832 <p>Ce test <code>instanceof</code> renverra toujours vrai. Même s'il est sûr, as surez-vous qu'il ne s'agit pas d'une erreur logique ou d'une mauvaise compréhens ion.</p>
3833
3834
3835 <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>
3836
3837
3838 <p>Le code effectue un décalage à droite non signé, dont le résultat est transty pé vers un <code>short</code> ou un <code>byte</code>, ce qui élimine les bits s upé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épen d de la taille du décalage)</p>
3839
3840
3841 <h3><a name="CI_CONFUSED_INHERITANCE">CI: Classe finale déclarant un champ proté gé (CI_CONFUSED_INHERITANCE)</a></h3>
3842
3843
3844 <p>Cette classe est déclarée <code>final</code> mais comporte des champs <code>p rotected</code>. Cette classe étant finale, elle ne pourra jamais être dérivée e t 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 m ettre en évidence la véritable utilisation du champ.</p>
3845
3846
3847 <h3><a name="DB_DUPLICATE_BRANCHES">DB: Méthode utilsant le même code pour deux branches (DB_DUPLICATE_BRANCHES)</a></h3>
3848
3849
3850 <p>Cette méthode utilise le même code pour implémenter deux branches d'une condi tion. Vérifiez pour vous assurer que ce n'est pas une erreur de codage.</p>
3851
3852
3853 <h3><a name="DB_DUPLICATE_SWITCH_CLAUSES">DB: Méthode utilisant le même code pou r deux clauses switch (DB_DUPLICATE_SWITCH_CLAUSES)</a></h3>
3854
3855
3856 <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'es t pas une erreur de codage.</p>
3857
3858
3859 <h3><a name="DLS_DEAD_LOCAL_STORE">DLS: Alimentation à perte d'une variable loca le (DLS_DEAD_LOCAL_STORE)</a></h3>
3860
3861
3862 <p>Cette instruction assigne une valeur à une variable locale mais cette variabl e n'est pas lue par la suite. Ceci indique souvent une erreur puisque la valeur calculée n'est jamais utilisée.</p>
3863 <p>Notez que le compilateur javac de Sun génère fréquemment ce genre d'affectati ons à perte. FindBugs analysant le byte-code généré, il n'y a pas de façon simpl e d'éliminer ces fausses alarmes.</p>
3864
3865
3866 <h3><a name="DLS_DEAD_LOCAL_STORE_IN_RETURN">DLS: Useless assignment in return s tatement (DLS_DEAD_LOCAL_STORE_IN_RETURN)</a></h3>
3867
3868
3869 <p>
3870 This statement assigns to a local variable in a return statement. This assignmen t
3871 has effect. Please verify that this statement does the right thing.
3872 </p>
3873
3874
3875 <h3><a name="DLS_DEAD_LOCAL_STORE_OF_NULL">DLS: Alimentation à null d'une variab le (DLS_DEAD_LOCAL_STORE_OF_NULL)</a></h3>
3876
3877
3878 <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>
3879
3880
3881 <h3><a name="DLS_DEAD_LOCAL_STORE_SHADOWS_FIELD">DLS: Dead store to local variab le that shadows field (DLS_DEAD_LOCAL_STORE_SHADOWS_FIELD)</a></h3>
3882
3883
3884 <p>
3885 This instruction assigns a value to a local variable,
3886 but the value is not read or used in any subsequent instruction.
3887 Often, this indicates an error, because the value computed is never
3888 used. There is a field with the same name as the local variable. Did you
3889 mean to assign to that variable instead?
3890 </p>
3891
3892
3893 <h3><a name="DMI_HARDCODED_ABSOLUTE_FILENAME">DMI: Chemin absolu codé en dur dan s le code (DMI_HARDCODED_ABSOLUTE_FILENAME)</a></h3>
3894
3895
3896 <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/shar e/com/sun/enterprise/deployment");)</code>.</p>
3897
3898
3899 <h3><a name="DMI_NONSERIALIZABLE_OBJECT_WRITTEN">DMI: Objet non sérialisable écr it dans un ObjectOutput (DMI_NONSERIALIZABLE_OBJECT_WRITTEN)</a></h3>
3900
3901
3902 <p>Ce code semble transmettre un objet non sérialisable à la méthode <code>Objec tOutput.writeObject</code>. Une erreur se produira si cet objet est effectivemen t non sérialisable.</p>
3903
3904
3905 <h3><a name="DMI_USELESS_SUBSTRING">DMI: Appel de substring(0) qui retourne la v aleur originale (DMI_USELESS_SUBSTRING)</a></h3>
3906
3907
3908 <p>Ce code appelle <code>substring(0)</code> sur une chaine, ce qui renvoit la v aleur originale.</p>
3909
3910
3911 <h3><a name="DMI_THREAD_PASSED_WHERE_RUNNABLE_EXPECTED">Dm: Thread passed where Runnable expected (DMI_THREAD_PASSED_WHERE_RUNNABLE_EXPECTED)</a></h3>
3912
3913
3914 <p> A Thread object is passed as a parameter to a method where
3915 a Runnable is expected. This is rather unusual, and may indicate a logic error
3916 or cause unexpected behavior.
3917 </p>
3918
3919
3920 <h3><a name="EQ_DOESNT_OVERRIDE_EQUALS">Eq: Class doesn't override equals in sup erclass (EQ_DOESNT_OVERRIDE_EQUALS)</a></h3>
3921
3922
3923 <p> This class extends a class that defines an equals method and adds fields, but doesn't
3924 define an equals method itself. Thus, equality on instances of this class will
3925 ignore the identity of the subclass and the added fields. Be sure this is what i s intended,
3926 and that you don't need to override the equals method. Even if you don't need to override
3927 the equals method, consider overriding it anyway to document the fact
3928 that the equals method for the subclass just return the result of
3929 invoking super.equals(o).
3930 </p>
3931
3932
3933 <h3><a name="EQ_UNUSUAL">Eq: Unusual equals method (EQ_UNUSUAL)</a></h3>
3934
3935
3936 <p> This class doesn't do any of the patterns we recognize for checking that t he type of the argument
3937 is compatible with the type of the <code>this</code> object. There might not be anything wrong with
3938 this code, but it is worth reviewing.
3939 </p>
3940
3941
3942 <h3><a name="FE_FLOATING_POINT_EQUALITY">FE: Test d'égalité en virgule flottante . (FE_FLOATING_POINT_EQUALITY)</a></h3>
3943
3944
3945 <p>Cette opération teste l'égalité de deux valeurs en virgule flottante. Les cal culs en virgule flottante pouvant introduire des arrondis, les valeurs flottante s 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 : <co de>if ( Math.abs(x - y) &lt; .0000001 )</code>. Cf section 4.2.4 des spécificati ons du langage Java.</p>
3946
3947
3948 <h3><a name="VA_FORMAT_STRING_BAD_CONVERSION_TO_BOOLEAN">FS: Non-Boolean argumen t formatted using %b format specifier (VA_FORMAT_STRING_BAD_CONVERSION_TO_BOOLEA N)</a></h3>
3949
3950
3951 <p>
3952 An argument not of type Boolean is being formatted with a %b format specifier. T his won't throw an
3953 exception; instead, it will print true for any non-null value, and false for nul l.
3954 This feature of format strings is strange, and may not be what you intended.
3955 </p>
3956
3957
3958 <h3><a name="IA_AMBIGUOUS_INVOCATION_OF_INHERITED_OR_OUTER_METHOD">IA: Appel amb igu d'une méthode hérité ou externe (IA_AMBIGUOUS_INVOCATION_OF_INHERITED_OR_OUT ER_METHOD)</a></h3>
3959
3960
3961 <p>Une classe interne invoque une méthode qui peut être résolue comme une méthod e 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 p eut ê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>
3962
3963
3964 <h3><a name="IC_INIT_CIRCULARITY">IC: Initialisation circulaire (IC_INIT_CIRCULA RITY)</a></h3>
3965
3966
3967 <p>Une initialisation circulaire a été détectée dans les initialisations de vari ables statiques de deux classes référencées par l'instance en erreur. De nombreu ses sortes de comportements inattendus peuvent surgir d'une telle situation.</p>
3968
3969
3970 <h3><a name="ICAST_IDIV_CAST_TO_DOUBLE">ICAST: Résultat d'une division entière t ranstypé en nombre flottant (ICAST_IDIV_CAST_TO_DOUBLE)</a></h3>
3971
3972
3973 <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éci s. Le fait que le résultat soit transtypé en <code>double</code> suggère que cet te 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 divisio n. Voici un exemple :</p>
3974 <blockquote>
3975 <pre>
3976 int x = 2;
3977 int y = 5;
3978 // Faux: renvoi 0.0
3979 double value1 = x / y;
3980
3981 // Juste: renvoi 0.4
3982 double value2 = x / (double) y;
3983 </pre>
3984 </blockquote>
3985
3986
3987 <h3><a name="ICAST_INTEGER_MULTIPLY_CAST_TO_LONG">ICAST: Résultat d'une multipli cation entière transtypée en long (ICAST_INTEGER_MULTIPLY_CAST_TO_LONG)</a></h3>
3988
3989
3990 <p>Ce code effectue des multiplications entières et transtype le résultat en <co de>long</code>, comme dans :
3991 <code>long convertDaysToMilliseconds(int days) { return 1000*3600*24*days; }</co de>. 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. Vou s pouvez par exemple corriger le code précédent par : <code>long convertDaysToMi lliseconds(int days) { return 1000L*3600*24*days; }</code> ou <code><pre>
3992 static final long MILLISECONDS_PER_DAY = 24L*3600*1000;
3993 long convertDaysToMilliseconds(int days) { return days * MILLISECONDS_PER_DAY; }
3994 </pre></code></p>
3995
3996
3997 <h3><a name="IM_AVERAGE_COMPUTATION_COULD_OVERFLOW">IM: Possibilité de débordeme nt du calcul d'une moyenne (IM_AVERAGE_COMPUTATION_COULD_OVERFLOW)</a></h3>
3998
3999
4000 <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 posi tif, vous devriez plutôt utiliser un décalage à droite non signé. En d'autres te rmes, utilisez plutôt <code>(low+high) &gt;&gt;&gt; 1</code> au lieu de <code>( low+high)/2</code>.</p>
4001 <p>Le bug existe dans de nombreuses implémentations des recherches binaires et d es tris fusion. Martin Buchholz <a href="http://bugs.sun.com/bugdatabase/view_bu g.do?bug_id=6412541"> l'a recherché et corrigé </a> dans les librairies du JDK e t Joshua Bloch <a href="http://googleresearch.blogspot.com/2006/06/extra-extra-r ead-all-about-it-nearly.html"> a largement publié ce modèle de bug</a>.</p>
4002
4003
4004 <h3><a name="IM_BAD_CHECK_FOR_ODD">IM: Test d'impaire ne fonctionnant pas avec l es négatifs (IM_BAD_CHECK_FOR_ODD)</a></h3>
4005
4006
4007 <p>Le code utilise <code>x % 2 == 1</code> pour véifier si une valeur est impair e, 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'util iser <code>x & 1 == 1</code> ou <code>x % 2 != 0</code>.</p>
4008
4009
4010 <h3><a name="INT_BAD_REM_BY_1">INT: Reste entier modulo 1 (INT_BAD_REM_BY_1)</a> </h3>
4011
4012
4013 <p>Cette expression (Ex. : <code>exp % 1</code>) est assurée de toujours renvoye r 0. Vouliez-vous plutot dire <code>(exp & 1)</code> ou <code>(exp % 2)</code> ? </p>
4014
4015
4016 <h3><a name="INT_VACUOUS_BIT_OPERATION">INT: Vacuous bit mask operation on integ er value (INT_VACUOUS_BIT_OPERATION)</a></h3>
4017
4018
4019 <p> This is an integer bit operation (and, or, or exclusive or) that doesn't do any useful work
4020 (e.g., <code>v & 0xffffffff</code>).
4021
4022 </p>
4023
4024
4025 <h3><a name="INT_VACUOUS_COMPARISON">INT: Comparaison inutile de valeurs entière s (INT_VACUOUS_COMPARISON)</a></h3>
4026
4027
4028 <p>Il y a une comparaison entière qui renvoie toujours la même valeur (Ex. : <co de>x <= Integer.MAX_VALUE</code>).</p>
4029
4030
4031 <h3><a name="MTIA_SUSPECT_SERVLET_INSTANCE_FIELD">MTIA: La classe hérite de Serv let et utilise les variables de l'instance. (MTIA_SUSPECT_SERVLET_INSTANCE_FIELD )</a></h3>
4032
4033
4034 <p>Cette classe hérite de la classe <code>Servlet</code>, et utilise une variabl e 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 multi tâche, ce paradigme est très fortement découragé et très certainement problémati que. Considérer l'emploi seul de variables propres à la méthode.</p>
4035
4036
4037 <h3><a name="MTIA_SUSPECT_STRUTS_INSTANCE_FIELD">MTIA: La classe hérite d'une cl asse action Struts et utilise les variables de l'instance. (MTIA_SUSPECT_STRUTS_ INSTANCE_FIELD)</a></h3>
4038
4039
4040 <p>Cette classe hérite d'une classe <code>Action</code> Struts, et utilise une v ariable 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 e nvironnement multitâche, ce paradigme est très fortement découragé et très certa inement problématique. Considérer l'emploi seul de variables propres à la méthod e.</p>
4041
4042
4043 <h3><a name="NP_DEREFERENCE_OF_READLINE_VALUE">NP: Dereference of the result of readLine() without nullcheck (NP_DEREFERENCE_OF_READLINE_VALUE)</a></h3>
4044
4045
4046 <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
4047 to read, readLine() will return null and dereferencing that will generate a null pointer exception.
4048 </p>
4049
4050
4051 <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>
4052
4053
4054 <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> retou rnera <code>null</code> ce qui provoquera une <code>NullPointerException</code> lors du déréférencement.</p>
4055
4056
4057 <h3><a name="NP_LOAD_OF_KNOWN_NULL_VALUE">NP: Chargement d'une valeur connue pou r être à null (NP_LOAD_OF_KNOWN_NULL_VALUE)</a></h3>
4058
4059
4060 <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 du e vérifier non-null plutôt que null).</p>
4061
4062
4063 <h3><a name="NP_METHOD_PARAMETER_TIGHTENS_ANNOTATION">NP: Method tightens nullne ss annotation on parameter (NP_METHOD_PARAMETER_TIGHTENS_ANNOTATION)</a></h3>
4064
4065 <p>
4066 A method should always implement the contract of a method it overrides. Thus, if a method takes a parameter
4067 that is marked as @Nullable, you shouldn't override that method in a subclas s with a method where that parameter is @Nonnull.
4068 Doing so violates the contract that the method should handle a null paramete r.
4069 </p>
4070
4071 <h3><a name="NP_METHOD_RETURN_RELAXING_ANNOTATION">NP: Method relaxes nullness a nnotation on return value (NP_METHOD_RETURN_RELAXING_ANNOTATION)</a></h3>
4072
4073 <p>
4074 A method should always implement the contract of a method it overrides. Thus, if a method takes is annotated
4075 as returning a @Nonnull value,
4076 you shouldn't override that method in a subclass with a method annotated as returning a @Nullable or @CheckForNull value.
4077 Doing so violates the contract that the method shouldn't return null.
4078 </p>
4079
4080 <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>
4081
4082
4083 <p>La valeur renvoyée par une méthode est déréférencée alors que cette méthode p eut renvoyer <code>null</code>. Ceci peut conduire à une <code>NullPointerExcept ion</code> quand le code sera exécuté.</p>
4084
4085
4086 <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_I NFEASIBLE)</a></h3>
4087
4088
4089 <p> There is a branch of statement that, <em>if executed,</em> guarantees that
4090 a null value will be dereferenced, which
4091 would generate a <code>NullPointerException</code> when the code is executed.
4092 Of course, the problem might be that the branch or statement is infeasible and t hat
4093 the null pointer exception can't ever be executed; deciding that is beyond the a bility of FindBugs.
4094 Due to the fact that this value had been previously tested for nullness,
4095 this is a definite possibility.
4096 </p>
4097
4098
4099 <h3><a name="NP_PARAMETER_MUST_BE_NONNULL_BUT_MARKED_AS_NULLABLE">NP: Parameter must be non-null but is marked as nullable (NP_PARAMETER_MUST_BE_NONNULL_BUT_MAR KED_AS_NULLABLE)</a></h3>
4100
4101
4102 <p> This parameter is always used in a way that requires it to be non-null,
4103 but the parameter is explicitly annotated as being Nullable. Either the use
4104 of the parameter or the annotation is wrong.
4105 </p>
4106
4107
4108 <h3><a name="NP_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD">NP: Read of unwritten publi c or protected field (NP_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD)</a></h3>
4109
4110
4111 <p> The program is dereferencing a public or protected
4112 field that does not seem to ever have a non-null value written to it.
4113 Unless the field is initialized via some mechanism not seen by the analysis,
4114 dereferencing this value will generate a null pointer exception.
4115 </p>
4116
4117
4118 <h3><a name="NS_DANGEROUS_NON_SHORT_CIRCUIT">NS: Potentially dangerous use of no n-short-circuit logic (NS_DANGEROUS_NON_SHORT_CIRCUIT)</a></h3>
4119
4120
4121 <p> This code seems to be using non-short-circuit logic (e.g., &amp;
4122 or |)
4123 rather than short-circuit logic (&amp;&amp; or ||). In addition,
4124 it seem possible that, depending on the value of the left hand side, you might n ot
4125 want to evaluate the right hand side (because it would have side effects, could cause an exception
4126 or could be expensive.</p>
4127 <p>
4128 Non-short-circuit logic causes both sides of the expression
4129 to be evaluated even when the result can be inferred from
4130 knowing the left-hand side. This can be less efficient and
4131 can result in errors if the left-hand side guards cases
4132 when evaluating the right-hand side can generate an error.
4133 </p>
4134
4135 <p>See <a href="http://java.sun.com/docs/books/jls/third_edition/html/expression s.html#15.22.2">the Java
4136 Language Specification</a> for details
4137
4138 </p>
4139
4140
4141 <h3><a name="NS_NON_SHORT_CIRCUIT">NS: Utilisation discutable de logique binaire (NS_NON_SHORT_CIRCUIT)</a></h3>
4142
4143
4144 <p>Ce code semble utiliser de la logique binaire (Ex. : <code>&amp;</code> ou <c ode>|</code>) plutôt que les opérateurs booléens (<code>&amp;&amp;</code> ou <co de>||</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'exp ression masque des cas de la partie droite.</p>
4145
4146
4147 <h3><a name="PZLA_PREFER_ZERO_LENGTH_ARRAYS">PZLA: Envisagez de renvoyer un tabl eau vide plutôt que null (PZLA_PREFER_ZERO_LENGTH_ARRAYS)</a></h3>
4148
4149
4150 <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éri fication explicite du <code>null</code> n'est nécessaire dans les méthodes clien tes.</p>
4151 <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.listF iles()</code> renvoi une liste vide si un répertoire donné ne contient pas de fi chiers, et renvoi <code>null</code> si le fichier n'est pas un répertoire.</p>
4152
4153
4154 <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>
4155
4156
4157 <p>Etes vous certain que cette boucle incrémente la variable voulue ? Il sembler aît qu'une autre variable est initialisée et vérifiée par la boucle.</p>
4158
4159
4160 <h3><a name="RCN_REDUNDANT_COMPARISON_OF_NULL_AND_NONNULL_VALUE">RCN: Comparaiso n redondante d'une valeur non nulle avec null (RCN_REDUNDANT_COMPARISON_OF_NULL_ AND_NONNULL_VALUE)</a></h3>
4161
4162
4163 <p>Cette méthode contient une comparaison entre une référence connue pour être n on nulle avec une autre référence connue pour être à <code>null</code>.</p>
4164
4165
4166 <h3><a name="RCN_REDUNDANT_COMPARISON_TWO_NULL_VALUES">RCN: Comparaison redondan te de deux valeurs nulles (RCN_REDUNDANT_COMPARISON_TWO_NULL_VALUES)</a></h3>
4167
4168
4169 <p>Cette méthode contient une comparaison redondante entre deux références connu es pour être obligatoirement à <code>null</code>.</p>
4170
4171
4172 <h3><a name="RCN_REDUNDANT_NULLCHECK_OF_NONNULL_VALUE">RCN: Test de nullité redo ndant sur une valeur non nulle (RCN_REDUNDANT_NULLCHECK_OF_NONNULL_VALUE)</a></h 3>
4173
4174
4175 <p>Cette méthode contient un test redondant de nullité sur une valeur connue pou r être non nulle.</p>
4176
4177
4178 <h3><a name="RCN_REDUNDANT_NULLCHECK_OF_NULL_VALUE">RCN: Test de nullité redonda nt sur une valeur connue pour être à null (RCN_REDUNDANT_NULLCHECK_OF_NULL_VALUE )</a></h3>
4179
4180
4181 <p>Cette méthode contient un test redondant de nullité sur une valeur ne pouvant qu'être à <code>null</code>.</p>
4182
4183
4184 <h3><a name="REC_CATCH_EXCEPTION">REC: java.lang.Exception est intercepté alors qu'Exception n'est jamais lancé (REC_CATCH_EXCEPTION)</a></h3>
4185
4186
4187 <p>Cette méthode utilise un block <code>try-catch</code> qui intercepte les obje ts <code>Exception</code>, mais <code>Exception</code> n'est jamais déclenché da ns 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> es t identique à plusieurs <code>try / catch</code>, mais cette tournure intercepte également les <code>RuntimeException</code>, masquant des bugs potentiels.</p>
4188
4189
4190 <h3><a name="RI_REDUNDANT_INTERFACES">RI: Classe implémentant la même interface que sa super-classe (RI_REDUNDANT_INTERFACES)</a></h3>
4191
4192
4193 <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ément e une interface, toutes les sous-classes le font aussi par défaut. Cela peut ind iquer que la hiérarchie d'héritage a changé depuis la création de cette classe e t la cible de l'implémentation de l'interface doit peut-être être reprise en con sidération.</p>
4194
4195
4196 <h3><a name="RV_CHECK_FOR_POSITIVE_INDEXOF">RV: Méthode vérifiant que le résulta t d'un String.indexOf() est positif (RV_CHECK_FOR_POSITIVE_INDEXOF)</a></h3>
4197
4198
4199 <p>La méthode appelle <code>String.indexOf()</code> et vérifie si le résultat es t strictement positif ou pas. Il est plus habituel de vérifier si le résultat es t négatif. Il n'est strictement positif que lorsque la sous-chaine recherchée ap paraît ailleurs qu'au début de la chaine.</p>
4200
4201
4202 <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_R EADLINE)</a></h3>
4203
4204
4205 <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ésulta t n'est pas à <code>null</code>, vous souhaiterez utiliser cette valeur. Appeler de nouveau <code>readLine()</code> vous renverra une ligne différente.</p>
4206
4207
4208 <h3><a name="RV_REM_OF_HASHCODE">RV: Reste d'un hashCode pouvant être négatif (R V_REM_OF_HASHCODE)</a></h3>
4209
4210
4211 <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>
4212 <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 puiss ance de 2, vous pourriez utiliser un décalage binaire à la place (c'est-à-dire < code>x.hashCode()&amp;(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>
4213
4214
4215 <h3><a name="RV_REM_OF_RANDOM_INT">RV: Reste d'un entier signé 32 bits aléeatoir e (RV_REM_OF_RANDOM_INT)</a></h3>
4216
4217
4218 <p>Ce code génère un entier signé aléatoire puis calcule le reste de cette valeu r modulo une autre valeur. Puisque ce nombre aléatoire peut être négatif, le res te 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>
4219
4220
4221 <h3><a name="RV_RETURN_VALUE_IGNORED_INFERRED">RV: Method ignores return value, is this OK? (RV_RETURN_VALUE_IGNORED_INFERRED)</a></h3>
4222
4223
4224 <p>This code calls a method and ignores the return value. The return value
4225 is the same type as the type the method is invoked on, and from our analysis it looks
4226 like the return value might be important (e.g., like ignoring the
4227 return value of <code>String.toLowerCase()</code>).
4228 </p>
4229 <p>We are guessing that ignoring the return value might be a bad idea just from
4230 a simple analysis of the body of the method. You can use a @CheckReturnValue ann otation
4231 to instruct FindBugs as to whether ignoring the return value of this method
4232 is important or acceptable.
4233 </p>
4234 <p>Please investigate this closely to decide whether it is OK to ignore the retu rn value.
4235 </p>
4236
4237
4238 <h3><a name="RV_RETURN_VALUE_IGNORED_NO_SIDE_EFFECT">RV: Return value of method without side effect is ignored (RV_RETURN_VALUE_IGNORED_NO_SIDE_EFFECT)</a></h3>
4239
4240
4241 <p>This code calls a method and ignores the return value. However our analysis s hows that
4242 the method (including its implementations in subclasses if any) does not produce any effect
4243 other than return value. Thus this call can be removed.
4244 </p>
4245 <p>We are trying to reduce the false positives as much as possible, but in some cases this warning might be wrong.
4246 Common false-positive cases include:</p>
4247 <p>- The method is designed to be overridden and produce a side effect in other projects which are out of the scope of the analysis.</p>
4248 <p>- The method is called to trigger the class loading which may have a side eff ect.</p>
4249 <p>- The method is called just to get some exception.</p>
4250 <p>If you feel that our assumption is incorrect, you can use a @CheckReturnValue annotation
4251 to instruct FindBugs that ignoring the return value of this method is acceptable .
4252 </p>
4253
4254
4255 <h3><a name="SA_FIELD_DOUBLE_ASSIGNMENT">SA: Double assignment of field (SA_FIEL D_DOUBLE_ASSIGNMENT)</a></h3>
4256
4257
4258 <p> This method contains a double assignment of a field; e.g.
4259 </p>
4260 <pre>
4261 int x,y;
4262 public void foo() {
4263 x = x = 17;
4264 }
4265 </pre>
4266 <p>Assigning to a field twice is useless, and may indicate a logic error or typo .</p>
4267
4268
4269 <h3><a name="SA_LOCAL_DOUBLE_ASSIGNMENT">SA: Double assignment of local variable (SA_LOCAL_DOUBLE_ASSIGNMENT)</a></h3>
4270
4271
4272 <p> This method contains a double assignment of a local variable; e.g.
4273 </p>
4274 <pre>
4275 public void foo() {
4276 int x,y;
4277 x = x = 17;
4278 }
4279 </pre>
4280 <p>Assigning the same value to a variable twice is useless, and may indicate a l ogic error or typo.</p>
4281
4282
4283 <h3><a name="SA_LOCAL_SELF_ASSIGNMENT">SA: Auto-alimentation d'une variable loca le (SA_LOCAL_SELF_ASSIGNMENT)</a></h3>
4284
4285
4286 <p>Cette méthode contient une auto-alimentation d'une variable locale, par exemp le :</p>
4287 <pre>
4288 public vida foo() {
4289 int x = 3;
4290 x = x;
4291 }
4292 </pre>
4293 <p>De telles affectations sont inutiles et peuvent indiquer une faute de frappe ou une erreur de logique.</p>
4294
4295
4296 <h3><a name="SF_SWITCH_FALLTHROUGH">SF: Un switch comporte un cas qui déborde su r le suivant (SF_SWITCH_FALLTHROUGH)</a></h3>
4297
4298
4299 <p>Cette méthode contient un <code>switch</code> dont l'un des cas déborde sur l e suivant. Normalement, vous devez terminer chaque cas avec une instruction <cod e>break</code> ou <code>return</code>.</p>
4300
4301
4302 <h3><a name="SF_SWITCH_NO_DEFAULT">SF: Switch statement found where default case is missing (SF_SWITCH_NO_DEFAULT)</a></h3>
4303
4304
4305 <p> This method contains a switch statement where default case is missing.
4306 Usually you need to provide a default case.</p>
4307 <p>Because the analysis only looks at the generated bytecode, this warning can be incorrect triggered if
4308 the default case is at the end of the switch statement and the switch statement doesn't contain break statements for other
4309 cases.
4310
4311
4312 <h3><a name="ST_WRITE_TO_STATIC_FROM_INSTANCE_METHOD">ST: Ecriture d'un champ st atique depuis la méthode d'une instance (ST_WRITE_TO_STATIC_FROM_INSTANCE_METHOD )</a></h3>
4313
4314
4315 <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 valeu r et cela ressemble surtout à une mauvaise pratique.</p>
4316
4317
4318 <h3><a name="SE_PRIVATE_READ_RESOLVE_NOT_INHERITED">Se: Private readResolve meth od not inherited by subclasses (SE_PRIVATE_READ_RESOLVE_NOT_INHERITED)</a></h3>
4319
4320
4321 <p> This class defines a private readResolve method. Since it is private, it w on't be inherited by subclasses.
4322 This might be intentional and OK, but should be reviewed to ensure it is what is intended.
4323 </p>
4324
4325
4326 <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>
4327
4328
4329 <p> The field is marked as transient, but the class isn't Serializable, so mar king it as transient
4330 has absolutely no effect.
4331 This may be leftover marking from a previous version of the code in which the cl ass was transient, or
4332 it may indicate a misunderstanding of how serialization works.
4333 </p>
4334
4335
4336 <h3><a name="TQ_EXPLICIT_UNKNOWN_SOURCE_VALUE_REACHES_ALWAYS_SINK">TQ: Value req uired to have type qualifier, but marked as unknown (TQ_EXPLICIT_UNKNOWN_SOURCE_ VALUE_REACHES_ALWAYS_SINK)</a></h3>
4337
4338
4339 <p>
4340 A value is used in a way that requires it to be always be a value denoted by a type qualifier, but
4341 there is an explicit annotation stating that it is not known where the value is required to have that type qualifier.
4342 Either the usage or the annotation is incorrect.
4343 </p>
4344
4345
4346 <h3><a name="TQ_EXPLICIT_UNKNOWN_SOURCE_VALUE_REACHES_NEVER_SINK">TQ: Value requ ired to not have type qualifier, but marked as unknown (TQ_EXPLICIT_UNKNOWN_SOUR CE_VALUE_REACHES_NEVER_SINK)</a></h3>
4347
4348
4349 <p>
4350 A value is used in a way that requires it to be never be a value denoted b y a type qualifier, but
4351 there is an explicit annotation stating that it is not known where the value is prohibited from having that type qualifier.
4352 Either the usage or the annotation is incorrect.
4353 </p>
4354
4355
4356 <h3><a name="UC_USELESS_CONDITION">UC: Condition has no effect (UC_USELESS_CONDI TION)</a></h3>
4357
4358
4359 <p>This condition always produces the same result as the value of the involved v ariable was narrowed before.
4360 Probably something else was meant or condition can be removed.</p>
4361
4362
4363 <h3><a name="UC_USELESS_CONDITION_TYPE">UC: Condition has no effect due to the v ariable type (UC_USELESS_CONDITION_TYPE)</a></h3>
4364
4365
4366 <p>This condition always produces the same result due to the type range of the i nvolved variable.
4367 Probably something else was meant or condition can be removed.</p>
4368
4369
4370 <h3><a name="UC_USELESS_OBJECT">UC: Useless object created (UC_USELESS_OBJECT)</ a></h3>
4371
4372
4373 <p>Our analysis shows that this object is useless.
4374 It's created and modified, but its value never go outside of the method or produ ce any side-effect.
4375 Either there is a mistake and object was intended to be used or it can be remove d.</p>
4376 <p>This analysis rarely produces false-positives. Common false-positive cases in clude:</p>
4377 <p>- This object used to implicitly throw some obscure exception.</p>
4378 <p>- This object used as a stub to generalize the code.</p>
4379 <p>- This object used to hold strong references to weak/soft-referenced objects. </p>
4380
4381
4382 <h3><a name="UC_USELESS_OBJECT_STACK">UC: Useless object created on stack (UC_US ELESS_OBJECT_STACK)</a></h3>
4383
4384
4385 <p>This object is created just to perform some modifications which don't have an y side-effect.
4386 Probably something else was meant or the object can be removed.</p>
4387
4388
4389 <h3><a name="UC_USELESS_VOID_METHOD">UC: Useless non-empty void method (UC_USELE SS_VOID_METHOD)</a></h3>
4390
4391
4392 <p>Our analysis shows that this non-empty void method does not actually perform any useful work.
4393 Please check it: probably there's a mistake in its code or its body can be fully removed.
4394 </p>
4395 <p>We are trying to reduce the false positives as much as possible, but in some cases this warning might be wrong.
4396 Common false-positive cases include:</p>
4397 <p>- The method is intended to trigger loading of some class which may have a si de effect.</p>
4398 <p>- The method is intended to implicitly throw some obscure exception.</p>
4399
4400
4401 <h3><a name="UCF_USELESS_CONTROL_FLOW">UCF: Instruction de contrôle du flux inut ile (UCF_USELESS_CONTROL_FLOW)</a></h3>
4402
4403
4404 <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>
4405 <pre>
4406 if (argv.length == 1);
4407 System.out.println("Hello, " + argv[0]);
4408 </pre>
4409
4410
4411 <h3><a name="UCF_USELESS_CONTROL_FLOW_NEXT_LINE">UCF: Useless control flow to ne xt line (UCF_USELESS_CONTROL_FLOW_NEXT_LINE)</a></h3>
4412
4413
4414 <p> This method contains a useless control flow statement in which control
4415 flow follows to the same or following line regardless of whether or not
4416 the branch is taken.
4417 Often, this is caused by inadvertently using an empty statement as the
4418 body of an <code>if</code> statement, e.g.:</p>
4419 <pre>
4420 if (argv.length == 1);
4421 System.out.println("Hello, " + argv[0]);
4422 </pre>
4423
4424
4425 <h3><a name="URF_UNREAD_PUBLIC_OR_PROTECTED_FIELD">UrF: Unread public/protected field (URF_UNREAD_PUBLIC_OR_PROTECTED_FIELD)</a></h3>
4426
4427
4428 <p> This field is never read.&nbsp;
4429 The field is public or protected, so perhaps
4430 it is intended to be used with classes not seen as part of the analysis. If not,
4431 consider removing it from the class.</p>
4432
4433
4434 <h3><a name="UUF_UNUSED_PUBLIC_OR_PROTECTED_FIELD">UuF: Unused public or protect ed field (UUF_UNUSED_PUBLIC_OR_PROTECTED_FIELD)</a></h3>
4435
4436
4437 <p> This field is never used.&nbsp;
4438 The field is public or protected, so perhaps
4439 it is intended to be used with classes not seen as part of the analysis. If not,
4440 consider removing it from the class.</p>
4441
4442
4443 <h3><a name="UWF_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR">UwF: Champ non initialisé dans le constructeur (UWF_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR)</a></h3>
4444
4445
4446 <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>
4447
4448
4449 <h3><a name="UWF_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD">UwF: Unwritten public or p rotected field (UWF_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD)</a></h3>
4450
4451
4452 <p> No writes were seen to this public/protected field.&nbsp; All reads of it will return the default
4453 value. Check for errors (should it have been initialized?), or remove it if it i s useless.</p>
4454
4455
4456 <h3><a name="XFB_XML_FACTORY_BYPASS">XFB: Méthode instanciant directement une im plémentation spécifique des interfaces XML (XFB_XML_FACTORY_BYPASS)</a></h3>
4457
4458
4459 <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>
4460 <p>
4461 <ul>
4462 <li>javax.xml.parsers.DocumentBuilderFactory</li>
4463 <li>javax.xml.parsers.SAXParserFactory</li>
4464 <li>javax.xml.transform.TransformerFactory</li>
4465 <li>org.w3c.dom.Document.create<i>XXXX</i></li>
4466 </ul>
4467 </p>
4468
4469
4470
4471
4472 <hr> <p>
4473 <script language="JavaScript" type="text/javascript">
4474 <!---//hide script from old browsers
4475 document.write( "Last updated "+ document.lastModified + "." );
4476 //end hiding contents --->
4477 </script>
4478 <p> Send comments to <a class="sidebar" href="mailto:findbugs@cs.umd.edu">findbu gs@cs.umd.edu</a>
4479 <p>
4480 <a href="http://sourceforge.net/projects/findbugs/"><img src="http://sourceforge .net/sflogo.php?group_id=96405&amp;type=5" width="210" height="62" border="0" al t="FindBugs on SourceForge.net" /></a>
4481 </td></tr></table>
4482 </body></html>
OLDNEW
« README.chromium ('K') | « doc/bugDescriptions.html ('k') | doc/bugDescriptions_ja.html » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698