1. 1 v1.6 08/02/2006 Module Road Map 1.Overview 2.Installing and Running 3.Building and Running Java Classes 4.Refactoring 5.Debugging 6.Testing with JUnit 7.Version Control with Subversion  Introduction  Terminology  Adding a repository to Eclipse Workbench  Sharing a project  Checking out a project from repository  Synchronizing with respository Lecture 4

2. 2 v1.6 08/02/2006 The Problem of Version Control Suppose two programmers are working on a project.  (See http://svnbook.red-bean.com/en/1.4/svn-book.html#svn.basic)  They edit the same file.  Then they both save their changes.  What will happen?  One approach: Programmer P1 locks the file, then unlocks it when done.  What is wrong with this?

3. 3 v1.6 08/02/2006 Subversion (SVN) An open-source based version-control system Allows coordination of source code changes made by individual developers working on a team Client-server method lets developers access code from anywhere there’s an internet connection.  Central server maintains history of all changes made to directory trees, called repositories  Client machines have a copy of all files that developers are working on.  The changes are then reported to the central server using a client that can access and update repositories.

4. 4 v1.6 08/02/2006 Subversion — What it does Subversion operations  Checking out from a repository  Retrieves a directory from a Subversion repository to the Workbench on local machine  Sharing a resource  Creates a copy of the resource on the Subversion repository  Synchronizing with a repository  Update Before you can commit changes, Subversion requires your sources to be in sync with any changes committed by other developers.  Commit To make the changes available to other developers, you must commit them to the repository.

5. 5 v1.6 08/02/2006 Download Subversion

6. 6 v1.6 08/02/2006 Installing Subversion I chose the latest stable version of Windows binary

7. 7 v1.6 08/02/2006 Unzipping Subversion

8. 8 v1.6 08/02/2006 Put Subversion in C:\Program Files

9. 9 v1.6 08/02/2006 Install Subversive, the Eclipse Client

10. 10 v1.6 08/02/2006 Installing Subversive In Eclipse: Help > Software Upates > Find and Install

11. 11 v1.6 08/02/2006 Search for Features of New Plug-in

12. 12 v1.6 08/02/2006 Select New Remote Site

13. 13 v1.6 08/02/2006 Fill in the Dialog Box On the New Update Site dialog enter the name of the update site and URL. Use the following values: Name: Subversive URL: for Subversive 1.1.x: http://www.polarion.org/projects/subversive/download/1.1 /update-site/ for Subversive 1.0.x: http://www.polarion.org/projects/subversive/download/up date-site/ http://www.polarion.org/projects/subversive/download/1.1 /update-site/ http://www.polarion.org/projects/subversive/download/up date-site/ Click on the OK button to store update site information.

14. 14 v1.6 08/02/2006 Select Subversive To start searching the update sites, select Subversive and click on the Finish button.

15. 15 v1.6 08/02/2006 Installing Subversive Features You will then be asked to select the features to install. It is safe to install all features. (If you want to save disk space, see the discussion at http://www.polarion.org/ind ex.php?page=installation& project=subversive#notes

16. 16 v1.6 08/02/2006 License Agreement Accept the terms of the license agreement.

17. 17 v1.6 08/02/2006 Install Features Then install the features.

18. 18 v1.6 08/02/2006 Install Features, cont. Install the feature, despite the warning.

19. 19 v1.6 08/02/2006 Restart for Safety I suggest you restart Eclipse

20. 20 v1.6 08/02/2006 Configure Subversive After installation, choose Help > Software Upgrades > Manage Configuration

21. 21 v1.6 08/02/2006 Select Subversive Team Provider Click to open “Eclipse SDK”; then select SVN Team Provider.

22. 22 v1.6 08/02/2006 Connecting with Subversive Select Window > Open perspective > Other

23. 23 v1.6 08/02/2006 Select “Subversion Repository Exploring”

24. 24 v1.6 08/02/2006 Click “New Repository Location”

25. 25 v1.6 08/02/2006 Select a Repository Give the URL, user-ID, and password, then click “Finish”.

26. 26 v1.6 08/02/2006 Expand the Repository Click on the name of the repository to expand it

27. 27 v1.6 08/02/2006 Check out the Project Right- click on the name of the project to check it out.

28. 28 v1.6 08/02/2006 Project Checked Out The project at the top of the pane was checked out.

29. 29 v1.6 08/02/2006 Modify a Class

30. 30 v1.6 08/02/2006 Committing Changes Save the file, then right-click on the filename and choose Team > Commit

31. 31 v1.6 08/02/2006 Subversion » Conflicts A conflict occurs when  you have locally modified a resource  for which a more recent revision is available  in the branch in the repository. 3 methods to resolve conflicts:  Discard local copy by overwriting it with the newer version on the repository.  Overwrite the copy on the repository with the local copy.  Use extreme caution since you will be erasing changes made by others.  Merge your work and the repository resource, saving locally the merged resource.

32. 32 v1.6 08/02/2006 CVS » Conflicts Conflict types:  An auto-mergeable conflicting change occurs when an source-code file  has been changed both remotely and locally (i.e. has non- committed local changes)  but the changes are in different lines.  A non-auto-mergeable conflicting change occurs when  one or more of the same lines of a source-code file have been changed or  when a binary file has been changed both remotely and locally. Binary files are never auto-mergeable.

33. v1.6 08/02/2006 Introduction to NetBeans v 5.0 Integrated Development Environment

34. 34 v1.6 08/02/2006 Lecture Overview NetBeans Overview Installing and Running NetBeans NetBeans Projects Building and Running Java Classes Building Running Web Applications Refactoring Applications

35. 35 v1.6 08/02/2006 Lecture Road Map NetBeans Overview  Introduction to NetBeans  Features NetBeans Projects Installing and Running NetBeans Building and Running Java Classes Building and Running Web Applications Refactoring Applications

36. 36 v1.6 08/02/2006 NetBeans Overview » Introduction to NetBeans A comprehensive, modular Java-based IDE (Integrated Development Environment). Free and open-source based.  Open source since June 2000  Large community of users and developers Provides a platform for building rich-client Java applications, Web applications, Web services etc. Supports plug-in architecture. Large set of third-party modules (plug- in’s) are included in the downloadable version.

37. 37 v1.6 08/02/2006 NetBeans Overview » Features Ant-based project system  Apache Ant is a Java-based build tool used to standardize and automate build and run environments for development.  It is not necessary to know Ant to work with the IDE.  See http://ant.apache.org/resources.html for more information on Ant.http://ant.apache.org/resources.html Matisse GUI Builder - provides rich framework of windows, menus, toolbars and actions. Plug-in (module) and rich client application development wizard. CVS version control. Enhanced Refactoring.

38. 38 v1.6 08/02/2006 NetBeans Overview » Features Enterprise Development  JBoss 4 and Weblogic 9 Support. Developer Collaboration  Discuss/share code with other developers remotely.  Conduct code review using chat capabilities.  Allow others to make changes which are then represented to the rest of the group via visual cues.  Send messages in plain text, XML, HTML, or Java code format. Application Profiling  CPU performance profiling  Memory profiling and memory leak detection

39. 39 v1.6 08/02/2006 Lecture Road Map NetBeans Overview Installing and Running  Where to get NetBeans?  Installing NetBeans  Running NetBeans NetBeans Projects Building and Running Java Classes Building and Running Web Applications Refactoring Applications

40. 40 v1.6 08/02/2006 Installing and Running NetBeans » Where to get NetBeans ? http:// www.netbeans.org provides downloads, articles and tutorials related to NetBeans. http:// www.netbeans.org IDE can be downloaded from http://www.netbeans.info/downloads/index.php http://www.netbeans.info/downloads/index.php

41. 41 v1.6 08/02/2006 Installing and Running NetBeans » Installing NetBeans NetBeans is available for Windows, MacOS, Linux and Solaris operating systems. Choose the NetBeans IDE 5.5.1 installer for the operating system that is installed on your development system. For Windows operating system, download the IDE 5.5.1 installer ‘netbeans-5_5_1-windows.exe’. Prior to NetBeans installation, make sure JVM (Java Virtual Machine) is installed. It is recommended that JDK 5.0 be downloaded from http://java.sun.com/j2se/1.5.0/download.jsp and installed. http://java.sun.com/j2se/1.5.0/download.jsp Execute the NetBeans self-extracting installer to start NetBeans installation. Follow the install shield instructions.

42. 42 v1.6 08/02/2006 Installing and Running NetBeans » Running NetBeans On Windows XP, choose Start » All Programs » NetBeans 5.0 » NetBeans IDE to launch NetBeans IDE.

43. 43 v1.6 08/02/2006 Lecture Road Map NetBeans Overview Installing and Running NetBeans NetBeans Projects  About Projects  Project Templates Building and Running Java Applications Building and Running Web Applications Refactoring Applications

44. 44 v1.6 08/02/2006 NetBeans Projects » About Projects A project is a group of source files and the settings with which you build, run, and debug those source files. The NetBeans IDE stores all of the information about a project in an Ant script, a properties file, and a few XML configuration files. The IDE includes support for two types of projects:  Standard Projects: The IDE uses a NetBeans-generated Ant build script to build, run, clean, test, and debug your application.  Free-form Projects: The IDE uses targets in an existing Ant script to build, run, clean, test, and debug your application.

45. 45 v1.6 08/02/2006 NetBeans Projects » Project Templates The IDE includes several project templates designed to support different types of development including Web applications, general Java applications, and so forth. Standard Templates: The IDE controls all source and classpath settings, compilation, running, and debugging. The IDE generates an Ant script in which all project settings are stored.  Standard Java Applications: Java Application, Java Class Library, Java Project with Existing Sources.  Web Applications: Web Application, Web Application with Existing Sources.  Enterprise Applications: Enterprise Application, Enterprise Application with Existing Sources.  EJB Modules: EJB Module, EJB Module with Existing Sources  NetBeans Plug-in Modules: Module Project, Module Suite Project, Library Wrapper Module Project. Free-Form Project Templates: The IDE relies on an existing Ant script for instructions on how to compile, run, and debug applications.  Java Project with Existing Ant Script: A free-form Java project.  Web Project with Existing Ant Script: A free-form project containing a web application.  EJB Module with Existing Ant Script: A free-form project containing an Enterprise JavaBeans module.

46. 46 v1.6 08/02/2006 Lecture Road Map NetBeans Overview Installing and Running NetBeans NetBeans Projects Building and Running Java Applications  Setting up a Project  Creating and Editing Java Source Code  Compiling, Running and Debugging a Project  Testing with JUnit Building and Running Web Applications Refactoring Applications

47. 47 v1.6 08/02/2006 Java Applications » Setting up a New Project From the main menu, choose File » New Project. This opens up the New Project window. In Categories pane, select General. In Projects pane, select Java Application and click Next.

48. 48 v1.6 08/02/2006 Java Applications » Setting up a New Project Enter the name of the project in the Project Name text box. Choose a folder for the Project Location. Ensure that Set as Main Project and Create Main Class checkboxes are checked. Enter the fully qualified name of the main class (without the.java extension) in the text box adjacent to the Create Main Class checkbox. The class name may be qualified with a package name and a dot (for example, mypackage.MainClass). Click Finish.

49. 49 v1.6 08/02/2006 Java Applications » Setting up a New Project The project will be displayed in the Projects window. The Java file that contains the skeleton code for the main class opens in the Source Editor. Expand the project name (a.k.a. project node) in the Projects window to view the Java files that belong to the project.

50. 50 v1.6 08/02/2006 Java Applications » Setting up a New Project Click on the Files tab to view the project’s file structure in the Files window.

51. 51 v1.6 08/02/2006 Java Applications » Setting up a New Project » Project Properties Right-click on the Project node in the Projects window. This will open the Project Properties window. In Categories pane, click on Libraries. Click Manage Platforms button to specify a different JDK platform. Compile-time and run-time class paths may be specified using the Compile tab and the Run tab respectively.

52. 52 v1.6 08/02/2006 Exercise 1 Create a New Java Application Project titled EgApp with a main class titled MainClass in a new package titled csc517.

53. 53 v1.6 08/02/2006 Lecture Road Map NetBeans Overview Installing and Running NetBeans NetBeans Projects Building and Running Java Applications  Setting up a Project  Creating and Editing Java Code  Compiling, Running and Debugging a Project  Testing with JUnit Building and Running Web Applications Refactoring Applications

54. 54 v1.6 08/02/2006 Java Applications » Creating and Editing Java code In this module, you will learn how to  Create a new class  Navigate a Project node  Add a new method to a class  Create a new field to a class  Use editing shortcuts

55. 55 v1.6 08/02/2006 Java Applications » Creating and Editing Java code » Creating a new Java class To create a new Java class, right-click on the project node in the Projects window and choose New » Java class. The New Java Class window will be displayed. Enter the name of the new Java class in the Class Name text box. If the new class needs to be part of a package, type the name of a new package in the Package text box or choose an existing package from the drop-down list. Click Finish. The IDE generates the skeleton source code of the new Java class and opens it up in a new Java source window.

56. 56 v1.6 08/02/2006 Java Applications » Creating and Editing Java code » Navigating the project node In the Projects window, expand Source packages node under the Project node to view the package nodes and Java file nodes. Expand the Java file node to view the classes defined in the Java file. Double-click on the Java file to open the Java file in the Source editor. Expand the class node to view the fields, constructors and methods of the class.

57. 57 v1.6 08/02/2006 Java Applications » Creating and Editing Java code » Adding a new method to a class Right-click on the Methods node of the class and click Add Method to create a new Java method. This opens up the Add New Method window. The Name, Return Type, Access, Modifiers and Parameters of the new method may be specified in the Add New Method window.

58. 58 v1.6 08/02/2006 Java Applications » Creating and Editing Java code » Adding a new field to a class Right-click on the Fields node of the class and click Add Field to add a new field. This opens up the Add New Field window. The Name, Type, Access, Modifiers and Initial Value of the field may be specified in the Add New Field window.

59. 59 v1.6 08/02/2006 Java Applications » Creating and Editing Java Source Editing Shortcuts:  Ctrl+Shift+F: Reformat the whole source code window.  Ctrl+Space: Code-completion box. (The IDE offers code completion for all classes and methods in the project's compilation classpath).

60. 60 v1.6 08/02/2006 Exercise 2 Create a new class titled NewClass and add it to the package csc517 in the project EgApp you have created in Exercise 1. Add a private integer field (member variable) mVar to the class NewClass. Change the default constructor to accept integer parameter to initialize the private integer field mVar. Add a public method printField that takes no parameters and returns void. Add code to the printField method to print the value of the private variable mVar to standard output. (Hint: To use code-completion feature for the print routine, type “sys” and hit Ctrl-Space. The IDE pops-up the code completion box with a list of methods. Choose System.out.println() print routine).

61. 61 v1.6 08/02/2006 Lecture Road Map NetBeans Overview Installing and Running NetBeans NetBeans Projects Refactoring Applications Building and Running Java Applications  Setting up a Project  Creating and Editing Java Source Code  Compiling, Running and Debugging a Project  Testing with JUnit Building and Running Web Applications

62. 62 v1.6 08/02/2006 Java Applications » Compiling, Running and Debugging a project In this module, you will learn how to  Build a Java project  Run a Java project  Debug a Java project

63. 63 v1.6 08/02/2006 Java Applications » Compiling, Running and Debugging a Project » Building a Project Choose Build » Build Main Project (F11) from the main menu to build (compile) a project. Choose Build » Clean and Build Main Project (Shift+F11) from the main menu to clean and build a project Alternatively, right-click on the project node in the project window and click Build Project or Clean and Build Project from the contextual menu. The Output window displays the build results.

64. 64 v1.6 08/02/2006 Java Applications » Compiling, Running and Debugging a Project » Running a Project Choose Run » Run Main Project (F6) from the main menu to run a project. Alternatively, right-click on the project node in the Project window and click Run Project from the contextual menu. The Output window displays the project output.

65. 65 v1.6 08/02/2006 Java Applications » Compiling, Running and Debugging a project » Debugging a project To set a breakpoint, place the caret in any of the methods in the Java file and press Ctrl+F8. The selected line will be highlighted indicating that the breakpoint has been set. Choose Run » Debug Main Project (F5) from the main menu to debug the project. The IDE runs the project in the debugger until the breakpoint is reached. The IDE open the Debugger windows at the bottom of the IDE.

66. 66 v1.6 08/02/2006 Java Applications » Compiling, Running and Debugging a Project » Debugging a Project To step over a line of code, choose Run » Step Over (F8) from the main menu. To step into a method, choose Run » Step Into (F7) from the main menu. To step out of a method, choose Run » Step Out (Ctrl + F7) from the main menu. To terminate a debugging session, choose Run » Finish Debugger Session (Shift+F5).

67. 67 v1.6 08/02/2006 Java Applications » Compiling, Running and Debugging a Project » Debugging a Project » The Local Variables, Watches, and Call Stack windows open by default with every debugging session. You can open any debugger window by choosing Window » Debugging » window-name (for example, Window » Debugging » Breakpoints). Debugger Windows

68. 68 v1.6 08/02/2006 Java Applications » Compiling, Running and Debugging a Project » Debugging a Project » Local Variables Window  The Local Variables window lists the local variables in the current call.  The information given for each variable includes the variable name, type, and value.  You can click the control to the left of the name to expand or collapse the variable. Call Stack Window  The Call Stack window lists the sequence of calls made during execution of the current thread.  The information given for each call includes the name of the method, followed by the filename and line number of the call's currently executing statement. Debugger Windows

69. 69 v1.6 08/02/2006 Java Applications » Compiling, Running and Debugging a Project » Debugging a Project » Watches Window  The Watches window lists all variables and expressions that you have specified to watch while debugging.  The information given for each watch includes the variable or expression name, type, and value.  When you add a new variable or expression to the Watches window, the value of the variable or expression is immediately evaluated and displayed.  The value of a watch is based on the current context. As you move through your program code, the Watches window is updated to show the value of the watch for that context.  Creating a Watch:  Select the variable or expression in the Source Editor, right-click, and choose New Watch (Ctrl+Shift+F7).  The New Watch dialog box opens with the variable or expression entered in the text field. Click OK.  The Watches window opens with the new watch selected. Debugger Windows

70. 70 v1.6 08/02/2006 Java Applications » Compiling, Running and Debugging a Project » Debugging a Project » Classes Window  The Classes window displays the hierarchy of all classes that have been loaded into the virtual machine hosting the program that is being debugged.  You can click the turner control (+) to the left of the class name to expand or collapse the class.  You can inspect the fields, constructors, and methods in your program as well as inspect the value of static variables. Breakpoints Window  The Breakpoints window lists the breakpoints set in the current project.  By default, each entry contains a short text description of the breakpoint and a boolean flag indicating whether the breakpoint is enabled or disabled. Debugger Windows

71. 71 v1.6 08/02/2006 Java Applications » Compiling, Running and Debugging a Project » Debugging a Project » Session Window  The Sessions window lists the debugging sessions currently running in the IDE.  The information given for each session includes the session name and state.  One session is always considered the current session, unless no sessions are running.  By default, the current session is the session that you most recently started. Threads Window  The Threads window lists all threads in the current debugging session.  For Java applications, this list also includes the thread groups in the Java virtual machine.  The information given for each thread is the thread name and state. Debugger Windows

72. 72 v1.6 08/02/2006 Exercise 3 In the project EgApp, based on the class NewClass that was created in Exercise 2, instantiate an object of type NewClass in the main() routine of the MainClass. Call the printField routine of the NewClass object. (Use the code-completion feature of the IDE.) Build (compile) the project EgApp. Run the project EgApp. What do you see in the output window ?