From 0371da714978f67f1fe68657c2c1383251ee2d47 Mon Sep 17 00:00:00 2001 From: Andrey Loskutov Date: Sun, 2 Jul 2017 10:15:44 +0200 Subject: [PATCH] Cleanup the repository from obsoleted files #20 --- bugDescriptions_fr.html | 4439 -------------------------- index.html | 2 +- ja/manual/acknowledgments.html | 132 - ja/manual/analysisprops.html | 15 - ja/manual/annotations.html | 87 - ja/manual/anttask.html | 80 - ja/manual/building.html | 49 - ja/manual/datamining.html | 289 -- ja/manual/eclipse.html | 57 - ja/manual/example-code.png | Bin 17799 -> 0 bytes ja/manual/example-details.png | Bin 53029 -> 0 bytes ja/manual/example.png | Bin 17653 -> 0 bytes ja/manual/filter.html | 241 -- ja/manual/gui.html | 14 - ja/manual/important.png | Bin 722 -> 0 bytes ja/manual/index.html | 12 - ja/manual/infiniteRecursiveLoops.png | Bin 24467 -> 0 bytes ja/manual/installing.html | 18 - ja/manual/introduction.html | 12 - ja/manual/license.html | 12 - ja/manual/note.png | Bin 490 -> 0 bytes ja/manual/project-dialog.png | Bin 11995 -> 0 bytes ja/manual/rejarForAnalysis.html | 12 - ja/manual/running.html | 34 - ja/manual/warning.png | Bin 1241 -> 0 bytes manual-fo.xsl | 30 - manual.xml | 4175 ------------------------ manual.xsl | 46 - manual/acknowledgments.html | 134 - manual/analysisprops.html | 54 - manual/annotations.html | 122 - manual/anttask.html | 281 -- manual/building.html | 132 - manual/datamining.html | 430 --- manual/eclipse.html | 121 - manual/example-code.png | Bin 17799 -> 0 bytes manual/example-details.png | Bin 53029 -> 0 bytes manual/example.png | Bin 17653 -> 0 bytes manual/filter.html | 387 --- manual/gui.html | 77 - manual/important.png | Bin 722 -> 0 bytes manual/index.html | 19 - manual/infiniteRecursiveLoops.png | Bin 24467 -> 0 bytes manual/installing.html | 38 - manual/introduction.html | 21 - manual/license.html | 22 - manual/note.png | Bin 490 -> 0 bytes manual/project-dialog.png | Bin 11995 -> 0 bytes manual/rejarForAnalysis.html | 42 - manual/running.html | 227 -- manual/warning.png | Bin 1241 -> 0 bytes manual_ja.xml | 3087 ------------------ sysprops.html | 155 - 53 files changed, 1 insertion(+), 15104 deletions(-) delete mode 100644 bugDescriptions_fr.html delete mode 100644 ja/manual/acknowledgments.html delete mode 100644 ja/manual/analysisprops.html delete mode 100644 ja/manual/annotations.html delete mode 100644 ja/manual/anttask.html delete mode 100644 ja/manual/building.html delete mode 100644 ja/manual/datamining.html delete mode 100644 ja/manual/eclipse.html delete mode 100644 ja/manual/example-code.png delete mode 100644 ja/manual/example-details.png delete mode 100644 ja/manual/example.png delete mode 100644 ja/manual/filter.html delete mode 100644 ja/manual/gui.html delete mode 100644 ja/manual/important.png delete mode 100644 ja/manual/index.html delete mode 100644 ja/manual/infiniteRecursiveLoops.png delete mode 100644 ja/manual/installing.html delete mode 100644 ja/manual/introduction.html delete mode 100644 ja/manual/license.html delete mode 100644 ja/manual/note.png delete mode 100644 ja/manual/project-dialog.png delete mode 100644 ja/manual/rejarForAnalysis.html delete mode 100644 ja/manual/running.html delete mode 100644 ja/manual/warning.png delete mode 100644 manual-fo.xsl delete mode 100644 manual.xml delete mode 100644 manual.xsl delete mode 100644 manual/acknowledgments.html delete mode 100644 manual/analysisprops.html delete mode 100644 manual/annotations.html delete mode 100644 manual/anttask.html delete mode 100644 manual/building.html delete mode 100644 manual/datamining.html delete mode 100644 manual/eclipse.html delete mode 100644 manual/example-code.png delete mode 100644 manual/example-details.png delete mode 100644 manual/example.png delete mode 100644 manual/filter.html delete mode 100644 manual/gui.html delete mode 100644 manual/important.png delete mode 100644 manual/index.html delete mode 100644 manual/infiniteRecursiveLoops.png delete mode 100644 manual/installing.html delete mode 100644 manual/introduction.html delete mode 100644 manual/license.html delete mode 100644 manual/note.png delete mode 100644 manual/project-dialog.png delete mode 100644 manual/rejarForAnalysis.html delete mode 100644 manual/running.html delete mode 100644 manual/warning.png delete mode 100644 manual_ja.xml delete mode 100644 sysprops.html diff --git a/bugDescriptions_fr.html b/bugDescriptions_fr.html deleted file mode 100644 index ccfa10f..0000000 --- a/bugDescriptions_fr.html +++ /dev/null @@ -1,4439 +0,0 @@ - - - - - - - - - SpotBugs Bug Descriptions - -
-
-

SpotBugs

-

Find bugs in Java Programs

- Check it out on GitHub -
-
-
-
-
- -

SpotBugs Bug Descriptions

-

Summary

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
DescriptionCategory
BC: Equals method should not assume anything about the type of its argumentBad practice
BIT: Check for sign of bitwise operationBad practice
CN: La classe implémente Cloneable mais ne définit et n'utilise pas la méthode clone()Bad practice
CN: La méthode clone() n'appelle pas super.clone()Bad practice
CN: Class defines clone() but doesn't implement CloneableBad practice
CNT: Rough value of known constant foundBad practice
Co: Une classe abstraite définit une méthode compareTo() covarianteBad practice
Co: compareTo()/compare() incorrectly handles float or double valueBad practice
Co: compareTo()/compare() returns Integer.MIN_VALUEBad practice
Co: Définition d'une méthode compareTo() covarianteBad practice
DE: La méthode peut déclencher une exceptionBad practice
DE: La méthode peut ignorer une exceptionBad practice
DMI: Adding elements of an entry set may fail due to reuse of Entry objectsBad practice
DMI: Random object created and used only onceBad practice
DMI: Don't use removeAll to clear a collectionBad practice
Dm: La méthode invoque System.exit(...)Bad practice
Dm: Méthode invoquant runFinalizersOnExit, l'une des plus dangeureuses méthodes des librairies JavaBad practice
ES: Comparison of String parameter using == or !=Bad practice
ES: Comparaison d'objets String utilisant == ou !=Bad practice
Eq: Une classe abstraite définit une méthode equals() covarianteBad practice
Eq: Equals checks for incompatible operandBad practice
Eq: Class defines compareTo(...) and uses Object.equals()Bad practice
Eq: equals method fails for subtypesBad practice
Eq: Définition d'une méthode equals() covarianteBad practice
FI: Un finaliseur vide devrait être suppriméBad practice
FI: Invocation explicite d'un finaliseurBad practice
FI: Finalizer nulls fieldsBad practice
FI: Finalizer only nulls fieldsBad practice
FI: Le finaliseur n'appelle pas le finaliseur de la super-classeBad practice
FI: Un finaliseur rend inutile celui de sa super-classeBad practice
FI: Le finaliseur ne fait rien sauf appeler celui de la super-classeBad practice
FS: Format string should use %n rather than \nBad practice
GC: Unchecked type in generic callBad practice
HE: La classe définit equals() mais pas hashCode()Bad practice
HE: La classe définit equals() et utilise Object.hashCode()Bad practice
HE: La classe définit hashCode() mais pas equals()Bad practice
HE: La classe définit hashCode() et utilise Object.equals()Bad practice
HE: La classe hérite de equals() et utilise Object.hashCode()Bad practice
IC: Classe mère utilisant une sous-classe durant son initialisationBad practice
IMSE: Interception douteuse d'une IllegalMonitorStateExceptionBad practice
ISC: Instantiation inutile d'une classe qui n'a que des méthodes statiquesBad practice
It: La méthode next() de Iterator ne peut pas déclencher une exception NoSuchElementBad practice
J2EE: Stockage d'un objet non serialisable dans une session HttpBad practice
JCIP: Les champs d'une classe immuable devraient être finaux.Bad practice
ME: Public enum method unconditionally sets its fieldBad practice
ME: Enum field is public and mutableBad practice
NP: Method with Boolean return type returns explicit nullBad practice
NP: Clone method may return nullBad practice
NP: Méthode equals() ne vérifiant pas la nullitéBad practice
NP: toString method may return nullBad practice
Nm: Nom de classe devant commencer par une majusculeBad practice
Nm: Cette classe ne dérive pas d'Exception, même si son nom le sous-entendBad practice
Nm: Noms de méthodes ambigusBad practice
Nm: Nom de champ devant commencer par une minusculeBad practice
Nm: Use of identifier that is a keyword in later versions of JavaBad practice
Nm: Use of identifier that is a keyword in later versions of JavaBad practice
Nm: Nom de méthode devant commencer par une minusculeBad practice
Nm: Class names shouldn't shadow simple name of implemented interfaceBad practice
Nm: Class names shouldn't shadow simple name of superclassBad practice
Nm: Very confusing method names (but perhaps intentional)Bad practice
Nm: Method doesn't override method in superclass due to wrong package for parameterBad practice
ODR: La méthode peut ne pas fermer une ressource base de donnéesBad practice
ODR: La méthode peut ne pas fermer une ressource base de données sur une exceptionBad practice
OS: La méthode peut ne pas fermer un fluxBad practice
OS: La méthode peut oublier de fermer un flux en cas d'exceptionBad practice
PZ: Don't reuse entry objects in iteratorsBad practice
RC: Suspicious reference comparison to constantBad practice
RC: Suspicious reference comparison of Boolean valuesBad practice
RR: La méthode ignore le résultat de InputStream.read()Bad practice
RR: La méthode ignore le résultat de InputStream.skip()Bad practice
RV: Negating the result of compareTo()/compare()Bad practice
RV: Method ignores exceptional return valueBad practice
SI: Initialiseur statique de classe créant une instance avant que tous les champs static final soient alimentésBad practice
SW: Certaines méthodes Swing ne doivent être invoquées qu'à partir du thread SwingBad practice
Se: Champ d'instance non transient et non sérialisable dans une classe sérialisableBad practice
Se: Non-serializable class has a serializable inner classBad practice
Se: Valeur non sérialisable stockée dans un champ d'instance de classe sérialisableBad practice
Se: Comparateur n'implémentant pas SerializableBad practice
Se: Serializable inner classBad practice
Se: serialVersionUID n'est pas finalBad practice
Se: serialVersionUID n'est pas de type longBad practice
Se: serialVersionUID n'est pas staticBad practice
Se: La classe est Serializable mais sa super-classe ne possède pas de constructeur par défaut visibleBad practice
Se: La classe est Externalizable mais ne définit pas de constructeur par défautBad practice
Se: La méthode readResolve doit retourner un ObjectBad practice
Se: Champ "transient" non positionné lors de la désérialisationBad practice
SnVI: La classe est Serializable, mais ne définit pas serialVersionUIDBad practice
UI: L'utilisation de GetResource peut-être instable si la classe est étendueBad practice
BC: Transtypage impossibleCorrectness
BC: Impossible downcastCorrectness
BC: Impossible downcast of toArray() resultCorrectness
BC: instanceof renverra toujours fauxCorrectness
BIT: Bitwise add of signed byte valueCorrectness
BIT: Masques binaires incompatiblesCorrectness
BIT: Masques binaires incompatiblesCorrectness
BIT: Masques binaires incompatiblesCorrectness
BIT: Ou binaire d'un octet signéCorrectness
BIT: Check for sign of bitwise operation involving negative numberCorrectness
BOA: La classe surcharge mal une méthode implémentée dans une superclasse AdapterCorrectness
BSHIFT: Possible bad parsing of shift operationCorrectness
BSHIFT: Décalage d'un int hors de proportion (0..31)Correctness
DLS: Useless increment in return statementCorrectness
DLS: Dead store of class literalCorrectness
DLS: Incrémentation annuléeCorrectness
DMI: Reversed method argumentsCorrectness
DMI: Valeur constante pour un mois en dehors de l'intervalle attendu de 0 à 11Correctness
DMI: BigDecimal constructed from double that isn't represented preciselyCorrectness
DMI: Méthode hasNext() appelant next()Correctness
DMI: Collections should not contain themselvesCorrectness
DMI: D'oh! A nonsensical method invocationCorrectness
DMI: Invocation of hashCode on an arrayCorrectness
DMI: Double.longBitsToDouble invoked on an intCorrectness
DMI: Vacuous call to collectionsCorrectness
Dm: La réflexion ne peut pas être utilisée pour vérifier la présence d'une annotation avec la rétention par défautCorrectness
Dm: Futile attempt to change max pool size of ScheduledThreadPoolExecutorCorrectness
Dm: Creation of ScheduledThreadPoolExecutor with zero core threadsCorrectness
Dm: Useless/vacuous call to EasyMock methodCorrectness
Dm: Incorrect combination of Math.max and Math.minCorrectness
EC: Utilisation de equals() pour comparer un tableau et un objetCorrectness
EC: Appel à equals() sur un tableau équivalent à ==Correctness
EC: equals(...) used to compare incompatible arraysCorrectness
EC: Appel de equals() avec un argument à nullCorrectness
EC: Appel de equals() comparant une classe et une interface sans relationCorrectness
EC: Appel de equals() comparant différentes interfacesCorrectness
EC: Appel de equals() comparant des types différentsCorrectness
EC: Using pointer equality to compare different typesCorrectness
Eq: equals method always returns falseCorrectness
Eq: equals method always returns trueCorrectness
Eq: equals method compares class names rather than class objectsCorrectness
Eq: Covariant equals() method defined for enumCorrectness
Eq: equals() method defined that doesn't override equals(Object)Correctness
Eq: equals() method defined that doesn't override Object.equals(Object)Correctness
Eq: equals method overrides equals in superclass and may not be symmetricCorrectness
Eq: Définition d'une méthode equals() covariante, Object.equals(Object) est héritéCorrectness
FE: Test d'égalité avec NaN erronéCorrectness
FS: Format string placeholder incompatible with passed argumentCorrectness
FS: The type of a supplied argument doesn't match format specifierCorrectness
FS: MessageFormat supplied where printf style format expectedCorrectness
FS: More arguments are passed than are actually used in the format stringCorrectness
FS: Illegal format stringCorrectness
FS: Format string references missing argumentCorrectness
FS: No previous argument for format stringCorrectness
GC: No relationship between generic parameter and method argumentCorrectness
HE: Signature declares use of unhashable class in hashed constructCorrectness
HE: Use of class without a hashCode() method in a hashed data structureCorrectness
ICAST: int value converted to long and used as absolute timeCorrectness
ICAST: Valeur entière transtypée en nombre flottant passée à Math.ceilCorrectness
ICAST: Valeur entière transtypée en flottant puis transmise à Math.roundCorrectness
IJU: JUnit assertion in run method will not be noticed by JUnitCorrectness
IJU: TestCase declares a bad suite method Correctness
IJU: TestCase sans testsCorrectness
IJU: Une classe dérivant de TestCase implémente setUp() sans appeler super.setUp()Correctness
IJU: Une classe dérivant de TestCase implémente une méthode suite() non statiqueCorrectness
IJU: Une classe dérivant de TestCase implémente tearDown() sans appeler super.tearDown()Correctness
IL: Un conteneur est ajouté à lui-mêmeCorrectness
IL: Boucle apparemment inifinieCorrectness
IL: Boucle récursive infinieCorrectness
IM: Multiplication d'un entier avec le résulat entier d'un moduloCorrectness
INT: Bad comparison of int value with long constantCorrectness
INT: Bad comparison of nonnegative value with negative constant or zeroCorrectness
INT: Bad comparison of signed byteCorrectness
IO: Doomed attempt to append to an object output streamCorrectness
IP: Un paramètre est ré-écrit avant d'être utiliséCorrectness
MF: La classe définit un champ qui masque un champ d'une classe mèreCorrectness
MF: La méthode définit une variable qui masque un champCorrectness
NP: Déréférencement d'un pointeur null dans la méthodeCorrectness
NP: Déréférencement d'un pointeur null dans le chemin d'exception d'une méthodeCorrectness
NP: Méthode ne testant pas les paramètres à nullCorrectness
NP: close() invoked on a value that is always nullCorrectness
NP: Null déréférencéCorrectness
NP: Value is null and guaranteed to be dereferenced on exception pathCorrectness
NP: Non-null field is not initializedCorrectness
NP: Appel de méthode transmettant null à un paramètre déclaré @NonNullCorrectness
NP: Méthode renvoyer null mais déclarée @NonNullCorrectness
NP: A known null value is checked to see if it is an instance of a typeCorrectness
NP: Possible déréférencement d'un pointeur null dans une méthodeCorrectness
NP: Possible déréférencement d'un pointeur null dans le chemin d'exception d'une méthodeCorrectness
NP: Méthode passant null à un paramètre déréférencé inconditionnellementCorrectness
NP: Appel de méthode passant null à un paramètre déréférencé inconditionnellementCorrectness
NP: Appel à une méthode non virtuelle passant null à un paramètre déréférencé de façon inconditionnelleCorrectness
NP: Method with Optional return type returns explicit nullCorrectness
NP: Stocke une valeur null dans un champ annoté NonNullCorrectness
NP: Lecture d'un champ jamais écritCorrectness
Nm: La classe définit equal() ; ne devrait-ce pas être equals() ?Correctness
Nm: La classe définit hashcode() ; ne devrait-ce pas être hashCode() ?Correctness
Nm: La classe définit tostring() ; ne devrait-ce pas être toString() ?Correctness
Nm: Confusion apparente entre une méthode et un constructeurCorrectness
Nm: Noms de méthodes très ambigusCorrectness
Nm: Method doesn't override method in superclass due to wrong package for parameterCorrectness
QBA: Méthode assignant une valeur boléenne fixe dans une expression booléenneCorrectness
RANGE: Array index is out of boundsCorrectness
RANGE: Array length is out of boundsCorrectness
RANGE: Array offset is out of boundsCorrectness
RANGE: String index is out of boundsCorrectness
RC: Comparaison de références suspecteCorrectness
RCN: Test de nullité d'une valeur préalablement déréférencéeCorrectness
RE: Syntaxe d'expression régulière invalideCorrectness
RE: File.separator used for regular expressionCorrectness
RE: "." utilisé dans une expression régulièreCorrectness
RV: Les valeurs aléatoires entre 0 et 1 sont réduites à l'entier 0Correctness
RV: Bad attempt to compute absolute value of signed 32-bit hashcode Correctness
RV: Bad attempt to compute absolute value of signed random integerCorrectness
RV: Code checks for specific values returned by compareToCorrectness
RV: Exception created and dropped rather than thrownCorrectness
RV: La méthode ignore une valeur de retourCorrectness
RpC: Repeated conditional testsCorrectness
SA: Auto-alimentation d'un champsCorrectness
SA: Self comparison of field with itselfCorrectness
SA: Nonsensical self computation involving a field (e.g., x & x)Correctness
SA: Self assignment of local rather than assignment to fieldCorrectness
SA: Self comparison of value with itselfCorrectness
SA: Nonsensical self computation involving a variable (e.g., x & x)Correctness
SF: Dead store due to switch statement fall throughCorrectness
SF: Dead store due to switch statement fall through to throwCorrectness
SIC: Deadly embrace of non-static inner class and thread localCorrectness
SIO: Vérification de type inutile avec l'opérateur instanceofCorrectness
SQL: Méthode essayant au paramêtre d'indice 0 d'un PreparedStatementCorrectness
SQL: Méthode essayant d'accèder à un champ de ResultSet d'indice 0Correctness
STI: Utilisation superflue d'un appel à currentThread() pour appeler interrupted()Correctness
STI: Thread.interrupted() appelée par erreur sur un objet Thread arbitraireCorrectness
Se: Méthode devant être privée pour que la sérialisation fonctionneCorrectness
Se: The readResolve method must not be declared as a static method. Correctness
TQ: Value annotated as carrying a type qualifier used where a value that must not carry that qualifier is requiredCorrectness
TQ: Comparing values with incompatible type qualifiersCorrectness
TQ: Value that might not carry a type qualifier is always used in a way requires that type qualifierCorrectness
TQ: Value that might carry a type qualifier is always used in a way prohibits it from having that type qualifierCorrectness
TQ: Value annotated as never carrying a type qualifier used where value carrying that qualifier is requiredCorrectness
TQ: Value without a type qualifier used where a value is required to have that qualifierCorrectness
UMAC: Méthode non appelable définie dans une classe anonymeCorrectness
UR: Lecture d'un champ non initialisé dans un constructeurCorrectness
UR: Uninitialized read of field method called from constructor of superclassCorrectness
USELESS_STRING: Invocation of toString on an unnamed arrayCorrectness
USELESS_STRING: Invocation de toString sur un tableauCorrectness
USELESS_STRING: Array formatted in useless way using format stringCorrectness
UwF: Champ uniquement mis à nullCorrectness
UwF: Champ jamais écritCorrectness
VA: Tableau de primitives passé à une fonction attendant un nombre variable d'objets en argumentCorrectness
LG: Potential lost logger changes due to weak reference in OpenJDKExperimental
OBL: Method may fail to clean up stream or resourceExperimental
OBL: Method may fail to clean up stream or resource on checked exceptionExperimental
Dm: La méthode appelle les String.toUpperCase() ou String.toLowerCase ; utilisez plutôt la version paramètrée par une LocaleInternationalization
Dm: Reliance on default encodingInternationalization
DP: Les chargeurs de classes ne doivent être créés qu'à partir de block doPrivilegedMalicious code vulnerability
DP: Méthode invoquée alors qu'elle ne devrait l'être qu'à partir d'un block doPrivilegedMalicious code vulnerability
EI: Une méthode peut exposer sa représentation interne en renvoyant une référence à un objet modifiableMalicious code vulnerability
EI2: Une méthode expose sa représentation interne en incorporant une référence à un objet modifiableMalicious code vulnerability
FI: Un finaliseur devrait être protégé, pas publicMalicious code vulnerability
MS: Une méthode peut exposer un état interne statique en stockant un objet modifiable dans un champs statiqueMalicious code vulnerability
MS: Un champ n'est pas final et ne peut pas être protégé face à du code malveillantMalicious code vulnerability
MS: Une méthode statique publique risque d'exposer une représentation interne en renvoyant un tableauMalicious code vulnerability
MS: Le champ devrait être à la fois final et package protectedMalicious code vulnerability
MS: Un champ est un tableau modifiableMalicious code vulnerability
MS: Field is a mutable collectionMalicious code vulnerability
MS: Field is a mutable collection which should be package protectedMalicious code vulnerability
MS: Un champ modifiable est une HashtableMalicious code vulnerability
MS: Le champ devrait être sorti de l'interface et mis en package protectedMalicious code vulnerability
MS: Un champ devrait être package protectedMalicious code vulnerability
MS: Un champ n'est pas final alors qu'il devrait l'êtreMalicious code vulnerability
MS: Field isn't final but should be refactored to be soMalicious code vulnerability
AT: Sequence of calls to concurrent abstraction may not be atomicMultithreaded correctness
DC: Possible double vérification d'un champMultithreaded correctness
DC: Possible exposure of partially initialized objectMultithreaded correctness
DL: Synchronization on BooleanMultithreaded correctness
DL: Synchronization on boxed primitiveMultithreaded correctness
DL: Synchronization on interned String Multithreaded correctness
DL: Synchronization on boxed primitive valuesMultithreaded correctness
Dm: Wait() appelé sur une ConditionMultithreaded correctness
Dm: Thread créé avec la méthode run vide par défautMultithreaded correctness
ESync: Bloc synchronisé videMultithreaded correctness
IS: Synchronisation incohérenteMultithreaded correctness
IS: Champ non protégé contre les accès concurrentsMultithreaded correctness
JLM: Synchronisation effectuée sur un Lock java.util.concurrentMultithreaded correctness
JLM: Synchronization performed on util.concurrent instanceMultithreaded correctness
JLM: Using monitor style wait methods on util.concurrent abstractionMultithreaded correctness
LI: Initialisation paresseuse incorrecte d'un champ statiqueMultithreaded correctness
LI: Incorrect lazy initialization and update of static fieldMultithreaded correctness
ML: Synchronization on field in futile attempt to guard that fieldMultithreaded correctness
ML: La méthode se synchronise sur un champ mis à jourMultithreaded correctness
MSF: Mutable servlet fieldMultithreaded correctness
MWN: notify() non appareilléMultithreaded correctness
MWN: wait() non appareilléMultithreaded correctness
NN: Appel notify() isolé dans une méthodeMultithreaded correctness
NP: Synchronize and null check on the same field.Multithreaded correctness
No: Utilisation de notify() plutôt que notifyAll() dans une méthodeMultithreaded correctness
RS: Seule la méthode readObject() est synchroniséeMultithreaded correctness
RV: Return value of putIfAbsent ignored, value passed to putIfAbsent reusedMultithreaded correctness
Ru: Invocation de run() sur un thread (Vouliez-vous plutôt dire start() ?)Multithreaded correctness
SC: Un constructeur invoque Thread.start()Multithreaded correctness
SP: Méthode bouclant sur un champMultithreaded correctness
STCAL: Call to static CalendarMultithreaded correctness
STCAL: Call to static DateFormatMultithreaded correctness
STCAL: Static Calendar fieldMultithreaded correctness
STCAL: Static DateFormatMultithreaded correctness
SWL: Appel de la méthode Thread.sleep() avec un verrouMultithreaded correctness
TLW: wait() avec deux verrous en attenteMultithreaded correctness
UG: Méthode getXXX non synchronisée, méthode setXXX synchroniséeMultithreaded correctness
UL: La méthode ne libère pas un verrou dans tous les chemins d'exécutionMultithreaded correctness
UL: La méthode ne libère pas un verrou dans tous les chemins d'exceptionMultithreaded correctness
UW: Méthode contenant un wait() non conditionnéMultithreaded correctness
VO: An increment to a volatile field isn't atomicMultithreaded correctness
VO: Une référence volatile à un tableau ne traite pas les éléments du tableau comme volatilesMultithreaded correctness
WL: Synchronization on getClass rather than class literalMultithreaded correctness
WS: Seule la méthode writeObject() est synchroniséeMultithreaded correctness
Wa: Condition.await() en dehors d'une boucleMultithreaded correctness
Wa: Méthode contenant un wait() en dehors d'une boucleMultithreaded correctness
Bx: Primitive value is boxed and then immediately unboxedPerformance
Bx: Primitive value is boxed then unboxed to perform primitive coercionPerformance
Bx: Primitive value is unboxed and coerced for ternary operatorPerformance
Bx: Boxed value is unboxed and then immediately reboxedPerformance
Bx: Boxing a primitive to comparePerformance
Bx: Boxing/unboxing to parse a primitivePerformance
Bx: Méthode allouant une primitive boxed pour appeler toStringPerformance
Bx: Method invokes inefficient floating-point Number constructor; use static valueOf insteadPerformance
Bx: Method invokes inefficient Number constructor; use static valueOf insteadPerformance
Dm: The equals and hashCode methods of URL are blockingPerformance
Dm: Maps and sets of URLs can be performance hogsPerformance
Dm: La méthode invoque le constructeur inutile Boolean() ; utilisez Boolean.valueOf(...) à la placePerformance
Dm: Ramasse-miettes explicite ; extrêmement douteux sauf dans du code de banc d'essaiPerformance
Dm: Méthode allouant un objet juste pour obtenir la classePerformance
Dm: Utiliser la méthode nextInt de Random plutôt que nextDouble pour générer un entier aléatoirePerformance
Dm: La méthode invoque le constructeur inutile String(String) ; utilisez juste l'argumentPerformance
Dm: La méthode appel toString() sur un objet String ; utilisez directement l'objet StringPerformance
Dm: La méthode invoque le constructeur inutile String() ; utilisez juste ""Performance
HSC: Huge string constants is duplicated across multiple class filesPerformance
SBSC: La méthode concatène des chaînes au moyen de + en bouclePerformance
SIC: Devrait être une classe interne statiquePerformance
SIC: Peut-être transformée en classe interne statique nomméePerformance
SIC: Pourrait-être transformée en classe interne statiquePerformance
SS: Champ non lu : devrait-il être statique ?Performance
UM: Appel d'une méthode statique de la classe Math sur une valeur constantePerformance
UPM: Méthode privée jamais appeléePerformance
UrF: Champ inutiliséPerformance
UuF: Champ inutiliséPerformance
WMI: Utilisation inefficace d'un itérateur sur keySet au lieu de entrySetPerformance
Dm: Hardcoded constant database passwordSecurity
Dm: Empty database passwordSecurity
HRS: HTTP cookie formed from untrusted inputSecurity
HRS: HTTP Response splitting vulnerabilitySecurity
PT: Absolute path traversal in servletSecurity
PT: Relative path traversal in servletSecurity
SQL: Une chaîne non constante est passée à la méthode execute d'une commande SQLSecurity
SQL: Une requète est préparée à partir d'une chaine non constanteSecurity
XSS: JSP reflected cross site scripting vulnerabilitySecurity
XSS: Servlet reflected cross site scripting vulnerability in error pageSecurity
XSS: Servlet reflected cross site scripting vulnerabilitySecurity
BC: Transtypage douteux d'un type Collection vers une classe abstraiteDodgy code
BC: Transtypage douteux vers une collection concrèteDodgy code
BC: Transtypage non vérifié/non confirméDodgy code
BC: Unchecked/unconfirmed cast of return value from methodDodgy code
BC: instanceof renverra toujours vraiDodgy code
BSHIFT: Décalage à droite non signé et transtypage short/byteDodgy code
CI: Classe finale déclarant un champ protégéDodgy code
DB: Méthode utilisant le même code pour deux branchesDodgy code
DB: Méthode utilisant le même code pour deux clauses switchDodgy code
DLS: Alimentation à perte d'une variable localeDodgy code
DLS: Useless assignment in return statementDodgy code
DLS: Alimentation à null d'une variableDodgy code
DLS: Dead store to local variable that shadows fieldDodgy code
DMI: Chemin absolu codé en dur dans le codeDodgy code
DMI: Objet non sérialisable écrit dans un ObjectOutputDodgy code
DMI: Appel de substring(0) qui retourne la valeur originaleDodgy code
Dm: Thread passed where Runnable expectedDodgy code
Eq: Class doesn't override equals in superclassDodgy code
Eq: Unusual equals method Dodgy code
FE: Test d'égalité en virgule flottante.Dodgy code
FS: Non-Boolean argument formatted using %b format specifierDodgy code
IA: Appel ambigu d'une méthode hérité ou externeDodgy code
IC: Initialisation circulaireDodgy code
ICAST: Résultat d'une division entière transtypé en nombre flottantDodgy code
ICAST: Résultat d'une multiplication entière transtypée en longDodgy code
IM: Possibilité de débordement du calcul d'une moyenneDodgy code
IM: Test d'impaire ne fonctionnant pas avec les négatifsDodgy code
INT: Reste entier modulo 1Dodgy code
INT: Vacuous bit mask operation on integer valueDodgy code
INT: Comparaison inutile de valeurs entièresDodgy code
MTIA: La classe hérite de Servlet et utilise les variables de l'instance.Dodgy code
MTIA: La classe hérite d'une classe action Struts et utilise les variables de l'instance.Dodgy code
NP: Dereference of the result of readLine() without nullcheckDodgy code
NP: Déréférencement immédiat du résultat d'un readLine()Dodgy code
NP: Chargement d'une valeur connue pour être à nullDodgy code
NP: Method tightens nullness annotation on parameterDodgy code
NP: Method relaxes nullness annotation on return valueDodgy code
NP: Pointeur à null renvoyé par une méthode qui risque d'être déréférencéDodgy code
NP: Possible null pointer dereference on branch that might be infeasibleDodgy code
NP: Parameter must be non-null but is marked as nullableDodgy code
NP: Read of unwritten public or protected fieldDodgy code
NS: Potentially dangerous use of non-short-circuit logicDodgy code
NS: Utilisation discutable de logique binaireDodgy code
PZLA: Envisagez de renvoyer un tableau vide plutôt que nullDodgy code
QF: Incrémentation compliquée, subtile au incorrecte dans une boucle forDodgy code
RCN: Comparaison redondante d'une valeur non nulle avec nullDodgy code
RCN: Comparaison redondante de deux valeurs nullesDodgy code
RCN: Test de nullité redondant sur une valeur non nulleDodgy code
RCN: Test de nullité redondant sur une valeur connue pour être à nullDodgy code
REC: java.lang.Exception est intercepté alors qu'Exception n'est jamais lancéDodgy code
RI: Classe implémentant la même interface que sa super-classeDodgy code
RV: Méthode vérifiant que le résultat d'un String.indexOf() est positifDodgy code
RV: Méthode ignorant le résultat d'un readLine() après avoir vérifié qu'il est non nulDodgy code
RV: Reste d'un hashCode pouvant être négatifDodgy code
RV: Reste d'un entier signé 32 bits aléeatoireDodgy code
RV: Method ignores return value, is this OK?Dodgy code
RV: Return value of method without side effect is ignoredDodgy code
SA: Double assignment of fieldDodgy code
SA: Double assignment of local variable Dodgy code
SA: Auto-alimentation d'une variable localeDodgy code
SF: Un switch comporte un cas qui déborde sur le suivantDodgy code
SF: Switch statement found where default case is missingDodgy code
ST: Ecriture d'un champ statique depuis la méthode d'une instanceDodgy code
Se: Private readResolve method not inherited by subclassesDodgy code
Se: Transient field of class that isn't Serializable. Dodgy code
TQ: Value required to have type qualifier, but marked as unknownDodgy code
TQ: Value required to not have type qualifier, but marked as unknownDodgy code
UC: Condition has no effectDodgy code
UC: Condition has no effect due to the variable typeDodgy code
UC: Useless object createdDodgy code
UC: Useless object created on stackDodgy code
UC: Useless non-empty void methodDodgy code
UCF: Instruction de contrôle du flux inutileDodgy code
UCF: Useless control flow to next lineDodgy code
UrF: Unread public/protected fieldDodgy code
UuF: Unused public or protected fieldDodgy code
UwF: Champ non initialisé dans le constructeurDodgy code
UwF: Unwritten public or protected fieldDodgy code
XFB: Méthode instanciant directement une implémentation spécifique des interfaces XMLDodgy code
-

Descriptions

-

BC: Equals method should not assume anything about the type of its argument (BC_EQUALS_METHOD_SHOULD_WORK_FOR_ALL_OBJECTS)

- - -

-The equals(Object o) method shouldn't make any assumptions -about the type of o. It should simply return -false if o is not the same type as this. -

- - -

BIT: Check for sign of bitwise operation (BIT_SIGNED_CHECK)

- - -

This method compares an expression such as -((event.detail & SWT.SELECTED) > 0). -Using bit arithmetic and then comparing with the greater than operator can -lead to unexpected results (of course depending on the value of -SWT.SELECTED). If SWT.SELECTED is a negative number, this is a candidate -for a bug. Even when SWT.SELECTED is not negative, it seems good practice -to use '!= 0' instead of '> 0'. -

- - -

CN: La classe implémente Cloneable mais ne définit et n'utilise pas la méthode clone() (CN_IDIOM)

- - -

La classe implémente Cloneable sans définir ou utiliser la méthode clone().

- - -

CN: La méthode clone() n'appelle pas super.clone() (CN_IDIOM_NO_SUPER_CALL)

- - -

Cette classe définit une méthode clone() qui n'appelle pas super.clone(), et n'est pas finale. Si cette classe ("A") est étendue par une classe fille ("B"), et que la classe fille B appelle super.clone(), alors il est probable que la méthode clone() de B retournera un objet de type A, ce qui viole le contrat standard de clone().

-

Si toutes les méthodes clone() appellent super.clone(), elles ont alors la garantie d'utiliser Object.clone(), qui retourne toujours un objet du type correct.

- - -

CN: Class defines clone() but doesn't implement Cloneable (CN_IMPLEMENTS_CLONE_BUT_NOT_CLONEABLE)

- - -

This class defines a clone() method but the class doesn't implement Cloneable. -There are some situations in which this is OK (e.g., you want to control how subclasses -can clone themselves), but just make sure that this is what you intended. -

- - -

CNT: Rough value of known constant found (CNT_ROUGH_CONSTANT_VALUE)

- - -

It's recommended to use the predefined library constant for code clarity and better precision.

- - -

Co: Une classe abstraite définit une méthode compareTo() covariante (CO_ABSTRACT_SELF)

- - -

Cette classe définit une version covariante de compareTo(). Pour surcharger correctement la méthode compareTo() de l'interface Comparable, le paramètre de compareTo() doit être du type java.lang.Object.

- - -

Co: compareTo()/compare() incorrectly handles float or double value (CO_COMPARETO_INCORRECT_FLOATING)

- - -

This method compares double or float values using pattern like this: val1 > val2 ? 1 : val1 < val2 ? -1 : 0. -This pattern works incorrectly for -0.0 and NaN values which may result in incorrect sorting result or broken collection -(if compared values are used as keys). Consider using Double.compare or Float.compare static methods which handle all -the special cases correctly.

- - -

Co: compareTo()/compare() returns Integer.MIN_VALUE (CO_COMPARETO_RESULTS_MIN_VALUE)

- - -

In some situation, this compareTo or compare method returns -the constant Integer.MIN_VALUE, which is an exceptionally bad practice. - The only thing that matters about the return value of compareTo is the sign of the result. - But people will sometimes negate the return value of compareTo, expecting that this will negate - the sign of the result. And it will, except in the case where the value returned is Integer.MIN_VALUE. - So just return -1 rather than Integer.MIN_VALUE. - - -

Co: Définition d'une méthode compareTo() covariante (CO_SELF_NO_OBJECT)

- - -

Cette classe définit une version covariante de compareTo(). Pour correctement surcharger la méthode compareTo() de l'interface Comparable, le paramètre de compareTo() doit être du type java.lang.Object.

- - -

DE: La méthode peut déclencher une exception (DE_MIGHT_DROP)

- - -

Cette méthode peut déclencher une exception. En général, les exceptions doivent être gérées ou transmises hors de la méthode.

- - -

DE: La méthode peut ignorer une exception (DE_MIGHT_IGNORE)

- - -

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.

- - -

DMI: Adding elements of an entry set may fail due to reuse of Entry objects (DMI_ENTRY_SETS_MAY_REUSE_ENTRY_OBJECTS)

- - -

The entrySet() method is allowed to return a view of the - underlying Map in which a single Entry object is reused and returned - during the iteration. As of Java 1.6, both IdentityHashMap - and EnumMap did so. When iterating through such a Map, - the Entry value is only valid until you advance to the next iteration. - If, for example, you try to pass such an entrySet to an addAll method, - things will go badly wrong. -

- - -

DMI: Random object created and used only once (DMI_RANDOM_USED_ONLY_ONCE)

- - -

This code creates a java.util.Random object, uses it to generate one random number, and then discards -the Random object. This produces mediocre quality random numbers and is inefficient. -If possible, rewrite the code so that the Random object is created once and saved, and each time a new random number -is required invoke a method on the existing Random object to obtain it. -

- -

If it is important that the generated Random numbers not be guessable, you must not create a new Random for each random -number; the values are too easily guessable. You should strongly consider using a java.security.SecureRandom instead -(and avoid allocating a new SecureRandom for each random number needed). -

- - -

DMI: Don't use removeAll to clear a collection (DMI_USING_REMOVEALL_TO_CLEAR_COLLECTION)

- - -

If you want to remove all elements from a collection c, use c.clear, -not c.removeAll(c). Calling c.removeAll(c) to clear a collection -is less clear, susceptible to errors from typos, less efficient and -for some collections, might throw a ConcurrentModificationException. -

- - -

Dm: La méthode invoque System.exit(...) (DM_EXIT)

- - -

Invoquer System.exit() arrête toute la JVM. Cela ne doit être fait que lorsque c'est nécessaire. De tels appels rendent difficile ou impossible l'invocation de votre code par d'autre code. Envisagez de déclencher une RuntimeException à la place.

- - -

Dm: Méthode invoquant runFinalizersOnExit, l'une des plus dangeureuses méthodes des librairies Java (DM_RUN_FINALIZERS_ON_EXIT)

- - -

N'appelez jamais System.runFinalizersOnExit ou Runtime.runFinalizersOnExit pour quelque raison que ce soit : elles font partie des méthodes les plus dangeureuses des librairies Java

-

Joshua Bloch

- - -

ES: Comparison of String parameter using == or != (ES_COMPARING_PARAMETER_STRING_WITH_EQ)

- - -

This code compares a java.lang.String parameter for reference -equality using the == or != operators. Requiring callers to -pass only String constants or interned strings to a method is unnecessarily -fragile, and rarely leads to measurable performance gains. Consider -using the equals(Object) method instead.

- - -

ES: Comparaison d'objets String utilisant == ou != (ES_COMPARING_STRINGS_WITH_EQ)

- - -

Ce code compare des objets java.lang.String au moyen de l'égalité par référence des opérateurs == ou !=. A moins que les deux chaînes ne soient des constantes dans le fichier source ou aient été internalisées au moyen de la méthode String.intern(), deux chaînes identiques peuvent être représentées par deux objets String différents. Envisagez d'utiliser la méthode equals(Object) à la place.

- - -

Eq: Une classe abstraite définit une méthode equals() covariante (EQ_ABSTRACT_SELF)

- - -

Cette classe définit une version covariante de la méthode equals(). Pour surcharger correctement la méthode equals() de java.lang.Object, le paramètre de equals() doit être du type java.lang.Object.

- - -

Eq: Equals checks for incompatible operand (EQ_CHECK_FOR_OPERAND_NOT_COMPATIBLE_WITH_THIS)

- - -

This equals method is checking to see if the argument is some incompatible type -(i.e., a class that is neither a supertype nor subtype of the class that defines -the equals method). For example, the Foo class might have an equals method -that looks like: -

-
-public boolean equals(Object o) {
-  if (o instanceof Foo)
-    return name.equals(((Foo)o).name);
-  else if (o instanceof String)
-    return name.equals(o);
-  else return false;
-
- -

This is considered bad practice, as it makes it very hard to implement an equals method that -is symmetric and transitive. Without those properties, very unexpected behaviors are possible. -

- - -

Eq: Class defines compareTo(...) and uses Object.equals() (EQ_COMPARETO_USE_OBJECT_EQUALS)

- - -

This class defines a compareTo(...) method but inherits its - equals() method from java.lang.Object. - Generally, the value of compareTo should return zero if and only if - equals returns true. If this is violated, weird and unpredictable - failures will occur in classes such as PriorityQueue. - In Java 5 the PriorityQueue.remove method uses the compareTo method, - while in Java 6 it uses the equals method.

- -

From the JavaDoc for the compareTo method in the Comparable interface: -

-It is strongly recommended, but not strictly required that (x.compareTo(y)==0) == (x.equals(y)). -Generally speaking, any class that implements the Comparable interface and violates this condition -should clearly indicate this fact. The recommended language -is "Note: this class has a natural ordering that is inconsistent with equals." -

- - -

Eq: equals method fails for subtypes (EQ_GETCLASS_AND_CLASS_CONSTANT)

- - -

This class has an equals method that will be broken if it is inherited by subclasses. -It compares a class literal with the class of the argument (e.g., in class Foo -it might check if Foo.class == o.getClass()). -It is better to check if this.getClass() == o.getClass(). -

- - -

Eq: Définition d'une méthode equals() covariante (EQ_SELF_NO_OBJECT)

- - -

Cette classe définit une version covariante de equals(). Pour surcharger correctement la méthode equals() de java.lang.Object, le paramètre de equals() doit être du type java.lang.Object.

- - -

FI: Un finaliseur vide devrait être supprimé (FI_EMPTY)

- - -

Les méthodes finalize() vides sont inutiles, donc elles devraient être supprimées.

- - -

FI: Invocation explicite d'un finaliseur (FI_EXPLICIT_INVOCATION)

- - -

Cette méthode contient un appel explicite à la méthode finalize() d'un objet. Les méthodes finalize() étant sensées n'être appelées qu'une fois, et uniquement par la JVM, c'est une mauvaise idée.

- - -

FI: Finalizer nulls fields (FI_FINALIZER_NULLS_FIELDS)

- - -

This finalizer nulls out fields. This is usually an error, as it does not aid garbage collection, - and the object is going to be garbage collected anyway.

- - -

FI: Finalizer only nulls fields (FI_FINALIZER_ONLY_NULLS_FIELDS)

- - -

This finalizer does nothing except null out fields. This is completely pointless, and requires that -the object be garbage collected, finalized, and then garbage collected again. You should just remove the finalize -method.

- - -

FI: Le finaliseur n'appelle pas le finaliseur de la super-classe (FI_MISSING_SUPER_CALL)

- - -

Cette méthode finalize() n'appelle pas la méthode finalize() de sa classe mère ; donc toutes les actions définies au niveau de la classe mère seront ignorées. Ajoutez un appel à super.finalize().

- - -

FI: Un finaliseur rend inutile celui de sa super-classe (FI_NULLIFY_SUPER)

- - -

Cette méthode finalize() vide rend explicitement inutile tout finaliseur défini dans les super-classes. Toute action définie dans un finaliseur d'une superclasse sera ignorée. A moins que cela ne soit voulu, supprimer cette méthode.

- - -

FI: Le finaliseur ne fait rien sauf appeler celui de la super-classe (FI_USELESS)

- - -

La seule chose que cette méthode finalize() fait est d'appeler la méthode finalize() de la super-classe, ce qui la rend redondante. Supprimez la.

- - -

FS: Format string should use %n rather than \n (VA_FORMAT_STRING_USES_NEWLINE)

- - -

-This format string includes a newline character (\n). In format strings, it is generally - preferable to use %n, which will produce the platform-specific line separator. -

- - -

GC: Unchecked type in generic call (GC_UNCHECKED_TYPE_IN_GENERIC_CALL)

- - -

This call to a generic collection method passes an argument - while compile type Object where a specific type from - the generic type parameters is expected. - Thus, neither the standard Java type system nor static analysis - can provide useful information on whether the - object being passed as a parameter is of an appropriate type. -

- - -

HE: La classe définit equals() mais pas hashCode() (HE_EQUALS_NO_HASHCODE)

- - -

Cette classe surcharge equals(Object), mais pas hashCode(). C'est pourquoi la classe peut violer le contrat indiquant que des objets égaux doivent avoir des codes de hachage identiques.

- - -

HE: La classe définit equals() et utilise Object.hashCode() (HE_EQUALS_USE_HASHCODE)

- - -

Cette classe surcharge equals(Object), pas hashCode(), et hérite de l'implémentation de hashCode() issue de java.lang.Object (qui renvoie le code de hachage d'identité, une valeur arbitraire assignée à l'objet par la JVM). C'est pourquoi la classe a des chances de violer le contrat impliquant que des objets égaux doivent avoir des codes de hachage identiques.

-

Si vous ne pensez pas que des instances de cette classe soient un jour insérés dans desHashMap/Hashtable, l'implémentation recommendée est du type :

-

-public int hashCode() {
-  assert false : "hashCode not designed";
-  return 42; // any arbitrary constant will do 
-}
-

- - -

HE: La classe définit hashCode() mais pas equals() (HE_HASHCODE_NO_EQUALS)

- - -

Cette classe définit une méthode hashCode() mais pas de méthode equals(). C'est pourquoi cette classe peut violer le contrat indiquant que des objets identiques doivent avoir des codes de hachage identiques.

- - -

HE: La classe définit hashCode() et utilise Object.equals() (HE_HASHCODE_USE_OBJECT_EQUALS)

- - -

Cette classe définit une méthode hashCode() mais hérite la méthode equals() de java.lang.Object (qui définit l'égalité par comparaison des références des objets). Bien que cela satisfasse certainement le contrat indiquant que les objets égaux doivent avoir des codes de hachage égaux, ce n'est certainement pas ce qui était voulu lors de la surcharge de la méthode hashCode() (Surcharger hashCode() 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.)

-

Si vous ne pensez pas que des instances de cette classe soient un jour insérées dans des HashMap/HashTable, l'implémentation recommendée de hashCode est :

-

-public int hashCode() {
-  assert false : "hashCode not designed";
-  return 42; // any arbitrary constant will do 
-  }
-

- - -

HE: La classe hérite de equals() et utilise Object.hashCode() (HE_INHERITS_EQUALS_USE_HASHCODE)

- - -

Cette classe hérite de la méthode equals((Object) d'une super-classe abstraite, et de la méthode hashCode() de l'objet java.lang.Object (qui renvoi le code de hachage d'identité, une valeur arbitraire assignée à l'objet par la JVM). C'est pourquoi la classe viole probablement le contrat indiquant que des objets égaux doivent avoir des codes de hachage identiques.

-

Si vous ne souhaitez pas définir une méthode hashCode() et/ou ne pensez pas que l'objet puisse un jour être mis dans des HashMap/Hashtable, définissez une méthode hashCode() déclenchant une UnsupportedOperationException.

- - -

IC: Classe mère utilisant une sous-classe durant son initialisation (IC_SUPERCLASS_USES_SUBCLASS_DURING_INITIALIZATION)

- - -

Durant l'intialisation, une classe utilise activement l'une de ses sous-classes. Cette sous-classe ne sera pas encore initialisée lors de la première utilisation. Par exemple, dans le code suivant, foo sera à null.

-

-public class CircularClassInitialization {
-    static class InnerClassSingleton extends CircularClassInitialization {
-        static InnerClassSingleton singleton = new InnerClassSingleton();
-    }
-    static CircularClassInitialization foo = InnerClassSingleton.singleton;
-}
-

- - -

IMSE: Interception douteuse d'une IllegalMonitorStateException (IMSE_DONT_CATCH_IMSE)

- - -

IllegalMonitorStateException n'est généralement déclenchée que dans le cas d'une faille dans la conception du code (appeler wait() ou notify() sur un objet dont on ne possède pas le verrou).

- - -

ISC: Instantiation inutile d'une classe qui n'a que des méthodes statiques (ISC_INSTANTIATE_STATIC_CLASS)

- - -

Cette classe alloue un objet basé sur une classe qui n'a que des méthodes statiques. Cet objet n'a pas besoin d'être créé, accédez directement aux méthodes en utilisant le nom de la classe.

- - -

It: La méthode next() de Iterator ne peut pas déclencher une exception NoSuchElement (IT_NO_SUCH_ELEMENT)

- - -

Cette classe implémente l'interface java.util.Iterator. Néanmoins, sa méthode next() n'est pas capable de déclencher java.util.NoSuchElementException. La méthode next() devrait être modifiée pour déclencher NoSuchElementException si elle est appelée alors qu'il n'y a plus d'éléments à renvoyer.

- - -

J2EE: Stockage d'un objet non serialisable dans une session Http (J2EE_STORE_OF_NON_SERIALIZABLE_OBJECT_INTO_SESSION)

- - -

Ce code semble stocker un objet non sérialisable dans un HttpSession. Une erreur se produira si cette session est rendue passive ou migrée.

- - -

JCIP: Les champs d'une classe immuable devraient être finaux. (JCIP_FIELD_ISNT_FINAL_IN_IMMUTABLE_CLASS)

- - -La classe est annotée avec net.jcip.annotations.Immutable, et la règle liée à cette annotation réclame que tous les champs soient marqués final. - - -

ME: Public enum method unconditionally sets its field (ME_ENUM_FIELD_SETTER)

- - -

This public method declared in public enum unconditionally sets enum field, thus this field can be changed by malicious code - or by accident from another package. Though mutable enum fields may be used for lazy initialization, it's a bad practice to expose them to the outer world. - Consider removing this method or declaring it package-private.

- - -

ME: Enum field is public and mutable (ME_MUTABLE_ENUM_FIELD)

- - -

A mutable public field is defined inside a public enum, thus can be changed by malicious code or by accident from another package. - Though mutable enum fields may be used for lazy initialization, it's a bad practice to expose them to the outer world. - Consider declaring this field final and/or package-private.

- - -

NP: Method with Boolean return type returns explicit null (NP_BOOLEAN_RETURN_NULL)

- - -

- A method that returns either Boolean.TRUE, Boolean.FALSE or null is an accident waiting to happen. - This method can be invoked as though it returned a value of type boolean, and - the compiler will insert automatic unboxing of the Boolean value. If a null value is returned, - this will result in a NullPointerException. -

- - -

NP: Clone method may return null (NP_CLONE_COULD_RETURN_NULL)

- - -

- This clone method seems to return null in some circumstances, but clone is never - allowed to return a null value. If you are convinced this path is unreachable, throw an AssertionError - instead. -

- - -

NP: Méthode equals() ne vérifiant pas la nullité (NP_EQUALS_SHOULD_HANDLE_NULL_ARGUMENT)

- - -

Cette implémentation de equals(Object) ne respecte pas le contrat défini par java.lang.Object.equals() car elle ne vérifie la nullité du paramètre reçu en argument. Toutes les méthodes equals() doivent renvoyer false quand elles reçoivent une valeur à null.

- - -

NP: toString method may return null (NP_TOSTRING_COULD_RETURN_NULL)

- - -

- This toString method seems to return null in some circumstances. A liberal reading of the - spec could be interpreted as allowing this, but it is probably a bad idea and could cause - other code to break. Return the empty string or some other appropriate string rather than null. -

- - -

Nm: Nom de classe devant commencer par une majuscule (NM_CLASS_NAMING_CONVENTION)

- - -

Les noms de classe doivent être en minuscules avec la première lettre de chaque mot en majuscules. Essayez de conserver vos noms de classes simples et explicites. Utilisez des mots entiers et évitez acronymes et abbréviations (à moins que l'abbréviation soit plus largement utilisée que la forme longue, comme "URL" ou "HTML").

- - -

Nm: Cette classe ne dérive pas d'Exception, même si son nom le sous-entend (NM_CLASS_NOT_EXCEPTION)

- - -

Cette classe n'est pas dérivée d'une autre Exception alors que son nom se termine par 'Exception'. Ceci risque de porter à confusion les utilisateurs de cette classe.

- - -

Nm: Noms de méthodes ambigus (NM_CONFUSING)

- - -

Les méthodes indiquées ont des noms qui ne diffèrent que par les majuscules.

- - -

Nm: Nom de champ devant commencer par une minuscule (NM_FIELD_NAMING_CONVENTION)

- - -

Les noms de champs qui ne sont pas finaux devraient être en minuscules avec la première lettre des mots, après le premier, en majuscule.

- - -

Nm: Use of identifier that is a keyword in later versions of Java (NM_FUTURE_KEYWORD_USED_AS_IDENTIFIER)

- - -

The identifier is a word that is reserved as a keyword in later versions of Java, and your code will need to be changed -in order to compile it in later versions of Java.

- - - -

Nm: Use of identifier that is a keyword in later versions of Java (NM_FUTURE_KEYWORD_USED_AS_MEMBER_IDENTIFIER)

- - -

This identifier is used as a keyword in later versions of Java. This code, and -any code that references this API, -will need to be changed in order to compile it in later versions of Java.

- - - -

Nm: Nom de méthode devant commencer par une minuscule (NM_METHOD_NAMING_CONVENTION)

- - -

Les noms de méthodes devraient être des verbes en minuscules, avec la première lettre des mots, après le premier, en majuscules.

- - -

Nm: Class names shouldn't shadow simple name of implemented interface (NM_SAME_SIMPLE_NAME_AS_INTERFACE)

- - -

This class/interface has a simple name that is identical to that of an implemented/extended interface, except -that the interface is in a different package (e.g., alpha.Foo extends beta.Foo). -This can be exceptionally confusing, create lots of situations in which you have to look at import statements -to resolve references and creates many -opportunities to accidentally define methods that do not override methods in their superclasses. -

- - -

Nm: Class names shouldn't shadow simple name of superclass (NM_SAME_SIMPLE_NAME_AS_SUPERCLASS)

- - -

This class has a simple name that is identical to that of its superclass, except -that its superclass is in a different package (e.g., alpha.Foo extends beta.Foo). -This can be exceptionally confusing, create lots of situations in which you have to look at import statements -to resolve references and creates many -opportunities to accidentally define methods that do not override methods in their superclasses. -

- - -

Nm: Very confusing method names (but perhaps intentional) (NM_VERY_CONFUSING_INTENTIONAL)

- - -

The referenced methods have names that differ only by capitalization. -This is very confusing because if the capitalization were -identical then one of the methods would override the other. From the existence of other methods, it -seems that the existence of both of these methods is intentional, but is sure is confusing. -You should try hard to eliminate one of them, unless you are forced to have both due to frozen APIs. -

- - -

Nm: Method doesn't override method in superclass due to wrong package for parameter (NM_WRONG_PACKAGE_INTENTIONAL)

- - -

The method in the subclass doesn't override a similar method in a superclass because the type of a parameter doesn't exactly match -the type of the corresponding parameter in the superclass. For example, if you have:

- -
-
-import alpha.Foo;
-public class A {
-  public int f(Foo x) { return 17; }
-}
-----
-import beta.Foo;
-public class B extends A {
-  public int f(Foo x) { return 42; }
-  public int f(alpha.Foo x) { return 27; }
-}
-
-
- -

The f(Foo) method defined in class B doesn't -override the -f(Foo) method defined in class A, because the argument -types are Foo's from different packages. -

- -

In this case, the subclass does define a method with a signature identical to the method in the superclass, -so this is presumably understood. However, such methods are exceptionally confusing. You should strongly consider -removing or deprecating the method with the similar but not identical signature. -

- - -

ODR: La méthode peut ne pas fermer une ressource base de données (ODR_OPEN_DATABASE_RESOURCE)

- - -

Cette méthode crée une ressource base de données (telle qu'une connexion ou un RowSet), ne l'affecte à aucun champ, ne la passe à aucune autre méthode, ne la renvoie pas, et ne semble pas la fermer dans tous les chemins d'exécution. Ne pas fermer une ressource base de données dans tous les chemins d'exécution peut entraîner de faibles performances et poser des problèmes de communication entre la base de données et l'application.

- - -

ODR: La méthode peut ne pas fermer une ressource base de données sur une exception (ODR_OPEN_DATABASE_RESOURCE_EXCEPTION_PATH)

- - -

Cette méthode crée une ressource base de données (telle qu'une connexion ou un RowSet), ne l'affecte à aucun champ, ne la passe à aucune autre méthode, ne la renvoie pas, et ne semble pas la fermer dans tous les chemins d'exception. Ne pas fermer une ressource base de données peut entraîner de faibles performances et poser des problèmes de communication entre la base de données et l'application.

- - -

OS: La méthode peut ne pas fermer un flux (OS_OPEN_STREAM)

- - -

La méthode crée un objet de flux d'E/S, ne l'assigne à aucun champ, ne le passe à aucune méthode, ne le renvoit pas et ne semble pas le fermer dans tous les chemins d'exécution. Ceci peut entraîner le blocage d'un descripteur de fichier. C'est généralement une bonne idée d'utiliser un bloc finally pour s'assurer de la fermeture des flux.

- - -

OS: La méthode peut oublier de fermer un flux en cas d'exception (OS_OPEN_STREAM_EXCEPTION_PATH)

- - -

La méthode crée un flux d'E/S, ne l'affecte à aucun champ, ne le passe à aucune méthode, ne le renvoit pas, et ne semble pas le fermer dans tous les chemins d'exception possibles. Ceci peut provoquer le blocage d'un descripteur de fichier. C'est généralement une bonne idée d'utiliser un bloc finally pour garantir la fermeture des flux.

- - -

PZ: Don't reuse entry objects in iterators (PZ_DONT_REUSE_ENTRY_OBJECTS_IN_ITERATORS)

- - -

The entrySet() method is allowed to return a view of the - underlying Map in which an Iterator and Map.Entry. This clever - idea was used in several Map implementations, but introduces the possibility - of nasty coding mistakes. If a map m returns - such an iterator for an entrySet, then - c.addAll(m.entrySet()) will go badly wrong. All of - the Map implementations in OpenJDK 1.7 have been rewritten to avoid this, - you should to. -

- - -

RC: Suspicious reference comparison to constant (RC_REF_COMPARISON_BAD_PRACTICE)

- - -

This method compares a reference value to a constant using the == or != operator, -where the correct way to compare instances of this type is generally -with the equals() method. -It is possible to create distinct instances that are equal but do not compare as == since -they are different objects. -Examples of classes which should generally -not be compared by reference are java.lang.Integer, java.lang.Float, etc.

- - -

RC: Suspicious reference comparison of Boolean values (RC_REF_COMPARISON_BAD_PRACTICE_BOOLEAN)

- - -

This method compares two Boolean values using the == or != operator. -Normally, there are only two Boolean values (Boolean.TRUE and Boolean.FALSE), -but it is possible to create other Boolean objects using the new Boolean(b) -constructor. It is best to avoid such objects, but if they do exist, -then checking Boolean objects for equality using == or != will give results -than are different than you would get using .equals(...). -

- - -

RR: La méthode ignore le résultat de InputStream.read() (RR_NOT_CHECKED)

- - -

Cette méthode ignore le code retour d'une des variantes de java.io.InputStream.read() qui peut renvoyer de multiples octets. Si la valeur renvoyée n'est pas vérifiée, l'appelant ne sera pas capable de gérer correctement le cas ou moins d'octets que prévu auront été lus. C'est un bogue particulièrement insidieux car dans la plupart des programmes les lectures renvoient effectivement souvent le nombre d'octets demandé, les plantages restant sporadiques.

- - -

RR: La méthode ignore le résultat de InputStream.skip() (SR_NOT_CHECKED)

- - -

Cette méthode ignore la valeur renvoyée par java.io.InputStream.skip(), qui peut sauter de multiples octets. Si la valeur renvoyée n'est pas vérifiée, l'appelant n'est pas capable de gérer correctement les cas ou moins d'octets que prévu auront été sautés. C'est un type de bogue particulièrement insidieux car la plupart du temps le bon nombre d'octet sera effectivement sauté, et les plantages seront sporadiques. Néanmoins, sur les flux bufferisés, skip() ne s'applique qu'aux données du buffer et échoue fréquemment à sauter le nombre d'octets demandé.

- - -

RV: Negating the result of compareTo()/compare() (RV_NEGATING_RESULT_OF_COMPARETO)

- - -

This code negatives the return value of a compareTo or compare method. -This is a questionable or bad programming practice, since if the return -value is Integer.MIN_VALUE, negating the return value won't -negate the sign of the result. You can achieve the same intended result -by reversing the order of the operands rather than by negating the results. -

- - -

RV: Method ignores exceptional return value (RV_RETURN_VALUE_IGNORED_BAD_PRACTICE)

- - -

This method returns a value that is not checked. The return value should be checked -since it can indicate an unusual or unexpected function execution. For -example, the File.delete() method returns false -if the file could not be successfully deleted (rather than -throwing an Exception). -If you don't check the result, you won't notice if the method invocation -signals unexpected behavior by returning an atypical return value. -

- - -

SI: Initialiseur statique de classe créant une instance avant que tous les champs static final soient alimentés (SI_INSTANCE_BEFORE_FINALS_ASSIGNED)

- - -

L'initialiseur static de la classe crée une instance de la classe avant que tous les champs static final soient alimentés.

- - -

SW: Certaines méthodes Swing ne doivent être invoquées qu'à partir du thread Swing (SW_SWING_METHODS_INVOKED_IN_SWING_THREAD)

- - -

(Conseil technique JDC) : les méthodes Swing show(), setVisible() et pack() créent les ressources associées à la fenêtre. En même temps que la création de ces ressources, le système crée le processus Swing de répartition de évènements.

-

Ceci pose problème car le processus de répartition des évènements peut notifier des écouteurs alors que pack() et validate() sont toujours en cours de traitement. Cette situation peut conduire à ce que deux processus essayent d'accèder en même temps au composant, ce qui est une faille sérieuse qui peut provoquer des interblocages et autres problèmes de synchronisation.

-

Un appel à pack() provoque l'initialisation du composant. Quand ils s'initialisent (sans être forcément visibles), les composants peuvent émettre des évènements vers le processus de répartition des évènements de Swing.

- - -

Se: Champ d'instance non transient et non sérialisable dans une classe sérialisable (SE_BAD_FIELD)

- - -

Cette classe Serializable définit un champ d'instance non primitif qui n'est ni transient, ni Serializable ou java.lang.Object, et qui ne semble pas implémenter l'interface Externalizable ou les méthodes readObject() et writeObject(). Les objets de cette classe ne seront pas désérialisés correctement si un objet non Serializable est stocké dans ce champ.

- - -

Se: Non-serializable class has a serializable inner class (SE_BAD_FIELD_INNER_CLASS)

- - -

This Serializable class is an inner class of a non-serializable class. -Thus, attempts to serialize it will also attempt to associate instance of the outer -class with which it is associated, leading to a runtime error. -

-

If possible, making the inner class a static inner class should solve the -problem. Making the outer class serializable might also work, but that would -mean serializing an instance of the inner class would always also serialize the instance -of the outer class, which it often not what you really want. - - -

Se: Valeur non sérialisable stockée dans un champ d'instance de classe sérialisable (SE_BAD_FIELD_STORE)

- - -

Une valeur non sérialisable est stockée dans un champ non transient d'une classe sérialisable.

- - -

Se: Comparateur n'implémentant pas Serializable (SE_COMPARATOR_SHOULD_BE_SERIALIZABLE)

- - -

Cette classe implémente l'interface Comparator. Vous devriez vérifier si elle doit ou pas également implémenter l'interface Serializable. Si un comparateur est utilisé pour construire une collection triée, telle que TreeMap, alors le TreeMap ne sera sérialisable uniquement si le compareteur l'est aussi. Puisque la plupart des comparateurs ont de petits voire aucun états, les rendre sérialisables est généralement une technique de programmation défensive simple et bénéfique.

- - -

Se: Serializable inner class (SE_INNER_CLASS)

- - -

This Serializable class is an inner class. Any attempt to serialize -it will also serialize the associated outer instance. The outer instance is serializable, -so this won't fail, but it might serialize a lot more data than intended. -If possible, making the inner class a static inner class (also known as a nested class) should solve the -problem. - - -

Se: serialVersionUID n'est pas final (SE_NONFINAL_SERIALVERSIONID)

- - -

Cette classe définit un champ serialVersionUID qui n'est pas final. Ce champ devrait être rendu final si son but est de préciser l'identifiant de version utilisé pour la sérialisation.

- - -

Se: serialVersionUID n'est pas de type long (SE_NONLONG_SERIALVERSIONID)

- - -

Cette classe définit un champ serialVersionUID qui n'est pas de type long. Ce champ devrait être de type long si son but est de préciser l'identifiant de version utilisé pour la sérialisation.

- - -

Se: serialVersionUID n'est pas static (SE_NONSTATIC_SERIALVERSIONID)

- - -

Cette classe définit un champ serialVersionUID qui n'est pas statique. Le champ devrait être rendu statique si son but est de préciser l'identifiant de version utilisé pour la sérialisation.

- - -

Se: La classe est Serializable mais sa super-classe ne possède pas de constructeur par défaut visible (SE_NO_SUITABLE_CONSTRUCTOR)

- - -

Cette classe implémente l'interface Serializable mais pas sa super-classe. Quand un tel objet est désérialisé, les champs de la classe mère doivent être initialisés en invoquant le constructeur par défaut de la super-classe. Comme la super-classe n'en a pas, sérialisation et désérialisation échoueront à l'exécution.

- - -

Se: La classe est Externalizable mais ne définit pas de constructeur par défaut (SE_NO_SUITABLE_CONSTRUCTOR_FOR_EXTERNALIZATION)

- - -

Cette classe implémente l'interface Externalizable, mais ne définit pas de constructeur par défaut. Quand les objets Externalizable sont déserialisés, ils doivent d'abord être construit au moyen du constructeur par défaut. Cette classe n'en ayant pas, sérialisation et désérialisation échoueront à l'exécution.

- - -

Se: La méthode readResolve doit retourner un Object (SE_READ_RESOLVE_MUST_RETURN_OBJECT)

- - -

Pour que la méthode readResolve soit prise en compte pas le mécanisme de sérialisation, elle doit avoir Object comme type de retour.

- - -

Se: Champ "transient" non positionné lors de la désérialisation (SE_TRANSIENT_FIELD_NOT_RESTORED)

- - -

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 transient et n'étant pas alimenté par les méthodes readObject et readResolve, il contiendra la valeur par défaut dans toutes les instances désérialisées de la classe.

- - -

SnVI: La classe est Serializable, mais ne définit pas serialVersionUID (SE_NO_SERIALVERSIONID)

- - -

Cette classe implémente l'interface Serializable mais ne définit pas de champ serialVersionUID. Une modification aussi simple qu'ajouter une référence vers un objet .class ajoutera des champs synthétiques à la classe, ce qui malheureusement changera la valeur implicite de serialVersionUID (Ex. : ajouter une référence à String.class générera un champ statique class$java$lang$String). De plus, différents compilateurs source vers bytecode peuvent utiliser différentes conventions de nommage pour les variables synthétiques générées pour référencer les objets classes et les classes internes. Afin de garantir l'interopérabilité de Serializable suivant les versions, pensez à ajouter un champ serialVersionUID explicite.

- - -

UI: L'utilisation de GetResource peut-être instable si la classe est étendue (UI_INHERITANCE_UNSAFE_GETRESOURCE)

- - -

Appeler this.getClass().getResource(...) peut rendre des résultats différents de ceux attendus si la classe est étendue par une classe d'un autre paquetage.

- - -

BC: Transtypage impossible (BC_IMPOSSIBLE_CAST)

- - -

Ce trantypage lancera toujours une exception ClassCastException.

- - -

BC: Impossible downcast (BC_IMPOSSIBLE_DOWNCAST)

- - -

-This cast will always throw a ClassCastException. -The analysis believes it knows -the precise type of the value being cast, and the attempt to -downcast it to a subtype will always fail by throwing a ClassCastException. -

- - -

BC: Impossible downcast of toArray() result (BC_IMPOSSIBLE_DOWNCAST_OF_TOARRAY)

- - -

-This code is casting the result of calling toArray() on a collection -to a type more specific than Object[], as in:

-
-String[] getAsArray(Collection<String> c) {
-  return (String[]) c.toArray();
-  }
-
-

This will usually fail by throwing a ClassCastException. The toArray() -of almost all collections return an Object[]. They can't really do anything else, -since the Collection object has no reference to the declared generic type of the collection. -

The correct way to do get an array of a specific type from a collection is to use - c.toArray(new String[]); - or c.toArray(new String[c.size()]); (the latter is slightly more efficient). -

There is one common/known exception to this. The toArray() -method of lists returned by Arrays.asList(...) will return a covariantly -typed array. For example, Arrays.asArray(new String[] { "a" }).toArray() -will return a String []. FindBugs attempts to detect and suppress -such cases, but may miss some. -

- - -

BC: instanceof renverra toujours faux (BC_IMPOSSIBLE_INSTANCEOF)

- - -

Ce test instanceof renverra toujours faux. Même s'il est sûr, assurez-vous qu'il ne s'agisse pas d'une erreur logique ou d'une mauvaise compréhension.

- - -

BIT: Bitwise add of signed byte value (BIT_ADD_OF_SIGNED_BYTE)

- - -

Adds a byte value and a value which is known to have the 8 lower bits clear. -Values loaded from a byte array are sign extended to 32 bits -before any bitwise operations are performed on the value. -Thus, if b[0] contains the value 0xff, and -x is initially 0, then the code -((x << 8) + b[0]) will sign extend 0xff -to get 0xffffffff, and thus give the value -0xffffffff as the result. -

- -

In particular, the following code for packing a byte array into an int is badly wrong:

-
-int result = 0;
-for(int i = 0; i < 4; i++)
-  result = ((result << 8) + b[i]);
-
- -

The following idiom will work instead:

-
-int result = 0;
-for(int i = 0; i < 4; i++)
-  result = ((result << 8) + (b[i] & 0xff));
-
- - - -

BIT: Masques binaires incompatibles (BIT_AND)

- - -

Cette méthode compare une expression de la forme (a & C) avec D, qui est toujours inégale en raison des valeurs spécifiques des constantes C et D. Cela peut indiquer une faute de frappe ou une erreur logique.

- - -

BIT: Masques binaires incompatibles (BIT_AND_ZZ)

- - -

Cette méthode compare une expression de la forme (a & 0) avec 0, qui est toujours égale. Ceci peut indiquer une faute de frappe ou une erreur logique.

- - -

BIT: Masques binaires incompatibles (BIT_IOR)

- - -

Cette méthode compare une expression de la forme (a | 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.

-

Typiquement, ce bogue arrive quand du code essaye d'effectuer un test d'apparition d'un bit mais utilise l'opérateur OU ("|") au lieu de l'opérateur ET ("&").

- - -

BIT: Ou binaire d'un octet signé (BIT_IOR_OF_SIGNED_BYTE)

- - -

Charge une valeur à partir d'un tableau d'octets et effectue un ou binaire sur cette valeur. Les valeurs venant d'un tableau d'octet sont signées et risquent donc de ne pas se comporter comme prévue.

- - -

BIT: Check for sign of bitwise operation involving negative number (BIT_SIGNED_CHECK_HIGH_BIT)

- - -

This method compares a bitwise expression such as -((val & CONSTANT) > 0) where CONSTANT is the negative number. -Using bit arithmetic and then comparing with the greater than operator can -lead to unexpected results. This comparison is unlikely to work as expected. The good practice is -to use '!= 0' instead of '> 0'. -

- - -

BOA: La classe surcharge mal une méthode implémentée dans une superclasse Adapter (BOA_BADLY_OVERRIDDEN_ADAPTER)

- - -

Cette méthode surcharge une méthode provenant d'une classe mère qui est un Adapter qui implémente un Listener défini dans le paquetage java.awt.event ou javax.swing.event. En conséquence, cette méthode ne sera pas appelée quand l'évènement se produira.

- - -

BSHIFT: Possible bad parsing of shift operation (BSHIFT_WRONG_ADD_PRIORITY)

- - -

-The code performs an operation like (x << 8 + y). Although this might be correct, probably it was meant -to perform (x << 8) + y, but shift operation has -a lower precedence, so it's actually parsed as x << (8 + y). -

- - -

BSHIFT: Décalage d'un int hors de proportion (0..31) (ICAST_BAD_SHIFT_AMOUNT)

- - -

Un décalage de n bits est effectué avec n hors des limites (0..31). Ceci résulte en l'utilisation des 5 bits inférieurs de l'entier pour décider de la valeur du décalage. Ce n'est sans doute pas l'effet recherché et est pour le moins source de confusion.

- - -

DLS: Useless increment in return statement (DLS_DEAD_LOCAL_INCREMENT_IN_RETURN)

- - -

This statement has a return such as return x++;. -A postfix increment/decrement does not impact the value of the expression, -so this increment/decrement has no effect. -Please verify that this statement does the right thing. -

- - -

DLS: Dead store of class literal (DLS_DEAD_STORE_OF_CLASS_LITERAL)

- - -

-This instruction assigns a class literal to a variable and then never uses it. -The behavior of this differs in Java 1.4 and in Java 5. -In Java 1.4 and earlier, a reference to Foo.class would force the static initializer -for Foo to be executed, if it has not been executed already. -In Java 5 and later, it does not. -

-

See Sun's article on Java SE compatibility -for more details and examples, and suggestions on how to force class initialization in Java 5. -

- - -

DLS: Incrémentation annulée (DLS_OVERWRITTEN_INCREMENT)

- - -

Ce code incrémente une valeur (ex., i++) et en annule immédiatement l'effet. Par exemple, i = i++ réécrit de façon immédiate la valeur incrémentée avec la valeur originale.

- - -

DMI: Reversed method arguments (DMI_ARGUMENTS_WRONG_ORDER)

- - -

The arguments to this method call seem to be in the wrong order. -For example, a call Preconditions.checkNotNull("message", message) -has reserved arguments: the value to be checked is the first argument. -

- - -

DMI: Valeur constante pour un mois en dehors de l'intervalle attendu de 0 à 11 (DMI_BAD_MONTH)

- - -

Ce code passe une constante mois en dehors de l'intervalle de 0 à 11.

- - -

DMI: BigDecimal constructed from double that isn't represented precisely (DMI_BIGDECIMAL_CONSTRUCTED_FROM_DOUBLE)

- - -

-This code creates a BigDecimal from a double value that doesn't translate well to a -decimal number. -For example, one might assume that writing new BigDecimal(0.1) in Java creates a BigDecimal which is exactly equal to 0.1 (an unscaled value of 1, with a scale of 1), but it is actually equal to 0.1000000000000000055511151231257827021181583404541015625. -You probably want to use the BigDecimal.valueOf(double d) method, which uses the String representation -of the double to create the BigDecimal (e.g., BigDecimal.valueOf(0.1) gives 0.1). -

- - - -

DMI: Méthode hasNext() appelant next() (DMI_CALLING_NEXT_FROM_HASNEXT)

- - -

La méthode hasNext() appelle la méthode next(). C'est très probablement faux puisque la méthode hasNext() n'est pas changer l'état de l'itérateur tandis que la méthode next() doit changer cet état.

- - -

DMI: Collections should not contain themselves (DMI_COLLECTIONS_SHOULD_NOT_CONTAIN_THEMSELVES)

- - -

This call to a generic collection's method would only make sense if a collection contained -itself (e.g., if s.contains(s) were true). This is unlikely to be true and would cause -problems if it were true (such as the computation of the hash code resulting in infinite recursion). -It is likely that the wrong value is being passed as a parameter. -

- - -

DMI: D'oh! A nonsensical method invocation (DMI_DOH)

- - -

-This partical method invocation doesn't make sense, for reasons that should be apparent from inspection. -

- - - -

DMI: Invocation of hashCode on an array (DMI_INVOKING_HASHCODE_ON_ARRAY)

- - -

-The code invokes hashCode on an array. Calling hashCode on -an array returns the same value as System.identityHashCode, and ignores -the contents and length of the array. If you need a hashCode that -depends on the contents of an array a, -use java.util.Arrays.hashCode(a). - -

- - -

DMI: Double.longBitsToDouble invoked on an int (DMI_LONG_BITS_TO_DOUBLE_INVOKED_ON_INT)

- - -

The Double.longBitsToDouble method is invoked, but a 32 bit int value is passed - as an argument. This almost certainly is not intended and is unlikely - to give the intended result. -

- - -

DMI: Vacuous call to collections (DMI_VACUOUS_SELF_COLLECTION_CALL)

- - -

This call doesn't make sense. For any collection c, calling c.containsAll(c) should -always be true, and c.retainAll(c) should have no effect. -

- - -

Dm: La réflexion ne peut pas être utilisée pour vérifier la présence d'une annotation avec la rétention par défaut (DMI_ANNOTATION_IS_NOT_VISIBLE_TO_REFLECTION)

- - -

A moins qu'une annotation ait elle même été annotée avec une @Retention différente de la rétention "source uniquement" par défaut, l'annotation n'est pas conservée dans le fichier .class et ne peut pas être utilisée par réflexion (par exemple avec la méthode isAnnotationPresent()).

- - -

Dm: Futile attempt to change max pool size of ScheduledThreadPoolExecutor (DMI_FUTILE_ATTEMPT_TO_CHANGE_MAXPOOL_SIZE_OF_SCHEDULED_THREAD_POOL_EXECUTOR)

- - -

(Javadoc) -While ScheduledThreadPoolExecutor inherits from ThreadPoolExecutor, a few of the inherited tuning methods are not useful for it. In particular, because it acts as a fixed-sized pool using corePoolSize threads and an unbounded queue, adjustments to maximumPoolSize have no useful effect. -

- - - -

Dm: Creation of ScheduledThreadPoolExecutor with zero core threads (DMI_SCHEDULED_THREAD_POOL_EXECUTOR_WITH_ZERO_CORE_THREADS)

- - -

(Javadoc) -A ScheduledThreadPoolExecutor with zero core threads will never execute anything; changes to the max pool size are ignored. -

- - - -

Dm: Useless/vacuous call to EasyMock method (DMI_VACUOUS_CALL_TO_EASYMOCK_METHOD)

- - -

This call doesn't pass any objects to the EasyMock method, so the call doesn't do anything. -

- - - -

Dm: Incorrect combination of Math.max and Math.min (DM_INVALID_MIN_MAX)

- - -

This code tries to limit the value bounds using the construct like Math.min(0, Math.max(100, value)). However the order of - the constants is incorrect: it should be Math.min(100, Math.max(0, value)). As the result this code always produces the same result - (or NaN if the value is NaN).

- - -

EC: Utilisation de equals() pour comparer un tableau et un objet (EC_ARRAY_AND_NONARRAY)

- - -

Cette méthode appelle equals(Object o) 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 equals() détermine seulement si les deux tableaux sont le même objet. Pour comparer le contenu de deux tableaux, utilisez java.util.Arrays.equals(Object[], Object[]).

- - -

EC: Appel à equals() sur un tableau équivalent à == (EC_BAD_ARRAY_COMPARE)

- - -

Cette méthode invoque la méthode equals(Object o) d'un tableau. Comme les tableaux ne surchargent pas la méthode equals() de Object, cet appel revient à comparer les adresses. Pour comparer les contenus de tableaux, utilisez java.util.Arrays.equals(Object[], Object[]).

- - -

EC: equals(...) used to compare incompatible arrays (EC_INCOMPATIBLE_ARRAY_COMPARE)

- - -

-This method invokes the .equals(Object o) to compare two arrays, but the arrays of -of incompatible types (e.g., String[] and StringBuffer[], or String[] and int[]). -They will never be equal. In addition, when equals(...) is used to compare arrays it -only checks to see if they are the same array, and ignores the contents of the arrays. -

- - -

EC: Appel de equals() avec un argument à null (EC_NULL_ARG)

- - -

Cette méthode appelle equals(Object), passant une valeur à null comme argument. D'après le contrat de la méthode equals(), cet appel devrait systématiquement renvoyer false.

- - -

EC: Appel de equals() comparant une classe et une interface sans relation (EC_UNRELATED_CLASS_AND_INTERFACE)

- - -

Cette méthode appelle equals(Object) sur deux références, l'une de classe, l'autre d'interface, alors que ni la classe, ni aucune de ses sous classes abstraites n'implémente l'interface. Les objets comparés ne font donc probablement pas partie de la même hiérarchie de classe à l'exécution (à moins que certaines classes de l'application n'est pas été analysées ou soient chargées dynamiquement à l'exécution). En accord avec le contrat de equals(), des objets de classes différentes doivent toujours être non égaux, donc le résultat de cette comparaison par java.lang.Object.equals(Object) renverra systèmatiquement false à l'exécution.

- - -

EC: Appel de equals() comparant différentes interfaces (EC_UNRELATED_INTERFACES)

- - -

Cette méthode appelle equals(Object) pour deux références d'interfaces sans rapport, aucune n'étant un sous-type de l'autre et aucune classe non abstraite implémentant les deux interfaces. Les objets comparés ne sont donc probablement pas de la même classe à l'éxécution (au moins que certaines classes de l'application n'aient pas été analysées ou qu'il y ait des chargements dynamiques). D'après le contrat de equals(), les objets de classes différentes devraient toujours être inégaux.

- - -

EC: Appel de equals() comparant des types différents (EC_UNRELATED_TYPES)

- - -

Cette méthode appelle equals(Object) pour deux références de type différents, sans sous-classe commune. Les objets comparés ne sont donc probablement pas de la même classe à l'éxécution (au moins que certaines classes de l'application n'aient pas été analysées ou qu'il y ait des chargements dynamiques). D'après le contrat de equals(), les objets de classes différentes devraient toujours être inégaux, c'est pourquoi la comparaison a de fortes chances de toujours renvoyer false à l'exécution.

- - -

EC: Using pointer equality to compare different types (EC_UNRELATED_TYPES_USING_POINTER_EQUALITY)

- - -

This method uses using pointer equality to compare two references that seem to be of -different types. The result of this comparison will always be false at runtime. -

- - -

Eq: equals method always returns false (EQ_ALWAYS_FALSE)

- - -

This class defines an equals method that always returns false. This means that an object is not equal to itself, and it is impossible to create useful Maps or Sets of this class. More fundamentally, it means -that equals is not reflexive, one of the requirements of the equals method.

-

The likely intended semantics are object identity: that an object is equal to itself. This is the behavior inherited from class Object. If you need to override an equals inherited from a different -superclass, you can use use:

-
-public boolean equals(Object o) { return this == o; }
-
- - -

Eq: equals method always returns true (EQ_ALWAYS_TRUE)

- - -

This class defines an equals method that always returns true. This is imaginative, but not very smart. -Plus, it means that the equals method is not symmetric. -

- - -

Eq: equals method compares class names rather than class objects (EQ_COMPARING_CLASS_NAMES)

- - -

This method checks to see if two objects are the same class by checking to see if the names -of their classes are equal. You can have different classes with the same name if they are loaded by -different class loaders. Just check to see if the class objects are the same. -

- - -

Eq: Covariant equals() method defined for enum (EQ_DONT_DEFINE_EQUALS_FOR_ENUM)

- - -

This class defines an enumeration, and equality on enumerations are defined -using object identity. Defining a covariant equals method for an enumeration -value is exceptionally bad practice, since it would likely result -in having two different enumeration values that compare as equals using -the covariant enum method, and as not equal when compared normally. -Don't do it. -

- - -

Eq: equals() method defined that doesn't override equals(Object) (EQ_OTHER_NO_OBJECT)

- - -

This class defines an equals() - method, that doesn't override the normal equals(Object) method - defined in the base java.lang.Object class.  Instead, it - inherits an equals(Object) method from a superclass. - The class should probably define a boolean equals(Object) method. -

- - -

Eq: equals() method defined that doesn't override Object.equals(Object) (EQ_OTHER_USE_OBJECT)

- - -

This class defines an equals() - method, that doesn't override the normal equals(Object) method - defined in the base java.lang.Object class.  - The class should probably define a boolean equals(Object) method. -

- - -

Eq: equals method overrides equals in superclass and may not be symmetric (EQ_OVERRIDING_EQUALS_NOT_SYMMETRIC)

- - -

This class defines an equals method that overrides an equals method in a superclass. Both equals methods -methods use instanceof in the determination of whether two objects are equal. This is fraught with peril, -since it is important that the equals method is symmetrical (in other words, a.equals(b) == b.equals(a)). -If B is a subtype of A, and A's equals method checks that the argument is an instanceof A, and B's equals method -checks that the argument is an instanceof B, it is quite likely that the equivalence relation defined by these -methods is not symmetric. -

- - -

Eq: Définition d'une méthode equals() covariante, Object.equals(Object) est hérité (EQ_SELF_USE_OBJECT)

- - -

Cette classe définit une version covariante de la méthode equals(), mais appelle la méthode normale equals(Object) définie dans la classe de base java.lang.Object. La classe devrait probablement définir une version non covariante de equals(). (C'est-à-dire une méthode avec la signature boolean equals(java.lang.Object).

- - -

FE: Test d'égalité avec NaN erroné (FE_TEST_IF_EQUAL_TO_NOT_A_NUMBER)

- - -

Ce code vérifie si une valeur flottante est égale à la valeur spéciale "Not A Number" (Ex. : if (x == Double.NaN)). La sémantique de NaN fait que, par définition, aucune valeur n'est égale à Nan, y compris NaN. Donc x == Double.NaN renvoi systématiquement false.

-

Pour savoir si la valeur contenu dans x est la valeur particulière "Not A Number", utilisez Double.isNaN(x) (ou Float.isNaN(x) si x est en simple précision).

- - -

FS: Format string placeholder incompatible with passed argument (VA_FORMAT_STRING_BAD_ARGUMENT)

- - -

-The format string placeholder is incompatible with the corresponding -argument. For example, - - System.out.println("%d\n", "hello"); - -

The %d placeholder requires a numeric argument, but a string value is -passed instead. -A runtime exception will occur when -this statement is executed. -

- - -

FS: The type of a supplied argument doesn't match format specifier (VA_FORMAT_STRING_BAD_CONVERSION)

- - -

-One of the arguments is incompatible with the corresponding format string specifier. -As a result, this will generate a runtime exception when executed. -For example, String.format("%d", "1") will generate an exception, since -the String "1" is incompatible with the format specifier %d. -

- - -

FS: MessageFormat supplied where printf style format expected (VA_FORMAT_STRING_EXPECTED_MESSAGE_FORMAT_SUPPLIED)

- - -

-A method is called that expects a Java printf format string and a list of arguments. -However, the format string doesn't contain any format specifiers (e.g., %s) but -does contain message format elements (e.g., {0}). It is likely -that the code is supplying a MessageFormat string when a printf-style format string -is required. At runtime, all of the arguments will be ignored -and the format string will be returned exactly as provided without any formatting. -

- - -

FS: More arguments are passed than are actually used in the format string (VA_FORMAT_STRING_EXTRA_ARGUMENTS_PASSED)

- - -

-A format-string method with a variable number of arguments is called, -but more arguments are passed than are actually used by the format string. -This won't cause a runtime exception, but the code may be silently omitting -information that was intended to be included in the formatted string. -

- - -

FS: Illegal format string (VA_FORMAT_STRING_ILLEGAL)

- - -

-The format string is syntactically invalid, -and a runtime exception will occur when -this statement is executed. -

- - -

FS: Format string references missing argument (VA_FORMAT_STRING_MISSING_ARGUMENT)

- - -

-Not enough arguments are passed to satisfy a placeholder in the format string. -A runtime exception will occur when -this statement is executed. -

- - -

FS: No previous argument for format string (VA_FORMAT_STRING_NO_PREVIOUS_ARGUMENT)

- - -

-The format string specifies a relative index to request that the argument for the previous format specifier -be reused. However, there is no previous argument. -For example, -

-

formatter.format("%<s %s", "a", "b") -

-

would throw a MissingFormatArgumentException when executed. -

- - -

GC: No relationship between generic parameter and method argument (GC_UNRELATED_TYPES)

- - -

This call to a generic collection method contains an argument - with an incompatible class from that of the collection's parameter - (i.e., the type of the argument is neither a supertype nor a subtype - of the corresponding generic type argument). - Therefore, it is unlikely that the collection contains any objects - that are equal to the method argument used here. - Most likely, the wrong value is being passed to the method.

-

In general, instances of two unrelated classes are not equal. - For example, if the Foo and Bar classes - are not related by subtyping, then an instance of Foo - should not be equal to an instance of Bar. - Among other issues, doing so will likely result in an equals method - that is not symmetrical. For example, if you define the Foo class - so that a Foo can be equal to a String, - your equals method isn't symmetrical since a String can only be equal - to a String. -

-

In rare cases, people do define nonsymmetrical equals methods and still manage to make - their code work. Although none of the APIs document or guarantee it, it is typically - the case that if you check if a Collection<String> contains - a Foo, the equals method of argument (e.g., the equals method of the - Foo class) used to perform the equality checks. -

- - -

HE: Signature declares use of unhashable class in hashed construct (HE_SIGNATURE_DECLARES_HASHING_OF_UNHASHABLE_CLASS)

- - -

A method, field or class declares a generic signature where a non-hashable class -is used in context where a hashable class is required. -A class that declares an equals method but inherits a hashCode() method -from Object is unhashable, since it doesn't fulfill the requirement that -equal objects have equal hashCodes. -

- - -

HE: Use of class without a hashCode() method in a hashed data structure (HE_USE_OF_UNHASHABLE_CLASS)

- - -

A class defines an equals(Object) method but not a hashCode() method, -and thus doesn't fulfill the requirement that equal objects have equal hashCodes. -An instance of this class is used in a hash data structure, making the need to -fix this problem of highest importance. - - -

ICAST: int value converted to long and used as absolute time (ICAST_INT_2_LONG_AS_INSTANT)

- - -

-This code converts a 32-bit int value to a 64-bit long value, and then -passes that value for a method parameter that requires an absolute time value. -An absolute time value is the number -of milliseconds since the standard base time known as "the epoch", namely January 1, 1970, 00:00:00 GMT. -For example, the following method, intended to convert seconds since the epoch into a Date, is badly -broken:

-
-Date getDate(int seconds) { return new Date(seconds * 1000); }
-
-

The multiplication is done using 32-bit arithmetic, and then converted to a 64-bit value. -When a 32-bit value is converted to 64-bits and used to express an absolute time -value, only dates in December 1969 and January 1970 can be represented.

- -

Correct implementations for the above method are:

- -
-// Fails for dates after 2037
-Date getDate(int seconds) { return new Date(seconds * 1000L); }
-
-// better, works for all dates
-Date getDate(long seconds) { return new Date(seconds * 1000); }
-
- - -

ICAST: Valeur entière transtypée en nombre flottant passée à Math.ceil (ICAST_INT_CAST_TO_DOUBLE_PASSED_TO_CEIL)

- - -

Ce code convertit une valeur entière en nombre flottant à double précision et passe le résultat à la méthode Math.ceil(), qui arrondit un nombre flottant à sa valeur entière immédiatement supérieure. Cette opération n'a pas de raison d'être, puisque le transtypage d'un entier en double donne un nombre sans valeur après la virgule. Il est vraissemblable que l'opération qui a créé la valeur pour la passer à Math.ceil visait l'utilisation de l'arithmétique sur un nombre flottant en double précision.

- - -

ICAST: Valeur entière transtypée en flottant puis transmise à Math.round (ICAST_INT_CAST_TO_FLOAT_PASSED_TO_ROUND)

- - -

Ce code converti une valeur entière en flottant simple précision puis la passe à la méthode Math.round() qui renvoi l'int ou le long le plus proche de son paramètre. Cette opération doit toujours revenir à ne rien faire, puisque le transtypage d'un entier en un flottant devrait systématiquement donner un flottant sans partie décimale. Il est probable que l'opération gérant la valeur passée à Math.round() devrait être effectuée en arithmétique flottante.

- - -

IJU: JUnit assertion in run method will not be noticed by JUnit (IJU_ASSERT_METHOD_INVOKED_FROM_RUN_METHOD)

- - -

A JUnit assertion is performed in a run method. Failed JUnit assertions -just result in exceptions being thrown. -Thus, if this exception occurs in a thread other than the thread that invokes -the test method, the exception will terminate the thread but not result -in the test failing. -

- - -

IJU: TestCase declares a bad suite method (IJU_BAD_SUITE_METHOD)

- - -

Class is a JUnit TestCase and defines a suite() method. -However, the suite method needs to be declared as either

-
public static junit.framework.Test suite()
-or -
public static junit.framework.TestSuite suite()
- - -

IJU: TestCase sans tests (IJU_NO_TESTS)

- - -

La classe JUnit TestCase n'implémente aucune méthode de test.

- - -

IJU: Une classe dérivant de TestCase implémente setUp() sans appeler super.setUp() (IJU_SETUP_NO_SUPER)

- - -

La classe dérive de la classe TestCase de JUnit est implémente la méthode setUp(). La méthode setUp() devrait appeler super.setUp(), mais ne le fait pas.

- - -

IJU: Une classe dérivant de TestCase implémente une méthode suite() non statique (IJU_SUITE_NOT_STATIC)

- - -

La classe dérive de TestCase de JUnit et implémente une méthode suite(). La méthode suite() devrait-être déclarée comme étant static, ce qui n'est pas fait.

- - -

IJU: Une classe dérivant de TestCase implémente tearDown() sans appeler super.tearDown() (IJU_TEARDOWN_NO_SUPER)

- - -

La classe dérive de la classe TestCase de JUnit et implémente la méthode tearDown(). La méthode tearDown() devrait appeler super.tearDown(), mais ne le fait pas.

- - -

IL: Un conteneur est ajouté à lui-même (IL_CONTAINER_ADDED_TO_ITSELF)

- - -

Un conteneur est ajouté à lui-même. Il en résulte que le calcul du code de hachage de cet ensemble provequera une StackOverflowEception.

- - -

IL: Boucle apparemment inifinie (IL_INFINITE_LOOP)

- - -

Cette boucle ne semble pas avoir un moyen de se terminer (autrement que, peut être, en déclenchant une exception).

- - -

IL: Boucle récursive infinie (IL_INFINITE_RECURSIVE_LOOP)

- - -

Cette méthode s'appelle elle-même sans condition. Cela semble indiquer une boucle récursive infinie qui se terminera sur un débordement de la pile.

- - -

IM: Multiplication d'un entier avec le résulat entier d'un modulo (IM_MULTIPLYING_RESULT_OF_IREM)

- - -

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, i % 60 * 1000 correspond à (i % 60) * 1000, non à i % (60 * 1000).

- - -

INT: Bad comparison of int value with long constant (INT_BAD_COMPARISON_WITH_INT_VALUE)

- - -

This code compares an int value with a long constant that is outside -the range of values that can be represented as an int value. -This comparison is vacuous and possibly to be incorrect. -

- - -

INT: Bad comparison of nonnegative value with negative constant or zero (INT_BAD_COMPARISON_WITH_NONNEGATIVE_VALUE)

- - -

This code compares a value that is guaranteed to be non-negative with a negative constant or zero. -

- - -

INT: Bad comparison of signed byte (INT_BAD_COMPARISON_WITH_SIGNED_BYTE)

- - -

Signed bytes can only have a value in the range -128 to 127. Comparing -a signed byte with a value outside that range is vacuous and likely to be incorrect. -To convert a signed byte b to an unsigned value in the range 0..255, -use 0xff & b. -

- - -

IO: Doomed attempt to append to an object output stream (IO_APPENDING_TO_OBJECT_OUTPUT_STREAM)

- - -

- This code opens a file in append mode and then wraps the result in an object output stream. - This won't allow you to append to an existing object output stream stored in a file. If you want to be - able to append to an object output stream, you need to keep the object output stream open. -

-

The only situation in which opening a file in append mode and the writing an object output stream - could work is if on reading the file you plan to open it in random access mode and seek to the byte offset - where the append started. -

- -

- TODO: example. -

- - -

IP: Un paramètre est ré-écrit avant d'être utilisé (IP_PARAMETER_IS_DEAD_BUT_OVERWRITTEN)

- - -

La valeur initiale de ce paramètre est ignorée, et le paramètre est écrasé. Ceci indique généralement une erreur provenant de la croyance infondée qu'une écriture sur ce paramètre sera transmise à l'appelant.

- - -

MF: La classe définit un champ qui masque un champ d'une classe mère (MF_CLASS_MASKS_FIELD)

- - -

Cette classe définit un champ avec le même nom qu'un champ visible d'instance d'une classe mère. C'est ambigu et peut entraîner une erreur si des méthodes mettent à jour ou accèdent à un des champs alors qu'elles souhaitaient utiliser l'autre.

- - -

MF: La méthode définit une variable qui masque un champ (MF_METHOD_MASKS_FIELD)

- - -

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.

- - -

NP: Déréférencement d'un pointeur null dans la méthode (NP_ALWAYS_NULL)

- - -

Un pointeur à null est déréférencé ici. Ceci va mener à une NullPointerException quand le code sera exécuté.

- - -

NP: Déréférencement d'un pointeur null dans le chemin d'exception d'une méthode (NP_ALWAYS_NULL_EXCEPTION)

- - -

Un pointeur à null dans le chemin d'exception est déréférencé ici. Cela va mener à une NullPointerException quand le code sera exécuté. Notez que puisque FindBugs ne détecte pas les chemins d'exception irréalisables, il est possible que cette alarme soit injustifiée.

-

Notez aussi que FindBugs considère le choix par défaut d'un switch comme étant dans le chemin d'exception, puisque ce choix est souvent irréalisable.

- - -

NP: Méthode ne testant pas les paramètres à null (NP_ARGUMENT_MIGHT_BE_NULL)

- - -

Un paramètre de cette méthode a été identifié comme une valeur pouvant être à null, mais qui est déréférencée sans test de nullité.

- - -

NP: close() invoked on a value that is always null (NP_CLOSING_NULL)

- - -

close() is being invoked on a value that is always null. If this statement is executed, -a null pointer exception will occur. But the big risk here you never close -something that should be closed. - - -

NP: Null déréférencé (NP_GUARANTEED_DEREF)

- - -

Cette méthode contient une valeur à null qui est déréférencée (sauf dans les chemins impliquant une RuntimeException).

- - -

NP: Value is null and guaranteed to be dereferenced on exception path (NP_GUARANTEED_DEREF_ON_EXCEPTION_PATH)

- - -

- There is a statement or branch on an exception path - that if executed guarantees that - a value is null at this point, and that - value that is guaranteed to be dereferenced - (except on forward paths involving runtime exceptions). -

- - -

NP: Non-null field is not initialized (NP_NONNULL_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR)

- - -

The field is marked as non-null, but isn't written to by the constructor. - The field might be initialized elsewhere during constructor, or might always - be initialized before use. -

- - -

NP: Appel de méthode transmettant null à un paramètre déclaré @NonNull (NP_NONNULL_PARAM_VIOLATION)

- - -

Cette méthode passe une valeur à null en paramètre d'une méthode qui a déclaré ce paramètre comme @NonNull.

-

Notez que la méthode avec l'annotation @NonNull peut être dans une sous-classe de l'objet appelé.

- - -

NP: Méthode renvoyer null mais déclarée @NonNull (NP_NONNULL_RETURN_VIOLATION)

- - -

Cette méthode peut renvoyer une valeur à null alors que cette méthode (ou une méthode dérivée d'une de ses classes mère) est déclarée comme renvoyant @NonNull.

- - -

NP: A known null value is checked to see if it is an instance of a type (NP_NULL_INSTANCEOF)

- - -

-This instanceof test will always return false, since the value being checked is guaranteed to be null. -Although this is safe, make sure it isn't -an indication of some misunderstanding or some other logic error. -

- - -

NP: Possible déréférencement d'un pointeur null dans une méthode (NP_NULL_ON_SOME_PATH)

- - -

Une valeur par référence déréférencée ici peut-être à null à l'exécution. Cela peut conduire à une NullPointerException quand le code est exécuté.

- - -

NP: Possible déréférencement d'un pointeur null dans le chemin d'exception d'une méthode (NP_NULL_ON_SOME_PATH_EXCEPTION)

- - -

Une valeur par référence qui est à null dans un des chemins d'exception est déréférencée ici. Ceci peut conduire à une NullPointerException à l'exécution du code. Notez que comme FindBugs ne repère pas les chemins d'exception irréalisables, il est possible que cette alarme soit injustifiée.

-

Notez également que FindBugs considère le cas par défaut d'un switch comme faisant partie du chemin d'exception puisque ce cas est souvent inattendu.

- - -

NP: Méthode passant null à un paramètre déréférencé inconditionnellement (NP_NULL_PARAM_DEREF)

- - -

Cet appel de méthode envoie null à une méthode qui peut déréférencer ce paramètre de façon inconditionnelle.

- - -

NP: Appel de méthode passant null à un paramètre déréférencé inconditionnellement (NP_NULL_PARAM_DEREF_ALL_TARGETS_DANGEROUS)

- - -

Une valeur pouvant être à null est passée lors d'un appel alors que toutes les méthodes cibles possibles le déréférence inconditionnellement. Cela a de fortes chances de provoquer une NullPointerException.

- - -

NP: Appel à une méthode non virtuelle passant null à un paramètre déréférencé de façon inconditionnelle (NP_NULL_PARAM_DEREF_NONVIRTUAL)

- - -

Une valeur pouvant être à null est passée à une méthode qui déréférence ce paramètre de façon inconditionnelle. Cela peut se terminer en NullPointerException.

- - -

NP: Method with Optional return type returns explicit null (NP_OPTIONAL_RETURN_NULL)

- - -

- The usage of Optional return type (java.util.Optional or com.google.common.base.Optional) - always means that explicit null returns were not desired by design. - Returning a null value in such case is a contract violation and will most likely break client code. -

- - -

NP: Stocke une valeur null dans un champ annoté NonNull (NP_STORE_INTO_NONNULL_FIELD)

- - -

Une valeur qui pourrait être à null est stockée dans un champ qui a été annoté comme NonNull.

- - -

NP: Lecture d'un champ jamais écrit (NP_UNWRITTEN_FIELD)

- - -

Le programme déréférence un champ qui ne semble jamais alimenté par une valeur non nulle. Déréférencer cette valeur provoquera une NullPointerException.

- - -

Nm: La classe définit equal() ; ne devrait-ce pas être equals() ? (NM_BAD_EQUAL)

- - -

Cette classe définit une méthode equal(Object). Cette méthode ne surcharge pas la méthode equals(Object) de java.lang.Object, surchage qui était pourtant sans doute le but visé.

- - -

Nm: La classe définit hashcode() ; ne devrait-ce pas être hashCode() ? (NM_LCASE_HASHCODE)

- - -

Cette classe définit une méthode nommée hashcode(). Cette méthode ne surcharge pas la méthode hashCode() de java.lang.Object, surchage qui était pourtant sans doute le but visé.

- - -

Nm: La classe définit tostring() ; ne devrait-ce pas être toString() ? (NM_LCASE_TOSTRING)

- - -

Cette classe définit une méthode appelée tostring(). Cette méthode ne surcharge pas la méthode toString() de java.lang.Object, surchage qui était pourtant sans doute le but visé.

- - -

Nm: Confusion apparente entre une méthode et un constructeur (NM_METHOD_CONSTRUCTOR_CONFUSION)

- - -

Cette méthode a le même nom que la classe dans laquelle elle est déclarée. Il est probable qu'elle devait être un constructeur. -Si c'est bien le cas, retirez la déclaration d'une valeur de retour.

- - -

Nm: Noms de méthodes très ambigus (NM_VERY_CONFUSING)

- - -

Les méthodes indiquées ont des noms qui ne diffèrent que par les majuscules. C'est d'autant plus ambigu que les classes comportant ces méthodes sont liées par héritage.

- - -

Nm: Method doesn't override method in superclass due to wrong package for parameter (NM_WRONG_PACKAGE)

- - -

The method in the subclass doesn't override a similar method in a superclass because the type of a parameter doesn't exactly match -the type of the corresponding parameter in the superclass. For example, if you have:

- -
-
-import alpha.Foo;
-public class A {
-  public int f(Foo x) { return 17; }
-}
-----
-import beta.Foo;
-public class B extends A {
-  public int f(Foo x) { return 42; }
-}
-
-
- -

The f(Foo) method defined in class B doesn't -override the -f(Foo) method defined in class A, because the argument -types are Foo's from different packages. -

- - -

QBA: Méthode assignant une valeur boléenne fixe dans une expression booléenne (QBA_QUESTIONABLE_BOOLEAN_ASSIGNMENT)

- - -

Cette méthode assigne une valeur booléenne fixe (true ou false) à une variable booléenne dans une expression if ou while. Il est probable que le but était d'effectuer une comparaison booléenne utilisant == et non pas une affectation avec =.

- - -

RANGE: Array index is out of bounds (RANGE_ARRAY_INDEX)

- - -

Array operation is performed, but array index is out of bounds, which will result in ArrayIndexOutOfBoundsException at runtime.

- - -

RANGE: Array length is out of bounds (RANGE_ARRAY_LENGTH)

- - -

Method is called with array parameter and length parameter, but the length is out of bounds. This will result in IndexOutOfBoundsException at runtime.

- - -

RANGE: Array offset is out of bounds (RANGE_ARRAY_OFFSET)

- - -

Method is called with array parameter and offset parameter, but the offset is out of bounds. This will result in IndexOutOfBoundsException at runtime.

- - -

RANGE: String index is out of bounds (RANGE_STRING_INDEX)

- - -

String method is called and specified string index is out of bounds. This will result in StringIndexOutOfBoundsException at runtime.

- - -

RC: Comparaison de références suspecte (RC_REF_COMPARISON)

- - -

Cette méthode compare deux références avec l'opérateur == ou !=, alors que la façon correcte de comparer les instances de ce type est généralement d'utiliser la méthode equals(). Des exemples de classes qui ne doivent généralement pas être comparées par référence sont java.lang.Integer, java.lang.Float, etc...

- - -

RCN: Test de nullité d'une valeur préalablement déréférencée (RCN_REDUNDANT_NULLCHECK_WOULD_HAVE_BEEN_A_NPE)

- - -

Une valeur est testée ici pour savoir si elle est à null alors que cette valeur ne peut pas être à null puisqu'elle a été déréférencée et qu'une NullPointerException se serait alors produite à ce moment. Ce code est en contradiction avec le déréférencement préalable au sujet de la capacité de cette valeur d'être à null. Soit le test est redondant, soit le déréférencement préalable est erroné.

- - -

RE: Syntaxe d'expression régulière invalide (RE_BAD_SYNTAX_FOR_REGULAR_EXPRESSION)

- - -

Le code utilise une expression régulière qui est invalide selon la syntaxe des expressions régulières. Lors de l'exécution, une exception PatternSyntaxException sera lancée.

- - -

RE: File.separator used for regular expression (RE_CANT_USE_FILE_SEPARATOR_AS_REGULAR_EXPRESSION)

- - -

-The code here uses File.separator -where a regular expression is required. This will fail on Windows -platforms, where the File.separator is a backslash, which is interpreted in a -regular expression as an escape character. Among other options, you can just use -File.separatorChar=='\\' ? "\\\\" : File.separator instead of -File.separator - -

- - -

RE: "." utilisé dans une expression régulière (RE_POSSIBLE_UNINTENDED_PATTERN)

- - -

Une fonction String attendant une expression régulière reçoit "." en paramètre. Est-ce voulu ? Par exemple, s.replaceAll(".", "/") renverra une chaine dont chaque caractère aura été remplacé par le caractère '/'.

- - -

RV: Les valeurs aléatoires entre 0 et 1 sont réduites à l'entier 0 (RV_01_TO_INT)

- - -

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 Random.nextInt(n).

- - -

RV: Bad attempt to compute absolute value of signed 32-bit hashcode (RV_ABSOLUTE_VALUE_OF_HASHCODE)

- - -

This code generates a hashcode and then computes -the absolute value of that hashcode. If the hashcode -is Integer.MIN_VALUE, then the result will be negative as well (since -Math.abs(Integer.MIN_VALUE) == Integer.MIN_VALUE). -

-

One out of 2^32 strings have a hashCode of Integer.MIN_VALUE, -including "polygenelubricants" "GydZG_" and ""DESIGNING WORKHOUSES". -

- - -

RV: Bad attempt to compute absolute value of signed random integer (RV_ABSOLUTE_VALUE_OF_RANDOM_INT)

- - -

This code generates a random signed integer and then computes -the absolute value of that random integer. If the number returned by the random number -generator is Integer.MIN_VALUE, then the result will be negative as well (since -Math.abs(Integer.MIN_VALUE) == Integer.MIN_VALUE). (Same problem arises for long values as well). -

- - -

RV: Code checks for specific values returned by compareTo (RV_CHECK_COMPARETO_FOR_SPECIFIC_RETURN_VALUE)

- - -

This code invoked a compareTo or compare method, and checks to see if the return value is a specific value, -such as 1 or -1. When invoking these methods, you should only check the sign of the result, not for any specific -non-zero value. While many or most compareTo and compare methods only return -1, 0 or 1, some of them -will return other values. - - -

RV: Exception created and dropped rather than thrown (RV_EXCEPTION_NOT_THROWN)

- - -

This code creates an exception (or error) object, but doesn't do anything with it. For example, -something like

-
-
-if (x < 0)
-  new IllegalArgumentException("x must be nonnegative");
-
-
-

It was probably the intent of the programmer to throw the created exception:

-
-
-if (x < 0)
-  throw new IllegalArgumentException("x must be nonnegative");
-
-
- - -

RV: La méthode ignore une valeur de retour (RV_RETURN_VALUE_IGNORED)

- - -

La valeur renvoyée par cette méthode devrait-être vérifiée. Une cause habituelle de cette alarme est d'invoquer une méthode sur un objet constant en pensant que cela modifiera l'objet. Par exemple :

-
-
-String dateString = getHeaderField(name);
-dateString.trim();
-
-
-

Le programmeur semble croire que la méthode trim() mettra à jour l'objet String référencé par dateString. Mais, les objets String étant constants, la fonction renvoi une nouvelle valeur qui est ici ignorée. Le code devrait être corrigé en :

-
-
-String dateString = getHeaderField(name);
-dateString = dateString.trim();
-
-
- - -

RpC: Repeated conditional tests (RpC_REPEATED_CONDITIONAL_TEST)

- - -

The code contains a conditional test is performed twice, one right after the other -(e.g., x == 0 || x == 0). Perhaps the second occurrence is intended to be something else -(e.g., x == 0 || y == 0). -

- - -

SA: Auto-alimentation d'un champs (SA_FIELD_SELF_ASSIGNMENT)

- - -

Cette méthode contient un champ s'auto-alimentant; par exemple :

-
-int x;
-public void foo() {
-  x = x;
-}
-
-

De telles affectations sont inutiles et peuvent indiquer une faute de frappe ou une erreur logique.

- - -

SA: Self comparison of field with itself (SA_FIELD_SELF_COMPARISON)

- - -

This method compares a field with itself, and may indicate a typo or -a logic error. Make sure that you are comparing the right things. -

- - -

SA: Nonsensical self computation involving a field (e.g., x & x) (SA_FIELD_SELF_COMPUTATION)

- - -

This method performs a nonsensical computation of a field with another -reference to the same field (e.g., x&x or x-x). Because of the nature -of the computation, this operation doesn't seem to make sense, -and may indicate a typo or -a logic error. Double check the computation. -

- - -

SA: Self assignment of local rather than assignment to field (SA_LOCAL_SELF_ASSIGNMENT_INSTEAD_OF_FIELD)

- - -

This method contains a self assignment of a local variable, and there -is a field with an identical name. -assignment appears to have been ; e.g.

-
-  int foo;
-  public void setFoo(int foo) {
-    foo = foo;
-  }
-
-

The assignment is useless. Did you mean to assign to the field instead?

- - -

SA: Self comparison of value with itself (SA_LOCAL_SELF_COMPARISON)

- - -

This method compares a local variable with itself, and may indicate a typo or -a logic error. Make sure that you are comparing the right things. -

- - -

SA: Nonsensical self computation involving a variable (e.g., x & x) (SA_LOCAL_SELF_COMPUTATION)

- - -

This method performs a nonsensical computation of a local variable with another -reference to the same variable (e.g., x&x or x-x). Because of the nature -of the computation, this operation doesn't seem to make sense, -and may indicate a typo or -a logic error. Double check the computation. -

- - -

SF: Dead store due to switch statement fall through (SF_DEAD_STORE_DUE_TO_SWITCH_FALLTHROUGH)

- - -

A value stored in the previous switch case is overwritten here due to a switch fall through. It is likely that - you forgot to put a break or return at the end of the previous case. -

- - -

SF: Dead store due to switch statement fall through to throw (SF_DEAD_STORE_DUE_TO_SWITCH_FALLTHROUGH_TO_THROW)

- - -

A value stored in the previous switch case is ignored here due to a switch fall through to a place where - an exception is thrown. It is likely that - you forgot to put a break or return at the end of the previous case. -

- - -

SIC: Deadly embrace of non-static inner class and thread local (SIC_THREADLOCAL_DEADLY_EMBRACE)

- - -

This class is an inner class, but should probably be a static inner class. - As it is, there is a serious danger of a deadly embrace between the inner class - and the thread local in the outer class. Because the inner class isn't static, - it retains a reference to the outer class. - If the thread local contains a reference to an instance of the inner - class, the inner and outer instance will both be reachable - and not eligible for garbage collection. -

- - -

SIO: Vérification de type inutile avec l'opérateur instanceof (SIO_SUPERFLUOUS_INSTANCEOF)

- - -

Vérification de type effectuée avec l'opérateur instanceof alors que cela pourrait-être déterminé statiquement.

- - -

SQL: Méthode essayant au paramêtre d'indice 0 d'un PreparedStatement (SQL_BAD_PREPARED_STATEMENT_ACCESS)

- - -

Un appel à une méthode setXXX d'un PreparedStatement est réalisé sur l'indice 0. Puisque les indices des paramêtres d'un PreparedStatement commencent à 1, c'est toujours une erreur.

- - -

SQL: Méthode essayant d'accèder à un champ de ResultSet d'indice 0 (SQL_BAD_RESULTSET_ACCESS)

- - -

Un appel à une méthode getXXX ou updateXXX d'un ResultSet est réalisé pour l'indice 0. Puisque les indices de ResultSet commencent à 1, c'est toujours une erreur.

- - -

STI: Utilisation superflue d'un appel à currentThread() pour appeler interrupted() (STI_INTERRUPTED_ON_CURRENTTHREAD)

- - -

Cette méthode invoque Thread.currentThread() juste pour appeler la méthode interrupted(). Comme interrupted() est une méthode statique, il est plus simple et facile d'utiliser Thread.interrupted().

- - -

STI: Thread.interrupted() appelée par erreur sur un objet Thread arbitraire (STI_INTERRUPTED_ON_UNKNOWNTHREAD)

- - -

Cette méthode invoque Thread.interrupted() sur un objet Thread qui n'est pas le thread actif. Pusique la méthode interrupted() est statique, la méthode interrupted() sera appelée sur un objet différent de celui auquel l'auteur du code pensait.

- - -

Se: Méthode devant être privée pour que la sérialisation fonctionne (SE_METHOD_MUST_BE_PRIVATE)

- - -

Cette classe implémente l'interface Serializable et défini une méthode pour personnaliser la sérialisation/désérialisation. Mais cette méthode n'étant pas déclarée privée elle sera ignorée silencieusement par les API de sérialisation/désérialisation.

- - -

Se: The readResolve method must not be declared as a static method. (SE_READ_RESOLVE_IS_STATIC)

- - -

In order for the readResolve method to be recognized by the serialization -mechanism, it must not be declared as a static method. -

- - -

TQ: Value annotated as carrying a type qualifier used where a value that must not carry that qualifier is required (TQ_ALWAYS_VALUE_USED_WHERE_NEVER_REQUIRED)

- - -

- A value specified as carrying a type qualifier annotation is - consumed in a location or locations requiring that the value not - carry that annotation. -

- -

- More precisely, a value annotated with a type qualifier specifying when=ALWAYS - is guaranteed to reach a use or uses where the same type qualifier specifies when=NEVER. -

- -

- For example, say that @NonNegative is a nickname for - the type qualifier annotation @Negative(when=When.NEVER). - The following code will generate this warning because - the return statement requires a @NonNegative value, - but receives one that is marked as @Negative. -

-
-
-public @NonNegative Integer example(@Negative Integer value) {
-    return value;
-}
-
-
- - -

TQ: Comparing values with incompatible type qualifiers (TQ_COMPARING_VALUES_WITH_INCOMPATIBLE_TYPE_QUALIFIERS)

- - -

- A value specified as carrying a type qualifier annotation is - compared with a value that doesn't ever carry that qualifier. -

- -

- More precisely, a value annotated with a type qualifier specifying when=ALWAYS - is compared with a value that where the same type qualifier specifies when=NEVER. -

- -

- For example, say that @NonNegative is a nickname for - the type qualifier annotation @Negative(when=When.NEVER). - The following code will generate this warning because - the return statement requires a @NonNegative value, - but receives one that is marked as @Negative. -

-
-
-public boolean example(@Negative Integer value1, @NonNegative Integer value2) {
-    return value1.equals(value2);
-}
-
-
- - -

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 value that is annotated as possibility not being an instance of - the values denoted by the type qualifier, and the value is guaranteed to be used - in a way that requires values denoted by that type qualifier. -

- - -

TQ: Value that might carry a type qualifier is always used in a way prohibits it from having that type qualifier (TQ_MAYBE_SOURCE_VALUE_REACHES_NEVER_SINK)

- - -

- A value that is annotated as possibility being an instance of - the values denoted by the type qualifier, and the value is guaranteed to be used - in a way that prohibits values denoted by that type qualifier. -

- - -

TQ: Value annotated as never carrying a type qualifier used where value carrying that qualifier is required (TQ_NEVER_VALUE_USED_WHERE_ALWAYS_REQUIRED)

- - -

- A value specified as not carrying a type qualifier annotation is guaranteed - to be consumed in a location or locations requiring that the value does - carry that annotation. -

- -

- More precisely, a value annotated with a type qualifier specifying when=NEVER - is guaranteed to reach a use or uses where the same type qualifier specifies when=ALWAYS. -

- -

- TODO: example -

- - -

TQ: Value without a type qualifier used where a value is required to have that qualifier (TQ_UNKNOWN_VALUE_USED_WHERE_ALWAYS_STRICTLY_REQUIRED)

- - -

- A value is being used in a way that requires the value be annotation with a type qualifier. - The type qualifier is strict, so the tool rejects any values that do not have - the appropriate annotation. -

- -

- To coerce a value to have a strict annotation, define an identity function where the return value is annotated - with the strict annotation. - This is the only way to turn a non-annotated value into a value with a strict type qualifier annotation. -

- - - -

UMAC: Méthode non appelable définie dans une classe anonyme (UMAC_UNCALLABLE_METHOD_OF_ANONYMOUS_CLASS)

- - -

Cette classe anonyme définie une méthode qui n'est pas directement appelée et qui ne surcharge pas une méthode de la classe mère. Puisque les méthodes des autres classes ne peuvent pas directement invoquer les méthodes des classes anonymes, il apparaît que cette méthode est inaccessible. Cette méthode est probablement du code mort, mais il est aussi possible qu'elle essaye de surcharger une méthode déclarée dans la classe mère et échoue à le faire en raison d'une erreur de type ou autre.

- - -

UR: Lecture d'un champ non initialisé dans un constructeur (UR_UNINIT_READ)

- - -

Ce constructeur lit un champ qui n'a pas encore été initialisé. Une des causes les plus fréquentes est l'utilisation accidentelle par le développeur du champ au lieu d'un des paramètres du constructeur.

- - -

UR: Uninitialized read of field method called from constructor of superclass (UR_UNINIT_READ_CALLED_FROM_SUPER_CONSTRUCTOR)

- - -

This method is invoked in the constructor of the superclass. At this point, - the fields of the class have not yet initialized.

-

To make this more concrete, consider the following classes:

-
abstract class A {
-  int hashCode;
-  abstract Object getValue();
-  A() {
-    hashCode = getValue().hashCode();
-    }
-  }
-class B extends A {
-  Object value;
-  B(Object v) {
-    this.value = v;
-    }
-  Object getValue() {
-    return value;
-  }
-  }
-

When a B is constructed, -the constructor for the A class is invoked -before the constructor for B sets value. -Thus, when the constructor for A invokes getValue, -an uninitialized value is read for value. -

- - -

USELESS_STRING: Invocation of toString on an unnamed array (DMI_INVOKING_TOSTRING_ON_ANONYMOUS_ARRAY)

- - -

-The code invokes toString on an (anonymous) array. Calling toString on an array generates a fairly useless result -such as [C@16f0472. Consider using Arrays.toString to convert the array into a readable -String that gives the contents of the array. See Programming Puzzlers, chapter 3, puzzle 12. -

- - -

USELESS_STRING: Invocation de toString sur un tableau (DMI_INVOKING_TOSTRING_ON_ARRAY)

- - -

Le code invoque toString sur un tableau, ce qui va générer un résultat assez inutile du genre [C@16f0472. Envisagez d'utiliser String.valueOf pour convertir un tableau en une chaine lisible contenant les valeurs du tableau. Cf Programming Puzzlers, chapitre 3, problème 12.

- - -

USELESS_STRING: Array formatted in useless way using format string (VA_FORMAT_STRING_BAD_CONVERSION_FROM_ARRAY)

- - -

-One of the arguments being formatted with a format string is an array. This will be formatted -using a fairly useless format, such as [I@304282, which doesn't actually show the contents -of the array. -Consider wrapping the array using Arrays.asList(...) before handling it off to a formatted. -

- - -

UwF: Champ uniquement mis à null (UWF_NULL_FIELD)

- - -

Ce champ est uniquement alimenté par la constante null et donc toutes les lectures de ce champ renverront null. Vérifiez si c'est une erreur ou alors supprimez ce champ qui est inutile.

- - -

UwF: Champ jamais écrit (UWF_UNWRITTEN_FIELD)

- - -

Ce champ n'est jamais alimenté. Toutes les lectures vont renvoyer sa valeur par défaut. Recherchez les erreurs (devrait-il avoir été initialisé ?) ou supprimez le s'il est inutile.

- - -

VA: Tableau de primitives passé à une fonction attendant un nombre variable d'objets en argument (VA_PRIMITIVE_ARRAY_PASSED_TO_OBJECT_VARARG)

- - -

Ce code envoie un tableau de primitives à une fonction qui attend un nombre variable d'objets en arguments. Ceci créé un tableau de longueur 1 pour contenir le tableau de primitives puis le passe à la fonction.

- - -

LG: Potential lost logger changes due to weak reference in OpenJDK (LG_LOST_LOGGER_DUE_TO_WEAK_REFERENCE)

- - -

OpenJDK introduces a potential incompatibility. - In particular, the java.util.logging.Logger behavior has - changed. Instead of using strong references, it now uses weak references - internally. That's a reasonable change, but unfortunately some code relies on - the old behavior - when changing logger configuration, it simply drops the - logger reference. That means that the garbage collector is free to reclaim - that memory, which means that the logger configuration is lost. For example, -consider: -

- -
public static void initLogging() throws Exception {
- Logger logger = Logger.getLogger("edu.umd.cs");
- logger.addHandler(new FileHandler()); // call to change logger configuration
- logger.setUseParentHandlers(false); // another call to change logger configuration
-}
- -

The logger reference is lost at the end of the method (it doesn't -escape the method), so if you have a garbage collection cycle just -after the call to initLogging, the logger configuration is lost -(because Logger only keeps weak references).

- -
public static void main(String[] args) throws Exception {
- initLogging(); // adds a file handler to the logger
- System.gc(); // logger configuration lost
- Logger.getLogger("edu.umd.cs").info("Some message"); // this isn't logged to the file as expected
-}
-

Ulf Ochsenfahrt and Eric Fellheimer

- - -

OBL: Method may fail to clean up stream or resource (OBL_UNSATISFIED_OBLIGATION)

- - -

- This method may fail to clean up (close, dispose of) a stream, - database object, or other - resource requiring an explicit cleanup operation. -

- -

- In general, if a method opens a stream or other resource, - the method should use a try/finally block to ensure that - the stream or resource is cleaned up before the method - returns. -

- -

- This bug pattern is essentially the same as the - OS_OPEN_STREAM and ODR_OPEN_DATABASE_RESOURCE - bug patterns, but is based on a different - (and hopefully better) static analysis technique. - We are interested is getting feedback about the - usefulness of this bug pattern. - To send feedback, either: -

- - -

- In particular, - the false-positive suppression heuristics for this - bug pattern have not been extensively tuned, so - reports about false positives are helpful to us. -

- -

- See Weimer and Necula, Finding and Preventing Run-Time Error Handling Mistakes, for - a description of the analysis technique. -

- - -

OBL: Method may fail to clean up stream or resource on checked exception (OBL_UNSATISFIED_OBLIGATION_EXCEPTION_EDGE)

- - -

- This method may fail to clean up (close, dispose of) a stream, - database object, or other - resource requiring an explicit cleanup operation. -

- -

- In general, if a method opens a stream or other resource, - the method should use a try/finally block to ensure that - the stream or resource is cleaned up before the method - returns. -

- -

- This bug pattern is essentially the same as the - OS_OPEN_STREAM and ODR_OPEN_DATABASE_RESOURCE - bug patterns, but is based on a different - (and hopefully better) static analysis technique. - We are interested is getting feedback about the - usefulness of this bug pattern. - To send feedback, either: -

- - -

- In particular, - the false-positive suppression heuristics for this - bug pattern have not been extensively tuned, so - reports about false positives are helpful to us. -

- -

- See Weimer and Necula, Finding and Preventing Run-Time Error Handling Mistakes, for - a description of the analysis technique. -

- - -

Dm: La méthode appelle les String.toUpperCase() ou String.toLowerCase ; utilisez plutôt la version paramètrée par une Locale (DM_CONVERT_CASE)

- - -

Une chaîne est mise en majuscules ou minuscules en fonction de jeu de caractères par défaut de la machine. Ceci peut entraîner des conversions erronées sur les caractères internationaux. Utilisez String.toUpperCase(Locale l) ou String.toLowerCase(Locale l) à la place.

- - -

Dm: Reliance on default encoding (DM_DEFAULT_ENCODING)

- - -

Found a call to a method which will perform a byte to String (or String to byte) conversion, and will assume that the default platform encoding is suitable. This will cause the application behaviour to vary between platforms. Use an alternative API and specify a charset name or Charset object explicitly.

- - -

DP: Les chargeurs de classes ne doivent être créés qu'à partir de block doPrivileged (DP_CREATE_CLASSLOADER_INSIDE_DO_PRIVILEGED)

- - -

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 doPrivileged au cas ou il serait appelé par du code ne possédant pas les droits requis.

- - -

DP: Méthode invoquée alors qu'elle ne devrait l'être qu'à partir d'un block doPrivileged (DP_DO_INSIDE_DO_PRIVILEGED)

- - -

Ce code invoque une méthode qui nécessite un test de sécurité sur les permissions. Si ce code, bien qu'ayant les droits suffisants, peut être invoqué par du code n'ayant pas les droits requis l'appel doit alors être effectué à l'intérieur d'un block doPrivileged.

- - -

EI: Une méthode peut exposer sa représentation interne en renvoyant une référence à un objet modifiable (EI_EXPOSE_REP)

- - -

Renvoyer une référence à un objet modifiable stocké dans les champs d'un objet expose la représentation interne de l'objet. Si des instances sont accédées par du code non fiable, et que des modifications non vérifiées peuvent compromettre la sécurité ou d'autres propriétés importantes, vous devez faire autre chose. Renvoyer une nouvelle copie de l'objet est une meilleur approche dans de nombreuses situations.

- - -

EI2: Une méthode expose sa représentation interne en incorporant une référence à un objet modifiable (EI_EXPOSE_REP2)

- - -

Ce code stocke une référence à un objet externe modifiable dans la représentation interne de l'objet. Si des instances sont accédées par du code non fiable, et que des modifications non vérifiées peuvent compromettre la sécurité ou d'autres propriétés importantes, vous devez faire autre chose. Stocker une copie de l'objet est une meilleur approche dans de nombreuses situations.

- - -

FI: Un finaliseur devrait être protégé, pas public (FI_PUBLIC_SHOULD_BE_PROTECTED)

- - -

La méthode finalize() d'une classe devrait avoir un accès protégé, pas public.

- - -

MS: Une méthode peut exposer un état interne statique en stockant un objet modifiable dans un champs statique (EI_EXPOSE_STATIC_REP2)

- - -

Ce code stocke une référence à un objet modifiable externe dans un champs statique. Si des modifications non vérifiées de l'objet modifiable peuvent compromettre la sécurité ou d'autres propriétés importantes, vous devez faire autre chose. Stocker une copie de l'objet est souvent une meilleur approche.

- - -

MS: Un champ n'est pas final et ne peut pas être protégé face à du code malveillant (MS_CANNOT_BE_FINAL)

- - -

Un champ statique modifiable peut-être modifié par accident ou par du code malveillant. Malheureusement, la façon dont ce champ est utilisé ne permet une correction aisée de ce problème.

- - -

MS: Une méthode statique publique risque d'exposer une représentation interne en renvoyant un tableau (MS_EXPOSE_REP)

- - -

Une méthode statique publique renvoit une référence à un tableau faisant partie de l'état statique de la classe. Tout code appelant cette méthode peut librement modifier le tableau sous-jacent. Une correction possible serait de renvoyer une copie du tableau.

- - -

MS: Le champ devrait être à la fois final et package protected (MS_FINAL_PKGPROTECT)

- - -

Un champ statique modifiable peut-être changé par accident ou par du code malveillant d'un autre paquetage. Le champ devrait être package protected et/ou final pour éviter cette vulnérabilité.

- - -

MS: Un champ est un tableau modifiable (MS_MUTABLE_ARRAY)

- - -

Le champ est une référence final static à un tableau et peut-être modifié par accident ou par du code malveillant d'un autre paquetage. Ce code peut librement modifier le contenu du tableau.

- - -

MS: Field is a mutable collection (MS_MUTABLE_COLLECTION)

- - -

A mutable collection instance is assigned to a final static field, - thus can be changed by malicious code or by accident from another package. - Consider wrapping this field into Collections.unmodifiableSet/List/Map/etc. - to avoid this vulnerability.

- - -

MS: Field is a mutable collection which should be package protected (MS_MUTABLE_COLLECTION_PKGPROTECT)

- - -

A mutable collection instance is assigned to a final static field, - thus can be changed by malicious code or by accident from another package. - The field could be made package protected to avoid this vulnerability. - Alternatively you may wrap this field into Collections.unmodifiableSet/List/Map/etc. - to avoid this vulnerability.

- - -

MS: Un champ modifiable est une Hashtable (MS_MUTABLE_HASHTABLE)

- - -

Le champ est une référence final static à une Hashtable et peut-être modifié par accident ou par du code malveillant d'un autre paquetage. Ce code peut librement modifier le contenu de la Hashtable.

- - -

MS: Le champ devrait être sorti de l'interface et mis en package protected (MS_OOI_PKGPROTECT)

- - -

Un champ final static défini dans une interface référence un objet modifiable tel qu'un tableau ou une table de hachage. Cet objet pourrait être modifié par accident ou par du code sournois d'un autre paquetage. Pour résoudre cela et éviter cette vulnérabilité, le champ doit être intégré dans une classe et sa visibilité modifiée en package protected.

- - -

MS: Un champ devrait être package protected (MS_PKGPROTECT)

- - -

Un champ statique modifiable peut-être changé par accident ou par du code malveillant d'un autre paquetage. Le champ devrait être package protected pour éviter cette vulnérabilité.

- - -

MS: Un champ n'est pas final alors qu'il devrait l'être (MS_SHOULD_BE_FINAL)

- - -

Un champ statique modifiable peut-être changé par accident ou par du code malveillant d'un autre paquetage. Le champ devrait être final pour éviter cette vulnérabilité.

- - -

MS: Field isn't final but should be refactored to be so (MS_SHOULD_BE_REFACTORED_TO_BE_FINAL)

- - -

-This static field public but not final, and -could be changed by malicious code or -by accident from another package. -The field could be made final to avoid -this vulnerability. However, the static initializer contains more than one write -to the field, so doing so will require some refactoring. -

- - -

AT: Sequence of calls to concurrent abstraction may not be atomic (AT_OPERATION_SEQUENCE_ON_CONCURRENT_ABSTRACTION)

- - -

This code contains a sequence of calls to a concurrent abstraction - (such as a concurrent hash map). - These calls will not be executed atomically. - - -

DC: Possible double vérification d'un champ (DC_DOUBLECHECK)

- - -

Cette méthode contient peut-être une instance de verrou par double vérification. Cet idiome n'est pas correct vis-à-vis de la sémantique du modèle de mémoire Java. Pour plus d'informations, cf. la page http://www.cs.umd.edu/~pugh/java/memoryModel/DoubleCheckedLocking.html.

- - -

DC: Possible exposure of partially initialized object (DC_PARTIALLY_CONSTRUCTED)

- - -

Looks like this method uses lazy field initialization with double-checked locking. - While the field is correctly declared as volatile, it's possible that the internal structure of - the object is changed after the field assignment, thus another thread may see the partially initialized object.

-

To fix this problem consider storing the object into the local variable first - and save it to the volatile field only after it's fully constructed. -

- - -

DL: Synchronization on Boolean (DL_SYNCHRONIZATION_ON_BOOLEAN)

- - -

The code synchronizes on a boxed primitive constant, such as a Boolean.

-
-private static Boolean inited = Boolean.FALSE;
-...
-  synchronized(inited) {
-    if (!inited) {
-       init();
-       inited = Boolean.TRUE;
-       }
-     }
-...
-
-

Since there normally exist only two Boolean objects, this code could be synchronizing on the same object as other, unrelated code, leading to unresponsiveness -and possible deadlock.

-

See CERT CON08-J. Do not synchronize on objects that may be reused for more information.

- - -

DL: Synchronization on boxed primitive (DL_SYNCHRONIZATION_ON_BOXED_PRIMITIVE)

- - -

The code synchronizes on a boxed primitive constant, such as an Integer.

-
-private static Integer count = 0;
-...
-  synchronized(count) {
-     count++;
-     }
-...
-
-

Since Integer objects can be cached and shared, -this code could be synchronizing on the same object as other, unrelated code, leading to unresponsiveness -and possible deadlock.

-

See CERT CON08-J. Do not synchronize on objects that may be reused for more information.

- - -

DL: Synchronization on interned String (DL_SYNCHRONIZATION_ON_SHARED_CONSTANT)

- - -

The code synchronizes on interned String.

-
-private static String LOCK = "LOCK";
-...
-  synchronized(LOCK) { ...}
-...
-
-

Constant Strings are interned and shared across all other classes loaded by the JVM. Thus, this code -is locking on something that other code might also be locking. This could result in very strange and hard to diagnose -blocking and deadlock behavior. See http://www.javalobby.org/java/forums/t96352.html and http://jira.codehaus.org/browse/JETTY-352. -

-

See CERT CON08-J. Do not synchronize on objects that may be reused for more information.

- - -

DL: Synchronization on boxed primitive values (DL_SYNCHRONIZATION_ON_UNSHARED_BOXED_PRIMITIVE)

- - -

The code synchronizes on an apparently unshared boxed primitive, -such as an Integer.

-
-private static final Integer fileLock = new Integer(1);
-...
-  synchronized(fileLock) {
-     .. do something ..
-     }
-...
-
-

It would be much better, in this code, to redeclare fileLock as

-
-private static final Object fileLock = new Object();
-
-

-The existing code might be OK, but it is confusing and a -future refactoring, such as the "Remove Boxing" refactoring in IntelliJ, -might replace this with the use of an interned Integer object shared -throughout the JVM, leading to very confusing behavior and potential deadlock. -

- - -

Dm: Wait() appelé sur une Condition (DM_MONITOR_WAIT_ON_CONDITION)

- - -

Cette méthode appelle wait() sur un objet java.util.concurrent.locks.Condition. L'attente d'une Condition devrait être faite en utilisant l'une des méthodes await() définies dans l'interface Condition.

- - -

Dm: Thread créé avec la méthode run vide par défaut (DM_USELESS_THREAD)

- - -

Cette méthode crée un thread sans spécifier de méthode run, soit par dérivation de la classe Thread, soit en transmettant un objet Runnable. Ce thread ne fait donc rien sauf perdre du temps.

- - -

ESync: Bloc synchronisé vide (ESync_EMPTY_SYNC)

- - -

Présence d'un bloc synchronisé vide:

-
-synchronized() {}
-
-

L'utilisation de blocs synchronisés vides est bien plus subtile et dure à réaliser correctement que bien des gens ne le reconnaissent, et de plus ne correspond que rarement à la meilleure des solutions.

- - -

IS: Synchronisation incohérente (IS2_INCONSISTENT_SYNC)

- - -

Les champs de cette classe semblent être accédés de façon incohérente vis-à-vis de la synchronisation. Le détecteur de bogue juge que :

-
    -
  1. la classe contient un mélange d'accès verrouillés et non verrouillés,
    2. -
  2. au moins un des accès verrouillés est effectué par une des propres méthodes de la classe,
    3. -
  3. le nombre d'accès (lectures et écritures) non synchronisés ne représente pas plus d'un tiers de tous les accès, avec plus de deux fois plus d'écritures que de lectures.
    4. -
-

Un bogue typique déclenchant ce détecteur est l'oubli de la synchronisation sur l'une des méthodes d'une classe qui essaye d'être sûre vis-à-vis des threads.

-

Vous pouvez sélectionner les noeuds nommés "Accès non synchronisés" pour avoir la position exacte dans le code où le détecteur pense qu'un champ est accédé sans synchronisation.

-

Notez qu'il y a diverses sources d'inexactitude dans ce détecteur ; par exemple, le détecteur ne peut pas repérer statiquement toutes les situations dans lesquelles un verrou est obtenu. En fait, même lorsque le détecteur repère effectivement des accès avec et sans verrou, le code concerné peut quand même être correct.

-

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".

- - -

IS: Champ non protégé contre les accès concurrents (IS_FIELD_NOT_GUARDED)

- - -

Ce champ est annoté avec net.jcip.annotations.GuardedBy, mais peut être utilisé d'une façon qui contredit l'annotation.

- - -

JLM: Synchronisation effectuée sur un Lock java.util.concurrent (JLM_JSR166_LOCK_MONITORENTER)

- - -

Cette méthode se synchronise au moyen d'une implémentation de java.util.concurrent.locks.Lock. Vous devriez plutôt utiliser les méthodes lock() et unlock().

- - -

JLM: Synchronization performed on util.concurrent instance (JLM_JSR166_UTILCONCURRENT_MONITORENTER)

- - -

This method performs synchronization an object that is an instance of -a class from the java.util.concurrent package (or its subclasses). Instances -of these classes have their own concurrency control mechanisms that are orthogonal to -the synchronization provided by the Java keyword synchronized. For example, -synchronizing on an AtomicBoolean will not prevent other threads -from modifying the AtomicBoolean.

-

Such code may be correct, but should be carefully reviewed and documented, -and may confuse people who have to maintain the code at a later date. -

- - -

JLM: Using monitor style wait methods on util.concurrent abstraction (JML_JSR166_CALLING_WAIT_RATHER_THAN_AWAIT)

- - -

This method calls -wait(), -notify() or -notifyAll()() -on an object that also provides an -await(), -signal(), -signalAll() method (such as util.concurrent Condition objects). -This probably isn't what you want, and even if you do want it, you should consider changing -your design, as other developers will find it exceptionally confusing. -

- - -

LI: Initialisation paresseuse incorrecte d'un champ statique (LI_LAZY_INIT_STATIC)

- - -

Cette méthode contient une initialisation paresseuse non synchronisée d'un champ statique non volatile. Comme le compilateur ou le processeur peuvent réordonner les instructions, les threads ne sont pas certains de voir un objet complètement initialisé, si la méthode peut-être appelée par de multiples threads. Vous pouvez rendre le champs volatile pour corriger le problème. Pour plus d'informations, cf. site Web sur le modèle mémoire de Java.

- - -

LI: Incorrect lazy initialization and update of static field (LI_LAZY_INIT_UPDATE_STATIC)

- - -

This method contains an unsynchronized lazy initialization of a static field. -After the field is set, the object stored into that location is further updated or accessed. -The setting of the field is visible to other threads as soon as it is set. If the -further accesses in the method that set the field serve to initialize the object, then -you have a very serious multithreading bug, unless something else prevents -any other thread from accessing the stored object until it is fully initialized. -

-

Even if you feel confident that the method is never called by multiple -threads, it might be better to not set the static field until the value -you are setting it to is fully populated/initialized. - - -

ML: Synchronization on field in futile attempt to guard that field (ML_SYNC_ON_FIELD_TO_GUARD_CHANGING_THAT_FIELD)

- - -

This method synchronizes on a field in what appears to be an attempt -to guard against simultaneous updates to that field. But guarding a field -gets a lock on the referenced object, not on the field. This may not -provide the mutual exclusion you need, and other threads might -be obtaining locks on the referenced objects (for other purposes). An example -of this pattern would be:

-
-private Long myNtfSeqNbrCounter = new Long(0);
-private Long getNotificationSequenceNumber() {
-     Long result = null;
-     synchronized(myNtfSeqNbrCounter) {
-         result = new Long(myNtfSeqNbrCounter.longValue() + 1);
-         myNtfSeqNbrCounter = new Long(result.longValue());
-     }
-     return result;
- }
-
- - -

ML: La méthode se synchronise sur un champ mis à jour (ML_SYNC_ON_UPDATED_FIELD)

- - -

Cette méthode se synchronise sur le champ modifiable d'une référence objet. Il y a peu de chances que cela ait un sens puisque les différents threads se synchroniserons par rapport à différents objets.

- - -

MSF: Mutable servlet field (MSF_MUTABLE_SERVLET_FIELD)

- - -

A web server generally only creates one instance of servlet or JSP class (i.e., treats -the class as a Singleton), -and will -have multiple threads invoke methods on that instance to service multiple -simultaneous requests. -Thus, having a mutable instance field generally creates race conditions. - - -

MWN: notify() non appareillé (MWN_MISMATCHED_NOTIFY)

- - -

Cette méthode appelle Object.notify() ou Object.notifyAll() sans détenir, visiblement, de verrou sur l'objet. Appeler notify() ou notifyAll() sans détenir de verrou entraîne le déclenchement d'une IllegalMonitorStateException.

- - -

MWN: wait() non appareillé (MWN_MISMATCHED_WAIT)

- - -

Cette méthode appelle Object.wait() sans détenir, visiblement, de verrou sur l'objet. Appeler wait() sans détenir de verrou entraîne le déclenchement d'une IllegalMonitorStateException.

- - -

NN: Appel notify() isolé dans une méthode (NN_NAKED_NOTIFY)

- - -

Un appel à notify() ou notifyAll() est effectué sans aucun changement (apparent) de l'état d'un objet modifiable. En général, appeler une méthode notify() dans un moniteur est effectué parce qu'une condition quelconque attendue par un autre thread est devenue vraie. Dans tous les cas, pour que la condition ait un sens, elle doit porter sur un objet visible des deux threads.

-

Ce bogue n'indique pas nécessairement une erreur puisque la modification de l'état de l'objet peut avoir eu lieu dans une méthode qui appelle la méthode contenant la notification.

- - -

NP: Synchronize and null check on the same field. (NP_SYNC_AND_NULL_CHECK_FIELD)

- - -

Since the field is synchronized on, it seems not likely to be null. -If it is null and then synchronized on a NullPointerException will be -thrown and the check would be pointless. Better to synchronize on -another field.

- - - -

No: Utilisation de notify() plutôt que notifyAll() dans une méthode (NO_NOTIFY_NOT_NOTIFYALL)

- - -

Cette méthode appelle notify() plutôt que notifyAll(). Le moniteur Java est souvent utilisé pour de multiples conditions. Appeler notify() ne réveille qu'un thread, ce qui signifie que le thread réveillé peut ne pas être celui qui attend la condition que l'appelant vient de remplir.

- - -

RS: Seule la méthode readObject() est synchronisée (RS_READOBJECT_SYNC)

- - -

Cette classe Serializable définit une méthode readObject() qui est synchronisée. Par définition, un objet créé par désérialisation n'est accessible que par un unique thread, donc il n'y a aucun intérêt à synchroniser readObject(). Si la méthode readObject() en elle-même rend l'objet visible d'un autre thread, vous avez un exemple de style de code très douteux.

- - -

RV: Return value of putIfAbsent ignored, value passed to putIfAbsent reused (RV_RETURN_VALUE_OF_PUTIFABSENT_IGNORED)

- - - The putIfAbsent method is typically used to ensure that a - single value is associated with a given key (the first value for which put - if absent succeeds). - If you ignore the return value and retain a reference to the value passed in, - you run the risk of retaining a value that is not the one that is associated with the key in the map. - If it matters which one you use and you use the one that isn't stored in the map, - your program will behave incorrectly. - - -

Ru: Invocation de run() sur un thread (Vouliez-vous plutôt dire start() ?) (RU_INVOKE_RUN)

- - -

Cette méthode appelle explicitement run() sur un objet. En général, les classes implémentent l'interface Runnable parce qu'elles vont avoir leur méthode run() invoquée dans un nouveau thread, auquel cas Thread.start() est la bonne méthode à appeler.

- - -

SC: Un constructeur invoque Thread.start() (SC_START_IN_CTOR)

- - -

Le constructeur lance un thread. Il y a de fortes chances que ce soit une erreur si cette classe est un jour dérivée ou étendue puisque que le thread sera alors lancé avant que le constructeur de la classe dérivée ne soit appelé.

- - -

SP: Méthode bouclant sur un champ (SP_SPIN_ON_FIELD)

- - -

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 à wait() et notify()).

- - -

STCAL: Call to static Calendar (STCAL_INVOKE_ON_STATIC_CALENDAR_INSTANCE)

- - -

Even though the JavaDoc does not contain a hint about it, Calendars are inherently unsafe for multithreaded use. -The detector has found a call to an instance of Calendar that has been obtained via a static -field. This looks suspicious.

-

For more information on this see JDK Bug #6231579 -and JDK Bug #6178997.

- - -

STCAL: Call to static DateFormat (STCAL_INVOKE_ON_STATIC_DATE_FORMAT_INSTANCE)

- - -

As the JavaDoc states, DateFormats are inherently unsafe for multithreaded use. -The detector has found a call to an instance of DateFormat that has been obtained via a static -field. This looks suspicious.

-

For more information on this see JDK Bug #6231579 -and JDK Bug #6178997.

- - -

STCAL: Static Calendar field (STCAL_STATIC_CALENDAR_INSTANCE)

- - -

Even though the JavaDoc does not contain a hint about it, Calendars are inherently unsafe for multithreaded use. -Sharing a single instance across thread boundaries without proper synchronization will result in erratic behavior of the -application. Under 1.4 problems seem to surface less often than under Java 5 where you will probably see -random ArrayIndexOutOfBoundsExceptions or IndexOutOfBoundsExceptions in sun.util.calendar.BaseCalendar.getCalendarDateFromFixedDate().

-

You may also experience serialization problems.

-

Using an instance field is recommended.

-

For more information on this see JDK Bug #6231579 -and JDK Bug #6178997.

- - -

STCAL: Static DateFormat (STCAL_STATIC_SIMPLE_DATE_FORMAT_INSTANCE)

- - -

As the JavaDoc states, DateFormats are inherently unsafe for multithreaded use. -Sharing a single instance across thread boundaries without proper synchronization will result in erratic behavior of the -application.

-

You may also experience serialization problems.

-

Using an instance field is recommended.

-

For more information on this see JDK Bug #6231579 -and JDK Bug #6178997.

- - -

SWL: Appel de la méthode Thread.sleep() avec un verrou (SWL_SLEEP_WITH_LOCK_HELD)

- - -

Cette méthode appelle Thread.sleep() en tenant un verrou. Ceci peut résulter en de faibles performances, peu de capacité à monter en charge ou un inter-blocage puisque d'autres processus pourraient être en attente du verrou. C'est une meilleure idée d'appeler wait() sur le verrou, afin de le libérer et de permettre à d'autre processus de tourner.

- - -

TLW: wait() avec deux verrous en attente (TLW_TWO_LOCK_WAIT)

- - -

Attendre sur on moniteur alors que deux verrous sont détenus peut entraîner un blocage fatal (deadlock). Exécuter un wait() ne libère que le verrou sur l'objet accueillant le wait(), mais aucun autre verrou. Ce n'est pas obligatoirement un bogue, mais il vaut mieux examiner ça en détails.

- - -

UG: Méthode getXXX non synchronisée, méthode setXXX synchronisée (UG_SYNC_SET_UNSYNC_GET)

- - -

Cette classe contient des méthodes getXXX et setXXX similaires dont la méthode setXXX est synchronisée tandis que la méthode getXXX ne l'est pas. Ceci peut entraîner un comportement incorrect à l'exécution car l'appelant de la méthode getXXX ne verra pas obligatoirement l'objet dans un état consistant. La méthode getXXX devrait être synchronisée.

- - -

UL: La méthode ne libère pas un verrou dans tous les chemins d'exécution (UL_UNRELEASED_LOCK)

- - -

Cette méthode acquière un verrou JSR-166 (java.util.concurrent), mais ne le libère pas dans tous les chemins d'exécution. En général, l'idiome correct pour utiliser un verrou JSR-166 est :

-
-Lock l = ...;
-l.lock();
-try {
-    // do something
-} finally {
-    l.unlock();
-}
-
- - -

UL: La méthode ne libère pas un verrou dans tous les chemins d'exception (UL_UNRELEASED_LOCK_EXCEPTION_PATH)

- - -

Cette méthode acquière un verrou JSR-166 (java.util.concurrent), mais ne le libère pas dans tous les chemins d'exception. En général, l'idiome correct pour utiliser un verrou JSR-166 est :

-
-Lock l = ...;
-l.lock();
-try {
-    // do something
-} finally {
-    l.unlock();
-}
-
- - -

UW: Méthode contenant un wait() non conditionné (UW_UNCOND_WAIT)

- - -

Cette méthode contient un appel à java.lang.Object.wait() qui n'est pas protégé par une condition. Si la condition que la méthode essaye d'attendre a déjà été remplie, le thread risque d'attendre indéfiniment.

- - -

VO: An increment to a volatile field isn't atomic (VO_VOLATILE_INCREMENT)

- - -

This code increments a volatile field. Increments of volatile fields aren't -atomic. If more than one thread is incrementing the field at the same time, -increments could be lost. -

- - -

VO: Une référence volatile à un tableau ne traite pas les éléments du tableau comme volatiles (VO_VOLATILE_REFERENCE_TO_ARRAY)

- - -

Ceci déclare une référence volatile à un tableau, ce qui n'est peut-être pas ce que vous voulez. Avec une référence volatile à un tableau, les lectures et écritures de la référence au tableau sont traitées comme volatiles, mais les éléments ne sont pas volatiles. Pour obtenir des éléments volatiles, vous devez utiliser l'une des classes de tableaux atomiques de java.util.concurrent (inclus dans Java 5.0).

- - -

WL: Synchronization on getClass rather than class literal (WL_USING_GETCLASS_RATHER_THAN_CLASS_LITERAL)

- - -

- This instance method synchronizes on this.getClass(). If this class is subclassed, - subclasses will synchronize on the class object for the subclass, which isn't likely what was intended. - For example, consider this code from java.awt.Label:

- 
-     private static final String base = "label";
-     private static int nameCounter = 0;
-     String constructComponentName() {
-        synchronized (getClass()) {
-            return base + nameCounter++;
-        }
-     }
-
-

Subclasses of Label won't synchronize on the same subclass, giving rise to a datarace. - Instead, this code should be synchronizing on Label.class

- 
-     private static final String base = "label";
-     private static int nameCounter = 0;
-     String constructComponentName() {
-        synchronized (Label.class) {
-            return base + nameCounter++;
-        }
-     }
-
-

Bug pattern contributed by Jason Mehrens

- - -

WS: Seule la méthode writeObject() est synchronisée (WS_WRITEOBJECT_SYNC)

- - -

Cette classe a une méthode writeObject() qui est synchronisée ; mais aucune autre méthode de cette classe n'est synchronisée.

- - -

Wa: Condition.await() en dehors d'une boucle (WA_AWAIT_NOT_IN_LOOP)

- - -

Cette méthode contient un appel à java.util.concurrent.await() (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.

- - -

Wa: Méthode contenant un wait() en dehors d'une boucle (WA_NOT_IN_LOOP)

- - -

Cette méthode contient un appel à java.lang.Object.wait() qui n'est pas dans une boucle. Si le moniteur est utilisé pour des conditions multiples, la condition que l'appelant attend peut ne pas être celle qui s'est réellement déclenchée.

- - -

Bx: Primitive value is boxed and then immediately unboxed (BX_BOXING_IMMEDIATELY_UNBOXED)

- - -

A primitive is boxed, and then immediately unboxed. This probably is due to a manual - boxing in a place where an unboxed value is required, thus forcing the compiler -to immediately undo the work of the boxing. -

- - -

Bx: Primitive value is boxed then unboxed to perform primitive coercion (BX_BOXING_IMMEDIATELY_UNBOXED_TO_PERFORM_COERCION)

- - -

A primitive boxed value constructed and then immediately converted into a different primitive type -(e.g., new Double(d).intValue()). Just perform direct primitive coercion (e.g., (int) d).

- - -

Bx: Primitive value is unboxed and coerced for ternary operator (BX_UNBOXED_AND_COERCED_FOR_TERNARY_OPERATOR)

- - -

A wrapped primitive value is unboxed and converted to another primitive type as part of the -evaluation of a conditional ternary operator (the b ? e1 : e2 operator). The -semantics of Java mandate that if e1 and e2 are wrapped -numeric values, the values are unboxed and converted/coerced to their common type (e.g, -if e1 is of type Integer -and e2 is of type Float, then e1 is unboxed, -converted to a floating point value, and boxed. See JLS Section 15.25. -

- - -

Bx: Boxed value is unboxed and then immediately reboxed (BX_UNBOXING_IMMEDIATELY_REBOXED)

- - -

A boxed value is unboxed and then immediately reboxed. -

- - -

Bx: Boxing a primitive to compare (DM_BOXED_PRIMITIVE_FOR_COMPARE)

- - -

A boxed primitive is created just to call compareTo method. It's more efficient to use static compare method - (for double and float since Java 1.4, for other primitive types since Java 1.7) which works on primitives directly. -

- - -

Bx: Boxing/unboxing to parse a primitive (DM_BOXED_PRIMITIVE_FOR_PARSING)

- - -

A boxed primitive is created from a String, just to extract the unboxed primitive value. - It is more efficient to just call the static parseXXX method.

- - -

Bx: Méthode allouant une primitive boxed pour appeler toString (DM_BOXED_PRIMITIVE_TOSTRING)

- - -

Une primitive "boxed" est allouée juste pour appeler toString(). Il est plus efficace de simplement utiliser la forme statique de toString qui accepte la valeur primitive. Donc,

- - - - - - - - - -
Remplacer...Avec...
new Integer(1).toString()Integer.toString(1)
new Long(1).toString()Long.toString(1)
new Float(1.0).toString()Float.toString(1.0)
new Double(1.0).toString()Double.toString(1.0)
new Byte(1).toString()Byte.toString(1)
new Short(1).toString()Short.toString(1)
Boolean.valueOf(true).toString()Boolean.toString(true)
- - -

Bx: Method invokes inefficient floating-point Number constructor; use static valueOf instead (DM_FP_NUMBER_CTOR)

- - -

- Using new Double(double) is guaranteed to always result in a new object whereas - Double.valueOf(double) allows caching of values to be done by the compiler, class library, or JVM. - Using of cached values avoids object allocation and the code will be faster. -

-

- Unless the class must be compatible with JVMs predating Java 1.5, - use either autoboxing or the valueOf() method when creating instances of Double and Float. -

- - -

Bx: Method invokes inefficient Number constructor; use static valueOf instead (DM_NUMBER_CTOR)

- - -

- Using new Integer(int) is guaranteed to always result in a new object whereas - Integer.valueOf(int) allows caching of values to be done by the compiler, class library, or JVM. - Using of cached values avoids object allocation and the code will be faster. -

-

- Values between -128 and 127 are guaranteed to have corresponding cached instances - and using valueOf is approximately 3.5 times faster than using constructor. - For values outside the constant range the performance of both styles is the same. -

-

- Unless the class must be compatible with JVMs predating Java 1.5, - use either autoboxing or the valueOf() method when creating instances of - Long, Integer, Short, Character, and Byte. -

- - -

Dm: The equals and hashCode methods of URL are blocking (DMI_BLOCKING_METHODS_ON_URL)

- - -

The equals and hashCode -method of URL perform domain name resolution, this can result in a big performance hit. -See http://michaelscharf.blogspot.com/2006/11/javaneturlequals-and-hashcode-make.html for more information. -Consider using java.net.URI instead. -

- - -

Dm: Maps and sets of URLs can be performance hogs (DMI_COLLECTION_OF_URLS)

- - -

This method or field is or uses a Map or Set of URLs. Since both the equals and hashCode -method of URL perform domain name resolution, this can result in a big performance hit. -See http://michaelscharf.blogspot.com/2006/11/javaneturlequals-and-hashcode-make.html for more information. -Consider using java.net.URI instead. -

- - -

Dm: La méthode invoque le constructeur inutile Boolean() ; utilisez Boolean.valueOf(...) à la place (DM_BOOLEAN_CTOR)

- - -

Créer de nouvelles instances de java.lang.Boolean gaspille la mémoire puisque les objets Boolean sont immuables et qu'il n'y a que deux valeurs utiles de ce type. Utilisez à la place la méthode Boolean.valueOf() pour créer des objets Boolean.

- - -

Dm: Ramasse-miettes explicite ; extrêmement douteux sauf dans du code de banc d'essai (DM_GC)

- - -

Le code appelle explicitement le ramasse-miettes. Mis à part l'emploi spécifique dans un banc d'essai, c'est très douteux.

-

Dans le passé, les cas où des personnes ont explicitement invoqué le ramasse-miettes dans des méthodes telles que close() ou finalize() ont creusés des gouffres dans les performances. Le ramasse-miettes peut-être très coûteux. Toute situation qui force des centaines ou des milliers de ramasse-miettes mettra à genoux une machine.

- - -

Dm: Méthode allouant un objet juste pour obtenir la classe (DM_NEW_FOR_GETCLASS)

- - -

Cette méthode alloue un objet juste pour appeler sa méthode getClass() afin d'obtenir l'objet Class correspondant. Il est plus simple d'accèder directement à la propriété .class de la classe.

- - -

Dm: Utiliser la méthode nextInt de Random plutôt que nextDouble pour générer un entier aléatoire (DM_NEXTINT_VIA_NEXTDOUBLE)

- - -

Si r est un java.util.Random, vous pouvez générer un nombre aléatoire entre 0 et n-1 en utilisant r.nextInt(n) plutôt que (int)(r.nextDouble() * n).

- - -

Dm: La méthode invoque le constructeur inutile String(String) ; utilisez juste l'argument (DM_STRING_CTOR)

- - -

Utiliser le constructeur java.lang.String(String) 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.

- - -

Dm: La méthode appel toString() sur un objet String ; utilisez directement l'objet String (DM_STRING_TOSTRING)

- - -

Appeler String.toString() est juste une opération redondante. Utilisez directement l'objet String.

- - -

Dm: La méthode invoque le constructeur inutile String() ; utilisez juste "" (DM_STRING_VOID_CTOR)

- - -

Créer un nouveau objet java.lang.String en utilisant le constructeur sans argument gaspille de la mémoire parce que l'objet ainsi créé serait fonctionnellement identique à la constante de chaîne vide "". Java garantie que les chaînes constantes identiques seront représentées par le même objet String. C'est pourquoi vous devriez directement utiliser la constante de chaîne vide.

- - -

HSC: Huge string constants is duplicated across multiple class files (HSC_HUGE_SHARED_STRING_CONSTANT)

- - -

- A large String constant is duplicated across multiple class files. - This is likely because a final field is initialized to a String constant, and the Java language - mandates that all references to a final field from other classes be inlined into -that classfile. See JDK bug 6447475 - for a description of an occurrence of this bug in the JDK and how resolving it reduced - the size of the JDK by 1 megabyte. -

- - -

SBSC: La méthode concatène des chaînes au moyen de + en boucle (SBSC_USE_STRINGBUFFER_CONCATENATION)

- - -

Cette méthode semble construire une String en utilisant une concaténation en boucle. A chaque itération, l'objet String est converti en StringBuffer/StringBuilder, complété, puis de nouveau converti en String. Ceci a un coût exponentiel en fonction du nombre d'itérations, puisque la chaîne est recopiée à chaque itération.

-

De meilleurs performances peuvent être obtenues en utilisant explicitement StringBuffer (ou StringBuilder en Java 5).

-

Par exemple :

-
-// C'est mal !
-String s = "";
-for (int i = 0; i < field.length; ++i) {
-  s = s + field[i];
-}
-
-// C'est mieux...
-StringBuffer buf = new StringBuffer();
-for (int i = 0; i < field.length; ++i) {
-  buf.append(field[i]);
-}
-String s = buf.toString();
-
- - -

SIC: Devrait être une classe interne statique (SIC_INNER_SHOULD_BE_STATIC)

- - -

Cette classe est une classe interne, mais n'utilise pas sa référence vers l'objet qui l'a créée. Cette référence rend les instances de cette classe plus grosses et peut garder active la référence à l'objet créateur plus longtemps que nécessaire. Si possible, la classe devrait être transformée en classe interne static.

- - -

SIC: Peut-être transformée en classe interne statique nommée (SIC_INNER_SHOULD_BE_STATIC_ANON)

- - -

Cette classe est une classe interne qui n'utilise pas sa référence vers l'objet qui l'a créée. Cette référence rend l'objet plus gros et peut garder active la référence de l'objet créateur plus longtemps que nécessaire. Si possible, la classe devrait être transformée en classe interne static. Puisque les classes anonymes ne peuvent pas être marquées comme static, il faudrait également nommer cette classe.

- - -

SIC: Pourrait-être transformée en classe interne statique (SIC_INNER_SHOULD_BE_STATIC_NEEDS_THIS)

- - -

Cette classe est une classe interne mais elle n'utilise pas sa référence vers l'objet qui l'a créée, à part durant la création de l'objet interne. Cette référence rend les instances de cette classe plus grosses et peut forcer à garder active la référence de l'objet créateur plus longtemps que nécessaire. Si possible, la classe devrait-être transformée en classe interne static. Puisque la référence à l'objet créateur est requise durant la construction de la classe interne, le constructeur de celle-ci devrait-être modifié afin d'accepter en argument cette référence.

- - -

SS: Champ non lu : devrait-il être statique ? (SS_SHOULD_BE_STATIC)

- - -

Cette classe contient un champ d'instance final qui est initialisé par une valeur statique déterminée à la compilation. Envisagez de rendre ce champ static.

- - -

UM: Appel d'une méthode statique de la classe Math sur une valeur constante (UM_UNNECESSARY_MATH)

- - -

Cette méthode utilise une méthode statique de java.lang.Math sur une valeur constante. Dans ce cas, le résultat de cet appel peut être déterminé statiquement, ce qui est plus rapide et souvent plus précis. Les méthodes détectées sont :

- - - - - - - - - - - - - - - - - - - - - - - - - -
MéthodeParamètre
abs-tous-
acos0.0 ou 1.0
asin0.0 ou 1.0
atan0.0 ou 1.0
atan20.0
cbrt0.0 ou 1.0
ceil-tous-
cos0.0
cosh0.0
exp0.0 ou 1.0
expm10.0
floor-tous-
log0.0 ou 1.0
log100.0 ou 1.0
rint-tous-
round-tous-
sin0.0
sinh0.0
sqrt0.0 ou 1.0
tan0.0
tanh0.0
toDegrees0.0 ou 1.0
toRadians0.0
- - -

UPM: Méthode privée jamais appelée (UPM_UNCALLED_PRIVATE_METHOD)

- - -

Cette méthode privée n'est jamais appelée. Bien qu'il soit possible que cette méthode soit appelée par réflexion, il y a plus de chances qu'elle ne soit jamais utilisée et qu'elle puisse être supprimée.

- - -

UrF: Champ inutilisé (URF_UNREAD_FIELD)

- - -

Ce champ n'est jamais lu. Envisagez de le supprimer de la classe.

- - -

UuF: Champ inutilisé (UUF_UNUSED_FIELD)

- - -

Ce champ n'est jamais utilisé. Envisagez de le supprimer de la classe.

- - -

WMI: Utilisation inefficace d'un itérateur sur keySet au lieu de entrySet (WMI_WRONG_MAP_ITERATOR)

- - -

Cette méthode accède à la valeur d'une entrée de Map au moyen d'une clé provenant d'un itérateur sur keySet. Il est plus efficace d'utiliser un itérateur sur l'entrySet de la Map, pour éviter la recherche par Map.get(clé).

- - -

Dm: Hardcoded constant database password (DMI_CONSTANT_DB_PASSWORD)

- - -

This code creates a database connect using a hardcoded, constant password. Anyone with access to either the source code or the compiled code can - easily learn the password. -

- - - -

Dm: Empty database password (DMI_EMPTY_DB_PASSWORD)

- - -

This code creates a database connect using a blank or empty password. This indicates that the database is not protected by a password. -

- - - -

HRS: HTTP cookie formed from untrusted input (HRS_REQUEST_PARAMETER_TO_COOKIE)

- - -

This code constructs an HTTP Cookie using an untrusted HTTP parameter. If this cookie is added to an HTTP response, it will allow a HTTP response splitting -vulnerability. See http://en.wikipedia.org/wiki/HTTP_response_splitting -for more information.

-

FindBugs looks only for the most blatant, obvious cases of HTTP response splitting. -If FindBugs found any, you almost certainly have more -vulnerabilities that FindBugs doesn't report. If you are concerned about HTTP response splitting, you should seriously -consider using a commercial static analysis or pen-testing tool. -

- - - -

HRS: HTTP Response splitting vulnerability (HRS_REQUEST_PARAMETER_TO_HTTP_HEADER)

- - -

This code directly writes an HTTP parameter to an HTTP header, which allows for a HTTP response splitting -vulnerability. See http://en.wikipedia.org/wiki/HTTP_response_splitting -for more information.

-

FindBugs looks only for the most blatant, obvious cases of HTTP response splitting. -If FindBugs found any, you almost certainly have more -vulnerabilities that FindBugs doesn't report. If you are concerned about HTTP response splitting, you should seriously -consider using a commercial static analysis or pen-testing tool. -

- - - -

PT: Absolute path traversal in servlet (PT_ABSOLUTE_PATH_TRAVERSAL)

- - -

The software uses an HTTP request parameter to construct a pathname that should be within a restricted directory, -but it does not properly neutralize absolute path sequences such as "/abs/path" that can resolve to a location that is outside of that directory. - -See http://cwe.mitre.org/data/definitions/36.html -for more information.

-

FindBugs looks only for the most blatant, obvious cases of absolute path traversal. -If FindBugs found any, you almost certainly have more -vulnerabilities that FindBugs doesn't report. If you are concerned about absolute path traversal, you should seriously -consider using a commercial static analysis or pen-testing tool. -

- - - -

PT: Relative path traversal in servlet (PT_RELATIVE_PATH_TRAVERSAL)

- - -

The software uses an HTTP request parameter to construct a pathname that should be within a restricted directory, but it does not properly neutralize sequences such as ".." that can resolve to a location that is outside of that directory. - -See http://cwe.mitre.org/data/definitions/23.html -for more information.

-

FindBugs looks only for the most blatant, obvious cases of relative path traversal. -If FindBugs found any, you almost certainly have more -vulnerabilities that FindBugs doesn't report. If you are concerned about relative path traversal, you should seriously -consider using a commercial static analysis or pen-testing tool. -

- - - -

SQL: Une chaîne non constante est passée à la méthode execute d'une commande SQL (SQL_NONCONSTANT_STRING_PASSED_TO_EXECUTE)

- - -

Cette méthode invoque la méthode execute d'une commande SQL (statement) avec une chaîne qui semble générée dynamiquement. Préférer la préparation de la commande avec un PreparedStatement, c'est plus efficace et bien moins vulnérable aux attaques par injection SQL (insertion de code SQL malveillant au sein d'une requête).

- - -

SQL: Une requète est préparée à partir d'une chaine non constante (SQL_PREPARED_STATEMENT_GENERATED_FROM_NONCONSTANT_STRING)

- - -

Ce code créé une requète SQL préparée à partir d'une chaine non constante. Les données qui permettent de construire cette chaine venant de l'utilisateur, elles pourraient, sans vérification, servir à faire de l'injection de SQL et ainsi modifier la requète afin qu'elle produise des résultats inattendus et indésirables.

- - -

XSS: JSP reflected cross site scripting vulnerability (XSS_REQUEST_PARAMETER_TO_JSP_WRITER)

- - -

This code directly writes an HTTP parameter to JSP output, which allows for a cross site scripting -vulnerability. See http://en.wikipedia.org/wiki/Cross-site_scripting -for more information.

-

FindBugs looks only for the most blatant, obvious cases of cross site scripting. -If FindBugs found any, you almost certainly have more cross site scripting -vulnerabilities that FindBugs doesn't report. If you are concerned about cross site scripting, you should seriously -consider using a commercial static analysis or pen-testing tool. -

- - -

XSS: Servlet reflected cross site scripting vulnerability in error page (XSS_REQUEST_PARAMETER_TO_SEND_ERROR)

- - -

This code directly writes an HTTP parameter to a Server error page (using HttpServletResponse.sendError). Echoing this untrusted input allows -for a reflected cross site scripting -vulnerability. See http://en.wikipedia.org/wiki/Cross-site_scripting -for more information.

-

FindBugs looks only for the most blatant, obvious cases of cross site scripting. -If FindBugs found any, you almost certainly have more cross site scripting -vulnerabilities that FindBugs doesn't report. If you are concerned about cross site scripting, you should seriously -consider using a commercial static analysis or pen-testing tool. -

- - - -

XSS: Servlet reflected cross site scripting vulnerability (XSS_REQUEST_PARAMETER_TO_SERVLET_WRITER)

- - -

This code directly writes an HTTP parameter to Servlet output, which allows for a reflected cross site scripting -vulnerability. See http://en.wikipedia.org/wiki/Cross-site_scripting -for more information.

-

FindBugs looks only for the most blatant, obvious cases of cross site scripting. -If FindBugs found any, you almost certainly have more cross site scripting -vulnerabilities that FindBugs doesn't report. If you are concerned about cross site scripting, you should seriously -consider using a commercial static analysis or pen-testing tool. -

- - - -

BC: Transtypage douteux d'un type Collection vers une classe abstraite (BC_BAD_CAST_TO_ABSTRACT_COLLECTION)

- - -

Ce code transtype un object de type Collection vers un type de collection abstrait (tel que Collection). Assurez vous que l'objet est bien du type précisé. Si vous désirez par exemple faire une itération sur une collection, le transtypage vers Set ou List est inutile.

- - -

BC: Transtypage douteux vers une collection concrète (BC_BAD_CAST_TO_CONCRETE_COLLECTION)

- - -

Ce code transtype une collection abstraite (telles que Collection, List, ou Set) vers une implémentation concrète spécifique (telles que ArrayList ou HashSet). Ceci n'est pas forcément correct, et peut rendre votre code plus fragile, puisqu'il un éventuel refactoring futur avec une autre implémentation concrète plus difficile. A défaut d'une raison valable, l'utilisation des classes abstraites est recommandée.

- - -

BC: Transtypage non vérifié/non confirmé (BC_UNCONFIRMED_CAST)

- - -

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.

- - -

BC: Unchecked/unconfirmed cast of return value from method (BC_UNCONFIRMED_CAST_OF_RETURN_VALUE)

- - -

-This code performs an unchecked cast of the return value of a method. -The code might be calling the method in such a way that the cast is guaranteed to be -safe, but FindBugs is unable to verify that the cast is safe. Check that your program logic ensures that this -cast will not fail. -

- - -

BC: instanceof renverra toujours vrai (BC_VACUOUS_INSTANCEOF)

- - -

Ce test instanceof renverra toujours vrai. Même s'il est sûr, assurez-vous qu'il ne s'agit pas d'une erreur logique ou d'une mauvaise compréhension.

- - -

BSHIFT: Décalage à droite non signé et transtypage short/byte (ICAST_QUESTIONABLE_UNSIGNED_RIGHT_SHIFT)

- - -

Le code effectue un décalage à droite non signé, dont le résultat est transtypé vers un short ou un byte, ce qui élimine les bits supérieurs du résultat. Puisque les bits supérieurs sont éliminés, il peut ne pas y avoir de différence entre un décalage à droite signé ou non signé (ceci dépend de la taille du décalage)

- - -

CI: Classe finale déclarant un champ protégé (CI_CONFUSED_INHERITANCE)

- - -

Cette classe est déclarée final mais comporte des champs protected. Cette classe étant finale, elle ne pourra jamais être dérivée et donc l'utilisation de protected est troublante. Le modificateur d'accès devrait être modifié à private ou public pour mettre en évidence la véritable utilisation du champ.

- - -

DB: Méthode utilisant le même code pour deux branches (DB_DUPLICATE_BRANCHES)

- - -

Cette méthode utilise le même code pour implémenter deux branches d'une condition. Vérifiez pour vous assurer que ce n'est pas une erreur de codage.

- - -

DB: Méthode utilisant le même code pour deux clauses switch (DB_DUPLICATE_SWITCH_CLAUSES)

- - -

Cette méthode utilise le même code pour implémenter deux cas différents d'un switch. Ce peut être normal mais il vaut mieux vérifier que ce n'est pas une erreur de codage.

- - -

DLS: Alimentation à perte d'une variable locale (DLS_DEAD_LOCAL_STORE)

- - -

Cette instruction assigne une valeur à une variable locale mais cette variable n'est pas lue par la suite. Ceci indique souvent une erreur puisque la valeur calculée n'est jamais utilisée.

-

Notez que le compilateur javac de Sun génère fréquemment ce genre d'affectations à perte. FindBugs analysant le byte-code généré, il n'y a pas de façon simple d'éliminer ces fausses alarmes.

- - -

DLS: Useless assignment in return statement (DLS_DEAD_LOCAL_STORE_IN_RETURN)

- - -

-This statement assigns to a local variable in a return statement. This assignment -has effect. Please verify that this statement does the right thing. -

- - -

DLS: Alimentation à null d'une variable (DLS_DEAD_LOCAL_STORE_OF_NULL)

- - -

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.

- - -

DLS: Dead store to local variable that shadows field (DLS_DEAD_LOCAL_STORE_SHADOWS_FIELD)

- - -

-This instruction assigns a value to a local variable, -but the value is not read or used in any subsequent instruction. -Often, this indicates an error, because the value computed is never -used. There is a field with the same name as the local variable. Did you -mean to assign to that variable instead? -

- - -

DMI: Chemin absolu codé en dur dans le code (DMI_HARDCODED_ABSOLUTE_FILENAME)

- - -

Ce code construit un objet File en utilisant un chemin absolu de fichier codé en dur (Ex. : new File("/home/dannyc/workspace/j2ee/src/share/com/sun/enterprise/deployment");).

- - -

DMI: Objet non sérialisable écrit dans un ObjectOutput (DMI_NONSERIALIZABLE_OBJECT_WRITTEN)

- - -

Ce code semble transmettre un objet non sérialisable à la méthode ObjectOutput.writeObject. Une erreur se produira si cet objet est effectivement non sérialisable.

- - -

DMI: Appel de substring(0) qui retourne la valeur originale (DMI_USELESS_SUBSTRING)

- - -

Ce code appelle substring(0) sur une chaine, ce qui renvoit la valeur originale.

- - -

Dm: Thread passed where Runnable expected (DMI_THREAD_PASSED_WHERE_RUNNABLE_EXPECTED)

- - -

A Thread object is passed as a parameter to a method where -a Runnable is expected. This is rather unusual, and may indicate a logic error -or cause unexpected behavior. -

- - -

Eq: Class doesn't override equals in superclass (EQ_DOESNT_OVERRIDE_EQUALS)

- - -

This class extends a class that defines an equals method and adds fields, but doesn't -define an equals method itself. Thus, equality on instances of this class will -ignore the identity of the subclass and the added fields. Be sure this is what is intended, -and that you don't need to override the equals method. Even if you don't need to override -the equals method, consider overriding it anyway to document the fact -that the equals method for the subclass just return the result of -invoking super.equals(o). -

- - -

Eq: Unusual equals method (EQ_UNUSUAL)

- - -

This class doesn't do any of the patterns we recognize for checking that the type of the argument -is compatible with the type of the this object. There might not be anything wrong with -this code, but it is worth reviewing. -

- - -

FE: Test d'égalité en virgule flottante. (FE_FLOATING_POINT_EQUALITY)

- - -

Cette opération teste l'égalité de deux valeurs en virgule flottante. Les calculs en virgule flottante pouvant introduire des arrondis, les valeurs flottantes ou doubles peuvent être imprécises. Pour les valeurs qui doivent être précises, telles que les valeurs monétaires, pensez à utiliser un type à précision fixe tel qu'un BigDecimal. Pour les valeurs qui n'ont pas besoin d'être précises, pensez à tester l'égalité sur une portée quelconque, par exemple : if ( Math.abs(x - y) < .0000001 ). Cf section 4.2.4 des spécifications du langage Java.

- - -

FS: Non-Boolean argument formatted using %b format specifier (VA_FORMAT_STRING_BAD_CONVERSION_TO_BOOLEAN)

- - -

-An argument not of type Boolean is being formatted with a %b format specifier. This won't throw an -exception; instead, it will print true for any non-null value, and false for null. -This feature of format strings is strange, and may not be what you intended. -

- - -

IA: Appel ambigu d'une méthode hérité ou externe (IA_AMBIGUOUS_INVOCATION_OF_INHERITED_OR_OUTER_METHOD)

- - -

Une classe interne invoque une méthode qui peut être résolue comme une méthode héritée ou comme une méthode définie dans une classe externe. La sémantique de Java fait qu'elle sera résolue en invoquant la méthode héritée, mais ce n'est peut être pas votre intention. Si vous souhaitez réellement invoquer la méthode héritée, faite le en utilisant super (Ex : appelé super.foo(17)) ce qui clarifiera votre code pour les autres lecteurs et pour FindBugs.

- - -

IC: Initialisation circulaire (IC_INIT_CIRCULARITY)

- - -

Une initialisation circulaire a été détectée dans les initialisations de variables statiques de deux classes référencées par l'instance en erreur. De nombreuses sortes de comportements inattendus peuvent surgir d'une telle situation.

- - -

ICAST: Résultat d'une division entière transtypé en nombre flottant (ICAST_IDIV_CAST_TO_DOUBLE)

- - -

Ce code transtype le résultat d'une division entière en un nombre flottant à double précision. Effectuer une division sur des nombres entiers n'est pas précis. Le fait que le résultat soit transtypé en double suggère que cette précision était voulue dès le départ. Peut être l'un ou l'autre des opérandes, ou les deux opérandes, auraient du être transtypé avant d'effectuer la division. Voici un exemple :

-
-
-int x = 2;
-int y = 5;
-// Faux: renvoi 0.0
-double value1 =  x / y;
-
-// Juste: renvoi 0.4
-double value2 =  x / (double) y;
-
-
- - -

ICAST: Résultat d'une multiplication entière transtypée en long (ICAST_INTEGER_MULTIPLY_CAST_TO_LONG)

- - -

Ce code effectue des multiplications entières et transtype le résultat en long, comme dans : -long convertDaysToMilliseconds(int days) { return 1000*3600*24*days; }. Si la multiplication était réalisée en utilisant l'arithmétique long, vous pourriez éviter le risque de débordement de capacité du calcul. Vous pouvez par exemple corriger le code précédent par : long convertDaysToMilliseconds(int days) { return 1000L*3600*24*days; } ou 

-static final long MILLISECONDS_PER_DAY = 24L*3600*1000;
-long convertDaysToMilliseconds(int days) { return days * MILLISECONDS_PER_DAY; } 
-

- - -

IM: Possibilité de débordement du calcul d'une moyenne (IM_AVERAGE_COMPUTATION_COULD_OVERFLOW)

- - -

Le code calcule la moyenne de deux entiers au moyen d'une division ou d'un décalage signé vers la droite, puis utilise le résultat comme indice d'un tableau. Si les valeurs moyennées sont très grandes, le calcul peut déborder (résultant en un très grand négatif). En supposant que le résultat doive toujours être positif, vous devriez plutôt utiliser un décalage à droite non signé. En d'autres termes, utilisez plutôt (low+high) >>> 1 au lieu de (low+high)/2.

-

Le bug existe dans de nombreuses implémentations des recherches binaires et des tris fusion. Martin Buchholz l'a recherché et corrigé dans les librairies du JDK et Joshua Bloch a largement publié ce modèle de bug.

- - -

IM: Test d'impaire ne fonctionnant pas avec les négatifs (IM_BAD_CHECK_FOR_ODD)

- - -

Le code utilise x % 2 == 1 pour véifier si une valeur est impaire, mais cela ne fonctionera pas avec une valeur négative (Ex. : (-5) % 2 == -1). Si ce code doit tester si une valeur est impaire, envisagez d'utiliser x & 1 == 1 ou x % 2 != 0.

- - -

INT: Reste entier modulo 1 (INT_BAD_REM_BY_1)

- - -

Cette expression (Ex. : exp % 1) est assurée de toujours renvoyer 0. Vouliez-vous plutot dire (exp & 1) ou (exp % 2) ?

- - -

INT: Vacuous bit mask operation on integer value (INT_VACUOUS_BIT_OPERATION)

- - -

This is an integer bit operation (and, or, or exclusive or) that doesn't do any useful work -(e.g., v & 0xffffffff). - -

- - -

INT: Comparaison inutile de valeurs entières (INT_VACUOUS_COMPARISON)

- - -

Il y a une comparaison entière qui renvoie toujours la même valeur (Ex. : x <= Integer.MAX_VALUE).

- - -

MTIA: La classe hérite de Servlet et utilise les variables de l'instance. (MTIA_SUSPECT_SERVLET_INSTANCE_FIELD)

- - -

Cette classe hérite de la classe Servlet, et utilise une variable de l'instance. Puisqu'une seule instance d'une classe Servlet est créée par le cadre de travail J2EE, et est utilisée dans un environnement multitâche, ce paradigme est très fortement découragé et très certainement problématique. Considérer l'emploi seul de variables propres à la méthode.

- - -

MTIA: La classe hérite d'une classe action Struts et utilise les variables de l'instance. (MTIA_SUSPECT_STRUTS_INSTANCE_FIELD)

- - -

Cette classe hérite d'une classe Action Struts, et utilise une variable de cette instance. Puisqu'une seule instance de la classe Action Struts est créée par le cadre de travail Struts, et est utilisée dans un environnement multitâche, ce paradigme est très fortement découragé et très certainement problématique. Considérer l'emploi seul de variables propres à la méthode.

- - -

NP: Dereference of the result of readLine() without nullcheck (NP_DEREFERENCE_OF_READLINE_VALUE)

- - -

The result of invoking readLine() is dereferenced without checking to see if the result is null. If there are no more lines of text -to read, readLine() will return null and dereferencing that will generate a null pointer exception. -

- - -

NP: Déréférencement immédiat du résultat d'un readLine() (NP_IMMEDIATE_DEREFERENCE_OF_READLINE)

- - -

Le résultat d'un appel à readLine() est immédiatement déréférencé. S'il n'y a plus d'autre lignes de texte à lire, readLine() retournera null ce qui provoquera une NullPointerException lors du déréférencement.

- - -

NP: Chargement d'une valeur connue pour être à null (NP_LOAD_OF_KNOWN_NULL_VALUE)

- - -

La variable référencée est connue pour être à null suite à une vérification précédente. Bien que cela soit valide, ce peut être une erreur (peut-être vouliez-vous référencer une autre valeur ou le test précédent aurait-il due vérifier non-null plutôt que null).

- - -

NP: Method tightens nullness annotation on parameter (NP_METHOD_PARAMETER_TIGHTENS_ANNOTATION)

- -

- A method should always implement the contract of a method it overrides. Thus, if a method takes a parameter - that is marked as @Nullable, you shouldn't override that method in a subclass with a method where that parameter is @Nonnull. - Doing so violates the contract that the method should handle a null parameter. -

- -

NP: Method relaxes nullness annotation on return value (NP_METHOD_RETURN_RELAXING_ANNOTATION)

- -

- A method should always implement the contract of a method it overrides. Thus, if a method takes is annotated - as returning a @Nonnull value, - you shouldn't override that method in a subclass with a method annotated as returning a @Nullable or @CheckForNull value. - Doing so violates the contract that the method shouldn't return null. -

- -

NP: Pointeur à null renvoyé par une méthode qui risque d'être déréférencé (NP_NULL_ON_SOME_PATH_FROM_RETURN_VALUE)

- - -

La valeur renvoyée par une méthode est déréférencée alors que cette méthode peut renvoyer null. Ceci peut conduire à une NullPointerException quand le code sera exécuté.

- - -

NP: Possible null pointer dereference on branch that might be infeasible (NP_NULL_ON_SOME_PATH_MIGHT_BE_INFEASIBLE)

- - -

There is a branch of statement that, if executed, guarantees that -a null value will be dereferenced, which -would generate a NullPointerException when the code is executed. -Of course, the problem might be that the branch or statement is infeasible and that -the null pointer exception can't ever be executed; deciding that is beyond the ability of FindBugs. -Due to the fact that this value had been previously tested for nullness, -this is a definite possibility. -

- - -

NP: Parameter must be non-null but is marked as nullable (NP_PARAMETER_MUST_BE_NONNULL_BUT_MARKED_AS_NULLABLE)

- - -

This parameter is always used in a way that requires it to be non-null, -but the parameter is explicitly annotated as being Nullable. Either the use -of the parameter or the annotation is wrong. -

- - -

NP: Read of unwritten public or protected field (NP_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD)

- - -

The program is dereferencing a public or protected -field that does not seem to ever have a non-null value written to it. -Unless the field is initialized via some mechanism not seen by the analysis, -dereferencing this value will generate a null pointer exception. -

- - -

NS: Potentially dangerous use of non-short-circuit logic (NS_DANGEROUS_NON_SHORT_CIRCUIT)

- - -

This code seems to be using non-short-circuit logic (e.g., & -or |) -rather than short-circuit logic (&& or ||). In addition, -it seem possible that, depending on the value of the left hand side, you might not -want to evaluate the right hand side (because it would have side effects, could cause an exception -or could be expensive.

-

-Non-short-circuit logic causes both sides of the expression -to be evaluated even when the result can be inferred from -knowing the left-hand side. This can be less efficient and -can result in errors if the left-hand side guards cases -when evaluating the right-hand side can generate an error. -

- -

See the Java -Language Specification for details. - -

- - -

NS: Utilisation discutable de logique binaire (NS_NON_SHORT_CIRCUIT)

- - -

Ce code semble utiliser de la logique binaire (Ex. : & ou |) plutôt que les opérateurs booléens (&& ou ||). La logique binaire entraîne l'évaluation systématique de toute l'expression, même quand le résultat pourrait être immédiatement déduit. Ceci est moins performant et peut provoquer des erreurs lorsque la partie gauche de l'expression masque des cas de la partie droite.

- - -

PZLA: Envisagez de renvoyer un tableau vide plutôt que null (PZLA_PREFER_ZERO_LENGTH_ARRAYS)

- - -

Renvoyer un tableau vide constitue souvent une meilleure approche plutôt que de renvoyer une référence à null pour signaler qu'il n'y a pas de résultat (c'est-à-dire, une liste vide de résultats). De cette façon, aucune vérification explicite du null n'est nécessaire dans les méthodes clientes.

-

D'un autre côté, utiliser null signifie "il n'y a pas de réponse à cette question". Cela peut donc être approprié. Par exemple, File.listFiles() renvoi une liste vide si un répertoire donné ne contient pas de fichiers, et renvoi null si le fichier n'est pas un répertoire.

- - -

QF: Incrémentation compliquée, subtile au incorrecte dans une boucle for (QF_QUESTIONABLE_FOR_LOOP)

- - -

Etes vous certain que cette boucle incrémente la variable voulue ? Il sembleraît qu'une autre variable est initialisée et vérifiée par la boucle.

- - -

RCN: Comparaison redondante d'une valeur non nulle avec null (RCN_REDUNDANT_COMPARISON_OF_NULL_AND_NONNULL_VALUE)

- - -

Cette méthode contient une comparaison entre une référence connue pour être non nulle avec une autre référence connue pour être à null.

- - -

RCN: Comparaison redondante de deux valeurs nulles (RCN_REDUNDANT_COMPARISON_TWO_NULL_VALUES)

- - -

Cette méthode contient une comparaison redondante entre deux références connues pour être obligatoirement à null.

- - -

RCN: Test de nullité redondant sur une valeur non nulle (RCN_REDUNDANT_NULLCHECK_OF_NONNULL_VALUE)

- - -

Cette méthode contient un test redondant de nullité sur une valeur connue pour être non nulle.

- - -

RCN: Test de nullité redondant sur une valeur connue pour être à null (RCN_REDUNDANT_NULLCHECK_OF_NULL_VALUE)

- - -

Cette méthode contient un test redondant de nullité sur une valeur ne pouvant qu'être à null.

- - -

REC: java.lang.Exception est intercepté alors qu'Exception n'est jamais lancé (REC_CATCH_EXCEPTION)

- - -

Cette méthode utilise un block try-catch qui intercepte les objets Exception, mais Exception n'est jamais déclenché dans ce bloc, et RuntimeException n'est pas explicitement intercepté. C'est une erreur commune de dire que try / catch (Exception e) est identique à plusieurs try / catch, mais cette tournure intercepte également les RuntimeException, masquant des bugs potentiels.

- - -

RI: Classe implémentant la même interface que sa super-classe (RI_REDUNDANT_INTERFACES)

- - -

Cette classe déclare implémenter une interface qui est aussi implémentée par une de ses classes mères. Ceci est redondant : dès qu'une super-classe implémente une interface, toutes les sous-classes le font aussi par défaut. Cela peut indiquer que la hiérarchie d'héritage a changé depuis la création de cette classe et la cible de l'implémentation de l'interface doit peut-être être reprise en considération.

- - -

RV: Méthode vérifiant que le résultat d'un String.indexOf() est positif (RV_CHECK_FOR_POSITIVE_INDEXOF)

- - -

La méthode appelle String.indexOf() et vérifie si le résultat est strictement positif ou pas. Il est plus habituel de vérifier si le résultat est négatif. Il n'est strictement positif que lorsque la sous-chaine recherchée apparaît ailleurs qu'au début de la chaine.

- - -

RV: Méthode ignorant le résultat d'un readLine() après avoir vérifié qu'il est non nul (RV_DONT_JUST_NULL_CHECK_READLINE)

- - -

La valeur renvoyée par readLine() est ignorée après avoir vérifié s'il n'est pas à null. Dans quasiment tous les cas, si le résultat n'est pas à null, vous souhaiterez utiliser cette valeur. Appeler de nouveau readLine() vous renverra une ligne différente.

- - -

RV: Reste d'un hashCode pouvant être négatif (RV_REM_OF_HASHCODE)

- - -

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.

-

En supposant que vous vouliez garantir que le résultat de votre opération ne soit pas négatif, vous devriez modifier votre code. Si le diviseur est une puissance de 2, vous pourriez utiliser un décalage binaire à la place (c'est-à-dire x.hashCode()&(n-1) au lieu de x.hashCode()%n). 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 (Math.abs(x.hashCode()%n)).

- - -

RV: Reste d'un entier signé 32 bits aléeatoire (RV_REM_OF_RANDOM_INT)

- - -

Ce code génère un entier signé aléatoire puis calcule le reste de cette valeur modulo une autre valeur. Puisque ce nombre aléatoire peut être négatif, le reste de l'opération peut également l'être. Soyez sûr que c'est voulu, et envisagez d'utiliser à la place la méthode Random.nextInt(int).

- - -

RV: Method ignores return value, is this OK? (RV_RETURN_VALUE_IGNORED_INFERRED)

- - -

This code calls a method and ignores the return value. The return value -is the same type as the type the method is invoked on, and from our analysis it looks -like the return value might be important (e.g., like ignoring the -return value of String.toLowerCase()). -

-

We are guessing that ignoring the return value might be a bad idea just from -a simple analysis of the body of the method. You can use a @CheckReturnValue annotation -to instruct FindBugs as to whether ignoring the return value of this method -is important or acceptable. -

-

Please investigate this closely to decide whether it is OK to ignore the return value. -

- - -

RV: Return value of method without side effect is ignored (RV_RETURN_VALUE_IGNORED_NO_SIDE_EFFECT)

- - -

This code calls a method and ignores the return value. However our analysis shows that -the method (including its implementations in subclasses if any) does not produce any effect -other than return value. Thus this call can be removed. -

-

We are trying to reduce the false positives as much as possible, but in some cases this warning might be wrong. -Common false-positive cases include:

-

- The method is designed to be overridden and produce a side effect in other projects which are out of the scope of the analysis.

-

- The method is called to trigger the class loading which may have a side effect.

-

- The method is called just to get some exception.

-

If you feel that our assumption is incorrect, you can use a @CheckReturnValue annotation -to instruct FindBugs that ignoring the return value of this method is acceptable. -

- - -

SA: Double assignment of field (SA_FIELD_DOUBLE_ASSIGNMENT)

- - -

This method contains a double assignment of a field; e.g. -

-
-  int x,y;
-  public void foo() {
-    x = x = 17;
-  }
-
-

Assigning to a field twice is useless, and may indicate a logic error or typo.

- - -

SA: Double assignment of local variable (SA_LOCAL_DOUBLE_ASSIGNMENT)

- - -

This method contains a double assignment of a local variable; e.g. -

-
-  public void foo() {
-    int x,y;
-    x = x = 17;
-  }
-
-

Assigning the same value to a variable twice is useless, and may indicate a logic error or typo.

- - -

SA: Auto-alimentation d'une variable locale (SA_LOCAL_SELF_ASSIGNMENT)

- - -

Cette méthode contient une auto-alimentation d'une variable locale, par exemple :

-
-public vida foo() {
-  int x = 3;
-  x = x;
-}
-
-

De telles affectations sont inutiles et peuvent indiquer une faute de frappe ou une erreur de logique.

- - -

SF: Un switch comporte un cas qui déborde sur le suivant (SF_SWITCH_FALLTHROUGH)

- - -

Cette méthode contient un switch dont l'un des cas déborde sur le suivant. Normalement, vous devez terminer chaque cas avec une instruction break ou return.

- - -

SF: Switch statement found where default case is missing (SF_SWITCH_NO_DEFAULT)

- - -

This method contains a switch statement where default case is missing. - Usually you need to provide a default case.

-

Because the analysis only looks at the generated bytecode, this warning can be incorrect triggered if -the default case is at the end of the switch statement and the switch statement doesn't contain break statements for other -cases. - - -

ST: Ecriture d'un champ statique depuis la méthode d'une instance (ST_WRITE_TO_STATIC_FROM_INSTANCE_METHOD)

- - -

La méthode de l'instance écrit la valeur d'un champ statique. Cela peut être difficile à gérer si plusieurs instances ont la possibilité d'écrire cette valeur et cela ressemble surtout à une mauvaise pratique.

- - -

Se: Private readResolve method not inherited by subclasses (SE_PRIVATE_READ_RESOLVE_NOT_INHERITED)

- - -

This class defines a private readResolve method. Since it is private, it won't be inherited by subclasses. -This might be intentional and OK, but should be reviewed to ensure it is what is intended. -

- - -

Se: Transient field of class that isn't Serializable. (SE_TRANSIENT_FIELD_OF_NONSERIALIZABLE_CLASS)

- - -

The field is marked as transient, but the class isn't Serializable, so marking it as transient -has absolutely no effect. -This may be leftover marking from a previous version of the code in which the class was transient, or -it may indicate a misunderstanding of how serialization works. -

- - -

TQ: Value required to have type qualifier, but marked as unknown (TQ_EXPLICIT_UNKNOWN_SOURCE_VALUE_REACHES_ALWAYS_SINK)

- - -

- A value is used in a way that requires it to be always be a value denoted by a type qualifier, but - there is an explicit annotation stating that it is not known where the value is required to have that type qualifier. - Either the usage or the annotation is incorrect. -

- - -

TQ: Value required to not have type qualifier, but marked as unknown (TQ_EXPLICIT_UNKNOWN_SOURCE_VALUE_REACHES_NEVER_SINK)

- - -

- A value is used in a way that requires it to be never be a value denoted by a type qualifier, but - there is an explicit annotation stating that it is not known where the value is prohibited from having that type qualifier. - Either the usage or the annotation is incorrect. -

- - -

UC: Condition has no effect (UC_USELESS_CONDITION)

- - -

This condition always produces the same result as the value of the involved variable that was narrowed before. -Probably something else was meant or the condition can be removed.

- - -

UC: Condition has no effect due to the variable type (UC_USELESS_CONDITION_TYPE)

- - -

This condition always produces the same result due to the type range of the involved variable. -Probably something else was meant or the condition can be removed.

- - -

UC: Useless object created (UC_USELESS_OBJECT)

- - -

Our analysis shows that this object is useless. -It's created and modified, but its value never go outside of the method or produce any side-effect. -Either there is a mistake and object was intended to be used or it can be removed.

-

This analysis rarely produces false-positives. Common false-positive cases include:

-

- This object used to implicitly throw some obscure exception.

-

- This object used as a stub to generalize the code.

-

- This object used to hold strong references to weak/soft-referenced objects.

- - -

UC: Useless object created on stack (UC_USELESS_OBJECT_STACK)

- - -

This object is created just to perform some modifications which don't have any side-effect. -Probably something else was meant or the object can be removed.

- - -

UC: Useless non-empty void method (UC_USELESS_VOID_METHOD)

- - -

Our analysis shows that this non-empty void method does not actually perform any useful work. -Please check it: probably there's a mistake in its code or its body can be fully removed. -

-

We are trying to reduce the false positives as much as possible, but in some cases this warning might be wrong. -Common false-positive cases include:

-

- The method is intended to trigger loading of some class which may have a side effect.

-

- The method is intended to implicitly throw some obscure exception.

- - -

UCF: Instruction de contrôle du flux inutile (UCF_USELESS_CONTROL_FLOW)

- - -

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 :

-
-if (argv.length == 1);
-    System.out.println("Hello, " + argv[0]);
-
- - -

UCF: Useless control flow to next line (UCF_USELESS_CONTROL_FLOW_NEXT_LINE)

- - -

This method contains a useless control flow statement in which control -flow follows to the same or following line regardless of whether or not -the branch is taken. -Often, this is caused by inadvertently using an empty statement as the -body of an if statement, e.g.:

-
-    if (argv.length == 1);
-        System.out.println("Hello, " + argv[0]);
-
- - -

UrF: Unread public/protected field (URF_UNREAD_PUBLIC_OR_PROTECTED_FIELD)

- - -

This field is never read.  -The field is public or protected, so perhaps - it is intended to be used with classes not seen as part of the analysis. If not, -consider removing it from the class.

- - -

UuF: Unused public or protected field (UUF_UNUSED_PUBLIC_OR_PROTECTED_FIELD)

- - -

This field is never used.  -The field is public or protected, so perhaps - it is intended to be used with classes not seen as part of the analysis. If not, -consider removing it from the class.

- - -

UwF: Champ non initialisé dans le constructeur (UWF_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR)

- - -

Ce champ n'est jamais initialisé dans aucun constructeur, et est de ce fait null 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.

- - -

UwF: Unwritten public or protected field (UWF_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD)

- - -

No writes were seen to this public/protected field.  All reads of it will return the default -value. Check for errors (should it have been initialized?), or remove it if it is useless.

- - -

XFB: Méthode instanciant directement une implémentation spécifique des interfaces XML (XFB_XML_FACTORY_BYPASS)

- - -

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. :

-

-

    -
  • javax.xml.parsers.DocumentBuilderFactory
    • -
  • javax.xml.parsers.SAXParserFactory
    • -
  • javax.xml.transform.TransformerFactory
    • -
  • org.w3c.dom.Document.createXXXX
    • -
-

-
-
-
- - - diff --git a/index.html b/index.html index a094e05..99899e5 100644 --- a/index.html +++ b/index.html @@ -38,7 +38,7 @@

SpotBugs checks for more than 400 bug patterns. Bug descriptions can be found here

-

Descriptions are also available in Japanese and French

+

Descriptions are also available in Japanese

Using SpotBugs

diff --git a/ja/manual/acknowledgments.html b/ja/manual/acknowledgments.html deleted file mode 100644 index 2adcb03..0000000 --- a/ja/manual/acknowledgments.html +++ /dev/null @@ -1,132 +0,0 @@ - - - 第14章 謝辞
第14章 謝辞
戻る   

第14章 謝辞

目次

1. 貢献者
2. 使用しているソフトウェア

1. 貢献者

FindBugs was originally written by Bill Pugh (). -David Hovemeyer () implemented some of the -detectors, added the Swing GUI, and is a co-maintainer.

Mike Fagan () contributed the Ant build script, -the Ant task, and several enhancements and bug fixes to the GUI.

Germano Leichsenring contributed Japanese translations of the bug -summaries.

David Li contributed the Emacs bug report format.

Peter D. Stout contributed recursive detection of Class-Path -attributes in analyzed Jar files, German translations of -text used in the Swing GUI, and other fixes.

Peter Friese wrote the FindBugs Eclipse plugin.

Rohan Lloyd contributed several Mac OS X enhancements, -bug detector improvements, -and maintains the Fink package for FindBugs.

Hiroshi Okugawa translated the FindBugs manual and -more of the bug summaries into Japanese.

Phil Crosby enhanced the Eclipse plugin to add a view -to display the bug details.

Dave Brosius fixed a number of bugs, added user preferences -to the Swing GUI, improved several bug detectors, and -contributed the string concatenation detector.

Thomas Klaeger contributed a number of bug fixes and -bug detector improvements.

Andrey Loskutov made a number of bug fixes and -bug detector improvements. He is maintainer of the Eclipse plugin.

Brian Goetz contributed a major refactoring of the -visitor classes to improve readability and understandability.

Pete Angstadt fixed several problems in the Swing GUI.

Francis Lalonde provided a task resource file for the -FindBugs Ant task.

Garvin LeClaire contributed support for output in -Xdocs format, for use by Maven.

Holger Stenzhorn contributed improved German translations of items -in the Swing GUI.

Juha Knuutila contributed Finnish translations of items -in the Swing GUI.

Tanel Lebedev contributed Estonian translations of items -in the Swing GUI.

Hanai Shisei (ruimo) contributed full Japanese translations of -bug messages, and text used in the Swing GUI.

David Cotton contributed Fresh translations for bug -messages and for the Swing GUI.

Michael Tamm contributed support for the "errorProperty" attribute -in the Ant task.

Thomas Kuehne improved the German translation of the Swing GUI.

Len Trigg improved source file support for the Emacs output mode.

Greg Bentz provided a fix for the hashcode/equals detector.

K. Hashimoto contributed internationalization fixes and several other - bug fixes.

- Glenn Boysko contributed support for ignoring specified local - variables in the dead local store detector. -

- Jay Dunning contributed a detector to find equality comparisons - of floating-point values, and overhauled the analysis summary - report and its representation in the saved XML format. -

- Olivier Parent contributed updated French translations for bug descriptions and - Swing GUI. -

- Chris Nappin contributed the plain.xsl - stylesheet. -

- Etienne Giraudy contributed the fancy.xsl and fancy-hist.xsl - stylesheets, and made improvements to the -xml:withMessages - option. -

- Takashi Okamoto fixed bugs in the project preferences dialog - in the Eclipse plugin, and contributed to its internationalization and localization. -

Thomas Einwaller fixed bugs in the project preferences dialog in the Eclipse plugin.

Jeff Knox contributed support for the warningsProperty attribute -in the Ant task.

Peter Hendriks extended the Eclipse plugin preferences, -and fixed a bug related to renaming the Eclipse plugin ID.

Mark McKay contributed an Ant task to launch the findbugs frame.

Dieter von Holten (dvholten) contributed -some German improvements to findbugs_de.properties.

If you have contributed to FindBugs, but aren't mentioned above, -please send email to (and also accept -our humble apologies).

2. 使用しているソフトウェア

FindBugs は、いくつかのオープンソースソフトウェアパッケージを使用しています。これらがなければ、 FindBugs の開発は、より一層困難なものになったことでしょう。

2.1. BCEL

FindBugs includes software developed by the Apache Software Foundation -(http://www.apache.org/). -Specifically, it uses the Byte Code -Engineering Library.

2.2. ASM

FindBugs uses the ASM -bytecode framework, which is distributed under the following license:

-Copyright (c) 2000-2005 INRIA, France Telecom -All rights reserved. -

-Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions -are met: -

  1. - Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. -

  2. - Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. -

  3. - Neither the name of the copyright holders nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. -

-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE -LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF -THE POSSIBILITY OF SUCH DAMAGE. -

2.3. DOM4J

FindBugs uses DOM4J, which is -distributed under the following license:

-Copyright 2001 (C) MetaStuff, Ltd. All Rights Reserved. -

-Redistribution and use of this software and associated documentation -("Software"), with or without modification, are permitted provided that -the following conditions are met: -

  1. - Redistributions of source code must retain copyright statements and - notices. Redistributions must also contain a copy of this document. -

  2. - Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. -

  3. - The name "DOM4J" must not be used to endorse or promote products - derived from this Software without prior written permission - of MetaStuff, Ltd. For written permission, please contact - . -

  4. - Products derived from this Software may not be called "DOM4J" nor may - "DOM4J" appear in their names without prior written permission of - MetaStuff, Ltd. DOM4J is a registered trademark of MetaStuff, Ltd. -

  5. - Due credit should be given to the DOM4J Project (http://dom4j.org/). -

-THIS SOFTWARE IS PROVIDED BY METASTUFF, LTD. AND CONTRIBUTORS ``AS IS'' -AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL METASTUFF, LTD. OR ITS -CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, -EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, -PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR -PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF -LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING -NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS -SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -

戻る   
第13章 ライセンス ホーム 
\ No newline at end of file diff --git a/ja/manual/analysisprops.html b/ja/manual/analysisprops.html deleted file mode 100644 index 3c20bd1..0000000 --- a/ja/manual/analysisprops.html +++ /dev/null @@ -1,15 +0,0 @@ - - - 第9章 分析プロパティー
第9章 分析プロパティー
戻る   次へ

第9章 分析プロパティー

FindBugs は分析する場合にいくつかの観点を持っています。そして、観点をカスタマイズして実行することができます。システムプロパティーを使って、それらのオプションを設定します。この章では、分析オプションの設定方法を説明します。

分析オプションの主な目的は、 2 つあります。1 番目は、 FindBugs に対して分析されるアプリケーションのメソッドの意味を伝えることです。そうすることで FindBugs がより正確な結果を出すことができ、誤検出を減らすことができます。2 番目に、分析を行うに当たりその精度を設定できるようにすることです。分析の精度を落とすことで、メモリ使用量と分析時間を減らすことができます。ただし、本当のバグを見逃したり、誤検出の数が増えるという代償があります。

コマンドラインオプション -property を使って、分析オプションを設定することができます。次に、例を示します:

-$ findbugs -textui -property "cfg.noprune=true" myApp.jar
-

-

設定することができる分析オプションの一覧を 表9.1「設定可能な分析プロパティー」 に示します。

表9.1 設定可能な分析プロパティー

プロパティー名設定値目的
findbugs.assertionmethodsコンマ区切りの完全修飾メソッド名リスト : 例、 "com.foo.MyClass.checkAssertion"このプロパティーには、プログラムが正しいことをチェックするために使われるメソッドを指定します。これらのメソッドを指定することで、 チェックメソッドで確認した値に対する null 参照アクセスディテクタの誤検出を回避できます。
findbugs.de.commenttrue または falsetrue に設定すると、 DroppedException (無視された例外) ディテクタは空の catch ブロック にコメントが無いか探します。そして、コメントがみつかった場合には警告が報告されません。
findbugs.maskedfields.localstrue または falsetrue に設定すると、フィールドを隠蔽しているローカル変数に対して優先度(低)の警告が発行されます。デフォルトは、 false です。
findbugs.nullderef.assumensptrue または false使用されません。 (意図 : true に設定すると、null 参照アクセスディテクタはメソッドからの戻り値、または、メソッドに受け渡される引数を null であると仮定します。デフォルトは、 false です。このプロパティーを有効にすると、大量の誤検出が生成されるであろうことに注意してください。)
findbugs.refcomp.reportAlltrue または falsetrue に設定すると、 == および != 演算子を使っている疑わしい参照比較がすべて報告されます。 false に設定すると、同様の警告は 1 メソッドにつき 1 つしか発行されません。デフォルトは、 false です。
findbugs.sf.commenttrue または falsetrue に設定すると、 SwitchFallthrough ディテクタはソースコードに「fall」または「nobreak」という単語を含んだコメントを記載していない caseラベル に限り警告を報告します。(この機能が正しく動作するためには、正確なソースパスが必要です。) これにより、意図的ではない switch 文の fallthrough を発見し易くなります。

戻る   次へ
第8章 フィルターファイル ホーム 第10章 アノテーション
\ No newline at end of file diff --git a/ja/manual/annotations.html b/ja/manual/annotations.html deleted file mode 100644 index 8735f92..0000000 --- a/ja/manual/annotations.html +++ /dev/null @@ -1,87 +0,0 @@ - - - 第10章 アノテーション
第10章 アノテーション
戻る   次へ

第10章 アノテーション

FindBugs はいくつかのアノテーションをサポートしています。開発者の意図を明確にすることで、 FindBugs はより的確に警告を発行することができます。アノテーションを使用するためには Java 5 が必要であり、 annotations.jar および jsr305.jar ファイルをコンパイル時のクラスパスに含める必要があります。

edu.umd.cs.findbugs.annotations.CheckForNull

- [Target] Field, Method, Parameter -

アノテーションをつけた要素は、 null である可能性があります。したがって、当該要素を使用する際は null チェックをするべきです。このアノテーションをメソッドに適用すると、メソッドの戻り値に適用されます。

edu.umd.cs.findbugs.annotations.CheckReturnValue

- [Target] Method, Constructor -

[Parameter]

- priority: 警告の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。

- explanation:戻り値をチェックしなけばならない理由をテキストで説明します。デフォルト値 :""。

このアノテーションを使用して、呼出し後に戻り値をチェックすべきメソッドを表すことができます。

edu.umd.cs.findbugs.annotations.DefaultAnnotation

- [Target] Type, Package -

[Parameter]

- value:アノテーションクラスのclassオブジェクト。複数のクラスを指定することができます。

- priority:省略時の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。

-クラスまたはパッケージのすべてのメンバーが指定されたアノテーションクラスのデフォルト値でアノテートされることを指定することができます。 -この指定は @NonNull 、 @CheckForNull 、または @CheckReturnValueなどに使用する想定です。 -具体的には、 クラスまたはパッケージに @DefaultAnnotation(NonNull.class) を指定した上で、 -null を許容したいパラメーター、メソッドまたはフィールドにのみ @Nullable を指定するという使用方法があります。 -

edu.umd.cs.findbugs.annotations.DefaultAnnotationForFields

- [Target] Type, Package -

[Parameter]

- value:アノテーションクラスのclassオブジェクト。複数のクラスを指定することができます。

- priority:省略時の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。

-フィールドのみに適用されること以外は DefaultAnnotation と同様です。 -

edu.umd.cs.findbugs.annotations.DefaultAnnotationForMethods

- [Target] Type, Package -

[Parameter]

- value:アノテーションクラスのclassオブジェクト。複数のクラスを指定することができます。

- priority:省略時の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。

-メソッドのみに適用されること以外は DefaultAnnotation と同様です。 -

edu.umd.cs.findbugs.annotations.DefaultAnnotationForParameters

- [Target] Type, Package -

[Parameter]

- value:アノテーションクラスのclassオブジェクト。複数のクラスを指定することができます。

- priority:省略時の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。

-パラメーターのみに適用されること以外は DefaultAnnotation と同様です。 -

edu.umd.cs.findbugs.annotations.NonNull

- [Target] Field, Method, Parameter -

アノテーションをつけた要素は、 null であってはいけません。アノテーションをつけたフィールドは、構築完了後 null であってはいけません。アノテーションをつけたメソッドは、 null ではない値を戻り値としなければなりません。

edu.umd.cs.findbugs.annotations.Nullable

- [Target] Field, Method, Parameter -

-アノテーションをつけた要素は、 条件により null である可能性があります。 -一般に、開発者はドキュメントを読んで null 値を許容するかどうかまたは null 値をチェックするかどうかを決定する必要があります。 -FindBugs はこのアノテーションをつけた要素を、アノテーションがついていないものと同様に扱います。 -

-実際には、このアノテーションは NonNull をつけた要素をオーバーライドする場合に有用です。 -

edu.umd.cs.findbugs.annotations.OverrideMustInvoke

- [Target] Method -

[Parameter]

- value:super の呼び出し箇所を指定します (FIRST, ANYTIME, LAST)。 デフォルト値 :ANYTIME。 -

-オーバーライドされた場合にオーバーライドメソッド内で super を呼び出すべきメソッドにアノテートします。 -例えば、 finalize() や clone() がそのようなメソッドに該当します。 -引数は、 super の呼び出し箇所を指定します。すなわち、随時、メソッドの最初またはメソッドの最後です。 -

edu.umd.cs.findbugs.annotations.PossiblyNull

-非推奨です。 CheckForNull を使用してください。 -

edu.umd.cs.findbugs.annotations.SuppressWarnings

- [Target] Type, Field, Method, Parameter, Constructor, Package -

[Parameter]

- value:警告の名称。複数の名称を指定することができます。 -

- justification:警告を無視する理由。 デフォルト値 :""。

-The set of warnings that are to be suppressed by the compiler in the annotated element. -Duplicate names are permitted. The second and successive occurrences of a name are ignored. -The presence of unrecognized warning names is not an error: Compilers -must ignore any warning names they do not recognize. They are, however, free to emit a -warning if an annotation contains an unrecognized warning name. Compiler vendors should -document the warning names they support in conjunction with this annotation type. They -are encouraged to cooperate to ensure that the same names work across multiple compilers. -

edu.umd.cs.findbugs.annotations.UnknownNullness

- [Target] Field, Method, Parameter -

-Used to indicate that the nullness of the target is unknown, or my vary in unknown ways in subclasses. -

edu.umd.cs.findbugs.annotations.UnknownNullness

- [Target] Field, Method, Parameter -

-Used to indicate that the nullness of the target is unknown, or my vary in unknown ways in subclasses. -

また、 FindBugs 次に示すアノテーションもサポートしています。 :

  • net.jcip.annotations.GuardedBy

  • net.jcip.annotations.Immutable

  • net.jcip.annotations.NotThreadSafe

  • net.jcip.annotations.ThreadSafe

-

Java Concurrency in Practice の API ドキュメント を参照してください。

戻る   次へ
第9章 分析プロパティー ホーム 第11章 rejarForAnalysis の使用方法
\ No newline at end of file diff --git a/ja/manual/anttask.html b/ja/manual/anttask.html deleted file mode 100644 index b266641..0000000 --- a/ja/manual/anttask.html +++ /dev/null @@ -1,80 +0,0 @@ - - - 第6章 FindBugs™ Ant タスクの使用方法
第6章 FindBugs™ Ant タスクの使用方法
戻る   次へ

第6章 FindBugs™ Ant タスクの使用方法

目次

1. Ant タスクのインストール
2. build.xml の書き方
3. タスクの実行
4. パラメーター

この章では、 FindBugs を Ant のビルドスクリプトに組み入れる方法について説明します。 Ant は、ビルドや配備を行うことができる Java でよく使用されるツールです。FindBugs Ant タスクを使用すると、 ビルドスクリプトを作成して機械的に FindBugs による Java コードの分析を実行することができます。

この Ant タスクは、 Mike Fagan 氏の多大な貢献によるものです。

1. Ant タスクのインストール

Ant タスクのインストールは、 $FINDBUGS_HOME/lib/findbugs-ant.jar を Ant インストールディレクトリーのlib サブディレクトリーにコピーするだけです。

[注記]注記

使用する Ant タスクと FindBugs 本体は、同梱されていた同じバージョンのものを使用することを強く推奨します。別のバージョンの FindBugs に含まれていた Ant タスク Jar ファイルでの動作は保証しません。

-

2. build.xml の書き方

FindBugs を build.xml (Ant ビルドスクリプト) に組み入れるためにはまず、タスク定義を記述する必要があります。タスク定義は次のように記述します。:

-  <taskdef name="findbugs" classname="edu.umd.cs.findbugs.anttask.FindBugsTask"/>
-

タスク定義は、 findbugs 要素を build.xml 上に記述したとき、そのタスクの実行に使用されるクラスを指定します。

タスク定義の記述をすれば、findbugs タスクを使ってターゲットを定義できます。次に示すのは、 Apache BCEL ライブラリーを分析する場合を想定した build.xml の記述例です。

-  <property name="findbugs.home" value="/export/home/daveho/work/findbugs" />
-
-  <target name="findbugs" depends="jar">
-    <findbugs home="${findbugs.home}"
-              output="xml"
-              outputFile="bcel-fb.xml" >
-      <auxClasspath path="${basedir}/lib/Regex.jar" />
-      <sourcePath path="${basedir}/src/java" />
-      <class location="${basedir}/bin/bcel.jar" />
-    </findbugs>
-  </target>
-

findbugs 要素には、 home 属性が必須です。 FindBugs のインストールディレクトリーすなわち $FINDBUGS_HOME の値を設定します。2章FindBugs™ のインストール を参照してください。

このターゲットは bcel.jar に対して FindBugs を実行します。この Jar ファイルは、 BCEL ビルドスクリプトによって作成されるものです。(上記のターゲットが「jar」ターゲットに依存している (depends) と設定することにより、 FindBugs が実行される前に当該ライブラリーが完全にコンパイルされていることを保証しています。) FindBugs の出力は、 XML 形式で bcel-fb.xml ファイルに保存されます。補助 Jar ファイル Regex.jar を aux classpath に記述しています。なぜなら、当該 Jar ファイルが BCEL メイン･ライブラリーから参照されるからです。source path を指定することで、保存されるバグデータに BCEL ソースコードへの正確な参照が記述されます。

3. タスクの実行

コマンドラインから Ant を起動する例を次に示します。前述の findbugs ターゲットを使用しています。

-  [daveho@noir]$ ant findbugs
-  Buildfile: build.xml
-
-  init:
-
-  compile:
-
-  examples:
-
-  jar:
-
-  findbugs:
-   [findbugs] Running FindBugs...
-   [findbugs] Bugs were found
-   [findbugs] Output saved to bcel-fb.xml
-
-  BUILD SUCCESSFUL
-  Total time: 35 seconds
-

この事例においては、XML ファイルでバグ検索結果を保存しているので、 FindBugs GUI を使って結果を参照することができます。 4章FindBugs™ の実行 を参照してください。

4. パラメーター

このセクションでは、 FindBugs タスクを使用する際に、指定することができるパラメーターについて説明します。 - -

class

任意指定のネストされる要素です。分析の対象となるクラス群を指定します。 - class 要素には location 属性の指定が必須です。 - 分析対象となるアーカイブファイル (jar, zip, 他)、ディレクトリーまたはクラスファイルの名前を記述します。 - 1 つの findbugs 要素に対して、複数の class 子要素を指定することができます。 -

class 要素の指定を置き換えるまたは追加する形で、 FindBugs タスクに1個以上の fileset 要素を記述することで - 分析するファイル群を指定することができます。 - 例えば、 fileset において特定のディレクトリにある全ての jar ファイルを分析対象に指定することができます。 -

auxClasspath

任意指定のネストされる要素です。分析対象のライブラリーまたはアプリケーションによって使用されているが分析の対象にはしたくないクラスを含んでいるクラスパス (Jar ファイルまたはディレクトリー) を指定します。 Ant の Java タスクにある classpath 要素 と同じ方法で指定することができます。

sourcePath

任意指定のネストされる要素です。分析対象 Java コードのコンパイル時に使用したソースファイルを含んでいるソースディレクトリーへのパスを指定します。ソースパスを指定することにより、生成される XML のバグ出力結果に完全なソース情報をもたせることができ、後になって GUI で参照することができます。

home

必須属性です。FindBugs がインストールされているディレクトリー名を設定します。

quietErrors

任意指定のブール値属性です。true を設定すると、深刻な分析エラー発生やクラスがみつからないといった情報が FindBugs 出力に記録されません。デフォルトは、 false です。

reportLevel

- 任意指定の属性です。報告される問題の信頼度・優先度のしきい値を指定します。 - 「low」に設定すると、バグ報告が信頼度により除外されることはありません。 - 「medium」 (デフォルト) に設定すると、信頼度(低)の問題が除外されます。 - 「high」に設定すると、信頼度(高) のバグのみが報告されます。 -

output

任意指定の属性です。出力形式を指定します。「xml」 (デフォルト) に設定すると、出力は XML 形式になります。「xml:withMessages」 に設定すると、出力は人間が読めるメッセージ が追加された XML 形式になります。(XSL スタイルシートを使ってレポートを作成することを計画している場合はこの形式を使用してください。) 「html」に設定すると、出力は HTML 形式(デフォルトのスタイルシートは default.xsl) になります。 「text」に設定すると、出力は特別なテキスト形式になります。「emacs」に設定すると、出力は Emacs エラーメッセージ形式になります。「xdocs」に設定すると、出力は Apache Maven で使用できる xdoc XML になります。

stylesheet

任意指定の属性です。output 属性 に html を指定した場合に、 HTML 出力作成に使用されるスタイルシートを指定します。FindBugs 配布物に含まれているスタイルシートは、 default.xsl、 fancy.xsl 、 fancy-hist.xsl 、 plain.xsl および summary.xsl です。デフォルト値は default.xsl です。

sort

任意指定の属性です。output 属性に「text」を指定した場合に、バグの報告をクラス順にソートするかどうかを sort 属性で指定します。デフォルトは、 true です。

outputFile

任意指定の属性です。指定した場合、FindBugs の出力はその名前のファイルへと保存されます。省略時、出力は Ant によって直接表示されます。

debug

任意指定のブール値属性です。true に設定すると、 FindBugs は 診断情報を出力します。どのクラスを分析しているか、どのパグパターンディテクタが実行されているか、という情報が表示されます。デフォルトは、 false です。

effort

分析の活動レベルを設定します。min 、default または max のいずれかの値を設定してください。分析レベルの設定に関する詳細情報は、 「コマンドラインオプション」 を参照してください。

conserveSpace

effort="min" と同義です。

workHard

effort="max" と同義です。

visitors

任意指定の属性です。どのバグディテクタを実行するかをコンマ区切りのリストで指定します。バグディテクタはパッケージ指定なしのクラス名で指定します。省略時、デフォルトで無効化されているものを除くすべてのディテクタが実行されます。

omitVisitors

- 任意指定の属性です。 - バグディテクタをコンマ区切りのリストで指定します。 - visitors 属性と似ていますが、こちらは 実行されない ディテクタを指定します。 -

chooseVisitors

- 任意指定の属性です。 - 頭に「+」または「-」を付け加えたバグディテクタをコンマ区切りのリストで指定します。 - 「+」を付け加えたバグディテクタは有効に、「-」を付け加えたバグディテクタは無効になります。 -

excludeFilter

任意指定の属性です。フィルターファイル名を指定します。報告から除外されるバグを指定します。8章フィルターファイル を参照してください。

includeFilter

任意指定の属性です。フィルターファイル名を指定します。報告されるバグを指定します。8章フィルターファイル を参照してください。

projectFile

任意指定の属性です。プロジェクトファイル名を指定します。プロジェクトファイルは、 FindBugs GUI で作成します。分析されるクラス、および、補助クラスパス、ソースディレクトリーが記入されてます。プロジェクトファイルを指定した場合は、 class 要素・ auxClasspath 属性および sourcePath 属性を設定する必要はありません。プロジェクトの作成方法は、 4章FindBugs™ の実行 を参照してください。

jvmargs

任意指定の属性です。FindBugs を実行している Java 仮想マシンに対して受け渡される引数を指定します。巨大なプログラムを分析する場合に、 JVM が使用するメモリ容量を増やす指定をするためにこの引数を利用する必要があるかもしれません。

systemProperty

任意指定のネストされる要素です。指定した場合、Java システムプロパティーを定義します。name 属性にはシステムプロパティーの名前を指定します。そして、 value 属性にはシステムプロパティの値を指定します。

timeout

任意指定の属性です。FindBugs を実行している Java プロセス の実行許容時間をミリ秒単位で指定します。時間を超過するとハングアップしていると判断してプロセスが終了されます。デフォルトは、 600,000 ミリ秒 (10 分) です。巨大なプログラムの場合は、 FindBugs が分析を完了するまでに 10 分 以上掛かる可能性があることに注意してください。

failOnError

任意指定のブール値属性です。FindBugs の実行中にエラーがあった場合に、ビルドプロセス自体を打ち切って異常終了させるかどうかを指定します。デフォルトは、「false」です。

errorProperty

任意指定の属性です。FindBugs の実行中にエラーが発生した場合に、「true」が設定されるプロパティーの名前を指定します。

warningsProperty

任意指定の属性です。FindBugs が分析したプログラムにバグ報告が 1 件でもある場合に、「true」が設定されるプロパティーの名前を指定します。

userPreferencesFile

- 任意指定の属性です。 - ユーザー設定ファイルのパスを設定します。ユーザー設定ファイルの内容で、他のオプションの一部を上書きすることができます。 - userPreferencesFile を一番目の引数に指定した場合は、後続のオプションの方がユーザー設定ファイルの内容に優先します。 - userPreferencesFile を最後の引数に指定した場合は、ユーザー設定ファイルの内容の方が前に指定したオプションに優先します。 - このオプションを設けた背景・理由は、 Eclipse プロジェクトの FindBugs の設定をコマンドライン実行で再利用するためです。 -

nested

- 任意指定の属性です。分析対象のファイル・ディレクトリーリストにあるファイル内にネストされた jar および zip ファイルに対する分析を有効化・無効化します。 - デフォルトでは、ネストされた jar/zip の分析は有効です。 -

- - -

戻る   次へ
第5章 FindBugs GUI の使用方法 ホーム 第7章 FindBugs™ Eclipse プラグインの使用方法
\ No newline at end of file diff --git a/ja/manual/building.html b/ja/manual/building.html deleted file mode 100644 index 39fefb1..0000000 --- a/ja/manual/building.html +++ /dev/null @@ -1,49 +0,0 @@ - - - 第3章 FindBugs™ のソールからのビルド
第3章 FindBugs™ のソールからのビルド
戻る   次へ

第3章 FindBugs™ のソールからのビルド

目次

1. 前提条件
2. ソース配布物の展開
3. local.properties の修正
4. Ant の実行
5. ソースディレクトリーからの FindBugs™ の実行

この章では、 FindBugs をソースコードからビルドする方法を説明します。FindBugs を修正することに興味がないのであれば、 次の章 に進んでください。

1. 前提条件

ソースから FindBugs をコンパイルするためには、以下のものが必要です。

-

[警告]警告

Redhat Linux システムの /usr/bin/ant に同梱されている Ant のバージョンでは、 FindBugs のコンパイルはうまくできません。Ant web サイトからバイナリ配布物をダウンロードしてインストールすることを推奨します。Ant を実行する場合は、 環境変数 JAVA_HOME が JDK 1.5 (またはそれ以降)をインストールしたディレクトリーを指していることを確認してください。

体裁の整った FindBugs のドキュメントを生成したい場合は、以下のソフトウェアも必要となります:

-

2. ソース配布物の展開

ソース配布物をダウンロードした後に、それを作業用ディレクトリーに展開する必要があります。通常は、次のようなコマンドで展開を行います:

-$ unzip findbugs-3.1.0-dev-20161105-d07b50f-source.zip
-

- -

3. local.properties の修正

FindBugs のドキュメントをビルドするためには、 local.properties ファイルを修正する必要があります。このファイルは、 FindBugs をビルドする際に Ant build.xml ファイルが参照します。FindBugs のドキュメントをビルドしない場合は、このファイルは無視してもかまいません。

local.properties での定義は、 build.properties ファイルでの定義に優先します。build.properties は次のような内容です:

-
-# User Configuration:
-# This section must be modified to reflect your system.
-
-local.software.home     =/export/home/daveho/linux
-
-# Set this to the directory containing the DocBook Modular XSL Stylesheets
-#  from http://docbook.sourceforge.net/projects/xsl/
-
-xsl.stylesheet.home     =${local.software.home}/docbook/docbook-xsl-1.71.1
-
-# Set this to the directory where Saxon (http://saxon.sourceforge.net/)
-# is installed.
-
-saxon.home              =${local.software.home}/java/saxon-6.5.5
-
-

-

xsl.stylesheet.home プロパティーには、DocBook Modular XSL スタイルシートがインストールしてあるディレクトリーの絶対パスを指定します。FindBugs ドキュメントを生成しようと考えている場合にのみ、このプロパティーを指定する必要があります。

saxon.home プロパティーには、Saxon XSLT プロセッサーがインストールしてあるディレクトリーの絶対パスを指定します。FindBugs ドキュメントを生成しようと考えている場合にのみ、このプロパティーを指定する必要があります。

4. Ant の実行

ソース配布物の展開、 Ant のインストール、build.properties(local.properties) の修正 (これは任意) およびツール (Saxon など)の環境構築ができれば、 FindBugs をビルドするための準備は完了です。Ant の起動する方法は、単にコマンドを実行するだけです。

-$ ant target
-

target には以下のいずれかを指定します:

build

このターゲットは、 FindBugs のコードをコンパイルします。これは、デフォルトのターゲットです。

docs

このターゲットは、ドキュメントの整形を行います(また、副作用としていくつかのソースのコンパイルも行います。)

runjunit

このターゲットは、コンパイルを行い FindBugs が持っている JUnit テストを実行します。ユニットテストが失敗した場合は、エラーメッセージが表示されます。

bindist

FindBugs のバイナリ配布物を構築します。このターゲットは、 .zip および .tar.gz のアーカイブをそれぞれ作成します。

-

Ant コマンドの実行後、次のような出力が表示されるはずです。 (この前に Ant が実行したタスクに関するメッセージもいくらか出力されます。):

-
-BUILD SUCCESSFUL
-Total time: 17 seconds
-
-

-

5. ソースディレクトリーからの FindBugs™ の実行

build ターゲットの実行が終了すると、バイナリ配布物と同様の状態が作業ディレクトリーに構築されるように FindBugs のAnt ビルドスクリプトは記述されています。したがって、4章FindBugs™ の実行 の FindBugs の実行に関する情報はソース配布物の場合にも応用できます。

戻る   次へ
第2章 FindBugs™ のインストール ホーム 第4章 FindBugs™ の実行
\ No newline at end of file diff --git a/ja/manual/datamining.html b/ja/manual/datamining.html deleted file mode 100644 index 0918efd..0000000 --- a/ja/manual/datamining.html +++ /dev/null @@ -1,289 +0,0 @@ - - - 第12章 FindBugs™ によるデータ・マイニング
第12章 FindBugs™ によるデータ・マイニング
戻る   次へ

第12章 FindBugs™ によるデータ・マイニング

目次

1. コマンド
2. 例
3. Ant の例

バグデータベースへの高機能の問い合わせ機能、および、調査対象のコードの複数のバージョンにわたる警告の追跡記録機能を、 FindBugs は内蔵しています。これらを使って次のようなことができます。すなわち、いつバグが最初持ち込まれたかを捜し出すこと、最終リリース以後持ち込まれた警告の分析を行うこと、または、無限再起ループの数を時間軸でグラフにすることです。

これらの技術は、 FindBugs が警告の保存に使う XML 書式を使用します。これらの XML ファイルは、通常、特定の 1 分析に対する警告が入れられています。しかしそれらには、一連のソフトウェアのビルドやバージョンに対する分析結果を格納することもできます。

すべての FindBugs XML バグデータベースには、バージョン名とタイム・スタンプ が入れられています。FindBugs は分析が行われるファイルの更新時刻からタイム・スタンプを計算します (例えば、タイム・スタンプはクラスファイルの生成時刻になるようになっています。分析が行われた時刻ではありません) 。各々のバグデータベースには、バージョン名も入れられています。バージョン名とタイム・スタンプは、 setBugDatabaseInfo (「setBugDatabaseInfo」) コマンドを使用して手動で設定することもできます。

複数バージョンを格納するバグデータベースにおいては、分析されるコードの各バージョンごとにシーケンス番号が割り当てられます。これらのシーケンス番号は単に 0 から始まる連続する整数値です (例えば、 4 つのコードバージョンを格納するバグデータベースには、バージョン 0~3 が入れられます) 。バグデータベースにはまた、各バージョンの名前とタイム・スタンプがそれぞれ記録されます。filterBugs コマンドを使用すると、シーケンス番号、バージョン名またはタイム・スタンプからバージョンを参照することができます。

1 バージョンを格納するバグデータベースの集合から、 1 個の複数バージョンバグデータベースを作成することができます。また、複数バージョンバグデータベースに対して、それ以後に作成された 1 バージョンのバグデータベースを結合することができます。

これらのコマンドのいくつかは、 ant タスクとして実行することができます。コマンドの実行方法および属性・引数の詳細は、以下を参照してください。以下のすべての例においては、 findbugs.lib refid が正しく設定されていることを前提としています。設定方法の一例を次に示します :

-
-   <!-- findbugs タスク定義 -->
-   <property name="findbugs.home" value="/your/path/to/findbugs" />
-   <path id="findbugs.lib">
-      <fileset dir="${findbugs.home}/lib">
-         <include name="findbugs-ant.jar"/>
-      </fileset>
-   </path>
-
-

1. コマンド

FindBugs データ・マイニング ツールはすべてコマンドラインから実行することができます。また、いくつかのより有用なコマンドは、 ant ビルドファイルから実行することができます。

コマンドラインツールについて簡単に説明します :

unionBugs

別のクラスに対する別個の分析結果を結合します。

computeBugHistory

複数バージョンから得られた複数のバグ警告を、マージして 1 個の複数バージョンバグデータベースにします。これを使って、既存の複数バージョンバグデータベースに更にバージョンを追加したり、 1 バージョンを格納するバグデータベースの集合から 1 個の複数バージョンバグデータベースを作成したり、できます。

setBugDatabaseInfo

リビジョン名やタイム・スタンプなどの情報を XML データベースに設定します。

listBugDatabaseInfo

XML データベースにあるリビジョン名やタイム・スタンプなどの情報を一覧表示します。

filterBugs

バグデータベースの部分集合を選択します。

mineBugHistory

複数バージョンバグデータベースの各バージョン毎の警告数を一覧にした表を作成します。

defectDensity

プロジェクト全体およびクラス毎・パッケージ毎の不良密度 (1000 NCSS 毎の警告数) に関する情報を一覧表示します。

convertXmlToText

XML 形式のバグ警告を、 1 行 1 バグのテキスト形式、または、HTML形式に変換します。

1.1. unionBugs

分析するのにアプリケーションの jar ファイルを分割している場合、このコマンドを使用することで、別個に生成された XML バグ警告ファイルをすべての警告を含んでいる 1 つの ファイルにすることができます。

同じファイルの異なるバージョンを分析した結果を結合する場合は、このコマンドを使用しないでください。代わりに computeBugHistory を使用してください。

XML ファイルは、コマンドラインで指定してください。結果は、標準出力に送られます。

1.2. computeBugHistory

このコマンドを使用することで、分析するソフトウェアの異なるビルドまたはバージョンの情報を含むバグデータベースを生成することができます入力として提供したファイルの 1 番目のファイルから履歴が取得されます。後に続くファイルは 1 バージョンのバグデータベースであるようにしてください (もし、履歴を持っていたとしても無視されます) 。

デフォルトでは、結果は標準出力に送られます。

この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに computeBugHistory を taskdef で定義します :

-
-<taskdef name="computeBugHistory" classname="edu.umd.cs.findbugs.anttask.ComputeBugHistoryTask">
-    <classpath refid="findbugs.lib" />
-</taskdef>
-
-

この ant タスクに指定できる属性を、下表に一覧で示します。入力ファイルを指定するには、 <datafile> 要素を入れ子にして入れてください。次に、例を示します:

-
-<computeBugHistory home="${findbugs.home}" ...>
-    <datafile name="analyze1.xml"/>
-    <datafile name="analyze2.xml"/>
-</computeBugHistory>
-
-

表12.1 computeBugHistory コマンドのオプション一覧

コマンドラインオプションAnt 属性目的
-output <file>output="<file>"出力結果を保存するファイル名を指定します。 (同時に入力ファイルにもなりえます)
-overrideRevisionNames[:truth]overrideRevisionNames="[true|false]"ファイル名から算出されるそれぞれのバージョン名を指定変更します。
-noPackageMoves[:truth]noPackageMoves="[true|false]"パッケージを移動したクラスがある場合、当該クラスの警告は別の存在として扱われます。
-preciseMatch[:truth]preciseMatch="[true|false]"バグパターンが正確に一致することを要求します。
-precisePriorityMatch[:truth]precisePriorityMatch="[true|false]"優先度が正確に一致した場合のみ警告が同一であると判断されます。
-quiet[:truth]quiet="[true|false]"エラーが発生しない限り、標準出力には何も表示されません。
-withMessages[:truth]withMessages="[true|false]"出力 XML に人間が読むことができるバグメッセージが含まれます。

1.3. filterBugs

このコマンドを使用することで、 FindBugs XML 警告ファイルから一部分を選び出して新規 FindBugs 警告ファイルに選択された部分を書き込むことができます。

このコマンドには、オプション群に続いて 0 個から 2 個の findbugs xml バグファイルを指定することができます。

ファイル名をひとつも指定しない場合は、標準入力から読んで標準出力に出力されます。ファイル名を 1 個 指定した場合は、指定したファイルから読んで標準出力に出力されます。ファイル名を 2 個 指定した場合は、 1 番目に指定したファイルから読んで 2 番目に指定したファイルに出力されます。

この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに filterBugs を taskdef で定義します :

-
-<taskdef name="filterBugs" classname="edu.umd.cs.findbugs.anttask.FilterBugsTask">
-    <classpath refid="findbugs.lib" />
-</taskdef>
-
-

この ant タスクに指定できる属性を、下表に一覧で示します。入力ファイルを指定するには、 input 属性を使用するか、 <datafile> 要素を入れ子にして入れてください。次に、例を示します:

-
-<filterBugs home="${findbugs.home}" ...>
-    <datafile name="analyze.xml"/>
-</filterBugs>
-
-

表12.2 filterBugs コマンドのオプション一覧

コマンドラインオプションAnt 属性目的
 input="<file>"入力ファイルを指定します。
 output="<file>"出力ファイルを指定します。
-notnot="[true|false]"フィルターのスイッチを反転します。
-withSource[:truth]withSource="[true|false]"ソースが入手可能な警告のみ出力されます。
-exclude <filter file>exclude="<filter file>"フィルターに一致するバグが除外されます。
-include <filter file>include="<filter file>"フィルターに一致するバグのみを含まれます。
-annotation <text>annotation="<text>"手で入力した注釈に指定した文言を含む警告のみ出力されます。
-after <when>after="<when>"指定したバージョンより後に初めて出現した警告のみ出力されます。
-before <when>before="<when>"指定したバージョンより前に初めて出現した警告のみ出力されます。
-first <when>first="<when>"指定したバージョンに初めて出現した警告のみ出力されます。
-last <when>last="<when>"指定したバージョンが出現した最後である警告のみ出力されます。
-fixed <when>fixed="<when>"指定したバージョンの前回のバージョンが出現した最後である警告のみ出力されます。 (-last に優先します)。
-present <when>present="<when>"指定したバージョンに存在する警告のみ出力されます。
-absent <when>absent="<when>"指定したバージョンに存在しない警告のみ出力されます。
-active[:truth]active="[true|false]"最終通番に存在する警告のみ出力されます。
-introducedByChange[:truth]introducedByChange="[true|false]"存在するクラスの変更によってもたらされた警告のみ出力されます。
-removedByChange[:truth]removedByChange="[true|false]"存在するクラスの変更によって除去された警告のみ出力されます。
-newCode[:truth]newCode="[true|false]"新クラスの追加によってもたらされた警告のみ出力されます。
-removedCode[:truth]removedCode="[true|false]"クラスの削除によって除去された警告のみ出力されます。
-priority <level>priority="<level>"指定した優先度以上の優先度をもつ警告のみ出力されます。
-maxRank <rank>rank="[1..20]"allow only warnings with this rank or lower
-class <pattern>class="<class>"指定したパターンに一致する主クラスをもつ警告のみ出力されます。
-bugPattern <pattern>bugPattern="<pattern>"指定したパターンに一致するバグ種別をもつ警告のみ出力されます。
-category <category>category="<category>"指定した文字列で始まるカテゴリーの警告のみ出力されます。
-designation <designation>designation="<designation>"指定したバグ分類指定をもつ警告のみ出力されます。 (例、 -designation SHOULD_FIX)
-withMessages[:truth] withMessages="[true|false]"テキストメッセージを含んだ XML が生成されます。

1.4. mineBugHistory

このコマンドを使用することで、複数バージョンバグデータベースの各バージョン毎の警告数を一覧にした表を作成することができます。

この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに mineBugHistory を taskdef で定義します :

-
-<taskdef name="mineBugHistory" classname="edu.umd.cs.findbugs.anttask.MineBugHistoryTask">
-    <classpath refid="findbugs.lib" />
-</taskdef>
-
-

この ant タスクに指定できる属性を、下表に一覧で示します。入力ファイルを指定するには、 input 属性を使用するか、 <datafile> 要素を入れ子にして入れてください。次に、例を示します:

-
-<mineBugHistory home="${findbugs.home}" ...>
-    <datafile name="analyze.xml"/>
-</mineBugHistory>
-
-

表12.3 mineBugHistory コマンドのオプション一覧

コマンドラインオプションAnt 属性目的
 input="<file>"入力ファイルを指定します。
 output="<file>"出力ファイルを指定します。
-formatDatesformatDates="[true|false]"データがテキスト形式で描画されます。
-noTabsnoTabs="[true|false]"タブの代わりに複数スペースでカラムが区切られます (下記参照)。
-summarysummary="[true|false]"最新 10 件の変更の要約が出力されます。

-noTabs 出力を使うことで、固定幅フォントのシェルで読み易くなります。数値カラムは右寄せされるので、スペースがカラム値の前に挿入されます。また、このオプションを使用した場合、 -formatDates を指定したときに要約の日付を描画するのに空白が埋め込まれなくなります。

出力される表は、 (-noTabs が無ければ) タブ区切りで次に示すカラムから成ります :

表12.4 mineBugHistory 出力のカラム一覧

表題目的
seqシーケンス番号 (0 始まりの連続した整数値)
versionバージョン名
timeリリースされた日時
classes分析されたクラス数
NCSSコメント文を除いた命令数 (Non Commenting Source Statements)
added前回のバージョンに存在したクラスにおける新規警告数
newCode前回のバージョンに存在しなかったクラスにおける新規警告数
fixed現在のバージョンに存在するクラスにおける除去された警告数
removed現在のバージョンに存在しないクラスの前回のバージョンにおける警告数
retained現在のバージョンと前回のバージョンの両方に存在する警告の数
dead以前のバージョンに存在したが現在のバージョンにも直前のバージョンにも存在しない警告の数
active現在のバージョンに存在する警告総数

1.5. defectDensity

このコマンドを使用することで、プロジェクト全体およびクラス毎・パッケージ毎の不良密度 (1000 NCSS 毎の警告数) に関する情報を一覧表示できます。標準入力から読み込む場合はファイル指定なしで、そうでなければ、コマンドラインでファイルを指定して、このコマンドを実行します。

出力される表は、次に示すカラムから成ります。また、プロジェクト全体情報の行、および、4 個以上の警告を含んでいる各パッケージ情報または各クラス情報の行も出力されます。

表12.5 defectDensity 出力のカラム一覧

表題目的
kindプロジェクト (project)、パッケージ (package) またはクラス (class)
nameプロジェクト、パッケージまたはクラスの名前
density 1000 NCSS 毎の警告数
bugs警告数
NCSSコメント文を除いた命令数 (Non Commenting Source Statements)

1.6. convertXmlToText

このコマンドを使用することで、XML 形式のバグ警告を、 1 行 1 バグのテキスト形式、または、HTML形式に変換することができます。

この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに convertXmlToText を taskdef で定義します :

-
-<taskdef name="convertXmlToText" classname="edu.umd.cs.findbugs.anttask.ConvertXmlToTextTask">
-    <classpath refid="findbugs.lib" />
-</taskdef>
-
-

この ant タスクに指定できる属性を、下表に一覧で示します。

表12.6 convertXmlToText コマンドのオプション一覧

コマンドラインオプションAnt 属性目的
 input="<filename>"入力ファイルを指定します。
 output="<filename>"出力ファイルを指定します。
-longBugCodeslongBugCodes="[true|false]"2 文字のバグ略称の代わりに、省略なしのバグパターンコードを使用します。
 format="text"プレーンテキストの出力が作成されます。1 行につき 1 つのバグが出力されます。コマンドライン時のデフォルトです。
-html[:stylesheet]format="html:<stylesheet>"指定されたスタイルシートを使用して出力が作成されます (下記参照) 。省略した場合は、 default.xsl が使用されます。

-html/format オプションには、plain.xsl 、 default.xsl 、 fancy.xsl 、 fancy-hist.xsl または ユーザ自身が作成した XSL スタイルシートのいずれかを指定することができます。オプション名をよそに、 html 以外の形式を出力するスタイルシートを指定することもできます。FindBugs に含まれているスタイルシート(上述)以外のスタイルシートを使用する場合は、オプション -html/format で当該スタイルシートへのパスまたは URL を指定してください。

1.7. setBugDatabaseInfo

このコマンドを使用することで、指定したバグ警告にメタ情報を設定することができます。このコマンドには次に示すオプションがあります:

この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに setBugDatabaseInfo を taskdef で定義します :

-
-<taskdef name="setBugDatabaseInfo" classname="edu.umd.cs.findbugs.anttask.SetBugDatabaseInfoTask">
-    <classpath refid="findbugs.lib" />
-</taskdef>
-
-

この ant タスクに指定できる属性を、下表に一覧で示します。入力ファイルを指定するには、 input 属性を使用するか、 <datafile> 要素を入れ子にして入れてください。次に、例を示します:

-
-<setBugDatabaseInfo home="${findbugs.home}" ...>
-    <datafile name="analyze.xml"/>
-</setBugDatabaseInfo>
-
-

表12.7 setBugDatabaseInfo オプション一覧

コマンドラインオプションAnt 属性目的
 input="<file>"入力ファイルを指定します。
 output="<file>"出力ファイルを指定します。
-name <name>name="<name>"最新リビジョンの名前を設定します。
-timestamp <when>timestamp="<when>"最新リビジョンのタイム・スタンプを設定します。
-source <directory>source="<directory>"ソースを検索するディレクトリーを追加指定します。
-findSource <directory>findSource="<directory>"指定したディレクトリー内を検索して関連するソースの場所を追加します。
-suppress <filter file>suppress="<filter file>"指定したファイルに一致する警告を抑止します (以前に指定した抑止設定は置き換えられます)。
-withMessageswithMessages="[true|false]"XMLにテキストメッセージを追加します。
-resetSourceresetSource="[true|false]"ソース検索パスをすべて削除します。

1.8. listBugDatabaseInfo

このコマンドの実行においては、コマンドラインで 0 個以上の xml バグデータベースファイル名を指定します。ファイル名を1つも指定しなければ、標準出力から読み込みを行いテーブルのヘッダーは生成されません。

このコマンドには 1 つだけオプションがあります : -formatDates を指定するとテキスト形式でデータが描画されます。

出力される表は、各バグデータベースごとに行を持ち、次に示すカラムから成ります :

表12.8 listBugDatabaseInfo カラム一覧

カラム目的
versionバージョン名
timeリリースされた日時
classes分析されたクラス数
NCSSコメント文を除いた命令数 (Non Commenting Source Statements)
total全警告数
high優先度(高)の警告の総数
medium優先度(中)の警告の総数
low優先度(低)の警告の総数
filenameデータベースのファイル名

2. 例

2.1. 提供されたシェル・スクリプトを使用しての履歴マイニング

以下はすべて、 jdk1.6.0-b12, jdk1.6.0-b13, ..., jdk1.6.0-b60 のディレクトリに対してコマンドを実行しています。

以下のコマンドを実行してみます :

-computeBugHistory jdk1.6.0-b* | filterBugs -bugPattern IL_ | mineBugHistory -formatDates
-

すると、次のような出力が行われます :

-seq	version	time	classes	NCSS	added	newCode	fixed	removed	retained	dead	active
-0	jdk1.6.0-b12	"Thu Nov 11 09:07:20 EST 2004"	13128	811569	0	4	0	0	0	0	4
-1	jdk1.6.0-b13	"Thu Nov 18 06:02:06 EST 2004"	13128	811570	0	0	0	0	4	0	4
-2	jdk1.6.0-b14	"Thu Dec 02 06:12:26 EST 2004"	13145	811786	0	0	2	0	2	0	2
-3	jdk1.6.0-b15	"Thu Dec 09 06:07:04 EST 2004"	13174	811693	0	0	1	0	1	2	1
-4	jdk1.6.0-b16	"Thu Dec 16 06:21:28 EST 2004"	13175	811715	0	0	0	0	1	3	1
-5	jdk1.6.0-b17	"Thu Dec 23 06:27:22 EST 2004"	13176	811974	0	0	0	0	1	3	1
-6	jdk1.6.0-b19	"Thu Jan 13 06:41:16 EST 2005"	13176	812011	0	0	0	0	1	3	1
-7	jdk1.6.0-b21	"Thu Jan 27 05:57:52 EST 2005"	13177	812173	0	0	0	0	1	3	1
-8	jdk1.6.0-b23	"Thu Feb 10 05:44:36 EST 2005"	13179	812188	0	0	0	0	1	3	1
-9	jdk1.6.0-b26	"Thu Mar 03 06:04:02 EST 2005"	13199	811770	0	0	0	0	1	3	1
-10	jdk1.6.0-b27	"Thu Mar 10 04:48:38 EST 2005"	13189	812440	0	0	0	0	1	3	1
-11	jdk1.6.0-b28	"Thu Mar 17 02:54:22 EST 2005"	13185	812056	0	0	0	0	1	3	1
-12	jdk1.6.0-b29	"Thu Mar 24 03:09:20 EST 2005"	13117	809468	0	0	0	0	1	3	1
-13	jdk1.6.0-b30	"Thu Mar 31 02:53:32 EST 2005"	13118	809501	0	0	0	0	1	3	1
-14	jdk1.6.0-b31	"Thu Apr 07 03:00:14 EDT 2005"	13117	809572	0	0	0	0	1	3	1
-15	jdk1.6.0-b32	"Thu Apr 14 02:56:56 EDT 2005"	13169	811096	0	0	0	0	1	3	1
-16	jdk1.6.0-b33	"Thu Apr 21 02:46:22 EDT 2005"	13187	811942	0	0	0	0	1	3	1
-17	jdk1.6.0-b34	"Thu Apr 28 02:49:00 EDT 2005"	13195	813488	0	1	0	0	1	3	2
-18	jdk1.6.0-b35	"Thu May 05 02:49:04 EDT 2005"	13457	829837	0	0	0	0	2	3	2
-19	jdk1.6.0-b36	"Thu May 12 02:59:46 EDT 2005"	13462	831278	0	0	0	0	2	3	2
-20	jdk1.6.0-b37	"Thu May 19 02:55:08 EDT 2005"	13464	831971	0	0	0	0	2	3	2
-21	jdk1.6.0-b38	"Thu May 26 03:08:16 EDT 2005"	13564	836565	0	0	0	0	2	3	2
-22	jdk1.6.0-b39	"Fri Jun 03 03:10:48 EDT 2005"	13856	849992	0	1	0	0	2	3	3
-23	jdk1.6.0-b40	"Thu Jun 09 03:30:28 EDT 2005"	15972	959619	0	2	0	0	3	3	5
-24	jdk1.6.0-b41	"Thu Jun 16 03:19:22 EDT 2005"	15972	959619	0	0	0	0	5	3	5
-25	jdk1.6.0-b42	"Fri Jun 24 03:38:54 EDT 2005"	15966	958581	0	0	0	0	5	3	5
-26	jdk1.6.0-b43	"Thu Jul 14 03:09:34 EDT 2005"	16041	960544	0	0	0	0	5	3	5
-27	jdk1.6.0-b44	"Thu Jul 21 03:05:54 EDT 2005"	16041	960547	0	0	0	0	5	3	5
-28	jdk1.6.0-b45	"Thu Jul 28 03:26:10 EDT 2005"	16037	960606	0	0	1	0	4	3	4
-29	jdk1.6.0-b46	"Thu Aug 04 03:02:48 EDT 2005"	15936	951355	0	0	0	0	4	4	4
-30	jdk1.6.0-b47	"Thu Aug 11 03:18:56 EDT 2005"	15964	952387	0	0	1	0	3	4	3
-31	jdk1.6.0-b48	"Thu Aug 18 08:10:40 EDT 2005"	15970	953421	0	0	0	0	3	5	3
-32	jdk1.6.0-b49	"Thu Aug 25 03:24:38 EDT 2005"	16048	958940	0	0	0	0	3	5	3
-33	jdk1.6.0-b50	"Thu Sep 01 01:52:40 EDT 2005"	16287	974937	1	0	0	0	3	5	4
-34	jdk1.6.0-b51	"Thu Sep 08 01:55:36 EDT 2005"	16362	979377	0	0	0	0	4	5	4
-35	jdk1.6.0-b52	"Thu Sep 15 02:04:08 EDT 2005"	16477	979399	0	0	0	0	4	5	4
-36	jdk1.6.0-b53	"Thu Sep 22 02:00:28 EDT 2005"	16019	957900	0	0	1	0	3	5	3
-37	jdk1.6.0-b54	"Thu Sep 29 01:54:34 EDT 2005"	16019	957900	0	0	0	0	3	6	3
-38	jdk1.6.0-b55	"Thu Oct 06 01:54:14 EDT 2005"	16051	959014	0	0	0	0	3	6	3
-39	jdk1.6.0-b56	"Thu Oct 13 01:54:12 EDT 2005"	16211	970835	0	0	0	0	3	6	3
-40	jdk1.6.0-b57	"Thu Oct 20 01:55:26 EDT 2005"	16279	971627	0	0	0	0	3	6	3
-41	jdk1.6.0-b58	"Thu Oct 27 01:56:30 EDT 2005"	16283	971945	0	0	0	0	3	6	3
-42	jdk1.6.0-b59	"Thu Nov 03 01:56:58 EST 2005"	16232	972193	0	0	0	0	3	6	3
-43	jdk1.6.0-b60	"Thu Nov 10 01:54:18 EST 2005"	16235	972346	0	0	0	0	3	6	3
-

次に示すコマンドを実行すると、db.xml 中間ファイルを生成することなく直接同じ情報を作成できます。

-computeBugHistory  jdk1.6.0-b*/jre/lib/rt.xml | filterBugs -bugPattern IL_ db.xml | mineBugHistory -formatDates
-

この情報を使って、 Sun JDK1.6.0 の各ビルドにおいて FindBugs によって発見された無限再起ループの数を表すグラフを表示します。青色の領域は、当該ビルドにおける無限再起ループの数を表しています。その上に描かれている赤色の領域は、以前のバージョンには存在したが当該バージョンでは除去された無限再起ループの数を表しています。 (したがって、赤色の領域と青色の領域を足し合わせた高さは決して減少しないことが保証されています。そして、新たに無限再起ループのバグが持ち込まれた時点で増加します) 。赤色の領域の高さは、当該バージョンにおいて修正または削除されたバグ数の合計で算出されます。バージョン 13 および 14 において見られる減少は、 FindBugs を使用して見つかった JDK のバグの報告を Sun が受け取ったことによるものです。

db.xml ファイルは、 jdk1.6.0 のすべてのビルドに対する検索結果を保持しています。したがって、次に示すコマンドを実行することで、優先度(高)または優先度(低)の正確性に関する警告の履歴が表示されます :

-filterBugs -priority M -category C db.xml | mineBugHistory -formatDates
-

作成される表の例 :

-seq	version	time	classes	NCSS	added	newCode	fixed	removed	retained	dead	active
-0	jdk1.6.0-b12	"Thu Nov 11 09:07:20 EST 2004"	13128	811569	0	1075	0	0	0	0	1075
-1	jdk1.6.0-b13	"Thu Nov 18 06:02:06 EST 2004"	13128	811570	0	0	0	0	1075	0	1075
-2	jdk1.6.0-b14	"Thu Dec 02 06:12:26 EST 2004"	13145	811786	3	0	6	0	1069	0	1072
-3	jdk1.6.0-b15	"Thu Dec 09 06:07:04 EST 2004"	13174	811693	2	1	3	0	1069	6	1072
-4	jdk1.6.0-b16	"Thu Dec 16 06:21:28 EST 2004"	13175	811715	0	0	1	0	1071	9	1071
-5	jdk1.6.0-b17	"Thu Dec 23 06:27:22 EST 2004"	13176	811974	0	0	1	0	1070	10	1070
-6	jdk1.6.0-b19	"Thu Jan 13 06:41:16 EST 2005"	13176	812011	0	0	0	0	1070	11	1070
-7	jdk1.6.0-b21	"Thu Jan 27 05:57:52 EST 2005"	13177	812173	0	0	1	0	1069	11	1069
-8	jdk1.6.0-b23	"Thu Feb 10 05:44:36 EST 2005"	13179	812188	0	0	0	0	1069	12	1069
-9	jdk1.6.0-b26	"Thu Mar 03 06:04:02 EST 2005"	13199	811770	0	0	2	1	1066	12	1066
-10	jdk1.6.0-b27	"Thu Mar 10 04:48:38 EST 2005"	13189	812440	1	0	1	1	1064	15	1065
-11	jdk1.6.0-b28	"Thu Mar 17 02:54:22 EST 2005"	13185	812056	0	0	0	0	1065	17	1065
-12	jdk1.6.0-b29	"Thu Mar 24 03:09:20 EST 2005"	13117	809468	3	0	8	26	1031	17	1034
-13	jdk1.6.0-b30	"Thu Mar 31 02:53:32 EST 2005"	13118	809501	0	0	0	0	1034	51	1034
-14	jdk1.6.0-b31	"Thu Apr 07 03:00:14 EDT 2005"	13117	809572	0	0	0	0	1034	51	1034
-15	jdk1.6.0-b32	"Thu Apr 14 02:56:56 EDT 2005"	13169	811096	1	1	0	1	1033	51	1035
-16	jdk1.6.0-b33	"Thu Apr 21 02:46:22 EDT 2005"	13187	811942	3	0	2	1	1032	52	1035
-17	jdk1.6.0-b34	"Thu Apr 28 02:49:00 EDT 2005"	13195	813488	0	1	0	0	1035	55	1036
-18	jdk1.6.0-b35	"Thu May 05 02:49:04 EDT 2005"	13457	829837	0	36	2	0	1034	55	1070
-19	jdk1.6.0-b36	"Thu May 12 02:59:46 EDT 2005"	13462	831278	0	0	0	0	1070	57	1070
-20	jdk1.6.0-b37	"Thu May 19 02:55:08 EDT 2005"	13464	831971	0	1	1	0	1069	57	1070
-21	jdk1.6.0-b38	"Thu May 26 03:08:16 EDT 2005"	13564	836565	1	7	2	6	1062	58	1070
-22	jdk1.6.0-b39	"Fri Jun 03 03:10:48 EDT 2005"	13856	849992	6	39	5	0	1065	66	1110
-23	jdk1.6.0-b40	"Thu Jun 09 03:30:28 EDT 2005"	15972	959619	7	147	11	0	1099	71	1253
-24	jdk1.6.0-b41	"Thu Jun 16 03:19:22 EDT 2005"	15972	959619	0	0	0	0	1253	82	1253
-25	jdk1.6.0-b42	"Fri Jun 24 03:38:54 EDT 2005"	15966	958581	3	0	1	2	1250	82	1253
-26	jdk1.6.0-b43	"Thu Jul 14 03:09:34 EDT 2005"	16041	960544	5	11	15	8	1230	85	1246
-27	jdk1.6.0-b44	"Thu Jul 21 03:05:54 EDT 2005"	16041	960547	0	0	0	0	1246	108	1246
-28	jdk1.6.0-b45	"Thu Jul 28 03:26:10 EDT 2005"	16037	960606	19	0	2	0	1244	108	1263
-29	jdk1.6.0-b46	"Thu Aug 04 03:02:48 EDT 2005"	15936	951355	13	1	1	32	1230	110	1244
-30	jdk1.6.0-b47	"Thu Aug 11 03:18:56 EDT 2005"	15964	952387	163	8	7	20	1217	143	1388
-31	jdk1.6.0-b48	"Thu Aug 18 08:10:40 EDT 2005"	15970	953421	0	0	0	0	1388	170	1388
-32	jdk1.6.0-b49	"Thu Aug 25 03:24:38 EDT 2005"	16048	958940	1	11	1	0	1387	170	1399
-33	jdk1.6.0-b50	"Thu Sep 01 01:52:40 EDT 2005"	16287	974937	19	27	16	7	1376	171	1422
-34	jdk1.6.0-b51	"Thu Sep 08 01:55:36 EDT 2005"	16362	979377	1	15	3	0	1419	194	1435
-35	jdk1.6.0-b52	"Thu Sep 15 02:04:08 EDT 2005"	16477	979399	0	0	1	1	1433	197	1433
-36	jdk1.6.0-b53	"Thu Sep 22 02:00:28 EDT 2005"	16019	957900	13	12	16	20	1397	199	1422
-37	jdk1.6.0-b54	"Thu Sep 29 01:54:34 EDT 2005"	16019	957900	0	0	0	0	1422	235	1422
-38	jdk1.6.0-b55	"Thu Oct 06 01:54:14 EDT 2005"	16051	959014	1	4	7	0	1415	235	1420
-39	jdk1.6.0-b56	"Thu Oct 13 01:54:12 EDT 2005"	16211	970835	6	8	37	0	1383	242	1397
-40	jdk1.6.0-b57	"Thu Oct 20 01:55:26 EDT 2005"	16279	971627	0	0	0	0	1397	279	1397
-41	jdk1.6.0-b58	"Thu Oct 27 01:56:30 EDT 2005"	16283	971945	0	1	1	0	1396	279	1397
-42	jdk1.6.0-b59	"Thu Nov 03 01:56:58 EST 2005"	16232	972193	6	0	5	0	1392	280	1398
-43	jdk1.6.0-b60	"Thu Nov 10 01:54:18 EST 2005"	16235	972346	0	0	0	0	1398	285	1398
-44	jdk1.6.0-b61	"Thu Nov 17 01:58:42 EST 2005"	16202	971134	2	0	4	0	1394	285	1396
-

2.2. 増分履歴メンテナンス

仮に、 db.xml がビルド b12 - b60 に対する findbugs 実行結果を保持している場合、次に示すコマンドを実行することで、 db.xml に b61 に対する実行結果を追加することができます :

-computeBugHistory -output db.xml db.xml jdk1.6.0-b61/jre/lib/rt.xml
-

3. Ant の例

findbugs の実行とその後のデータ・マイニングツールの活用の両方を実行している ant スクリプトの完全な例を以下に示します :

-
-<project name="analyze_asm_util" default="findbugs">
-   <!-- findbugs タスク定義 -->
-   <property name="findbugs.home" value="/Users/ben/Documents/workspace/findbugs/findbugs" />
-   <property name="jvmargs" value="-server -Xss1m -Xmx800m -Duser.language=en -Duser.region=EN -Dfindbugs.home=${findbugs.home}" />
-
-    <path id="findbugs.lib">
-      <fileset dir="${findbugs.home}/lib">
-         <include name="findbugs-ant.jar"/>
-      </fileset>
-   </path>
-
-   <taskdef name="findbugs" classname="edu.umd.cs.findbugs.anttask.FindBugsTask">
-      <classpath refid="findbugs.lib" />
-   </taskdef>
-
-   <taskdef name="computeBugHistory" classname="edu.umd.cs.findbugs.anttask.ComputeBugHistoryTask">
-      <classpath refid="findbugs.lib" />
-   </taskdef>
-
-   <taskdef name="setBugDatabaseInfo" classname="edu.umd.cs.findbugs.anttask.SetBugDatabaseInfoTask">
-      <classpath refid="findbugs.lib" />
-   </taskdef>
-
-   <taskdef name="mineBugHistory" classname="edu.umd.cs.findbugs.anttask.MineBugHistoryTask">
-      <classpath refid="findbugs.lib" />
-   </taskdef>
-
-   <!-- findbugs タスク定義 -->
-   <target name="findbugs">
-      <antcall target="analyze" />
-      <antcall target="mine" />
-   </target>
-
-   <!-- 分析を行うタスク-->
-   <target name="analyze">
-      <!-- asm-util に対して findbugs を実行する -->
-      <findbugs home="${findbugs.home}"
-                output="xml:withMessages"
-                timeout="90000000"
-                reportLevel="experimental"
-                workHard="true"
-                effort="max"
-                adjustExperimental="true"
-                jvmargs="${jvmargs}"
-                failOnError="true"
-                outputFile="out.xml"
-                projectName="Findbugs"
-                debug="false">
-         <class location="asm-util-3.0.jar" />
-      </findbugs>
-   </target>
-
-   <target name="mine">
-
-      <!-- 最新の分析結果に情報を設定する -->
-      <setBugDatabaseInfo home="${findbugs.home}"
-                            withMessages="true"
-                            name="asm-util-3.0.jar"
-                            input="out.xml"
-                            output="out-rel.xml"/>
-
-      <!-- 履歴ファイル (out-hist.xml) が既に存在するかどうかを確認する -->
-      <condition property="mining.historyfile.available">
-         <available file="out-hist.xml"/>
-      </condition>
-      <condition property="mining.historyfile.notavailable">
-         <not>
-            <available file="out-hist.xml"/>
-         </not>
-      </condition>
-
-      <!-- このターゲットは、履歴ファイルが存在しないとき (初回) だけ実行されます -->
-      <antcall target="history-init">
-        <param name="data.file" value="out-rel.xml" />
-        <param name="hist.file" value="out-hist.xml" />
-      </antcall>
-      <!-- 上記以外の場合に実行されます -->
-      <antcall target="history">
-        <param name="data.file"         value="out-rel.xml" />
-        <param name="hist.file"         value="out-hist.xml" />
-        <param name="hist.summary.file" value="out-hist.txt" />
-      </antcall>
-   </target>
-
-   <!-- 履歴ファイルを初期化します -->
-   <target name="history-init" if="mining.historyfile.notavailable">
-      <copy file="${data.file}" tofile="${hist.file}" />
-   </target>
-
-   <!-- バグ履歴を算出します -->
-   <target name="history" if="mining.historyfile.available">
-      <!-- ${data.file} を ${hist.file} にマージします -->
-      <computeBugHistory home="${findbugs.home}"
-                           withMessages="true"
-                           output="${hist.file}">
-            <dataFile name="${hist.file}"/>
-            <dataFile name="${data.file}"/>
-      </computeBugHistory>
-
-      <!-- 履歴を算出して ${hist.summary.file} に出力します -->
-      <mineBugHistory home="${findbugs.home}"
-                        formatDates="true"
-                      noTabs="true"
-                        input="${hist.file}"
-                        output="${hist.summary.file}"/>
-   </target>
-
-</project>
-
-
戻る   次へ
第11章 rejarForAnalysis の使用方法 ホーム 第13章 ライセンス
\ No newline at end of file diff --git a/ja/manual/eclipse.html b/ja/manual/eclipse.html deleted file mode 100644 index 8807f00..0000000 --- a/ja/manual/eclipse.html +++ /dev/null @@ -1,57 +0,0 @@ - - - 第7章 FindBugs™ Eclipse プラグインの使用方法
第7章 FindBugs™ Eclipse プラグインの使用方法
戻る   次へ

第7章 FindBugs™ Eclipse プラグインの使用方法

目次

1. 必要条件
2. インストール
3. プラグインの使用方法
4. Eclipse プラグインの拡張方法 (2.0.0 以降)
5. トラブルシューティング

-FindBugs Eclipse プラグインを使用することによって、 FindBugs を Eclipse IDE で使用することができるようになります。 -このFindBugs Eclipse プラグインは、 Peter Friese 氏の多大な貢献によるものです。 -Phil Crosby 氏 と Andrey Loskutov 氏は、プラグインの重要な改良に貢献しました。 -

1. 必要条件

FindBugs Eclipse Plugin を使用するためには、 Eclipse 3.3 あるいはそれ以降のバージョン、また、 JRE/JDK 1.5 あるいはそれ以降のバージョンが必要です。

2. インストール

更新サイトが提供されています。更新サイトを利用して、機械的に FindBugs を Eclipse にインストールできます。また自動的に、最新版のアップデートを照会してインストールすることもできます。内容の異なる 3 つの更新サイトが存在します。

FindBugs Eclipse 更新サイト一覧

http://findbugs.cs.umd.edu/eclipse/

FindBugs の公式リリース物を提供します。

http://findbugs.cs.umd.edu/eclipse-candidate/

FindBugsの公式リリース物に加えて、公式リリース候補版を提供します。

http://findbugs.cs.umd.edu/eclipse-daily/

FindBugsの日次ビルド物を提供します。コンパイルができること以上のテストは行われていません。

また、次に示すリンクから手動でプラグインをダウンロードすることもできます : http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_3.1.0.20161105.zip?download. 展開して Eclipse の「plugins」サブディレクトリーに入れてください。(そうすると、 <eclipse インストールディレクトリー >/plugins/edu.umd.cs.findbugs.plugin.eclipse_3.1.0.20161105/findbugs.png が FindBugs のロゴファイルへのパスになるはずです。)

プラグインの展開ができたら、 Eclipse を起動して Help → About Eclipse Platform → Plug-in Details を選択してください。「FindBugs Project」から提供された「FindBugs Plug-in」というプラグインがあることを確認してください。

3. プラグインの使用方法

実行するには、 Java プロジェクト上で右クリックして「Find Bugs」を選択します。FindBugs が実行されて、バグパターンの実例の可能性があると識別されたコード箇所に問題マーカーがつきます。 (ソース画面および Eclipse 問題ビューに表示されます。)

Java プロジェクトのプロパティーダイアログを開いて「Findbugs」プロパティーページを選択することで、 FindBugs の動作をカスタマイズすることができます。選択できる項目には次のようなものがあります :

  • 「Run FindBugs Automatically」チェックボックスの設定。チェックすると、プロジェクト内の Java クラスが修正されるたびに FindBugs が実行されます。

  • 優先度とバグカテゴリーの選択。これらのオプションは、どの警告を表示するかを選択します。例えば、優先度で 「Medium」 を選択すると、優先度 (中) および優先度 (高) の警告のみが表示されます。同様に、「Style」チェックボックスのチェックマークを外すと、Style カテゴリーに属する警告は表示されません。

  • ディテクタの選択。表からプロジェクトで有効にしたいディテクタを選択することができます。

4. Eclipse プラグインの拡張方法 (2.0.0 以降)

-Eclipse プラグインでは、 独自の FindBugs ディテクタを追加することができます。 -(詳しく知りたい方は、 -AddingDetectors.txt -もご覧ください)。 -独自のプラグインを Eclipse に追加するには以下の2通りの方法があります。 -

  • - 既存の標準 FindBugs ディテクタパッケージは以下で設定できます。 - Window → Preferences → Java → FindBugs → Misc. Settings → Custom Detectors。 - ここで追加するプラグインライブラリの場所を指定するだけです。 -

    - この方法の利点は、既存のディテクタパッケージは「そのまま」で、サードパーティーディテクタの品質をすばやく検証できることです。 - 欠点としては、この設定は Eclipse ワークスペース毎に適用する必要があり、この設定をチームメンバー間で共有することができないことです。 -

  • - Eclipse 標準の拡張機構を使って独自のディテクタを追加することができます。 -

    - - findBugsEclipsePlugin/schema/detectorPlugins.exsd の documentation で plugin.xml の更新方法を確認してください。 - 既存の FindBugs ディテクタプラグイン を簡単に「拡張」して強力な FindBugs Eclipse ディテクタプラグイン にすることができます。 - 通常必要なのは、 META-INF/MANIFEST.MF および plugin.xml を jar に追加してかつ、 MANIFEST.MF がビルド時に上書きされないようにビルドスクリプトを更新するだけです。 -

    - この方法の利点は、 Eclipse インストールを共有しさえすれば、チームメンバー同士で正確に同じディテクタ設定を使用できることです。 - 前提条件は現在使用しているディテクタパッケージを Eclipse プラグインに変換しておくことです。 - これはサードパーティのディテクタパッケージも同様です。 - もうひとつの主な差別化要因は、 FindBugs のデフォルト実行時クラスパス に当該サードパーティライブラリーを追加することが必要なことです(くわしくは - AddingDetectors.txt - をご覧ください)。 -

5. トラブルシューティング

-このセクションでは、プラグインに関する一般的な問題と (判明していれば) それらの問題の解決方法を記述します。 -

  • - Eclipse において FindBugs の分析開始後に OutOfMemory エラーダイアログが 出た場合は、 - JVM の使用メモリを増やしてください。すなわち、 eclipse.ini の末尾に以下の記述を追加してください。 - 

    -    -vmargs
-    -Xmx1000m
-

    - 重要：「-vmargs」で始まる設定引数は eclipse.ini ファイルの末尾に記述する必要があります。 - また、各行には引数を一つだけしか書くことができません！ -

  • - FindBugs 問題マーカーが (ソース画面および問題ビューに) 表示されない場合は、問題ビューのフィルター設定を変更してください。 - 詳細情報は http://findbugs.sourceforge.net/FAQ.html#q7 を参照してください。 -

戻る   次へ
第6章 FindBugs™ Ant タスクの使用方法 ホーム 第8章 フィルターファイル
\ No newline at end of file diff --git a/ja/manual/example-code.png b/ja/manual/example-code.png deleted file mode 100644 index fe01f317ae1e27a207c5847c8f553da4d97101d1..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 17799 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 Ib4q9e05s!)cPloG1+-rJ>jPyy+^36Y@E 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 Ib4q9e08buq{r~^~ diff --git a/ja/manual/filter.html b/ja/manual/filter.html deleted file mode 100644 index 40e42e0..0000000 --- a/ja/manual/filter.html +++ /dev/null @@ -1,241 +0,0 @@ - - - 第8章 フィルターファイル
第8章 フィルターファイル
戻る   次へ

第8章 フィルターファイル

目次

1. フィルターファイルの概要
2. マッチング条件の種類
3. Java 要素名マッチング
4. 留意事項
5. 例
6. 完全な例

フィルターファイルを使用することで、特定のクラスやメソッドをバグ報告に含めたりバグ報告から除外したりすることができます。この章では、フィルターファイルの使用方法を説明します。

[注記]計画されている機能

フィルターは現在、コマンドラインインタフェースでのみサポートされています。最終的には、フィルターのサポートは GUI にも追加される予定です。

-

1. フィルターファイルの概要

概念的に言えば、フィルターはバグ検索結果をある基準と照合します。フィルターを定義することで、 特別な取り扱いをするバグ検索結果を選択することができます。例えば、あるバグ検索結果をバグ報告に含めたり、バグ報告から除外したりすることができます。

フィルターファイルは、 XML 文書です。最上位要素が　FindBugsFilter 要素 であり、その子要素として Match 要素を複数個定義します。それぞれの Match 要素は、生成されたバグ検索結果に適用される述部にあたります。通常、フィルターはバグ検索結果を除外するために使用します。次に、例を示します:

-$ findbugs -textui -exclude myExcludeFilter.xml myApp.jar
-

また一方で、的をしぼった報告を得るためにバグ報告結果を選択するためにフィルターを使用することも考えられます :

-$ findbugs -textui -include myIncludeFilter.xml myApp.jar
-

-

-Match 要素は子要素を持ちます。それらの子要素は論理積で述部になります。つまり、述部が真であるためには、すべての子要素が真である必要があります。

2. マッチング条件の種類

<Bug>

この要素は、バグパターンを指定して照合します。pattern 属性には、コンマ区切りでバグパターン類型のリストを指定します。どの警告がどのバグパターン類型にあたるかは、 -xml オプションをつかって出力されたもの (BugInstance 要素の type 属性) を見るか、または、 バグ解説ドキュメントを参照してください。

もっと粒度の粗い照合を行いたいときは、 code 属性を使用してください。バグ略称のコンマ区切りのリストで指定できます。さらに粒度の粗い照合を行いたいときは、 category 属性を使用してください。次に示す、バグカテゴリー名のコンマ区切りのリストで指定できます : CORRECTNESS, MT_CORRECTNESS, BAD_PRACTICICE, PERFORMANCE, STYLE.

同じ <Bug> 要素に上記の属性を複数指定した場合は、バグパターン名、バグ略称、バグカテゴリーのいずれか1つでも該当すれば、バグパターンは合致すると判定されます。

下位互換性を持たせたい場合は、 <Bug> 要素の代わりに <BugPattern> 要素および <BugCode> 要素を使用してください。これらの要素はそれぞれ、 name 属性で値のリストを指定します。これらの要素は、将来サポートされなくなる可能性があります。

<Confidence>

- この要素は、特定のバグ信頼度をもつ警告を照合します。 - value 属性には、整数値を指定します。すなわち 1 は信頼度(高) 、また、 2 は信頼度(中) 、 3 は信頼度(低) を示します。 - <Confidence> は 2.0.0 リリースから <Priority> の後継として取って代わりました。 -

<Priority>

- <Confidence> と同一です。下位互換性を保つため残されています。 -

<Rank>

- この要素は、特定のバグランクをもつ警告を照合します。 - value 属性には、 1 から 20 の整数値を指定します。 - 1 から 4 は最も恐ろしいバグ、 5 から 9 は恐ろしいバグ、 10 から 14 は厄介なバグ, - そして 15 から 20 は不安なバグを示します。 -

<Package>

この要素は、 name 属性で指定した特定のパッケージ内にあるクラスに関連した警告を照合します。入れ子のパッケージは含まれません (Java import 文に従っています) 。しかしながら、正規表現を使うと複数パッケージにマッチさせることは簡単にできます。

<Class>

この要素は、特定のクラスに関連した警告を照合します。name 属性を使用して、照合するクラス名をクラス名そのものか、または、正規表現で指定します。

下位互換性を持たせたい場合は、この要素の代わりに Match 要素を使用してください。クラス名そのものの指定は class 属性を、クラス名を正規表現で指定する場合は classregex 属性をそれぞれ使用してください

もし Match 要素に Class 要素が無かったり、 class / classregex 属性が無かったりした場合は、すべてのクラスに適用されます。その場合、想定外に多くのバグ検索結果が一致してしまうことがあり得ます。その場合は、適当なメソッドやフィールドで絞り込んでください。

<Source>

- この要素は、特定のソースファイルに関連した警告を照合します。 - name 属性を使用して、照合するソースファイル名をソースファイル名そのものか、または、正規表現で指定します。 -

<Method>

この要素は、メソッドを指定します。name 属性を使用して、照合するメソッド名をメソッド名そのものか、または、正規表現で指定します。params 属性には、コンマ区切りでメソッド引数の型のリストを指定します。returns 属性にはメソッドの戻り値の型を指定します。params および returns においては、クラス名は完全修飾名である必要があります。(例えば、単に "String" ではなく "java.lang.String" としてください。) params returns のどちらか一方を指定した場合は、もう一方の属性の指定も必須です。なぜならば、メソッドシグニチャーを構築のために必要だからです。name 属性、params 属性 および returns 属性または 3 つの 属性すべて、のどれかを条件とすることできることを意味しています。このように、名前とシグニチャーに基づく様々な種類の条件を規定できます。

<Field>

この要素は、フィールドを指定します。name 属性を使用して、照合するフィールド名をフィールド名そのものか、または、正規表現で指定します。また、フィールドのシグニチャーに照らしたフィルタリングをすることができます。 type 属性を使用して、フィールドの型を完全修飾名で指定してください。名前とシグニチャーに基づく条件を規定するために、その2つの属性を両方とも指定することができます。

<Local>

この要素は、ローカル変数を指定します。name 属性を使用して、照合するローカル変数名をローカル変数名そのものか、または、正規表現で指定します。ローカル変数とは、メソッド内で定義した変数です。

<Or>

この要素は、論理和として Match 条項を結合します。すなわち、2つの Method 要素を Or 条項に入れることで、どちらか一方のメソッドでマッチさせることができます。

<And>

- この要素は、論理積として Match 条項を結合します。 - すなわち、 Bug および Confidence 要素を And 条項内に指定することで - 特定の信頼度の特定のバグのみ照合することができます。 -

<Not>

- この要素は、内包する子 Match を反転します。 - すなわち、 Bug 要素を Not 条項内に指定することで指定したバグ以外のすべてのバグと照合します。 -

3. Java 要素名マッチング

-Class 、 Source 、 Method または Field の name 属性が文字 ~ で始まっている場合は、 -属性値の残りの部分を Java の正規表現として解釈します。 -そうして、当該 Java 要素の名前に対しての照合が行われます。 -

パターンの照合は要素の名前全体に対して行われることに注意してください。そのため、部分一致照合を行いたい場合はパターン文字列の前後に .* を付加して使用する必要があります。

パターンの構文規則に関しては、 java.util.regex.Pattern のドキュメントを参照してください。

4. 留意事項

-Match 条項は、バグ検索結果に実際に含まれている情報にのみ一致します。すべてのバグ検索結果はクラスを持っています。したがって、一般的に言って、バグを除外するためにはクラスを用いて行うとうまくいくことが多いです。

バグ検索結果の中には、2個以上のクラスを保持しているものもあります。例えば、 DE (dropped exception : 例外の無視) バグは、 例外の無視が発生したメソッドを持っているクラスと、 無視された例外の型を表すクラスの両方を含んだ形で報告されます。Match 条項とは、 1番目 (主) のクラスのみが照合されます。したがって、例えば、クラス "com.foobar.A" 、 "com.foobar.B" 間での IC (initialization circularity : 初期化時の処理循環) バグ報告を抑止したい場合、以下に示すように 2つの Match 条項を使用します :

-   <Match>
-      <Class name="com.foobar.A" />
-      <Bug code="IC" />
-   </Match>
-
-   <Match>
-      <Class name="com.foobar.B" />
-      <Bug code="IC" />
-   </Match>
-

明示的に両方のクラスで照合することによって、循環しているどちらのクラスがバグ検索結果の 1 番目になっているかに関係なく一致させることができます。(もちろんこの方法は、処理循環が "com.foobar.A" 、 "com.foobar.B" に加えて3番目のクラスも含んでいる場合は図らずも失敗してしまう恐れがあります。)

多くの種類のバグ報告は、自身が出現したメソッドを報告します。それらのバグ検索結果に対しては、 Method 条項を Match 要素に加えると期待通りの動作をするでしょう。

5. 例

1. 特定のクラスに対するすべてのバグ報告に一致させます。

-
-     <Match>
-       <Class name="com.foobar.MyClass" />
-     </Match>
-
-

- -

2. バグ略称を指定して、特定のクラスに対する特定の検査項目に一致させます。

-
-     <Match>
-       <Class name="com.foobar.MyClass"/ >
-       <Bug code="DE,UrF,SIC" />
-     </Match>
-
-

-

3. バグ略称を指定して、すべてのクラスに対する特定の検査項目に一致させます。

-
-     <Match>
-       <Bug code="DE,UrF,SIC" />
-     </Match>
-
-

-

4. バグカテゴリーを指定して、すべてのクラスに対する特定の検査項目に一致させます。

-
-     <Match>
-       <Bug category="PERFORMANCE" />
-     </Match>
-
-

-

5. バグ略称を指定して、特定のクラスの指定されたメソッドに対する特定のバグ種別に一致させます。

-
-     <Match>
-       <Class name="com.foobar.MyClass" />
-       <Or>
-         <Method name="frob" params="int,java.lang.String" returns="void" />
-         <Method name="blat" params="" returns="boolean" />
-       </Or>
-       <Bug code="DC" />
-     </Match>
-
-

-

6. 特定のメソッドに対する特定のバグパターンに一致させます。

-
-    <!-- open stream に関する誤検出があるメソッド。-->
-    <Match>
-      <Class name="com.foobar.MyClass" />
-      <Method name="writeDataToFile" />
-      <Bug pattern="OS_OPEN_STREAM" />
-    </Match>
-
-

-

7. 特定のメソッドに対する特定の優先度を付与された特定のバグパターンに一致させます。

-
-    <!-- dead local store (優先度 (中)) に関する誤検出があるメソッド。-->
-    <Match>
-      <Class name="com.foobar.MyClass" />
-      <Method name="someMethod" />
-      <Bug pattern="DLS_DEAD_LOCAL_STORE" />
-      <Priority value="2" />
-    </Match>
-
-

-

8. AspectJ コンパイラーによって引き起こされるマイナーバグに一致させます (AspectJ の開発者でもない限り、それらのバグに関心を持つことはないと考えます)。

-
-    <Match>
-      <Class name="~.*\$AjcClosure\d+" />
-      <Bug pattern="DLS_DEAD_LOCAL_STORE" />
-      <Method name="run" />
-    </Match>
-    <Match>
-      <Bug pattern="UUF_UNUSED_FIELD" />
-      <Field name="~ajc\$.*" />
-    </Match>
-
-

-

9. 基盤コードの特定の部分に対するバグに一致させます

-
-    <!-- すべてのパッケージにある Messages クラスに対する unused fields 警告に一致。 -->
-    <Match>
-      <Class name="~.*\.Messages" />
-      <Bug code="UUF" />
-    </Match>
-    <!-- すべての internal パッケージ内の mutable statics 警告に一致。 -->
-    <Match>
-      <Package name="~.*\.internal" />
-      <Bug code="MS" />
-    </Match>
-    <!-- ui パッケージ階層内の anonymoous inner classes 警告に一致。 -->
-    <Match>
-      <Package name="~com\.foobar\.fooproject\.ui.*" />
-      <Bug pattern="SIC_INNER_SHOULD_BE_STATIC_ANON" />
-    </Match>
-
-

-

10. 特定のシグニチャーを持つフィールドまたはメソッドのバグに一致させます。

-
-    <!-- すべてのクラスの main(String[]) メソッドに対する System.exit(...) usage 警告に一致。 -->
-    <Match>
-      <Method returns="void" name="main" params="java.lang.String[]" />
-      <Method pattern="DM_EXIT" />
-    </Match>
-    <!-- すべてのクラスの com.foobar.DebugInfo 型のフィールドに対する UuF 警告に一致。 -->
-    <Match>
-      <Field type="com.foobar.DebugInfo" />
-      <Bug code="UuF" />
-    </Match>
-
-

-

- 11. Not フィルター演算子を使用してバグに一致させます。 -

-
-<!-- テストクラスのバグは無視する。ただし、 JUnit テスト特有のバグは例外とする。 -->
-<!-- i.e. filter bug if ( classIsJUnitTest && ! bugIsRelatedToJUnit ) -->
-<Match>
-  <!-- Match フィルタは論理和と同等 -->
-
-  <Class name="~.*\.*Test" />
-  <!-- テストクラスは末尾に「Test」 -->
-
-  <Not>
-      <Bug code="IJU" /> <!-- 「IJU」は JUnit テストコード関連のバグコード -->
-  </Not>
-</Match>
-
-

-

- 12. 完全な除外フィルター。 Groovy ソースファイルから生成された全クラスを除外します。 - -

-
-<?xml version="1.0" encoding="UTF-8"?>
-<FindBugsFilter>
-<Match>
-    <Source name="~.*\.groovy" />
-</Match>
-</FindBugsFilter>
-
-

-

6. 完全な例

-
-<FindBugsFilter>
-     <Match>
-       <Class name="com.foobar.ClassNotToBeAnalyzed" />
-     </Match>
-
-     <Match>
-       <Class name="com.foobar.ClassWithSomeBugsMatched" />
-       <Bug code="DE,UrF,SIC" />
-     </Match>
-
-     <!-- XYZ 違反に一致。-->
-     <Match>
-       <Bug code="XYZ" />
-     </Match>
-
-     <!-- "AnotherClass" の特定のメソッドの doublecheck 違反に一致。-->
-     <Match>
-       <Class name="com.foobar.AnotherClass" />
-       <Or>
-         <Method name="nonOverloadedMethod" />
-         <Method name="frob" params="int,java.lang.String" returns="void" />
-         <Method name="blat" params="" returns="boolean" />
-       </Or>
-       <Bug code="DC" />
-     </Match>
-
-     <!-- dead local store (優先度 (中)) に関する誤検出があるメソッド。-->
-     <Match>
-       <Class name="com.foobar.MyClass" />
-       <Method name="someMethod" />
-       <Bug pattern="DLS_DEAD_LOCAL_STORE" />
-       <Priority value="2" />
-     </Match>
-
-     <!-- テストクラスのバグすべて。 JUnit 特有のバグは除く。 -->
-     <Match>
-      <Class name="~.*\.*Test" />
-      <Not>
-          <Bug code="IJU" />
-      </Not>
-     </Match>
-
-</FindBugsFilter>
-
-
戻る   次へ
第7章 FindBugs™ Eclipse プラグインの使用方法 ホーム 第9章 分析プロパティー
\ No newline at end of file diff --git a/ja/manual/gui.html b/ja/manual/gui.html deleted file mode 100644 index 89ab95e..0000000 --- a/ja/manual/gui.html +++ /dev/null @@ -1,14 +0,0 @@ - - - 第5章 FindBugs GUI の使用方法
第5章 FindBugs GUI の使用方法
戻る   次へ

第5章 FindBugs GUI の使用方法

目次

1. プロジェクトの作成
2. 分析の実行
3. 結果の閲覧
4. 保存と読み込み

この章では、FindBugs グラフィカルユーザーインタフェース (GUI) の使用方法を説明します。

1. プロジェクトの作成

findbugs コマンドで FindBugs を起動してから、メニューで File → New Project を選択してください。そうすると、次のようなダイアログが表示されます:

-

「Classpath to analyze」の横にある 「Add」ボタンを押すと、バグを分析する java クラスを含んでいる Java アーカイブファイル (zip, jar, ear, or war file) を選択して指定できます。複数の アーカイブ/ディレクトリーを追加することが可能です。

また、分析を行う Java アーカイブのソースコードを含んだソースディレクトリーを指定することもできます。そうすると、バグの可能性があるソースコードの場所が、FindBugs 上でハイライトして表示されます。ソースディレクトリーは、Java パッケージ階層のルートディレクトリーを指定する必要があります。例えば、ユーザのアプリケーションが org.foobar.myapp パッケージの中にある場合は、 org ディレクトリーの親ディレクトリーをソースディレクトリーリストに指定する必要があります。

もうひとつ、任意指定の手順があります。それは、補助用の Jar ファイルおよびディレクトリーを 「Auxiliary classpath locations」のエントリーに追加することです。分析するアーカイブ/ディレクトリーにも標準の実行時クラスパスにも含まれていないクラスを、分析するアーカイブ/ディレクトリーが参照している場合は、この項目を設定した方がいいでしょう。クラス階層に関する情報を使用するバグディテクタが、 FindBugs にはいくつかあります。したがって、FindBugs が分析を行うクラスの完全なクラス階層を参照できれば、より正確な分析結果を取得することができます。

2. 分析の実行

アーカイブ、ディレクトリーおよびソースディレクトリーの指定ができれば、「Analyze」ボタンを押して Jar ファイルに含まれるクラスに対する分析を実行します。巨大なプロジェクトを古いコンピュータ上で実行すると、かなりの時間(数十分)がかかることに注意してください。大容量メモリである最近のコンピュータなら、大きなプログラムであっても数分程度で分析できます。

3. 結果の閲覧

分析が完了すると、次のような画面が表示されます :

-

左上のペインにはバグ階層ツリーが表示されます。これは、分析でみつかったバグの検索結果が階層的に表示されたものです。

上部のペインでバグ検索結果を選択すると、下部の「Details」ペインにバグの詳細説明が表示されます。更に、ソースがみつかれば、右上のソースコードペインにバグの出現箇所に該当するソースコードが表示されます。上図の例で表示されているバグは、ストリームオブジェクトがクローズされていないというものです。ソースコード・ウィンドウにおいて当該ストリームオブジェクトを生成している行がハイライトされています。

バグの検索結果に対してテキストで注釈を入れることができます。階層ツリー図のすぐ下にあるテキストボックスに注釈を入力してください。記録しておきたい情報を何でも自由に入力することができます。バグ結果ファイルの保存および読み込みを行ったときに、注釈も保存されます。

4. 保存と読み込み

メニュー項目から File → Save as... を選択すると、ユーザーの作業結果を保存することができます。「Save as...」ダイアログにあるドロップダウン・リストの中から「FindBugs analysis results (.xml)」を選択ことで、ユーザーが指定した jar ファイルリストやバグ検索結果などの作業結果を保存することができます。また、jar ファイルリストのみを保存する選択肢 (「FindBugs project file (.fbp)」) やバグ検索結果のみを保存する選択肢 (「FindBugs analysis file (.fba)」) もあります。保存したファイルは、メニュー項目から File → Open... を選択することで、読み込むことができます。

戻る   次へ
第4章 FindBugs™ の実行 ホーム 第6章 FindBugs™ Ant タスクの使用方法
\ No newline at end of file diff --git a/ja/manual/important.png b/ja/manual/important.png deleted file mode 100644 index 12c90f607a1b27ddde0a7d922ae255e8c90e883e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 722 zcmV;@0xkWCP)Gdz_qOoSb{LwMwNgp7=gl$4aErG%}mjHRWNrKOy`y@b8JoTa6ut*xc4t*y1SwY|N)#>U3Z&d%1> z*52OU=jZ3|@9+2b_y7O@tTMkk%M`~Kg@u8&dg_P^_0l3yQb639!jLZt^Lx<-O17UeeJ z-|=!77W(jGx&e#?FOku-gKofoU0$~4M+dhLFueEauP`}l7LV=;lsOdn%WHure=x;k`m0(bF&MU#) z-qv#^n8(MjB|ykioqII#+`g4no-MU=BK|Sahu_3M_-d*=7hq=~t?^}A)G7 zbairN0An*{V`DL9V>K}|HDobmIW;*pIW=W9HaTQ6F*7kTGI9=S@Bjb+07*qoM6N<$ Ef=i}M4FCWD diff --git a/ja/manual/index.html b/ja/manual/index.html deleted file mode 100644 index d5d32f9..0000000 --- a/ja/manual/index.html +++ /dev/null @@ -1,12 +0,0 @@ - - - FindBugs™ マニュアル
FindBugs™ マニュアル
   次へ

FindBugs™ マニュアル

David H. Hovemeyer

William W. Pugh

Copyright © 2003 - 2012 University of Maryland

このマニュアルは、クリエイティブ・コモンズ表示-非営利-継承に基づく使用許諾がなされています。使用許諾書をご覧になる場合は、 http://creativecommons.org/licenses/by-nc-sa/1.0/ にアクセスするか、クリエイティブ・コモンズ(559 Nathan Abbott Way, Stanford, California 94305, USA)に書簡を送付してください。

名称「FindBugs」および FindBugs のロゴは、メリーランド大学の登録商標です。

20:59:21 ART, 05 November, 2016 (翻訳 2014年7月)

目次

1. はじめに
1. 必要条件
2. FindBugs™ のインストール
1. 配布物の展開
3. FindBugs™ のソールからのビルド
1. 前提条件
2. ソース配布物の展開
3. local.properties の修正
4. Ant の実行
5. ソースディレクトリーからの FindBugs™ の実行
4. FindBugs™ の実行
1. クイック・スタート
2. FindBugs の起動
3. コマンドラインオプション
5. FindBugs GUI の使用方法
1. プロジェクトの作成
2. 分析の実行
3. 結果の閲覧
4. 保存と読み込み
6. FindBugs™ Ant タスクの使用方法
1. Ant タスクのインストール
2. build.xml の書き方
3. タスクの実行
4. パラメーター
7. FindBugs™ Eclipse プラグインの使用方法
1. 必要条件
2. インストール
3. プラグインの使用方法
4. Eclipse プラグインの拡張方法 (2.0.0 以降)
5. トラブルシューティング
8. フィルターファイル
1. フィルターファイルの概要
2. マッチング条件の種類
3. Java 要素名マッチング
4. 留意事項
5. 例
6. 完全な例
9. 分析プロパティー
10. アノテーション
11. rejarForAnalysis の使用方法
12. FindBugs™ によるデータ・マイニング
1. コマンド
2. 例
3. Ant の例
13. ライセンス
14. 謝辞
1. 貢献者
2. 使用しているソフトウェア

表の一覧

9.1. 設定可能な分析プロパティー
12.1. computeBugHistory コマンドのオプション一覧
12.2. filterBugs コマンドのオプション一覧
12.3. mineBugHistory コマンドのオプション一覧
12.4. mineBugHistory 出力のカラム一覧
12.5. defectDensity 出力のカラム一覧
12.6. convertXmlToText コマンドのオプション一覧
12.7. setBugDatabaseInfo オプション一覧
12.8. listBugDatabaseInfo カラム一覧
   次へ
   第1章 はじめに
\ No newline at end of file diff --git a/ja/manual/infiniteRecursiveLoops.png b/ja/manual/infiniteRecursiveLoops.png deleted file mode 100644 index 5430df294b109f9400d7e09c6aa7b0715c4df61f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 24467 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 yI|g1;_B$_~WjO_syhG@JFxm3| - - 第2章 FindBugs™ のインストール
第2章 FindBugs™ のインストール
戻る   次へ

第2章 FindBugs™ のインストール

目次

1. 配布物の展開

この章では、 FindBugs のインストール方法を説明します。

1. 配布物の展開

FindBugs をインストールする最も簡単な方法は、バイナリ配布物をダウンロードすることです。 バイナリ配布物は、 gzipped tar 形式 および zip 形式 がそれぞれ入手可能です。バイナリ配布物をダウンロードしてきたら、それを任意のディレクトリーに展開します。

gzipped tar 形式配布物の展開方法例:

-$ gunzip -c findbugs-3.1.0-dev-20161105-d07b50f.tar.gz | tar xvf -
-

-

zip 形式配布物の展開方法例:

-C:\Software>unzip findbugs-3.1.0-dev-20161105-d07b50f.zip
-

-

バイナリ配布物の展開すると、通常は findbugs-3.1.0-dev-20161105-d07b50f ディレクトリーが作成されます。例えば、ディレクトリー C:\Software でバイナリ配布物を展開すると、ディレクトリー C:\Software\findbugs-3.1.0-dev-20161105-d07b50f に FindBugs は展開されます。このディレクトリーが FindBugs のホームディレクトリーになります。このマニュアルでは、このホームディレクトリーを $FINDBUGS_HOME (Windowsでは %FINDBUGS_HOME%) を用いて参照します。

戻る   次へ
第1章 はじめに ホーム 第3章 FindBugs™ のソールからのビルド
\ No newline at end of file diff --git a/ja/manual/introduction.html b/ja/manual/introduction.html deleted file mode 100644 index 577bb43..0000000 --- a/ja/manual/introduction.html +++ /dev/null @@ -1,12 +0,0 @@ - - - 第1章 はじめに
第1章 はじめに
戻る   次へ

第1章 はじめに

目次

1. 必要条件

FindBugs™ は、Java プログラムの中のバグを見つけるプログラムです。このプログラムは、「バグ パターン」の実例を探します。「バグ パターン」とは、エラーとなる可能性の高いコードの事例です。

この文書は、FindBugs バージョン 3.1.0-dev-20161105-d07b50f について説明してます。私たちは、 FindBugs に対するフィードバックを心待ちにしています。どうぞ、 FindBugs Web ページ にアクセスしてください。FindBugs についての最新情報、連絡先および FindBugs メーリングリストなどのサポート情報を入手することができます。

1. 必要条件

FindBugs を使用するには、 Java 2 Standard Edition, バージョン 1.5 以降のバージョンと互換性のあるランタイム環境が必要です。FindBugs は、プラットフォーム非依存であり、 GNU/Linux 、 Windows 、 MacOS X プラットフォーム上で動作することが知られています。

FindBugs を使用するためには、少なくとも 512 MB のメモリが必要です。巨大なプロジェクトを解析するためには、それより多くのメモリが必要とされることがあります。

戻る   次へ
FindBugs™ マニュアル ホーム 第2章 FindBugs™ のインストール
\ No newline at end of file diff --git a/ja/manual/license.html b/ja/manual/license.html deleted file mode 100644 index f9b39e3..0000000 --- a/ja/manual/license.html +++ /dev/null @@ -1,12 +0,0 @@ - - - 第13章 ライセンス
第13章 ライセンス
戻る   次へ

第13章 ライセンス

名称「FindBugs」および FindBugs のロゴは、メリーランド大学の登録商標です。FindBugs はフリーソフトウェアであり、 Lesser GNU Public License の条件で配布されています。使用承諾書を入手したい場合は、 FindBugs 配布物に含まれる LICENSE.txt ファイルを参照してください。

最新バージョンの FindBugs および そのソースコードは FindBugs web ページ で入手できます。

戻る   次へ
第12章 FindBugs™ によるデータ・マイニング ホーム 第14章 謝辞
\ No newline at end of file diff --git a/ja/manual/note.png b/ja/manual/note.png deleted file mode 100644 index d0c3c645ab9af6318035b026dd86944b9ddc9114..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 490 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 - - 第11章 rejarForAnalysis の使用方法
第11章 rejarForAnalysis の使用方法
戻る   次へ

第11章 rejarForAnalysis の使用方法

プロジェクトに多くの jar ファイル があったり、 jar ファイルが多くのディレクトリに点在したりする場合は、 rejarForAnalysis スクリプトを使用すると FindBugs の実行が比較的簡単になります。このスクリプトは、数多い jar ファイルを集めて 1 つの大きな jar ファイルに結合します。そうすると、分析時にFindBugs に jar ファイルを設定することが比較的簡単になります。このスクリプトは、 unix システムの 'find' コマンドと組み合わせるととりわけ有用になります ; 次に例を示します。 find . -name '*.jar' | xargs rejarForAnalysis .

また、 rejarForAnalysis スクリプトは巨大なプロジェクトを複数の jar ファイルに分割することに使用できます。プロジェクトのクラスファイルは、複数の jar ファイルに均等に配分されます。これは、プロジェクト全体に対して FindBugs を実行すると時間とメモリ消費が著しい場合に有用です。プロジェクト全体に対して FindBugs を実行する代わりに、 rejarForAnalysis ですべてのクラスを含む大きな jar ファイルを構築します。続いて、 rejarForAnalysis を再び実行して複数の jar ファイルに分割します。そして、各々の jar ファイルに対して順に FindBugs を実行します。その際、 -auxclasspath に最初に 1 つにまとめた jar ファイルを指定してください。

rejarForAnalysis スクリプトに指定することができるオプションを以下に示します :

-maxAge 日数

最後に更新された日からの経過時間を日単位で指定します (指定した日数より古い jar ファイルは無視されます)。

-inputFileList ファイル名

jar ファイル名を記載したテキストファイルを指定します。

-maxClasses クラス数

analysis*.jar ファイル 1 ファイルに対するクラスの最大数を指定します。

-prefix プレフィックス

分析するクラス名のプレフィックスを指定します (例、 edu.umd.cs.) 。

戻る   次へ
第10章 アノテーション ホーム 第12章 FindBugs™ によるデータ・マイニング
\ No newline at end of file diff --git a/ja/manual/running.html b/ja/manual/running.html deleted file mode 100644 index 2aaf745..0000000 --- a/ja/manual/running.html +++ /dev/null @@ -1,34 +0,0 @@ - - - 第4章 FindBugs™ の実行
第4章 FindBugs™ の実行
戻る   次へ

第4章 FindBugs™ の実行

目次

1. クイック・スタート
2. FindBugs の起動
3. コマンドラインオプション

FindBugs には2つのユーザーインタフェースがあります。すなわち、グラフィカルユーザーインタフェース (GUI) および コマンドラインインタフェースです。この章では、それぞれのインタフェースの実行方法について説明します。

[警告]警告

この章は、現在書き直し中です。書き直しはまだ完了していません。

1. クイック・スタート

Windows システムで FindBugs を起動する場合は、 %FINDBUGS_HOME%\lib\findbugs.jar ファイルをダブルクリックしてください。 FindBugs GUI が起動します。

Unix 、 Linux または Mac OS X システムの場合は、$FINDBUGS_HOME/bin/findbugs スクリプトを実行するか、以下のコマンドを実行します。

-java -jar $FINDBUGS_HOME/lib/findbugs.jar

これで、 FindBugs GUI が起動します。

GUI の使用方法については、 5章FindBugs GUI の使用方法 を参照してください。

2. FindBugs の起動

このセクションでは、 FindBugs の起動方法を説明します。FindBugs を起動するには2つの方法があります。すなわち、直接起動する方法、および、ラップしているスクリプトを使用する方法です。

2.1. FindBugs の直接起動

最初に述べる FindBugs の起動方法は、 $FINDBUGS_HOME/lib/findbugs.jar を直接実行する方法です。JVM (java) 実行プログラムの -jar コマンドラインスイッチを使用します。(FindBugsのバージョンが 1.3.5 より前の場合は、ラップしているスクリプトを使用する必要があります。)

FindBugs を直接起動するための、一般的な構文は以下のようになります。

-    java [JVM 引数] -jar $FINDBUGS_HOME/lib/findbugs.jar オプション…
-

-

2.1.1. ユーザーインタフェースの選択

1 番目のコマンドラインオプションは、起動する FindBugs ユーザーインタフェースを選択するためのものです。指定可能な値は次の通りです:

  • - -gui: グラフィカルユーザーインタフェース (GUI) を起動します。

  • - -textui: コマンドラインインタフェースを起動します。

  • - -version: FindBugs のバージョン番号を表示します。

  • - -help: FindBugs コマンドラインインタフェースのヘルプ情報を表示します。

  • - -gui1: 最初に作成された FindBugs グラフィカルユーザーインタフェース(すでに廃止されサポートされていない)を起動します。

2.1.2. Java 仮想マシン (JVM) 引数

FindBugs を起動する際に有用な Java 仮想マシン 引数をいくつか紹介します。

-XmxNNm

Java ヒープサイズの最大値を NN メガバイトに設定します。FindBugs は一般的に大容量のメモリサイズを必要とします。大きなプロジェクトでは、 1500 メガバイトを使用することも珍しくありません。

-Dname=value

Java システムプロパティーを設定します。例えば、引数 -Duser.language=ja を使用すると GUI 文言が日本語で表示されます。

2.2. ラップしているスクリプトを使用した FindBugs の起動

FindBugs を起動するもうひとつの方法は、ラップしているスクリプトを使用する方法です。

Unix 系のシステムにおいては、次のようなコマンドでラップしているスクリプトを起動します :

-$ $FINDBUGS_HOME/bin/findbugs オプション…
-

-

Windows システムにおいては、ラップしているスクリプトを起動するコマンドは次のようになります。

-C:\My Directory>%FINDBUGS_HOME%\bin\findbugs.bat オプション…
-

-

Unix 系システム および Windows システムのどちらにおいても、ディレクトリー $FINDBUGS_HOME/bin を環境変数 PATH に追加するだけで、 findbugs コマンドを使用して FindBugs を起動することができます。

2.2.1. ラップしているスクリプトのコマンドラインオプション

FindBugs のラップしているスクリプトは、次のようなコマンドラインオプションをサポートしています。これらのコマンドラインオプションは FindBugs プログラム 自体が操作するのではなく、どちらかといえば、ラップしているスクリプトの方が処理を行います。

-jvmArgs 引数

JVM に受け渡される引数を指定します。例えば、次のような JVM プロパティが設定できます:

-$ findbugs -textui -jvmArgs "-Duser.language=ja" myApp.jar
-

-

-javahome ディレクトリー

FindBugs の実行に使用する JRE (Java ランタイム環境) がインストールされているディレクトリーを指定します。

-maxHeap サイズ

Java ヒープサイズの最大値をメガバイト単位で指定します。デフォルトは、 256 です。巨大なプログラムやライブラリを分析するには、もっと大きなメモリー容量が必要になる可能性があります。

-debug

ディテクタ実行およびクラス分析のトレース情報が標準出力に出力されます。分析が予期せず失敗した際の、トラブルシューティングに有用です。

-property name=value

このオプションを使用してシステムプロパティーを設定することができます。 FindBugs はシステムプロパティーを使用して分析特性の設定を行います。9章分析プロパティー を参照してください。このオプションを複数指定して、複数のシステムプロパティを設定することが可能です。注: Windows の多くのバージョンでは、 name=value 文字列を引用符で囲む必要があります。

3. コマンドラインオプション

このセクションでは、 FindBugs がサポートするコマンドラインオプションについて説明します。ここで示すコマンドラインオプションは、 FindBugs 直接起動、または、ラップしているスクリプトによる起動で使用できます。

3.1. 共通のコマンドラインオプション

ここで示すオプションは、 GUI および コマンドラインインタフェースの両方で使用できます。

-effort:min

このオプションを指定すると、精度を上げるために大量のメモリーを消費する分析が無効になります。FindBugs の実行時にメモリー不足になったり、分析を完了するまでに異常に長い時間がかかる場合に試してみてください。

-effort:max

精度が高く、より多くのバグを検出する分析を有効にします。ただし、多くのメモリー容量を必要とし、また、完了までの時間が多くかかる可能性があります。

-project project

分析するプロジェクトを指定します。指定するプロジェクトファイルには、 GUI を使って作成したものを使用してください。ファイルの拡張子は、一般的には .fb または .fbp です。

3.2. GUI オプション

ここで示すオプションは、グラフィカルユーザーインタフェースでのみ使用できます。

-look:plastic|gtk|native

Swing のルック・アンド・フィールを設定します。

-

3.3. テキストユーザーインタフェースオプション

ここで示すオプションは、テキストユーザーインタフェースでのみ使用できます。

-sortByClass

報告されるバグ検索結果をクラス名でソートします。

-include filterFile.xml

filterFile.xml で指定したフィルターに一致したバグ検索結果のみ報告されます。8章フィルターファイル を参照してください。

-exclude filterFile.xml

filterFile.xml で指定したフィルターに一致したバグ検索結果は報告されません。8章フィルターファイル を参照してください。

-onlyAnalyze com.foobar.MyClass,com.foobar.mypkg.*

コンマ区切りで指定したクラスおよびパッケージのみに限定して、バグ検出の分析を行うようにします。フィルターと違って、このオプションを使うと一致しないクラスおよびパッケージに対する分析の実行を回避することができます。大きなプロジェクトにおいて、このオプションを活用すると分析にかかる時間を大きく削減することができる可能性があります。(しかしながら、アプリケーションの全体で実行していないために不正確な結果を出してしまうディテクタがある可能性もあります。) クラスはパッケージも含んだ完全な名前を指定する必要があります。また、パッケージは、 Java の import 文でパッケージ下のすべてのクラスをインポートするときと同じ方法で指定します。 (すなわち、パッケージの完全な名前に .* を付け加えた形です。).* の代わりに .- を指定すると、サブパッケージも含めてすべてが分析されます。

-low

すべてのバグが報告されます。

-medium

優先度 (中) および優先度 (高) のバグが報告されます。これは、デフォルトの設定値です。

-high

優先度 (高) のバグのみが報告されます。

-relaxed

手抜き報告モードです。このオプションを指定すると、多くのディテクタにおいて 誤検出を回避するためのヒューリスティック機能が抑止されます。

-xml

バグ報告が XML で作成されます。作成された XML データは 、後で GUI で見ることができます。このオプションは -xml:withMessages と指定することもできます。こうすると 出力 XML には 各バグに関して人間に読むことができるメッセージが含まれるようになります。このオプションで作成された XML ファイルは 報告書に変換するのが簡単です。

-html

HTML 出力が生成されます。デフォルトでは FindBugs は default.xsl XSLT スタイルシートを使用して HTML 出力を生成します: このファイルは、 findbugs.jar の中、または、 FindBugs のソース配布物もしくはバイナリ配布物の中にあります。このオプションには、次のようなバリエーションも存在します。すなわち、 -html:plain.xsl 、 -html:fancy.xsl および -html:fancy-hist.xsl です。plain.xsl スタイルシートは Javascript や DOM を利用しません。したがって、古いWeb ブラウザ使用時や印刷時にも比較的うまく表示されるでしょう。fancy.xsl スタイルシートは DOM と Javascript を利用してナビゲーションを行います。また、ビジュアル表示に CSS を使用します。fancy-hist.xsl は fancy.xsl スタイルシートを更に進化させたものです。DOM や Javascript をふんだんに駆使して、バグの一覧を動的にフィルタリングします。

ユーザー自身の XSLT スタイルシートを用いて HTML への変換を行いたい場合は、 -html:myStylesheet.xsl のように指定してください。ここで、 myStylesheet.xsl はユーザーが使用したいスタイルシートのファイル名です。

-emacs

バグ報告が Emacs 形式で作成されます。

-xdocs

バグ報告が xdoc XML 形式で作成されます。Apache Mavenで使用できます。

-output ファイル名

指定したファイルに出力結果が作成されます。

-outputFile ファイル名

この引数は、使用すべきではありません。代わりに、 -output を使用してください。

-nested[:true|false]

このオプションは、ファイルやディレクトリーの中で入れ子になった jar および zip ファイルを分析するかどうかを指定します。デフォルトでは、入れ子になった jar および zip ファイルも分析します。入れ子になった jar および zip ファイルの分析するを無効にする場合は、 -nested:false をコマンドライン引数に追加してください。

-auxclasspath クラスパス

分析時に使用する補助クラスパスを設定します。分析するプログラムで使用するjarファイルやクラスディレクトリーをすべて指定してください。補助クラスパスに指定したクラスは分析の対象にはなりません。

-auxclasspathFromInput

分析時に使用する補助クラスパスを標準入力から読み込みます。標準入力の各行が分析時に使用する補助クラスパスに追加されます。

-auxclasspathFromFile ファイルパス

分析時に使用する補助クラスパスをファイルから読み込みます。ファイルの各行が分析時に使用する補助クラスパスに追加されます。

-analyzeFromFile ファイルパス

分析対象ファイルをファイルから読み込みます。ファイルの各行が分析対象クラスパスに追加されます。

-userPrefs edu.umd.cs.findbugs.core.prefs

ユーザー設定ファイルのパスを設定します。ユーザー設定ファイルの内容で、他のオプションの一部を上書きすることができます。 - userPrefs を一番目の引数に指定した場合は、後続のオプションの方がユーザー設定ファイルの内容に優先します。 - userPrefs を最後の引数に指定した場合は、ユーザー設定ファイルの内容の方が前に指定したオプションに優先します。 - このオプションを設けた背景・理由は、 Eclipse プロジェクトの FindBugs の設定をコマンドライン実行で再利用するためです。

戻る   次へ
第3章 FindBugs™ のソールからのビルド ホーム 第5章 FindBugs GUI の使用方法
\ No newline at end of file diff --git a/ja/manual/warning.png b/ja/manual/warning.png deleted file mode 100644 index 1c33db8f34a8b42b373179b46a2d8d8a10e061a9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1241 zcmeHH+e?!H6#vDtmgHCxG{Q}12(7`~)|MMe^RnTlY0JD#q1sIwW1DTCqzzwWg@Q=t zBC2Iceu@w4LHM97Gb5%*E%9MN*%m}jvs!{N@Pd8$H}vS?TsRzlzr#5kPPe|YG%fXL zDu6VdR$WC$&Oc)^X#ZjK-7LU>{!F!o39xr+d_Vw5fMTEwpb-s#9q<5Nzz6gIepyU?Lctpr{ZK zVzWaWPAC)#17S8h%;AIuf(Q_yeIybEqS0s^i1YdJcsv0ln9M{Xkpz;-I_^=P))~D~!!Hvpq{Dl8O{rN@cECkt>#DncX%I(O&3i_YgL-$m$VU zT3cLBLS%M1`o{TBX}S|Tbhc)vk!Yp)%rdDd&my(RPsxl%lU$)tC?(1~WuEwClUQn! n$Q8O{Mxt@ukkcT{K0> diff --git a/manual-fo.xsl b/manual-fo.xsl deleted file mode 100644 index bcec6db..0000000 --- a/manual-fo.xsl +++ /dev/null @@ -1,30 +0,0 @@ - - - - - - - -1 - - -1 - - -manual/ - - -manual/ - - -5in - - -1 - - diff --git a/manual.xml b/manual.xml deleted file mode 100644 index 1c32a71..0000000 --- a/manual.xml +++ /dev/null @@ -1,4175 +0,0 @@ - -FindBugs"> -Ant"> -Saxon"> -$FINDBUGS_HOME"> -%FINDBUGS_HOME%"> - -]> - - - - -&FindBugs;™ Manual - - - - David - H. - Hovemeyer - - - William - W. - Pugh - - - - - 2003 - 2012 - University of Maryland - - - - -This manual is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike License. -To view a copy of this license, visit -http://creativecommons.org/licenses/by-nc-sa/1.0/ -or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA. - - -The name FindBugs and the FindBugs logo are trademarked by the University of Maryland. - - - -3.1.0-dev-20161105-d07b50f - -20:57:33 ART, 05 November, 2016 - - - - - - -Introduction - - &FindBugs;™ is a program to find bugs in Java programs. It looks for instances -of "bug patterns" --- code instances that are likely to be errors. - - This document describes version 3.1.0-dev-20161105-d07b50f of &FindBugs;.We -are very interested in getting your feedback on &FindBugs;. Please visit -the &FindBugs; web page for -the latest information on &FindBugs;, contact information, and support resources such -as information about the &FindBugs; mailing lists. - - -Requirements - To use &FindBugs;, you need a runtime environment compatible with -Java 2 Standard Edition, version 1.5 or later. -&FindBugs; is platform independent, and is known to run on GNU/Linux, Windows, and -MacOS X platforms. - -You should have at least 512 MB of memory to use &FindBugs;. -To analyze very large projects, more memory may be needed. - - - - - - - -Installing &FindBugs;™ - - -This chapter explains how to install &FindBugs;. - - - -Extracting the Distribution - - -The easiest way to install &FindBugs; is to download a binary distribution. -Binary distributions are available in -gzipped tar format and -zip format. -Once you have downloaded a binary distribution, extract it into a directory of your choice. - - - -Extracting a gzipped tar format distribution: - -$ gunzip -c findbugs-3.1.0-dev-20161105-d07b50f.tar.gz | tar xvf - - - - - -Extracting a zip format distribution: - -C:\Software>unzip findbugs-3.1.0-dev-20161105-d07b50f.zip - - - - -Usually, extracting a binary distribution will create a directory ending in -findbugs-3.1.0-dev-20161105-d07b50f. For example, if you extracted -the binary distribution from the C:\Software -directory, then the &FindBugs; software will be extracted into the directory -C:\Software\findbugs-3.1.0-dev-20161105-d07b50f. -This directory is the &FindBugs; home directory. We'll refer to it as -&FBHome; (or &FBHomeWin; for Windows) throughout this manual. - - - - - - - - -Building &FindBugs;™ from Source - - -This chapter describes how to build &FindBugs; from source code. Unless you are -interesting in modifying &FindBugs;, you will probably want to skip to the -next chapter. - - - -Prerequisites - - -To compile &FindBugs; from source, you will need the following: - - - - The &FindBugs; source distribution - - - - - JDK 1.5.0 or later - - - - - Apache &Ant;, version 1.6.3 or later - - - - - - - - The version of &Ant; included as /usr/bin/ant on - Redhat Linux systems will not work for compiling - &FindBugs;. We recommend you install a binary distribution of &Ant; - downloaded from the &Ant; website. - Make sure that when you run &Ant; your JAVA_HOME - environment variable points to the directory in which you installed - JDK 1.5 (or later). - - - - -If you want to be able to generate formatted versions of the &FindBugs; documentation, -you will also need the following software: - - - - The DocBook XSL Stylesheets. - These are required to convert the &FindBugs; manual into HTML format. - - - - - The &Saxon; XSLT Processor. - (Also required for converting the &FindBugs; manual to HTML.) - - - - - - - - - -Extracting the Source Distribution - -After you download the source distribution, you'll need to extract it into -a working directory. A typical command to do this is: - - -$ unzip findbugs-3.1.0-dev-20161105-d07b50f-source.zip - - - - - - -Modifying <filename>local.properties</filename> - -If you intend to build the FindBugs documentation, -you will need to modify the local.properties file -used by the &Ant; -build.xml file to build &FindBugs;. -If you do not want to build the FindBugs documentation, then you -can ignore this file. - - - -The local.properties overrides definitions -in the build.properties file. -The build.properties file looks something like this: - - - - - - -The xsl.stylesheet.home property specifies the full -path to the directory where you have installed the -DocBook Modular XSL -Stylesheets. You only need to specify this property if you will be -generating the &FindBugs; documentation. - - - -The saxon.home property is the full path to the -directory where you installed the &Saxon; XSLT Processor. -You only need to specify this property if you will be -generating the &FindBugs; documentation. - - - - - -Running &Ant; - - -Once you have extracted the source distribution, -made sure that &Ant; is installed, -modified build.properties (optional), -and configured the tools (such as &Saxon;), -you are ready to build &FindBugs;. Invoking &Ant; is a simple matter -of running the command - -$ ant target - -where target is one of the following: - - - build - - - This target compiles the code for &FindBugs;. It is the default target. - - - - - - docs - - - This target formats the documentation. (It also compiles some of - the source code as a side-effect.) - - - - - - runjunit - - - This target compiles and runs the internal JUnit tests included - in &FindBugs;. It will print an error message if any unit - tests fail. - - - - - - bindist - - - Builds a binary distribution of &FindBugs;. - The target creates both .zip and - .tar.gz archives. - - - - - - - -After running an &Ant; command, you should see output similar to -the following (after some other messages regarding the tasks that -&Ant; is running): - - -BUILD SUCCESSFUL -Total time: 17 seconds - - - - - - - -Running &FindBugs;™ from a source directory - -The &Ant; build script for &FindBugs; is written such that after -building the build target, the working directory -is set up just like a binary distribution. So, the information about -running &FindBugs; in -applies to source distributions, too. - - - - - - - - - -Running &FindBugs;™ - - -&FindBugs; has two user interfaces: a graphical user interface (GUI) and a -command line user interface. This chapter describes -how to run each of these user interfaces. - - - - - This chapter is in the process of being re-written. - The rewrite is not complete yet. - - - - - - - Quick Start - - If you are running &FindBugs; on a Windows system, - double-click on the file &FBHomeWin;\lib\findbugs.jar to start the &FindBugs; GUI. - - - - On a Unix, Linux, or Mac OS X system, run the &FBHome;/bin/findbugs - script, or run the command -java -jar &FBHome;/lib/findbugs.jar - to run the &FindBugs; GUI. - - - - Refer to for information on how to use the GUI. - - - - - - Executing &FindBugs; - - - This section describes how to invoke the &FindBugs; program. - There are two ways to invoke &FindBugs;: directly, or using a - wrapper script. - - - - - Direct invocation of &FindBugs; - - - The preferred method of running &FindBugs; is to directly execute - &FBHome;/lib/findbugs.jar using the -jar - command line switch of the JVM (java) executable. - (Versions of &FindBugs; prior to 1.3.5 required a wrapper script - to invoke &FindBugs;.) - - - - The general syntax of invoking &FindBugs; directly is the following: - - java [JVM arguments] -jar &FBHome;/lib/findbugs.jar options... - - - - - - - Choosing the User Interface - - - The first command line option chooses the &FindBugs; user interface to execute. - Possible values are: - - - - - -gui: runs the graphical user interface (GUI) - - - - - - -textui: runs the command line user interface - - - - - - -version: displays the &FindBugs; version number - - - - - - -help: displays help information for the - &FindBugs; command line user interface - - - - - - -gui1: executes the original (obsolete) - &FindBugs; graphical user interface - - - - - - - - Java Virtual Machine (JVM) arguments - - - Several Java Virtual Machine arguments are useful when invoking - &FindBugs;. - - - - - -XmxNNm - - - Set the maximum Java heap size to NN - megabytes. &FindBugs; generally requires a large amount of - memory. For a very large project, using 1500 megabytes - is not unusual. - - - - - - -Dname=value - - - Set a Java system property. For example, you might use the - argument -Duser.language=ja to display - GUI messages in Japanese. - - - - - - - - - - - - Invocation of &FindBugs; using a wrapper script - - - Another way to run &FindBugs; is to use a wrapper script. - - - -On Unix-like systems, use the following command to invoke the wrapper script: - -$ &FBHome;/bin/findbugs options... - - - - -On Windows systems, the command to invoke the wrapper script is - -C:\My Directory>&FBHomeWin;\bin\findbugs.bat options... - - - - -On both Unix-like and Windows systems, you can simply add the $FINDBUGS_HOME/bin -directory to your PATH environment variable and then invoke -FindBugs using the findbugs command. - - - - Wrapper script command line options - The &FindBugs; wrapper scripts support the following command-line options. - Note that these command line options are not handled by - the &FindBugs; program per se; rather, they are handled by the wrapper - script. - - - - -jvmArgs args - - - Specifies arguments to pass to the JVM. For example, you might want - to set a JVM property: - -$ findbugs -textui -jvmArgs "-Duser.language=ja" myApp.jar - - - - - - - -javahome directory - - - Specifies the directory containing the JRE (Java Runtime Environment) to - use to execute &FindBugs;. - - - - - - -maxHeap size - - - Specifies the maximum Java heap size in megabytes. The default is 256. - More memory may be required to analyze very large programs or libraries. - - - - - - -debug - - - Prints a trace of detectors run and classes analyzed to standard output. - Useful for troubleshooting unexpected analysis failures. - - - - - - -property name=value - - - This option sets a system property.  &FindBugs; uses system properties - to configure analysis options. See . - You can use this option multiple times in order to set multiple properties. - Note: In most versions of Windows, the name=value - string must be in quotes. - - - - - - - - - - - - - -Command-line Options - - - - - This section describes the command line options supported by &FindBugs;. - These command line options may be used when invoking &FindBugs; directly, - or when using a wrapper script. - - - -Common command-line options - - -These options may be used with both the GUI and command-line interfaces. - - - - - - -effort:min - - - This option disables analyses that increase precision but also - increase memory consumption. You may want to try this option if - you find that &FindBugs; runs out of memory, or takes an unusually - long time to complete its analysis. - - - - - - - -effort:max - - - Enable analyses which increase precision and find more bugs, but which - may require more memory and take more time to complete. - - - - - - -project project - - - Specify a project to be analyzed. The project file you specify should - be one that was created using the GUI interface. It will typically end - in the extension .fb or .fbp. - - - - - - - - - - - -GUI Options - - -These options are only accepted by the Graphical User Interface. - - - - -look:plastic|gtk|native - - - Set Swing look and feel. - - - - - - - - - -Text UI Options - - -These options are only accepted by the Text User Interface. - - - - - -sortByClass - - - Sort reported bug instances by class name. - - - - - - -include filterFile.xml - - - Only report bug instances that match the filter specified by filterFile.xml. - See . - - - - - - -exclude filterFile.xml - - - Report all bug instances except those matching the filter specified by filterFile.xml. - See . - - - - - - -onlyAnalyze com.foobar.MyClass,com.foobar.mypkg.* - - - Restrict analysis to find bugs to given comma-separated list of - classes and packages. - Unlike filtering, this option avoids running analysis on - classes and packages that are not explicitly matched: - for large projects, this may greatly reduce the amount of time - needed to run the analysis. (However, some detectors may produce - inaccurate results if they aren't run on the entire application.) - Classes should be specified using their full classnames (including - package), and packages should be specified in the same way - they would in a Java import statement to - import all classes in the package (i.e., add .* - to the full name of the package). - Replace .* with .- to also - analyze all subpackages. - - - - - - -low - - - Report all bugs. - - - - - - -medium - - - Report medium and high priority bugs. This is the default setting. - - - - - - -high - - - Report only high priority bugs. - - - - - - -relaxed - - - Relaxed reporting mode. For many detectors, this option - suppresses the heuristics used to avoid reporting false positives. - - - - - - -xml - - - Produce the bug reports as XML. The XML data produced may be - viewed in the GUI at a later time. You may also specify this - option as -xml:withMessages; when this variant - of the option is used, the XML output will contain human-readable - messages describing the warnings contained in the file. - XML files generated this way are easy to transform into reports. - - - - - - -html - - - Generate HTML output. By default, &FindBugs; will use the default.xsl - XSLT - stylesheet to generate the HTML: you can find this file in findbugs.jar, - or in the &FindBugs; source or binary distributions. Variants of this option include - -html:plain.xsl, -html:fancy.xsl and -html:fancy-hist.xsl. - The plain.xsl stylesheet does not use Javascript or DOM, - and may work better with older web browsers, or for printing. The fancy.xsl - stylesheet uses DOM and Javascript for navigation and CSS for - visual presentation. The fancy-hist.xsl an evolution of fancy.xsl stylesheet. - It makes an extensive use of DOM and Javascript for dynamically filtering the lists of bugs. - - - - If you want to specify your own - XSLT stylesheet to perform the transformation to HTML, specify the option as - -html:myStylesheet.xsl, - where myStylesheet.xsl is the filename of the - stylesheet you want to use. - - - - - - -emacs - - - Produce the bug reports in Emacs format. - - - - - - -xdocs - - - Produce the bug reports in xdoc XML format for use with Apache Maven. - - - - - - -output filename - - - Produce the output in the specified file. - - - - - - -outputFile filename - - - This argument is deprecated. Use -output instead. - - - - - - -nested[:true|false] - - - This option enables or disables scanning of nested jar and zip files found in - the list of files and directories to be analyzed. - By default, scanning of nested jar/zip files is enabled. - To disable it, add -nested:false to the command line - arguments. - - - - - - -auxclasspath classpath - - - Set the auxiliary classpath for analysis. This classpath should include all - jar files and directories containing classes that are part of the program - being analyzed but you do not want to have analyzed for bugs. - - - - - - -auxclasspathFromInput - - - Read the auxiliary classpath for analysis from standard input, each line adds new - entry to the auxiliary classpath for analysis. - - - - - - -auxclasspathFromFile filepath - - - Read the auxiliary classpath for analysis from file, each line adds new - entry to the auxiliary classpath for analysis. - - - - - - -analyzeFromFile filepath - - - Read the files to analyze from file, each line adds new - entry to the classpath for analysis. - - - - - - -userPrefs edu.umd.cs.findbugs.core.prefs - - - Set the path of the user preferences file to use, which might override some of the options abobe. - Specifying userPrefs as first argument would mean some later - options will override them, as last argument would mean they will override some previous options). - This rationale behind this option is to reuse FindBugs Eclipse project settings for command - line execution. - - - - - - - - - - - - - - - - Using the &FindBugs; GUI - - - This chapter describes how to use the &FindBugs; graphical user interface (GUI). - - - -Creating a Project - -After you have started &FindBugs; using the findbugs command, -choose the FileNew Project -menu item. You will see a dialog which looks like this: - - - - - - - - -Use the "Add" button next to "Classpath to analyze" to select a Java archive -file (zip, jar, ear, or war file) or directory containing java classes to analyze for bugs. You may add multiple -archives/directories. - - - -You can also add the source directories which contain -the source code for the Java archives you are analyzing. This will enable -&FindBugs; to highlight the source code which contains a possible error. -The source directories you add should be the roots of the Java -package hierarchy. For example, if your application is contained in the -org.foobar.myapp package, you should add the -parent directory of the org directory -to the source directory list for the project. - - - -Another optional step is to add additional Jar files or directories as -"Auxiliary classpath locations" entries. You should do this if the archives and directories you are analyzing -have references to other classes which are not included in the analyzed -archives/directories and are not in the standard runtime classpath. Some of the bug -pattern detectors in &FindBugs; make use of class hierarchy information, -so you will get more accurate results if the entire class hierarchy is -available which &FindBugs; performs its analysis. - - - - - -Running the Analysis - -Once you have added all of the archives, directories, and source directories, -click the "Analyze" button to analyze the classes contained in the -Jar files. Note that for a very large program on an older computer, -this may take quite a while (tens of minutes). A recent computer with -ample memory will typically be able to analyze a large program in only a -few minutes. - - - - -Browsing Results - - -When the analysis completes, you will see a screen like the following: - - - - - - - - -The upper left-hand pane of the window shows the bug tree; this is a hierarchical -representation of all of the potential bugs detected in the analyzed -Jar files. - - - -When you select a particular bug instance in the top pane, you will -see a description of the bug in the "Details" tab of the bottom pane. -In addition, the source code pane on the upper-right will show the -program source code where the potential bug occurs, if source is available. -In the above example, the bug is a stream object that is not closed. The -source code window highlights the line where the stream object is created. - - - -You may add a textual annotations to bug instances. To do so, type them -into the text box just below the hierarchical view. You can type any -information which you would like to record. When you load and save bug -results files, the annotations are preserved. - - - - - -Saving and Opening - - -You may use the FileSave as... -menu option to save your work. To save your work, including the jar -file lists you specified and all bug results, choose -"FindBugs analysis results (.xml)" from the drop-down list in the -"Save as..." dialog. There are also options for saving just the jar -file lists ("FindBugs project file (.fbp)") or just the results -("FindBugs analysis file (.fba)"). -A saved file may be loaded with the -FileOpen... -menu option. - - - - - - - - - - - -Using the &FindBugs;™ &Ant; task - - -This chapter describes how to integrate &FindBugs; into a build script -for &Ant;, which is a popular Java build -and deployment tool. Using the &FindBugs; &Ant; task, your build script can -automatically run &FindBugs; on your Java code. - - - -The &Ant; task was generously contributed by Mike Fagan. - - - -Installing the &Ant; task - - -To install the &Ant; task, simply copy &FBHome;/lib/findbugs-ant.jar -into the lib subdirectory of your &Ant; installation. - - -It is strongly recommended that you use the &Ant; task with the version -of &FindBugs; it was included with. We do not guarantee that the &Ant; task Jar file -will work with any version of &FindBugs; other than the one it was included with. - - - - - - -Modifying build.xml - - -To incorporate &FindBugs; into build.xml (the build script -for &Ant;), you first need to add a task definition. This should appear as follows: - - - <taskdef name="findbugs" classname="edu.umd.cs.findbugs.anttask.FindBugsTask"/> - - -The task definition specifies that when a findbugs element is -seen in build.xml, it should use the indicated class to execute the task. - - - -After you have added the task definition, you can define a target -which uses the findbugs task. Here is an example -which could be added to the build.xml for the -Apache BCEL library. - - - <property name="findbugs.home" value="/export/home/daveho/work/findbugs" /> - - <target name="findbugs" depends="jar"> - <findbugs home="${findbugs.home}" - output="xml" - outputFile="bcel-fb.xml" > - <auxClasspath path="${basedir}/lib/Regex.jar" /> - <sourcePath path="${basedir}/src/java" /> - <class location="${basedir}/bin/bcel.jar" /> - </findbugs> - </target> - - -The findbugs element must have the home -attribute set to the directory in which &FindBugs; is installed; in other words, -&FBHome;. See . - - - -This target will execute &FindBugs; on bcel.jar, which is the -Jar file produced by BCEL's build script. (By making it depend on the "jar" -target, we ensure that the library is fully compiled before running &FindBugs; on it.) -The output of &FindBugs; will be saved in XML format to a file called -bcel-fb.xml. -An auxiliary Jar file, Regex.jar, is added to the aux classpath, -because it is referenced by the main BCEL library. A source path is specified -so that the saved bug data will have accurate references to the BCEL source code. - - - - -Executing the task - - -Here is an example of invoking &Ant; from the command line, using the findbugs -target defined above. - - - [daveho@noir]$ ant findbugs - Buildfile: build.xml - - init: - - compile: - - examples: - - jar: - - findbugs: - [findbugs] Running FindBugs... - [findbugs] Bugs were found - [findbugs] Output saved to bcel-fb.xml - - BUILD SUCCESSFUL - Total time: 35 seconds - - -In this case, because we saved the bug results in an XML file, we can -use the &FindBugs; GUI to view the results; see . - - - - - -Parameters - -This section describes the parameters that may be specified when -using the &FindBugs; task. - - - - - class - - - A optional nested element specifying which classes to analyze. The class - element must specify a location attribute which names the - archive file (jar, zip, etc.), directory, or class file to be analyzed. Multiple class - elements may be specified as children of a single findbugs element. - - In addition to or instead of specifying a class element, - the &FindBugs; task can contain one or more fileset or dirset element(s) that - specify files or class folders to be analyzed. - For example, you might use a fileset to specify that all of the jar files in a directory - should be analyzed. - Using a dirset, you can have ANT dynamically collect the class folders of multiple sub-projects to be - analyzed in a single run. - - - - - - auxClasspath - - - An optional nested element which specifies a classpath (Jar files or directories) - containing classes used by the analyzed library or application, but which - you don't want to analyze. It is specified the same way as - &Ant;'s classpath element for the Java task. - - - - - - sourcePath - - - An optional nested element which specifies a source directory path - containing source files used to compile the Java code being analyzed. - By specifying a source path, any generated XML bug output will have - complete source information, which allows later viewing in the - GUI. - - - - - - home - - - A required attribute. - It must be set to the name of the directory where &FindBugs; is installed. - - - - - - quietErrors - - - An optional boolean attribute. - If true, reports of serious analysis errors and missing classes will - be suppressed in the &FindBugs; output. Default is false. - - - - - - reportLevel - - - An optional attribute. It specifies - the confidence/priority threshold for reporting issues. If set to "low", confidence is not used to filter bugs. - If set to "medium" (the default), low confidence issues are suppressed. - If set to "high", only high confidence bugs are reported. - - - - - - output - - - Optional attribute. - It specifies the output format. If set to "xml" (the default), output - is in XML format. - If set to "xml:withMessages", output is in XML format augmented with - human-readable messages. (You should use this format if you plan - to generate a report using an XSL stylesheet.) - If set to "html", output is in HTML formatted (default stylesheet is default.xsl). - If set to "text", output is in ad-hoc text format. - If set to "emacs", output is in Emacs error message format. - If set to "xdocs", output is xdoc XML for use with Apache Maven. - - - - - stylesheet - - - Optional attribute. - It specifies the stylesheet to use to generate html output when the output is set to html. - Stylesheets included in the FindBugs distribution include default.xsl, fancy.xsl, fancy-hist.xsl, plain.xsl, and summary.xsl. - The default value, if no stylesheet attribute is provided, is default.xsl. - - - - - - - sort - - - Optional attribute. If the output attribute - is set to "text", then the sort attribute specifies - whether or not reported bugs are sorted by class. Default is true. - - - - - - outputFile - - - Optional attribute. If specified, names the output file in which the - &FindBugs; output will be saved. By default, the output is displayed - directly by &Ant;. - - - - - - debug - - - Optional boolean attribute. If set to true, &FindBugs; prints diagnostic - information about which classes are being analyzed, and which bug pattern - detectors are being run. Default is false. - - - - - - effort - - - Set the analysis effort level. The value specified should be - one of min, default, - or max. See - for more information about setting the analysis level. - - - - - - conserveSpace - - Synonym for effort="min". - - - - - workHard - - Synonym for effort="max". - - - - - visitors - - - Optional attribute. It specifies a comma-separated list of bug detectors - which should be run. The bug detectors are specified by their class names, - without any package qualification. By default, all detectors which are - not disabled by default are run. - - - - - - omitVisitors - - - Optional attribute. It specifies a comma-separated list of bug detectors. - It is like the visitors attribute, - except it specifies detectors which will not be run. - - - - - - chooseVisitors - - - Optional attribute. It specifies a comma-separated list of bug detectors - prefixed with "+" or "-" to selectively enable/disable them. - - - - - - excludeFilter - - - Optional attribute. It specifies the filename of a filter specifying bugs - to exclude from being reported. See . - - - - - - excludePath - - - Since Findbugs 3.0.2. - - - An optional nested element which specifies a path - containing filters specifying bugs - to exclude from being reported. See . - - - Example: - - - <findbugs home="${findbugs.home}"> - <excludePath> - <path> - <fileset dir="${findbugs-exclusion-filters.dir}" includes="findbugs-*-exclude-filter.xml" /> - </path> - </excludePath> - </findbugs> - - - See Apache Ant's Path-like Structures documentation for details. - - - - - - includeFilter - - - Optional attribute. It specifies the filename of a filter specifying - which bugs are reported. See . - - - - - - includePath - - - Since Findbugs 3.0.2. - - - An optional nested element which specifies a path - containing filters specifying which bugs - are reported. See . - - - Example: - - - <findbugs home="${findbugs.home}"> - <includePath> - <path> - <fileset dir="${findbugs-inclusion-filters.dir}" includes="findbugs-*-include-filter.xml" /> - </path> - </includePath> - </findbugs> - - - See Apache Ant's Path-like Structures documentation for details. - - - - - - projectFile - - - Optional attribute. It specifies the name of a project file. - Project files are created by the &FindBugs; GUI, and specify classes, - aux classpath entries, and source directories. By naming a project, - you don't need to specify any class elements, - nor do you need to specify auxClasspath or - sourcePath attributes. - See for how to create a project. - - - - - - jvmargs - - - Optional attribute. It specifies any arguments that should be passed - to the Java virtual machine used to run &FindBugs;. You may need to - use this attribute to specify flags to increase the amount of memory - the JVM may use if you are analyzing a very large program. - - - - - - systemProperty - - - Optional nested element. If specified, defines a system property. - The name attribute specifies the name of the - system property, and the value attribute specifies - the value of the system property. - - - - - - timeout - - - Optional attribute. It specifies the amount of time, in milliseconds, - that the Java process executing &FindBugs; may run before it is - assumed to be hung and is terminated. The default is 600,000 - milliseconds, which is ten minutes. Note that for very large - programs, &FindBugs; may require more than ten minutes to complete its - analysis. - - - - - - failOnError - - - Optional boolean attribute. Whether to abort the build process if there is an - error running &FindBugs;. Defaults to "false" - - - - - - errorProperty - - - Optional attribute which specifies the name of a property that - will be set to "true" if an error occurs while running &FindBugs;. - - - - - - warningsProperty - - - Optional attribute which specifies the name of a property - that will be set to "true" if any warnings are reported by - &FindBugs; on the analyzed program. - - - - - - userPreferencesFile - - - Optional attribute. Set the path of the user preferences file to use, which might override some of the options abobe. - Specifying userPreferencesFile as first argument would mean some later - options will override them, as last argument would mean they will override some previous options). - This rationale behind this option is to reuse FindBugs Eclipse project settings for command - line execution. - - - - - - nested - - - Optional attribute which enables or disables scanning of nested jar and zip files found in - the list of files and directories to be analyzed. - By default, scanning of nested jar/zip files is enabled. - - - - - - setExitCode - - - Optional boolean attribute. Whether the exit code will be returned to - the main ant job. Defaults to "true". - - - - - - pluginList - - - A optional String attribute or optional nested element specifying which BugDetector Jar files to add.. The pluginList - element must specify a location attribute which names the - archive file (jar, zip, etc.), directory, or class file to be analyzed. Multiple pluginList - elements may be specified as children of a single findbugs element. - - - - - - - - - - - - - - - - - - -Using the &FindBugs;™ Eclipse plugin - - -The FindBugs Eclipse plugin allows &FindBugs; to be used within -the Eclipse IDE. -The FindBugs Eclipse plugin was generously contributed by Peter Friese. -Phil Crosby and Andrey Loskutov contributed major improvements -to the plugin. - - - -Requirements - - -To use the &FindBugs; Plugin for Eclipse, you need Eclipse 3.3 or later, -and JRE/JDK 1.5 or later. - - - - - -Installation - - - We provide update sites that allow you to automatically install FindBugs into Eclipse and also query and install updates. - There are three different update sites - - FindBugs Eclipse update sites - http://findbugs.cs.umd.edu/eclipse/ - - - - Only provides official releases of FindBugs. - - - - - http://findbugs.cs.umd.edu/eclipse-candidate/ - - - - Provides official releases and release candidates of FindBugs. - - - - - http://findbugs.cs.umd.edu/eclipse-daily/ - - - - Provides the daily build of FindBugs. No testing other than that it compiles. - - - - - -You can also manually -download the plugin from the following link: -http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_3.1.0.20161105.zip?download. -Extract it in Eclipse's "plugins" subdirectory. -(So <eclipse_install_dir>/plugins/edu.umd.cs.findbugs.plugin.eclipse_3.1.0.20161105/findbugs.png -should be the path to the &FindBugs; logo.) - - - - -Once the plugin is extracted, start Eclipse and choose - - Help - About Eclipse Platform - Plug-in Details -. -You should find a plugin called "FindBugs Plug-in" provided by "FindBugs Project". - - - - -Using the Plugin - - -To get started, right click on a Java project in Package Explorer, -and select the option labeled "Find Bugs". -&FindBugs; will run, and problem markers (displayed in source -windows, and also in the Eclipse Problems view) will point to -locations in your code which have been identified as potential instances -of bug patterns. - - -You can also run &FindBugs; on existing java archives (jar, ear, zip, war etc). Simply -create an empty Java project and attach archives to the project classpath. Having that, you -can now right click the archive node in Package Explorer and select the option labeled -"Find Bugs". If you additionally configure the source code locations for the binaries, -&FindBugs; will also link the generated warnings to the right source files. - - -You may customize how &FindBugs; runs by opening the Properties -dialog for a Java project, and choosing the "Findbugs" property page. -Options you may choose include: - - - - - - Enable or disable the "Run FindBugs Automatically" checkbox. - When enabled, FindBugs will run every time you modify a Java class - within the project. - - - - - - Choose minimum warning priority and enabled bug categories. - These options will choose which warnings are shown. - For example, if you select the "Medium" warning priority, - only Medium and High priority warnings will be shown. - Similarly, if you uncheck the "Style" checkbox, no warnings - in the Style category will be displayed. - - - - - - Select detectors. The table allows you to select which detectors - you want to enable for your project. - - - - - - - -Extending the Eclipse Plugin (since 2.0.0) - -Eclipse plugin supports contribution of custom &FindBugs; detectors (see also -AddingDetectors.txt -for more information). There are two ways to contribute custom plugins to the Eclipse: - - - - - Existing standard &FindBugs; detector packages can be configured via - - Window - Preferences - Java - FindBugs - Misc. Settings - Custom Detectors - . - Simply specify there locations of any additional plugin libraries. - - - - The benefit of this solution is that already existing detector packages can be - used "as is", and that you can quickly verify the quality of third party detectors. - The drawback is that you have to apply this settings in each - new Eclipse workspace, and this settings can't be shared between team members. - - - - - - It is possible to contribute custom detectors via standard Eclipse extensions mechanism. - - - - Please check the documentation of the - - findBugsEclipsePlugin/schema/detectorPlugins.exsd - extension point how to update the plugin.xml. Existing &FindBugs; detector plugins can - be easily "extended" to be full featured &FindBugs; AND Eclipse detector plugins. - Usually you only need to add META-INF/MANIFEST.MF and plugin.xml to the jar and - update your build scripts to not to override the MANIFEST.MF during the build. - - - - The benefit of this solution is that for given (shared) Eclipse installation - each team member has exactly same detectors set, and there is no need to configure - anything anymore. The (really small) precondition - is that you have to convert your existing detectors package to the valid - Eclipse plugin. You can do this even for third-party detector packages. - Another major differentiator is the ability to extend the default FindBugs - classpath at runtime with required third party libraries (see - AddingDetectors.txt - for more information). - - - - - - - - -Troubleshooting - - -This section lists common problems with the plugin and (if known) how to resolve them. - - - - - - If you see OutOfMemory error dialogs after starting &FindBugs; analysis in Eclipse, - please increase JVM available memory: change eclipse.ini and add the lines below - to the end of the file: - - -vmargs - -Xmx1000m - - Important: the configuration arguments starting with the line "-vmargs" must - be last lines in the eclipse.ini file, and only one argument per line is allowed! - - - - - If you do not see any &FindBugs; problem markers (in your source - windows or in the Problems View), you may need to change your - Problems View filter settings. See - http://findbugs.sourceforge.net/FAQ.html#q7 for more information. - - - - - - - - - - - - - - -Filter Files - - -Filter files may be used to include or exclude bug reports for particular classes -and methods. This chapter explains how to use filter files. - - - - -Introduction to Filter Files - - -Conceptually, a filter matches bug instances against a set of criteria. -By defining a filter, you can select bug instances for special treatment; -for example, to exclude or include them in a report. - - - -A filter file is an XML document with a top-level FindBugsFilter element -which has some number of Match elements as children. Each Match -element represents a predicate which is applied to generated bug instances. -Usually, a filter will be used to exclude bug instances. For example: - - -$ findbugs -textui -exclude myExcludeFilter.xml myApp.jar - - -However, a filter could also be used to select bug instances to specifically -report: - - -$ findbugs -textui -include myIncludeFilter.xml myApp.jar - - - - -Match elements contain children, which are conjuncts of the predicate. -In other words, each of the children must be true for the predicate to be true. - - - - - -Types of Match clauses - - - - <Bug> - - This element specifies a particular bug pattern or patterns to match. - The pattern attribute is a comma-separated list of - bug pattern types. You can find the bug pattern types for particular - warnings by looking at the output produced by the -xml - output option (the type attribute of BugInstance - elements), or from the bug - descriptions document. - - For more coarse-grained matching, use code attribute. It takes - a comma-separated list of bug abbreviations. For most-coarse grained matching use - category attriute, that takes a comma separated list of bug category names: - CORRECTNESS, MT_CORRECTNESS, - BAD_PRACTICICE, PERFORMANCE, STYLE. - - If more than one of the attributes mentioned above are specified on the same - <Bug> element, all bug patterns that match either one of specified - pattern names, or abreviations, or categories will be matched. - - As a backwards compatibility measure, <BugPattern> and - <BugCode> elements may be used instead of - <Bug> element. Each of these uses a - name attribute for specifying accepted values list. Support for these - elements may be removed in a future release. - - - - - <Confidence> - - - This element matches warnings with a particular bug confidence. - The value attribute should be an integer value: - 1 to match high-confidence warnings, 2 to match normal-confidence warnings, - or 3 to match low-confidence warnings. <Confidence> replaced - <Priority> in 2.0.0 release. - - - - - - <Priority> - - - Same as <Confidence>, exists for backward compatibility. - - - - - - <Rank> - - - This element matches warnings with a particular bug rank. - The value attribute should be an integer value - between 1 and 20, where 1 to 4 are scariest, 5 to 9 scary, 10 to 14 troubling, - and 15 to 20 of concern bugs. - - - - - - <Package> - - - This element matches warnings associated with classes within the package specified - using name attribute. Nested packages are not included (along the - lines of Java import statement). However matching multiple packages can be achieved - easily using regex name match. - - - - - - <Class> - - - This element matches warnings associated with a particular class. The - name attribute is used to specify the exact or regex match pattern - for the class name. The role attribute is the class role. - - - - As a backward compatibility measure, instead of element of this type, you can use - class attribute on a Match element to specify - exact an class name or classregex attribute to specify a regular - expression to match the class name against. - - - - If the Match element contains neither a Class element, - nor a class / classregex attribute, the predicate will apply - to all classes. Such predicate is likely to match more bug instances than you want, unless it is - refined further down with appropriate method or field predicates. - - - - - - <Source> - - - This element matches warnings associated with a particular source file. The - name attribute is used to specify the exact or regex match pattern - for the source file name. - - - - - - <Method> - - This element specifies a method. The name is used to specify - the exact or regex match pattern for the method name. - The params attribute is a comma-separated list - of the types of the method's parameters. The returns attribute is - the method's return type. The role attribute is - the method role. In params and returns, class names - must be fully qualified. (E.g., "java.lang.String" instead of just - "String".) If one of the latter attributes is specified the other is required for creating a method signature. - Note that you can provide either name attribute or params - and returns attributes or all three of them. This way you can provide various kinds of - name and signature based matches. - - - - - <Field> - - This element specifies a field. The name attribute is is used to specify - the exact or regex match pattern for the field name. You can also filter fields according to their signature - - use type attribute to specify fully qualified type of the field. You can specify either or both - of these attributes in order to perform name / signature based matches. The role attribute is - the field role. - - - - - <Local> - - This element specifies a local variable. The name attribute is is used to specify - the exact or regex match pattern for the local variable name. Local variables are variables defined within a method. - - - - - <Or> - - This element combines Match clauses as disjuncts. I.e., you can put two - Method elements in an Or clause in order to match either method. - - - - <And> - - This element combines Match clauses which both must evaluate to true. I.e., you can put - Bug and Confidence elements in an And clause in order - to match specific bugs with given confidence only. - - - - <Not> - - This element inverts the included child Match. I.e., you can put a - Bug element in a Not clause in order to match any bug - excluding the given one. - - - - - - - -Java element name matching - - -If the name attribute of Class, Source, -Method or Field starts with the ~ character -the rest of attribute content is interpreted as -a Java regular expression that is matched against the names of the Java element in question. - - - -Note that the pattern is matched against whole element name and therefore .* clauses need to be used -at pattern beginning and/or end to perform substring matching. - - - -See java.util.regex.Pattern -documentation for pattern syntax. - - - - -Caveats - - -Match clauses can only match information that is actually contained in the -bug instances. Every bug instance has a class, so in general, excluding -bugs by class will work. - - - -Some bug instances have two (or more) classes. For example, the DE (dropped exception) -bugs report both the class containing the method where the dropped exception -happens, and the class which represents the type of the dropped exception. -Only the first (primary) class is matched against Match clauses. -So, for example, if you want to suppress IC (initialization circularity) -reports for classes "com.foobar.A" and "com.foobar.B", you would use -two Match clauses: - - - <Match> - <Class name="com.foobar.A" /> - <Bug code="IC" /> - </Match> - - <Match> - <Class name="com.foobar.B" /> - <Bug code="IC" /> - </Match> - - -By explicitly matching both classes, you ensure that the IC bug instance will be -matched regardless of which class involved in the circularity happens to be -listed first in the bug instance. (Of course, this approach might accidentally -suppress circularities involving "com.foobar.A" or "com.foobar.B" and a third -class.) - - - -Many kinds of bugs report what method they occur in. For those bug instances, -you can put Method clauses in the Match element and they should work -as expected. - - - - - -Examples - - - 1. Match all bug reports for a class. - - - - - -]]> - - - - - - 2. Match certain tests from a class by specifying their abbreviations. - - - - - -]]> - - - - - 3. Match certain tests from all classes by specifying their abbreviations. - - - - - -]]> - - - - - 4. Match certain tests from all classes by specifying their category. - - - - - -]]> - - - - - 5. Match bug types from specified methods of a class by their abbreviations. - - - - - - - - - - -]]> - - - - - 6. Match a particular bug pattern in a particular method. - - - - - - - - -]]> - - - - - 7. Match a particular bug pattern with a given priority in a particular method. - - - - - - - - - -]]> - - - - - 8. Match minor bugs introduced by AspectJ compiler (you are probably not interested in these unless - you are an AspectJ developer). - - - - - - - - - - - -]]> - - - - - 9. Match bugs in specific parts of the code base - - - - - - - - - - - - - - - - - -]]> - - - - - 10. Match bugs on fields or methods with specific signatures - - - - - - - - - - - -]]> - - - - - - 11. Match bugs using the Not filter operator - - - - - - - - - - - - - -]]> - - - - - 12. Full exclusion filter file to match all classes generated from Groovy source files. - - - - - - - - -]]> - - - - - - -Complete Example - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -]]> - - - - - - - - - - - -Analysis Properties - - -&FindBugs; allows several aspects of the analyses it performs to be -customized. System properties are used to configure these options. -This chapter describes the configurable analysis options. - - - -The analysis options have two main purposes. First, they allow you -to inform &FindBugs; about the meaning of methods in your application, -so that it can produce more accurate results, or produce fewer -false warnings. Second, they allow you to configure the precision -of the analysis performed. Reducing analysis precision can save -memory and analysis time, at the expense of missing some real bugs, -or producing more false warnings. - - - -The analysis options are set using the -property -command line option. For example: - -$ findbugs -textui -property "cfg.noprune=true" myApp.jar - - - - -The list of configurable analysis properties is shown in -. - - - -Configurable Analysis Properties - - - - Property Name - Value - Meaning - - - - - - findbugs.assertionmethods - Comma-separated list of fully qualified method names: - e.g., "com.foo.MyClass.checkAssertion" - This property specifies the names of methods that are used - to check program assertions. Specifying these methods allows - the null pointer dereference bug detector to avoid reporting - false warnings for values which are checked by assertion - methods. - - - findbugs.de.comment - true or false - If true, the DroppedException detector scans source code - for empty catch blocks for a comment, and if one is found, does - not report a warning. - - - findbugs.maskedfields.locals - true or false - If true, emit low priority warnings for local variables - which obscure fields. Default is false. - - - findbugs.nullderef.assumensp - true or false - not used - (intention: If true, the null dereference detector assumes that any - reference value returned from a method or passed to a method - in a parameter might be null. Default is false. Note that - enabling this property will very likely cause a large number - of false warnings to be produced.) - - - findbugs.refcomp.reportAll - true or false - If true, all suspicious reference comparisons - using the == and != operators are reported.  If false, - only one such warning is issued per method.  Default - is false. - - - findbugs.sf.comment - true or false - If true, the SwitchFallthrough detector will only report - warnings for cases where the source code does not have a comment - containing the words "fall" or "nobreak". (An accurate source - path must be used for this feature to work correctly.) - This helps find cases where the switch fallthrough is likely - to be unintentional. - - - - -
- - - - - - -Annotations - - -&FindBugs; supports several annotations to express the developer's intent -so that FindBugs can issue warnings more appropriately. You need to use -Java 5 to use annotations, and must place the annotations.jar and jsr305.jar -files in the classpath while compiling your program. - - - - - edu.umd.cs.findbugs.annotations.CheckForNull - - - [Target] Field, Method, Parameter - - - - -The annotated element might be null, and uses of the element should check for null. -When this annotation is applied to a method it applies to the method return value. - - - - - - edu.umd.cs.findbugs.annotations.CheckReturnValue - - - [Target] Method, Constructor - - - - - - [Parameter] - - - priority:The priority of the warning (HIGH, MEDIUM, LOW, IGNORE). Default value:MEDIUM. - - - - - explanation:A textual explanation of why the return value should be checked. Default value:"". - - - - - - - -This annotation is used to denote a method whose return value should always be checked after invoking the method. - - - - - - edu.umd.cs.findbugs.annotations.DefaultAnnotation - - - [Target] Type, Package - - - - - - [Parameter] - - - value:Annotation class objects. More than one class can be specified. - - - - - priority:Default priority(HIGH, MEDIUM, LOW, IGNORE). Default value:MEDIUM. - - - - - - - -Indicates that all members of the class or package should be annotated with the default -value of the supplied annotation classes. This would be used for behavior annotations -such as @NonNull, @CheckForNull, or @CheckReturnValue. In particular, you can use -@DefaultAnnotation(NonNull.class) on a class or package, and then use @Nullable only -on those parameters, methods or fields that you want to allow to be null. - - - - - - edu.umd.cs.findbugs.annotations.DefaultAnnotationForFields - - - [Target] Type, Package - - - - - - [Parameter] - - - value:Annotation class objects. More than one class can be specified. - - - - - priority:Default priority(HIGH, MEDIUM, LOW, IGNORE). Default value:MEDIUM. - - - - - - - -This is same as the DefaultAnnotation except it only applys to fields. - - - - - - edu.umd.cs.findbugs.annotations.DefaultAnnotationForMethods - - - [Target] Type, Package - - - - - - [Parameter] - - - value:Annotation class objects. More than one class can be specified. - - - - - priority:Default priority(HIGH, MEDIUM, LOW, IGNORE). Default value:MEDIUM. - - - - - - - -This is same as the DefaultAnnotation except it only applys to methods. - - - - - - edu.umd.cs.findbugs.annotations.DefaultAnnotationForParameters - - - [Target] Type, Package - - - - - - [Parameter] - - - value:Annotation class objects. More than one class can be specified. - - - - - priority:Default priority(HIGH, MEDIUM, LOW, IGNORE). Default value:MEDIUM. - - - - - - - -This is same as the DefaultAnnotation except it only applys to method parameters. - - - - - - edu.umd.cs.findbugs.annotations.NonNull - - - [Target] Field, Method, Parameter - - - - -The annotated element must not be null. -Annotated fields must not be null after construction has completed. Annotated methods must have non-null return values. - - - - - - edu.umd.cs.findbugs.annotations.Nullable - - - [Target] Field, Method, Parameter - - - - -The annotated element could be null under some circumstances. In general, this means -developers will have to read the documentation to determine when a null value is -acceptable and whether it is necessary to check for a null value. FindBugs will -treat the annotated items as though they had no annotation. - - -In practice this annotation is useful only for overriding an overarching NonNull -annotation. - - - - - - edu.umd.cs.findbugs.annotations.OverrideMustInvoke - - - [Target] Method - - - - - - [Parameter] - - - value:Specify when the super invocation should be - performed (FIRST, ANYTIME, LAST). Default value:ANYTIME. - - - - - - - -Used to annotate a method that, if overridden, must (or should) be invoke super -in the overriding method. Examples of such methods include finalize() and clone(). -The argument to the method indicates when the super invocation should occur: -at any time, at the beginning of the overriding method, or at the end of the overriding method. -(This anotation is not implmemented in FindBugs as of September 8, 2006). - - - - - - edu.umd.cs.findbugs.annotations.PossiblyNull - - -This annotation is deprecated. Use CheckForNull instead. - - - - - - edu.umd.cs.findbugs.annotations.SuppressWarnings - - - [Target] Type, Field, Method, Parameter, Constructor, Package - - - - - - [Parameter] - - - value:The name of the warning. More than one name can be specified. - - - - - justification:Reason why the warning should be ignored. Default value:"". - - - - - - - -The set of warnings that are to be suppressed by the compiler in the annotated element. -Duplicate names are permitted. The second and successive occurrences of a name are ignored. -The presence of unrecognized warning names is not an error: Compilers -must ignore any warning names they do not recognize. They are, however, free to emit a -warning if an annotation contains an unrecognized warning name. Compiler vendors should -document the warning names they support in conjunction with this annotation type. They -are encouraged to cooperate to ensure that the same names work across multiple compilers. - - - - - - edu.umd.cs.findbugs.annotations.UnknownNullness - - - [Target] Field, Method, Parameter - - - - -Used to indicate that the nullness of the target is unknown, or my vary in unknown ways in subclasses. - - - - - - edu.umd.cs.findbugs.annotations.UnknownNullness - - - [Target] Field, Method, Parameter - - - - -Used to indicate that the nullness of the target is unknown, or my vary in unknown ways in subclasses. - - - - - - - &FindBugs; also supports the following annotations: - - net.jcip.annotations.GuardedBy - net.jcip.annotations.Immutable - net.jcip.annotations.NotThreadSafe - net.jcip.annotations.ThreadSafe - - - -You can refer the JCIP annotation -API documentation at Java Concurrency in Practice. - - - - - - -Using rejarForAnalysis - - -If your project consists of many jarfiles or the jarfiles are scattered -over many directories, you may wish to use the rejarForAnalysis - script to make -FindBugs invocation easier. The script collects many jarfiles and combines them -into a single, large jarfile that can then be easily passed to FindBugs for -analysis. This can be particularly useful in combination with the 'find' command -on unix systems; e.g. find . -name '*.jar' | xargs rejarForAnalysis -. - - - -The rejarForAnalysis script -can also be used to split a very large project up into a set of jarfiles with -the project classfiles evenly divided between them. This is useful when running -FindBugs on the entire project is not practical due to time or memory consumption. -Instead of running FindBugs on the entire project, you may use -rejarForAnalysis build one large, all-inclusive jarfile -containing all classes, invoke rejarForAnalysis -again to split the project into multiple jarfiles, then run FindBugs -on each divided jarfiles in turn, specifying the the all-inclusive jarfile in -the -auxclasspath. - - - -These are the options accepted by the rejarForAnalysis script: - - - - - -maxAge days - - - Maximum age in days (ignore jar files older than this). - - - - - -inputFileList filename - - - Text file containing names of jar files. - - - - - -maxClasses num - - - Maximum number of classes per analysis*.jar file. - - - - - -prefix class name prefix - - - Prefix of class names that should be analyzed (e.g., edu.umd.cs.). - - - - - - - - - - Data mining of bugs with &FindBugs;™ - - -FindBugs incorporates an ability to perform sophisticated queries on bug -databases and track warnings across multiple versions of code being -studied, allowing you to do things such as seeing when a bug was first introduced, examining -just the warnings that have been introduced since the last release, or graphing the number -of infinite recursive loops in your code over time. - - -These techniques all depend upon the XML format used by FindBugs for storing warnings. -These XML files usually contain just the warnings from one particular analysis run, but -they can also store the results from analyzing a sequence of software builds or versions. - - - -Any FindBugs XML bug database contains a version name and timestamp. -FindBugs tries to compute a timestamp from the timestamps of the files that -are analyzed (e.g., the timestamp is intended to be the time the class files -were generated, not analyzed). Each bug database also contains a version name. -Both the version name and timestamp can be set manually using the -setBugDatabaseInfo () command. - - -A multiversion bug database assigns a sequence number to each version of -the analyzed code. These sequence numbers are simply successive integers, -starting at 0 (e.g., a bug database for 4 versions of the code will contain -versions 0..3). The bug database will also record the name and timestamp for -each version. The filterBugs command allows you to refer -to a version by sequence number, name or timestamp. - - -You can take a sequence (or pair) of single version bug databases and create -from them a multiversion bug database, or combine a multiversion bug database -with a sequence of later single-version bug databases. - - -Some of these commands can be invoked as ant tasks. See below for specifics -on how to invoke them and what attributes and arguments they take. All of -the examples assume that the findbugs.lib -refid is set correctly. Here is one way to set it: - - - - - - - - - - -]]> - - - - Commands - - -All tools for FindBugs data mining are can be invoked from the command line, -and some of the more useful tools can also be invoked from an -ant build file. - - -Briefly, the command-line tools are: - - - - unionBugs - - - combine the results from separate analysis of disjoint - classes - - - - - computeBugHistory - - Merge bug warnings from multiple versions of - analyzed code into - a single multiversion bug database. This can either be used - to add more versions to an existing multiversion database, - or to create a multiversion database from a sequence of single version - bug warning databases. - - - - setBugDatabaseInfo - - Set information such as the revision name or -timestamp in an XML bug database - - - - listBugDatabaseInfo - - List information such as the revision name and -timestamp for a list of XML bug databases - - - - filterBugs - - Select a subset of a bug database - - - - mineBugHistory - - Generate a tabular listing of the number of warnings in each - version of a multiversion bug database - - - - defectDensity - - List information about defect density - (warnings per 1000 NCSS) - for the entire project and each class and package - - - - convertXmlToText - - Convert bug warnings in XML format to - a textual one-line-per-bug format, or to HTML - - - - - - - unionBugs - - - If you have, for example, separately analyzing each jar file used in an application, - you can use this command to combine the separately generated xml bug warning files into - a single file containing all of the warnings. - - Do not use this command to combine results from analyzing different versions of the same - file; use computeBugHistory instead. - - Specify the xml files on the command line. The result is sent to standard output. - - - - computeBugHistory - -Use this command to generate a bug database containing information from different builds or versions -of software you are analyzing. -History is taken from the first file provided as input; any following -files should be single version bug databases (if they contain history, the history in those -files will be ignored). -By default, output is written to the standard output. - - -This functionality may also can be accessed from ant. -First create a taskdef for computeBugHistory in your -build file: - - - - - - -]]> - - -Attributes for this ant task are listed in the following table. -To specify input files, nest them inside with a -<datafile> element. For example: - - - - - - - -]]> - - - - Options for computeBugHistory command - - - - Command-line option - Ant attribute - Meaning - - - --output <file> output="<file>" save output in the named file (may also be an input file) --overrideRevisionNames[:truth] overrideRevisionNames="[true|false]"override revision names for each version with names computed from the filenames --noPackageMoves[:truth] noPackageMoves="[true|false]"if a class has moved to another package, treat warnings in that class as separate --preciseMatch[:truth] preciseMatch="[true|false]"require bug patterns to match precisely --precisePriorityMatch[:truth] precisePriorityMatch="[true|false]"consider two warnings as the same only if priorities match exactly --quiet[:truth] quiet="[true|false]"don't generate any output to standard out unless there is an error --withMessages[:truth] withMessages="[true|false]"include human-readable messages describing the warnings in XML output - - -
- - - - filterBugs -This command is used to select a subset of warnings from a FindBugs XML warning file -and write the selected subset to a new FindBugs warning file. - -This command takes a sequence of options, and either zero, one or two -filenames of findbugs xml bug files on the command line. -If no file names are provided, the command reads from standard input -and writes to standard output. If one file name is provided, -it reads from the file and writes to standard output. -If two file names are provided, it reads from the first and writes the output -to the second file name. - -This functionality may also can be accessed from ant. -First create a taskdef for filterBugs in your -build file: - - - - - - -]]> - - -Attributes for this ant task are listed in the following table. -To specify an input file either use the input attribute or nest it inside -the ant call with a <datafile> element. For example: - - - - - - -]]> - - - - Options for filterBugs command - - - - Command-line option - Ant attribute - Meaning - - - - input="<file>" use file as input - output="<file>" output results to file --not not="[true|false]" reverse (all) switches for the filter --withSource[:truth] withSource="[true|false]" only warnings for switch source is available --exclude <filter file>exclude="<filter file>" exclude bugs matching given filter --include <filter file>include="<filter file>" include only bugs matching given filter --annotation <text> annotation="<text>" allow only warnings containing this text in a manual annotation --after <when> after="<when>" allow only warnings that first occurred after this version --before <when> before="<when>" allow only warnings that first occurred before this version --first <when> first="<when>" allow only warnings that first occurred in this version --last <when> last="<when>" allow only warnings that last occurred in this version --fixed <when> fixed="<when>" allow only warnings that last occurred in the previous version (clobbers ) --present <when> present="<when>" allow only warnings present in this version --absent <when> absent="<when>" allow only warnings absent in this version --active[:truth] active="[true|false]" allow only warnings alive in the last sequence number --introducedByChange[:truth] introducedByChange="[true|false]"allow only warnings introduced by a change of an existing class --removedByChange[:truth] removedByChange="[true|false]" allow only warnings removed by a change of a persisting class --newCode[:truth] newCode="[true|false]" allow only warnings introduced by the addition of a new class --removedCode[:truth] removedCode="[true|false]" allow only warnings removed by removal of a class --priority <level> priority="<level>" allow only warnings with this priority or higher --maxRank <rank> rank="[1..20]" allow only warnings with this rank or lower --class <pattern> class="<class>" allow only bugs whose primary class name matches this pattern --bugPattern <pattern> bugPattern="<pattern>" allow only bugs whose type matches this pattern --category <category> category="<category>" allow only warnings with a category that starts with this string --designation <designation> designation="<designation>" allow only warnings with this designation (e.g., -designation SHOULD_FIX) --withMessages[:truth] withMessages="[true|false]" the generated XML should contain textual messages - - -
- - - - - mineBugHistory -This command generates a table containing counts of the numbers of warnings -in each version of a multiversion bug database. - - -This functionality may also can be accessed from ant. -First create a taskdef for mineBugHistory in your -build file: - - - - - - -]]> - - -Attributes for this ant task are listed in the following table. -To specify an input file either use the input -attribute or nest it inside the ant call with a -<datafile> element. For example: - - - - - - -]]> - - - - Options for mineBugHistory command - - - - Command-line option - Ant attribute - Meaning - - - - input="<file>" use file as input - output="<file>" write output to file --formatDates formatDates="[true|false]" render dates in textual form --noTabs noTabs="[true|false]" delimit columns with groups of spaces instead of tabs (see below) --summary summary="[true|false]" output terse summary of changes over the last ten entries - - -
- - - The output can be easier to read from a shell - with a fixed-width font. - Because numeric columns are right-justified, spaces may precede the - first column value. This option also causes - to render dates in terser format without embedded whitespace. - - - The table is a tab-separated (barring ) - table with the following columns: - - - Columns in mineBugHistory output - - - - Title - Meaning - - - - seqSequence number (successive integers, starting at 0) - versionVersion name - timeRelease timestamp - classesNumber of classes analyzed - NCSSNon Commenting Source Statements - addedCount of new warnings for a class that existed in the previous version - newCodeCount of new warnings for a class that did not exist in the previous version - fixedCount of warnings removed from a class that remains in the current version - removedCount of warnings in the previous version for a class that is not present in the current version - retainedCount of warnings that were in both the previous and current version - deadWarnings that were present in earlier versions but in neither the current version or the immediately preceding version - activeTotal warnings present in the current version - - -
- - - - defectDensity - -This command lists information about defect density (warnings per 1000 NCSS) for the entire project and each class and package. -It can either be invoked with no files specified on the command line (in which case it reads from standard input) -or with one file specified on the command line. -It generates a table with the following columns, and with one -row for the entire project, and one row for each package or class that contains at least -4 warnings. - - Columns in defectDensity output - - - - Title - Meaning - - - - kindproject, package or class - nameThe name of the project, package or class - densityNumber of warnings generated per 1000 lines of NCSS. - bugsNumber of warnings - NCSSCalculated number of NCSS - - -
- - - - convertXmlToText - - - This command converts a warning collection in XML format to a text - format with one line per warning, or to HTML. - - -This functionality may also can be accessed from ant. -First create a taskdef for convertXmlToText in your -build file: - - - - - - -]]> - - -Attributes for this ant task are listed in the following table. - - - Options for convertXmlToText command - - - - Command-line option - Ant attribute - Meaning - - - - input="<filename>" use file as input - output="<filename>" output results to file --longBugCodes longBugCodes="[true|false]" use the full bug pattern code instead of two-letter abbreviation - format="text" generate plain text output with one bug per line (command-line default) --html[:stylesheet] format="html:<stylesheet>" generate output with specified stylesheet (see below), or default.xsl if unspecified - - -
- - - You may specify plain.xsl, default.xsl, fancy.xsl, fancy-hist.xsl, - or your own XSL stylesheet for the -html/format option. - Despite the name of this option, you may specify - a stylesheet that emits something other than html. - When applying a stylesheet other than those included - with FindBugs (listed above), the -html/format option should be used - with a path or URL to the stylesheet. - - - - - setBugDatabaseInfo - - - This command sets meta-information in a specified warning collection. - It takes the following options: - - -This functionality may also can be accessed from ant. -First create a taskdef for setBugDatabaseInfo in your -build file: - - - - - - -]]> - - -Attributes for this ant task are listed in the following table. -To specify an input file either use the input -attribute or nest it inside the ant call with a -<datafile> element. For example: - - - - - - -]]> - - - - setBugDatabaseInfo Options - - - - Command-line option - Ant attribute - Meaning - - - - input="<file>" use file as input - output="<file>" write output to file - -name <name> name="<name>" set name for (last) revision - -timestamp <when> timestamp="<when>" set timestamp for (last) revision - -source <directory> source="<directory>" add specified directory to the source search path - -findSource <directory> findSource="<directory>" find and add all relevant source directions contained within specified directory - -suppress <filter file> suppress="<filter file>" suppress warnings matched by this file (replaces previous suppressions) - -withMessages withMessages="[true|false]" add textual messages to XML - -resetSource resetSource="[true|false]" remove all source search paths - - -
- - - - listBugDatabaseInfo - - This command takes a list of zero or more xml bug database filenames on the command line. -If zero file names are provided, it reads from standard input and does not generate -a table header. - -There is only one option: renders dates - in textual form. - - -The output is a table one row per bug database and the following columns: - - listBugDatabaseInfo Columns - - - - Column - Meaning - - - - versionversion name - timeRelease timestamp - classesNumber of classes analyzed - NCSSNon Commenting Source Statements analyzed - totalTotal number of warnings of all kinds - highTotal number of high priority warnings of all kinds - mediumTotal number of medium/normal priority warnings of all kinds - lowTotal number of low priority warnings of all kinds - filenamefilename of database - - - -
- - - - - - - Examples - - Mining history using proveded shell scrips -In all of the following, the commands are given in a directory that contains -directories jdk1.6.0-b12, jdk1.6.0-b13, ..., jdk1.6.0-b60. - -You can use the command: - -computeBugHistory jdk1.6.0-b* | filterBugs -bugPattern IL_ | mineBugHistory -formatDates - -to generate the following output: - - -seq version time classes NCSS added newCode fixed removed retained dead active -0 jdk1.6.0-b12 "Thu Nov 11 09:07:20 EST 2004" 13128 811569 0 4 0 0 0 0 4 -1 jdk1.6.0-b13 "Thu Nov 18 06:02:06 EST 2004" 13128 811570 0 0 0 0 4 0 4 -2 jdk1.6.0-b14 "Thu Dec 02 06:12:26 EST 2004" 13145 811786 0 0 2 0 2 0 2 -3 jdk1.6.0-b15 "Thu Dec 09 06:07:04 EST 2004" 13174 811693 0 0 1 0 1 2 1 -4 jdk1.6.0-b16 "Thu Dec 16 06:21:28 EST 2004" 13175 811715 0 0 0 0 1 3 1 -5 jdk1.6.0-b17 "Thu Dec 23 06:27:22 EST 2004" 13176 811974 0 0 0 0 1 3 1 -6 jdk1.6.0-b19 "Thu Jan 13 06:41:16 EST 2005" 13176 812011 0 0 0 0 1 3 1 -7 jdk1.6.0-b21 "Thu Jan 27 05:57:52 EST 2005" 13177 812173 0 0 0 0 1 3 1 -8 jdk1.6.0-b23 "Thu Feb 10 05:44:36 EST 2005" 13179 812188 0 0 0 0 1 3 1 -9 jdk1.6.0-b26 "Thu Mar 03 06:04:02 EST 2005" 13199 811770 0 0 0 0 1 3 1 -10 jdk1.6.0-b27 "Thu Mar 10 04:48:38 EST 2005" 13189 812440 0 0 0 0 1 3 1 -11 jdk1.6.0-b28 "Thu Mar 17 02:54:22 EST 2005" 13185 812056 0 0 0 0 1 3 1 -12 jdk1.6.0-b29 "Thu Mar 24 03:09:20 EST 2005" 13117 809468 0 0 0 0 1 3 1 -13 jdk1.6.0-b30 "Thu Mar 31 02:53:32 EST 2005" 13118 809501 0 0 0 0 1 3 1 -14 jdk1.6.0-b31 "Thu Apr 07 03:00:14 EDT 2005" 13117 809572 0 0 0 0 1 3 1 -15 jdk1.6.0-b32 "Thu Apr 14 02:56:56 EDT 2005" 13169 811096 0 0 0 0 1 3 1 -16 jdk1.6.0-b33 "Thu Apr 21 02:46:22 EDT 2005" 13187 811942 0 0 0 0 1 3 1 -17 jdk1.6.0-b34 "Thu Apr 28 02:49:00 EDT 2005" 13195 813488 0 1 0 0 1 3 2 -18 jdk1.6.0-b35 "Thu May 05 02:49:04 EDT 2005" 13457 829837 0 0 0 0 2 3 2 -19 jdk1.6.0-b36 "Thu May 12 02:59:46 EDT 2005" 13462 831278 0 0 0 0 2 3 2 -20 jdk1.6.0-b37 "Thu May 19 02:55:08 EDT 2005" 13464 831971 0 0 0 0 2 3 2 -21 jdk1.6.0-b38 "Thu May 26 03:08:16 EDT 2005" 13564 836565 0 0 0 0 2 3 2 -22 jdk1.6.0-b39 "Fri Jun 03 03:10:48 EDT 2005" 13856 849992 0 1 0 0 2 3 3 -23 jdk1.6.0-b40 "Thu Jun 09 03:30:28 EDT 2005" 15972 959619 0 2 0 0 3 3 5 -24 jdk1.6.0-b41 "Thu Jun 16 03:19:22 EDT 2005" 15972 959619 0 0 0 0 5 3 5 -25 jdk1.6.0-b42 "Fri Jun 24 03:38:54 EDT 2005" 15966 958581 0 0 0 0 5 3 5 -26 jdk1.6.0-b43 "Thu Jul 14 03:09:34 EDT 2005" 16041 960544 0 0 0 0 5 3 5 -27 jdk1.6.0-b44 "Thu Jul 21 03:05:54 EDT 2005" 16041 960547 0 0 0 0 5 3 5 -28 jdk1.6.0-b45 "Thu Jul 28 03:26:10 EDT 2005" 16037 960606 0 0 1 0 4 3 4 -29 jdk1.6.0-b46 "Thu Aug 04 03:02:48 EDT 2005" 15936 951355 0 0 0 0 4 4 4 -30 jdk1.6.0-b47 "Thu Aug 11 03:18:56 EDT 2005" 15964 952387 0 0 1 0 3 4 3 -31 jdk1.6.0-b48 "Thu Aug 18 08:10:40 EDT 2005" 15970 953421 0 0 0 0 3 5 3 -32 jdk1.6.0-b49 "Thu Aug 25 03:24:38 EDT 2005" 16048 958940 0 0 0 0 3 5 3 -33 jdk1.6.0-b50 "Thu Sep 01 01:52:40 EDT 2005" 16287 974937 1 0 0 0 3 5 4 -34 jdk1.6.0-b51 "Thu Sep 08 01:55:36 EDT 2005" 16362 979377 0 0 0 0 4 5 4 -35 jdk1.6.0-b52 "Thu Sep 15 02:04:08 EDT 2005" 16477 979399 0 0 0 0 4 5 4 -36 jdk1.6.0-b53 "Thu Sep 22 02:00:28 EDT 2005" 16019 957900 0 0 1 0 3 5 3 -37 jdk1.6.0-b54 "Thu Sep 29 01:54:34 EDT 2005" 16019 957900 0 0 0 0 3 6 3 -38 jdk1.6.0-b55 "Thu Oct 06 01:54:14 EDT 2005" 16051 959014 0 0 0 0 3 6 3 -39 jdk1.6.0-b56 "Thu Oct 13 01:54:12 EDT 2005" 16211 970835 0 0 0 0 3 6 3 -40 jdk1.6.0-b57 "Thu Oct 20 01:55:26 EDT 2005" 16279 971627 0 0 0 0 3 6 3 -41 jdk1.6.0-b58 "Thu Oct 27 01:56:30 EDT 2005" 16283 971945 0 0 0 0 3 6 3 -42 jdk1.6.0-b59 "Thu Nov 03 01:56:58 EST 2005" 16232 972193 0 0 0 0 3 6 3 -43 jdk1.6.0-b60 "Thu Nov 10 01:54:18 EST 2005" 16235 972346 0 0 0 0 3 6 3 - - - -We could also generate that information directly, without creating an intermediate db.xml file, using the command - - - -computeBugHistory jdk1.6.0-b*/jre/lib/rt.xml | filterBugs -bugPattern IL_ db.xml | mineBugHistory -formatDates - - -We can then use that information to display a graph showing the number of infinite recursive loops -found by FindBugs in each build of Sun's JDK1.6.0. The blue area indicates the number of infinite -recursive loops in that build, the red area above it indicates the number of infinite recursive loops that existed -in some previous version but not in the current version (thus, the combined height of the red and blue areas -is guaranteed to never decrease, and goes up whenever a new infinite recursive loop bug is introduced). The height -of the red area is computed as the sum of the fixed, removed and dead values for each version. -The reductions in builds 13 and 14 came after Sun was notified about the bugs found by FindBugs in the JDK. - - - - - - - - -Given the db.xml file that contains the results for all the jdk1.6.0 builds, the following command will show the history of high and medium priority correctness warnings: - - - -filterBugs -priority M -category C db.xml | mineBugHistory -formatDates - - - -generating the table: - - - -seq version time classes NCSS added newCode fixed removed retained dead active -0 jdk1.6.0-b12 "Thu Nov 11 09:07:20 EST 2004" 13128 811569 0 1075 0 0 0 0 1075 -1 jdk1.6.0-b13 "Thu Nov 18 06:02:06 EST 2004" 13128 811570 0 0 0 0 1075 0 1075 -2 jdk1.6.0-b14 "Thu Dec 02 06:12:26 EST 2004" 13145 811786 3 0 6 0 1069 0 1072 -3 jdk1.6.0-b15 "Thu Dec 09 06:07:04 EST 2004" 13174 811693 2 1 3 0 1069 6 1072 -4 jdk1.6.0-b16 "Thu Dec 16 06:21:28 EST 2004" 13175 811715 0 0 1 0 1071 9 1071 -5 jdk1.6.0-b17 "Thu Dec 23 06:27:22 EST 2004" 13176 811974 0 0 1 0 1070 10 1070 -6 jdk1.6.0-b19 "Thu Jan 13 06:41:16 EST 2005" 13176 812011 0 0 0 0 1070 11 1070 -7 jdk1.6.0-b21 "Thu Jan 27 05:57:52 EST 2005" 13177 812173 0 0 1 0 1069 11 1069 -8 jdk1.6.0-b23 "Thu Feb 10 05:44:36 EST 2005" 13179 812188 0 0 0 0 1069 12 1069 -9 jdk1.6.0-b26 "Thu Mar 03 06:04:02 EST 2005" 13199 811770 0 0 2 1 1066 12 1066 -10 jdk1.6.0-b27 "Thu Mar 10 04:48:38 EST 2005" 13189 812440 1 0 1 1 1064 15 1065 -11 jdk1.6.0-b28 "Thu Mar 17 02:54:22 EST 2005" 13185 812056 0 0 0 0 1065 17 1065 -12 jdk1.6.0-b29 "Thu Mar 24 03:09:20 EST 2005" 13117 809468 3 0 8 26 1031 17 1034 -13 jdk1.6.0-b30 "Thu Mar 31 02:53:32 EST 2005" 13118 809501 0 0 0 0 1034 51 1034 -14 jdk1.6.0-b31 "Thu Apr 07 03:00:14 EDT 2005" 13117 809572 0 0 0 0 1034 51 1034 -15 jdk1.6.0-b32 "Thu Apr 14 02:56:56 EDT 2005" 13169 811096 1 1 0 1 1033 51 1035 -16 jdk1.6.0-b33 "Thu Apr 21 02:46:22 EDT 2005" 13187 811942 3 0 2 1 1032 52 1035 -17 jdk1.6.0-b34 "Thu Apr 28 02:49:00 EDT 2005" 13195 813488 0 1 0 0 1035 55 1036 -18 jdk1.6.0-b35 "Thu May 05 02:49:04 EDT 2005" 13457 829837 0 36 2 0 1034 55 1070 -19 jdk1.6.0-b36 "Thu May 12 02:59:46 EDT 2005" 13462 831278 0 0 0 0 1070 57 1070 -20 jdk1.6.0-b37 "Thu May 19 02:55:08 EDT 2005" 13464 831971 0 1 1 0 1069 57 1070 -21 jdk1.6.0-b38 "Thu May 26 03:08:16 EDT 2005" 13564 836565 1 7 2 6 1062 58 1070 -22 jdk1.6.0-b39 "Fri Jun 03 03:10:48 EDT 2005" 13856 849992 6 39 5 0 1065 66 1110 -23 jdk1.6.0-b40 "Thu Jun 09 03:30:28 EDT 2005" 15972 959619 7 147 11 0 1099 71 1253 -24 jdk1.6.0-b41 "Thu Jun 16 03:19:22 EDT 2005" 15972 959619 0 0 0 0 1253 82 1253 -25 jdk1.6.0-b42 "Fri Jun 24 03:38:54 EDT 2005" 15966 958581 3 0 1 2 1250 82 1253 -26 jdk1.6.0-b43 "Thu Jul 14 03:09:34 EDT 2005" 16041 960544 5 11 15 8 1230 85 1246 -27 jdk1.6.0-b44 "Thu Jul 21 03:05:54 EDT 2005" 16041 960547 0 0 0 0 1246 108 1246 -28 jdk1.6.0-b45 "Thu Jul 28 03:26:10 EDT 2005" 16037 960606 19 0 2 0 1244 108 1263 -29 jdk1.6.0-b46 "Thu Aug 04 03:02:48 EDT 2005" 15936 951355 13 1 1 32 1230 110 1244 -30 jdk1.6.0-b47 "Thu Aug 11 03:18:56 EDT 2005" 15964 952387 163 8 7 20 1217 143 1388 -31 jdk1.6.0-b48 "Thu Aug 18 08:10:40 EDT 2005" 15970 953421 0 0 0 0 1388 170 1388 -32 jdk1.6.0-b49 "Thu Aug 25 03:24:38 EDT 2005" 16048 958940 1 11 1 0 1387 170 1399 -33 jdk1.6.0-b50 "Thu Sep 01 01:52:40 EDT 2005" 16287 974937 19 27 16 7 1376 171 1422 -34 jdk1.6.0-b51 "Thu Sep 08 01:55:36 EDT 2005" 16362 979377 1 15 3 0 1419 194 1435 -35 jdk1.6.0-b52 "Thu Sep 15 02:04:08 EDT 2005" 16477 979399 0 0 1 1 1433 197 1433 -36 jdk1.6.0-b53 "Thu Sep 22 02:00:28 EDT 2005" 16019 957900 13 12 16 20 1397 199 1422 -37 jdk1.6.0-b54 "Thu Sep 29 01:54:34 EDT 2005" 16019 957900 0 0 0 0 1422 235 1422 -38 jdk1.6.0-b55 "Thu Oct 06 01:54:14 EDT 2005" 16051 959014 1 4 7 0 1415 235 1420 -39 jdk1.6.0-b56 "Thu Oct 13 01:54:12 EDT 2005" 16211 970835 6 8 37 0 1383 242 1397 -40 jdk1.6.0-b57 "Thu Oct 20 01:55:26 EDT 2005" 16279 971627 0 0 0 0 1397 279 1397 -41 jdk1.6.0-b58 "Thu Oct 27 01:56:30 EDT 2005" 16283 971945 0 1 1 0 1396 279 1397 -42 jdk1.6.0-b59 "Thu Nov 03 01:56:58 EST 2005" 16232 972193 6 0 5 0 1392 280 1398 -43 jdk1.6.0-b60 "Thu Nov 10 01:54:18 EST 2005" 16235 972346 0 0 0 0 1398 285 1398 -44 jdk1.6.0-b61 "Thu Nov 17 01:58:42 EST 2005" 16202 971134 2 0 4 0 1394 285 1396 - - - - - Incremental history maintenance - - -If db.xml contains the results of running findbugs over builds b12 - b60, we can update db.xml to include the results of analyzing b61 with the commands: - - -computeBugHistory -output db.xml db.xml jdk1.6.0-b61/jre/lib/rt.xml - - - - - - - Ant example - -Here is a complete ant script example for both running findbugs and running a chain of data-mining tools afterward: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -]]> - - - - - - - - -License - - -The name FindBugs and the FindBugs logo is trademarked by the University -of Maryland. -FindBugs is free software distributed under the terms of the -Lesser GNU Public License. -You should have received a copy of the license in the file LICENSE.txt -in the &FindBugs; distribution. - - - -You can find the latest version of FindBugs, along with its source code, from the -FindBugs web page. - - - - - - - -Acknowledgments - - -Contributors - -&FindBugs; was originally written by Bill Pugh (pugh@cs.umd.edu). -David Hovemeyer (daveho@cs.umd.edu) implemented some of the -detectors, added the Swing GUI, and is a co-maintainer. - -Mike Fagan (mfagan@tde.com) contributed the &Ant; build script, -the &Ant; task, and several enhancements and bug fixes to the GUI. - -Germano Leichsenring contributed Japanese translations of the bug -summaries. - -David Li contributed the Emacs bug report format. - -Peter D. Stout contributed recursive detection of Class-Path -attributes in analyzed Jar files, German translations of -text used in the Swing GUI, and other fixes. - -Peter Friese wrote the &FindBugs; Eclipse plugin. - -Rohan Lloyd contributed several Mac OS X enhancements, -bug detector improvements, -and maintains the Fink package for &FindBugs;. - -Hiroshi Okugawa translated the &FindBugs; manual and -more of the bug summaries into Japanese. - -Phil Crosby enhanced the Eclipse plugin to add a view -to display the bug details. - -Dave Brosius fixed a number of bugs, added user preferences -to the Swing GUI, improved several bug detectors, and -contributed the string concatenation detector. - -Thomas Klaeger contributed a number of bug fixes and -bug detector improvements. - -Andrey Loskutov made a number of bug fixes and -bug detector improvements. He is maintainer of the Eclipse plugin. - -Brian Goetz contributed a major refactoring of the -visitor classes to improve readability and understandability. - - Pete Angstadt fixed several problems in the Swing GUI. - -Francis Lalonde provided a task resource file for the -FindBugs Ant task. - -Garvin LeClaire contributed support for output in -Xdocs format, for use by Maven. - -Holger Stenzhorn contributed improved German translations of items -in the Swing GUI. - -Juha Knuutila contributed Finnish translations of items -in the Swing GUI. - -Tanel Lebedev contributed Estonian translations of items -in the Swing GUI. - -Hanai Shisei (ruimo) contributed full Japanese translations of -bug messages, and text used in the Swing GUI. - -David Cotton contributed Fresh translations for bug -messages and for the Swing GUI. - -Michael Tamm contributed support for the "errorProperty" attribute -in the Ant task. - -Thomas Kuehne improved the German translation of the Swing GUI. - -Len Trigg improved source file support for the Emacs output mode. - -Greg Bentz provided a fix for the hashcode/equals detector. - -K. Hashimoto contributed internationalization fixes and several other - bug fixes. - - - Glenn Boysko contributed support for ignoring specified local - variables in the dead local store detector. - - - - Jay Dunning contributed a detector to find equality comparisons - of floating-point values, and overhauled the analysis summary - report and its representation in the saved XML format. - - - - Olivier Parent contributed updated French translations for bug descriptions and - Swing GUI. - - - - Chris Nappin contributed the plain.xsl - stylesheet. - - - - Etienne Giraudy contributed the fancy.xsl and fancy-hist.xsl - stylesheets, and made improvements to the -xml:withMessages - option. - - - - Takashi Okamoto fixed bugs in the project preferences dialog - in the Eclipse plugin, and contributed to its internationalization and localization. - - -Thomas Einwaller fixed bugs in the project preferences dialog in the Eclipse plugin. - -Jeff Knox contributed support for the warningsProperty attribute -in the Ant task. - -Peter Hendriks extended the Eclipse plugin preferences, -and fixed a bug related to renaming the Eclipse plugin ID. - -Mark McKay contributed an Ant task to launch the findbugs frame. - -Dieter von Holten (dvholten) contributed -some German improvements to findbugs_de.properties. - -Kevin Lubick contributed fixes and tests for multi-quick-fixes and customizable -annotation colors for Eclipse plugin. - -Boris Bokowski contributed several new bug patterns: BIT_SIGNED_CHECK and BIT_SIGNED_CHECK_HIGH_BIT. - -Tagir Valeev contributed several new bug detectors and improved existing ones. - -If you have contributed to &FindBugs;, but aren't mentioned above, -please send email to findbugs@cs.umd.edu (and also accept -our humble apologies). - - - - -Software Used - -&FindBugs; uses several open-source software packages, without which its -development would have been much more difficult. - - -BCEL -&FindBugs; includes software developed by the Apache Software Foundation -(http://www.apache.org/). -Specifically, it uses the Byte Code -Engineering Library. - - - -ASM -&FindBugs; uses the ASM -bytecode framework, which is distributed under the following license: - -
- -Copyright (c) 2000-2005 INRIA, France Telecom -All rights reserved. - - - -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions -are met: - - - - - Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - - - Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. - - - Neither the name of the copyright holders nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. - - - - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE -LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF -THE POSSIBILITY OF SUCH DAMAGE. - -
- - - -DOM4J -&FindBugs; uses DOM4J, which is -distributed under the following license: - -
- -Copyright 2001 (C) MetaStuff, Ltd. All Rights Reserved. - - - -Redistribution and use of this software and associated documentation -("Software"), with or without modification, are permitted provided that -the following conditions are met: - - - - - Redistributions of source code must retain copyright statements and - notices. Redistributions must also contain a copy of this document. - - - Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. - - - The name "DOM4J" must not be used to endorse or promote products - derived from this Software without prior written permission - of MetaStuff, Ltd. For written permission, please contact - dom4j-info@metastuff.com. - - - Products derived from this Software may not be called "DOM4J" nor may - "DOM4J" appear in their names without prior written permission of - MetaStuff, Ltd. DOM4J is a registered trademark of MetaStuff, Ltd. - - - Due credit should be given to the DOM4J Project (http://dom4j.org/). - - - - -THIS SOFTWARE IS PROVIDED BY METASTUFF, LTD. AND CONTRIBUTORS ``AS IS'' -AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL METASTUFF, LTD. OR ITS -CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, -EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, -PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR -PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF -LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING -NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS -SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - -
- - - - - - - - - diff --git a/manual.xsl b/manual.xsl deleted file mode 100644 index d50acd8..0000000 --- a/manual.xsl +++ /dev/null @@ -1,46 +0,0 @@ - - - - - - - - - - - - -0 - - -manual/ - - -1 - - -1 - - -1 - - - - - -1 - - diff --git a/manual/acknowledgments.html b/manual/acknowledgments.html deleted file mode 100644 index c209f22..0000000 --- a/manual/acknowledgments.html +++ /dev/null @@ -1,134 +0,0 @@ - - - Chapter 14. Acknowledgments
Chapter 14. Acknowledgments
Prev   

Chapter 14. Acknowledgments

Table of Contents

1. Contributors
2. Software Used

1. Contributors

FindBugs was originally written by Bill Pugh (). -David Hovemeyer () implemented some of the -detectors, added the Swing GUI, and is a co-maintainer.

Mike Fagan () contributed the Ant build script, -the Ant task, and several enhancements and bug fixes to the GUI.

Germano Leichsenring contributed Japanese translations of the bug -summaries.

David Li contributed the Emacs bug report format.

Peter D. Stout contributed recursive detection of Class-Path -attributes in analyzed Jar files, German translations of -text used in the Swing GUI, and other fixes.

Peter Friese wrote the FindBugs Eclipse plugin.

Rohan Lloyd contributed several Mac OS X enhancements, -bug detector improvements, -and maintains the Fink package for FindBugs.

Hiroshi Okugawa translated the FindBugs manual and -more of the bug summaries into Japanese.

Phil Crosby enhanced the Eclipse plugin to add a view -to display the bug details.

Dave Brosius fixed a number of bugs, added user preferences -to the Swing GUI, improved several bug detectors, and -contributed the string concatenation detector.

Thomas Klaeger contributed a number of bug fixes and -bug detector improvements.

Andrey Loskutov made a number of bug fixes and -bug detector improvements. He is maintainer of the Eclipse plugin.

Brian Goetz contributed a major refactoring of the -visitor classes to improve readability and understandability.

Pete Angstadt fixed several problems in the Swing GUI.

Francis Lalonde provided a task resource file for the -FindBugs Ant task.

Garvin LeClaire contributed support for output in -Xdocs format, for use by Maven.

Holger Stenzhorn contributed improved German translations of items -in the Swing GUI.

Juha Knuutila contributed Finnish translations of items -in the Swing GUI.

Tanel Lebedev contributed Estonian translations of items -in the Swing GUI.

Hanai Shisei (ruimo) contributed full Japanese translations of -bug messages, and text used in the Swing GUI.

David Cotton contributed Fresh translations for bug -messages and for the Swing GUI.

Michael Tamm contributed support for the "errorProperty" attribute -in the Ant task.

Thomas Kuehne improved the German translation of the Swing GUI.

Len Trigg improved source file support for the Emacs output mode.

Greg Bentz provided a fix for the hashcode/equals detector.

K. Hashimoto contributed internationalization fixes and several other - bug fixes.

- Glenn Boysko contributed support for ignoring specified local - variables in the dead local store detector. -

- Jay Dunning contributed a detector to find equality comparisons - of floating-point values, and overhauled the analysis summary - report and its representation in the saved XML format. -

- Olivier Parent contributed updated French translations for bug descriptions and - Swing GUI. -

- Chris Nappin contributed the plain.xsl - stylesheet. -

- Etienne Giraudy contributed the fancy.xsl and fancy-hist.xsl - stylesheets, and made improvements to the -xml:withMessages - option. -

- Takashi Okamoto fixed bugs in the project preferences dialog - in the Eclipse plugin, and contributed to its internationalization and localization. -

Thomas Einwaller fixed bugs in the project preferences dialog in the Eclipse plugin.

Jeff Knox contributed support for the warningsProperty attribute -in the Ant task.

Peter Hendriks extended the Eclipse plugin preferences, -and fixed a bug related to renaming the Eclipse plugin ID.

Mark McKay contributed an Ant task to launch the findbugs frame.

Dieter von Holten (dvholten) contributed -some German improvements to findbugs_de.properties.

Kevin Lubick contributed fixes and tests for multi-quick-fixes and customizable -annotation colors for Eclipse plugin.

Boris Bokowski contributed several new bug patterns: BIT_SIGNED_CHECK and BIT_SIGNED_CHECK_HIGH_BIT.

Tagir Valeev contributed several new bug detectors and improved existing ones.

If you have contributed to FindBugs, but aren't mentioned above, -please send email to (and also accept -our humble apologies).

2. Software Used

FindBugs uses several open-source software packages, without which its -development would have been much more difficult.

2.1. BCEL

FindBugs includes software developed by the Apache Software Foundation -(http://www.apache.org/). -Specifically, it uses the Byte Code -Engineering Library.

2.2. ASM

FindBugs uses the ASM -bytecode framework, which is distributed under the following license:

-Copyright (c) 2000-2005 INRIA, France Telecom -All rights reserved. -

-Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions -are met: -

  1. - Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. -

  2. - Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. -

  3. - Neither the name of the copyright holders nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. -

-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE -LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF -THE POSSIBILITY OF SUCH DAMAGE. -

2.3. DOM4J

FindBugs uses DOM4J, which is -distributed under the following license:

-Copyright 2001 (C) MetaStuff, Ltd. All Rights Reserved. -

-Redistribution and use of this software and associated documentation -("Software"), with or without modification, are permitted provided that -the following conditions are met: -

  1. - Redistributions of source code must retain copyright statements and - notices. Redistributions must also contain a copy of this document. -

  2. - Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. -

  3. - The name "DOM4J" must not be used to endorse or promote products - derived from this Software without prior written permission - of MetaStuff, Ltd. For written permission, please contact - . -

  4. - Products derived from this Software may not be called "DOM4J" nor may - "DOM4J" appear in their names without prior written permission of - MetaStuff, Ltd. DOM4J is a registered trademark of MetaStuff, Ltd. -

  5. - Due credit should be given to the DOM4J Project (http://dom4j.org/). -

-THIS SOFTWARE IS PROVIDED BY METASTUFF, LTD. AND CONTRIBUTORS ``AS IS'' -AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL METASTUFF, LTD. OR ITS -CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, -EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, -PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR -PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF -LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING -NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS -SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -

Prev   
Chapter 13. License Home 
\ No newline at end of file diff --git a/manual/analysisprops.html b/manual/analysisprops.html deleted file mode 100644 index c8d1836..0000000 --- a/manual/analysisprops.html +++ /dev/null @@ -1,54 +0,0 @@ - - - Chapter 9. Analysis Properties
Chapter 9. Analysis Properties
Prev   Next

Chapter 9. Analysis Properties

-FindBugs allows several aspects of the analyses it performs to be -customized. System properties are used to configure these options. -This chapter describes the configurable analysis options. -

-The analysis options have two main purposes. First, they allow you -to inform FindBugs about the meaning of methods in your application, -so that it can produce more accurate results, or produce fewer -false warnings. Second, they allow you to configure the precision -of the analysis performed. Reducing analysis precision can save -memory and analysis time, at the expense of missing some real bugs, -or producing more false warnings. -

-The analysis options are set using the -property -command line option. For example: -

-$ findbugs -textui -property "cfg.noprune=true" myApp.jar
-

-

-The list of configurable analysis properties is shown in -Table 9.1, “Configurable Analysis Properties”. -

Table 9.1. Configurable Analysis Properties

Property NameValueMeaning
findbugs.assertionmethodsComma-separated list of fully qualified method names: - e.g., "com.foo.MyClass.checkAssertion"This property specifies the names of methods that are used - to check program assertions. Specifying these methods allows - the null pointer dereference bug detector to avoid reporting - false warnings for values which are checked by assertion - methods.
findbugs.de.commenttrue or falseIf true, the DroppedException detector scans source code - for empty catch blocks for a comment, and if one is found, does - not report a warning.
findbugs.maskedfields.localstrue or falseIf true, emit low priority warnings for local variables - which obscure fields. Default is false.
findbugs.nullderef.assumensptrue or falsenot used - (intention: If true, the null dereference detector assumes that any - reference value returned from a method or passed to a method - in a parameter might be null. Default is false. Note that - enabling this property will very likely cause a large number - of false warnings to be produced.)
findbugs.refcomp.reportAlltrue or falseIf true, all suspicious reference comparisons - using the == and != operators are reported.  If false, - only one such warning is issued per method.  Default - is false.
findbugs.sf.commenttrue or falseIf true, the SwitchFallthrough detector will only report - warnings for cases where the source code does not have a comment - containing the words "fall" or "nobreak". (An accurate source - path must be used for this feature to work correctly.) - This helps find cases where the switch fallthrough is likely - to be unintentional.

Prev   Next
Chapter 8. Filter Files Home Chapter 10. Annotations
\ No newline at end of file diff --git a/manual/annotations.html b/manual/annotations.html deleted file mode 100644 index 036d022..0000000 --- a/manual/annotations.html +++ /dev/null @@ -1,122 +0,0 @@ - - - Chapter 10. Annotations
Chapter 10. Annotations
Prev   Next

Chapter 10. Annotations

-FindBugs supports several annotations to express the developer's intent -so that FindBugs can issue warnings more appropriately. You need to use -Java 5 to use annotations, and must place the annotations.jar and jsr305.jar -files in the classpath while compiling your program. -

edu.umd.cs.findbugs.annotations.CheckForNull

- [Target] Field, Method, Parameter -

-The annotated element might be null, and uses of the element should check for null. -When this annotation is applied to a method it applies to the method return value. -

edu.umd.cs.findbugs.annotations.CheckReturnValue

- [Target] Method, Constructor -

[Parameter]

- priority:The priority of the warning (HIGH, MEDIUM, LOW, IGNORE). Default value:MEDIUM. -

- explanation:A textual explanation of why the return value should be checked. Default value:"". -

-This annotation is used to denote a method whose return value should always be checked after invoking the method. -

edu.umd.cs.findbugs.annotations.DefaultAnnotation

- [Target] Type, Package -

[Parameter]

- value:Annotation class objects. More than one class can be specified. -

- priority:Default priority(HIGH, MEDIUM, LOW, IGNORE). Default value:MEDIUM. -

-Indicates that all members of the class or package should be annotated with the default -value of the supplied annotation classes. This would be used for behavior annotations -such as @NonNull, @CheckForNull, or @CheckReturnValue. In particular, you can use -@DefaultAnnotation(NonNull.class) on a class or package, and then use @Nullable only -on those parameters, methods or fields that you want to allow to be null. -

edu.umd.cs.findbugs.annotations.DefaultAnnotationForFields

- [Target] Type, Package -

[Parameter]

- value:Annotation class objects. More than one class can be specified. -

- priority:Default priority(HIGH, MEDIUM, LOW, IGNORE). Default value:MEDIUM. -

-This is same as the DefaultAnnotation except it only applys to fields. -

edu.umd.cs.findbugs.annotations.DefaultAnnotationForMethods

- [Target] Type, Package -

[Parameter]

- value:Annotation class objects. More than one class can be specified. -

- priority:Default priority(HIGH, MEDIUM, LOW, IGNORE). Default value:MEDIUM. -

-This is same as the DefaultAnnotation except it only applys to methods. -

edu.umd.cs.findbugs.annotations.DefaultAnnotationForParameters

- [Target] Type, Package -

[Parameter]

- value:Annotation class objects. More than one class can be specified. -

- priority:Default priority(HIGH, MEDIUM, LOW, IGNORE). Default value:MEDIUM. -

-This is same as the DefaultAnnotation except it only applys to method parameters. -

edu.umd.cs.findbugs.annotations.NonNull

- [Target] Field, Method, Parameter -

-The annotated element must not be null. -Annotated fields must not be null after construction has completed. Annotated methods must have non-null return values. -

edu.umd.cs.findbugs.annotations.Nullable

- [Target] Field, Method, Parameter -

-The annotated element could be null under some circumstances. In general, this means -developers will have to read the documentation to determine when a null value is -acceptable and whether it is necessary to check for a null value. FindBugs will -treat the annotated items as though they had no annotation. -

-In practice this annotation is useful only for overriding an overarching NonNull -annotation. -

edu.umd.cs.findbugs.annotations.OverrideMustInvoke

- [Target] Method -

[Parameter]

- value:Specify when the super invocation should be - performed (FIRST, ANYTIME, LAST). Default value:ANYTIME. -

-Used to annotate a method that, if overridden, must (or should) be invoke super -in the overriding method. Examples of such methods include finalize() and clone(). -The argument to the method indicates when the super invocation should occur: -at any time, at the beginning of the overriding method, or at the end of the overriding method. -(This anotation is not implmemented in FindBugs as of September 8, 2006). -

edu.umd.cs.findbugs.annotations.PossiblyNull

-This annotation is deprecated. Use CheckForNull instead. -

edu.umd.cs.findbugs.annotations.SuppressWarnings

- [Target] Type, Field, Method, Parameter, Constructor, Package -

[Parameter]

- value:The name of the warning. More than one name can be specified. -

- justification:Reason why the warning should be ignored. Default value:"". -

-The set of warnings that are to be suppressed by the compiler in the annotated element. -Duplicate names are permitted. The second and successive occurrences of a name are ignored. -The presence of unrecognized warning names is not an error: Compilers -must ignore any warning names they do not recognize. They are, however, free to emit a -warning if an annotation contains an unrecognized warning name. Compiler vendors should -document the warning names they support in conjunction with this annotation type. They -are encouraged to cooperate to ensure that the same names work across multiple compilers. -

edu.umd.cs.findbugs.annotations.UnknownNullness

- [Target] Field, Method, Parameter -

-Used to indicate that the nullness of the target is unknown, or my vary in unknown ways in subclasses. -

edu.umd.cs.findbugs.annotations.UnknownNullness

- [Target] Field, Method, Parameter -

-Used to indicate that the nullness of the target is unknown, or my vary in unknown ways in subclasses. -

- FindBugs also supports the following annotations: -

  • net.jcip.annotations.GuardedBy

  • net.jcip.annotations.Immutable

  • net.jcip.annotations.NotThreadSafe

  • net.jcip.annotations.ThreadSafe

-

-You can refer the JCIP annotation -API documentation at Java Concurrency in Practice. -

Prev   Next
Chapter 9. Analysis Properties Home Chapter 11. Using rejarForAnalysis
\ No newline at end of file diff --git a/manual/anttask.html b/manual/anttask.html deleted file mode 100644 index bf9ee82..0000000 --- a/manual/anttask.html +++ /dev/null @@ -1,281 +0,0 @@ - - - Chapter 6. Using the FindBugs™ Ant task
Chapter 6. Using the FindBugs™ Ant task
Prev   Next

Chapter 6. Using the FindBugs™ Ant task

Table of Contents

1. Installing the Ant task
2. Modifying build.xml
3. Executing the task
4. Parameters

-This chapter describes how to integrate FindBugs into a build script -for Ant, which is a popular Java build -and deployment tool. Using the FindBugs Ant task, your build script can -automatically run FindBugs on your Java code. -

-The Ant task was generously contributed by Mike Fagan. -

1. Installing the Ant task

-To install the Ant task, simply copy $FINDBUGS_HOME/lib/findbugs-ant.jar -into the lib subdirectory of your Ant installation. - -

[Note]Note

It is strongly recommended that you use the Ant task with the version -of FindBugs it was included with. We do not guarantee that the Ant task Jar file -will work with any version of FindBugs other than the one it was included with.

-

2. Modifying build.xml

-To incorporate FindBugs into build.xml (the build script -for Ant), you first need to add a task definition. This should appear as follows: - -

-  <taskdef name="findbugs" classname="edu.umd.cs.findbugs.anttask.FindBugsTask"/>
-

- -The task definition specifies that when a findbugs element is -seen in build.xml, it should use the indicated class to execute the task. -

-After you have added the task definition, you can define a target -which uses the findbugs task. Here is an example -which could be added to the build.xml for the -Apache BCEL library. - -

-  <property name="findbugs.home" value="/export/home/daveho/work/findbugs" />
-
-  <target name="findbugs" depends="jar">
-    <findbugs home="${findbugs.home}"
-              output="xml"
-              outputFile="bcel-fb.xml" >
-      <auxClasspath path="${basedir}/lib/Regex.jar" />
-      <sourcePath path="${basedir}/src/java" />
-      <class location="${basedir}/bin/bcel.jar" />
-    </findbugs>
-  </target>
-

- -The findbugs element must have the home -attribute set to the directory in which FindBugs is installed; in other words, -$FINDBUGS_HOME. See Chapter 2, Installing FindBugs™. -

-This target will execute FindBugs on bcel.jar, which is the -Jar file produced by BCEL's build script. (By making it depend on the "jar" -target, we ensure that the library is fully compiled before running FindBugs on it.) -The output of FindBugs will be saved in XML format to a file called -bcel-fb.xml. -An auxiliary Jar file, Regex.jar, is added to the aux classpath, -because it is referenced by the main BCEL library. A source path is specified -so that the saved bug data will have accurate references to the BCEL source code. -

3. Executing the task

-Here is an example of invoking Ant from the command line, using the findbugs -target defined above. - -

-  [daveho@noir]$ ant findbugs
-  Buildfile: build.xml
-
-  init:
-
-  compile:
-
-  examples:
-
-  jar:
-
-  findbugs:
-   [findbugs] Running FindBugs...
-   [findbugs] Bugs were found
-   [findbugs] Output saved to bcel-fb.xml
-
-  BUILD SUCCESSFUL
-  Total time: 35 seconds
-

- -In this case, because we saved the bug results in an XML file, we can -use the FindBugs GUI to view the results; see Chapter 4, Running FindBugs™. -

4. Parameters

This section describes the parameters that may be specified when -using the FindBugs task. - -

class

- A optional nested element specifying which classes to analyze. The class - element must specify a location attribute which names the - archive file (jar, zip, etc.), directory, or class file to be analyzed. Multiple class - elements may be specified as children of a single findbugs element. -

In addition to or instead of specifying a class element, - the FindBugs task can contain one or more fileset or dirset element(s) that - specify files or class folders to be analyzed. - For example, you might use a fileset to specify that all of the jar files in a directory - should be analyzed. - Using a dirset, you can have ANT dynamically collect the class folders of multiple sub-projects to be - analyzed in a single run. -

auxClasspath

- An optional nested element which specifies a classpath (Jar files or directories) - containing classes used by the analyzed library or application, but which - you don't want to analyze. It is specified the same way as - Ant's classpath element for the Java task. -

sourcePath

- An optional nested element which specifies a source directory path - containing source files used to compile the Java code being analyzed. - By specifying a source path, any generated XML bug output will have - complete source information, which allows later viewing in the - GUI. -

home

- A required attribute. - It must be set to the name of the directory where FindBugs is installed. -

quietErrors

- An optional boolean attribute. - If true, reports of serious analysis errors and missing classes will - be suppressed in the FindBugs output. Default is false. -

reportLevel

- An optional attribute. It specifies - the confidence/priority threshold for reporting issues. If set to "low", confidence is not used to filter bugs. - If set to "medium" (the default), low confidence issues are suppressed. - If set to "high", only high confidence bugs are reported. -

output

- Optional attribute. - It specifies the output format. If set to "xml" (the default), output - is in XML format. - If set to "xml:withMessages", output is in XML format augmented with - human-readable messages. (You should use this format if you plan - to generate a report using an XSL stylesheet.) - If set to "html", output is in HTML formatted (default stylesheet is default.xsl). - If set to "text", output is in ad-hoc text format. - If set to "emacs", output is in Emacs error message format. - If set to "xdocs", output is xdoc XML for use with Apache Maven. -

stylesheet

- Optional attribute. - It specifies the stylesheet to use to generate html output when the output is set to html. - Stylesheets included in the FindBugs distribution include default.xsl, fancy.xsl, fancy-hist.xsl, plain.xsl, and summary.xsl. - The default value, if no stylesheet attribute is provided, is default.xsl. - -

sort

- Optional attribute. If the output attribute - is set to "text", then the sort attribute specifies - whether or not reported bugs are sorted by class. Default is true. -

outputFile

- Optional attribute. If specified, names the output file in which the - FindBugs output will be saved. By default, the output is displayed - directly by Ant. -

debug

- Optional boolean attribute. If set to true, FindBugs prints diagnostic - information about which classes are being analyzed, and which bug pattern - detectors are being run. Default is false. -

effort

- Set the analysis effort level. The value specified should be - one of min, default, - or max. See Section 3, “Command-line Options” - for more information about setting the analysis level. -

conserveSpace

Synonym for effort="min".

workHard

Synonym for effort="max".

visitors

- Optional attribute. It specifies a comma-separated list of bug detectors - which should be run. The bug detectors are specified by their class names, - without any package qualification. By default, all detectors which are - not disabled by default are run. -

omitVisitors

- Optional attribute. It specifies a comma-separated list of bug detectors. - It is like the visitors attribute, - except it specifies detectors which will not be run. -

chooseVisitors

- Optional attribute. It specifies a comma-separated list of bug detectors - prefixed with "+" or "-" to selectively enable/disable them. -

excludeFilter

- Optional attribute. It specifies the filename of a filter specifying bugs - to exclude from being reported. See Chapter 8, Filter Files. -

excludePath

- Since Findbugs 3.0.2. -

- An optional nested element which specifies a path - containing filters specifying bugs - to exclude from being reported. See Chapter 8, Filter Files. -

- Example: - - 

-		    <findbugs home="${findbugs.home}">
-		      <excludePath>
-		              <path>
-		                      <fileset dir="${findbugs-exclusion-filters.dir}" includes="findbugs-*-exclude-filter.xml" />
-		              </path>
-		      </excludePath>
-		    </findbugs>
-

- - See Apache Ant's Path-like Structures documentation for details. -

includeFilter

- Optional attribute. It specifies the filename of a filter specifying - which bugs are reported. See Chapter 8, Filter Files. -

includePath

- Since Findbugs 3.0.2. -

- An optional nested element which specifies a path - containing filters specifying which bugs - are reported. See Chapter 8, Filter Files. -

- Example: - - 

-		    <findbugs home="${findbugs.home}">
-		      <includePath>
-		              <path>
-		                      <fileset dir="${findbugs-inclusion-filters.dir}" includes="findbugs-*-include-filter.xml" />
-		              </path>
-		      </includePath>
-		    </findbugs>
-

- - See Apache Ant's Path-like Structures documentation for details. -

projectFile

- Optional attribute. It specifies the name of a project file. - Project files are created by the FindBugs GUI, and specify classes, - aux classpath entries, and source directories. By naming a project, - you don't need to specify any class elements, - nor do you need to specify auxClasspath or - sourcePath attributes. - See Chapter 4, Running FindBugs™ for how to create a project. -

jvmargs

- Optional attribute. It specifies any arguments that should be passed - to the Java virtual machine used to run FindBugs. You may need to - use this attribute to specify flags to increase the amount of memory - the JVM may use if you are analyzing a very large program. -

systemProperty

- Optional nested element. If specified, defines a system property. - The name attribute specifies the name of the - system property, and the value attribute specifies - the value of the system property. -

timeout

- Optional attribute. It specifies the amount of time, in milliseconds, - that the Java process executing FindBugs may run before it is - assumed to be hung and is terminated. The default is 600,000 - milliseconds, which is ten minutes. Note that for very large - programs, FindBugs may require more than ten minutes to complete its - analysis. -

failOnError

- Optional boolean attribute. Whether to abort the build process if there is an - error running FindBugs. Defaults to "false" -

errorProperty

- Optional attribute which specifies the name of a property that - will be set to "true" if an error occurs while running FindBugs. -

warningsProperty

- Optional attribute which specifies the name of a property - that will be set to "true" if any warnings are reported by - FindBugs on the analyzed program. -

userPreferencesFile

- Optional attribute. Set the path of the user preferences file to use, which might override some of the options abobe. - Specifying userPreferencesFile as first argument would mean some later - options will override them, as last argument would mean they will override some previous options). - This rationale behind this option is to reuse FindBugs Eclipse project settings for command - line execution. -

nested

- Optional attribute which enables or disables scanning of nested jar and zip files found in - the list of files and directories to be analyzed. - By default, scanning of nested jar/zip files is enabled. -

setExitCode

- Optional boolean attribute. Whether the exit code will be returned to - the main ant job. Defaults to "true". -

pluginList

- A optional String attribute or optional nested element specifying which BugDetector Jar files to add.. The pluginList - element must specify a location attribute which names the - archive file (jar, zip, etc.), directory, or class file to be analyzed. Multiple pluginList - elements may be specified as children of a single findbugs element. -

- - -

Prev   Next
Chapter 5. Using the FindBugs GUI Home Chapter 7. Using the FindBugs™ Eclipse plugin
\ No newline at end of file diff --git a/manual/building.html b/manual/building.html deleted file mode 100644 index e12cdc3..0000000 --- a/manual/building.html +++ /dev/null @@ -1,132 +0,0 @@ - - - Chapter 3. Building FindBugs™ from Source
Chapter 3. Building FindBugs™ from Source
Prev   Next

Chapter 3. Building FindBugs™ from Source

Table of Contents

1. Prerequisites
2. Extracting the Source Distribution
3. Modifying local.properties
4. Running Ant
5. Running FindBugs™ from a source directory

-This chapter describes how to build FindBugs from source code. Unless you are -interesting in modifying FindBugs, you will probably want to skip to the -next chapter. -

1. Prerequisites

-To compile FindBugs from source, you will need the following: -

-

[Warning]Warning

- The version of Ant included as /usr/bin/ant on - Redhat Linux systems will not work for compiling - FindBugs. We recommend you install a binary distribution of Ant - downloaded from the Ant website. - Make sure that when you run Ant your JAVA_HOME - environment variable points to the directory in which you installed - JDK 1.5 (or later). -

-If you want to be able to generate formatted versions of the FindBugs documentation, -you will also need the following software: -

-

2. Extracting the Source Distribution

-After you download the source distribution, you'll need to extract it into -a working directory. A typical command to do this is: - -

-$ unzip findbugs-3.1.0-dev-20161105-d07b50f-source.zip
-

- -

3. Modifying local.properties

-If you intend to build the FindBugs documentation, -you will need to modify the local.properties file -used by the Ant -build.xml file to build FindBugs. -If you do not want to build the FindBugs documentation, then you -can ignore this file. -

-The local.properties overrides definitions -in the build.properties file. -The build.properties file looks something like this: -

-
-# User Configuration:
-# This section must be modified to reflect your system.
-
-local.software.home     =/export/home/daveho/linux
-
-# Set this to the directory containing the DocBook Modular XSL Stylesheets
-#  from http://docbook.sourceforge.net/projects/xsl/
-
-xsl.stylesheet.home     =${local.software.home}/docbook/docbook-xsl-1.71.1
-
-# Set this to the directory where Saxon (http://saxon.sourceforge.net/)
-# is installed.
-
-saxon.home              =${local.software.home}/java/saxon-6.5.5
-
-

-

-The xsl.stylesheet.home property specifies the full -path to the directory where you have installed the -DocBook Modular XSL -Stylesheets. You only need to specify this property if you will be -generating the FindBugs documentation. -

-The saxon.home property is the full path to the -directory where you installed the Saxon XSLT Processor. -You only need to specify this property if you will be -generating the FindBugs documentation. -

4. Running Ant

-Once you have extracted the source distribution, -made sure that Ant is installed, -modified build.properties (optional), -and configured the tools (such as Saxon), -you are ready to build FindBugs. Invoking Ant is a simple matter -of running the command -

-$ ant target
-

-where target is one of the following: -

build

- This target compiles the code for FindBugs. It is the default target. -

docs

- This target formats the documentation. (It also compiles some of - the source code as a side-effect.) -

runjunit

- This target compiles and runs the internal JUnit tests included - in FindBugs. It will print an error message if any unit - tests fail. -

bindist

- Builds a binary distribution of FindBugs. - The target creates both .zip and - .tar.gz archives. -

-

-After running an Ant command, you should see output similar to -the following (after some other messages regarding the tasks that -Ant is running): -

-
-BUILD SUCCESSFUL
-Total time: 17 seconds
-
-

-

5. Running FindBugs™ from a source directory

-The Ant build script for FindBugs is written such that after -building the build target, the working directory -is set up just like a binary distribution. So, the information about -running FindBugs in Chapter 4, Running FindBugs™ -applies to source distributions, too. -

Prev   Next
Chapter 2. Installing FindBugs™ Home Chapter 4. Running FindBugs™
\ No newline at end of file diff --git a/manual/datamining.html b/manual/datamining.html deleted file mode 100644 index 9626932..0000000 --- a/manual/datamining.html +++ /dev/null @@ -1,430 +0,0 @@ - - - Chapter 12. Data mining of bugs with FindBugs™
Chapter 12. Data mining of bugs with FindBugs™
Prev   Next

Chapter 12. Data mining of bugs with FindBugs™

Table of Contents

1. Commands
2. Examples
3. Ant example

-FindBugs incorporates an ability to perform sophisticated queries on bug -databases and track warnings across multiple versions of code being -studied, allowing you to do things such as seeing when a bug was first introduced, examining -just the warnings that have been introduced since the last release, or graphing the number -of infinite recursive loops in your code over time.

-These techniques all depend upon the XML format used by FindBugs for storing warnings. -These XML files usually contain just the warnings from one particular analysis run, but -they can also store the results from analyzing a sequence of software builds or versions. -

-Any FindBugs XML bug database contains a version name and timestamp. -FindBugs tries to compute a timestamp from the timestamps of the files that -are analyzed (e.g., the timestamp is intended to be the time the class files -were generated, not analyzed). Each bug database also contains a version name. -Both the version name and timestamp can be set manually using the -setBugDatabaseInfo (Section 1.7, “setBugDatabaseInfo”) command. -

A multiversion bug database assigns a sequence number to each version of -the analyzed code. These sequence numbers are simply successive integers, -starting at 0 (e.g., a bug database for 4 versions of the code will contain -versions 0..3). The bug database will also record the name and timestamp for -each version. The filterBugs command allows you to refer -to a version by sequence number, name or timestamp.

-You can take a sequence (or pair) of single version bug databases and create -from them a multiversion bug database, or combine a multiversion bug database -with a sequence of later single-version bug databases.

-Some of these commands can be invoked as ant tasks. See below for specifics -on how to invoke them and what attributes and arguments they take. All of -the examples assume that the findbugs.lib -refid is set correctly. Here is one way to set it: -

-
-   <!-- findbugs task definition -->
-   <property name="findbugs.home" value="/your/path/to/findbugs" />
-   <path id="findbugs.lib">
-      <fileset dir="${findbugs.home}/lib">
-         <include name="findbugs-ant.jar"/>
-      </fileset>
-   </path>
-
-

1. Commands

-All tools for FindBugs data mining are can be invoked from the command line, -and some of the more useful tools can also be invoked from an -ant build file.

-Briefly, the command-line tools are:

unionBugs

- combine the results from separate analysis of disjoint - classes -

computeBugHistory

Merge bug warnings from multiple versions of - analyzed code into - a single multiversion bug database. This can either be used - to add more versions to an existing multiversion database, - or to create a multiversion database from a sequence of single version - bug warning databases.

setBugDatabaseInfo

Set information such as the revision name or -timestamp in an XML bug database

listBugDatabaseInfo

List information such as the revision name and -timestamp for a list of XML bug databases

filterBugs

Select a subset of a bug database

mineBugHistory

Generate a tabular listing of the number of warnings in each - version of a multiversion bug database

defectDensity

List information about defect density - (warnings per 1000 NCSS) - for the entire project and each class and package

convertXmlToText

Convert bug warnings in XML format to - a textual one-line-per-bug format, or to HTML

1.1. unionBugs

- If you have, for example, separately analyzing each jar file used in an application, - you can use this command to combine the separately generated xml bug warning files into - a single file containing all of the warnings.

Do not use this command to combine results from analyzing different versions of the same - file; use computeBugHistory instead.

Specify the xml files on the command line. The result is sent to standard output.

1.2. computeBugHistory

Use this command to generate a bug database containing information from different builds or versions -of software you are analyzing. -History is taken from the first file provided as input; any following -files should be single version bug databases (if they contain history, the history in those -files will be ignored).

By default, output is written to the standard output. -

This functionality may also can be accessed from ant. -First create a taskdef for computeBugHistory in your -build file: -

-
-<taskdef name="computeBugHistory" classname="edu.umd.cs.findbugs.anttask.ComputeBugHistoryTask">
-    <classpath refid="findbugs.lib" />
-</taskdef>
-
-

Attributes for this ant task are listed in the following table. -To specify input files, nest them inside with a -<datafile> element. For example: -

-
-<computeBugHistory home="${findbugs.home}" ...>
-    <datafile name="analyze1.xml"/>
-    <datafile name="analyze2.xml"/>
-</computeBugHistory>
-
-

Table 12.1. Options for computeBugHistory command

Command-line optionAnt attributeMeaning
-output <file>output="<file>"save output in the named file (may also be an input file)
-overrideRevisionNames[:truth]overrideRevisionNames="[true|false]"override revision names for each version with names computed from the filenames
-noPackageMoves[:truth]noPackageMoves="[true|false]"if a class has moved to another package, treat warnings in that class as separate
-preciseMatch[:truth]preciseMatch="[true|false]"require bug patterns to match precisely
-precisePriorityMatch[:truth]precisePriorityMatch="[true|false]"consider two warnings as the same only if priorities match exactly
-quiet[:truth]quiet="[true|false]"don't generate any output to standard out unless there is an error
-withMessages[:truth]withMessages="[true|false]"include human-readable messages describing the warnings in XML output

1.3. filterBugs

This command is used to select a subset of warnings from a FindBugs XML warning file -and write the selected subset to a new FindBugs warning file.

-This command takes a sequence of options, and either zero, one or two -filenames of findbugs xml bug files on the command line.

If no file names are provided, the command reads from standard input -and writes to standard output. If one file name is provided, -it reads from the file and writes to standard output. -If two file names are provided, it reads from the first and writes the output -to the second file name.

This functionality may also can be accessed from ant. -First create a taskdef for filterBugs in your -build file: -

-
-<taskdef name="filterBugs" classname="edu.umd.cs.findbugs.anttask.FilterBugsTask">
-    <classpath refid="findbugs.lib" />
-</taskdef>
-
-

Attributes for this ant task are listed in the following table. -To specify an input file either use the input attribute or nest it inside -the ant call with a <datafile> element. For example: -

-
-<filterBugs home="${findbugs.home}" ...>
-    <datafile name="analyze.xml"/>
-</filterBugs>
-
-

Table 12.2. Options for filterBugs command

Command-line optionAnt attributeMeaning
 input="<file>"use file as input
 output="<file>"output results to file
-notnot="[true|false]"reverse (all) switches for the filter
-withSource[:truth]withSource="[true|false]"only warnings for switch source is available
-exclude <filter file>exclude="<filter file>"exclude bugs matching given filter
-include <filter file>include="<filter file>"include only bugs matching given filter
-annotation <text>annotation="<text>"allow only warnings containing this text in a manual annotation
-after <when>after="<when>"allow only warnings that first occurred after this version
-before <when>before="<when>"allow only warnings that first occurred before this version
-first <when>first="<when>"allow only warnings that first occurred in this version
-last <when>last="<when>"allow only warnings that last occurred in this version
-fixed <when>fixed="<when>"allow only warnings that last occurred in the previous version (clobbers -last)
-present <when>present="<when>"allow only warnings present in this version
-absent <when>absent="<when>"allow only warnings absent in this version
-active[:truth]active="[true|false]"allow only warnings alive in the last sequence number
-introducedByChange[:truth]introducedByChange="[true|false]"allow only warnings introduced by a change of an existing class
-removedByChange[:truth]removedByChange="[true|false]"allow only warnings removed by a change of a persisting class
-newCode[:truth]newCode="[true|false]"allow only warnings introduced by the addition of a new class
-removedCode[:truth]removedCode="[true|false]"allow only warnings removed by removal of a class
-priority <level>priority="<level>"allow only warnings with this priority or higher
-maxRank <rank>rank="[1..20]"allow only warnings with this rank or lower
-class <pattern>class="<class>"allow only bugs whose primary class name matches this pattern
-bugPattern <pattern>bugPattern="<pattern>"allow only bugs whose type matches this pattern
-category <category>category="<category>"allow only warnings with a category that starts with this string
-designation <designation>designation="<designation>"allow only warnings with this designation (e.g., -designation SHOULD_FIX)
-withMessages[:truth] withMessages="[true|false]"the generated XML should contain textual messages

1.4. mineBugHistory

This command generates a table containing counts of the numbers of warnings -in each version of a multiversion bug database.

This functionality may also can be accessed from ant. -First create a taskdef for mineBugHistory in your -build file: -

-
-<taskdef name="mineBugHistory" classname="edu.umd.cs.findbugs.anttask.MineBugHistoryTask">
-    <classpath refid="findbugs.lib" />
-</taskdef>
-
-

Attributes for this ant task are listed in the following table. -To specify an input file either use the input -attribute or nest it inside the ant call with a -<datafile> element. For example: -

-
-<mineBugHistory home="${findbugs.home}" ...>
-    <datafile name="analyze.xml"/>
-</mineBugHistory>
-
-

Table 12.3. Options for mineBugHistory command

Command-line optionAnt attributeMeaning
 input="<file>"use file as input
 output="<file>"write output to file
-formatDatesformatDates="[true|false]"render dates in textual form
-noTabsnoTabs="[true|false]"delimit columns with groups of spaces instead of tabs (see below)
-summarysummary="[true|false]"output terse summary of changes over the last ten entries

- The -noTabs output can be easier to read from a shell - with a fixed-width font. - Because numeric columns are right-justified, spaces may precede the - first column value. This option also causes -formatDates - to render dates in terser format without embedded whitespace. -

The table is a tab-separated (barring -noTabs) - table with the following columns:

Table 12.4. Columns in mineBugHistory output

TitleMeaning
seqSequence number (successive integers, starting at 0)
versionVersion name
timeRelease timestamp
classesNumber of classes analyzed
NCSSNon Commenting Source Statements
addedCount of new warnings for a class that existed in the previous version
newCodeCount of new warnings for a class that did not exist in the previous version
fixedCount of warnings removed from a class that remains in the current version
removedCount of warnings in the previous version for a class that is not present in the current version
retainedCount of warnings that were in both the previous and current version
deadWarnings that were present in earlier versions but in neither the current version or the immediately preceding version
activeTotal warnings present in the current version

1.5. defectDensity

-This command lists information about defect density (warnings per 1000 NCSS) for the entire project and each class and package. -It can either be invoked with no files specified on the command line (in which case it reads from standard input) -or with one file specified on the command line.

It generates a table with the following columns, and with one -row for the entire project, and one row for each package or class that contains at least -4 warnings.

Table 12.5. Columns in defectDensity output

TitleMeaning
kindproject, package or class
nameThe name of the project, package or class
densityNumber of warnings generated per 1000 lines of NCSS.
bugsNumber of warnings
NCSSCalculated number of NCSS

1.6. convertXmlToText

- This command converts a warning collection in XML format to a text - format with one line per warning, or to HTML. -

This functionality may also can be accessed from ant. -First create a taskdef for convertXmlToText in your -build file: -

-
-<taskdef name="convertXmlToText" classname="edu.umd.cs.findbugs.anttask.ConvertXmlToTextTask">
-    <classpath refid="findbugs.lib" />
-</taskdef>
-
-

Attributes for this ant task are listed in the following table.

Table 12.6. Options for convertXmlToText command

Command-line optionAnt attributeMeaning
 input="<filename>"use file as input
 output="<filename>"output results to file
-longBugCodeslongBugCodes="[true|false]"use the full bug pattern code instead of two-letter abbreviation
 format="text"generate plain text output with one bug per line (command-line default)
-html[:stylesheet]format="html:<stylesheet>"generate output with specified stylesheet (see below), or default.xsl if unspecified

- You may specify plain.xsl, default.xsl, fancy.xsl, fancy-hist.xsl, - or your own XSL stylesheet for the -html/format option. - Despite the name of this option, you may specify - a stylesheet that emits something other than html. - When applying a stylesheet other than those included - with FindBugs (listed above), the -html/format option should be used - with a path or URL to the stylesheet. -

1.7. setBugDatabaseInfo

- This command sets meta-information in a specified warning collection. - It takes the following options: -

This functionality may also can be accessed from ant. -First create a taskdef for setBugDatabaseInfo in your -build file: -

-
-<taskdef name="setBugDatabaseInfo" classname="edu.umd.cs.findbugs.anttask.SetBugDatabaseInfoTask">
-    <classpath refid="findbugs.lib" />
-</taskdef>
-
-

Attributes for this ant task are listed in the following table. -To specify an input file either use the input -attribute or nest it inside the ant call with a -<datafile> element. For example: -

-
-<setBugDatabaseInfo home="${findbugs.home}" ...>
-    <datafile name="analyze.xml"/>
-</setBugDatabaseInfo>
-
-

Table 12.7. setBugDatabaseInfo Options

Command-line optionAnt attributeMeaning
 input="<file>"use file as input
 output="<file>"write output to file
-name <name>name="<name>"set name for (last) revision
-timestamp <when>timestamp="<when>"set timestamp for (last) revision
-source <directory>source="<directory>"add specified directory to the source search path
-findSource <directory>findSource="<directory>"find and add all relevant source directions contained within specified directory
-suppress <filter file>suppress="<filter file>"suppress warnings matched by this file (replaces previous suppressions)
-withMessageswithMessages="[true|false]"add textual messages to XML
-resetSourceresetSource="[true|false]"remove all source search paths

1.8. listBugDatabaseInfo

This command takes a list of zero or more xml bug database filenames on the command line. -If zero file names are provided, it reads from standard input and does not generate -a table header.

There is only one option: -formatDates renders dates - in textual form. -

The output is a table one row per bug database and the following columns:

Table 12.8. listBugDatabaseInfo Columns

ColumnMeaning
versionversion name
timeRelease timestamp
classesNumber of classes analyzed
NCSSNon Commenting Source Statements analyzed
totalTotal number of warnings of all kinds
highTotal number of high priority warnings of all kinds
mediumTotal number of medium/normal priority warnings of all kinds
lowTotal number of low priority warnings of all kinds
filenamefilename of database

2. Examples

2.1. Mining history using proveded shell scrips

In all of the following, the commands are given in a directory that contains -directories jdk1.6.0-b12, jdk1.6.0-b13, ..., jdk1.6.0-b60.

You can use the command:

-computeBugHistory jdk1.6.0-b* | filterBugs -bugPattern IL_ | mineBugHistory -formatDates
-

to generate the following output:

-seq	version	time	classes	NCSS	added	newCode	fixed	removed	retained	dead	active
-0	jdk1.6.0-b12	"Thu Nov 11 09:07:20 EST 2004"	13128	811569	0	4	0	0	0	0	4
-1	jdk1.6.0-b13	"Thu Nov 18 06:02:06 EST 2004"	13128	811570	0	0	0	0	4	0	4
-2	jdk1.6.0-b14	"Thu Dec 02 06:12:26 EST 2004"	13145	811786	0	0	2	0	2	0	2
-3	jdk1.6.0-b15	"Thu Dec 09 06:07:04 EST 2004"	13174	811693	0	0	1	0	1	2	1
-4	jdk1.6.0-b16	"Thu Dec 16 06:21:28 EST 2004"	13175	811715	0	0	0	0	1	3	1
-5	jdk1.6.0-b17	"Thu Dec 23 06:27:22 EST 2004"	13176	811974	0	0	0	0	1	3	1
-6	jdk1.6.0-b19	"Thu Jan 13 06:41:16 EST 2005"	13176	812011	0	0	0	0	1	3	1
-7	jdk1.6.0-b21	"Thu Jan 27 05:57:52 EST 2005"	13177	812173	0	0	0	0	1	3	1
-8	jdk1.6.0-b23	"Thu Feb 10 05:44:36 EST 2005"	13179	812188	0	0	0	0	1	3	1
-9	jdk1.6.0-b26	"Thu Mar 03 06:04:02 EST 2005"	13199	811770	0	0	0	0	1	3	1
-10	jdk1.6.0-b27	"Thu Mar 10 04:48:38 EST 2005"	13189	812440	0	0	0	0	1	3	1
-11	jdk1.6.0-b28	"Thu Mar 17 02:54:22 EST 2005"	13185	812056	0	0	0	0	1	3	1
-12	jdk1.6.0-b29	"Thu Mar 24 03:09:20 EST 2005"	13117	809468	0	0	0	0	1	3	1
-13	jdk1.6.0-b30	"Thu Mar 31 02:53:32 EST 2005"	13118	809501	0	0	0	0	1	3	1
-14	jdk1.6.0-b31	"Thu Apr 07 03:00:14 EDT 2005"	13117	809572	0	0	0	0	1	3	1
-15	jdk1.6.0-b32	"Thu Apr 14 02:56:56 EDT 2005"	13169	811096	0	0	0	0	1	3	1
-16	jdk1.6.0-b33	"Thu Apr 21 02:46:22 EDT 2005"	13187	811942	0	0	0	0	1	3	1
-17	jdk1.6.0-b34	"Thu Apr 28 02:49:00 EDT 2005"	13195	813488	0	1	0	0	1	3	2
-18	jdk1.6.0-b35	"Thu May 05 02:49:04 EDT 2005"	13457	829837	0	0	0	0	2	3	2
-19	jdk1.6.0-b36	"Thu May 12 02:59:46 EDT 2005"	13462	831278	0	0	0	0	2	3	2
-20	jdk1.6.0-b37	"Thu May 19 02:55:08 EDT 2005"	13464	831971	0	0	0	0	2	3	2
-21	jdk1.6.0-b38	"Thu May 26 03:08:16 EDT 2005"	13564	836565	0	0	0	0	2	3	2
-22	jdk1.6.0-b39	"Fri Jun 03 03:10:48 EDT 2005"	13856	849992	0	1	0	0	2	3	3
-23	jdk1.6.0-b40	"Thu Jun 09 03:30:28 EDT 2005"	15972	959619	0	2	0	0	3	3	5
-24	jdk1.6.0-b41	"Thu Jun 16 03:19:22 EDT 2005"	15972	959619	0	0	0	0	5	3	5
-25	jdk1.6.0-b42	"Fri Jun 24 03:38:54 EDT 2005"	15966	958581	0	0	0	0	5	3	5
-26	jdk1.6.0-b43	"Thu Jul 14 03:09:34 EDT 2005"	16041	960544	0	0	0	0	5	3	5
-27	jdk1.6.0-b44	"Thu Jul 21 03:05:54 EDT 2005"	16041	960547	0	0	0	0	5	3	5
-28	jdk1.6.0-b45	"Thu Jul 28 03:26:10 EDT 2005"	16037	960606	0	0	1	0	4	3	4
-29	jdk1.6.0-b46	"Thu Aug 04 03:02:48 EDT 2005"	15936	951355	0	0	0	0	4	4	4
-30	jdk1.6.0-b47	"Thu Aug 11 03:18:56 EDT 2005"	15964	952387	0	0	1	0	3	4	3
-31	jdk1.6.0-b48	"Thu Aug 18 08:10:40 EDT 2005"	15970	953421	0	0	0	0	3	5	3
-32	jdk1.6.0-b49	"Thu Aug 25 03:24:38 EDT 2005"	16048	958940	0	0	0	0	3	5	3
-33	jdk1.6.0-b50	"Thu Sep 01 01:52:40 EDT 2005"	16287	974937	1	0	0	0	3	5	4
-34	jdk1.6.0-b51	"Thu Sep 08 01:55:36 EDT 2005"	16362	979377	0	0	0	0	4	5	4
-35	jdk1.6.0-b52	"Thu Sep 15 02:04:08 EDT 2005"	16477	979399	0	0	0	0	4	5	4
-36	jdk1.6.0-b53	"Thu Sep 22 02:00:28 EDT 2005"	16019	957900	0	0	1	0	3	5	3
-37	jdk1.6.0-b54	"Thu Sep 29 01:54:34 EDT 2005"	16019	957900	0	0	0	0	3	6	3
-38	jdk1.6.0-b55	"Thu Oct 06 01:54:14 EDT 2005"	16051	959014	0	0	0	0	3	6	3
-39	jdk1.6.0-b56	"Thu Oct 13 01:54:12 EDT 2005"	16211	970835	0	0	0	0	3	6	3
-40	jdk1.6.0-b57	"Thu Oct 20 01:55:26 EDT 2005"	16279	971627	0	0	0	0	3	6	3
-41	jdk1.6.0-b58	"Thu Oct 27 01:56:30 EDT 2005"	16283	971945	0	0	0	0	3	6	3
-42	jdk1.6.0-b59	"Thu Nov 03 01:56:58 EST 2005"	16232	972193	0	0	0	0	3	6	3
-43	jdk1.6.0-b60	"Thu Nov 10 01:54:18 EST 2005"	16235	972346	0	0	0	0	3	6	3
-

-We could also generate that information directly, without creating an intermediate db.xml file, using the command -

-computeBugHistory  jdk1.6.0-b*/jre/lib/rt.xml | filterBugs -bugPattern IL_ db.xml | mineBugHistory -formatDates
-

We can then use that information to display a graph showing the number of infinite recursive loops -found by FindBugs in each build of Sun's JDK1.6.0. The blue area indicates the number of infinite -recursive loops in that build, the red area above it indicates the number of infinite recursive loops that existed -in some previous version but not in the current version (thus, the combined height of the red and blue areas -is guaranteed to never decrease, and goes up whenever a new infinite recursive loop bug is introduced). The height -of the red area is computed as the sum of the fixed, removed and dead values for each version. -The reductions in builds 13 and 14 came after Sun was notified about the bugs found by FindBugs in the JDK. -

-Given the db.xml file that contains the results for all the jdk1.6.0 builds, the following command will show the history of high and medium priority correctness warnings: -

-filterBugs -priority M -category C db.xml | mineBugHistory -formatDates
-

-generating the table: -

-seq	version	time	classes	NCSS	added	newCode	fixed	removed	retained	dead	active
-0	jdk1.6.0-b12	"Thu Nov 11 09:07:20 EST 2004"	13128	811569	0	1075	0	0	0	0	1075
-1	jdk1.6.0-b13	"Thu Nov 18 06:02:06 EST 2004"	13128	811570	0	0	0	0	1075	0	1075
-2	jdk1.6.0-b14	"Thu Dec 02 06:12:26 EST 2004"	13145	811786	3	0	6	0	1069	0	1072
-3	jdk1.6.0-b15	"Thu Dec 09 06:07:04 EST 2004"	13174	811693	2	1	3	0	1069	6	1072
-4	jdk1.6.0-b16	"Thu Dec 16 06:21:28 EST 2004"	13175	811715	0	0	1	0	1071	9	1071
-5	jdk1.6.0-b17	"Thu Dec 23 06:27:22 EST 2004"	13176	811974	0	0	1	0	1070	10	1070
-6	jdk1.6.0-b19	"Thu Jan 13 06:41:16 EST 2005"	13176	812011	0	0	0	0	1070	11	1070
-7	jdk1.6.0-b21	"Thu Jan 27 05:57:52 EST 2005"	13177	812173	0	0	1	0	1069	11	1069
-8	jdk1.6.0-b23	"Thu Feb 10 05:44:36 EST 2005"	13179	812188	0	0	0	0	1069	12	1069
-9	jdk1.6.0-b26	"Thu Mar 03 06:04:02 EST 2005"	13199	811770	0	0	2	1	1066	12	1066
-10	jdk1.6.0-b27	"Thu Mar 10 04:48:38 EST 2005"	13189	812440	1	0	1	1	1064	15	1065
-11	jdk1.6.0-b28	"Thu Mar 17 02:54:22 EST 2005"	13185	812056	0	0	0	0	1065	17	1065
-12	jdk1.6.0-b29	"Thu Mar 24 03:09:20 EST 2005"	13117	809468	3	0	8	26	1031	17	1034
-13	jdk1.6.0-b30	"Thu Mar 31 02:53:32 EST 2005"	13118	809501	0	0	0	0	1034	51	1034
-14	jdk1.6.0-b31	"Thu Apr 07 03:00:14 EDT 2005"	13117	809572	0	0	0	0	1034	51	1034
-15	jdk1.6.0-b32	"Thu Apr 14 02:56:56 EDT 2005"	13169	811096	1	1	0	1	1033	51	1035
-16	jdk1.6.0-b33	"Thu Apr 21 02:46:22 EDT 2005"	13187	811942	3	0	2	1	1032	52	1035
-17	jdk1.6.0-b34	"Thu Apr 28 02:49:00 EDT 2005"	13195	813488	0	1	0	0	1035	55	1036
-18	jdk1.6.0-b35	"Thu May 05 02:49:04 EDT 2005"	13457	829837	0	36	2	0	1034	55	1070
-19	jdk1.6.0-b36	"Thu May 12 02:59:46 EDT 2005"	13462	831278	0	0	0	0	1070	57	1070
-20	jdk1.6.0-b37	"Thu May 19 02:55:08 EDT 2005"	13464	831971	0	1	1	0	1069	57	1070
-21	jdk1.6.0-b38	"Thu May 26 03:08:16 EDT 2005"	13564	836565	1	7	2	6	1062	58	1070
-22	jdk1.6.0-b39	"Fri Jun 03 03:10:48 EDT 2005"	13856	849992	6	39	5	0	1065	66	1110
-23	jdk1.6.0-b40	"Thu Jun 09 03:30:28 EDT 2005"	15972	959619	7	147	11	0	1099	71	1253
-24	jdk1.6.0-b41	"Thu Jun 16 03:19:22 EDT 2005"	15972	959619	0	0	0	0	1253	82	1253
-25	jdk1.6.0-b42	"Fri Jun 24 03:38:54 EDT 2005"	15966	958581	3	0	1	2	1250	82	1253
-26	jdk1.6.0-b43	"Thu Jul 14 03:09:34 EDT 2005"	16041	960544	5	11	15	8	1230	85	1246
-27	jdk1.6.0-b44	"Thu Jul 21 03:05:54 EDT 2005"	16041	960547	0	0	0	0	1246	108	1246
-28	jdk1.6.0-b45	"Thu Jul 28 03:26:10 EDT 2005"	16037	960606	19	0	2	0	1244	108	1263
-29	jdk1.6.0-b46	"Thu Aug 04 03:02:48 EDT 2005"	15936	951355	13	1	1	32	1230	110	1244
-30	jdk1.6.0-b47	"Thu Aug 11 03:18:56 EDT 2005"	15964	952387	163	8	7	20	1217	143	1388
-31	jdk1.6.0-b48	"Thu Aug 18 08:10:40 EDT 2005"	15970	953421	0	0	0	0	1388	170	1388
-32	jdk1.6.0-b49	"Thu Aug 25 03:24:38 EDT 2005"	16048	958940	1	11	1	0	1387	170	1399
-33	jdk1.6.0-b50	"Thu Sep 01 01:52:40 EDT 2005"	16287	974937	19	27	16	7	1376	171	1422
-34	jdk1.6.0-b51	"Thu Sep 08 01:55:36 EDT 2005"	16362	979377	1	15	3	0	1419	194	1435
-35	jdk1.6.0-b52	"Thu Sep 15 02:04:08 EDT 2005"	16477	979399	0	0	1	1	1433	197	1433
-36	jdk1.6.0-b53	"Thu Sep 22 02:00:28 EDT 2005"	16019	957900	13	12	16	20	1397	199	1422
-37	jdk1.6.0-b54	"Thu Sep 29 01:54:34 EDT 2005"	16019	957900	0	0	0	0	1422	235	1422
-38	jdk1.6.0-b55	"Thu Oct 06 01:54:14 EDT 2005"	16051	959014	1	4	7	0	1415	235	1420
-39	jdk1.6.0-b56	"Thu Oct 13 01:54:12 EDT 2005"	16211	970835	6	8	37	0	1383	242	1397
-40	jdk1.6.0-b57	"Thu Oct 20 01:55:26 EDT 2005"	16279	971627	0	0	0	0	1397	279	1397
-41	jdk1.6.0-b58	"Thu Oct 27 01:56:30 EDT 2005"	16283	971945	0	1	1	0	1396	279	1397
-42	jdk1.6.0-b59	"Thu Nov 03 01:56:58 EST 2005"	16232	972193	6	0	5	0	1392	280	1398
-43	jdk1.6.0-b60	"Thu Nov 10 01:54:18 EST 2005"	16235	972346	0	0	0	0	1398	285	1398
-44	jdk1.6.0-b61	"Thu Nov 17 01:58:42 EST 2005"	16202	971134	2	0	4	0	1394	285	1396
-

2.2. Incremental history maintenance

-If db.xml contains the results of running findbugs over builds b12 - b60, we can update db.xml to include the results of analyzing b61 with the commands: -

-computeBugHistory -output db.xml db.xml jdk1.6.0-b61/jre/lib/rt.xml
-

3. Ant example

-Here is a complete ant script example for both running findbugs and running a chain of data-mining tools afterward: -

-
-<project name="analyze_asm_util" default="findbugs">
-   <!-- findbugs task definition -->
-   <property name="findbugs.home" value="/Users/ben/Documents/workspace/findbugs/findbugs" />
-   <property name="jvmargs" value="-server -Xss1m -Xmx800m -Duser.language=en -Duser.region=EN -Dfindbugs.home=${findbugs.home}" />
-
-    <path id="findbugs.lib">
-      <fileset dir="${findbugs.home}/lib">
-         <include name="findbugs-ant.jar"/>
-      </fileset>
-   </path>
-
-   <taskdef name="findbugs" classname="edu.umd.cs.findbugs.anttask.FindBugsTask">
-      <classpath refid="findbugs.lib" />
-   </taskdef>
-
-   <taskdef name="computeBugHistory" classname="edu.umd.cs.findbugs.anttask.ComputeBugHistoryTask">
-      <classpath refid="findbugs.lib" />
-   </taskdef>
-
-   <taskdef name="setBugDatabaseInfo" classname="edu.umd.cs.findbugs.anttask.SetBugDatabaseInfoTask">
-      <classpath refid="findbugs.lib" />
-   </taskdef>
-
-   <taskdef name="mineBugHistory" classname="edu.umd.cs.findbugs.anttask.MineBugHistoryTask">
-      <classpath refid="findbugs.lib" />
-   </taskdef>
-
-   <!-- findbugs task definition -->
-   <target name="findbugs">
-      <antcall target="analyze" />
-      <antcall target="mine" />
-   </target>
-
-   <!-- analyze task -->
-   <target name="analyze">
-      <!-- run findbugs against asm-util -->
-      <findbugs home="${findbugs.home}"
-                output="xml:withMessages"
-                timeout="90000000"
-                reportLevel="experimental"
-                workHard="true"
-                effort="max"
-                adjustExperimental="true"
-                jvmargs="${jvmargs}"
-                failOnError="true"
-                outputFile="out.xml"
-                projectName="Findbugs"
-                debug="false">
-         <class location="asm-util-3.0.jar" />
-      </findbugs>
-   </target>
-
-   <target name="mine">
-
-      <!-- Set info to the latest analysis -->
-      <setBugDatabaseInfo home="${findbugs.home}"
-                            withMessages="true"
-                            name="asm-util-3.0.jar"
-                            input="out.xml"
-                            output="out-rel.xml"/>
-
-      <!-- Checking if history file already exists (out-hist.xml) -->
-      <condition property="mining.historyfile.available">
-         <available file="out-hist.xml"/>
-      </condition>
-      <condition property="mining.historyfile.notavailable">
-         <not>
-            <available file="out-hist.xml"/>
-         </not>
-      </condition>
-
-      <!-- this target is executed if the history file do not exist (first run) -->
-      <antcall target="history-init">
-        <param name="data.file" value="out-rel.xml" />
-        <param name="hist.file" value="out-hist.xml" />
-      </antcall>
-      <!-- else this one is executed -->
-      <antcall target="history">
-        <param name="data.file"         value="out-rel.xml" />
-        <param name="hist.file"         value="out-hist.xml" />
-        <param name="hist.summary.file" value="out-hist.txt" />
-      </antcall>
-   </target>
-
-   <!-- Initializing history file -->
-   <target name="history-init" if="mining.historyfile.notavailable">
-      <copy file="${data.file}" tofile="${hist.file}" />
-   </target>
-
-   <!-- Computing bug history -->
-   <target name="history" if="mining.historyfile.available">
-      <!-- Merging ${data.file} into ${hist.file} -->
-      <computeBugHistory home="${findbugs.home}"
-                           withMessages="true"
-                           output="${hist.file}">
-            <dataFile name="${hist.file}"/>
-            <dataFile name="${data.file}"/>
-      </computeBugHistory>
-
-      <!-- Compute history into ${hist.summary.file} -->
-      <mineBugHistory home="${findbugs.home}"
-                        formatDates="true"
-                      noTabs="true"
-                        input="${hist.file}"
-                        output="${hist.summary.file}"/>
-   </target>
-
-</project>
-
-
Prev   Next
Chapter 11. Using rejarForAnalysis Home Chapter 13. License
\ No newline at end of file diff --git a/manual/eclipse.html b/manual/eclipse.html deleted file mode 100644 index e233234..0000000 --- a/manual/eclipse.html +++ /dev/null @@ -1,121 +0,0 @@ - - - Chapter 7. Using the FindBugs™ Eclipse plugin
Chapter 7. Using the FindBugs™ Eclipse plugin
Prev   Next

Chapter 7. Using the FindBugs™ Eclipse plugin

Table of Contents

1. Requirements
2. Installation
3. Using the Plugin
4. Extending the Eclipse Plugin (since 2.0.0)
5. Troubleshooting

-The FindBugs Eclipse plugin allows FindBugs to be used within -the Eclipse IDE. -The FindBugs Eclipse plugin was generously contributed by Peter Friese. -Phil Crosby and Andrey Loskutov contributed major improvements -to the plugin. -

1. Requirements

-To use the FindBugs Plugin for Eclipse, you need Eclipse 3.3 or later, -and JRE/JDK 1.5 or later. -

2. Installation

- We provide update sites that allow you to automatically install FindBugs into Eclipse and also query and install updates. - There are three different update sites

FindBugs Eclipse update sites

http://findbugs.cs.umd.edu/eclipse/

- Only provides official releases of FindBugs. -

http://findbugs.cs.umd.edu/eclipse-candidate/

- Provides official releases and release candidates of FindBugs. -

http://findbugs.cs.umd.edu/eclipse-daily/

- Provides the daily build of FindBugs. No testing other than that it compiles. -

You can also manually -download the plugin from the following link: -http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_3.1.0.20161105.zip?download. -Extract it in Eclipse's "plugins" subdirectory. -(So <eclipse_install_dir>/plugins/edu.umd.cs.findbugs.plugin.eclipse_3.1.0.20161105/findbugs.png -should be the path to the FindBugs logo.) - -

-Once the plugin is extracted, start Eclipse and choose -Help → About Eclipse Platform → Plug-in Details. -You should find a plugin called "FindBugs Plug-in" provided by "FindBugs Project". -

3. Using the Plugin

-To get started, right click on a Java project in Package Explorer, -and select the option labeled "Find Bugs". -FindBugs will run, and problem markers (displayed in source -windows, and also in the Eclipse Problems view) will point to -locations in your code which have been identified as potential instances -of bug patterns. -

-You can also run FindBugs on existing java archives (jar, ear, zip, war etc). Simply -create an empty Java project and attach archives to the project classpath. Having that, you -can now right click the archive node in Package Explorer and select the option labeled -"Find Bugs". If you additionally configure the source code locations for the binaries, -FindBugs will also link the generated warnings to the right source files. -

-You may customize how FindBugs runs by opening the Properties -dialog for a Java project, and choosing the "Findbugs" property page. -Options you may choose include: -

  • - Enable or disable the "Run FindBugs Automatically" checkbox. - When enabled, FindBugs will run every time you modify a Java class - within the project. -

  • - Choose minimum warning priority and enabled bug categories. - These options will choose which warnings are shown. - For example, if you select the "Medium" warning priority, - only Medium and High priority warnings will be shown. - Similarly, if you uncheck the "Style" checkbox, no warnings - in the Style category will be displayed. -

  • - Select detectors. The table allows you to select which detectors - you want to enable for your project. -

4. Extending the Eclipse Plugin (since 2.0.0)

-Eclipse plugin supports contribution of custom FindBugs detectors (see also -AddingDetectors.txt -for more information). There are two ways to contribute custom plugins to the Eclipse: -

  • - Existing standard FindBugs detector packages can be configured via - Window → Preferences → Java → FindBugs → Misc. Settings → Custom Detectors. - Simply specify there locations of any additional plugin libraries. -

    - The benefit of this solution is that already existing detector packages can be - used "as is", and that you can quickly verify the quality of third party detectors. - The drawback is that you have to apply this settings in each - new Eclipse workspace, and this settings can't be shared between team members. -

  • - It is possible to contribute custom detectors via standard Eclipse extensions mechanism. -

    - Please check the documentation of the - - findBugsEclipsePlugin/schema/detectorPlugins.exsd - extension point how to update the plugin.xml. Existing FindBugs detector plugins can - be easily "extended" to be full featured FindBugs AND Eclipse detector plugins. - Usually you only need to add META-INF/MANIFEST.MF and plugin.xml to the jar and - update your build scripts to not to override the MANIFEST.MF during the build. -

    - The benefit of this solution is that for given (shared) Eclipse installation - each team member has exactly same detectors set, and there is no need to configure - anything anymore. The (really small) precondition - is that you have to convert your existing detectors package to the valid - Eclipse plugin. You can do this even for third-party detector packages. - Another major differentiator is the ability to extend the default FindBugs - classpath at runtime with required third party libraries (see - AddingDetectors.txt - for more information). -

5. Troubleshooting

-This section lists common problems with the plugin and (if known) how to resolve them. -

  • - If you see OutOfMemory error dialogs after starting FindBugs analysis in Eclipse, - please increase JVM available memory: change eclipse.ini and add the lines below - to the end of the file: - 

    -    -vmargs
-    -Xmx1000m
-

    - Important: the configuration arguments starting with the line "-vmargs" must - be last lines in the eclipse.ini file, and only one argument per line is allowed! -

  • - If you do not see any FindBugs problem markers (in your source - windows or in the Problems View), you may need to change your - Problems View filter settings. See - http://findbugs.sourceforge.net/FAQ.html#q7 for more information. -

Prev   Next
Chapter 6. Using the FindBugs™ Ant task Home Chapter 8. Filter Files
\ No newline at end of file diff --git a/manual/example-code.png b/manual/example-code.png deleted file mode 100644 index fe01f317ae1e27a207c5847c8f553da4d97101d1..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 17799 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 Ib4q9e05s!)cPloG1+-rJ>jPyy+^36Y@E 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 Ib4q9e08buq{r~^~ diff --git a/manual/filter.html b/manual/filter.html deleted file mode 100644 index a097406..0000000 --- a/manual/filter.html +++ /dev/null @@ -1,387 +0,0 @@ - - - Chapter 8. Filter Files
Chapter 8. Filter Files
Prev   Next

Chapter 8. Filter Files

Table of Contents

1. Introduction to Filter Files
2. Types of Match clauses
3. Java element name matching
4. Caveats
5. Examples
6. Complete Example

-Filter files may be used to include or exclude bug reports for particular classes -and methods. This chapter explains how to use filter files. -

1. Introduction to Filter Files

-Conceptually, a filter matches bug instances against a set of criteria. -By defining a filter, you can select bug instances for special treatment; -for example, to exclude or include them in a report. -

-A filter file is an XML document with a top-level FindBugsFilter element -which has some number of Match elements as children. Each Match -element represents a predicate which is applied to generated bug instances. -Usually, a filter will be used to exclude bug instances. For example: - -

-$ findbugs -textui -exclude myExcludeFilter.xml myApp.jar
-

- -However, a filter could also be used to select bug instances to specifically -report: - -

-$ findbugs -textui -include myIncludeFilter.xml myApp.jar
-

-

-Match elements contain children, which are conjuncts of the predicate. -In other words, each of the children must be true for the predicate to be true. -

2. Types of Match clauses

<Bug>

- This element specifies a particular bug pattern or patterns to match. - The pattern attribute is a comma-separated list of - bug pattern types. You can find the bug pattern types for particular - warnings by looking at the output produced by the -xml - output option (the type attribute of BugInstance - elements), or from the bug - descriptions document. -

- For more coarse-grained matching, use code attribute. It takes - a comma-separated list of bug abbreviations. For most-coarse grained matching use - category attriute, that takes a comma separated list of bug category names: - CORRECTNESS, MT_CORRECTNESS, - BAD_PRACTICICE, PERFORMANCE, STYLE. -

- If more than one of the attributes mentioned above are specified on the same - <Bug> element, all bug patterns that match either one of specified - pattern names, or abreviations, or categories will be matched. -

- As a backwards compatibility measure, <BugPattern> and - <BugCode> elements may be used instead of - <Bug> element. Each of these uses a - name attribute for specifying accepted values list. Support for these - elements may be removed in a future release. -

<Confidence>

- This element matches warnings with a particular bug confidence. - The value attribute should be an integer value: - 1 to match high-confidence warnings, 2 to match normal-confidence warnings, - or 3 to match low-confidence warnings. <Confidence> replaced - <Priority> in 2.0.0 release. -

<Priority>

- Same as <Confidence>, exists for backward compatibility. -

<Rank>

- This element matches warnings with a particular bug rank. - The value attribute should be an integer value - between 1 and 20, where 1 to 4 are scariest, 5 to 9 scary, 10 to 14 troubling, - and 15 to 20 of concern bugs. -

<Package>

- This element matches warnings associated with classes within the package specified - using name attribute. Nested packages are not included (along the - lines of Java import statement). However matching multiple packages can be achieved - easily using regex name match. -

<Class>

- This element matches warnings associated with a particular class. The - name attribute is used to specify the exact or regex match pattern - for the class name. The role attribute is the class role. -

- As a backward compatibility measure, instead of element of this type, you can use - class attribute on a Match element to specify - exact an class name or classregex attribute to specify a regular - expression to match the class name against. -

- If the Match element contains neither a Class element, - nor a class / classregex attribute, the predicate will apply - to all classes. Such predicate is likely to match more bug instances than you want, unless it is - refined further down with appropriate method or field predicates. -

<Source>

- This element matches warnings associated with a particular source file. The - name attribute is used to specify the exact or regex match pattern - for the source file name. -

<Method>

This element specifies a method. The name is used to specify - the exact or regex match pattern for the method name. - The params attribute is a comma-separated list - of the types of the method's parameters. The returns attribute is - the method's return type. The role attribute is - the method role. In params and returns, class names - must be fully qualified. (E.g., "java.lang.String" instead of just - "String".) If one of the latter attributes is specified the other is required for creating a method signature. - Note that you can provide either name attribute or params - and returns attributes or all three of them. This way you can provide various kinds of - name and signature based matches. -

<Field>

This element specifies a field. The name attribute is is used to specify - the exact or regex match pattern for the field name. You can also filter fields according to their signature - - use type attribute to specify fully qualified type of the field. You can specify either or both - of these attributes in order to perform name / signature based matches. The role attribute is - the field role. -

<Local>

This element specifies a local variable. The name attribute is is used to specify - the exact or regex match pattern for the local variable name. Local variables are variables defined within a method. -

<Or>

- This element combines Match clauses as disjuncts. I.e., you can put two - Method elements in an Or clause in order to match either method. -

<And>

- This element combines Match clauses which both must evaluate to true. I.e., you can put - Bug and Confidence elements in an And clause in order - to match specific bugs with given confidence only. -

<Not>

- This element inverts the included child Match. I.e., you can put a - Bug element in a Not clause in order to match any bug - excluding the given one. -

3. Java element name matching

-If the name attribute of Class, Source, -Method or Field starts with the ~ character -the rest of attribute content is interpreted as -a Java regular expression that is matched against the names of the Java element in question. -

-Note that the pattern is matched against whole element name and therefore .* clauses need to be used -at pattern beginning and/or end to perform substring matching. -

-See java.util.regex.Pattern -documentation for pattern syntax. -

4. Caveats

-Match clauses can only match information that is actually contained in the -bug instances. Every bug instance has a class, so in general, excluding -bugs by class will work. -

-Some bug instances have two (or more) classes. For example, the DE (dropped exception) -bugs report both the class containing the method where the dropped exception -happens, and the class which represents the type of the dropped exception. -Only the first (primary) class is matched against Match clauses. -So, for example, if you want to suppress IC (initialization circularity) -reports for classes "com.foobar.A" and "com.foobar.B", you would use -two Match clauses: - -

-   <Match>
-      <Class name="com.foobar.A" />
-      <Bug code="IC" />
-   </Match>
-
-   <Match>
-      <Class name="com.foobar.B" />
-      <Bug code="IC" />
-   </Match>
-

- -By explicitly matching both classes, you ensure that the IC bug instance will be -matched regardless of which class involved in the circularity happens to be -listed first in the bug instance. (Of course, this approach might accidentally -suppress circularities involving "com.foobar.A" or "com.foobar.B" and a third -class.) -

-Many kinds of bugs report what method they occur in. For those bug instances, -you can put Method clauses in the Match element and they should work -as expected. -

5. Examples

- 1. Match all bug reports for a class. - -

-
-     <Match>
-       <Class name="com.foobar.MyClass" />
-     </Match>
-
-

- -

- 2. Match certain tests from a class by specifying their abbreviations. -

-
-     <Match>
-       <Class name="com.foobar.MyClass"/ >
-       <Bug code="DE,UrF,SIC" />
-     </Match>
-
-

-

- 3. Match certain tests from all classes by specifying their abbreviations. - -

-
-     <Match>
-       <Bug code="DE,UrF,SIC" />
-     </Match>
-
-

-

- 4. Match certain tests from all classes by specifying their category. - -

-
-     <Match>
-       <Bug category="PERFORMANCE" />
-     </Match>
-
-

-

- 5. Match bug types from specified methods of a class by their abbreviations. - -

-
-     <Match>
-       <Class name="com.foobar.MyClass" />
-       <Or>
-         <Method name="frob" params="int,java.lang.String" returns="void" />
-         <Method name="blat" params="" returns="boolean" />
-       </Or>
-       <Bug code="DC" />
-     </Match>
-
-

-

- 6. Match a particular bug pattern in a particular method. - -

-
-    <!-- A method with an open stream false positive. -->
-    <Match>
-      <Class name="com.foobar.MyClass" />
-      <Method name="writeDataToFile" />
-      <Bug pattern="OS_OPEN_STREAM" />
-    </Match>
-
-

-

- 7. Match a particular bug pattern with a given priority in a particular method. - -

-
-    <!-- A method with a dead local store false positive (medium priority). -->
-    <Match>
-      <Class name="com.foobar.MyClass" />
-      <Method name="someMethod" />
-      <Bug pattern="DLS_DEAD_LOCAL_STORE" />
-      <Priority value="2" />
-    </Match>
-
-

-

- 8. Match minor bugs introduced by AspectJ compiler (you are probably not interested in these unless - you are an AspectJ developer). - -

-
-    <Match>
-      <Class name="~.*\$AjcClosure\d+" />
-      <Bug pattern="DLS_DEAD_LOCAL_STORE" />
-      <Method name="run" />
-    </Match>
-    <Match>
-      <Bug pattern="UUF_UNUSED_FIELD" />
-      <Field name="~ajc\$.*" />
-    </Match>
-
-

-

- 9. Match bugs in specific parts of the code base - -

-
-    <!-- match unused fields warnings in Messages classes in all packages -->
-    <Match>
-      <Class name="~.*\.Messages" />
-      <Bug code="UUF" />
-    </Match>
-    <!-- match mutable statics warnings in all internal packages -->
-    <Match>
-      <Package name="~.*\.internal" />
-      <Bug code="MS" />
-    </Match>
-    <!-- match anonymoous inner classes warnings in ui package hierarchy -->
-    <Match>
-      <Package name="~com\.foobar\.fooproject\.ui.*" />
-      <Bug pattern="SIC_INNER_SHOULD_BE_STATIC_ANON" />
-    </Match>
-
-

-

- 10. Match bugs on fields or methods with specific signatures -

-
-    <!-- match System.exit(...) usage warnings in void main(String[]) methods in all classes -->
-    <Match>
-      <Method returns="void" name="main" params="java.lang.String[]" />
-      <Bug pattern="DM_EXIT" />
-    </Match>
-    <!-- match UuF warnings on fields of type com.foobar.DebugInfo on all classes -->
-    <Match>
-      <Field type="com.foobar.DebugInfo" />
-      <Bug code="UuF" />
-    </Match>
-
-

-

- 11. Match bugs using the Not filter operator -

-
-<!-- ignore all bugs in test classes, except for those bugs specifically relating to JUnit tests -->
-<!-- i.e. filter bug if ( classIsJUnitTest && ! bugIsRelatedToJUnit ) -->
-<Match>
-  <!-- the Match filter is equivalent to a logical 'And' -->
-
-  <Class name="~.*\.*Test" />
-  <!-- test classes are suffixed by 'Test' -->
-
-  <Not>
-      <Bug code="IJU" /> <!-- 'IJU' is the code for bugs related to JUnit test code -->
-  </Not>
-</Match>
-
-

-

- 12. Full exclusion filter file to match all classes generated from Groovy source files. - -

-
-<?xml version="1.0" encoding="UTF-8"?>
-<FindBugsFilter>
-<Match>
-    <Source name="~.*\.groovy" />
-</Match>
-</FindBugsFilter>
-
-

-

6. Complete Example

-
-<FindBugsFilter>
-     <Match>
-       <Class name="com.foobar.ClassNotToBeAnalyzed" />
-     </Match>
-
-     <Match>
-       <Class name="com.foobar.ClassWithSomeBugsMatched" />
-       <Bug code="DE,UrF,SIC" />
-     </Match>
-
-     <!-- Match all XYZ violations. -->
-     <Match>
-       <Bug code="XYZ" />
-     </Match>
-
-     <!-- Match all doublecheck violations in these methods of "AnotherClass". -->
-     <Match>
-       <Class name="com.foobar.AnotherClass" />
-       <Or>
-         <Method name="nonOverloadedMethod" />
-         <Method name="frob" params="int,java.lang.String" returns="void" />
-         <Method name="blat" params="" returns="boolean" />
-       </Or>
-       <Bug code="DC" />
-     </Match>
-
-     <!-- A method with a dead local store false positive (medium priority). -->
-     <Match>
-       <Class name="com.foobar.MyClass" />
-       <Method name="someMethod" />
-       <Bug pattern="DLS_DEAD_LOCAL_STORE" />
-       <Priority value="2" />
-     </Match>
-
-     <!-- All bugs in test classes, except for JUnit-specific bugs -->
-     <Match>
-      <Class name="~.*\.*Test" />
-      <Not>
-          <Bug code="IJU" />
-      </Not>
-     </Match>
-
-</FindBugsFilter>
-
-
Prev   Next
Chapter 7. Using the FindBugs™ Eclipse plugin Home Chapter 9. Analysis Properties
\ No newline at end of file diff --git a/manual/gui.html b/manual/gui.html deleted file mode 100644 index 45f18cc..0000000 --- a/manual/gui.html +++ /dev/null @@ -1,77 +0,0 @@ - - - Chapter 5. Using the FindBugs GUI
Chapter 5. Using the FindBugs GUI
Prev   Next

Chapter 5. Using the FindBugs GUI

Table of Contents

1. Creating a Project
2. Running the Analysis
3. Browsing Results
4. Saving and Opening

- This chapter describes how to use the FindBugs graphical user interface (GUI). -

1. Creating a Project

-After you have started FindBugs using the findbugs command, -choose the File → New Project -menu item. You will see a dialog which looks like this: -

-

-Use the "Add" button next to "Classpath to analyze" to select a Java archive -file (zip, jar, ear, or war file) or directory containing java classes to analyze for bugs. You may add multiple -archives/directories. -

-You can also add the source directories which contain -the source code for the Java archives you are analyzing. This will enable -FindBugs to highlight the source code which contains a possible error. -The source directories you add should be the roots of the Java -package hierarchy. For example, if your application is contained in the -org.foobar.myapp package, you should add the -parent directory of the org directory -to the source directory list for the project. -

-Another optional step is to add additional Jar files or directories as -"Auxiliary classpath locations" entries. You should do this if the archives and directories you are analyzing -have references to other classes which are not included in the analyzed -archives/directories and are not in the standard runtime classpath. Some of the bug -pattern detectors in FindBugs make use of class hierarchy information, -so you will get more accurate results if the entire class hierarchy is -available which FindBugs performs its analysis. -

2. Running the Analysis

-Once you have added all of the archives, directories, and source directories, -click the "Analyze" button to analyze the classes contained in the -Jar files. Note that for a very large program on an older computer, -this may take quite a while (tens of minutes). A recent computer with -ample memory will typically be able to analyze a large program in only a -few minutes. -

3. Browsing Results

-When the analysis completes, you will see a screen like the following: -

-

-The upper left-hand pane of the window shows the bug tree; this is a hierarchical -representation of all of the potential bugs detected in the analyzed -Jar files. -

-When you select a particular bug instance in the top pane, you will -see a description of the bug in the "Details" tab of the bottom pane. -In addition, the source code pane on the upper-right will show the -program source code where the potential bug occurs, if source is available. -In the above example, the bug is a stream object that is not closed. The -source code window highlights the line where the stream object is created. -

-You may add a textual annotations to bug instances. To do so, type them -into the text box just below the hierarchical view. You can type any -information which you would like to record. When you load and save bug -results files, the annotations are preserved. -

4. Saving and Opening

-You may use the File → Save as... -menu option to save your work. To save your work, including the jar -file lists you specified and all bug results, choose -"FindBugs analysis results (.xml)" from the drop-down list in the -"Save as..." dialog. There are also options for saving just the jar -file lists ("FindBugs project file (.fbp)") or just the results -("FindBugs analysis file (.fba)"). -A saved file may be loaded with the -File → Open... -menu option. -

Prev   Next
Chapter 4. Running FindBugs™ Home Chapter 6. Using the FindBugs™ Ant task
\ No newline at end of file diff --git a/manual/important.png b/manual/important.png deleted file mode 100644 index 12c90f607a1b27ddde0a7d922ae255e8c90e883e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 722 zcmV;@0xkWCP)Gdz_qOoSb{LwMwNgp7=gl$4aErG%}mjHRWNrKOy`y@b8JoTa6ut*xc4t*y1SwY|N)#>U3Z&d%1> z*52OU=jZ3|@9+2b_y7O@tTMkk%M`~Kg@u8&dg_P^_0l3yQb639!jLZt^Lx<-O17UeeJ z-|=!77W(jGx&e#?FOku-gKofoU0$~4M+dhLFueEauP`}l7LV=;lsOdn%WHure=x;k`m0(bF&MU#) z-qv#^n8(MjB|ykioqII#+`g4no-MU=BK|Sahu_3M_-d*=7hq=~t?^}A)G7 zbairN0An*{V`DL9V>K}|HDobmIW;*pIW=W9HaTQ6F*7kTGI9=S@Bjb+07*qoM6N<$ Ef=i}M4FCWD diff --git a/manual/index.html b/manual/index.html deleted file mode 100644 index 4502fda..0000000 --- a/manual/index.html +++ /dev/null @@ -1,19 +0,0 @@ - - - FindBugs™ Manual
FindBugs™ Manual
   Next

FindBugs™ Manual

David H. Hovemeyer

William W. Pugh

Copyright © 2003 - 2012 University of Maryland

-This manual is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike License. -To view a copy of this license, visit -http://creativecommons.org/licenses/by-nc-sa/1.0/ -or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA. -

-The name FindBugs and the FindBugs logo are trademarked by the University of Maryland. -

20:57:33 ART, 05 November, 2016

Table of Contents

1. Introduction
1. Requirements
2. Installing FindBugs™
1. Extracting the Distribution
3. Building FindBugs™ from Source
1. Prerequisites
2. Extracting the Source Distribution
3. Modifying local.properties
4. Running Ant
5. Running FindBugs™ from a source directory
4. Running FindBugs™
1. Quick Start
2. Executing FindBugs
3. Command-line Options
5. Using the FindBugs GUI
1. Creating a Project
2. Running the Analysis
3. Browsing Results
4. Saving and Opening
6. Using the FindBugs™ Ant task
1. Installing the Ant task
2. Modifying build.xml
3. Executing the task
4. Parameters
7. Using the FindBugs™ Eclipse plugin
1. Requirements
2. Installation
3. Using the Plugin
4. Extending the Eclipse Plugin (since 2.0.0)
5. Troubleshooting
8. Filter Files
1. Introduction to Filter Files
2. Types of Match clauses
3. Java element name matching
4. Caveats
5. Examples
6. Complete Example
9. Analysis Properties
10. Annotations
11. Using rejarForAnalysis
12. Data mining of bugs with FindBugs™
1. Commands
2. Examples
3. Ant example
13. License
14. Acknowledgments
1. Contributors
2. Software Used

List of Tables

9.1. Configurable Analysis Properties
12.1. Options for computeBugHistory command
12.2. Options for filterBugs command
12.3. Options for mineBugHistory command
12.4. Columns in mineBugHistory output
12.5. Columns in defectDensity output
12.6. Options for convertXmlToText command
12.7. setBugDatabaseInfo Options
12.8. listBugDatabaseInfo Columns
   Next
   Chapter 1. Introduction
\ No newline at end of file diff --git a/manual/infiniteRecursiveLoops.png b/manual/infiniteRecursiveLoops.png deleted file mode 100644 index 5430df294b109f9400d7e09c6aa7b0715c4df61f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 24467 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 yI|g1;_B$_~WjO_syhG@JFxm3| - - Chapter 2. Installing FindBugs™
Chapter 2. Installing FindBugs™
Prev   Next

Chapter 2. Installing FindBugs™

Table of Contents

1. Extracting the Distribution

-This chapter explains how to install FindBugs. -

1. Extracting the Distribution

-The easiest way to install FindBugs is to download a binary distribution. -Binary distributions are available in -gzipped tar format and -zip format. -Once you have downloaded a binary distribution, extract it into a directory of your choice. -

-Extracting a gzipped tar format distribution: -

-$ gunzip -c findbugs-3.1.0-dev-20161105-d07b50f.tar.gz | tar xvf -
-

-

-Extracting a zip format distribution: -

-C:\Software>unzip findbugs-3.1.0-dev-20161105-d07b50f.zip
-

-

-Usually, extracting a binary distribution will create a directory ending in -findbugs-3.1.0-dev-20161105-d07b50f. For example, if you extracted -the binary distribution from the C:\Software -directory, then the FindBugs software will be extracted into the directory -C:\Software\findbugs-3.1.0-dev-20161105-d07b50f. -This directory is the FindBugs home directory. We'll refer to it as -$FINDBUGS_HOME (or %FINDBUGS_HOME% for Windows) throughout this manual. -

Prev   Next
Chapter 1. Introduction Home Chapter 3. Building FindBugs™ from Source
\ No newline at end of file diff --git a/manual/introduction.html b/manual/introduction.html deleted file mode 100644 index aefa4fc..0000000 --- a/manual/introduction.html +++ /dev/null @@ -1,21 +0,0 @@ - - - Chapter 1. Introduction
Chapter 1. Introduction
Prev   Next

Chapter 1. Introduction

Table of Contents

1. Requirements

FindBugs™ is a program to find bugs in Java programs. It looks for instances -of "bug patterns" --- code instances that are likely to be errors.

This document describes version 3.1.0-dev-20161105-d07b50f of FindBugs.We -are very interested in getting your feedback on FindBugs. Please visit -the FindBugs web page for -the latest information on FindBugs, contact information, and support resources such -as information about the FindBugs mailing lists.

1. Requirements

To use FindBugs, you need a runtime environment compatible with -Java 2 Standard Edition, version 1.5 or later. -FindBugs is platform independent, and is known to run on GNU/Linux, Windows, and -MacOS X platforms.

You should have at least 512 MB of memory to use FindBugs. -To analyze very large projects, more memory may be needed.

Prev   Next
FindBugs™ Manual Home Chapter 2. Installing FindBugs™
\ No newline at end of file diff --git a/manual/license.html b/manual/license.html deleted file mode 100644 index e8f5d4e..0000000 --- a/manual/license.html +++ /dev/null @@ -1,22 +0,0 @@ - - - Chapter 13. License
Chapter 13. License
Prev   Next

Chapter 13. License

-The name FindBugs and the FindBugs logo is trademarked by the University -of Maryland. -FindBugs is free software distributed under the terms of the -Lesser GNU Public License. -You should have received a copy of the license in the file LICENSE.txt -in the FindBugs distribution. -

-You can find the latest version of FindBugs, along with its source code, from the -FindBugs web page. -

Prev   Next
Chapter 12. Data mining of bugs with FindBugs™ Home Chapter 14. Acknowledgments
\ No newline at end of file diff --git a/manual/note.png b/manual/note.png deleted file mode 100644 index d0c3c645ab9af6318035b026dd86944b9ddc9114..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 490 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 - - Chapter 11. Using rejarForAnalysis
Chapter 11. Using rejarForAnalysis
Prev   Next

Chapter 11. Using rejarForAnalysis

-If your project consists of many jarfiles or the jarfiles are scattered -over many directories, you may wish to use the rejarForAnalysis - script to make -FindBugs invocation easier. The script collects many jarfiles and combines them -into a single, large jarfile that can then be easily passed to FindBugs for -analysis. This can be particularly useful in combination with the 'find' command -on unix systems; e.g. find . -name '*.jar' | xargs rejarForAnalysis -. -

-The rejarForAnalysis script -can also be used to split a very large project up into a set of jarfiles with -the project classfiles evenly divided between them. This is useful when running -FindBugs on the entire project is not practical due to time or memory consumption. -Instead of running FindBugs on the entire project, you may use -rejarForAnalysis build one large, all-inclusive jarfile -containing all classes, invoke rejarForAnalysis -again to split the project into multiple jarfiles, then run FindBugs -on each divided jarfiles in turn, specifying the the all-inclusive jarfile in -the -auxclasspath. -

-These are the options accepted by the rejarForAnalysis script: -

-maxAge days

- Maximum age in days (ignore jar files older than this). -

-inputFileList filename

- Text file containing names of jar files. -

-maxClasses num

- Maximum number of classes per analysis*.jar file. -

-prefix class name prefix

- Prefix of class names that should be analyzed (e.g., edu.umd.cs.). -

Prev   Next
Chapter 10. Annotations Home Chapter 12. Data mining of bugs with FindBugs™
\ No newline at end of file diff --git a/manual/running.html b/manual/running.html deleted file mode 100644 index 74b4b54..0000000 --- a/manual/running.html +++ /dev/null @@ -1,227 +0,0 @@ - - - Chapter 4. Running FindBugs™
Chapter 4. Running FindBugs™
Prev   Next

Chapter 4. Running FindBugs™

Table of Contents

1. Quick Start
2. Executing FindBugs
3. Command-line Options

-FindBugs has two user interfaces: a graphical user interface (GUI) and a -command line user interface. This chapter describes -how to run each of these user interfaces. -

[Warning]Warning

- This chapter is in the process of being re-written. - The rewrite is not complete yet. -

1. Quick Start

- If you are running FindBugs on a Windows system, - double-click on the file %FINDBUGS_HOME%\lib\findbugs.jar to start the FindBugs GUI. -

- On a Unix, Linux, or Mac OS X system, run the $FINDBUGS_HOME/bin/findbugs - script, or run the command 

-java -jar $FINDBUGS_HOME/lib/findbugs.jar

- to run the FindBugs GUI. -

- Refer to Chapter 5, Using the FindBugs GUI for information on how to use the GUI. -

2. Executing FindBugs

- This section describes how to invoke the FindBugs program. - There are two ways to invoke FindBugs: directly, or using a - wrapper script. -

2.1. Direct invocation of FindBugs

- The preferred method of running FindBugs is to directly execute - $FINDBUGS_HOME/lib/findbugs.jar using the -jar - command line switch of the JVM (java) executable. - (Versions of FindBugs prior to 1.3.5 required a wrapper script - to invoke FindBugs.) -

- The general syntax of invoking FindBugs directly is the following: -

-    java [JVM arguments] -jar $FINDBUGS_HOME/lib/findbugs.jar options...
-

-

2.1.1. Choosing the User Interface

- The first command line option chooses the FindBugs user interface to execute. - Possible values are: -

  • - -gui: runs the graphical user interface (GUI) -

  • - -textui: runs the command line user interface -

  • - -version: displays the FindBugs version number -

  • - -help: displays help information for the - FindBugs command line user interface -

  • - -gui1: executes the original (obsolete) - FindBugs graphical user interface -

2.1.2. Java Virtual Machine (JVM) arguments

- Several Java Virtual Machine arguments are useful when invoking - FindBugs. -

-XmxNNm

- Set the maximum Java heap size to NN - megabytes. FindBugs generally requires a large amount of - memory. For a very large project, using 1500 megabytes - is not unusual. -

-Dname=value

- Set a Java system property. For example, you might use the - argument -Duser.language=ja to display - GUI messages in Japanese. -

2.2. Invocation of FindBugs using a wrapper script

- Another way to run FindBugs is to use a wrapper script. -

-On Unix-like systems, use the following command to invoke the wrapper script: -

-$ $FINDBUGS_HOME/bin/findbugs options...
-

-

-On Windows systems, the command to invoke the wrapper script is -

-C:\My Directory>%FINDBUGS_HOME%\bin\findbugs.bat options...
-

-

-On both Unix-like and Windows systems, you can simply add the $FINDBUGS_HOME/bin -directory to your PATH environment variable and then invoke -FindBugs using the findbugs command. -

2.2.1. Wrapper script command line options

The FindBugs wrapper scripts support the following command-line options. - Note that these command line options are not handled by - the FindBugs program per se; rather, they are handled by the wrapper - script. -

-jvmArgs args

- Specifies arguments to pass to the JVM. For example, you might want - to set a JVM property: -

-$ findbugs -textui -jvmArgs "-Duser.language=ja" myApp.jar
-

-

-javahome directory

- Specifies the directory containing the JRE (Java Runtime Environment) to - use to execute FindBugs. -

-maxHeap size

- Specifies the maximum Java heap size in megabytes. The default is 256. - More memory may be required to analyze very large programs or libraries. -

-debug

- Prints a trace of detectors run and classes analyzed to standard output. - Useful for troubleshooting unexpected analysis failures. -

-property name=value

- This option sets a system property.  FindBugs uses system properties - to configure analysis options. See Chapter 9, Analysis Properties. - You can use this option multiple times in order to set multiple properties. - Note: In most versions of Windows, the name=value - string must be in quotes. -

3. Command-line Options

- This section describes the command line options supported by FindBugs. - These command line options may be used when invoking FindBugs directly, - or when using a wrapper script. -

3.1. Common command-line options

-These options may be used with both the GUI and command-line interfaces. -

-effort:min

- This option disables analyses that increase precision but also - increase memory consumption. You may want to try this option if - you find that FindBugs runs out of memory, or takes an unusually - long time to complete its analysis. -

-effort:max

- Enable analyses which increase precision and find more bugs, but which - may require more memory and take more time to complete. -

-project project

- Specify a project to be analyzed. The project file you specify should - be one that was created using the GUI interface. It will typically end - in the extension .fb or .fbp. -

3.2. GUI Options

-These options are only accepted by the Graphical User Interface. - -

-look:plastic|gtk|native

- Set Swing look and feel. -

-

3.3. Text UI Options

-These options are only accepted by the Text User Interface. -

-sortByClass

- Sort reported bug instances by class name. -

-include filterFile.xml

- Only report bug instances that match the filter specified by filterFile.xml. - See Chapter 8, Filter Files. -

-exclude filterFile.xml

- Report all bug instances except those matching the filter specified by filterFile.xml. - See Chapter 8, Filter Files. -

-onlyAnalyze com.foobar.MyClass,com.foobar.mypkg.*

- Restrict analysis to find bugs to given comma-separated list of - classes and packages. - Unlike filtering, this option avoids running analysis on - classes and packages that are not explicitly matched: - for large projects, this may greatly reduce the amount of time - needed to run the analysis. (However, some detectors may produce - inaccurate results if they aren't run on the entire application.) - Classes should be specified using their full classnames (including - package), and packages should be specified in the same way - they would in a Java import statement to - import all classes in the package (i.e., add .* - to the full name of the package). - Replace .* with .- to also - analyze all subpackages. -

-low

- Report all bugs. -

-medium

- Report medium and high priority bugs. This is the default setting. -

-high

- Report only high priority bugs. -

-relaxed

- Relaxed reporting mode. For many detectors, this option - suppresses the heuristics used to avoid reporting false positives. -

-xml

- Produce the bug reports as XML. The XML data produced may be - viewed in the GUI at a later time. You may also specify this - option as -xml:withMessages; when this variant - of the option is used, the XML output will contain human-readable - messages describing the warnings contained in the file. - XML files generated this way are easy to transform into reports. -

-html

- Generate HTML output. By default, FindBugs will use the default.xsl - XSLT - stylesheet to generate the HTML: you can find this file in findbugs.jar, - or in the FindBugs source or binary distributions. Variants of this option include - -html:plain.xsl, -html:fancy.xsl and -html:fancy-hist.xsl. - The plain.xsl stylesheet does not use Javascript or DOM, - and may work better with older web browsers, or for printing. The fancy.xsl - stylesheet uses DOM and Javascript for navigation and CSS for - visual presentation. The fancy-hist.xsl an evolution of fancy.xsl stylesheet. - It makes an extensive use of DOM and Javascript for dynamically filtering the lists of bugs. -

- If you want to specify your own - XSLT stylesheet to perform the transformation to HTML, specify the option as - -html:myStylesheet.xsl, - where myStylesheet.xsl is the filename of the - stylesheet you want to use. -

-emacs

- Produce the bug reports in Emacs format. -

-xdocs

- Produce the bug reports in xdoc XML format for use with Apache Maven. -

-output filename

- Produce the output in the specified file. -

-outputFile filename

- This argument is deprecated. Use -output instead. -

-nested[:true|false]

- This option enables or disables scanning of nested jar and zip files found in - the list of files and directories to be analyzed. - By default, scanning of nested jar/zip files is enabled. - To disable it, add -nested:false to the command line - arguments. -

-auxclasspath classpath

- Set the auxiliary classpath for analysis. This classpath should include all - jar files and directories containing classes that are part of the program - being analyzed but you do not want to have analyzed for bugs. -

-auxclasspathFromInput

- Read the auxiliary classpath for analysis from standard input, each line adds new - entry to the auxiliary classpath for analysis. -

-auxclasspathFromFile filepath

- Read the auxiliary classpath for analysis from file, each line adds new - entry to the auxiliary classpath for analysis. -

-analyzeFromFile filepath

- Read the files to analyze from file, each line adds new - entry to the classpath for analysis. -

-userPrefs edu.umd.cs.findbugs.core.prefs

- Set the path of the user preferences file to use, which might override some of the options abobe. - Specifying userPrefs as first argument would mean some later - options will override them, as last argument would mean they will override some previous options). - This rationale behind this option is to reuse FindBugs Eclipse project settings for command - line execution. -

Prev   Next
Chapter 3. Building FindBugs™ from Source Home Chapter 5. Using the FindBugs GUI
\ No newline at end of file diff --git a/manual/warning.png b/manual/warning.png deleted file mode 100644 index 1c33db8f34a8b42b373179b46a2d8d8a10e061a9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1241 zcmeHH+e?!H6#vDtmgHCxG{Q}12(7`~)|MMe^RnTlY0JD#q1sIwW1DTCqzzwWg@Q=t zBC2Iceu@w4LHM97Gb5%*E%9MN*%m}jvs!{N@Pd8$H}vS?TsRzlzr#5kPPe|YG%fXL zDu6VdR$WC$&Oc)^X#ZjK-7LU>{!F!o39xr+d_Vw5fMTEwpb-s#9q<5Nzz6gIepyU?Lctpr{ZK zVzWaWPAC)#17S8h%;AIuf(Q_yeIybEqS0s^i1YdJcsv0ln9M{Xkpz;-I_^=P))~D~!!Hvpq{Dl8O{rN@cECkt>#DncX%I(O&3i_YgL-$m$VU zT3cLBLS%M1`o{TBX}S|Tbhc)vk!Yp)%rdDd&my(RPsxl%lU$)tC?(1~WuEwClUQn! n$Q8O{Mxt@ukkcT{K0> diff --git a/manual_ja.xml b/manual_ja.xml deleted file mode 100644 index 5559d37..0000000 --- a/manual_ja.xml +++ /dev/null @@ -1,3087 +0,0 @@ - -FindBugs"> -Ant"> -Saxon"> -$FINDBUGS_HOME"> -%FINDBUGS_HOME%"> - -]> - - - -&FindBugs;™ マニュアル - - - - David - H. - Hovemeyer - - - William - W. - Pugh - - - - - 2003 - 2012 - University of Maryland - - - -このマニュアルは、クリエイティブ・コモンズ表示-非営利-継承に基づく使用許諾がなされています。使用許諾書をご覧になる場合は、 http://creativecommons.org/licenses/by-nc-sa/1.0/ にアクセスするか、クリエイティブ・コモンズ(559 Nathan Abbott Way, Stanford, California 94305, USA)に書簡を送付してください。 -名称「FindBugs」および FindBugs のロゴは、メリーランド大学の登録商標です。 - - -3.1.0-dev-20161105-d07b50f - -20:59:21 ART, 05 November, 2016 (翻訳 2014年7月) - - - - - - -はじめに - -&FindBugs;™ は、Java プログラムの中のバグを見つけるプログラムです。このプログラムは、「バグ パターン」の実例を探します。「バグ パターン」とは、エラーとなる可能性の高いコードの事例です。 - -この文書は、&FindBugs; バージョン 3.1.0-dev-20161105-d07b50f について説明してます。私たちは、 &FindBugs; に対するフィードバックを心待ちにしています。どうぞ、 &FindBugs; Web ページ にアクセスしてください。&FindBugs; についての最新情報、連絡先および &FindBugs; メーリングリストなどのサポート情報を入手することができます。 - - -必要条件 -&FindBugs; を使用するには、 Java 2 Standard Edition, バージョン 1.5 以降のバージョンと互換性のあるランタイム環境が必要です。&FindBugs; は、プラットフォーム非依存であり、 GNU/Linux 、 Windows 、 MacOS X プラットフォーム上で動作することが知られています。 - -&FindBugs; を使用するためには、少なくとも 512 MB のメモリが必要です。巨大なプロジェクトを解析するためには、それより多くのメモリが必要とされることがあります。 - - - - - - - -&FindBugs;™ のインストール - -この章では、 &FindBugs; のインストール方法を説明します。 - - -配布物の展開 - -&FindBugs; をインストールする最も簡単な方法は、バイナリ配布物をダウンロードすることです。 バイナリ配布物は、 gzipped tar 形式 および zip 形式 がそれぞれ入手可能です。バイナリ配布物をダウンロードしてきたら、それを任意のディレクトリーに展開します。 - -gzipped tar 形式配布物の展開方法例: -$ gunzip -c findbugs-3.1.0-dev-20161105-d07b50f.tar.gz | tar xvf - - - - -zip 形式配布物の展開方法例: -C:\Software>unzip findbugs-3.1.0-dev-20161105-d07b50f.zip - - - -バイナリ配布物の展開すると、通常は findbugs-3.1.0-dev-20161105-d07b50f ディレクトリーが作成されます。例えば、ディレクトリー C:\Software でバイナリ配布物を展開すると、ディレクトリー C:\Software\findbugs-3.1.0-dev-20161105-d07b50f に &FindBugs; は展開されます。このディレクトリーが &FindBugs; のホームディレクトリーになります。このマニュアルでは、このホームディレクトリーを &FBHome; (Windowsでは &FBHomeWin;) を用いて参照します。 - - - - - - - -&FindBugs;™ のソールからのビルド - -この章では、 &FindBugs; をソースコードからビルドする方法を説明します。&FindBugs; を修正することに興味がないのであれば、 次の章 に進んでください。 - - -前提条件 - -ソースから &FindBugs; をコンパイルするためには、以下のものが必要です。 - - &FindBugs; のソース配布物 - - - - - JDK 1.5.0 またはそれ以降 - - - - - Apache &Ant;, バージョン 1.6.3 またはそれ以降 - - - - - - Redhat Linux システムの /usr/bin/ant に同梱されている &Ant; のバージョンでは、 &FindBugs; のコンパイルはうまくできません。&Ant; web サイトからバイナリ配布物をダウンロードしてインストールすることを推奨します。&Ant; を実行する場合は、 環境変数 JAVA_HOME が JDK 1.5 (またはそれ以降)をインストールしたディレクトリーを指していることを確認してください。 - - -体裁の整った &FindBugs; のドキュメントを生成したい場合は、以下のソフトウェアも必要となります: - - DocBook XSL スタイルシート。&FindBugs; のマニュアルを HTML に変換するのに必要です。 - - - &Saxon; XSLT プロセッサー。(同様に、 &FindBugs; のマニュアルを HTML に変換するのに必要です。) - - - - - - - - -ソース配布物の展開 -ソース配布物をダウンロードした後に、それを作業用ディレクトリーに展開する必要があります。通常は、次のようなコマンドで展開を行います: -$ unzip findbugs-3.1.0-dev-20161105-d07b50f-source.zip - - - - - - -<filename>local.properties</filename> の修正 -FindBugs のドキュメントをビルドするためには、 local.properties ファイルを修正する必要があります。このファイルは、 &FindBugs; をビルドする際に &Ant; build.xml ファイルが参照します。FindBugs のドキュメントをビルドしない場合は、このファイルは無視してもかまいません。 - -local.properties での定義は、 build.properties ファイルでの定義に優先します。build.properties は次のような内容です: - - - - -xsl.stylesheet.home プロパティーには、DocBook Modular XSL スタイルシートがインストールしてあるディレクトリーの絶対パスを指定します。&FindBugs; ドキュメントを生成しようと考えている場合にのみ、このプロパティーを指定する必要があります。 - -saxon.home プロパティーには、&Saxon; XSLT プロセッサーがインストールしてあるディレクトリーの絶対パスを指定します。&FindBugs; ドキュメントを生成しようと考えている場合にのみ、このプロパティーを指定する必要があります。 - - - - -&Ant; の実行 - -ソース配布物の展開、 &Ant; のインストール、build.properties(local.properties) の修正 (これは任意) およびツール (&Saxon; など)の環境構築ができれば、 &FindBugs; をビルドするための準備は完了です。&Ant; の起動する方法は、単にコマンドを実行するだけです。 -$ ant target -target には以下のいずれかを指定します: build - - このターゲットは、 &FindBugs; のコードをコンパイルします。これは、デフォルトのターゲットです。 - - - - - docs - - このターゲットは、ドキュメントの整形を行います(また、副作用としていくつかのソースのコンパイルも行います。) - - - - - runjunit - - このターゲットは、コンパイルを行い &FindBugs; が持っている JUnit テストを実行します。ユニットテストが失敗した場合は、エラーメッセージが表示されます。 - - - - - bindist - - &FindBugs; のバイナリ配布物を構築します。このターゲットは、 .zip および .tar.gz のアーカイブをそれぞれ作成します。 - - - - - -&Ant; コマンドの実行後、次のような出力が表示されるはずです。 (この前に &Ant; が実行したタスクに関するメッセージもいくらか出力されます。): - -BUILD SUCCESSFUL -Total time: 17 seconds - - - - - - - -ソースディレクトリーからの &FindBugs;™ の実行 -build ターゲットの実行が終了すると、バイナリ配布物と同様の状態が作業ディレクトリーに構築されるように &FindBugs; の&Ant; ビルドスクリプトは記述されています。したがって、 の &FindBugs; の実行に関する情報はソース配布物の場合にも応用できます。 - - - - - - - - -&FindBugs;™ の実行 - -&FindBugs; には2つのユーザーインタフェースがあります。すなわち、グラフィカルユーザーインタフェース (GUI) および コマンドラインインタフェースです。この章では、それぞれのインタフェースの実行方法について説明します。 - - - この章は、現在書き直し中です。書き直しはまだ完了していません。 - - - - - - クイック・スタート - Windows システムで &FindBugs; を起動する場合は、 &FBHomeWin;\lib\findbugs.jar ファイルをダブルクリックしてください。 &FindBugs; GUI が起動します。 - - Unix 、 Linux または Mac OS X システムの場合は、&FBHome;/bin/findbugs スクリプトを実行するか、以下のコマンドを実行します。 -java -jar &FBHome;/lib/findbugs.jarこれで、 &FindBugs; GUI が起動します。 - - GUI の使用方法については、 を参照してください。 - - - - - &FindBugs; の起動 - - このセクションでは、 &FindBugs; の起動方法を説明します。&FindBugs; を起動するには2つの方法があります。すなわち、直接起動する方法、および、ラップしているスクリプトを使用する方法です。 - - - - &FindBugs; の直接起動 - - 最初に述べる &FindBugs; の起動方法は、 &FBHome;/lib/findbugs.jar を直接実行する方法です。JVM (java) 実行プログラムの -jar コマンドラインスイッチを使用します。(&FindBugs;のバージョンが 1.3.5 より前の場合は、ラップしているスクリプトを使用する必要があります。) - - &FindBugs; を直接起動するための、一般的な構文は以下のようになります。 - java [JVM 引数] -jar &FBHome;/lib/findbugs.jar オプション… - - - - - - - ユーザーインタフェースの選択 - - 1 番目のコマンドラインオプションは、起動する &FindBugs; ユーザーインタフェースを選択するためのものです。指定可能な値は次の通りです: - - - - -gui: グラフィカルユーザーインタフェース (GUI) を起動します。 - - - - - -textui: コマンドラインインタフェースを起動します。 - - - - - -version: &FindBugs; のバージョン番号を表示します。 - - - - - -help: &FindBugs; コマンドラインインタフェースのヘルプ情報を表示します。 - - - - - -gui1: 最初に作成された &FindBugs; グラフィカルユーザーインタフェース(すでに廃止されサポートされていない)を起動します。 - - - - - - - Java 仮想マシン (JVM) 引数 - - &FindBugs; を起動する際に有用な Java 仮想マシン 引数をいくつか紹介します。 - - - - -XmxNNm - - Java ヒープサイズの最大値を NN メガバイトに設定します。&FindBugs; は一般的に大容量のメモリサイズを必要とします。大きなプロジェクトでは、 1500 メガバイトを使用することも珍しくありません。 - - - - - -Dname=value - - Java システムプロパティーを設定します。例えば、引数 -Duser.language=ja を使用すると GUI 文言が日本語で表示されます。 - - - - - - - - - - - ラップしているスクリプトを使用した &FindBugs; の起動 - - &FindBugs; を起動するもうひとつの方法は、ラップしているスクリプトを使用する方法です。 - -Unix 系のシステムにおいては、次のようなコマンドでラップしているスクリプトを起動します : -$ &FBHome;/bin/findbugs オプション… - - - -Windows システムにおいては、ラップしているスクリプトを起動するコマンドは次のようになります。 -C:\My Directory>&FBHomeWin;\bin\findbugs.bat オプション… - - - -Unix 系システム および Windows システムのどちらにおいても、ディレクトリー $FINDBUGS_HOME/bin を環境変数 PATH に追加するだけで、 findbugs コマンドを使用して FindBugs を起動することができます。 - - - ラップしているスクリプトのコマンドラインオプション - &FindBugs; のラップしているスクリプトは、次のようなコマンドラインオプションをサポートしています。これらのコマンドラインオプションは &FindBugs; プログラム 自体が操作するのではなく、どちらかといえば、ラップしているスクリプトの方が処理を行います。 - - - -jvmArgs 引数 - - JVM に受け渡される引数を指定します。例えば、次のような JVM プロパティが設定できます: -$ findbugs -textui -jvmArgs "-Duser.language=ja" myApp.jar - - - - - - - -javahome ディレクトリー - - &FindBugs; の実行に使用する JRE (Java ランタイム環境) がインストールされているディレクトリーを指定します。 - - - - - -maxHeap サイズ - - Java ヒープサイズの最大値をメガバイト単位で指定します。デフォルトは、 256 です。巨大なプログラムやライブラリを分析するには、もっと大きなメモリー容量が必要になる可能性があります。 - - - - - -debug - - ディテクタ実行およびクラス分析のトレース情報が標準出力に出力されます。分析が予期せず失敗した際の、トラブルシューティングに有用です。 - - - - - -property name=value - - このオプションを使用してシステムプロパティーを設定することができます。 &FindBugs; はシステムプロパティーを使用して分析特性の設定を行います。 を参照してください。このオプションを複数指定して、複数のシステムプロパティを設定することが可能です。注: Windows の多くのバージョンでは、 name=value 文字列を引用符で囲む必要があります。 - - - - - - - - - - - - -コマンドラインオプション - - - -このセクションでは、 &FindBugs; がサポートするコマンドラインオプションについて説明します。ここで示すコマンドラインオプションは、 &FindBugs; 直接起動、または、ラップしているスクリプトによる起動で使用できます。 - - -共通のコマンドラインオプション - -ここで示すオプションは、 GUI および コマンドラインインタフェースの両方で使用できます。 - - - - - -effort:min - - このオプションを指定すると、精度を上げるために大量のメモリーを消費する分析が無効になります。&FindBugs; の実行時にメモリー不足になったり、分析を完了するまでに異常に長い時間がかかる場合に試してみてください。 - - - - - - -effort:max - - 精度が高く、より多くのバグを検出する分析を有効にします。ただし、多くのメモリー容量を必要とし、また、完了までの時間が多くかかる可能性があります。 - - - - - -project project - - 分析するプロジェクトを指定します。指定するプロジェクトファイルには、 GUI を使って作成したものを使用してください。ファイルの拡張子は、一般的には .fb または .fbp です。 - - - - - - - - - - -GUI オプション - -ここで示すオプションは、グラフィカルユーザーインタフェースでのみ使用できます。 -look:plastic|gtk|native - - Swing のルック・アンド・フィールを設定します。 - - - - - - - - -テキストユーザーインタフェースオプション - -ここで示すオプションは、テキストユーザーインタフェースでのみ使用できます。 - - - - -sortByClass - - 報告されるバグ検索結果をクラス名でソートします。 - - - - - -include filterFile.xml - - filterFile.xml で指定したフィルターに一致したバグ検索結果のみ報告されます。 を参照してください。 - - - - - -exclude filterFile.xml - - filterFile.xml で指定したフィルターに一致したバグ検索結果は報告されません。 を参照してください。 - - - - - -onlyAnalyze com.foobar.MyClass,com.foobar.mypkg.* - - コンマ区切りで指定したクラスおよびパッケージのみに限定して、バグ検出の分析を行うようにします。フィルターと違って、このオプションを使うと一致しないクラスおよびパッケージに対する分析の実行を回避することができます。大きなプロジェクトにおいて、このオプションを活用すると分析にかかる時間を大きく削減することができる可能性があります。(しかしながら、アプリケーションの全体で実行していないために不正確な結果を出してしまうディテクタがある可能性もあります。) クラスはパッケージも含んだ完全な名前を指定する必要があります。また、パッケージは、 Java の import 文でパッケージ下のすべてのクラスをインポートするときと同じ方法で指定します。 (すなわち、パッケージの完全な名前に .* を付け加えた形です。).* の代わりに .- を指定すると、サブパッケージも含めてすべてが分析されます。 - - - - - -low - - すべてのバグが報告されます。 - - - - - -medium - - 優先度 (中) および優先度 (高) のバグが報告されます。これは、デフォルトの設定値です。 - - - - - -high - - 優先度 (高) のバグのみが報告されます。 - - - - - -relaxed - - 手抜き報告モードです。このオプションを指定すると、多くのディテクタにおいて 誤検出を回避するためのヒューリスティック機能が抑止されます。 - - - - - -xml - - バグ報告が XML で作成されます。作成された XML データは 、後で GUI で見ることができます。このオプションは -xml:withMessages と指定することもできます。こうすると 出力 XML には 各バグに関して人間に読むことができるメッセージが含まれるようになります。このオプションで作成された XML ファイルは 報告書に変換するのが簡単です。 - - - - - -html - - HTML 出力が生成されます。デフォルトでは &FindBugs; は default.xsl XSLT スタイルシートを使用して HTML 出力を生成します: このファイルは、 findbugs.jar の中、または、 &FindBugs; のソース配布物もしくはバイナリ配布物の中にあります。このオプションには、次のようなバリエーションも存在します。すなわち、 -html:plain.xsl 、 -html:fancy.xsl および -html:fancy-hist.xsl です。plain.xsl スタイルシートは Javascript や DOM を利用しません。したがって、古いWeb ブラウザ使用時や印刷時にも比較的うまく表示されるでしょう。fancy.xsl スタイルシートは DOM と Javascript を利用してナビゲーションを行います。また、ビジュアル表示に CSS を使用します。fancy-hist.xsl は fancy.xsl スタイルシートを更に進化させたものです。DOM や Javascript をふんだんに駆使して、バグの一覧を動的にフィルタリングします。 - - ユーザー自身の XSLT スタイルシートを用いて HTML への変換を行いたい場合は、 -html:myStylesheet.xsl のように指定してください。ここで、 myStylesheet.xsl はユーザーが使用したいスタイルシートのファイル名です。 - - - - - -emacs - - バグ報告が Emacs 形式で作成されます。 - - - - - -xdocs - - バグ報告が xdoc XML 形式で作成されます。Apache Mavenで使用できます。 - - - - - -output ファイル名 - - 指定したファイルに出力結果が作成されます。 - - - - - -outputFile ファイル名 - - この引数は、使用すべきではありません。代わりに、 -output を使用してください。 - - - - - -nested[:true|false] - - このオプションは、ファイルやディレクトリーの中で入れ子になった jar および zip ファイルを分析するかどうかを指定します。デフォルトでは、入れ子になった jar および zip ファイルも分析します。入れ子になった jar および zip ファイルの分析するを無効にする場合は、 -nested:false をコマンドライン引数に追加してください。 - - - - - -auxclasspath クラスパス - - 分析時に使用する補助クラスパスを設定します。分析するプログラムで使用するjarファイルやクラスディレクトリーをすべて指定してください。補助クラスパスに指定したクラスは分析の対象にはなりません。 - - - - - -auxclasspathFromInput - - 分析時に使用する補助クラスパスを標準入力から読み込みます。標準入力の各行が分析時に使用する補助クラスパスに追加されます。 - - - - - -auxclasspathFromFile ファイルパス - - 分析時に使用する補助クラスパスをファイルから読み込みます。ファイルの各行が分析時に使用する補助クラスパスに追加されます。 - - - - - -analyzeFromFile ファイルパス - - 分析対象ファイルをファイルから読み込みます。ファイルの各行が分析対象クラスパスに追加されます。 - - - - - -userPrefs edu.umd.cs.findbugs.core.prefs - - ユーザー設定ファイルのパスを設定します。ユーザー設定ファイルの内容で、他のオプションの一部を上書きすることができます。 - userPrefs を一番目の引数に指定した場合は、後続のオプションの方がユーザー設定ファイルの内容に優先します。 - userPrefs を最後の引数に指定した場合は、ユーザー設定ファイルの内容の方が前に指定したオプションに優先します。 - このオプションを設けた背景・理由は、 Eclipse プロジェクトの FindBugs の設定をコマンドライン実行で再利用するためです。 - - - - - - - - - - - - - - - &FindBugs; GUI の使用方法 - - この章では、&FindBugs; グラフィカルユーザーインタフェース (GUI) の使用方法を説明します。 - - -プロジェクトの作成 -findbugs コマンドで &FindBugs; を起動してから、メニューで FileNew Project を選択してください。そうすると、次のようなダイアログが表示されます: - - - - - - -「Classpath to analyze」の横にある 「Add」ボタンを押すと、バグを分析する java クラスを含んでいる Java アーカイブファイル (zip, jar, ear, or war file) を選択して指定できます。複数の アーカイブ/ディレクトリーを追加することが可能です。 - -また、分析を行う Java アーカイブのソースコードを含んだソースディレクトリーを指定することもできます。そうすると、バグの可能性があるソースコードの場所が、&FindBugs; 上でハイライトして表示されます。ソースディレクトリーは、Java パッケージ階層のルートディレクトリーを指定する必要があります。例えば、ユーザのアプリケーションが org.foobar.myapp パッケージの中にある場合は、 org ディレクトリーの親ディレクトリーをソースディレクトリーリストに指定する必要があります。 - -もうひとつ、任意指定の手順があります。それは、補助用の Jar ファイルおよびディレクトリーを 「Auxiliary classpath locations」のエントリーに追加することです。分析するアーカイブ/ディレクトリーにも標準の実行時クラスパスにも含まれていないクラスを、分析するアーカイブ/ディレクトリーが参照している場合は、この項目を設定した方がいいでしょう。クラス階層に関する情報を使用するバグディテクタが、 &FindBugs; にはいくつかあります。したがって、&FindBugs; が分析を行うクラスの完全なクラス階層を参照できれば、より正確な分析結果を取得することができます。 - - - - -分析の実行 -アーカイブ、ディレクトリーおよびソースディレクトリーの指定ができれば、「Analyze」ボタンを押して Jar ファイルに含まれるクラスに対する分析を実行します。巨大なプロジェクトを古いコンピュータ上で実行すると、かなりの時間(数十分)がかかることに注意してください。大容量メモリである最近のコンピュータなら、大きなプログラムであっても数分程度で分析できます。 - - - -結果の閲覧 - -分析が完了すると、次のような画面が表示されます : - - - - - - -左上のペインにはバグ階層ツリーが表示されます。これは、分析でみつかったバグの検索結果が階層的に表示されたものです。 - -上部のペインでバグ検索結果を選択すると、下部の「Details」ペインにバグの詳細説明が表示されます。更に、ソースがみつかれば、右上のソースコードペインにバグの出現箇所に該当するソースコードが表示されます。上図の例で表示されているバグは、ストリームオブジェクトがクローズされていないというものです。ソースコード・ウィンドウにおいて当該ストリームオブジェクトを生成している行がハイライトされています。 - -バグの検索結果に対してテキストで注釈を入れることができます。階層ツリー図のすぐ下にあるテキストボックスに注釈を入力してください。記録しておきたい情報を何でも自由に入力することができます。バグ結果ファイルの保存および読み込みを行ったときに、注釈も保存されます。 - - - - -保存と読み込み - -メニュー項目から FileSave as... を選択すると、ユーザーの作業結果を保存することができます。「Save as...」ダイアログにあるドロップダウン・リストの中から「FindBugs analysis results (.xml)」を選択ことで、ユーザーが指定した jar ファイルリストやバグ検索結果などの作業結果を保存することができます。また、jar ファイルリストのみを保存する選択肢 (「FindBugs project file (.fbp)」) やバグ検索結果のみを保存する選択肢 (「FindBugs analysis file (.fba)」) もあります。保存したファイルは、メニュー項目から FileOpen... を選択することで、読み込むことができます。 - - - - - - - - - - -&FindBugs;™ &Ant; タスクの使用方法 - -この章では、 &FindBugs; を &Ant; のビルドスクリプトに組み入れる方法について説明します。 &Ant; は、ビルドや配備を行うことができる Java でよく使用されるツールです。&FindBugs; &Ant; タスクを使用すると、 ビルドスクリプトを作成して機械的に &FindBugs; による Java コードの分析を実行することができます。 - -この &Ant; タスクは、 Mike Fagan 氏の多大な貢献によるものです。 - - -&Ant; タスクのインストール - -&Ant; タスクのインストールは、 &FBHome;/lib/findbugs-ant.jar を &Ant; インストールディレクトリーのlib サブディレクトリーにコピーするだけです。 -使用する &Ant; タスクと &FindBugs; 本体は、同梱されていた同じバージョンのものを使用することを強く推奨します。別のバージョンの &FindBugs; に含まれていた &Ant; タスク Jar ファイルでの動作は保証しません。 - - - - - - -build.xml の書き方 - -&FindBugs; を build.xml (&Ant; ビルドスクリプト) に組み入れるためにはまず、タスク定義を記述する必要があります。タスク定義は次のように記述します。: - <taskdef name="findbugs" classname="edu.umd.cs.findbugs.anttask.FindBugsTask"/> -タスク定義は、 findbugs 要素を build.xml 上に記述したとき、そのタスクの実行に使用されるクラスを指定します。 - -タスク定義の記述をすれば、findbugs タスクを使ってターゲットを定義できます。次に示すのは、 Apache BCEL ライブラリーを分析する場合を想定した build.xml の記述例です。 - <property name="findbugs.home" value="/export/home/daveho/work/findbugs" /> - - <target name="findbugs" depends="jar"> - <findbugs home="${findbugs.home}" - output="xml" - outputFile="bcel-fb.xml" > - <auxClasspath path="${basedir}/lib/Regex.jar" /> - <sourcePath path="${basedir}/src/java" /> - <class location="${basedir}/bin/bcel.jar" /> - </findbugs> - </target> -findbugs 要素には、 home 属性が必須です。 &FindBugs; のインストールディレクトリーすなわち &FBHome; の値を設定します。 を参照してください。 - -このターゲットは bcel.jar に対して &FindBugs; を実行します。この Jar ファイルは、 BCEL ビルドスクリプトによって作成されるものです。(上記のターゲットが「jar」ターゲットに依存している (depends) と設定することにより、 &FindBugs; が実行される前に当該ライブラリーが完全にコンパイルされていることを保証しています。) &FindBugs; の出力は、 XML 形式で bcel-fb.xml ファイルに保存されます。補助 Jar ファイル Regex.jar を aux classpath に記述しています。なぜなら、当該 Jar ファイルが BCEL メイン･ライブラリーから参照されるからです。source path を指定することで、保存されるバグデータに BCEL ソースコードへの正確な参照が記述されます。 - - - -タスクの実行 - -コマンドラインから &Ant; を起動する例を次に示します。前述の findbugs ターゲットを使用しています。 - [daveho@noir]$ ant findbugs - Buildfile: build.xml - - init: - - compile: - - examples: - - jar: - - findbugs: - [findbugs] Running FindBugs... - [findbugs] Bugs were found - [findbugs] Output saved to bcel-fb.xml - - BUILD SUCCESSFUL - Total time: 35 seconds -この事例においては、XML ファイルでバグ検索結果を保存しているので、 &FindBugs; GUI を使って結果を参照することができます。 を参照してください。 - - - - -パラメーター - -このセクションでは、 &FindBugs; タスクを使用する際に、指定することができるパラメーターについて説明します。 - - - - - class - - 任意指定のネストされる要素です。分析の対象となるクラス群を指定します。 - class 要素には location 属性の指定が必須です。 - 分析対象となるアーカイブファイル (jar, zip, 他)、ディレクトリーまたはクラスファイルの名前を記述します。 - 1 つの findbugs 要素に対して、複数の class 子要素を指定することができます。 - - class 要素の指定を置き換えるまたは追加する形で、 &FindBugs; タスクに1個以上の fileset 要素を記述することで - 分析するファイル群を指定することができます。 - 例えば、 fileset において特定のディレクトリにある全ての jar ファイルを分析対象に指定することができます。 - - - - - - auxClasspath - - 任意指定のネストされる要素です。分析対象のライブラリーまたはアプリケーションによって使用されているが分析の対象にはしたくないクラスを含んでいるクラスパス (Jar ファイルまたはディレクトリー) を指定します。 &Ant; の Java タスクにある classpath 要素 と同じ方法で指定することができます。 - - - - - sourcePath - - 任意指定のネストされる要素です。分析対象 Java コードのコンパイル時に使用したソースファイルを含んでいるソースディレクトリーへのパスを指定します。ソースパスを指定することにより、生成される XML のバグ出力結果に完全なソース情報をもたせることができ、後になって GUI で参照することができます。 - - - - - home - - 必須属性です。&FindBugs; がインストールされているディレクトリー名を設定します。 - - - - - quietErrors - - 任意指定のブール値属性です。true を設定すると、深刻な分析エラー発生やクラスがみつからないといった情報が &FindBugs; 出力に記録されません。デフォルトは、 false です。 - - - - - reportLevel - - - 任意指定の属性です。報告される問題の信頼度・優先度のしきい値を指定します。 - 「low」に設定すると、バグ報告が信頼度により除外されることはありません。 - 「medium」 (デフォルト) に設定すると、信頼度(低)の問題が除外されます。 - 「high」に設定すると、信頼度(高) のバグのみが報告されます。 - - - - - - output - - 任意指定の属性です。出力形式を指定します。「xml」 (デフォルト) に設定すると、出力は XML 形式になります。「xml:withMessages」 に設定すると、出力は人間が読めるメッセージ が追加された XML 形式になります。(XSL スタイルシートを使ってレポートを作成することを計画している場合はこの形式を使用してください。) 「html」に設定すると、出力は HTML 形式(デフォルトのスタイルシートは default.xsl) になります。 「text」に設定すると、出力は特別なテキスト形式になります。「emacs」に設定すると、出力は Emacs エラーメッセージ形式になります。「xdocs」に設定すると、出力は Apache Maven で使用できる xdoc XML になります。 - - - - stylesheet - - 任意指定の属性です。output 属性 に html を指定した場合に、 HTML 出力作成に使用されるスタイルシートを指定します。FindBugs 配布物に含まれているスタイルシートは、 default.xsl、 fancy.xsl 、 fancy-hist.xsl 、 plain.xsl および summary.xsl です。デフォルト値は default.xsl です。 - - - - - sort - - 任意指定の属性です。output 属性に「text」を指定した場合に、バグの報告をクラス順にソートするかどうかを sort 属性で指定します。デフォルトは、 true です。 - - - - - outputFile - - 任意指定の属性です。指定した場合、&FindBugs; の出力はその名前のファイルへと保存されます。省略時、出力は &Ant; によって直接表示されます。 - - - - - debug - - 任意指定のブール値属性です。true に設定すると、 &FindBugs; は 診断情報を出力します。どのクラスを分析しているか、どのパグパターンディテクタが実行されているか、という情報が表示されます。デフォルトは、 false です。 - - - - - effort - - 分析の活動レベルを設定します。min 、default または max のいずれかの値を設定してください。分析レベルの設定に関する詳細情報は、 を参照してください。 - - - - - conserveSpace - - effort="min" と同義です。 - - - - - workHard - - effort="max" と同義です。 - - - - - visitors - - 任意指定の属性です。どのバグディテクタを実行するかをコンマ区切りのリストで指定します。バグディテクタはパッケージ指定なしのクラス名で指定します。省略時、デフォルトで無効化されているものを除くすべてのディテクタが実行されます。 - - - - - omitVisitors - - - 任意指定の属性です。 - バグディテクタをコンマ区切りのリストで指定します。 - visitors 属性と似ていますが、こちらは 実行されない ディテクタを指定します。 - - - - - - chooseVisitors - - - 任意指定の属性です。 - 頭に「+」または「-」を付け加えたバグディテクタをコンマ区切りのリストで指定します。 - 「+」を付け加えたバグディテクタは有効に、「-」を付け加えたバグディテクタは無効になります。 - - - - - - excludeFilter - - 任意指定の属性です。フィルターファイル名を指定します。報告から除外されるバグを指定します。 を参照してください。 - - - - - includeFilter - - 任意指定の属性です。フィルターファイル名を指定します。報告されるバグを指定します。 を参照してください。 - - - - - projectFile - - 任意指定の属性です。プロジェクトファイル名を指定します。プロジェクトファイルは、 &FindBugs; GUI で作成します。分析されるクラス、および、補助クラスパス、ソースディレクトリーが記入されてます。プロジェクトファイルを指定した場合は、 class 要素・ auxClasspath 属性および sourcePath 属性を設定する必要はありません。プロジェクトの作成方法は、 を参照してください。 - - - - - jvmargs - - 任意指定の属性です。&FindBugs; を実行している Java 仮想マシンに対して受け渡される引数を指定します。巨大なプログラムを分析する場合に、 JVM が使用するメモリ容量を増やす指定をするためにこの引数を利用する必要があるかもしれません。 - - - - - systemProperty - - 任意指定のネストされる要素です。指定した場合、Java システムプロパティーを定義します。name 属性にはシステムプロパティーの名前を指定します。そして、 value 属性にはシステムプロパティの値を指定します。 - - - - - timeout - - 任意指定の属性です。&FindBugs; を実行している Java プロセス の実行許容時間をミリ秒単位で指定します。時間を超過するとハングアップしていると判断してプロセスが終了されます。デフォルトは、 600,000 ミリ秒 (10 分) です。巨大なプログラムの場合は、 &FindBugs; が分析を完了するまでに 10 分 以上掛かる可能性があることに注意してください。 - - - - - failOnError - - 任意指定のブール値属性です。&FindBugs; の実行中にエラーがあった場合に、ビルドプロセス自体を打ち切って異常終了させるかどうかを指定します。デフォルトは、「false」です。 - - - - - errorProperty - - 任意指定の属性です。&FindBugs; の実行中にエラーが発生した場合に、「true」が設定されるプロパティーの名前を指定します。 - - - - - warningsProperty - - 任意指定の属性です。&FindBugs; が分析したプログラムにバグ報告が 1 件でもある場合に、「true」が設定されるプロパティーの名前を指定します。 - - - - - userPreferencesFile - - - 任意指定の属性です。 - ユーザー設定ファイルのパスを設定します。ユーザー設定ファイルの内容で、他のオプションの一部を上書きすることができます。 - userPreferencesFile を一番目の引数に指定した場合は、後続のオプションの方がユーザー設定ファイルの内容に優先します。 - userPreferencesFile を最後の引数に指定した場合は、ユーザー設定ファイルの内容の方が前に指定したオプションに優先します。 - このオプションを設けた背景・理由は、 Eclipse プロジェクトの FindBugs の設定をコマンドライン実行で再利用するためです。 - - - - - - nested - - - 任意指定の属性です。分析対象のファイル・ディレクトリーリストにあるファイル内にネストされた jar および zip ファイルに対する分析を有効化・無効化します。 - デフォルトでは、ネストされた jar/zip の分析は有効です。 - - - - - - - - - - - - - - - - - - -&FindBugs;™ Eclipse プラグインの使用方法 - - -FindBugs Eclipse プラグインを使用することによって、 &FindBugs; を Eclipse IDE で使用することができるようになります。 -このFindBugs Eclipse プラグインは、 Peter Friese 氏の多大な貢献によるものです。 -Phil Crosby 氏 と Andrey Loskutov 氏は、プラグインの重要な改良に貢献しました。 - - - -必要条件 - -&FindBugs; Eclipse Plugin を使用するためには、 Eclipse 3.3 あるいはそれ以降のバージョン、また、 JRE/JDK 1.5 あるいはそれ以降のバージョンが必要です。 - - - - -インストール - -更新サイトが提供されています。更新サイトを利用して、機械的に FindBugs を Eclipse にインストールできます。また自動的に、最新版のアップデートを照会してインストールすることもできます。内容の異なる 3 つの更新サイトが存在します。 - - FindBugs Eclipse 更新サイト一覧 - http://findbugs.cs.umd.edu/eclipse/ - - - FindBugs の公式リリース物を提供します。 - - - - http://findbugs.cs.umd.edu/eclipse-candidate/ - - - FindBugsの公式リリース物に加えて、公式リリース候補版を提供します。 - - - - http://findbugs.cs.umd.edu/eclipse-daily/ - - - FindBugsの日次ビルド物を提供します。コンパイルができること以上のテストは行われていません。 - - - - -また、次に示すリンクから手動でプラグインをダウンロードすることもできます : http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_3.1.0.20161105.zip?download. 展開して Eclipse の「plugins」サブディレクトリーに入れてください。(そうすると、 <eclipse インストールディレクトリー >/plugins/edu.umd.cs.findbugs.plugin.eclipse_3.1.0.20161105/findbugs.png が &FindBugs; のロゴファイルへのパスになるはずです。) - -プラグインの展開ができたら、 Eclipse を起動して Help About Eclipse Platform Plug-in Details を選択してください。「FindBugs Project」から提供された「FindBugs Plug-in」というプラグインがあることを確認してください。 - - - -プラグインの使用方法 - -実行するには、 Java プロジェクト上で右クリックして「Find Bugs」を選択します。&FindBugs; が実行されて、バグパターンの実例の可能性があると識別されたコード箇所に問題マーカーがつきます。 (ソース画面および Eclipse 問題ビューに表示されます。) - -Java プロジェクトのプロパティーダイアログを開いて「Findbugs」プロパティーページを選択することで、 &FindBugs; の動作をカスタマイズすることができます。選択できる項目には次のようなものがあります : - - - - 「Run FindBugs Automatically」チェックボックスの設定。チェックすると、プロジェクト内の Java クラスが修正されるたびに FindBugs が実行されます。 - - - - 優先度とバグカテゴリーの選択。これらのオプションは、どの警告を表示するかを選択します。例えば、優先度で 「Medium」 を選択すると、優先度 (中) および優先度 (高) の警告のみが表示されます。同様に、「Style」チェックボックスのチェックマークを外すと、Style カテゴリーに属する警告は表示されません。 - - - - ディテクタの選択。表からプロジェクトで有効にしたいディテクタを選択することができます。 - - - - - - -Eclipse プラグインの拡張方法 (2.0.0 以降) - -Eclipse プラグインでは、 独自の &FindBugs; ディテクタを追加することができます。 -(詳しく知りたい方は、 -AddingDetectors.txt -もご覧ください)。 -独自のプラグインを Eclipse に追加するには以下の2通りの方法があります。 - - - - - 既存の標準 &FindBugs; ディテクタパッケージは以下で設定できます。 - - Window - Preferences - Java - FindBugs - Misc. Settings - Custom Detectors - 。 - ここで追加するプラグインライブラリの場所を指定するだけです。 - - - - この方法の利点は、既存のディテクタパッケージは「そのまま」で、サードパーティーディテクタの品質をすばやく検証できることです。 - 欠点としては、この設定は Eclipse ワークスペース毎に適用する必要があり、この設定をチームメンバー間で共有することができないことです。 - - - - - - Eclipse 標準の拡張機構を使って独自のディテクタを追加することができます。 - - - - - findBugsEclipsePlugin/schema/detectorPlugins.exsd の documentation で plugin.xml の更新方法を確認してください。 - 既存の &FindBugs; ディテクタプラグイン を簡単に「拡張」して強力な &FindBugs; Eclipse ディテクタプラグイン にすることができます。 - 通常必要なのは、 META-INF/MANIFEST.MF および plugin.xml を jar に追加してかつ、 MANIFEST.MF がビルド時に上書きされないようにビルドスクリプトを更新するだけです。 - - - - この方法の利点は、 Eclipse インストールを共有しさえすれば、チームメンバー同士で正確に同じディテクタ設定を使用できることです。 - 前提条件は現在使用しているディテクタパッケージを Eclipse プラグインに変換しておくことです。 - これはサードパーティのディテクタパッケージも同様です。 - もうひとつの主な差別化要因は、 FindBugs のデフォルト実行時クラスパス に当該サードパーティライブラリーを追加することが必要なことです(くわしくは - AddingDetectors.txt - をご覧ください)。 - - - - - - - - -トラブルシューティング - - -このセクションでは、プラグインに関する一般的な問題と (判明していれば) それらの問題の解決方法を記述します。 - - - - - - Eclipse において &FindBugs; の分析開始後に OutOfMemory エラーダイアログが 出た場合は、 - JVM の使用メモリを増やしてください。すなわち、 eclipse.ini の末尾に以下の記述を追加してください。 - - -vmargs - -Xmx1000m - - 重要：「-vmargs」で始まる設定引数は eclipse.ini ファイルの末尾に記述する必要があります。 - また、各行には引数を一つだけしか書くことができません！ - - - - - &FindBugs; 問題マーカーが (ソース画面および問題ビューに) 表示されない場合は、問題ビューのフィルター設定を変更してください。 - 詳細情報は http://findbugs.sourceforge.net/FAQ.html#q7 を参照してください。 - - - - - - - - - - - - - - -フィルターファイル - -フィルターファイルを使用することで、特定のクラスやメソッドをバグ報告に含めたりバグ報告から除外したりすることができます。この章では、フィルターファイルの使用方法を説明します。 -計画されている機能 -フィルターは現在、コマンドラインインタフェースでのみサポートされています。最終的には、フィルターのサポートは GUI にも追加される予定です。 - - - - - -フィルターファイルの概要 - -概念的に言えば、フィルターはバグ検索結果をある基準と照合します。フィルターを定義することで、 特別な取り扱いをするバグ検索結果を選択することができます。例えば、あるバグ検索結果をバグ報告に含めたり、バグ報告から除外したりすることができます。 - -フィルターファイルは、 XML 文書です。最上位要素が　FindBugsFilter 要素 であり、その子要素として Match 要素を複数個定義します。それぞれの Match 要素は、生成されたバグ検索結果に適用される述部にあたります。通常、フィルターはバグ検索結果を除外するために使用します。次に、例を示します: -$ findbugs -textui -exclude myExcludeFilter.xml myApp.jar -また一方で、的をしぼった報告を得るためにバグ報告結果を選択するためにフィルターを使用することも考えられます : -$ findbugs -textui -include myIncludeFilter.xml myApp.jar - - - - -Match 要素は子要素を持ちます。それらの子要素は論理積で述部になります。つまり、述部が真であるためには、すべての子要素が真である必要があります。 - - - - -マッチング条件の種類 - - - - <Bug> - この要素は、バグパターンを指定して照合します。pattern 属性には、コンマ区切りでバグパターン類型のリストを指定します。どの警告がどのバグパターン類型にあたるかは、 -xml オプションをつかって出力されたもの (BugInstance 要素の type 属性) を見るか、または、 バグ解説ドキュメントを参照してください。もっと粒度の粗い照合を行いたいときは、 code 属性を使用してください。バグ略称のコンマ区切りのリストで指定できます。さらに粒度の粗い照合を行いたいときは、 category 属性を使用してください。次に示す、バグカテゴリー名のコンマ区切りのリストで指定できます : CORRECTNESS, MT_CORRECTNESS, BAD_PRACTICICE, PERFORMANCE, STYLE.同じ <Bug> 要素に上記の属性を複数指定した場合は、バグパターン名、バグ略称、バグカテゴリーのいずれか1つでも該当すれば、バグパターンは合致すると判定されます。下位互換性を持たせたい場合は、 <Bug> 要素の代わりに <BugPattern> 要素および <BugCode> 要素を使用してください。これらの要素はそれぞれ、 name 属性で値のリストを指定します。これらの要素は、将来サポートされなくなる可能性があります。 - - - - <Confidence> - - - この要素は、特定のバグ信頼度をもつ警告を照合します。 - value 属性には、整数値を指定します。すなわち 1 は信頼度(高) 、また、 2 は信頼度(中) 、 3 は信頼度(低) を示します。 - <Confidence> は 2.0.0 リリースから <Priority> の後継として取って代わりました。 - - - - - - <Priority> - - - <Confidence> と同一です。下位互換性を保つため残されています。 - - - - - - <Rank> - - - この要素は、特定のバグランクをもつ警告を照合します。 - value 属性には、 1 から 20 の整数値を指定します。 - 1 から 4 は最も恐ろしいバグ、 5 から 9 は恐ろしいバグ、 10 から 14 は厄介なバグ, - そして 15 から 20 は不安なバグを示します。 - - - - - - <Package> - - この要素は、 name 属性で指定した特定のパッケージ内にあるクラスに関連した警告を照合します。入れ子のパッケージは含まれません (Java import 文に従っています) 。しかしながら、正規表現を使うと複数パッケージにマッチさせることは簡単にできます。 - - - - - <Class> - - この要素は、特定のクラスに関連した警告を照合します。name 属性を使用して、照合するクラス名をクラス名そのものか、または、正規表現で指定します。 - - 下位互換性を持たせたい場合は、この要素の代わりに Match 要素を使用してください。クラス名そのものの指定は class 属性を、クラス名を正規表現で指定する場合は classregex 属性をそれぞれ使用してください - - もし Match 要素に Class 要素が無かったり、 class / classregex 属性が無かったりした場合は、すべてのクラスに適用されます。その場合、想定外に多くのバグ検索結果が一致してしまうことがあり得ます。その場合は、適当なメソッドやフィールドで絞り込んでください。 - - - - - <Source> - - - この要素は、特定のソースファイルに関連した警告を照合します。 - name 属性を使用して、照合するソースファイル名をソースファイル名そのものか、または、正規表現で指定します。 - - - - - - <Method> - - この要素は、メソッドを指定します。name 属性を使用して、照合するメソッド名をメソッド名そのものか、または、正規表現で指定します。params 属性には、コンマ区切りでメソッド引数の型のリストを指定します。returns 属性にはメソッドの戻り値の型を指定します。params および returns においては、クラス名は完全修飾名である必要があります。(例えば、単に "String" ではなく "java.lang.String" としてください。) params returns のどちらか一方を指定した場合は、もう一方の属性の指定も必須です。なぜならば、メソッドシグニチャーを構築のために必要だからです。name 属性、params 属性 および returns 属性または 3 つの 属性すべて、のどれかを条件とすることできることを意味しています。このように、名前とシグニチャーに基づく様々な種類の条件を規定できます。 - - - - <Field> - - この要素は、フィールドを指定します。name 属性を使用して、照合するフィールド名をフィールド名そのものか、または、正規表現で指定します。また、フィールドのシグニチャーに照らしたフィルタリングをすることができます。 type 属性を使用して、フィールドの型を完全修飾名で指定してください。名前とシグニチャーに基づく条件を規定するために、その2つの属性を両方とも指定することができます。 - - - - <Local> - - この要素は、ローカル変数を指定します。name 属性を使用して、照合するローカル変数名をローカル変数名そのものか、または、正規表現で指定します。ローカル変数とは、メソッド内で定義した変数です。 - - - - <Or> - この要素は、論理和として Match 条項を結合します。すなわち、2つの Method 要素を Or 条項に入れることで、どちらか一方のメソッドでマッチさせることができます。 - - - <And> - - この要素は、論理積として Match 条項を結合します。 - すなわち、 Bug および Confidence 要素を And 条項内に指定することで - 特定の信頼度の特定のバグのみ照合することができます。 - - - - <Not> - - この要素は、内包する子 Match を反転します。 - すなわち、 Bug 要素を Not 条項内に指定することで指定したバグ以外のすべてのバグと照合します。 - - - - - - - -Java 要素名マッチング - - -Class 、 Source 、 Method または Field の name 属性が文字 ~ で始まっている場合は、 -属性値の残りの部分を Java の正規表現として解釈します。 -そうして、当該 Java 要素の名前に対しての照合が行われます。 - - -パターンの照合は要素の名前全体に対して行われることに注意してください。そのため、部分一致照合を行いたい場合はパターン文字列の前後に .* を付加して使用する必要があります。 - -パターンの構文規則に関しては、 java.util.regex.Pattern のドキュメントを参照してください。 - - - -留意事項 - - -Match 条項は、バグ検索結果に実際に含まれている情報にのみ一致します。すべてのバグ検索結果はクラスを持っています。したがって、一般的に言って、バグを除外するためにはクラスを用いて行うとうまくいくことが多いです。 - -バグ検索結果の中には、2個以上のクラスを保持しているものもあります。例えば、 DE (dropped exception : 例外の無視) バグは、 例外の無視が発生したメソッドを持っているクラスと、 無視された例外の型を表すクラスの両方を含んだ形で報告されます。Match 条項とは、 1番目 (主) のクラスのみが照合されます。したがって、例えば、クラス "com.foobar.A" 、 "com.foobar.B" 間での IC (initialization circularity : 初期化時の処理循環) バグ報告を抑止したい場合、以下に示すように 2つの Match 条項を使用します : - <Match> - <Class name="com.foobar.A" /> - <Bug code="IC" /> - </Match> - - <Match> - <Class name="com.foobar.B" /> - <Bug code="IC" /> - </Match> -明示的に両方のクラスで照合することによって、循環しているどちらのクラスがバグ検索結果の 1 番目になっているかに関係なく一致させることができます。(もちろんこの方法は、処理循環が "com.foobar.A" 、 "com.foobar.B" に加えて3番目のクラスも含んでいる場合は図らずも失敗してしまう恐れがあります。) - -多くの種類のバグ報告は、自身が出現したメソッドを報告します。それらのバグ検索結果に対しては、 Method 条項を Match 要素に加えると期待通りの動作をするでしょう。 - - - - -例 - -1. 特定のクラスに対するすべてのバグ報告に一致させます。 - - - -]]> - - - - -2. バグ略称を指定して、特定のクラスに対する特定の検査項目に一致させます。 - - - - -]]> - - - -3. バグ略称を指定して、すべてのクラスに対する特定の検査項目に一致させます。 - - - -]]> - - - -4. バグカテゴリーを指定して、すべてのクラスに対する特定の検査項目に一致させます。 - - - -]]> - - - -5. バグ略称を指定して、特定のクラスの指定されたメソッドに対する特定のバグ種別に一致させます。 - - - - - - - - -]]> - - - -6. 特定のメソッドに対する特定のバグパターンに一致させます。 - - - - - - -]]> - - - -7. 特定のメソッドに対する特定の優先度を付与された特定のバグパターンに一致させます。 - - - - - - - -]]> - - - -8. AspectJ コンパイラーによって引き起こされるマイナーバグに一致させます (AspectJ の開発者でもない限り、それらのバグに関心を持つことはないと考えます)。 - - - - - - - - - -]]> - - - -9. 基盤コードの特定の部分に対するバグに一致させます - - - - - - - - - - - - - - - -]]> - - - -10. 特定のシグニチャーを持つフィールドまたはメソッドのバグに一致させます。 - - - - - - - - - - -]]> - - - - - - 11. Not フィルター演算子を使用してバグに一致させます。 - - - - - - - - - - - - - -]]> - - - - - 12. 完全な除外フィルター。 Groovy ソースファイルから生成された全クラスを除外します。 - - - - - - - - -]]> - - - - - - -完全な例 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -]]> - - - - - - - - - - - -分析プロパティー - -&FindBugs; は分析する場合にいくつかの観点を持っています。そして、観点をカスタマイズして実行することができます。システムプロパティーを使って、それらのオプションを設定します。この章では、分析オプションの設定方法を説明します。 - -分析オプションの主な目的は、 2 つあります。1 番目は、 &FindBugs; に対して分析されるアプリケーションのメソッドの意味を伝えることです。そうすることで &FindBugs; がより正確な結果を出すことができ、誤検出を減らすことができます。2 番目に、分析を行うに当たりその精度を設定できるようにすることです。分析の精度を落とすことで、メモリ使用量と分析時間を減らすことができます。ただし、本当のバグを見逃したり、誤検出の数が増えるという代償があります。 - -コマンドラインオプション -property を使って、分析オプションを設定することができます。次に、例を示します: -$ findbugs -textui -property "cfg.noprune=true" myApp.jar - - - -設定することができる分析オプションの一覧を に示します。 - - -設定可能な分析プロパティー - - - - プロパティー名 - 設定値 - 目的 - - - - - - findbugs.assertionmethods - コンマ区切りの完全修飾メソッド名リスト : 例、 "com.foo.MyClass.checkAssertion" - このプロパティーには、プログラムが正しいことをチェックするために使われるメソッドを指定します。これらのメソッドを指定することで、 チェックメソッドで確認した値に対する null 参照アクセスディテクタの誤検出を回避できます。 - - - findbugs.de.comment - true または false - true に設定すると、 DroppedException (無視された例外) ディテクタは空の catch ブロック にコメントが無いか探します。そして、コメントがみつかった場合には警告が報告されません。 - - - findbugs.maskedfields.locals - true または false - true に設定すると、フィールドを隠蔽しているローカル変数に対して優先度(低)の警告が発行されます。デフォルトは、 false です。 - - - findbugs.nullderef.assumensp - true または false - 使用されません。 (意図 : true に設定すると、null 参照アクセスディテクタはメソッドからの戻り値、または、メソッドに受け渡される引数を null であると仮定します。デフォルトは、 false です。このプロパティーを有効にすると、大量の誤検出が生成されるであろうことに注意してください。) - - - findbugs.refcomp.reportAll - true または false - true に設定すると、 == および != 演算子を使っている疑わしい参照比較がすべて報告されます。 false に設定すると、同様の警告は 1 メソッドにつき 1 つしか発行されません。デフォルトは、 false です。 - - - findbugs.sf.comment - true または false - true に設定すると、 SwitchFallthrough ディテクタはソースコードに「fall」または「nobreak」という単語を含んだコメントを記載していない caseラベル に限り警告を報告します。(この機能が正しく動作するためには、正確なソースパスが必要です。) これにより、意図的ではない switch 文の fallthrough を発見し易くなります。 - - - - -
- - - - - - -アノテーション - -&FindBugs; はいくつかのアノテーションをサポートしています。開発者の意図を明確にすることで、 FindBugs はより的確に警告を発行することができます。アノテーションを使用するためには Java 5 が必要であり、 annotations.jar および jsr305.jar ファイルをコンパイル時のクラスパスに含める必要があります。 - - - - edu.umd.cs.findbugs.annotations.CheckForNull - - - [Target] Field, Method, Parameter - - - - アノテーションをつけた要素は、 null である可能性があります。したがって、当該要素を使用する際は null チェックをするべきです。このアノテーションをメソッドに適用すると、メソッドの戻り値に適用されます。 - - - - - edu.umd.cs.findbugs.annotations.CheckReturnValue - - - [Target] Method, Constructor - - - - - - [Parameter] - - - priority: 警告の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。 - - - - explanation:戻り値をチェックしなけばならない理由をテキストで説明します。デフォルト値 :""。 - - - - - - このアノテーションを使用して、呼出し後に戻り値をチェックすべきメソッドを表すことができます。 - - - - - edu.umd.cs.findbugs.annotations.DefaultAnnotation - - - [Target] Type, Package - - - - - - [Parameter] - - - value:アノテーションクラスのclassオブジェクト。複数のクラスを指定することができます。 - - - - priority:省略時の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。 - - - - - - -クラスまたはパッケージのすべてのメンバーが指定されたアノテーションクラスのデフォルト値でアノテートされることを指定することができます。 -この指定は @NonNull 、 @CheckForNull 、または @CheckReturnValueなどに使用する想定です。 -具体的には、 クラスまたはパッケージに @DefaultAnnotation(NonNull.class) を指定した上で、 -null を許容したいパラメーター、メソッドまたはフィールドにのみ @Nullable を指定するという使用方法があります。 - - - - - - edu.umd.cs.findbugs.annotations.DefaultAnnotationForFields - - - [Target] Type, Package - - - - - - [Parameter] - - - value:アノテーションクラスのclassオブジェクト。複数のクラスを指定することができます。 - - - - priority:省略時の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。 - - - - - - -フィールドのみに適用されること以外は DefaultAnnotation と同様です。 - - - - - - edu.umd.cs.findbugs.annotations.DefaultAnnotationForMethods - - - [Target] Type, Package - - - - - - [Parameter] - - - value:アノテーションクラスのclassオブジェクト。複数のクラスを指定することができます。 - - - - priority:省略時の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。 - - - - - - -メソッドのみに適用されること以外は DefaultAnnotation と同様です。 - - - - - - edu.umd.cs.findbugs.annotations.DefaultAnnotationForParameters - - - [Target] Type, Package - - - - - - [Parameter] - - - value:アノテーションクラスのclassオブジェクト。複数のクラスを指定することができます。 - - - - priority:省略時の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。 - - - - - - -パラメーターのみに適用されること以外は DefaultAnnotation と同様です。 - - - - - - edu.umd.cs.findbugs.annotations.NonNull - - - [Target] Field, Method, Parameter - - - - アノテーションをつけた要素は、 null であってはいけません。アノテーションをつけたフィールドは、構築完了後 null であってはいけません。アノテーションをつけたメソッドは、 null ではない値を戻り値としなければなりません。 - - - - - edu.umd.cs.findbugs.annotations.Nullable - - - [Target] Field, Method, Parameter - - - - -アノテーションをつけた要素は、 条件により null である可能性があります。 -一般に、開発者はドキュメントを読んで null 値を許容するかどうかまたは null 値をチェックするかどうかを決定する必要があります。 -FindBugs はこのアノテーションをつけた要素を、アノテーションがついていないものと同様に扱います。 - - -実際には、このアノテーションは NonNull をつけた要素をオーバーライドする場合に有用です。 - - - - - - edu.umd.cs.findbugs.annotations.OverrideMustInvoke - - - [Target] Method - - - - - - [Parameter] - - - value:super の呼び出し箇所を指定します (FIRST, ANYTIME, LAST)。 デフォルト値 :ANYTIME。 - - - - - - - -オーバーライドされた場合にオーバーライドメソッド内で super を呼び出すべきメソッドにアノテートします。 -例えば、 finalize() や clone() がそのようなメソッドに該当します。 -引数は、 super の呼び出し箇所を指定します。すなわち、随時、メソッドの最初またはメソッドの最後です。 - - - - - - edu.umd.cs.findbugs.annotations.PossiblyNull - - -非推奨です。 CheckForNull を使用してください。 - - - - - - edu.umd.cs.findbugs.annotations.SuppressWarnings - - - [Target] Type, Field, Method, Parameter, Constructor, Package - - - - - - [Parameter] - - - value:警告の名称。複数の名称を指定することができます。 - - - - - justification:警告を無視する理由。 デフォルト値 :""。 - - - - - - -The set of warnings that are to be suppressed by the compiler in the annotated element. -Duplicate names are permitted. The second and successive occurrences of a name are ignored. -The presence of unrecognized warning names is not an error: Compilers -must ignore any warning names they do not recognize. They are, however, free to emit a -warning if an annotation contains an unrecognized warning name. Compiler vendors should -document the warning names they support in conjunction with this annotation type. They -are encouraged to cooperate to ensure that the same names work across multiple compilers. - - - - - - edu.umd.cs.findbugs.annotations.UnknownNullness - - - [Target] Field, Method, Parameter - - - - -Used to indicate that the nullness of the target is unknown, or my vary in unknown ways in subclasses. - - - - - - edu.umd.cs.findbugs.annotations.UnknownNullness - - - [Target] Field, Method, Parameter - - - - -Used to indicate that the nullness of the target is unknown, or my vary in unknown ways in subclasses. - - - - - -また、 &FindBugs; 次に示すアノテーションもサポートしています。 : - net.jcip.annotations.GuardedBy - net.jcip.annotations.Immutable - net.jcip.annotations.NotThreadSafe - net.jcip.annotations.ThreadSafe - - -Java Concurrency in Practice の API ドキュメント を参照してください。 - - - - - -rejarForAnalysis の使用方法 - -プロジェクトに多くの jar ファイル があったり、 jar ファイルが多くのディレクトリに点在したりする場合は、 rejarForAnalysis スクリプトを使用すると FindBugs の実行が比較的簡単になります。このスクリプトは、数多い jar ファイルを集めて 1 つの大きな jar ファイルに結合します。そうすると、分析時にFindBugs に jar ファイルを設定することが比較的簡単になります。このスクリプトは、 unix システムの 'find' コマンドと組み合わせるととりわけ有用になります ; 次に例を示します。 find . -name '*.jar' | xargs rejarForAnalysis . - -また、 rejarForAnalysis スクリプトは巨大なプロジェクトを複数の jar ファイルに分割することに使用できます。プロジェクトのクラスファイルは、複数の jar ファイルに均等に配分されます。これは、プロジェクト全体に対して FindBugs を実行すると時間とメモリ消費が著しい場合に有用です。プロジェクト全体に対して FindBugs を実行する代わりに、 rejarForAnalysis ですべてのクラスを含む大きな jar ファイルを構築します。続いて、 rejarForAnalysis を再び実行して複数の jar ファイルに分割します。そして、各々の jar ファイルに対して順に FindBugs を実行します。その際、 -auxclasspath に最初に 1 つにまとめた jar ファイルを指定してください。 - -rejarForAnalysis スクリプトに指定することができるオプションを以下に示します : - - - - -maxAge 日数 - - 最後に更新された日からの経過時間を日単位で指定します (指定した日数より古い jar ファイルは無視されます)。 - - - - -inputFileList ファイル名 - - jar ファイル名を記載したテキストファイルを指定します。 - - - - -maxClasses クラス数 - - analysis*.jar ファイル 1 ファイルに対するクラスの最大数を指定します。 - - - - -prefix プレフィックス - - 分析するクラス名のプレフィックスを指定します (例、 edu.umd.cs.) 。 - - - - - - - - - &FindBugs;™ によるデータ・マイニング - -バグデータベースへの高機能の問い合わせ機能、および、調査対象のコードの複数のバージョンにわたる警告の追跡記録機能を、 FindBugs は内蔵しています。これらを使って次のようなことができます。すなわち、いつバグが最初持ち込まれたかを捜し出すこと、最終リリース以後持ち込まれた警告の分析を行うこと、または、無限再起ループの数を時間軸でグラフにすることです。 - -これらの技術は、 FindBugs が警告の保存に使う XML 書式を使用します。これらの XML ファイルは、通常、特定の 1 分析に対する警告が入れられています。しかしそれらには、一連のソフトウェアのビルドやバージョンに対する分析結果を格納することもできます。 - -すべての FindBugs XML バグデータベースには、バージョン名とタイム・スタンプ が入れられています。FindBugs は分析が行われるファイルの更新時刻からタイム・スタンプを計算します (例えば、タイム・スタンプはクラスファイルの生成時刻になるようになっています。分析が行われた時刻ではありません) 。各々のバグデータベースには、バージョン名も入れられています。バージョン名とタイム・スタンプは、 setBugDatabaseInfo () コマンドを使用して手動で設定することもできます。 - -複数バージョンを格納するバグデータベースにおいては、分析されるコードの各バージョンごとにシーケンス番号が割り当てられます。これらのシーケンス番号は単に 0 から始まる連続する整数値です (例えば、 4 つのコードバージョンを格納するバグデータベースには、バージョン 0~3 が入れられます) 。バグデータベースにはまた、各バージョンの名前とタイム・スタンプがそれぞれ記録されます。filterBugs コマンドを使用すると、シーケンス番号、バージョン名またはタイム・スタンプからバージョンを参照することができます。 - -1 バージョンを格納するバグデータベースの集合から、 1 個の複数バージョンバグデータベースを作成することができます。また、複数バージョンバグデータベースに対して、それ以後に作成された 1 バージョンのバグデータベースを結合することができます。 - -これらのコマンドのいくつかは、 ant タスクとして実行することができます。コマンドの実行方法および属性・引数の詳細は、以下を参照してください。以下のすべての例においては、 findbugs.lib refid が正しく設定されていることを前提としています。設定方法の一例を次に示します : - - - - - - - - - -]]> - - - - コマンド - - FindBugs データ・マイニング ツールはすべてコマンドラインから実行することができます。また、いくつかのより有用なコマンドは、 ant ビルドファイルから実行することができます。 - -コマンドラインツールについて簡単に説明します : - - - - unionBugs - - 別のクラスに対する別個の分析結果を結合します。 - - - - computeBugHistory - - 複数バージョンから得られた複数のバグ警告を、マージして 1 個の複数バージョンバグデータベースにします。これを使って、既存の複数バージョンバグデータベースに更にバージョンを追加したり、 1 バージョンを格納するバグデータベースの集合から 1 個の複数バージョンバグデータベースを作成したり、できます。 - - - - setBugDatabaseInfo - - リビジョン名やタイム・スタンプなどの情報を XML データベースに設定します。 - - - - listBugDatabaseInfo - - XML データベースにあるリビジョン名やタイム・スタンプなどの情報を一覧表示します。 - - - - filterBugs - - バグデータベースの部分集合を選択します。 - - - - mineBugHistory - - 複数バージョンバグデータベースの各バージョン毎の警告数を一覧にした表を作成します。 - - - - defectDensity - - プロジェクト全体およびクラス毎・パッケージ毎の不良密度 (1000 NCSS 毎の警告数) に関する情報を一覧表示します。 - - - - convertXmlToText - - XML 形式のバグ警告を、 1 行 1 バグのテキスト形式、または、HTML形式に変換します。 - - - - - - - unionBugs - - 分析するのにアプリケーションの jar ファイルを分割している場合、このコマンドを使用することで、別個に生成された XML バグ警告ファイルをすべての警告を含んでいる 1 つの ファイルにすることができます。 - - 同じファイルの異なるバージョンを分析した結果を結合する場合は、このコマンドを使用しないでください。代わりに computeBugHistory を使用してください。 - - XML ファイルは、コマンドラインで指定してください。結果は、標準出力に送られます。 - - - - computeBugHistory - -このコマンドを使用することで、分析するソフトウェアの異なるビルドまたはバージョンの情報を含むバグデータベースを生成することができます入力として提供したファイルの 1 番目のファイルから履歴が取得されます。後に続くファイルは 1 バージョンのバグデータベースであるようにしてください (もし、履歴を持っていたとしても無視されます) 。 -デフォルトでは、結果は標準出力に送られます。 - -この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに computeBugHistory を taskdef で定義します : - - - - - -]]> - - -この ant タスクに指定できる属性を、下表に一覧で示します。入力ファイルを指定するには、 <datafile> 要素を入れ子にして入れてください。次に、例を示します: - - - - - - -]]> - - - - computeBugHistory コマンドのオプション一覧 - - - - コマンドラインオプション - Ant 属性 - 目的 - - - --output <file> output="<file>" 出力結果を保存するファイル名を指定します。 (同時に入力ファイルにもなりえます) --overrideRevisionNames[:truth] overrideRevisionNames="[true|false]"ファイル名から算出されるそれぞれのバージョン名を指定変更します。 --noPackageMoves[:truth] noPackageMoves="[true|false]"パッケージを移動したクラスがある場合、当該クラスの警告は別の存在として扱われます。 --preciseMatch[:truth] preciseMatch="[true|false]"バグパターンが正確に一致することを要求します。 --precisePriorityMatch[:truth] precisePriorityMatch="[true|false]"優先度が正確に一致した場合のみ警告が同一であると判断されます。 --quiet[:truth] quiet="[true|false]"エラーが発生しない限り、標準出力には何も表示されません。 --withMessages[:truth] withMessages="[true|false]"出力 XML に人間が読むことができるバグメッセージが含まれます。 - - -
- - - - filterBugs -このコマンドを使用することで、 FindBugs XML 警告ファイルから一部分を選び出して新規 FindBugs 警告ファイルに選択された部分を書き込むことができます。 -このコマンドには、オプション群に続いて 0 個から 2 個の findbugs xml バグファイルを指定することができます。 -ファイル名をひとつも指定しない場合は、標準入力から読んで標準出力に出力されます。ファイル名を 1 個 指定した場合は、指定したファイルから読んで標準出力に出力されます。ファイル名を 2 個 指定した場合は、 1 番目に指定したファイルから読んで 2 番目に指定したファイルに出力されます。 - -この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに filterBugs を taskdef で定義します : - - - - - -]]> - - -この ant タスクに指定できる属性を、下表に一覧で示します。入力ファイルを指定するには、 input 属性を使用するか、 <datafile> 要素を入れ子にして入れてください。次に、例を示します: - - - - - -]]> - - - - filterBugs コマンドのオプション一覧 - - - - コマンドラインオプション - Ant 属性 - 目的 - - - - input="<file>" 入力ファイルを指定します。 - output="<file>" 出力ファイルを指定します。 --not not="[true|false]" フィルターのスイッチを反転します。 --withSource[:truth] withSource="[true|false]" ソースが入手可能な警告のみ出力されます。 --exclude <filter file>exclude="<filter file>" フィルターに一致するバグが除外されます。 --include <filter file>include="<filter file>" フィルターに一致するバグのみを含まれます。 --annotation <text> annotation="<text>" 手で入力した注釈に指定した文言を含む警告のみ出力されます。 --after <when> after="<when>" 指定したバージョンより後に初めて出現した警告のみ出力されます。 --before <when> before="<when>" 指定したバージョンより前に初めて出現した警告のみ出力されます。 --first <when> first="<when>" 指定したバージョンに初めて出現した警告のみ出力されます。 --last <when> last="<when>" 指定したバージョンが出現した最後である警告のみ出力されます。 --fixed <when> fixed="<when>" 指定したバージョンの前回のバージョンが出現した最後である警告のみ出力されます。 ( に優先します)。 --present <when> present="<when>" 指定したバージョンに存在する警告のみ出力されます。 --absent <when> absent="<when>" 指定したバージョンに存在しない警告のみ出力されます。 --active[:truth] active="[true|false]" 最終通番に存在する警告のみ出力されます。 --introducedByChange[:truth] introducedByChange="[true|false]"存在するクラスの変更によってもたらされた警告のみ出力されます。 --removedByChange[:truth] removedByChange="[true|false]" 存在するクラスの変更によって除去された警告のみ出力されます。 --newCode[:truth] newCode="[true|false]" 新クラスの追加によってもたらされた警告のみ出力されます。 --removedCode[:truth] removedCode="[true|false]" クラスの削除によって除去された警告のみ出力されます。 --priority <level> priority="<level>" 指定した優先度以上の優先度をもつ警告のみ出力されます。 --maxRank <rank> rank="[1..20]" allow only warnings with this rank or lower --class <pattern> class="<class>" 指定したパターンに一致する主クラスをもつ警告のみ出力されます。 --bugPattern <pattern> bugPattern="<pattern>" 指定したパターンに一致するバグ種別をもつ警告のみ出力されます。 --category <category> category="<category>" 指定した文字列で始まるカテゴリーの警告のみ出力されます。 --designation <designation> designation="<designation>" 指定したバグ分類指定をもつ警告のみ出力されます。 (例、 -designation SHOULD_FIX) --withMessages[:truth] withMessages="[true|false]" テキストメッセージを含んだ XML が生成されます。 - - -
- - - - - mineBugHistory -このコマンドを使用することで、複数バージョンバグデータベースの各バージョン毎の警告数を一覧にした表を作成することができます。 - - -この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに mineBugHistory を taskdef で定義します : - - - - - -]]> - - -この ant タスクに指定できる属性を、下表に一覧で示します。入力ファイルを指定するには、 input 属性を使用するか、 <datafile> 要素を入れ子にして入れてください。次に、例を示します: - - - - - -]]> - - - - mineBugHistory コマンドのオプション一覧 - - - - コマンドラインオプション - Ant 属性 - 目的 - - - - input="<file>" 入力ファイルを指定します。 - output="<file>" 出力ファイルを指定します。 --formatDates formatDates="[true|false]" データがテキスト形式で描画されます。 --noTabs noTabs="[true|false]" タブの代わりに複数スペースでカラムが区切られます (下記参照)。 --summary summary="[true|false]" 最新 10 件の変更の要約が出力されます。 - - -
- - 出力を使うことで、固定幅フォントのシェルで読み易くなります。数値カラムは右寄せされるので、スペースがカラム値の前に挿入されます。また、このオプションを使用した場合、 を指定したときに要約の日付を描画するのに空白が埋め込まれなくなります。 - - 出力される表は、 ( が無ければ) タブ区切りで次に示すカラムから成ります : - - - mineBugHistory 出力のカラム一覧 - - - - 表題 - 目的 - - - - seqシーケンス番号 (0 始まりの連続した整数値) - versionバージョン名 - timeリリースされた日時 - classes分析されたクラス数 - NCSSコメント文を除いた命令数 (Non Commenting Source Statements) - added前回のバージョンに存在したクラスにおける新規警告数 - newCode前回のバージョンに存在しなかったクラスにおける新規警告数 - fixed現在のバージョンに存在するクラスにおける除去された警告数 - removed現在のバージョンに存在しないクラスの前回のバージョンにおける警告数 - retained現在のバージョンと前回のバージョンの両方に存在する警告の数 - dead以前のバージョンに存在したが現在のバージョンにも直前のバージョンにも存在しない警告の数 - active現在のバージョンに存在する警告総数 - - -
- - - - defectDensity -このコマンドを使用することで、プロジェクト全体およびクラス毎・パッケージ毎の不良密度 (1000 NCSS 毎の警告数) に関する情報を一覧表示できます。標準入力から読み込む場合はファイル指定なしで、そうでなければ、コマンドラインでファイルを指定して、このコマンドを実行します。 -出力される表は、次に示すカラムから成ります。また、プロジェクト全体情報の行、および、4 個以上の警告を含んでいる各パッケージ情報または各クラス情報の行も出力されます。 - - defectDensity 出力のカラム一覧 - - - - 表題 - 目的 - - - - kindプロジェクト (project)、パッケージ (package) またはクラス (class) - nameプロジェクト、パッケージまたはクラスの名前 - density 1000 NCSS 毎の警告数 - bugs警告数 - NCSSコメント文を除いた命令数 (Non Commenting Source Statements) - - -
- - - - convertXmlToText - - このコマンドを使用することで、XML 形式のバグ警告を、 1 行 1 バグのテキスト形式、または、HTML形式に変換することができます。 - -この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに convertXmlToText を taskdef で定義します : - - - - - -]]> - - -この ant タスクに指定できる属性を、下表に一覧で示します。 - - - convertXmlToText コマンドのオプション一覧 - - - - コマンドラインオプション - Ant 属性 - 目的 - - - - input="<filename>" 入力ファイルを指定します。 - output="<filename>" 出力ファイルを指定します。 --longBugCodes longBugCodes="[true|false]" 2 文字のバグ略称の代わりに、省略なしのバグパターンコードを使用します。 - format="text" プレーンテキストの出力が作成されます。1 行につき 1 つのバグが出力されます。コマンドライン時のデフォルトです。 --html[:stylesheet] format="html:<stylesheet>" 指定されたスタイルシートを使用して出力が作成されます (下記参照) 。省略した場合は、 default.xsl が使用されます。 - - -
- - -html/format オプションには、plain.xsl 、 default.xsl 、 fancy.xsl 、 fancy-hist.xsl または ユーザ自身が作成した XSL スタイルシートのいずれかを指定することができます。オプション名をよそに、 html 以外の形式を出力するスタイルシートを指定することもできます。FindBugs に含まれているスタイルシート(上述)以外のスタイルシートを使用する場合は、オプション -html/format で当該スタイルシートへのパスまたは URL を指定してください。 - - - - setBugDatabaseInfo - - このコマンドを使用することで、指定したバグ警告にメタ情報を設定することができます。このコマンドには次に示すオプションがあります: - -この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに setBugDatabaseInfo を taskdef で定義します : - - - - - -]]> - - -この ant タスクに指定できる属性を、下表に一覧で示します。入力ファイルを指定するには、 input 属性を使用するか、 <datafile> 要素を入れ子にして入れてください。次に、例を示します: - - - - - -]]> - - - - setBugDatabaseInfo オプション一覧 - - - - コマンドラインオプション - Ant 属性 - 目的 - - - - input="<file>" 入力ファイルを指定します。 - output="<file>" 出力ファイルを指定します。 - -name <name> name="<name>" 最新リビジョンの名前を設定します。 - -timestamp <when> timestamp="<when>" 最新リビジョンのタイム・スタンプを設定します。 - -source <directory> source="<directory>" ソースを検索するディレクトリーを追加指定します。 - -findSource <directory> findSource="<directory>" 指定したディレクトリー内を検索して関連するソースの場所を追加します。 - -suppress <filter file> suppress="<filter file>" 指定したファイルに一致する警告を抑止します (以前に指定した抑止設定は置き換えられます)。 - -withMessages withMessages="[true|false]" XMLにテキストメッセージを追加します。 - -resetSource resetSource="[true|false]" ソース検索パスをすべて削除します。 - - -
- - - - listBugDatabaseInfo - - このコマンドの実行においては、コマンドラインで 0 個以上の xml バグデータベースファイル名を指定します。ファイル名を1つも指定しなければ、標準出力から読み込みを行いテーブルのヘッダーは生成されません。 - -このコマンドには 1 つだけオプションがあります : を指定するとテキスト形式でデータが描画されます。 - -出力される表は、各バグデータベースごとに行を持ち、次に示すカラムから成ります : - - listBugDatabaseInfo カラム一覧 - - - - カラム - 目的 - - - - versionバージョン名 - timeリリースされた日時 - classes分析されたクラス数 - NCSSコメント文を除いた命令数 (Non Commenting Source Statements) - total全警告数 - high優先度(高)の警告の総数 - medium優先度(中)の警告の総数 - low優先度(低)の警告の総数 - filenameデータベースのファイル名 - - - -
- - - - - - - 例 - - 提供されたシェル・スクリプトを使用しての履歴マイニング -以下はすべて、 jdk1.6.0-b12, jdk1.6.0-b13, ..., jdk1.6.0-b60 のディレクトリに対してコマンドを実行しています。 - -以下のコマンドを実行してみます : - -computeBugHistory jdk1.6.0-b* | filterBugs -bugPattern IL_ | mineBugHistory -formatDates - -すると、次のような出力が行われます : - - -seq version time classes NCSS added newCode fixed removed retained dead active -0 jdk1.6.0-b12 "Thu Nov 11 09:07:20 EST 2004" 13128 811569 0 4 0 0 0 0 4 -1 jdk1.6.0-b13 "Thu Nov 18 06:02:06 EST 2004" 13128 811570 0 0 0 0 4 0 4 -2 jdk1.6.0-b14 "Thu Dec 02 06:12:26 EST 2004" 13145 811786 0 0 2 0 2 0 2 -3 jdk1.6.0-b15 "Thu Dec 09 06:07:04 EST 2004" 13174 811693 0 0 1 0 1 2 1 -4 jdk1.6.0-b16 "Thu Dec 16 06:21:28 EST 2004" 13175 811715 0 0 0 0 1 3 1 -5 jdk1.6.0-b17 "Thu Dec 23 06:27:22 EST 2004" 13176 811974 0 0 0 0 1 3 1 -6 jdk1.6.0-b19 "Thu Jan 13 06:41:16 EST 2005" 13176 812011 0 0 0 0 1 3 1 -7 jdk1.6.0-b21 "Thu Jan 27 05:57:52 EST 2005" 13177 812173 0 0 0 0 1 3 1 -8 jdk1.6.0-b23 "Thu Feb 10 05:44:36 EST 2005" 13179 812188 0 0 0 0 1 3 1 -9 jdk1.6.0-b26 "Thu Mar 03 06:04:02 EST 2005" 13199 811770 0 0 0 0 1 3 1 -10 jdk1.6.0-b27 "Thu Mar 10 04:48:38 EST 2005" 13189 812440 0 0 0 0 1 3 1 -11 jdk1.6.0-b28 "Thu Mar 17 02:54:22 EST 2005" 13185 812056 0 0 0 0 1 3 1 -12 jdk1.6.0-b29 "Thu Mar 24 03:09:20 EST 2005" 13117 809468 0 0 0 0 1 3 1 -13 jdk1.6.0-b30 "Thu Mar 31 02:53:32 EST 2005" 13118 809501 0 0 0 0 1 3 1 -14 jdk1.6.0-b31 "Thu Apr 07 03:00:14 EDT 2005" 13117 809572 0 0 0 0 1 3 1 -15 jdk1.6.0-b32 "Thu Apr 14 02:56:56 EDT 2005" 13169 811096 0 0 0 0 1 3 1 -16 jdk1.6.0-b33 "Thu Apr 21 02:46:22 EDT 2005" 13187 811942 0 0 0 0 1 3 1 -17 jdk1.6.0-b34 "Thu Apr 28 02:49:00 EDT 2005" 13195 813488 0 1 0 0 1 3 2 -18 jdk1.6.0-b35 "Thu May 05 02:49:04 EDT 2005" 13457 829837 0 0 0 0 2 3 2 -19 jdk1.6.0-b36 "Thu May 12 02:59:46 EDT 2005" 13462 831278 0 0 0 0 2 3 2 -20 jdk1.6.0-b37 "Thu May 19 02:55:08 EDT 2005" 13464 831971 0 0 0 0 2 3 2 -21 jdk1.6.0-b38 "Thu May 26 03:08:16 EDT 2005" 13564 836565 0 0 0 0 2 3 2 -22 jdk1.6.0-b39 "Fri Jun 03 03:10:48 EDT 2005" 13856 849992 0 1 0 0 2 3 3 -23 jdk1.6.0-b40 "Thu Jun 09 03:30:28 EDT 2005" 15972 959619 0 2 0 0 3 3 5 -24 jdk1.6.0-b41 "Thu Jun 16 03:19:22 EDT 2005" 15972 959619 0 0 0 0 5 3 5 -25 jdk1.6.0-b42 "Fri Jun 24 03:38:54 EDT 2005" 15966 958581 0 0 0 0 5 3 5 -26 jdk1.6.0-b43 "Thu Jul 14 03:09:34 EDT 2005" 16041 960544 0 0 0 0 5 3 5 -27 jdk1.6.0-b44 "Thu Jul 21 03:05:54 EDT 2005" 16041 960547 0 0 0 0 5 3 5 -28 jdk1.6.0-b45 "Thu Jul 28 03:26:10 EDT 2005" 16037 960606 0 0 1 0 4 3 4 -29 jdk1.6.0-b46 "Thu Aug 04 03:02:48 EDT 2005" 15936 951355 0 0 0 0 4 4 4 -30 jdk1.6.0-b47 "Thu Aug 11 03:18:56 EDT 2005" 15964 952387 0 0 1 0 3 4 3 -31 jdk1.6.0-b48 "Thu Aug 18 08:10:40 EDT 2005" 15970 953421 0 0 0 0 3 5 3 -32 jdk1.6.0-b49 "Thu Aug 25 03:24:38 EDT 2005" 16048 958940 0 0 0 0 3 5 3 -33 jdk1.6.0-b50 "Thu Sep 01 01:52:40 EDT 2005" 16287 974937 1 0 0 0 3 5 4 -34 jdk1.6.0-b51 "Thu Sep 08 01:55:36 EDT 2005" 16362 979377 0 0 0 0 4 5 4 -35 jdk1.6.0-b52 "Thu Sep 15 02:04:08 EDT 2005" 16477 979399 0 0 0 0 4 5 4 -36 jdk1.6.0-b53 "Thu Sep 22 02:00:28 EDT 2005" 16019 957900 0 0 1 0 3 5 3 -37 jdk1.6.0-b54 "Thu Sep 29 01:54:34 EDT 2005" 16019 957900 0 0 0 0 3 6 3 -38 jdk1.6.0-b55 "Thu Oct 06 01:54:14 EDT 2005" 16051 959014 0 0 0 0 3 6 3 -39 jdk1.6.0-b56 "Thu Oct 13 01:54:12 EDT 2005" 16211 970835 0 0 0 0 3 6 3 -40 jdk1.6.0-b57 "Thu Oct 20 01:55:26 EDT 2005" 16279 971627 0 0 0 0 3 6 3 -41 jdk1.6.0-b58 "Thu Oct 27 01:56:30 EDT 2005" 16283 971945 0 0 0 0 3 6 3 -42 jdk1.6.0-b59 "Thu Nov 03 01:56:58 EST 2005" 16232 972193 0 0 0 0 3 6 3 -43 jdk1.6.0-b60 "Thu Nov 10 01:54:18 EST 2005" 16235 972346 0 0 0 0 3 6 3 - - -次に示すコマンドを実行すると、db.xml 中間ファイルを生成することなく直接同じ情報を作成できます。 - - -computeBugHistory jdk1.6.0-b*/jre/lib/rt.xml | filterBugs -bugPattern IL_ db.xml | mineBugHistory -formatDates - - -この情報を使って、 Sun JDK1.6.0 の各ビルドにおいて FindBugs によって発見された無限再起ループの数を表すグラフを表示します。青色の領域は、当該ビルドにおける無限再起ループの数を表しています。その上に描かれている赤色の領域は、以前のバージョンには存在したが当該バージョンでは除去された無限再起ループの数を表しています。 (したがって、赤色の領域と青色の領域を足し合わせた高さは決して減少しないことが保証されています。そして、新たに無限再起ループのバグが持ち込まれた時点で増加します) 。赤色の領域の高さは、当該バージョンにおいて修正または削除されたバグ数の合計で算出されます。バージョン 13 および 14 において見られる減少は、 FindBugs を使用して見つかった JDK のバグの報告を Sun が受け取ったことによるものです。 - - - - - - -db.xml ファイルは、 jdk1.6.0 のすべてのビルドに対する検索結果を保持しています。したがって、次に示すコマンドを実行することで、優先度(高)または優先度(低)の正確性に関する警告の履歴が表示されます : - - -filterBugs -priority M -category C db.xml | mineBugHistory -formatDates - - -作成される表の例 : - - -seq version time classes NCSS added newCode fixed removed retained dead active -0 jdk1.6.0-b12 "Thu Nov 11 09:07:20 EST 2004" 13128 811569 0 1075 0 0 0 0 1075 -1 jdk1.6.0-b13 "Thu Nov 18 06:02:06 EST 2004" 13128 811570 0 0 0 0 1075 0 1075 -2 jdk1.6.0-b14 "Thu Dec 02 06:12:26 EST 2004" 13145 811786 3 0 6 0 1069 0 1072 -3 jdk1.6.0-b15 "Thu Dec 09 06:07:04 EST 2004" 13174 811693 2 1 3 0 1069 6 1072 -4 jdk1.6.0-b16 "Thu Dec 16 06:21:28 EST 2004" 13175 811715 0 0 1 0 1071 9 1071 -5 jdk1.6.0-b17 "Thu Dec 23 06:27:22 EST 2004" 13176 811974 0 0 1 0 1070 10 1070 -6 jdk1.6.0-b19 "Thu Jan 13 06:41:16 EST 2005" 13176 812011 0 0 0 0 1070 11 1070 -7 jdk1.6.0-b21 "Thu Jan 27 05:57:52 EST 2005" 13177 812173 0 0 1 0 1069 11 1069 -8 jdk1.6.0-b23 "Thu Feb 10 05:44:36 EST 2005" 13179 812188 0 0 0 0 1069 12 1069 -9 jdk1.6.0-b26 "Thu Mar 03 06:04:02 EST 2005" 13199 811770 0 0 2 1 1066 12 1066 -10 jdk1.6.0-b27 "Thu Mar 10 04:48:38 EST 2005" 13189 812440 1 0 1 1 1064 15 1065 -11 jdk1.6.0-b28 "Thu Mar 17 02:54:22 EST 2005" 13185 812056 0 0 0 0 1065 17 1065 -12 jdk1.6.0-b29 "Thu Mar 24 03:09:20 EST 2005" 13117 809468 3 0 8 26 1031 17 1034 -13 jdk1.6.0-b30 "Thu Mar 31 02:53:32 EST 2005" 13118 809501 0 0 0 0 1034 51 1034 -14 jdk1.6.0-b31 "Thu Apr 07 03:00:14 EDT 2005" 13117 809572 0 0 0 0 1034 51 1034 -15 jdk1.6.0-b32 "Thu Apr 14 02:56:56 EDT 2005" 13169 811096 1 1 0 1 1033 51 1035 -16 jdk1.6.0-b33 "Thu Apr 21 02:46:22 EDT 2005" 13187 811942 3 0 2 1 1032 52 1035 -17 jdk1.6.0-b34 "Thu Apr 28 02:49:00 EDT 2005" 13195 813488 0 1 0 0 1035 55 1036 -18 jdk1.6.0-b35 "Thu May 05 02:49:04 EDT 2005" 13457 829837 0 36 2 0 1034 55 1070 -19 jdk1.6.0-b36 "Thu May 12 02:59:46 EDT 2005" 13462 831278 0 0 0 0 1070 57 1070 -20 jdk1.6.0-b37 "Thu May 19 02:55:08 EDT 2005" 13464 831971 0 1 1 0 1069 57 1070 -21 jdk1.6.0-b38 "Thu May 26 03:08:16 EDT 2005" 13564 836565 1 7 2 6 1062 58 1070 -22 jdk1.6.0-b39 "Fri Jun 03 03:10:48 EDT 2005" 13856 849992 6 39 5 0 1065 66 1110 -23 jdk1.6.0-b40 "Thu Jun 09 03:30:28 EDT 2005" 15972 959619 7 147 11 0 1099 71 1253 -24 jdk1.6.0-b41 "Thu Jun 16 03:19:22 EDT 2005" 15972 959619 0 0 0 0 1253 82 1253 -25 jdk1.6.0-b42 "Fri Jun 24 03:38:54 EDT 2005" 15966 958581 3 0 1 2 1250 82 1253 -26 jdk1.6.0-b43 "Thu Jul 14 03:09:34 EDT 2005" 16041 960544 5 11 15 8 1230 85 1246 -27 jdk1.6.0-b44 "Thu Jul 21 03:05:54 EDT 2005" 16041 960547 0 0 0 0 1246 108 1246 -28 jdk1.6.0-b45 "Thu Jul 28 03:26:10 EDT 2005" 16037 960606 19 0 2 0 1244 108 1263 -29 jdk1.6.0-b46 "Thu Aug 04 03:02:48 EDT 2005" 15936 951355 13 1 1 32 1230 110 1244 -30 jdk1.6.0-b47 "Thu Aug 11 03:18:56 EDT 2005" 15964 952387 163 8 7 20 1217 143 1388 -31 jdk1.6.0-b48 "Thu Aug 18 08:10:40 EDT 2005" 15970 953421 0 0 0 0 1388 170 1388 -32 jdk1.6.0-b49 "Thu Aug 25 03:24:38 EDT 2005" 16048 958940 1 11 1 0 1387 170 1399 -33 jdk1.6.0-b50 "Thu Sep 01 01:52:40 EDT 2005" 16287 974937 19 27 16 7 1376 171 1422 -34 jdk1.6.0-b51 "Thu Sep 08 01:55:36 EDT 2005" 16362 979377 1 15 3 0 1419 194 1435 -35 jdk1.6.0-b52 "Thu Sep 15 02:04:08 EDT 2005" 16477 979399 0 0 1 1 1433 197 1433 -36 jdk1.6.0-b53 "Thu Sep 22 02:00:28 EDT 2005" 16019 957900 13 12 16 20 1397 199 1422 -37 jdk1.6.0-b54 "Thu Sep 29 01:54:34 EDT 2005" 16019 957900 0 0 0 0 1422 235 1422 -38 jdk1.6.0-b55 "Thu Oct 06 01:54:14 EDT 2005" 16051 959014 1 4 7 0 1415 235 1420 -39 jdk1.6.0-b56 "Thu Oct 13 01:54:12 EDT 2005" 16211 970835 6 8 37 0 1383 242 1397 -40 jdk1.6.0-b57 "Thu Oct 20 01:55:26 EDT 2005" 16279 971627 0 0 0 0 1397 279 1397 -41 jdk1.6.0-b58 "Thu Oct 27 01:56:30 EDT 2005" 16283 971945 0 1 1 0 1396 279 1397 -42 jdk1.6.0-b59 "Thu Nov 03 01:56:58 EST 2005" 16232 972193 6 0 5 0 1392 280 1398 -43 jdk1.6.0-b60 "Thu Nov 10 01:54:18 EST 2005" 16235 972346 0 0 0 0 1398 285 1398 -44 jdk1.6.0-b61 "Thu Nov 17 01:58:42 EST 2005" 16202 971134 2 0 4 0 1394 285 1396 - - - - - 増分履歴メンテナンス - -仮に、 db.xml がビルド b12 - b60 に対する findbugs 実行結果を保持している場合、次に示すコマンドを実行することで、 db.xml に b61 に対する実行結果を追加することができます : - -computeBugHistory -output db.xml db.xml jdk1.6.0-b61/jre/lib/rt.xml - - - - - - - Ant の例 -findbugs の実行とその後のデータ・マイニングツールの活用の両方を実行している ant スクリプトの完全な例を以下に示します : - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -]]> - - - - - - - - -ライセンス - -名称「FindBugs」および FindBugs のロゴは、メリーランド大学の登録商標です。FindBugs はフリーソフトウェアであり、 Lesser GNU Public License の条件で配布されています。使用承諾書を入手したい場合は、 &FindBugs; 配布物に含まれる LICENSE.txt ファイルを参照してください。 - -最新バージョンの FindBugs および そのソースコードは FindBugs web ページ で入手できます。 - - - - - - -謝辞 - - -貢献者 - -&FindBugs; was originally written by Bill Pugh (pugh@cs.umd.edu). -David Hovemeyer (daveho@cs.umd.edu) implemented some of the -detectors, added the Swing GUI, and is a co-maintainer. - -Mike Fagan (mfagan@tde.com) contributed the &Ant; build script, -the &Ant; task, and several enhancements and bug fixes to the GUI. - -Germano Leichsenring contributed Japanese translations of the bug -summaries. - -David Li contributed the Emacs bug report format. - -Peter D. Stout contributed recursive detection of Class-Path -attributes in analyzed Jar files, German translations of -text used in the Swing GUI, and other fixes. - -Peter Friese wrote the &FindBugs; Eclipse plugin. - -Rohan Lloyd contributed several Mac OS X enhancements, -bug detector improvements, -and maintains the Fink package for &FindBugs;. - -Hiroshi Okugawa translated the &FindBugs; manual and -more of the bug summaries into Japanese. - -Phil Crosby enhanced the Eclipse plugin to add a view -to display the bug details. - -Dave Brosius fixed a number of bugs, added user preferences -to the Swing GUI, improved several bug detectors, and -contributed the string concatenation detector. - -Thomas Klaeger contributed a number of bug fixes and -bug detector improvements. - -Andrey Loskutov made a number of bug fixes and -bug detector improvements. He is maintainer of the Eclipse plugin. - -Brian Goetz contributed a major refactoring of the -visitor classes to improve readability and understandability. - - Pete Angstadt fixed several problems in the Swing GUI. - -Francis Lalonde provided a task resource file for the -FindBugs Ant task. - -Garvin LeClaire contributed support for output in -Xdocs format, for use by Maven. - -Holger Stenzhorn contributed improved German translations of items -in the Swing GUI. - -Juha Knuutila contributed Finnish translations of items -in the Swing GUI. - -Tanel Lebedev contributed Estonian translations of items -in the Swing GUI. - -Hanai Shisei (ruimo) contributed full Japanese translations of -bug messages, and text used in the Swing GUI. - -David Cotton contributed Fresh translations for bug -messages and for the Swing GUI. - -Michael Tamm contributed support for the "errorProperty" attribute -in the Ant task. - -Thomas Kuehne improved the German translation of the Swing GUI. - -Len Trigg improved source file support for the Emacs output mode. - -Greg Bentz provided a fix for the hashcode/equals detector. - -K. Hashimoto contributed internationalization fixes and several other - bug fixes. - - - Glenn Boysko contributed support for ignoring specified local - variables in the dead local store detector. - - - - Jay Dunning contributed a detector to find equality comparisons - of floating-point values, and overhauled the analysis summary - report and its representation in the saved XML format. - - - - Olivier Parent contributed updated French translations for bug descriptions and - Swing GUI. - - - - Chris Nappin contributed the plain.xsl - stylesheet. - - - - Etienne Giraudy contributed the fancy.xsl and fancy-hist.xsl - stylesheets, and made improvements to the -xml:withMessages - option. - - - - Takashi Okamoto fixed bugs in the project preferences dialog - in the Eclipse plugin, and contributed to its internationalization and localization. - - -Thomas Einwaller fixed bugs in the project preferences dialog in the Eclipse plugin. - -Jeff Knox contributed support for the warningsProperty attribute -in the Ant task. - -Peter Hendriks extended the Eclipse plugin preferences, -and fixed a bug related to renaming the Eclipse plugin ID. - -Mark McKay contributed an Ant task to launch the findbugs frame. - -Dieter von Holten (dvholten) contributed -some German improvements to findbugs_de.properties. - - -If you have contributed to &FindBugs;, but aren't mentioned above, -please send email to findbugs@cs.umd.edu (and also accept -our humble apologies). - - - - -使用しているソフトウェア - -&FindBugs; は、いくつかのオープンソースソフトウェアパッケージを使用しています。これらがなければ、 &FindBugs; の開発は、より一層困難なものになったことでしょう。 - - -BCEL -&FindBugs; includes software developed by the Apache Software Foundation -(http://www.apache.org/). -Specifically, it uses the Byte Code -Engineering Library. - - - -ASM -&FindBugs; uses the ASM -bytecode framework, which is distributed under the following license: - -
- -Copyright (c) 2000-2005 INRIA, France Telecom -All rights reserved. - - - -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions -are met: - - - - - Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - - - Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. - - - Neither the name of the copyright holders nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. - - - - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE -LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF -THE POSSIBILITY OF SUCH DAMAGE. - -
- - - -DOM4J -&FindBugs; uses DOM4J, which is -distributed under the following license: - -
- -Copyright 2001 (C) MetaStuff, Ltd. All Rights Reserved. - - - -Redistribution and use of this software and associated documentation -("Software"), with or without modification, are permitted provided that -the following conditions are met: - - - - - Redistributions of source code must retain copyright statements and - notices. Redistributions must also contain a copy of this document. - - - Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. - - - The name "DOM4J" must not be used to endorse or promote products - derived from this Software without prior written permission - of MetaStuff, Ltd. For written permission, please contact - dom4j-info@metastuff.com. - - - Products derived from this Software may not be called "DOM4J" nor may - "DOM4J" appear in their names without prior written permission of - MetaStuff, Ltd. DOM4J is a registered trademark of MetaStuff, Ltd. - - - Due credit should be given to the DOM4J Project (http://dom4j.org/). - - - - -THIS SOFTWARE IS PROVIDED BY METASTUFF, LTD. AND CONTRIBUTORS ``AS IS'' -AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL METASTUFF, LTD. OR ITS -CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, -EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, -PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR -PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF -LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING -NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS -SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - -
- - - - - - - - - diff --git a/sysprops.html b/sysprops.html deleted file mode 100644 index 7b1e1b9..0000000 --- a/sysprops.html +++ /dev/null @@ -1,155 +0,0 @@ - - - - - - - - -SpotBugs Optional System Properties - - - -

SpotBugs Optional System Properties

- -

These system properties can be added to the command line to alter the way -findbugs works. These options should be considered experimental. The description -gives information if the field is set to true. -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
System PropertyDescription
findbugs.assertionmethodsmethods supplied by user that have assertions
findbugs.checkreturn.loadtraining -
findbugs.checkreturn.savetraining		file name to read/write list of methods whose return values must be checked
findbugs.de.commentDon't report empty catch blocks if a source comment is found in the block.
findbugs.dls.exclusionslocal variables that will be excluded from Dead Local Store
findbugs.fis.unsyncFactorDefault value is 2.0, which means that we report a bug if more than 1/3 of accesses are unsynchronized.
findbugs.fis.writeBiasDefault value is 2.0. The idea is that this should be above 1.0, because unsynchronized writes are more dangerous than unsynchronized reads.
fundbugs.gui.bugCount?
findbugs.maskedfields.localsReport on local variables that mask fields.
findbugs.nullderef.assumenspsets value for IsNullValueAnalysisFeatures.UNKNOWN_VALUES_ARE_NSP, but is not used by SpotBugs
findbugs.refcomp.reportAll?
findbugs.report.SummaryHTMLemit SummaryHTML element
findbugs.sf.commentIgnore switch fall through bugs if a comment is found with 'fall' or 'nobreak' -
ba.checkAssertionsthrow excptions on certain illegal class type signatures
ba.verifyIntegrityenable data structure integrity checks
BCPMethodReturnCheck.javaAdd methods to the list requiring a check. (format: "class:method:sig|...")
dataflow.stackonly?
fis.eval?
fis.noAdjustSubclassAdjust field so its class name is the same as the type of reference it is accessed through.
fos.allowWUSIgnore wrapping streams that are wrapping uninteresting streams (like in memory streams).
ic.createInstance?
inva.ncpExtraBranch?
inva.noAssertHack?
inva.noSplitDowngradeNSP?
inva.noSwitchDefaultAsExceptionDon't consider switch default cases as exception paths.
lineNumberBugDisable the workaround for the bug in BCEL 5.0's LineNumberTable class.
ma.uglyReport method signature with method class and name.
mrc.checkallCheck for 1.5-specific method return values being ignored even if runtime Java predates 1.5.
ta.accurateExceptions?
vna.noRLEPerform redundant load elimination and forward substitution (but not in a correctness-preserving way).
- - - - -