cloudfoundry / java-test-applications Goto Github PK

View Code? Open in Web Editor NEW

33.0 26.0 67.0 2.63 MB

Applications used for testing the Java buildpack

License: Apache License 2.0

Java 85.64% Groovy 12.37% Shell 1.21% Dockerfile 0.79%

java-test-applications's Introduction

Java Test Applications

A collection of applications used for testing the Java buildpack.

Applications

Name	Description
`dist-zip-application`	A Spring Boot application, deployed as a `distZip`
`ejb-application`	A JEE EJB application using Servlet 3
`groovy-application`	An application started with `groovy`
`java-main-application`	A Spring Boot application started with `java -jar`
`ratpack-application`	A Ratpack application, deployed as a `distZip`
`spring-boot-cli-application`	A Spring Boot CLI application, deployed with `spring grab`
`spring-boot-cli-jar-application`	A Spring Boot CLI application, deployed with `spring jar`
`web-application`	A Spring MVC application using Servlet 3
`web-servlet-2-application`	A Spring MVC application using Servlet 2

Output Content

All applications support the following REST operations:

URI	Description
`GET /`	The health of the application
`GET /class-path`	The classpath of the application
`GET /environment-variables`	The environment variables available to the application
`GET /input-arguments`	The list of JVM input arguments for the application
`POST /out-of-memory`	The URL to trigger an out of memory error
`GET /request-headers`	The http request headers of the current request
`GET /security-providers`	The system security providers available to the application
`GET /system-properties`	The system properties available to the application

Building

Before building the project, the following tools must be installed:

This project is built with Gradle. After installing the pre-requisites, run:

./gradlew

Building Behind a Proxy

Since this project downloads its dependencies from the internet, building behing a proxy requires some extra effort. In order configure gradle properly, use the following system properties. More information can be found here.

./gradlew -Dhttp.proxyHost=<HOST> -Dhttp.proxyPort=<PORT>

Deploying to Cloud Foundry

Each test application contains a manifest.yml file which allows the built application to be deployed to Cloud Foundry by simply issuing:

cf push

To avoid clashing with the URLs of other applications, you should specify your own subdomain for the application (unless the test application does not need a subdomain).

Failure Testing

Failure testing is supported for each of the above applications by setting a suitable environment variable.

If the environment variable FAIL_INIT is set, the application will fail to initialize:

cf set-env <application name> FAIL_INIT true

If the environment variable FAIL_OOM is set, the application will repeatedly exhaust the heap until the JVM is killed:

cf set-env <application name> FAIL_OOM true

Running Tests

To run the tests, do the following:

./gradlew

License

The Tomcat Builder is released under version 2.0 of the Apache License.

java-test-applications's People

Contributors

Stargazers

Watchers

java-test-applications's Issues

Errors With Spring Boot Examples

I tried the spring boot examples, in particular I was trying the /mongodb/url endpoint. When I do it looks like there is a NPE.

java.lang.NullPointerException
    com.gopivotal.cloudfoundry.test.core.MongoDbUtils.getUrl(MongoDbUtils.java:38)
    com.gopivotal.cloudfoundry.test.core.MongoDbUtils.getUrl(MongoDbUtils.java:24)
    com.gopivotal.cloudfoundry.test.controller.ServiceController.url(ServiceController.java:40)
    sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
    sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    java.lang.reflect.Method.invoke(Method.java:606)
    org.springframework.web.method.support.InvocableHandlerMethod.invoke(InvocableHandlerMethod.java:215)
    org.springframework.web.method.support.InvocableHandlerMethod.invokeForRequest(InvocableHandlerMethod.java:132)
    org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod.invokeAndHandle(ServletInvocableHandlerMethod.java:104)
    org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.invokeHandleMethod(RequestMappingHandlerAdapter.java:749)
    org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.handleInternal(RequestMappingHandlerAdapter.java:689)
    org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter.handle(AbstractHandlerMethodAdapter.java:83)
    org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:938)
    org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:870)
    org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:961)
    org.springframework.web.servlet.FrameworkServlet.doGet(FrameworkServlet.java:852)
    javax.servlet.http.HttpServlet.service(HttpServlet.java:620)
    org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:837)
    javax.servlet.http.HttpServlet.service(HttpServlet.java:727)
    org.springframework.web.filter.HiddenHttpMethodFilter.doFilterInternal(HiddenHttpMethodFilter.java:77)
    org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:108)

README Typo

In the README it says there is an endpoint called /datasource-url however it should be /datasource/url.

Grails app missing

I came across this repository while searching for sample Grails applications that are built to be deployed to CloudFoundry. The README.md mentions that grails-application however, I haven't been able to find any grails-application. Is the README.md missing some information or am I just not seeing the grails-application

Play Framework app mentioned, but no longer existing

The play-application is mentioned in https://github.com/cloudfoundry/java-test-applications#applications but was removed via 14a702a. I was looking for an alternative, minimal Play Framework app but it seems hard to find one on Github. Any chance to point me to one that's know to work or is Play Framework no longer supported by the Java buildpack?

Thanks in advance.