Setting up Netbeans

This page describes how to set up Sockso with Netbeans.

Creating the Project

After you have cloned the Git repository, open Netbeans and choose to create a new project from existing sources.

Next, enter the name for the project (probably 'Sockso'), and choose the directory that you cloned the repository in.

NOTE: You will probably get an error here about the build.xml file already existing (Sockso uses its own, not Netbeans standard one) - so you will need to temporarily rename build.xml to something else. But name it back when we have passed this step!

Then add the main source code folders...

And just click Finish, you don't need to go on to the next step, and your project should be created for you...

The first thing you'll see is lots of errors on the packages like in the screenshot below. This is because we haven't told Netbeans about all the dependencies yet, so right click the Sockso project and select the Properties option from the menu.

Then we can go to the Libraries tab on the left side, and then click the button labelled Add JAR/Folder.

We then need to add all the .jar files from the following folders...

• lib/dev (development)
• lib/opt (optional)
• lib/std (standard runtime libraries)

Missing Classes

After this most of the errors will have gone, but you may still see errors about missing template classes like in the screenshot below...

These classes (along with Sockso.java) are created when you build Sockso, so go to the shell, change to the Sockso directory and run the compile Ant target. (You can also do this from within Netbeans if you have the Ant plugin)

$> ant compile

The reason you need to do this is because all Sockso's output templates are written using the Jamon templating engine (ie. all the .jamon files), which are converted to Java classes and then compiled into Sockso. So running the compile target as above will do all this.

Normally though you won't run the compile target directly, you'll usually just use run