SENG 301 – Tutorial 1 Introduction to Eclipse, Subclipse, and JUnit Slides: Theodore D. Hellmann

Acquiring the Software - 1 Eclipse: - download “Eclipse Classic” from eclipse.org - remember it just unzips (no installation)‏ JUnit: - JUnit 3.4 and 4.3 comes with Eclipse - 4.5 is out; you can get it from junit.org

Acquiring the Software - 2 Subclipse: 1) Start Eclipse 2) Under the “Help” menu, click “Software Updates”, then select the “Available Software” tab 3) Click “Add Site…” and type in http://subclipse.tigris.org/update_1.4.x 4) Click the “OK” button, select the checkbox next to Subclipse, and click “Install…”

Using Eclipse - 1 First create a new project: - click on “File”, then “New”, then “Java Project” Next, create a new class: - click “File”, then “New”, then “Class” To run your code: - click on the “Run” menu, then on “Run”

Using Eclipse - 2 Some useful features: - Catches syntax errors while you code - Hover over an error (squiggly red line) for suggestions on how to fix it - Auto-Complete

Using Subclipse - 1 Before you can use Subclipse: - email help@cpsc.ucalgary.ca and ask for an SVN account - the email should look something like “Hi, I need an SVN account for [your username], and the following people will need to be able to access it: [your partner’s usernames]” Standard operating procedure is to CC Dr. Sillito

Using Subclipse - 2 Help’s response will contain: - the link you’ll need to use when initially sharing the project and when accessing it - it should look something like: https://forge.cpsc.ucalgary.ca/svn/courses/s301/ group[your group number here]

Using Subclipse - 3 To share a project: - create a project in Eclipse - right-click the project, hover over “Team” in the context menu, and click “Share Project…” - double-click “SVN”, then enter in the URL that Help sent you

Using Subclipse - 4 To access a shared project: - click on “Window”, hover over “Open Perspective…”, then click on “Other” - select “SVN Repository Exploring” from the list - next, right-click within that perspective, hover over “New”, then select “Repository Location” - enter in the URL, after which you will likely be prompted for your username and password

Using Subclipse - 5 The main commands you will use in Subclipse: Update: will check the repository for changes and add them to your code Commit: takes changes in your code and adds them to the server Merge: resolves conflicts discovered by either of the above operations

Using Subclipse - 6 The main commands you will use (continued): Synchronize: - allows you to select which changes to make to both code bases if there have been concurrent modifications - otherwise Subclipse may insert junk into your code!

Using Subclipse - 7 To take any of these actions: - right-click on your project, hover over “Team”, then select the action you want from the menu If you Update/Commit frequently, you’ll reduce the chance of creating a conflict, and also reduce the time it takes to sort a conflict out!

Testing - Definitions There are two main types of testing that JUnit is good for: Unit Testing - checks whether a subset of your project is working; for example that an individual method is performing as expected Acceptance Testing - checks whether your code as a whole is performing as expected

JUnit Testing - 1 To create a JUnit test class: - go to “File”, then “New”, then “JUnit Test Case” - type the name of the class you want to test into the box next to “Class under test:” - the convention is to name your test something along the lines of “[name]Test”, where [name] is the name of the class you’re testing.

JUnit Testing - 2 Put the tag “@Before” before any method you want run before every test Put the tag “@After” before any method you want run after every test To write a test, just put the tag “@Test” before a method If a test passes when an exception is thrown, use “@Test (expected = [exception name here])”

JUnit Testing - 3 Within a test, use Assert to make sure that your test code is behaving as expected. For example, if your method adds two numbers and returns the result, you might test it with: Assert.assertEquals(3, addThese(5, -2)); or Assert.assertTrue(4 == addThese(2, 2));

JUnit Testing - 4 To run a test class: - right-click on the class in the Package Explorer, hover over “Run An…” and select “JUnit Test”