1. Overview
In this quick tutorial, we will see how to perform bug detection in a Java application using SpotBugs and Maven.
SpotBugs is a program that uses static analysis to look for bugs in Java code. It is free software, distributed under the terms of the GNU Lesser General Public License. SpotBugs is a fork of FindBugs which is no longer maintained.
You may use Spotbugs as a standalone application, as well as through several integrations including Maven, Gradle, Eclipse, and IntelliJ. In this tutorial, we are focusing on Maven integration.
You need at least Java 8 to run SpotBugs, but you can analyze programs written with older versions of Java.
2. Version check
This tutorial has been tested with the following tools :
- Java 17
- Maven 3.8.6
- SpotBugs Plugin for Maven 4.8.1.0
- Maven Site Plugin 4.0.0-M9
3. Sample Code
To generate a bug report we need some code to work with. For this tutorial, we are using a project with a simple Java class Flight shown below :
package com.kloudly.spotbugs;
import java.util.Date;
public class Flight {
private Date departureTime;
private Date arrivalTime;
public Date getDepartureTime() {
return departureTime;
}
public void setDepartureTime(Date departureTime) {
this.departureTime = departureTime;
}
public Date getArrivalTime() {
return arrivalTime;
}
public void setArrivalTime(Date arrivalTime) {
this.arrivalTime = arrivalTime;
}
}
4. Adding SpotBugs Plugin to Maven
Typically, SpotBugs will generate a report in an XML format (target/spotbugsXml.xml). To have a prettier report, we need to add the SpotBugs plugin in the reporting phase of Maven.
<reporting>
<plugins>
<!-- Spotbugs report-->
<plugin>
<groupId>com.github.spotbugs</groupId>
<artifactId>spotbugs-maven-plugin</artifactId>
<version>${maven.spotbugs.version}</version>
<configuration>
<jvmArgs>-Duser.language=en</jvmArgs>
</configuration>
</plugin>
</plugins>
</reporting>
We are using the “jvmArgs” option to force Maven to display the report in English.
Because the report is produced during the Maven site goal, we also need to add the Maven Site plugin to our build.
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-site-plugin</artifactId>
<version>${maven.site.version}</version>
</plugin>
</plugins>
</build>
5. Generating the report
5.1. Running maven site
Run the following command from the root directory of your project to produce the bugs report :
foo@bar:~$ mvn clean compile site
5.2. Viewing the result
Navigate to the following directory and open the file to see the results directly in a browser: target/site/spotbugs.html
From this report, we can see that our Flight class has 4 bugs with medium priority. Next, let’s see how to fix those bugs.
5.3. Fixing some bugs
The bug EI_EXPOSE_REP is triggered whenever you return a reference to a mutable object value stored in one of the object’s fields. For this specific case, the returned java.util.Date class is mutable, hence the rule is broken.
To fix this, we can do any of the following :
- Change the setters and getters implementations to use non-mutable copies of the fields.
- Change the field type from java.util.Date to java.time.LocalDateTime (which is not mutable)
Using the clone method
Update your class as shown below :
package com.kloudly.spotbugs;
import java.util.Date;
/**
* This Flight class uses clone() method to avoid
* returning a reference to a mutable object
*/
public class FlightV2 {
private Date departureTime;
private Date arrivalTime;
public Date getDepartureTime() {
if(departureTime != null){
return (Date) departureTime.clone();
}
return null;
}
public void setDepartureTime(Date departureTime) {
if(departureTime != null){
this.departureTime = (Date) departureTime.clone();
}
}
public Date getArrivalTime() {
if(arrivalTime != null){
return (Date) arrivalTime.clone();
}
return null;
}
public void setArrivalTime(Date arrivalTime) {
if(arrivalTime != null){
this.arrivalTime = (Date) arrivalTime.clone();
}
}
}
Using the java.time.LocalDateTime class
Update your class as shown below :
package com.kloudly.spotbugs;
import java.time.LocalDateTime;
/**
* This Flight class uses LocalDateTime to avoid
* returning a reference to a mutable object.
* LocalDateTime is by definition not mutable
*/
public class FlightV3 {
private LocalDateTime departureTime;
private LocalDateTime arrivalTime;
public LocalDateTime getDepartureTime() {
return departureTime;
}
public void setDepartureTime(LocalDateTime departureTime) {
this.departureTime = departureTime;
}
public LocalDateTime getArrivalTime() {
return arrivalTime;
}
public void setArrivalTime(LocalDateTime arrivalTime) {
this.arrivalTime = arrivalTime;
}
}
After implementing any of the previously suggested changes, running “mvn clean compile site” again will produce a free-bugs report like the one below :
6. Conclusion
In this quick tutorial, we learned how to make use of the SpotBugs maven plugin to list the bugs in a Java application. For more in-depth use of SpotBugs, refer to the official documentation available here.
You can find the complete code of this article here in GitHub