Skip to main content

Version 2.0.1 Released!

After a long period of happy exPOJO usage on a variety of different projects we saw some room for simplification and improvement and version 2.0.1 is the result of this.

We've made some excellent refinements and added some new features:

New ModelExposerFactory
The most notable refinement is that the PersistenceProviderFactory has been renamed to ModelExposerFactory which is extended within your application to become the single object reponsible for producing ModelExposer's when required.

Previously ModelExposers were produced by the ExpojoServletContextListener which unfortunately tied the use of exPOJO to web based applications. Now that ModelExposer's are produced by a separate ModelExposerFactory that is independent of the servlet API exPOJO can be used equally well in web app and traditional Java applications.

Even within web based development there is often the need for background threads running as part of the web app or running as services outside of a servlet container and this recent refinement of the exPOJO design makes it possible to implement exPOJO in both the web app and supporting services using common source code.

Simple Wrapping of method within a transaction context
The basic pattern for using the ModelExposer is as follows:

// Either find a ModelExposer associated with the current context or create
// a new one each time - the choice is yours. The context could be a HTTP
// session or anything you want it to be.
modelExposer = context.getModelExposer();

if ( modelExposer == null )
modelExposer = ModelExposerFactory().get().createModelExposer();

// Inject (attach) the ModelExposer to this thread so that within any
// methods executed by this thread the model exposer is instantly
// accessible without requiring direct injection of individual
// objects via ModelExposer.get()

// Get the PersistenceProvider and begin a transaction
PersistenceProvider pp = modelExposer.getPp();


// Typically call a method to perform work like servicing a HTTP request or
// executing an iteration of a periodic background task
// do something with your model - load objects, navigate along
// relationships etc., populating UI components: pages, forms, fields etc.,

// example of code that may be executed within a method that does the work:
// UI elements, model objects etc., all have access to the repositories and
// services and the methods of the PersistenceProvider by simply calling the
// convenience methods eg.,

// User user = UserRepository.get().findUser(username);

// Order order = OrderService.get().createOrder(customer);

// Commit the transaction
catch (Exception e)
// rollback if required etc.,

// Detach from this thread - as threads are pooled in a servlet container we must
// not leave the model exposer attached to any particular thread after it
// has finished servicing the current http request

In exPOJO 1.x what tended to happen was that this familiar pattern ended up being implemented in multiple places throughout the code. In 2.x a new method in ModelExposer makes it simple to wrap code in such a pattern without having to repeatedly write implementations of the whole pattern. The implementation within ModelExposer can simply be reused, wrapping any doWork() style method that you require. The doWork() style method in ModelExposer is actually called execute() and it supports the passing of parameters if required.


Popular posts from this blog

expojo 1.3.2 released!

exPOJO 1.3.2 has just been released. exPOJO is a super lightweight framework that provides: dependency injection in Java (no XML - say goodbye to Spring forever!) using the easy to use ModelExposer class. high productivity persistence using the 'exposed POJO model pattern' to access your objects via Hibernate or JDO. an ORM wrapper that helps you to build code that is portable across different ORMs. Version 1.3.2 adds an exceptionally useful 'auto query resource clean up' class donated by Guido Anzuoni from Object Magic: . Using this class to encapsulate returned query collection result you don't need to explicitly clean up the query resources associated with those results. Guido's class 'automagically' cleans up the resources when it is garbage collected. This is great for users of the OpenPersistenceManagerInView pattern. Currently Guido's class works with JDO only. Version 1.3.2 also adds a new flushChanges method which

exPOJO: used in major financial company's core enterprise software

A major provider of financial IT resources based in Sydney, Australia is using exPOJO to provide access to their core enterprise objects in a generic way. A variety of their integral applications use exPOJO to expose their core enterprise objects in a consistent and generic way saving thousands of developer hours whenever a new application needs to be created. The exposed model was implemented using exPOJOs JPOX/JDO wrapper (a Hibernate wrapper is also available) as their transparent persistence solution. JPOX was chosen because it provides virtually 100% transparent persistence at the domain model level and has a significant performance edge due to its ability to perform build time byte code enhancement instead of relying on much slower run time reflection to do its job. The domain model objects are all pure POJOs without any need for annotations or the need to add extra methods to enable the underlying ORM to function correctly. All domain models are designed and maintained using t