omero.api

Interface IContainer

All Superinterfaces:

_IContainerOperations, _IContainerOperationsNC, _ServiceInterfaceOperations, _ServiceInterfaceOperationsNC, Ice.Object, ServiceInterface

All Known Implementing Classes:

_IContainerDisp, _IContainerTie

public interface IContainer
extends Ice.Object, _IContainerOperations, _IContainerOperationsNC, ServiceInterface

Provides methods for dealing with the core Pojos of OME. Included are: Projects, Datasets, Images.

Read API

The names of the methods correlate to how the function operates:

• load: start at container objects and work down toward the leaves, returning hierarchy (Project->Dataset->Image
• find: start at leaf objects and work up to containers, returning hierarchy
• get: retrieves only leaves in the hierarchy (currently only Images)

Options Mechanism

The options are used to add some constraints to the generic method e.g. load hierarchy trees images for a given user. This mechanism should give us enough flexibility to extend the API if necessary, e.g. in some cases we might want to retrieve the images with or without annotations

Most methods take such an options map which is built on the client-side using the Parameters class. The currently supported options are:

• annotator(Integer): If key exists but value null, annotations are retrieved for all objects in the hierarchy where they exist; if a valid experimenterID, annotations are only retrieved for that user. May not be used be all methods. Default: all annotations
• leaves(Boolean): if FALSE omits images from the returned hierarchy. May not be used by all methods. Default: true
• experimenter(Integer): enables filtering on a per-experimenter basis. This option has a method-specific (and possibly context-specific) meaning. Please see the individual methods.
• group(Integer): enables filtering on a per-group basis. The experimenter value is ignored if present and instead a similar filtering is done using all experimenters in the given group.

Write API

As outlined in TODO, the semantics of the Omero write API are based on three rules:

1. IObject-valued fields for which isLoaded() returns false are assumed filtered
2. Collection-valued fields that are null are assumed filtered
3. Collection-valued fields for which getDetails().isFiltered(String collectionName) returns true are assumed filtered. TODO: should we accept isFiltered for all fields?

In each of these cases, the server will reload that given field before attempting to save the graph.

For all write calls, the options map (see below) must contain the userId and the userGroupId for the newly created objects. TODO umask.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ice_staticId
static long	serialVersionUID

Method Summary

Methods inherited from interface omero.api._IContainerOperations

createDataObject_async, createDataObjects_async, findContainerHierarchies_async, getCollectionCount_async, getImages_async, getImagesByOptions_async, getImagesBySplitFilesets_async, getUserImages_async, link_async, loadContainerHierarchy_async, retrieveCollection_async, unlink_async, updateDataObject_async, updateDataObjects_async

Methods inherited from interface omero.api._IContainerOperationsNC

createDataObject_async, createDataObjects_async, findContainerHierarchies_async, getCollectionCount_async, getImages_async, getImagesByOptions_async, getImagesBySplitFilesets_async, getUserImages_async, link_async, loadContainerHierarchy_async, retrieveCollection_async, unlink_async, updateDataObject_async, updateDataObjects_async

Methods inherited from interface Ice.Object

__dispatch, __read, __read, __write, __write, clone, ice_dispatch, ice_dispatch, ice_id, ice_id, ice_ids, ice_ids, ice_isA, ice_isA, ice_operationAttributes, ice_ping, ice_ping, ice_postUnmarshal, ice_preMarshal

Field Detail

ice_staticId

static final java.lang.String ice_staticId

See Also:

Constant Field Values

serialVersionUID

static final long serialVersionUID

See Also:

Constant Field Values