Notes on Java Tools

• Download TextPad.
  • Follow the instructions.
• Download J2SE 1.5 (if you have 1.4, you're fine).
  • Follow the instructions.
• Download Ant
  • create directory C:\local
  • unzip to C:\local
  • rename C:\local\apache-ant-?.?.? to C:\local\apache-ant
  • edit PATH variable; add C:\local\apache-ant\bin
  • create JAVA_HOME variable; value C:\Program Files\Java\jdk1.5.0
• Download Junit
  • unzip to C:\local
  • rename C:\local\junit?.?.? to C:\local\junit
  • create CLASSPATH variable; value .;C:\local\junit\junit.jar
• To run ant/junit:
  • create a directory (say C:\Documents and Settings\me\My Documents\hw-01)
  • create a subdirectory, called source (C:\Documents and Settings\me\My Documents\hw-01\source)
  • Place the build.xml and build.properties files from homework 1 in the directory C:\Documents and Settings\me\My Documents\hw-01
  • Place the source code (.java) files in C:\Documents and Settings\me\My Documents\hw-01\source
  • Start a DOS window: go to the start menu and select "run". In the dialog box type cmd and enter.
  • At the DOS prompt move to the correct directory (type cd C:\Documents and Settings\me\My Documents\hw-01)
  • At the DOS prompt, run ant (enter ant).
  • You can run ant by entering ant -find in any subdirectory of C:\Documents and Settings\me\My Documents\hw-01.
• See a few slides ahead for advice on integrating ant into textpad.

Optional. If you want a command line version of Junit, try the following:

• create directory C:\local\bin
• edit PATH variable; add C:\local\bin
• create file C:\local\bin\junit.bat with the following contents:

  --BEGIN FILE CONTENTS-----------------------------------------------------
  @echo off
  java junit.swingui.TestRunner "%1" "%2" "%3" "%4" "%5" "%6" "%7" "%8" "%9"
  --END FILE CONTENTS-------------------------------------------------------
              

For example, this is how you change the JAVA_HOME variable for Java 1.5

start |
  settings |
    control panel |
      system |
        advanced |
          environment variables |
            system variables |
              new | (or modify)
                Variable Name: JAVA_HOME
                Variable Value: C:\Program Files\Java\jdk1.5.0

The settings I use are:

JAVA_HOME  C:\Program Files\Java\jdk1.5.0
CLASSPATH  .;C:\local\junit\junit.jar
PATH       (...);C:\local\apache-ant\bin;C:\local\bin

Do not delete anything from the PATH variable. Simply add the entry for ant to the end.

In older versions of windows, you can set your system variables permanently by adding lines to the end of c:\autoexec.bat and restarting your computer. For example:

set PATH="%PATH%;C:\local\apache-ant\bin;C:\local\bin"

If DOS gives you the error "Out of environment space", then apply the solution found here: http://support.microsoft.com/default.aspx?scid=KB;EN-US;Q230205&

If you are still having trouble, make directory names seven characters or less. For example, rename "c:\local\apache-ant" to "c:\local\ant".

In order to open the zip files, use WinZIP

Tom Wilczak has advice for using ant with textpad:

• First get all your environment variables set--if you are able to run Ant from the command line you should be fine.
• In TextPad, select Configure -> Preferences then highlight Tools
  • Click the add button, and select DOS command
  • Enter "ant -find" in the Command field
  • Click the apply button.
• In the left pane, expand "Tools" and highlight "ant -find"
  • Make sure that the 'capture output' and 'save all documents first' options are selected. You may also want to select 'Prompt for parameters', as this will allow you to run the other ant targets besides the default project build (ie: Ant clean, ant test, etc.)
  • Enter the following in the 'Regular Expression to Match Output' field:

    ^[ \t]+\[javac\] \([A-Za-z]:[^:]+\):\([0-9]+\):
    

  • Set the File Register to 1, and the Line Register to 2.
  • Click the apply button.

To run Ant, select it from the "Tools" menu while editing any project source file. The build.xml file may be in the same directory, or any ancestor directory.

To jump to the offending line on a compiler error, double click the second line of the error message. This works only for compiler errors and not for failed tests.

You can also configure the tools to run from your choice of keyboard shortcuts by selecting the Keyboard option in the preferences box, and selecting tools. The rest should be self explanatory.

You can also run ant/junit by doing the following:

• make a directory called "util" in the same directory with build.xml
• Copy http://www.csd.uoc.gr/~hy252/assignments/antjunit.jar and http://www.csd.uoc.gr/~hy252/assignments/ant.bat into the util directory.
• Edit the local copy of ant.bat to suit your system.
• Run util\ant.bat

Comments on OSX from WILLIAM PETULLO

An Ant/JUnit environment may be installed on Apple's Mac OS X using the Fink[1] project. Here are the basic steps:

• Ensure you have Xcode 1.5[2] installed. http://developer.apple.com/tools/macosxtools.html
• Install the fink package management system. http://fink.sourceforge.net/
• Configure fink to install the latest, unstable packages.
• Use fink to install the junit, ant and ant-junit packages.

Once installed, ant may be used from the command line just like with any other operating system.

Comments from Andrew Close:

Here's how to install ANT and JUnit on OS X:

1) download ANT & JUnit (they should auto unstuff themselves)

2) copy/move the ANT directory to /Developer/Java/J2EE

3) copy/move the JUnit directory to /Developer/Java/J2EE

4) create symlink for ANT: ln -s apache-ant-1.6.2 Ant

5) create symlink for JUnit: ln -s junit3.8.1 junit

6) update environment variables (I use bash, if you use another shell
   then update accordingly).

   in .bash_profile:

   export JAVA_HOME=/Library/Java/Home
   export ANT_HOME=/Developer/Java/J2EE/Ant
   export JUNIT_HOME=/Developer/Java/J2EE/junit
   export PATH=$PATH:$ANT_HOME/bin:

7) reset your shell: . .bash_profile

8) check your environment variables: env <enter>

9) test:
   $ java -version <enter>
     --> you should get your java version (should already be installed)
   $ ant -version <enter>
     --> you should get your ant version

10) to test JUnit change directories to where your homework assignment
    is.  the directory with a build.xml file that calls JUnit to be
    specific.

11) type: ant <enter>

12) project should build and tests should run...

this article might be a bit better than the instructions above: http://www.macdevcenter.com/pub/a/mac/2003/10/03/ant.html

and here's one that tells users how to integrate ANT with xCode: http://www.macdevcenter.com/pub/a/mac/2004/06/01/osx_java.html

Revised: 2004/10/05 16:29

This page is valid xhtml 1.0.