omero

Overview

module omero

Exceptions thrown by OMERO server components. Exceptions thrown client side are available defined in each language binding separately, but will usually subclass from "ClientError" For more information, see: https://trac.openmicroscopy.org.uk/ome/wiki/ExceptionHandling including examples of what a appropriate try/catch block would look like.

All exceptions that are thrown by a remote call (any call on a *Prx instance) will be either a subclass of Ice::UserException or Ice::LocalException. Inheritance Hierarchy for Exceptions from the Ice manual shows the entire exception hierarchy. The exceptions described in this file will subclass from Ice::UserException. Other Ice-runtime exceptions subclass from Ice::LocalException.


OMERO Specific:
===============
ServerError (root server exception)
|
|_ InternalException (server bug)
|
|_ ResourceError (non-recoverable)
|  \_ NoProcessorAvailable
|
|_ ConcurrencyException (recoverable)
|  |_ ConcurrentModification (data was changed)
|  |_ OptimisticLockException (changed data conflicts)
|  |_ LockTimeout (took too long to aquire lock)
|  |_ TryAgain (some processing required before server is ready)
|  \_ TooManyUsersException
|     \_ DatabaseBusyException
|
|_ ApiUsageException (misuse of services)
|   |_ OverUsageException (too much)
|   |_ QueryException (bad query string)
|   |_ ValidationException (bad data)
|      |_ ChecksumValidationException (checksum mismatch)
|      \_ FilePathNamingException (repository path badly named)
|
|_ SecurityViolation (some no-no)
|   \_ GroupSecurityViolation
|      |_ PermissionMismatchGroupSecurityViolation
|      \_ ReadOnlyGroupSecurityViolation
|
\_SessionException
|_ RemovedSessionException (accessing a non-extant session)
|_ SessionTimeoutException (session timed out; not yet removed)
\_ ShutdownInProgress      (session on this server will most likely be destroyed)

However, in addition to Ice::LocalException subclasses, the Ice runtime also defines subclasses of Ice::UserException. In some cases, OMERO subclasses from these exceptions. The subclasses shown below are not exhaustive, but show those which an application's exception handler may want to deal with.

Ice::Exception (root of all Ice exceptions)
|
|_ Ice::UserException (super class of all application exceptions)
|  |
|  |_ Glacier2::CannotCreateSessionException (1 of 2 exceptions throwable by createSession)
|  |   |_ omero::AuthenticationException (bad login)
|  |   |_ omero::ExpiredCredentialException (old password)
|  |   |_ omero::WrappedCreateSessionException (any other server error during createSession)
|  |   \_ omero::licenses::NoAvailableLicensesException (see tools/licenses/resources/omero/LicensesAPI.ice)
|  |
|  \_ Glacier2::PermissionDeniedException (other of 2 exceptions throwable by createSession)
|
\_ Ice::LocalException (should generally be considered fatal. See exceptions below)
|
|_ Ice::ProtocolException (something went wrong on the wire. Wrong version?)
|
|_ Ice::RequestFailedException
|   |_ ObjectNotExistException (Service timeout or similar?)
|   \_ OperationNotExistException (Improper use of uncheckedCast?)
|
|_ Ice::UnknownException (server threw an unexpected exception. Bug!)
|
\_ Ice::TimeoutException
\_ Ice::ConnectTimeoutException (Couldn't establish a connection. Retry?)

Module Index

api: The omero::api module defines all the central verbs for working with OMERO.blitz.
cmd: Simplified API that is intended for passing
constants: Most client-intended constants are provided in this module.
grid: Interfaces and types running the backend facilities.
metadatastore: Types used during import.
model: Code-generated types based on the OME Specification.
romio: Primitives for working with binary data.
sys: Various core types.

Class Index

Color: RGBA-color packed into a single long.
Internal: Base class similar to model::IObject but for non-model-objects.
Plane: Sequences cannot subclass other types, so the Plane class extends Internal and wraps a Bytes2D instance.
Point: XY-point in space.
RArray: RCollection mapped to an array on the server of a type given by a random member of the RTypeSeq.
RBool: Boolean wrapper.
RClass: Extends RString and simply provides runtime information to the server that this string is intended as a ""protected"" class parameter.
RCollection: The collection ""protected"" classes permit the passing of sequences of all other RTypes (including other collections) and it is itself nullable.
RDouble: Double wrapper.
RFloat: Float wrapper.
RInt: Integer wrapper.
RInternal: Base type for RTypes whose contents will not be parsed by the server.
RList: RCollection mapped to a java.util.List on the server
RLong: Long Wrapper.
RMap: Similar to RCollection, the RMap class permits the passing of a possible null RTypeDict where any other RType is expected.
RObject: Wrapper for an model::IObject instance.
RSet: RCollection mapped to a java.util.HashSet on the server
RString: String wrapper.
RTime: A simple Time implementation.
RType: Simple base ""protected"" class.

Exception Index

ApiUsageException
AuthenticationException: Thrown when the information provided omero.createSession() or more specifically Glacier2.RouterPrx.createSession() is incorrect.
ChecksumValidationException
ConcurrencyException: Recoverable error caused by simultaneous access of some form.
ConcurrentModification: Currently unused.
DatabaseBusyException: Too many simultaneous database users.
ExpiredCredentialException: Thrown when the password for a user has expried.
FilePathNamingException
GroupSecurityViolation
InternalException: Programmer error.
LockTimeout: Lock cannot be acquired and has timed out.
MissingPyramidException
NoProcessorAvailable: A script cannot be executed because no matching processor was found.
OmeroFSError: OmeroFSError Just one catch-all UserException for the present.
OptimisticLockException: Conflicting changes to the same piece of data.
OverUsageException
PermissionMismatchGroupSecurityViolation
QueryException
ReadOnlyGroupSecurityViolation
RemovedSessionException: Session has been removed.
ResourceError: Unrecoverable error.
SecurityViolation
ServerError
SessionException: Base session exception, though in the OMERO.blitz implementation, all exceptions thrown by the Glacier2 must subclass CannotCreateSessionException.
SessionTimeoutException: Session has timed out and will be removed.
ShutdownInProgress: Server is in the progress of shutting down which will typically lead to the current session being closed.
TryAgain: Background processing needed before server is ready
ValidationException
WrappedCreateSessionException: Thrown when any other server exception causes the session creation to fail.

Sequence Index

Bytes2D: Simple 2D array of bytes.
RTypeSeq: Simple sequence of RType instances.
RTypeSeqSeq

Dictionary Index

RTypeDict: Simple dictionary of RType instances.

Sequences

sequence<::Ice::ByteSeq> Bytes2D

Simple 2D array of bytes.

Used By

Plane::data

[ "java:type:java.util.ArrayList:java.util.List" ] sequence<RType> RTypeSeq

Simple sequence of RType instances. Note: when passing an RTypeSeq over the wire, null sequence is maintained and will be turned into an empty sequence. If nullability is required, see the RCollection types.

Used By

RTypeSeqSeq
RCollection::addAll
RCollection::getValue
RCollection::val

Used By

api::IQuery::projection

Dictionaries

[ "java:type:java.util.HashMap" ] dictionary<string, RType> RTypeDict

Simple dictionary of RType instances. Note: when passing an RTypeDict over the wire, a null map will not be maintained and will be turned into an empty map. If nullability is required, see the RMap type.

Used By

RMap::getValue
RMap::val
api::RTypeDictArray
api::IScript::getScriptWithDetails
api::IScript::runScript
api::ISession::getInputs
api::ISession::getOutputs
cmd::OriginalMetadataResponse::globalMetadata
cmd::OriginalMetadataResponse::seriesMetadata
grid::ScriptProcess::getResults
grid::Table::getAllMetadata
grid::Table::getWhereList
grid::Table::setAllMetadata

Home

Index

omero

Overview

module omero

Module Index

Class Index

Exception Index

Sequence Index

Dictionary Index

Sequences

Used By

Used By

See Also

Used By

Dictionaries

Used By