Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Tree: c185a86100
Fetching contributors…

Cannot retrieve contributors at this time

120 lines (86 sloc) 4.35 KB

Hello Java Sample

This sample (originally based on the SpringSource sample) aims to demonstrate the simplest possible Servlet-based Java webapp. Here we walk through the entire content of the application.

The Servlet

In the org.cloudfoundry.samples package under src/main/java, you will see

package org.cloudfoundry.samples;


import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class HelloServlet extends HttpServlet {

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        PrintWriter writer = response.getWriter();
        writer.println("Hello from " + System.getenv("VCAP_APP_HOST") + ":" + System.getenv("VCAP_APP_PORT"));

Notice that it contains only java and javax imports. In the doGet(..) method, it simply writes the Content-Type header value, sets the status to 200 (OK), and then writes a message. The content of that message includes the HOST and PORT where this application is running. Those environment variables, VCAP_APP_HOST and VCAP_APP_PORT are available anytime the application is running on Cloud Foundry.

The web.xml File

As a standard Java webapp, the configuration of HelloServlet is included within the WEB-INF/web.xml file. You will find that under src/main/webapp. It looks like this:

<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="2.4" xmlns=""

    <display-name>Hello Java</display-name>




There you see the servlet is declared, and then a mapping is provided. In this case, the context root of the application is mapped directly to HelloServlet since it is the only servlet in the application.

The pom.xml File

Since this application is built with Maven, there is a pom.xml file directly in the root directory. That POM is as simple as it can be.


Notice that it has the standard project metadata (groupId, artifactId, version, etc.), and it has a single dependency: the Servlet API. That dependency is marked as provided since it's available in the deployment environment itself.

Building the Application

To build the application, make sure you have Maven installed. Then, cd into the root directory and execute:

mvn clean package

That will create the hello-java-1.0.war file within the 'target' directory.

Running the Application

To run the application, make sure you have the Stackato client installed and that you are logged in successfully for your desired target environment (e.g. http://api.stackato.local).

Then execute:

mvn clean package
stackato push -n 

Notice that it detected the app type as "Java Web Application". In this case, it's only recognizing a runtime (Java) but not a framework (e.g. Spring or Grails), since this really is just a barebones Java web application. If you were to create a Spring or Grails application, you would see that it detects both the runtime and the framework.

The result when visiting the 'Application Deployed URL' should look something like this:

Hello from

That's all. Have fun!

Jump to Line
Something went wrong with that request. Please try again.