org.nuiton.topia.persistence

Interface TopiaApplicationContext<K extends TopiaPersistenceContext>

All Superinterfaces:

TopiaListenableSupport, TopiaServiceSupport

All Known Implementing Classes:

AbstractTopiaApplicationContext

public interface TopiaApplicationContext<K extends TopiaPersistenceContext>
extends TopiaListenableSupport, TopiaServiceSupport

This is the main entry point for ToPIA. This interface represents the root context of an application.

Most of the time, there is only one instance of this context during the entire lifecycle of a application.

This contract provides facility to :

• create a new TopiaPersistenceContext;
• get meta information about the application (model name, version);
• get meta information about the entities;
• do schema related operations;
• shutdown the application

This contract has an abstract implementation (AbstractTopiaApplicationContext) which is itself extended by a generated AbstractXxxTopiaApplicationContext (where Xxx is the project name), itself extended by XxxTopiaApplicationContext.

The full hierarchy is :

 TopiaApplicationContext (this contract)
  \--AbstractTopiaApplicationContext
      \--AbstractXxxTopiaApplicationContext (generated)
          \--XxxTopiaApplicationContext (generated)
 

(where Xxx is the project name)

Created on 12/20/13.

Since:

3.0

Author:

Tony Chemit : chemit@codelutin.com

Method Summary

Methods

Modifier and Type	Method and Description
void	closeContext() Method to call when the application is going for shutdown.
void	createSchema()
void	dropSchema()
com.google.common.collect.ImmutableMap<String,String>	getConfiguration()
<T extends TopiaEntity> Class<T>	getContractClass(Class<T> klass)
Class<? extends TopiaEntity>[]	getContractClasses()
<T extends TopiaEntity> Class<T>	getImplementationClass(Class<T> klass)
String	getModelName()
String	getModelVersion()
List<Class<?>>	getPersistenceClasses()
String	getSchemaName()
boolean	isClosed()
boolean	isSchemaEmpty()
boolean	isTableExists(Class<?> clazz)
K	newPersistenceContext() Creates a new instance of XxxTopiaPersistenceContext (where Xxx is the project name).
void	showCreateSchema()
void	updateSchema()

Methods inherited from interface org.nuiton.topia.persistence.support.TopiaListenableSupport

addPropertyChangeListener, addTopiaEntitiesVetoable, addTopiaEntityListener, addTopiaEntityListener, addTopiaEntityVetoable, addTopiaEntityVetoable, addTopiaSchemaListener, addTopiaTransactionListener, addTopiaTransactionVetoable, removePropertyChangeListener, removeTopiaEntitiesVetoable, removeTopiaEntityListener, removeTopiaEntityListener, removeTopiaEntityVetoable, removeTopiaEntityVetoable, removeTopiaSchemaListener, removeTopiaTransactionListener, removeTopiaTransactionVetoable

Methods inherited from interface org.nuiton.topia.persistence.support.TopiaServiceSupport

getServices, getServices

Method Detail

newPersistenceContext

K newPersistenceContext()

Creates a new instance of XxxTopiaPersistenceContext (where Xxx is the project name). This is the method to use in order to start a new transaction.

Returns:

a newly created instance of your project's specific TopiaPersistenceContext

See Also:

TopiaPersistenceContext

getModelVersion

String getModelVersion()

getModelName

String getModelName()

getContractClass

<T extends TopiaEntity> Class<T> getContractClass(Class<T> klass)

getImplementationClass

<T extends TopiaEntity> Class<T> getImplementationClass(Class<T> klass)

getContractClasses

Class<? extends TopiaEntity>[] getContractClasses()

getConfiguration

com.google.common.collect.ImmutableMap<String,String> getConfiguration()

getPersistenceClasses

List<Class<?>> getPersistenceClasses()

isSchemaEmpty

boolean isSchemaEmpty()

isTableExists

boolean isTableExists(Class<?> clazz)

getSchemaName

String getSchemaName()

createSchema

void createSchema()

showCreateSchema

void showCreateSchema()

updateSchema

void updateSchema()

dropSchema

void dropSchema()

closeContext

void closeContext()
                  throws TopiaException

Method to call when the application is going for shutdown. It will trigger the shutdown of all the opened children TopiaPersistenceContext

Throws:

TopiaException

isClosed

boolean isClosed()

Returns:

true is the application context is already closed, false otherwise