net.sf.oqt.core

Class CoreFactory

java.lang.Object

net.sf.oqt.core.CoreFactory

public class CoreFactory
extends Object

The CoreFactory centralizes all interactions.

The CoreFactory will be responsible for setting up the real connection to the database and the intialization of the EntityManager. It will also be the central reference for the NullDriver and NullConnection since they will add every query they receive to the list maintained by the CoreFactory.

Bear in mind that the CoreFactory is not intended to be thread-safe.

Author:

phillip

Constructor Summary

Constructors

Constructor and Description
CoreFactory()

Method Summary

Methods

Modifier and Type	Method and Description
static javax.persistence.EntityManager	getEntityManager() Returns a reference to the JPA EntityManager.
static CoreProperties	getProperties() Returns the properties containing all the settings for this application.
static List<String>	getQueries()
static Connection	getRealConnection()
static Driver	getRealDriver()
static void	shutdown() Closes the entity manager and databse connection.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CoreFactory

public CoreFactory()

Method Detail

getProperties

public static final CoreProperties getProperties()

Returns the properties containing all the settings for this application.

Returns:

the properties.

getEntityManager

public static javax.persistence.EntityManager getEntityManager()
                                                        throws ClassNotFoundException,
                                                               InstantiationException,
                                                               IllegalAccessException,
                                                               SQLException

Returns a reference to the JPA EntityManager.

At first call, the EntityManager will be initialized. In order to correctly initialize, the CoreProperties must contains at least the following information:

• DriverName
• URL
• Username (if required for the connection)
• Password (if required for the connection)
• fqns (to get the list of fqns you can use the EntityFinder)

Please bare in mind that the EntityManager will make a connection using the NullDriver, it will never be able to execute statements on the database. It does require a database connection to gather information about your database's capabilities, this connection will be set read-only. The databse itself may be emtpy.

It is important to close the database connection afterwards using the shutdown() method.

Returns:

the entity manager connected using the NullDriver

Throws:

ClassNotFoundException - if the databse driver is not found on the classpath

InstantiationException - if failed to initliaze the database driver

IllegalAccessException - if failed to initliaze the database driver

SQLException - if failed to connect to the database or failed to set the connection to read-only mode.

shutdown

public static void shutdown()
                     throws SQLException

Closes the entity manager and databse connection.

Throws:

SQLException - if failed to close the connection.

getRealConnection

public static Connection getRealConnection()

getRealDriver

public static Driver getRealDriver()

getQueries

public static List<String> getQueries()