NBSVNQuickStart

NetBeans and Subversion - A Quick Start Guide

Introduction:

Subversion is arguably the most popular version control system as of now. No wonder NetBeans has very good support for Subversion. I personally feel that a java developer must be familiar with both these tools. This article shall help you to get started with both these tools.

Objectives:

- To create a simple java project in NetBeans.

- To import the java project into the subversion repository.

- To commit the changes made in a java source file.

- To view the revision history of a java source file which was changed.

- To rollback to the previous revision of the java source file.

Requirements:

- NetBeans 6.1

- Subversion

- TortoiseSVN

- Though not mandatory, but a basic knowledge of subversion concepts.

Step 1:

Create a new "Java Application" project called "SimpleLogin".

File:Figure1_NBSVNQuickStart.jpg

Step 2:

Create a new JFrame called "LoginFrame" under the package "org.example.simplelogin" and add the necessary components as shown below.

File:Figure2_NBSVNQuickStart.jpg

Step 3:

Name the swing components accordingly.

File:Figure3_NBSVNQuickStart.jpg

Your application should like this now on preview:

File:Figure4_NBSVNQuickStart.jpg

Step 4:

Create a java class named "LoginService" under the package "org.example.simplelogin".

File:Figure5_NBSVNQuickStart.jpg

Step 5:

Add the following code to the LoginService class.

File:Figure6_NBSVNQuickStart.jpg

Here we are defining a simple method which shall return true if the username is "guest" and the password is "password".

Step 6:

Now open "LoginFrame.java" and add the following methods.

File:Figure7_NBSVNQuickStart.jpg

The above methods are self explanatory. We are just doing a simple validation and calling the login method we defined previously in the class LoginService.

Step 7:

Now double click the login "button" in the design mode of LoginFrame.java to create the event handling method named "loginButtonActionPerformed". Add the following code to call the "performLogin" method.

File:Figure8_NBSVNQuickStart.jpg

That's it.

Step 8:

Run the project.

If you enter the username as "guest" and password as "password", you will get an output like this.

File:Figure9_NBSVNQuickStart.jpg

Otherwise, you will be getting an output like this.

File:Figure10_NBSVNQuickStart.jpg

Ok, our simple login application is ready for prime time :-). Now let us import this project into a subversion repository.

Step 9:

Create an empty folder called "MyRepository" in a preferred location.

File:Figure11_NBSVNQuickStart.jpg

Step 10:

Create a subversion repository in the empty "MyRepository" folder as mentioned below, by right clicking anywhere inside the windows explorer.

File:Figure12_NBSVNQuickStart.jpg

Accept the default option (FSFS) in the "Create Repository" window.

File:Figure13_NBSVNQuickStart.jpg

That's it. Your repository should be ready when you press "OK" and it should look something like this.

File:Figure14_NBSVNQuickStart.jpg

Step 11:

Let us import the NetBeans project we have created into the subversion repository. Right click the NetBeans project we have created and then click "Versioning -> Import into Subversion Repository".

File:Figure15_NBSVNQuickStart.jpg

NetBeans will prompt you with a window. Enter the path of your repository as shown below.

File:Figure16_NBSVNQuickStart.jpg

Click the "Next" button and enter the "Repository Folder" name into which you would like to import your project. To make things simple, let us enter our NetBeans project name itself as the "Repository Folder" name. Also enter a small description about this import activity as shown below. File:Figure17_NBSVNQuickStart.jpg

We are almost there. Click the "Next" button and the IDE will show a window like this.

File:Figure18_NBSVNQuickStart.jpg

Accept the default entries and click "Finish". Congratulations! you have imported your project successfully into the subversion repository.

Right click anywhere in your desktop/windows explorer and click "TortoiseSVN -> Repo-Browser" and then enter the path of your subversion repository. You can see all your project files sitting comfortably inside the subversion repository. :-)

File:Figure19_NBSVNQuickStart.jpg

Step 12:

Let us play around with some more cool subversion integration features offered by NetBeans. Open the class "LoginService.java" and change the value of "DUMMY_PASSWORD" from "password" to "guest".

File:Figure20_NBSVNQuickStart.jpg

You can see the IDE markup a blue shade near the line you made the change. This indicates that your source file has got something different than the version in the repository. You can also note that the IDE change your java source file name's font-color to blue.

File:Figure21_NBSVNQuickStart.jpg

Let us turn our focus to the editor window again. Click the blue stripe shown by the IDE near the place where you made changes to the source file. The IDE will popup a small hint-window.

File:Figure22_NBSVNQuickStart.jpg

You can see the previous value of the DUMMY_PASSWORD there. The IDE also provides you a set of buttons to revert back the changes or to have a "diff" view on the changes made. Let us explore the "diff' functionality of the IDE first by clicking the "diff" button.

File:Figure23_NBSVNQuickStart.jpg

The IDE will display the "diff" view of the "working copy" and the "HEAD" revision (the latest committed version) in the repository.

File:Figure24_NBSVNQuickStart.jpg

From the above figure, you can see the current and previous value of the string DUMMY_PASSWORD. Now you can revert back to the old value of "DUMMY_PASSWORD" by clicking the replace button (displayed like an arrow)

File:Figure25_NBSVNQuickStart.jpg

When you press the "replace" button, the IDE will replace the "current" value with the "original" value.

File:Figure26_NBSVNQuickStart.jpg

The "diff" view provided by the IDE will be very useful to examine and compare the changes made to the "working copy" alongwith the option to revert back to the original version in the repository. But if all you need is to quickly revert back some change to the original version in the repository, you can click on the blue strip in the source code and click the "revert" button.

File:Figure27_NBSVNQuickStart.jpg

That's cool, right?

Step 13:

Enough playing. Now let us commit the changes we made in our source file. Ensure that the source file you are willing to commit is in focus and click the menu "Versioning -> Commit"

File:Figure28_NBSVNQuickStart.jpg

When you click the "Commit" menu item, the IDE will prompt you with a window to enter the "message" for this commit operation. Enter a commit message and click the "Commit" button.

File:Figure29_NBSVNQuickStart.jpg

Step 14:

Let us explore the history of our source file and see the the changes we made all along. Click the "Versioning -> Search History" menu.

File:Figure30_NBSVNQuickStart.jpg

The IDE will display all the versions of the source file.

File:Figure31_NBSVNQuickStart.jpg

In the "Search History" window, the IDE offers two views, "summary" view and "diff" view. By default, the IDE displays the "summary" view. The "diff" view contains more information.

File:Figure32_NBSVNQuickStart.jpg

You can straightaway "revert" or "rollback" to previous revisions just by right clicking a particular revision.

File:Figure33_NBSVNQuickStart.jpg

Conclusion

In this tutorial you learned how to import a netbeans java project into subversion repository and commit your changes into the repository. You also learned about the various subversion features offered by the IDE like the "inline diff", "revert", "search history" etc.

Not logged in. Log in, Register

By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2012, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo