Configuring Eclipse with SAP Cloud Platform Tools for Java

To make use of the SAP Cloud Platform Tools for Java you first need to have a supported version of Eclipse installed on your computer. The Eclipse Neon version is recommended.

Open the Download site for Eclipse and click on the Eclipse IDE for Java EE Developers link

Choose the operating system that you will use to run Eclipse and choose the download site:

Choose the preferred download site and start the download.

Once the download has finished extract the archive to a local folder of your choice (e.g. c:\dev\eclipse).

Click on the eclipse executable file to start the Eclipse IDE.

Eclipse will first show you a Workspace Launcher dialog to choose your workspace. Replace the suggested workspace path with c:\dev\eclipse_workspace. Confirm with OK.

Close the Eclipse Welcome Page.

Now that you have installed Eclipse, you need to install the SAP Cloud Platform tools for Java. This is done following the standard approach of Eclipse to install plugins.

From the Eclipse menu, choose Help > Install New Software…

Copy the URL https://tools.hana.ondemand.com/neon and paste it in the **Work with **field and then press the Enter (or Return) key.

Select SAP Cloud Platform Tools and click Next.

Note: If Eclipse is not able to find the tools then please check your network settings. You might need to configure a proxy, in particular if you are working from a corporate network. How-to setup a proxy in Eclipse is explained in the Installing SAP Development Tools for Eclipse section of the official online documentation.

On the Install Details page click Next.

Read and accept the license agreement and choose Finish. The installation will now start.

At the end of the installation, you will be asked to restart Eclipse. Confirm the dialog with Yes to restart Eclipse immediately.

After Eclipse restarts, close the Eclipse Welcome Page. You now have the SAP Cloud Platform Tools for Java installed in Eclipse.

The next step is to download and install the SAP Cloud Platform SDK, which contains all the required artifacts to setup a local development environment as well as the console client used to interact with your cloud account.

The SDK comes in different flavors:

• Java Web: Provides a lightweight runtime supporting a subset of the standard Java EE APIs (Servlet, JSP, JSTL, EL). Currently there is a 1.x version of this runtime available
• Java EE 6 Web Profile: Provides certified support for the whole Java EE 6 Web Profile APIs. Currently there is a 2.x version of this runtime available
• Java Web Tomcat 7: Provides support for some of the standard Java EE APIs (Servlet, JSTL, EL). Currently there is a 2.x version of this runtime available
• Java Web Tomcat 8: Provides support for some of the standard Java EE APIs (Servlet, JSTL, EL). Currently there is a 3.x version of this runtime available

For this tutorial you will use the Java Web SDK 1.x version of the SDK. To install it on your system do the following:

Open https://tools.hana.ondemand.com#cloud. Make sure you are on the Cloud tab of the page.

Choose the Java Web (neo-java-web-sdk.X.X.X) (use the latest version) for download.

Note: The version of the Java Web SDK shown on this screenshot might be lower than the one that you will actually download. This is OK. The procedure should work with any higher version as well. Just make sure that you always use the SDK version that you actually downloaded in the following steps.

Before you are allowed to download the SDK you have to read and agree to the SAP Developer License agreement. After accepting the license by clicking I Have Read and Agree the download of the SDK will start.

Once the download has finished extract the archive to a local folder of your choice. It is recommended to place the folder in c:\dev and to name it like the just downloaded file, e.g. c:\dev\neo-java-web-sdk-1.109.9

Note: To familiarize yourself further with the content of the SDK, especially note the location of the console client within the tools directory and the provided samples in a respective samples directory. Also, you might be interested to learn about the supported APIs.

The next thing to do is to configure the SAP Cloud Platform Tools for Java so they make use of the just downloaded SDK. From the Eclipse IDE main menu, choose Window > Preferences.

Choose Server > Runtime Environment. Click the Add… button to open the New Server Runtime dialog.

Select SAP > Java Web as the Server Runtime Environment and click Next.

Provide the folder to which you have extracted the SDK by clicking the Browse… button and choosing the respective folder, e.g. c:\dev\neo-java-web-sdk-1.63.20.7. Click on Finish.

With this a new Java Web runtime is now available that will be used for your SAP Cloud Platform projects. You can now close the dialog by clicking OK

Congratulations: You have now installed the SAP Cloud Platform Tools for Java and are ready to start with your Java project on SAP Cloud Platform.