org.opensubsystems.core.logic
Interface DataController

All Superinterfaces:

StatelessController

All Known Subinterfaces:

BasicDataController, ModifiableDataController

All Known Implementing Classes:

BasicDataControllerImpl, DataControllerImpl, ModifiableDataControllerImpl

public interface DataController
extends StatelessController

Base interface for all controllers managing data objects. The primary purpose of data controller is to implement additional functionality on top of the persistence layer such as security checks, logging, etc. Every data object has to be accessible somehow to be available to the presentation tier and controller, which makes data object accessible should implement this interface.

Version:

$Id: DataController.java,v 1.7 2007/01/28 06:54:54 bastafidli Exp $

Author:

Miro Halas

Code reviewer:

Miro Halas

Code reviewed:

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

Method Summary

DataObject

get(int iId) Get data object knowing just the unique id.

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

constructor

Method Detail

get

DataObject get(int iId)
               throws OSSException,
                      java.rmi.RemoteException

Get data object knowing just the unique id. 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 retrieve anything. If the client needs to retrieve 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 retrieve

Returns:

DataObject - retrieved data object, null if the data object doesn't exists or 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