Abdul Habra's Blog

Arabic Text Editor

Tue, 29 Mar 2011 19:38:00 -0400

I just moved “Arabic Text Editor” to

http://www.tek271.com/software/other/arabic-text-editor

Spam Revenge

Tue, 29 Mar 2011 19:35:00 -0400

I just moved Spam Revenge to

http://www.tek271.com/software/other/spam-revenge

NuExpert

Tue, 29 Mar 2011 19:33:00 -0400

I just moved NuExpert to

http://www.tek271.com/software/other/nuexpert

Tek271 Servlet Utilities

Tue, 29 Mar 2011 19:31:00 -0400

I just moved Tek271 Servlet Utilities to

http://www.tek271.com/software/java/servlet-utilities

Tek271 Template

Tue, 29 Mar 2011 19:28:00 -0400

I just moved Tek271 Template to

http://www.tek271.com/software/java/text-template

Tek271 GzipServletFilter

Tue, 29 Mar 2011 19:25:00 -0400

I just moved Tek271 GzipServletFilter to

http://www.tek271.com/software/java/gzipservletfilter

Tek271 Memoizer

Tue, 29 Mar 2011 19:17:00 -0400

http://www.tek271.com/software/java/memoizer

TECUJ

Tue, 29 Mar 2011 19:14:00 -0400

Moved TECUJ library to

http://www.tek271.com/software/java/tecuj-library

Neural Networks - An Introduction

Tue, 29 Mar 2011 18:15:00 -0400

Moved this paper to the new Google Apps site on 2011.03.29

http://www.tek271.com/documents/others/into-to-neural-networks

Reverse Proxy Server

Sat, 26 Mar 2011 01:34:00 -0400

Information moved to http://www.tek271.com/software/java/reverse-proxy-server

Guava At Cinjug

Sun, 30 Jan 2011 11:52:00 -0500

I presented Google Guava at Cincinnati Java User Group (CinJug) on 2011.01.27.

Here are links to the material presented:

Presentation as PDF
Sample Java code as an Eclipse project (zipped)

Build CRUD Apps With Play Framework

Thu, 17 Jun 2010 02:56:00 -0400

Introduction

Play (playframework.org) is a Java framework that makes it very easy to build web applications. Here I show how to build a CRUD web app in a way that reminds me of RoR or Grails. You only need to know Java to follow this example. Play’s website contains excellent documentation and I will not repeat them here.

Some of the material here was presented at CoJug on 2010.06.08. The CoJug presentation contained more than what is provided here, and was presented by Nilanjan Raychaudhuri and myself.

Setup

Java 1.5 or higher installed.
Play installed, remember to add Play’s location to the path.
Eclipse 3.5 installed. (This is a personal choice, you may use any IDE or text editor).

This will be a simple CRUD application which manages the following entities:

A group of companies.
Each Company can have 0 or more Department.
Each Department can have 0 or more Employee.

Create App’s Skeleton

From the command line, navigate to the directory which will contain the new application.
Run this command: play new corporations
You will be prompted to enter the application’s name, enter Corporations
The above will create an empty Play application in the corporations directory.
To try what you created, run this command:

cd corporations play run
In your web browser, go to http://localhost:9000/
You should get a page titled “Your application is ready !”
This proves that Play is running and that you application has started.

Configure The App

Terminate the Play running app at the command line: Ctrl-C
We are going to use Eclipse for developing this app, so from the command line, enter: play eclipsify
The eclipsify command creates Eclipse artifacts like .settings and .project
Run Eclipse
Import this project: File/Import/General/Existing projects into Workspace
Navigate to the corporations directory which you created earlier.
Finish importing the project.
In my Eclipse’s instance, I got several errors after the import, the errors where complaining about different version of Java being used. I changed the project’s properties/Java compiler to JDK 1.5, and that resolved the problem.
Open the file conf/application.conf and enable the line

db=mem

which will run HSQL in memory (this is only a demo, but if you look in the file you could see how to connect to a real database)
Still in conf/application.conf, find the section titled “Additional modules” and either enable or add the following line:

module.crud=${play.path}/modules/crud

Which will tell Play to include default CRUD scaffolding.
Open the file conf/routes and add this line

* /admin module:crud

which will route all CRUD operations to /admin
Go to the command line (in the corporations directory) and run “play eclipsify” again.
Refresh the eclipse project (F5), (you may have to reset the Java Compiler to 1.5 again).
From the command line, do “play run” again, then check in the browser. The app should run as we had it before, no changes yet.

Create Employee Model and Controller

Keep Play running at the command line.

In Eclipse, navigate to app/models the create a new class Employee:

package models;
import java.util.Date;
import javax.persistence.*;
import play.db.jpa.Model;

@Entity
public class Employee extends Model {
  public String fullName;
  public Integer salary;
  public Date dateOfHire;
}

Navigate to app/controllers and create a new class Employees:

package controllers;
public class Employees extends CRUD { // an empty class
}

Make sure to save the files, and that Play is still running at the command line. In your web browser, go to http://localhost:9000/admin

You should see this page:

Try To Add an employee and see what happens.

Notice how Play’s convention for the controller’s name is just to add “s” at the end of the model class name. (model=Employee, controller=Employees). This is the default convention which can be changed as will be shown when we do the Company controller.

Notice also that our choice for the Employee class to be in the models package directly is only for simplicity. It can be in any sub-package under models. The same is true for the Employees class and controllers package.

Create Department Model and Controller

In Eclipse, navigate to app/models the create a new class Department:

package models;
import javax.persistence.*;
import play.db.jpa.Model;

@Entity
public class Department extends Model {
  public String name;
  public String description; 
}

Navigate to app/controllers and create a new class Departments:

package controllers;

public class Departments extends CRUD {}

Make sure to save the files, and that Play is still running at the command line. In your web browser, go to http://localhost:9000/admin

You should see the same Administration page as above but now it contains both Departments and Employees object types.

Relationship Between Employee and Department

So far when you add an employee, you cannot specify what department the employee belongs to. Let’s fix that. In the Employee class add the following:

  @ManyToOne
  public Department department;

The @ManyToOne is a JPA annotation (in javax.persistence) which says that many Employees can belong to one Department.

Save your work in Eclipse, then try to add a new Employee in the browser. You should see a new field titled “department” with a combo box list of options. If the department list is empty, then add a department, then try to add an employee again, you will see the added department in the list.

Create Company Model and Controller

Create the Company class in the models package:

package models;
import javax.persistence.Entity;
import play.db.jpa.Model;

@Entity
public class Company extends Model {
  public String name;
  public String address;
  public boolean isPublic;
}

Next we want to create the controller for the Company model. The naming convention is to add “s” at the end of the model’s name to create a controller. However, Companys does not spell right in English. The correct English spelling is Companies, so let’s create this class in app/controllers:

package controllers;
import models.Company;

@CRUD.For(Company.class)
public class Companies extends CRUD {}

Notice how we use the @CRUD.For annotation to indicate that this controller class is for the Company model object.

To set the relationship between Department and Company, add the following to the Department model class:

  @ManyToOne
  public Company company;

Which says that many departments can belong to one company.

Save your work in Eclipse, then refresh the browser. Notice how companies is added to the list of object types.

Fixing Model Lists

So far when you view the Companies list (for example) you see a list of Company[id] items. This is not too helpful, and the fix is very easy. Edit the model object and provide a toString() method that returns a more readable representation of the model object. For example, in the Company class, add the following:

  public String toString() {
    return name;
  }

Save and refresh the browser, you should see a more readable list of companies. You can use the same approach for Employee and Department.

Validation

Suppose you want to make the Employee’s fullName required, and that it should not exceed 100 characters in length. Add the following annotations to the fullName declaration:

@Required @MaxSize(100) public String fullName;

Both annotations are imported from play.data.validation.

Now if you try to add a new Employee, notice the comment under the fullName text field. If you try to save an Employee without providing a fullName, you will get an error message.

The are other interesting validation annotations like:

@Email
@InFuture for future dates
@InPast for past dates
@Match for regular expressions matching
@Max
@Min
@Range for a range of values
@URL
and others …

Change Employee List View

So far, when you view the Employee list, you will see a list of Employee names (assuming you added to toString() method). Suppose you want to change this view to see more details, like salary and dateOfHire. Again, Play provides a simple solution.

At the command line, stop play: Ctrl-C
Run this command

play crud:ov --template Employees/list

which will create the new file: app/views/Employees/list.html
Run Play again

play run
Refresh Eclipse (F5)
In Eclipse, open the new file: app/views/Employees/list.html
This file shows the default display for a list of Employees.
Look for the div with id=”crudListTable” and change the div’s content to

#{crud.table fields:['fullName', 'dateOfHire', 'salary'] /}
Save the file.
In the browser, refresh the list of Employees and notice how it contains three columns now.

Change Labels of Fields

Play uses the name of the field in the model object as the label for that field. To change that, open conf/messages file and add the following line:

fullName=Full Name

Save the file. Try to add a new Employee in the browser. Notice how the label for fullName has changed. You can do the same thing for any field name you choose.

Conclusion

This blog touched only one module (CRUD) of Play. Play contains many other modules which make the life of Java web programmer easier. Examples include:

Security.
Spring, and Guice integration.
GWT
Scala and Akka integration.
Maven dependency
…

The main advantages of Play as I see it are:

The quick development feedback cycle: code-save-browserRefresh. Play has removed the need to compile/deploy as used in typical Java web frameworks.
Testability: I have not talked about testability here because I wanted to show CRUD support at its simplest, but Play has great testing support, which you can read about at Play’s test documentation.

SUSHI and COUNTER

Thu, 03 Jun 2010 14:01:00 -0400

My notes about COUNTER and SUSHI

COUNTER: Counting Online Usage of Networked Electronic Resources. projectcounter.org

SUSHI: Standardized Usage Statistics Harvesting Initiative. www.niso.org/workrooms/sushi/

COUNTER is a standard used by libraries and publishers to report online usage statistics. The reports can be in CSV, spreadsheets, or XML. There are several types of reports; Journal, Database, and Consortium Reports. All reports are monthly.

SUSHI is a Web Service (SOAP) standard which allows requesting a COUNTER report in XML format. The web service request specifies what COUNTER report is needed, while the response will contain (embedded) the report. See SUSHI Tutorial.

The SUSHI web service should validate the request before responding. Validations could include:

Client IP address. As a security measure.
Customer ID.
Report type.
Date range.

Sample SUSHI Request

(Items in bold are required)

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
          xmlns:coun="http://www.niso.org/schemas/sushi/counter" 
          xmlns:sus="http://www.niso.org/schemas/sushi">
   <soapenv:Header/>
   <soapenv:Body>
      <coun:ReportRequest Created="?" ID="?">
         <sus:Requestor>
             <!-- ID contains the domain of service making request, e.g. http://www.x.com
                   It also can be used for authentication, e.g. userName/password
               -->
            <sus:ID>demo</sus:ID>
            <sus:Name>?</sus:Name>
            <sus:Email>?</sus:Email>
         </sus:Requestor>
         <sus:CustomerReference>
            <sus:ID>demo</sus:ID>  <!-- could be similar to Requestor ID ->
            <!--Optional:-->
            <sus:Name>?</sus:Name>
         </sus:CustomerReference>
         <sus:ReportDefinition Name="JR1" Release="3"> <!-- release is version# -->
            <sus:Filters>
               <sus:UsageDateRange>
                  <sus:Begin>2009-01-06</sus:Begin>
                  <sus:End>2009-01-06</sus:End>
               </sus:UsageDateRange>
            </sus:Filters>
         </sus:ReportDefinition>
      </coun:ReportRequest>
   </soapenv:Body>
</soapenv:Envelope>

Sample SUSHI Response (Error)

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
       xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance" 
       xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" 
       xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
       xmlns:xsd="http://www.w3.org/1999/XMLSchema" >
   <SOAP-ENV:Body>
      <ReportResponse ID="demo"
            xsi:schemaLocation="http://www.niso.org/schemas/sushi/counter 
                             http://www.niso.org/schemas/sushi/counter_sushi3_0.xsd" 
            Created="2010-06-02T19:40:14Z" 
            xmlns="http://www.niso.org/schemas/sushi/counter"
            xmlns:s="http://www.niso.org/schemas/sushi"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
         <s:Requestor>
            <s:ID>demo</s:ID>
            <s:Name>?</s:Name>
            <s:Email>?</s:Email>
         </s:Requestor>
         <s:CustomerReference>
            <s:ID>?</s:ID>
            <s:Name>?</s:Name>
         </s:CustomerReference>
         <s:ReportDefinition Name="JR1" Release="3">
            <s:Filters>
               <s:UsageDateRange>
                  <s:Begin>2008-01-01</s:Begin>
                  <s:End>2008-03-01</s:End>
               </s:UsageDateRange>
            </s:Filters>
         </s:ReportDefinition>
         <Exception Created="2010-06-02T19:40:14Z" xmlns="http://www.niso.org/schemas/sushi">
            <Number>2010</Number>
            <Severity>Error</Severity>
            <Message>The Requestor ID (demo) has not been authorized to harvest usage for the institution.</Message>
         </Exception>
      </ReportResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Sample SUSHI Response (success)

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
       xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance" 
       xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" 
       xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
       xmlns:xsd="http://www.w3.org/1999/XMLSchema" >
   <SOAP-ENV:Body>
      <ReportResponse ID="demo" 
            xsi:schemaLocation="http://www.niso.org/schemas/sushi/counter 
                             http://www.niso.org/schemas/sushi/counter_sushi3_0.xsd" 
            Created="2010-06-02T20:57:05Z" 
            xmlns="http://www.niso.org/schemas/sushi/counter"
            xmlns:s="http://www.niso.org/schemas/sushi"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
         <s:Requestor>
            <s:ID>demo</s:ID>
            <s:Name>?</s:Name>
            <s:Email>?</s:Email>
         </s:Requestor>
         <s:CustomerReference>
            <s:ID>demo</s:ID>
            <s:Name>?</s:Name>
         </s:CustomerReference>
         <s:ReportDefinition Name="JR1" Release="3">
            <s:Filters>
               <s:UsageDateRange>
                  <s:Begin>2009-01-06</s:Begin>
                  <s:End>2009-01-06</s:End>
               </s:UsageDateRange>
            </s:Filters>
         </s:ReportDefinition>

         <!-- next is the COUNTER report -->
         <Report>
            <Report Created="2010-06-02T20:57:06Z" 
                 Title="Number of Successful Full-Text Article Requests by Month and Journal" 
                 ID="JR1:3" Version="3" 
                 xmlns="http://www.niso.org/schemas/counter">
               <Vendor>
                  <Name>Project Euclid</Name>
                  <ID>37e194bf-898e-4884-aa14-5f73e4c14ae5</ID>
                  <Contact>
                     <Contact>Project Euclid Support</Contact>
                     <E-mail>EUCLID-L@cornell.edu</E-mail>
                  </Contact>
                  <WebSiteUrl>http://www.projecteuclid.org</WebSiteUrl>
               </Vendor>
               <Customer>
                  <Name>Demo Institution</Name>
                  <ID>demo</ID>
                  <WebSiteUrl/>

                  <!-- repeating ReportItems start next -->
                  <ReportItems>
                     <ItemIdentifier>
                        <Type>ISSN</Type>
                        <Value>1085-3375</Value>
                     </ItemIdentifier>
                     <ItemPlatform>Project Euclid</ItemPlatform>
                     <ItemPublisher>Hindawi Publishing Corporation</ItemPublisher>
                     <ItemName>Abstract and Applied Analysis</ItemName>
                     <ItemDataType>Journal</ItemDataType>
                     <ItemPerformance>
                        <Period>
                           <Begin>2009-01-01</Begin>
                           <End>2009-01-31</End>
                        </Period>
                        <Category>Requests</Category>
                        <Instance>
                           <MetricType>ft_total</MetricType>
                           <Count>586</Count>
                        </Instance>
                     </ItemPerformance>
                     <ItemPerformance>
                        <Period>
                           <Begin>2009-01-01</Begin>
                           <End>2009-01-31</End>
                        </Period>
                        <Category>Requests</Category>
                        <Instance>
                           <MetricType>ft_pdf</MetricType>
                           <Count>586</Count>
                        </Instance>
                     </ItemPerformance>
                     <ItemPerformance>
                        <Period>
                           <Begin>2009-01-01</Begin>
                           <End>2009-01-31</End>
                        </Period>
                        <Category>Requests</Category>
                        <Instance>
                           <MetricType>ft_html</MetricType>
                           <Count>0</Count>
                        </Instance>
                     </ItemPerformance>
                  </ReportItems>


                  <!-- more ReportItems -->
                  

               </Customer>
            </Report>
         </Report>

      </ReportResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>