WAR Plugin for Play framework 2.x
Current versions:
Play 2.2.x : 1.2.1
Play 2.3.0 -> 2.3.1 : 1.3-beta1 (Scala 2.10 & 2.11)
Play 2.3.2+ : 1.3-beta3 (Scala 2.10 & 2.11)
Play 2.4.x : 1.4.0 (Scala 2.10 & 2.11)
Play 2.5.x : Not supported yet
Project-status: STABLESee also archived versions.
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
Other references built with Play 2 and Play2War:
- Factile (Survey platform)
What's new ?
Features
| Features | Native Play 2 | Servlet engine | |||
|---|---|---|---|---|---|
| 3.1 | 3.0 | 2.4/2.5 | |||
| Availability |  |
P2W 1.2+ |
|
|
|
| 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 : |
||||
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/play2war/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, Yann Simon.
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
Versions not supported anymore
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