omero.cmd

Interface IRequest

All Known Subinterfaces:

IGraphModifyRequest, WrappableRequest<X>

All Known Implementing Classes:

Chgrp2I, ChgrpFacadeI, Chmod2I, ChmodFacadeI, Chown2I, ChownFacadeI, CurrentSessionsRequestI, Delete2I, DeleteFacadeI, DiskUsageI, DoAllI, LegalGraphTargetsI, ListRequestsI, ManagedImportRequestI, ManageImageBinariesI, OriginalMetadataRequestI, RawAccessRequestI, ResetPasswordRequestI, SaveI, SendEmailRequestI, SkipHeadI, TimingI, UpdateSessionTimeoutRequestI, UsedFilesRequestI

public interface IRequest

SPI Orthogonal interface hierarchy of types for working with the Request hierarchy. All request implementations handled by the server must also be instances of IRequest, which defines the lifecycle methods needed for processing.

Since:

Beta4.3.2

Method Summary

Modifier and Type	Method and Description
void	buildResponse(int step, Object object) Post-transaction chance to map from the return value of step(int) to a Response object.
void	finish() Method within the transaction boundaries after all processing has occurred.
Map<String,String>	getCallContext() Returns the desired call context for this request.
omero.cmd.Response	getResponse() Returns the current response value.
void	init(Helper helper) Method called within the transaction boundaries before any processing occurs.
Object	step(int step) Single uncancellable action which will be performed by this IRequest.

Method Detail

getCallContext

Map<String,String> getCallContext()

Returns the desired call context for this request. Some request implementations will require "omero.group":"-1" for example and will hard-code that value. Others may permit users to pass in the desired values which will be merged into the static Map as desired.

Returns:

the call context for this request

init

void init(Helper helper)
   throws HandleI.Cancel

Method called within the transaction boundaries before any processing occurs. Implementations must properly initialize the "step" field of the Status object by calling Helper.setSteps(int). This count will define how many times the step(int) method will be called. The Helper instance passed in contains those resources needed by IRequests to interact with data and should be stored for later use.

Parameters:

helper - the helper for this request

Throws:

HandleI.Cancel - if this request is cancelled

step

Object step(int step)
     throws HandleI.Cancel

Single uncancellable action which will be performed by this IRequest. The return value can be an ome.model object that is attached to the current thread and transaction. After processing and detachment from the transaction, the object will be passed to buildResponse(int, Object) for conversion and storage.

Parameters:

step - the step number

Returns:

an object to be used in building the response

Throws:

HandleI.Cancel - if this request is cancelled

finish

void finish()
     throws HandleI.Cancel

Method within the transaction boundaries after all processing has occurred. A thrown HandleI.Cancel will still rollback the current transaction.

Throws:

HandleI.Cancel - if this request is cancelled

Since:

5.0.0

buildResponse

void buildResponse(int step,
                   Object object)

Post-transaction chance to map from the return value of step(int) to a Response object.

Parameters:

step - the step number

object - an object to be used in building the response

getResponse

omero.cmd.Response getResponse()

Returns the current response value. This method should be protected by synchronization where necessary, and should never raise an exception. It is also guaranteed to be called so that any state cleanup that is necessary can take place here.

Returns:

the response to this request