com.sap.tc.cmi.model

Interface ICMIQuery

All Superinterfaces:

ICMIModelClass, ICMIModelClassExecutable

All Known Subinterfaces:

ICMISortableQuery

public interface ICMIQuery
extends ICMIModelClassExecutable, ICMIModelClass

Represents a query in a Model. This type can be called, extended or implemented by applications or frameworks using CMI.

Type Classification:

This interface is part of the Common Model Interface and is intended to be implemented by applications.

Field Summary

static String	ROLE_NAME_INPUT_PARAMETER Constant string for implicit inputParamter relation role.
static String	ROLE_NAME_RESULT Constant string for implicit result relation role.

Method Summary

ICMIModelClassInfo	associatedInputParameterInfo() Returns the metadata for the model class holding the input parameters or null if no metadata is available
ICMIModelObjectCollectionInfo	associatedResultInfo() Returns the metadata for the model object collection holding the query result or null if no such metadata is available
long	countOf() Returns the number all matching model objects for the parameterized query independent of the fetch size.
void	execute() Executes the query.
Object	getInputParameter() Returns the model object which holds the query input parameters or null if the query doesn't support parameters.
Collection	getResult() Returns the collection which matches the query.
boolean	isDirty() Returns true if the query is not yet executed or the result is not consistent with input parameters any more and false otherwise.

Methods inherited from interface com.sap.tc.cmi.model.ICMIModelClass

associatedModel, associatedModelClassInfo

Field Detail

ROLE_NAME_INPUT_PARAMETER

static final String ROLE_NAME_INPUT_PARAMETER

Constant string for implicit inputParamter relation role. If a query implementation also implements ICMIGenericModelClass, it should return the input parameter as a result to

   getRelatedModelObject(ROLE_NAME_INPUT_PARAMETER);
 

An implementation is free to additionally accept its own role name or names.

See Also:

Constant Field Values

ROLE_NAME_RESULT

static final String ROLE_NAME_RESULT

Constant string for implicit result relation role. If a query implementation also implements ICMIGenericModelClass, it should return the query result as a result to

   getRelatedModelObject(ROLE_NAME_RESULT);
 

An implementation is free to additionally accept its own role name or names.

See Also:

Constant Field Values

Method Detail

execute

void execute()
             throws CMIException

Executes the query. When called immediately after query execution isDirty() will return false.

Specified by:

execute in interface ICMIModelClassExecutable

Throws:

CMIException

See Also:

ICMIModelClassExecutable.execute()

countOf

long countOf()

Returns the number all matching model objects for the parameterized query independent of the fetch size. If this is not supported, the method returns -1; if countOf() is too big or too expensive to calculate Long.MAX_VALUE will be returned as long.

isDirty

boolean isDirty()

Returns true if the query is not yet executed or the result is not consistent with input parameters any more and false otherwise.

getInputParameter

Object getInputParameter()

Returns the model object which holds the query input parameters or null if the query doesn't support parameters. The returned object must be compliant with the CMI. That means it must be an instance of a generic Model Class (therefore implementing ICMIGenericModelClass or an instance of a typed Model Class (therefore supporting typed accessor methods etc.)

getResult

Collection getResult()

Returns the collection which matches the query. The collection may or may not be a ICMIModelObjectCollection.

associatedInputParameterInfo

ICMIModelClassInfo associatedInputParameterInfo()

Returns the metadata for the model class holding the input parameters or null if no metadata is available

associatedResultInfo

ICMIModelObjectCollectionInfo associatedResultInfo()

Returns the metadata for the model object collection holding the query result or null if no such metadata is available

Access Rights

This class can be accessed from:

SC	DC	Public Part	ACH
[sap.com] FRAMEWORK	[sap.com] tc/cm/ejb/api	api	BC-JAS-EJB
[sap.com] FRAMEWORK	[sap.com] tc/cmi	default	BC-WD-JAV-RUN