play war myapp -o myapp.war

Now to deploy on JBoss, you need to do some changes on your WAR file:

• Create a file called jboss-web.xml in the myapp.war/WEB-INF/ directory container the following:

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE jboss-web PUBLIC "-//JBoss//DTD Web Application 2.4//EN" "http://www.jboss.org/j2ee/dtd/jboss-web_4_0.dtd">



com.example:archive=myapp.war
java2ParentDelegation=false

• Download hibernate-validator and hibernate annotation using the compatibility matrix (Hibernate Compatibility Matrix). Play is using hibernate core 3.3.2 GA. Once you are done, place the relevant jars in the myapp.war/WEB-INF/lib directory. You should end up with:
  • hibernate-annotations.jar
  • hibernate-entitymanager.jar
  • hibernate-validator.jar
  • hibernate-commons-annotations.jar
  • hibernate-search-3.1.1.GA.jar
  • hibernate3.jar (Do not overwrite this library, as Play! has a modified version of it)
• Now that we’re prepared for WAR, you need to move your application to the deployment folder of JBoss. The default folder for it is: jboss_home/server/default/deploy (jboss_home == folder of jboss). There are some things you need to be aware of:
  
  1. Use a superior java version in JBoss to avoid class version errors
  2. Verify that the WAR folder has the necessary permissions. In my case I needed to make a “chown -R jboss myapp.war” where jboss is the user that controls the jboss application server
  3. Do a “tail -f jboss_home/server/default/log/server.log” to see if your application is being deployed. You’ve an Administration Console in http://yourserverip:8080
  4. Don’t change your routes file at runtime. Stop the war, change routes and then start the war (in the administration console I said before)
     
• Now you should have your application working. You can access to your app at: http://yourserverip:8080/myapp.war
• This tutorial was tested in JBoss 5.0.1
  

Thanks to Nicolas Leroux from lunatech.com for helping me to create this tutorial.

1. After the controller is created (what I do is to copy the controller  “Application” and do a refactor rename to the name I want).

1. Create a file named MyController (what I do is to copy the controller  “Application” and do a rename to the name I want – in this case i chose the name MyController)
2. After this, you need to create a folder with the same name of the controller (in this case: MyController) – app/views/MyController
3. Now in the controller, you’ve to create an index method, where you’ll output data for the user, for instance:

   1. public static void index() {
          List users = User.all().fetch();
          render(users);
      }

   2. Now you need to create a method that will create the file, or get the file somewhere:

      public static void generateMyDocument() {
             File f = new File("myFile.xls");
             //now you've to edit the file, in this is case is an excel file,
             //so you can edit using a library like JExcelAPI

             //set the header with the size of the file
             response.setHeader("Content-Length", String.valueOf(f.length()));
             //set the content type, in this case is a microsoft excel
             response.contentType = "application/ms-excel";
             //send the file to the user
             renderBinary(f);
             //after I send the file, I want to return to the same page (index())
             index();
      }

4. Now we need to create a view, inside that folder we just created (create an index.html file):

   • <a href="@{generateMyDocument()}">Download file</a>

     We are calling the method from the controller. First we have the folder with the same name that will route directly to the method of the controller.Off course that we could do this:

         <a href="@{MyController.generateMyDocument()}">Download file</a>

   And that’s it. The magic on the Play Framework is done .

1. Choose the JAR with the drivers according to your oracle’s database version and put in the lib/ directory of your web application
2. Configure your application.conf file,  located inside the conf/ directory
   • In the JPA Configuration Section you have to choose the JPA (Hibernate) dialect. In my case I was working with oracle10g so i had to insert in the configuration file:

     • jpa.dialect=org.hibernate.dialect.Oracle10gDialect

   • Now you just need to add the following lines, according to your database (including username and password).

     • db.url=jdbc:oracle:thin:@yourdatabaseserver:1521:dbname
       db.driver=oracle.jdbc.driver.OracleDriver
       db.user=yourusername
       db.pass=yourpassword

3. Now you just need to restart the server. He adds the database drivers automatically to the classpath of the project.
4. If you want, you can generate Netbeans or Eclipse projects, so you can open this projects with everything configured.

Really easy with no XMLs!

In every checkbox element I want to send a post message to my Play Framework.

jQuery.each($(':checkbox'), function() {
    $.post('@{myPlayMethod()}', { itemValue: $(this).val() })
});

This code sends the html element value property to method “myPlayMethod(String itemValue)“.