This QuickStart guide explores using open source Justify modules with a set of sample JUnit tests imported into Eclipse. If you elect to use Justify modules for your own project see the download page.
Step 1 – JDK and IDE (Eclipse) Installation
a. Download and install the current Java 8 SE Development Kit .
b. Download the current version of Eclipse – “Eclipse IDE for Java EE Developers” – from here. Extract the download to an installation directory similar to the following:
PC: C:\eclipse\oxygen Mac: /Applications/eclipse/oxygen
Step 2 – Launch Eclipse
Launch Eclipse and open a (suggested) work space as follows:
PC: C:\project\quickstart Mac: /project/quickstart
Step 3 – Proxy Server
Note: If you connect through a proxy server you may need to modify Windows / Preferences / General / Network Connections.
Step 4 – Perspectives – Required for Instructor Guided Training
- Deselect the “Always show Welcome at start up”
- Close the “Welcome” page
- In the upper-right corner, right-click and “close” the Java EE “Perspective”
- Ensure the “Java” perspective is active from Window / Perspective / Open Perspective / [Other…] / Java
Step 5 – Views – Required for Instructor Guided Training
Consider closing the “Task List”, “Outline” and “Declaration” Views. These views can remain open:
- Javadoc (bottom-right)
- Package Explorer (upper-left)
- Problems (bottom-right)
These additional Views (within the Java perspective) may be opened from Window / Show View / Other…
- Console (bottom-right)
- JUnit (move to bottom-left creating a new window)
- Consider using Layout / Vertical
Step 6 – Download the QuickStart Project
Download the QuickStart project from here [selecting the ‘download’ button] and unzip to the applicable Eclipse workspace folder resulting in:
Step 7 – Import using Gradle
Right-click in the Package Explorer view and select Import… — typing “Gradle” in the filter followed by selecting “Existing Gradle Project” and pressing Next and Next again.
Browse to the “justify-quickstart” folder as the “Project root directory” and Next.
Select the “Gradle wrapper” option. Select Next and Finish.
It may take a few minutes for Gradle to initialize the environment; view the lower right-hand corner for activity. Note: You may want to Project / Clean… / Clean all projects.
Step 8 – Run JUnit Tests
Highlight any of the “src/test/java” folders and right-click to “Run As” “JUnit Test”. If properly configured all tests run GREEN.
Step 9 – Explore!
Explore the QuickStart JUnit tests to see how Justify accelerates test creation with fluent “Rules” for configuration and powerful “Assertions” for verification.