Showing posts with label ejb3. Show all posts
Showing posts with label ejb3. Show all posts

Sunday, December 17, 2006

Smart Key Generator ejb3


Java Persistence provides facility for auto-generation of primary keys. But limited to integer datatype. Further there is no convenient way to access these generated values. Its often needed that the primary key is a combination of identifiable data. Such keys are also known as Smart Keys.
Smart Keys also need automatic serial number generation.
Following solution uses HiLo sequence generation algorithm.

The solution contains one Stateless Session Bean and a Singleton. Additionally it consists an Entity (JPA)


package jkook.vetan.utils;
/*
* HrSequenceFacade.java
*/
@Stateless
public class HrSequenceFacade implements HrSequenceFacadeLocal, HrSequenceFacadeRemote {


@PersistenceContext
private EntityManager em;

private UIDDispenser uiddispenser;
private static final Logger log = Logger.getLogger(HrSequence.class.getName());

/** Creates a new instance of HrSequenceFacade */
public HrSequenceFacade() {

}

public void create(HrSequence hrSequence) {
em.persist(hrSequence);
}


public void edit(HrSequence hrSequence) {
em.merge(hrSequence);
em.flush();
log.info("HrSequence Updated");

}

public void destroy(HrSequence hrSequence) {
em.merge(hrSequence);
em.remove(hrSequence);
}

public HrSequence find(Object pk) {
return (HrSequence) em.find(HrSequence.class, pk);
}

public List findAll() {
return em.createQuery("select object(o) from HrSequence as o").getResultList();
}

/*
if dispenser is null
create new dispenser
getnextHi from dispenser

*/

@TransactionAttribute(TransactionAttributeType.REQUIRED)
public Integer getNextID(String entityname) {
log.info(" getNextId called");
uiddispenser = UIDDispenser.getDispenser(em);
return uiddispenser.getNextID(entityname,em);
}

public Integer getCount() {
Query q = em.createQuery("select count(o) from HrSequence as o ");
Long count = (Long)q.getSingleResult();
if(count != null){
return count.intValue();
}
return null;
}

public Integer getCurrentID(String entityname) {
uiddispenser = UIDDispenser.getDispenser(em);
return uiddispenser.getCurrentID(entityname);
}
}



/*
* UIDDispenser.java
*
*/

package jkook.vetan.utils;

public class UIDDispenser {


private static UIDDispenser uiddispenser;
private Map allentries;
private static final byte maxLo = 25;
static Logger log = Logger.getLogger(UIDDispenser.class.getName());
/** Creates a new instance of UIDDispenser */
private UIDDispenser() {

}

private UIDDispenser(EntityManager em){
// populate all entries
Iterator i =
em.createQuery("select object(o) from HrSequence as o")
.getResultList()
.iterator();
// for large database initiate the hashmap with count of HrSequence
allentries = new HashMap();
while(i.hasNext()){
HrSequence hs = i.next();
hs.setNextHi(hs.getNextHi()+maxLo);
allentries.put(hs.getEntityname(),hs);
System.err.println(" enityties +++ "+hs.getEntityname());
}

}

public static synchronized UIDDispenser getDispenser( EntityManager em) {
if (uiddispenser == null)
return new UIDDispenser(em);
return uiddispenser;

}

/*
* get nextLo
if lo > max_lo getnext HI
set lo=0
return HI+Lo
*
*
*/
public synchronized Integer getNextID(String entityname, EntityManager em){

HrSequence hs = allentries.get(entityname);
if(hs.getLo() >=maxLo){
log.fine(" LO Val is > maxLo " +hs.getLo() + " maxLo is " + maxLo );
hs.setNextHi(hs.getNextHi()+maxLo);
em.merge(hs);
byte b=0;
hs.setLo(b);
log.fine("Updated HI_VAL");
}
return hs.getNextHi()+ hs.getNextLo();
}

public Integer getCurrentID(String entityname){
HrSequence hs = allentries.get(entityname);
return hs.getNextHi()+ hs.getLo();
}
}

Usage :
@EJB HrSequenceFacade hrSequenceFacade
{
....
....
// start of smart key generation
// smartkey part1
// smartkey part2
Integer nextSerial = hrSequenceFacade.getNextID("NameityOfTheEnt")
// primaryKey = smartkeypart1 + part2 + nextSerial



Ref : Using Primary Keys with Java Persistence

Friday, November 17, 2006

Sorting and Paging with EJB Alternatives

A rather clean approach would have been EJB returns a List, Bind the List to Table Component . Thats-it every thing has to work. There are two intresting problems to solve

1) Sorting :- The Table component does its own sorting. It does not use database sorting capabilities nor ejb facilities. Solution is writing TableSorter and bind it to the TableComponent.

2) Paging :- The dataprovider performs the job of paging.  Dataprovider interface provides getRowCount(),getRowKeys(int count, RowKey afterRow). The strait forward approach will be overwrite these methods in the custom dataprovider. But intrestingly the TableComponent has a bug. It always call this method with afterRow=null. As a result we cannot use inbuilt paging features of the Table Component.  Final solution is to write addtional methods in dataprovier to handle paging and call these methods from buttons/links on the webpage.

 

Other options

Using Standard table component : Supports paging ,Does not support sorting, Does not support themes.

Not using Dataprovider : Jsf page still works with out dataprovider. We loose on visual binding of fields with the Table component. The TableLayout screen will not work.

Scope of Dataprovider and Table sorter : Dataprovider can be move to page scope by moving the maxresults and starPosition variables to session. Table Sorter cannot be moved out of session scope.

Desired Solution

NetBeans should some how automatically generate dataprovider, delegate paging and sorting to ejb layer. Table componet has to be- smarter :)

Paging and Sorting in ejb3 Analysis

Netbeans 5.5 VisualWeb Pack is a lovey tool for rapid application development. It is the best solution for your visual development. It lacks few features which are available in its cousin Sun Studio Creator(SJSC). For example in SJSC one can drag an EJB component on to a table. The table automatically re-draws itself to show all the filelds exposed by the draged ejb. I have experimented with Netbeans 5.5 to understand how to use visual development of a web application along with the ejb projects.

The new process is

Create EJB project as usual , Create VisualWeb application

Write a custom Dataprovider  by extending ObjectListDataProvider and Write a Custom Sorter extending TableDataSorter

Handle paging in DataProvider

Handle Sorting in TableDataSorter

Add Dataprovider and TableDataSorter as properties of SessionBean1 , Bind these properties to the table component.

Add Button ui components to your page which will handle the paging events.

I have explaind the detailed process in my previous blog

Sorting and Paging with EJB3

In this article we shall use NetBeans Visual Web Pack 5.5 to create and deploy an ejb3 application along with a web application. The application has two parts. A) An Enterprise application using ejb3 B) A Web application which displays a data grid with sorting and paging. Netbeans has wizards which can manage sorting and paging data bound to a database table. Here we shall see how to achive this features using ejb.
At the end you build a travel web application as shown in the figure

Contents
Prerequisites
Creating Travel EJB application
Creating Entity Classes from Database
Writing StateLess Session Bean
Creating Travel Web Application

Creating DataProvider
Adding Table Component
Binding DataProvider
Creating EjbTableSorter
Binding EjbTableSorter
Adding Paging Buttons


Prerequisites

Before you use this tutorial, you must have the NetBeans 5.5 IDE and Visual Web Pack 5.5 installed on your system. Familiarize yourself with the basic parts of the IDE and read the Getting Started With NetBeans Visual Web Pack 5.5 for an introduction to the Visual Web Pack development environment. All steps in this tutorial are based on the default Visual Web Pack project, which uses the JSF 1.2 and Java EE 5 technologies.

Note: To access the TRAVEL database used in this tutorial, you must configure the IDE to use Sun Java System Application Server 9.0 (also known as GlassFish v1 UR1). For information about installing and configuring the Visual Web Pack and the Sun Java System Application Server, see the NetBeans Visual Web Pack 5.5 Installation Instructions.


Creating Travel EJB application
  1. Choose File > New Project (Ctrl-Shift-N) from the main menu.
  2. Select Enterprise Application from the Enterprise category and click Next.
  3. Name the project NewsApp and set the server to Sun Java System Application Server.
  4. Set the J2EE Version to Java EE 5, and select Create EJB Module and Create Web Application Module, if unselected.
  5. Project Name = Travel
  6. Select a Project Location
  7. Uncheck create web-application module and Create Client module
  8. Click Finish.
Creating Entity Classes from Database

  1. Right click Travel-ejb project
  2. Select New Entity Classes form Database
  3. Create a new DataSource
  4. Add a datasource
  5. Select Person Database Table (next)
  6. Click Create Persistance Unit
  7. Click Create
  8. Click Finish



































Writing StateLess Session Bean

  1. Right Click Travel-Ejb Project Select New Session Bean
  2. Type EJB Name : Person, Package com.travel.service
  3. Check Remote and Local
  4. Add Two Libraries to Travel-ejb . ToplinkEssentials is already available in netbeans. Dataprovider.jar is in following path C:/Sunnetbeans-5.5/rave2.0/modules/ext
  5. Open PersonBean.java. Right Click anywhere in
  6. the code . Add Business Method . Add following methods
  7. getPersons,getcount
  8. Build Travel

Here is the code of PersonBean.java
/* Returns sorted list of persons, Nomber of objects returned can be controlled by specifying
maxresukts and startposition */
public List getPersons(int startPosition, int maxResult, SortCriteria[] sc) {
String query = "select object(o) from Person as o";
if(sc != null){
query = query + " " + "order by " + " " + "o."+sc[0].getCriteriaKey();
if(!sc[0].isAscending()){
query = query + " desc";
}
}

Query q = em.createQuery(query);
q.setMaxResults(maxResult);
q.setFirstResult(startPosition);
return q.getResultList();
}
/* Count */
public int getCount() {
Query q = em.createQuery("select count(o) from Person as o ");
Long count = (Long)q.getSingleResult();
if(count != null){
return count.intValue();
}
return 0;
}


Creating Travel Web Application
  1. Create a new Visual Web application
  2. Add Travel-ejb in the Libraries of TravelWeb project

Creating DataProvider

  1. Create PersonDP.java
  2. Right Click any where in the code select Enterprise Resources | call Enterprise Bean
  3. Select Person Bean
  4. Add following methods to PersonDP refreshDP,getRowCount,next,previous
  5. Add two properties startPosition and maxresults


/*
* PersonDP.java
* Created on November 16, 2006, 6:10 PM
*/
package dataproviders;

public class PersonDP extends ObjectListDataProvider{
/** Creates a new instance of PersonDP */
public PersonDP() {
/* needed by netbeans editor */

setObjectType(Person.class);
}
/* fetch a fresh list of persons from ejb layer*/
public void refreshDP(){
clearObjectList();
setList(lookupPersonBean().getPersons(getStartPosition(),getMaxresults(),null));
}
/* Fetch sorted list of persons from ejb layer*/
public void refreshDP(SortCriteria[] sc){
clearObjectList();

setList(lookupPersonBean().getPersons(getStartPosition(),getMaxresults(),sc));
}
/* find count */
public int getRowCount() throws DataProviderException {
if(Beans.isDesignTime()){

return 5;
}

return lookupPersonBean().getCount();}
/* controls page size*/
private int maxresults =5;
/* starting row*/
private int startPosition;
public int getMaxresults() {
return maxresults;
}
public void setMaxresults(int maxresults) {
this.maxresults = maxresults;
}
public int getStartPosition() {
return startPosition;

}
public void setStartPosition(int startPosition) {
this.startPosition = startPosition;

refreshDP();
}
public void setLastPosition() {

startPosition = (lookupPersonBean().getCount()/maxresults) * maxresults;
refreshDP();
}
/*move to next page*/
public void next(){
if(startPosition + maxresults <= lookupPersonBean().getCount()){
startPosition = startPosition + maxresults;
}
refreshDP();
}
public void previous(){
if(startPosition < lookupPersonBean().getCount()){
startPosition = startPosition - maxresults;
}
if (startPosition < 0){
startPosition =0;
}
refreshDP();
}
/* Helper for calling ejb service . Created by netbeans*/
private PersonRemote lookupPersonBean() {
try {
Context c = new InitialContext();
return (PersonRemote) c.lookup("java:comp/env/ejb/PersonBean");
}
catch(NamingException ne) {
Logger.getLogger(getClass().getName()).log(Level.SEVERE,"exception caught" ,ne);
throw new RuntimeException(ne);
}
}

Adding Table Component

  1. Open Page1 in TraveWeb project
  2. Drag and drop a Table from Pallet window'
  3. Add a Property to SessionBean1
  4. Name of the property is persondp type PersonDP
  5. Inittialize private PersonDP persondp = new PersonDP();
  6. Clean Build TravelWeb
  7. Clean Build Travel-ejb (dont touch travle project)
  8. Restart Netbeans
  9. Open Page 1
  10. Right Click table component on the page
  11. Select Table Layout

Select persondp in getDataFrom dialog

Set Table Layout Options

Creating EjbTableSorter

  1. Create EjbTableSorter.java
  2. Create a Property ejbTableSorter in SessionBean1
  3. Initialize ejbTableSorter

/*
* EjbTableSorter.java
* Created on November 16, 2006, 6:42 PM

*/
package dataproviders;

import com.sun.data.provider.DataProviderException;
import com.sun.data.provider.RowKey;
import com.sun.data.provider.SortCriteria;
import com.sun.data.provider.TableDataProvider;
import com.sun.data.provider.TableDataSorter;
import java.beans.Beans;
import java.io.Serializable;

import java.util.Locale;

public class EjbTableSorter implements TableDataSorter , Serializable {
/** Creates a new instance of EjbTableSorter */
public EjbTableSorter() {
}

protected SortCriteria sortCriteria[];
protected Locale sortLocale;
/** Creates a new instance of EjbSorter */

public EjbTableSorter(SortCriteria sortCriteria[], Locale sortLoc
ale) {
this.sortCriteria = sortCriteria;
this.sortLocale = sortLocale;
}
public void setSortCriteria(SortCriteria[] sortCriteria) {
this.sortCriteria = sortCriteria;

}

public SortCriteria[] getSortCriteria() {
return sortCriteria;
}

public void setSortLocale(Locale locale) {
this.sortLocale= locale;

}

public Locale getSortLocale() {

return this.sortLocale;
}
/* returns sorted list of keys. Gets frersh sorted list of objects from ejb layer*/
public RowKey[] sort(TableDataProvider provider, RowKey[] rows) throws DataProviderException {
if(!Beans.isDesignTime()){

PersonDP persondp = (PersonDP)provider;
persondp.refreshDP(sortCriteria);
System.err.println(" Executed sort EjbSorter.java");
return persondp.getRowKeys(rows.length,null);

}
return provider.getRowKeys(rows.length,null);
}
}


Binding EjbTableSorter
  1. Open Page1 in Visual editor
  2. Select TableRowGroup1 in the Outline window
  3. Rigth Click TableRowGroup1 | Property Bindings
  4. Select all radio button in Property Bindings
  5. Select TableDataSorter in left pane
  6. Select SessionBean1 | ejbSorter in right pane
  7. close
    Adding Paging Buttons
  8. Open Page1 in visual editor
  9. Drag and drop GropPanel from pallet windows
  10. Drag and drop Button from pallet window on to the GroupPanel 4 of them
  11. Change the text property of each button using property editor
  12. Double click on the <<| Button
  13. Add following line getSessionBean1().getPersondp().setStartPosition(0);
  14. Add following code in each button
  15. getSessionBean1().getPersondp().previous(); getSessionBean1().getPersondp().next(); getSessionBean1().getPersondp().setLastPosition();
  16. Deploy Travel Project
  17. Run TravelWeb
  18. Voila your your webrowser will look like the screen shot we started with . You can sort the table, navigate the pages. Also the sorting can be removed. Also sorting order is retained even while moving to another page.