org.opensubsystems.core.logic
Interface BasicDataController

All Superinterfaces:

DataController, StatelessController

All Known Subinterfaces:

ModifiableDataController

All Known Implementing Classes:

BasicDataControllerImpl, ModifiableDataControllerImpl

public interface BasicDataController
extends DataController

Basic operations to perform with data objects by the application. Each data object needs to be somehow created and removed (if not for anything else at least for automated tests).

Version:

$Id: BasicDataController.java,v 1.7 2007/02/01 07:18:10 bastafidli Exp $

Author:

Miro Halas

Code reviewer:

Miro Halas

Code reviewed:

1.3 2005/02/26 10:00:58 bastafidli

Method Summary

DataObject	create(DataObject data) Create data object.
void	delete(int iId) Delete data object.

Methods inherited from interface org.opensubsystems.core.logic.DataController

get

Methods inherited from interface org.opensubsystems.core.logic.StatelessController

constructor

Method Detail

create

DataObject create(DataObject data)
                  throws OSSException,
                         java.rmi.RemoteException

Create data object.

Parameters:

data - - data object to create

Returns:

DataObject - newly created data object, null if user doesn't have access to that data object granted

Throws:

OSSException - - an error has occured

java.rmi.RemoteException - - required since this method can be called remotely

delete

void delete(int iId)
            throws OSSException,
                   java.rmi.RemoteException

Delete data object. This method will succeed only if the data object identified by specified id exists in the current domain, which is a domain identified by CallContext.getInstance().getCurrentDomainId(). If the object doesn't exist in the current domain, this method should throw an exception and shouldn't delete anything. If the client needs to delete data object in a different domain than the current one, it needs to provide for it its' own specific interface.

Parameters:

iId - - id of the data object to delete

Throws:

OSSException - - an error has occured

java.rmi.RemoteException - - required since this method can be called remotely