checkstyle4bluej5

Checkstyle Extension for BlueJ 5

This updates the BlueJ Checkstyle Extension (originally sourced from http://bluejcheckstyle.sourceforge.net) to work with BlueJ 5.0, Checkstyle 8.4, and Java 11+. See: https://bluej.org/extensions/writingextensions2.html

---

Abbreviated Usage Instructions

Overview

The BlueJ Checkstyle Extension is a wrapper for BlueJ to use Checkstyle, a source code analysis tool to help programmers write Java code that adheres to a coding standard.

The user can choose the Checkstyle configuration file that specifies which checks are applied to the Java source code. The extension distribution includes sample configuration files for the Sun Code Conventions, course-specific configuration files used at Virginia Tech and MSU Denver, and the Big Java Coding Guidelines.

Requirements

BlueJ 5.0.x running on JDK 11 or higher.

Download

The update of the BlueJ Checkstyle extension can be downloaded from the GitHub repository using this direct link to the extension jar file.

Installation

• Download the latest version of the extension jar file.

• Place the jar file in BlueJ's extensions directory:

  • Under Windows or Unix, place the jar in <BLUEJ_HOME>/lib/extensions, where <BLUEJ_HOME> is the directory where BlueJ is installed.
  • Under Mac OSX, place the jar in /Applications/BlueJ.app/Contents/Resources/Java/extensions (control-click BlueJ.app and choose Show Package Contents) or in ~/Library/Preferences/org.bluej/extensions.
  • If you are upgrading from an earlier version, remove the older checkstyle-extension*.jar file from your extensions directory.

Usage

• Open BlueJ.
• To run a check on all files in the current package, choose Checkstyle from the Tools menu.

Setting User Preferences

• The extension uses its built-in default_checks.xml file unless you specify a different configuration file in Preferences.

• To specify the Checkstyle configuration file or properties file:

  • Choose Preferences... from the Tools menu (or from the BlueJ menu under Mac OSX).
  • In the Preferences panel, click on the Extensions tab.
  • In the "Checkstyle" section, enter the file name for the checkstyle configuration XML file and/or properties file you wish to use.
  • In addition to local file names, you can also use URLs in the preferences settings.
  • To use one of the built-in configuration files, simply enter one of these file names with no path or directory:
    • sun_checks.xml (Sun Java code conventions)
    • bigjava_checks.xml (Big Java coding conventions)
    • cs1114_checks.xml (Virginia Tech CS style)
    • cs4250_checks.xml (MSU Denver CS style)