Quickstart for Spring Framework on OpenShift with JBoss EAP 6
Java CSS Shell
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.openshift
deployments
src
.gitignore
README.md
pom.xml

README.md

Spring Framework on OpenShift with JBoss EAP 6

What is it?

This is a sample Maven 3 project to help you get your foot in the door developing with Spring on JBoss Enterprise Application Platform 6 or JBoss AS 7.1, deployable on OpenShift (PaaS by Red Hat).

This project is setup to allow you to create a compliant Spring 3.1 application using Spring MVC, JPA 2.0 and Bean Validation 1.0. It includes a persistence unit and some sample persistence and transaction code to introduce you to database access in enterprise Java.

Quickstart

  1. Create an account at http://openshift.redhat.com/ and follow the Getting Started guide to install the OpenShift command line tools.

  2. Create a JBoss Enterprise Application Platform 6 app:

    rhc app create -a spring -t jbosseap-6.0

  3. Add this upstream repo:

    cd spring git remote add upstream -m master git://github.com/openshift/spring-eap6-quickstart.git git pull -s recursive -X theirs upstream master

  4. Remove the default index.html file and commit:

    git rm src/main/webapp/index.html git commit -m 'Removed default index.html'

  5. Then push the repo upstream:

    git push

  6. That's it, you can now browse to your application at:

    http://spring-$yournamespace.rhcloud.com

Setting up a database

The example uses a H2 database configured and deployed by the application. You can easily change it to MySQL or PostgreSQL (available on OpenShift as cartridges):

  1. Add a database cartridge to your OpenShift app (mysql-5.1 or postgresql-8.4):

    rhc cartridge add -a spring -c mysql-5.1

  2. Edit src/main/resources/META-INF/persistence.xml to use the appropriate datasource (java:jboss/datasources/MysqlDS or java:jboss/datasources/PostgreSQLDS):

    java:jboss/datasources/MysqlDS

  3. Commit and push your changes:

    git commit -a -m 'Added MySQL database support' git push

License

This code is dedicated to the public domain to the maximum extent permitted by applicable law, pursuant to CC0 (http://creativecommons.org/publicdomain/zero/1.0/)