Core Java

Setup your Java Development Environment in Windows 7

I have been receiving a lot of requests over the time, from students and people willing to experiment with the Java language, on providing a simple guide on how to setup a Java development environment , similar to the one I’ve written a year ago for Mac users. See here and here. So, this post is mainly addressed to people new to Java development, that seek information about setting up their Windows (7 or similar) environment, with all the basic tools and settings, in order to start writing Java code and experiment with various tools and technologies in the Java ecosystem.

I am pretty sure there are numerous similar resources out there, I just thought to add one more. Hope you find it handy. It is really easy, so don’t be afraid of the this post’s size, I just tried to elaborate on some simple steps, but for sure it is not rocket science

and you don’t have to be a ‘hacker’ in order to complete all the steps. You may not need all the tools below, so it is not necessary to have them all installed at once.

Index

1. Setup Java JDK and JAVA_HOME (this is a must)
2. Setup Apache Ant and ANT_HOME (optional)
3. Setup Apache Maven and MAVEN_HOME (optional)
4. Setup SVN (subversion) support, using TortoiseSVN (optional)
5. Setup Git using Git Extentions (optional)
6. Setup a Java IDE, Netbeans or Eclipse (this is a must)

1. Setup Java JDK and JAVA_HOME

I assume that you have not installed any related tool before, and your system is ‘clean‘ from Java and other Java development tools. So I guess, if you open a Command Prompt and you type ‘java -version’ you will get something like the following.

We need to install the Java Development Toolkit aka JDK, which is bundled with the Java Runtime Environment. At this moment, that I am writing this post the latest JDK versions is JDK 7u17 (update 17 that is). All you have to do is head to the main download page provided by Oracle (here) , and download the latest version that you will find. The direct link for the JKD 7u17 is here.Start the installer and go through the steps.

Tip: One small tip or let’s say a deviation from the installer that I prefer, is to change the installation path provided by the program to something easier to remember or even type in the command line tool. So instead of installing the JDK to ‘C:\Program Files\Java\jdk7_17‘ etc, i always choose something that looks like the following, ‘C:\Java\jdk17‘.

I do the same when the installer prompts me to install the JRE (java run time) and I provide the following path ‘C:\Java\jre7‘. When it is complete, I open a new command line and I re-type ‘java -version‘ as before. As you can see the installer has already done a good job and I have java in my environment. (You may use the ‘where‘ command to find out which executable is loaded on the Path – (similar to ‘which‘ in Unix) ).

We are almost there, we just need to set, one more environment variable, that is very important by many tools that are based on Java or require Java to work. It is the famous JAVA_HOME variable and you must have heard it or seen it in various tutorials and setup resources. It is easy though! Open your Advance System Settings ( Press Start , type in the search box ‘View Advanced System Settings‘, open it, select the tab ‘Advanced‘ and press the button in the bottom called ‘Environment Variables’). Add a new system variable as it is illustrated below. The name is JAVA_HOME and the path is actually the path our JDK installation, in my case ”C:\Java\jdk17‘.

Press OK, and open a new Command prompt ( it is required). Type ‘echo %JAVA_HOME%‘ and you are done.

Congrats you have successfully set up the java run time and the jdk environment! Let’s move on.

2. Setup Apache Ant and ANT_HOME

Apache Ant is a popular build tool used in many Java projects and it is still needed in many cases when you need to setup some servers or complex projects. You can find more about Ant here. Installing Ant is easy, there is no fancy installer just a zip file you need to extract somewhere and add a similar varible like JAVA_HOME (see above) called ANT_HOME. At the time being, the latest version of Apache Ant is, 1.8.4. and can be downloaded here. After downloading the zip file, I choose to extract the contents to a similar path like before ‘C:\ant184‘. (make sure that c:\ant184 is the root folder and then you have all the sub-folders like c:\ant184\bin’. So, now we must set our ANT_HOME variable and add the ‘ant’ executable to our windows Path so that we can invoke it in our command line by typing ‘ant’. Setting ANT_HOME is similar to JAVA_HOME, add a new system variable named ANT_HOME and value the path where you have the ant zip extracted in my case ‘C:\ant184‘. See below

In order to add the ‘ant’ command to our executable path we need to update the PATH system variable, in the very same window, as illustrated below, just hit ‘Edit’. Go to the end of the line and add a new entry (all the entries are separated with ‘;’ ). The path for the ant executable is ‘C:\ant184\bin‘ but we will use the ANT_HOME variable in order to be more flexible so we will add, %ANT_HOME%\bin”. See the image below.

You are done, open a new Command Prompt, and type ‘ant -version‘, or ‘echo %ANT_HOME%‘ you should get similar results are illustrated in the image below.

Congrats, you have successfully installed Apache Ant! Some Java IDE’s have Apache Ant already pre-bundled (as we will see in a later section) but I truly believe it is better to be installed manually,it is cleaner and easier to maintain, update.

3. Setup Apache Maven and MAVEN_HOME

Apache Maven is very popular tool among java developers, it does many things and has many uses. It is a building tool, a library dependency tool, a software project management and comprehension tool as it is indicated in the tool’s site. You may find more about maven here. The installation of maven is similar to Apache’s Ant, just a zip extracted somewhere and setting up a couple of variables + updating the system path. The latest version at the moment is 3.0.5 and can be downloaded here. There is already a short and handy setup guide provided in Maven’s site (see here), I am going to write similar steps. After downloading the zip file, I choose to extract the contents to a similar path like before ‘C:\maven305‘. (make sure that c:\maven305 is the root folder and then you have all the sub-folders like c:\maven305\bin’. So, now we must set our MAVEN_HOME variable and add the maven executable to our windows Path so that we can invoke it in our command line by typing ‘mvn‘. Setting MAVEN is similar to JAVA_HOME or ANT_HOME, just add a new system variable named MAVEN_HOME and value the path where you have the ant zip extracted in my case ‘C:\maven305‘.

See below.

In order to add the ‘mvn’ command to our executable path we need to update the PATH system variable like we did previously, in the very same window, as illustrated below, just hit ‘Edit’. Go to the end of the line and add a new entry (all the entries are separated with ‘;’ ). The path for the maven executable is ‘C:\maven305\bin‘ but we will use the MAVEN_HOME variable in order to be more flexible so we will add, %MAVEN_HOME%\bin”. See the image below.

You are done, open a new Command Prompt, and type ‘mvn -version‘, or ‘echo %MAVNE_HOME%‘ you should get similar results are illustrated in the image below.

Congrats, you have successfully installed Apache Maven 3!Some Java IDE’s have Apache Maven already pre-bundled (as we will see in a later section) but I truly believe it is better to be installed manually,it is cleaner and easier to maintain,use or update.

4. Setup Subversion (version control) using Tortoise SVN

Subversion is a popular versioning system among Java developers. You may find further information about it here. There are numerous subversion clients that you may install in your computer. The original subversion command line client can be found here (for windows). All of the Java IDE’s come with support of SVN either with pre-bundled clients or plug ins. I tend to use the clients offered by my IDE but I always want to have an extra client that gives me extra flexibility on certain things. I think that tortoise svn is an excellent choice for Windows users, it has full SVN support and excellent integration with the Windows file system.
You find the latest version of the client here, current is 1.7.11 (compatible with SVN 1.7.8). Download the executable and follow the steps. The only addition on the default settings is that I select to install the command line tools as well, as illustrated in the image below.

After completing the installation you can access Tortoise, using your right click in any folder, like the image below.

As I have already pointed out, most of the Java IDE’s around offer SVN integration, out of the box but is always a good thing to have an extra client, in your windows shell. Tortoise is a great one, you can actually work with tortoise and skip your IDE’s integration if you like so! If you don’t like Tortoise and you want to consider yet another client then I suggest you have a look on the free edition of SmartSVN.

5. Setup Git (version control) using Git Extentions

Git, is another version control system that is becoming very popular among developers in general. In many cases it is replacing SVN, so there is a high chance you might be required to work with it, or work in projects that store their code on a remote Git repository or contribute to an open source project at GitHub. You may find more about Git here.

Git is the new kid on the block on popular versioning systems, so some tools or support still may not be so user friendly comparing to tools and clients of SVN. Git is also encouraging users to interact with it, using the command line interface. The stand alone git installation for windows can be found here. This will install the git client and support tools and you may start experiments with it, using the command line. If you want a more UI friendly way, then you may choose one of the free clients. (so, don’t install the standalone client).

My choice at the time being is Git Extentions, which can be found here. The nice thing about Git Extentions is that with one download you get the native git client and all the nice UI tools, similar to Tortoise featured in the previous section. So you can just download the git extensions msi package, and follow the installer’s step – just make sure to enable (when you are prompted to do so) the mygit support. See the image below.

I have disabled any visual studio support, since i am not going to to install this particular IDE. On the next step, I select Putty to be installed as my ssh client.


On the related prompt of the Git installer, about altering your System’s Path, I always select the second one, so that the ‘git’ command is added to my command line exec path. See the image below.

Continue with the rest of the installation and the various tools installed. The provided, default selections are safe to use.

As you can see, by the end you are going to have the related icons, copied in your Desktop. Congrats you have full Git support on your development environment! Double click on the Git Extentions icons and set the final details like language of use and username / email to be used while interacting with git repositories.

6. Pick your Java IDE : )

Up until now we have installed a variety of tools towards setting up our Java Development environment. Since the JDK is already installed (from step one) we could actually jump to coding just by using our text editor of choice (NotePad++, TextPad, NotePad, Ultra Edit etc) and invoking the javac and java commands from the command line. It is good to know that this is an option but I would highly recommend you start doing your experiments using a real IDE, and there are a lot of them in the Java development world and are considered very very powerful.

Netbeans

If you are a total newbie and you have just started using or learning Java, then your first stop, according to my opinion should be Netbeans. It is one of the best Java IDE’s around, used by many professional java developers all around the world and is really targeting towards ease of use and productivity from the very beginning. You can find Netbeans (currently latest version 7.3) here. If you are about to work with some more advanced java stuff like the Java Enterprise edition (aka Java EE) then I think you should try downloading and install Netbeans with Java EE support and not the simple version. Upon installation it will prompt you about the bundled Java EE container (aka application server) that can install for you. My choice is GlassFish.

See the image below.


Continue with the rest of the installer prompts, your already existing JDK installation from step 1 should be picked accordingly by the setup script and be used by the IDE as well. The image below illustrates a fresh install of Netbeans running.

If you are looking for a quick guide or tutorial on using Netbeans, have a look here or have a look on numerous videos on youtube, here.

Eclipse

Eclipse is along with Netbeans, one of the most famous Java IDE’s in the whole Java development community. It’s user (installation base) might be larger comparing to Netbeans and is usually the IDE of choice for hard core Java developers. I am currently an Eclipse user as well, but I personally don’t find it a good fit for someone that is now starting to ‘play‘ with Java. There is a large community behind it, (as with Netbeans) numerous resources and support forums. It is not that hard, but if you are a new developer and you are still trying to make your way into basic stuff there is some possibility that you lose your way and get disappointed, something that we don’t want.

I don’t want the above paragraph to be the start of a flame war especially for hard cord eclipse users, I am actually an eclipse user myself, I just think that Netbeans is more ‘newbie’ user friendly, and it is critical that new java developers don’t get disappointed after trying to complete their first assignment or task in Java.The latest version of Eclipse currently is Eclipse 4.2 SR2 (codename Juno), and the downloads page can be found here. You can either select the Eclipse for Java or JEE developers download, depending on your assignments/tasks or interest. Eclipse does not pre- install any servers or support tools as such. All the extra functionality should be added afterwards through the Plugin system that offers. (See Eclipse Market place). Eclipse does not have any installer, it comes as a zip file, all you have to do, is download the zip and extract the contents (like we did with Ant, or Maven). I usually pick a simple folder, like in previous section e.g ‘C:\eclipseJuno42’ . Open the folder and you will find the executable (eclipse.exe). You should have something like the image below.
 

If you don’t like Netbeans, neither Eclipse, you may try another popular option, Idea IntelliJ, it can be found here.
 
 
Reference: Setup your Java Development Environment in Windows 7 from our JCG partner Paris Apostolopoulos at the Papo’s log blog.

Paris Apostolopoulos

Paris is a senior software engineer focusing on J2EE development, loves Business process modelling and is keen on software quality challenges. He is passionate about Java and Java communities. He is a co-founder and administrator of the first Java User Group in greece(JHUG.gr) and occasional speaker on meet-ups and seminars and regular blogger. For his contributions and involvement on the Java community he has been awarded the title of Java Champion in 2007 by Sun Microsystems.
Subscribe
Notify of
guest

This site uses Akismet to reduce spam. Learn how your comment data is processed.

13 Comments
Oldest
Newest Most Voted
Inline Feedbacks
View all comments
Gualtiero Testa
Gualtiero Testa
11 years ago

Thanks for the article. Quite similar to my Win7 environment. Let me add few points I can suggest:

– to create a folder container like c:APP for all tools (ant, maven,..). A sort of /opt as in Linux/Unix so you don’t clutter the root c:

– to install netbeans in c:… to avoid Windows protection rules for the c:Program Files. This will let Netbeans to auto-update without problems.

– to look for a console alternative to the horrible Windows command prompt window. I use Console (http://sourceforge.net/projects/console/) but there are other alternatives.

Gualtiero

Daniel Tyger
Daniel Tyger
10 years ago

I just want to commend you for the clear, unpretentious, and accessible article. This is one of the best I have encountered that ties all the pieces of a development setup with environment variables configuration in an easy-to-follow manner. Excellent screen shots and word flow. Nice tests and progress proofs along the way. I would recommend this to a wide range of development newbies. Thank you kindly for taking the time to author this for the wider world.

Paris Apostolopoulos
Paris Apostolopoulos
10 years ago
Reply to  Daniel Tyger

Thanks for your kind words :) happy to help

Rajesh Maddukuri
Rajesh Maddukuri
10 years ago

Thank you for your quick notes, it is very easy and help full for me to start up.

Casey
Casey
10 years ago

You did a great job with this! I have been programming in Java for sometime but haven’t had to set up an environment in at least a year. My laptop hard drive crashed on Wednesday and I just got it up and running this evening. Had to get my JDK and Eclipse on right away and needed a quick refresher on the system variable. Thanks for the clear and concise directions! Just a note – if a person doesn’t close out of their terminal after experimenting with the initial command about determining if installed/locating Java they won’t have success with… Read more »

Cameron
Cameron
10 years ago

Thanks for uploading this article, I’ve only just started programming, and this has helped me a lot.

Naveen
Naveen
10 years ago

Thanks for uploading this article. This has provided a base for me to install and start Practicing Java as i am a newbie to Java.

javapapo
10 years ago

Happy to help, keep it up :)

dragonfly
dragonfly
9 years ago

Is there any wrong when I type:

C:\Users\nguyendt>java -version
java version “1.7.0_71”
Java(TM) SE Runtime Environment (build 1.7.0_71-b14)
Java HotSpot(TM) 64-Bit Server VM (build 24.71-b01, mixed mode)

C:\Users\nguyendt>where java
C:\Windows\System32\java.exe
C:\Program Files\Java\jdk1.7.0_71\bin\java.exe

C:\Users\nguyendt>echo %JAVA_HOME%
%JAVA_HOME%

C:\Users\nguyendt>

ksr
ksr
9 years ago
Reply to  dragonfly

where java

it will work for “unix” flavores

windows it will not work

Nish
Nish
8 years ago

Absolutely clear, concise, informative, verifiable and current… Thank you

demissie
8 years ago

wants to upload setup

hello
8 years ago

outstanding getting started java tuto… really enjoyed reading it and getting memories back… especially because I was kicking some java projects after so many years without touching it…

Back to top button