Skip to content
This repository

WAR Plugin for Play framework 2.x

Merge pull request #239 from yanns/servlet31

Servlet31 upload internal buffer size can be configured
latest commit 1a3f3078bb
Damien Lecan authored
Octocat-spinner-32 ext-runtimes Reintroduce Windows launcher May 10, 2012
Octocat-spinner-32 project-code update to tomcat 8.0.5 April 04, 2014
Octocat-spinner-32 sample Merge pull request #235 from yanns/servlet31 March 20, 2014
Octocat-spinner-32 samples Upgrade to P2W 1.0 June 24, 2013
Octocat-spinner-32 .gitignore Ignore Intellij files May 22, 2013
Octocat-spinner-32 LICENCE Rename LICENCE.txt May 14, 2013
Octocat-spinner-32 README.md Add contributors February 04, 2014
README.md

WAR Plugin for Play framework 2.x

Current versions:
    Play 2.0 -> 2.0.4 : 0.8.1
    Play 2.0.5+       : 0.8.2
    Play 2.1 -> 2.1.3 : 1.0.2
    Play 2.1.4+       : 1.1.1
    Play 2.2.x        : 1.2-beta4

Project-status: STABLE

Build Status

This project is a module for Play framework 2 to package your apps into standard WAR packages. It can be used with Servlet 3.1, 3.0 and 2.5 containers (Tomcat 6/7/8, Jetty 7/8/9, JBoss 5/6/7/8, ...)

Why choosing WAR packaging when native Play 2 is a better deployment model (features and performances) ?

  • Ops don't want to change their deployment model and still want to use WAR in your company
  • SSL is available, easy to configure and well documented on JBoss, Tomcat, ... when SSL is newer on Play 2.1
  • You need to add extra Servlet filters specific to your company (to handle SSO, ...)

You can trust this plugin because it is heavily tested, with hundreds of integration tests run on :

  • several open-source application servers (Tomcat 6/7/8, Jetty 7/8/9)
  • all versions of Play Framework 2.x

Live demo: JBoss7@Cloudbees : http://servlet30.play-war.cloudbees.net/

Other references built with Play 2 and Play2War:

What's new ?

See releases and changelog.

Features

Features Native Play 2 Servlet engine
3.1 3.0 2.4/2.5
Availability
Performances +++ ++ + -
HTTP Asynchronous request
processing
Web Socket Not available yet
Container Data sources Built-in
(Bone CP)
Built-in (Bone CP)
Support external DataSource without JTA
Applications deployed at root context
Eg: http://myhost/

Applications deployed at sub-context
Eg: http://myhost/mySubAppContext

Play 2.0.x :
Play 2.1.x and more :

Server compatibility

Servlet engine Server In your company Public PaaS
Servlet 3.1 Tomcat 8 TBD
Jetty 9.1 TBD
JBoss/Wildfly 8 TBD TBD
Glassfish 4 TBD TBD
Servlet 3.0 Tomcat 7
Jetty 8
Jetty 9.0 TBD
JBoss 7.0 Demo @Cloudbees
Need extra configuration when deploying
JBoss 7.1 TBD
(Openshift)
Glassfish 3 TBD TBD
Websphere Community Edition 3.0 -
Websphere 8.5 Liberty Profile -
Servlet 2.5 Tomcat 6 -
Jetty 7 -

The plugin may work on others containers, such as Weblogic (not tested yet).

Configuration

See Configuration.

Usage

See Usage.

Deployment

See Deployment.

FAQ

See FAQ.

Issues

Please file issues here: https://github.com/dlecan/play2-war-plugin/issues.

Continous integration

Watch it in action here : https://play-war.ci.cloudbees.com/.

How to help ?

Discover how you can help the project.

Contributors

Ivan Meredith, Rossi Oddet, Sam Spycher, Naoki Takezoe, Quinn Slack, Eugene Platonov, László Zsolt Kustra.

Licence

This software is licensed under the Apache 2 license, quoted below.

Copyright 2012 Damien Lecan (http://www.dlecan.com).

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this project except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Built by CloudBees

githalytics.com alpha

Something went wrong with that request. Please try again.