no.g9.jgrape

Class OsManager

java.lang.Object

no.g9.jgrape.OsManager

All Implemented Interfaces:

Manager

public abstract class OsManager
extends Object
implements Manager

This class is the common superclass for the classes representing the object selection in the service layer.

The implementaion of each of the methods in the Manager iterface follow the same pattern

• Create a new role manager for current root in the object selection.
• Locate the role manager for the target role.
• Call this role managers method to do the wanted action.

Constructor Summary

Constructors

Constructor and Description
OsManager()

Method Summary

Modifier and Type	Method and Description
void	cleanupResult(Object rootResult) Deprecated.
void	cleanupResult(Object rootResult, ClientContext ctx) Deprecated.
void	cleanupResult(Object rootResult, ClientContext ctx, Session session) Postprocess the result after transaction is ended
void	cleanupResultAssociations(Object rootResult, ClientContext ctx, Session session) Postprocess the result after find actions
Object	connect(ObjectSelection objectSelection, ClientContext ctx, Session session) Connect an object to it's parent.
static String	createManagerClassName(String roleName, String pkgName) Generate fully qualified class name from role- and package name.
Object	delete(ObjectSelection objectSelection, ClientContext ctx, Session session) delete an existing object and the objects depending on it.
Object	disconnect(ObjectSelection objectSelection, ClientContext ctx, Session session) Disconnect an object from it's parent.
Object	find(ObjectSelection objectSelection, ClientContext ctx, Session session) Find a single object.
List<?>	findAll(ObjectSelection objectSelection, ClientContext ctx, Session session) Find multiple objects.
Object	get(ObjectSelection objectSelection, ENavigation navigation, ClientContext ctx, Session session)
static Manager	getManager(ObjectSelection objectSelection) Returns the proper manager accordning to objectSelection
Object	insert(ObjectSelection objectSelection, ClientContext ctx, Session session) Insert a new object.
abstract Role	newManager(String applicationName, String roleName) Create a new manager for an object selection role
Object	save(ObjectSelection objectSelection, ClientContext ctx, Session session) Save an object.
Object	update(ObjectSelection objectSelection, ClientContext ctx, Session session) Update an existing object.

Methods inherited from class java.lang.Object

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

Constructor Detail

OsManager

public OsManager()

Method Detail

find

public Object find(ObjectSelection objectSelection,
                   ClientContext ctx,
                   Session session)

Find a single object.

Specified by:

find in interface Manager

Parameters:

objectSelection - The object selection with data from the client.

ctx - The ClientContext desciption.

session - The DataAccess Session.

Returns:

Object found. This could be a list containing the real object.

findAll

public List<?> findAll(ObjectSelection objectSelection,
                       ClientContext ctx,
                       Session session)

Find multiple objects.

Specified by:

findAll in interface Manager

Parameters:

objectSelection - The object selection with data from the client.

ctx - The ClientContext desciption.

session - The DataAccess Session.

Returns:

(missing javadoc)

save

public Object save(ObjectSelection objectSelection,
                   ClientContext ctx,
                   Session session)

Save an object. A save is either an update or an insert.

Specified by:

save in interface Manager

Parameters:

objectSelection - The object selection with data from the client.

ctx - The ClientContext desciption.

session - The DataAccess Session.

Returns:

(missing javadoc)

insert

public Object insert(ObjectSelection objectSelection,
                     ClientContext ctx,
                     Session session)

Insert a new object.

Specified by:

insert in interface Manager

Parameters:

objectSelection - The object selection with data from the client.

ctx - The ClientContext desciption.

session - The DataAccess Session.

Returns:

(missing javadoc)

update

public Object update(ObjectSelection objectSelection,
                     ClientContext ctx,
                     Session session)

Update an existing object.

Specified by:

update in interface Manager

Parameters:

objectSelection - The object selection with data from the client.

ctx - The ClientContext desciption.

session - The DataAccess Session.

Returns:

(missing javadoc)

delete

public Object delete(ObjectSelection objectSelection,
                     ClientContext ctx,
                     Session session)

delete an existing object and the objects depending on it.

Specified by:

delete in interface Manager

Parameters:

objectSelection - The object selection with data from the client.

ctx - The ClientContext desciption.

session - The DataAccess Session.

Returns:

(missing javadoc)

connect

public Object connect(ObjectSelection objectSelection,
                      ClientContext ctx,
                      Session session)

Connect an object to it's parent.

Specified by:

connect in interface Manager

Parameters:

objectSelection - The object selection with data from the client.

ctx - The ClientContext desciption.

session - The DataAccess Session.

Returns:

(missing javadoc)

disconnect

public Object disconnect(ObjectSelection objectSelection,
                         ClientContext ctx,
                         Session session)

Disconnect an object from it's parent.

Specified by:

disconnect in interface Manager

Parameters:

objectSelection - The object selection with data from the client.

ctx - The ClientContext desciption.

session - The DataAccess Session.

Returns:

(missing javadoc)

get

public Object get(ObjectSelection objectSelection,
                  ENavigation navigation,
                  ClientContext ctx,
                  Session session)

Specified by:

get in interface Manager

Parameters:

objectSelection - The object selection with data from the client.

navigation - (missing javadoc)

ctx - The ClientContext desciption.

session - The DataAccess Session.

Returns:

(missing javadoc)

cleanupResult

@Deprecated
public void cleanupResult(Object rootResult)

Deprecated.

Description copied from interface: Manager

Postprocess the result after transaction is ended

Specified by:

cleanupResult in interface Manager

Parameters:

rootResult - (missing javadoc) This method is replaced with cleanupResult(Object rootResult, ClientContext ctx) It is included in the interface for compatibility reasons

cleanupResult

@Deprecated
public void cleanupResult(Object rootResult,
                                      ClientContext ctx)

Deprecated.

Description copied from interface: Manager

Postprocess the result after transaction is ended

Specified by:

cleanupResult in interface Manager

Parameters:

rootResult - (missing javadoc)

ctx - (missing javadoc)

cleanupResult

public void cleanupResult(Object rootResult,
                          ClientContext ctx,
                          Session session)

Description copied from interface: Manager

Postprocess the result after transaction is ended

Specified by:

cleanupResult in interface Manager

Parameters:

rootResult - (missing javadoc)

ctx - (missing javadoc)

session - (missing javadoc)

cleanupResultAssociations

public void cleanupResultAssociations(Object rootResult,
                                      ClientContext ctx,
                                      Session session)

Description copied from interface: Manager

Postprocess the result after find actions

Specified by:

cleanupResultAssociations in interface Manager

Parameters:

rootResult - (missing javadoc)

ctx - (missing javadoc)

session - (missing javadoc)

getManager

public static Manager getManager(ObjectSelection objectSelection)

Returns the proper manager accordning to objectSelection

Parameters:

objectSelection - (missing javadoc)

Returns:

(missing javadoc)

createManagerClassName

public static String createManagerClassName(String roleName,
                                            String pkgName)

Generate fully qualified class name from role- and package name.

Parameters:

roleName - OS node name

pkgName - Package

Returns:

"package.RoleManager"

newManager

public abstract Role newManager(String applicationName,
                                String roleName)

Create a new manager for an object selection role

Parameters:

applicationName - (missing javadoc)

roleName - (missing javadoc)

Returns:

The create RoleManager