Package fr.igred.omero.repository

Class GenericRepositoryObjectWrapper<T extends DataObject>

java.lang.Object

fr.igred.omero.GenericObjectWrapper<T>

fr.igred.omero.repository.GenericRepositoryObjectWrapper<T>

Type Parameters:

T - Subclass of DataObject

Direct Known Subclasses:

DatasetWrapper, FolderWrapper, ImageWrapper, PlateAcquisitionWrapper, PlateWrapper, ProjectWrapper, ScreenWrapper, WellWrapper

public abstract class GenericRepositoryObjectWrapper<T extends DataObject>
extends GenericObjectWrapper<T>

Generic class containing a DataObject (or a subclass) object.

Field Summary

Fields inherited from class fr.igred.omero.GenericObjectWrapper

data

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	GenericRepositoryObjectWrapper(T object)	Constructor of the class GenericRepositoryObjectWrapper.

Method Summary

Modifier and Type	Method	Description
long	addFile(Client client, File file)	Links a file to the object
void	addMapAnnotation(Client client, MapAnnotationWrapper mapAnnotation)	Adds a List of Key-Value pair to the object
void	addPairKeyValue(Client client, String key, String value)	Adds a single Key-Value pair to the object.
void	addTable(Client client, TableWrapper table)	Adds a table to the object in OMERO
void	addTag(Client client, TagAnnotationWrapper tag)	Adds a tag to the object in OMERO, if possible.
void	addTag(Client client, Long id)	Adds multiple tags to the object in OMERO, if possible.
void	addTag(Client client, String name, String description)	Adds a newly created tag to the object in OMERO, if possible.
protected void	addTag(Client client, TagAnnotationData tagData)	Protected function.
void	addTags(Client client, TagAnnotationWrapper... tags)	Adds multiple tag to the object in OMERO, if possible.
void	addTags(Client client, Long... ids)	Adds multiple tags by ID to the object in OMERO, if possible.
protected abstract String	annotationLinkType()	Returns the type of annotation link for this object
abstract String	getDescription()	Gets the object description
List<FileAnnotationWrapper>	getFileAnnotations(Client client)	Returns the file annotations
Map<String,String>	getKeyValuePairs(Client client)	Gets the List of NamedValue (Key-Value pair) associated to an object.
abstract String	getName()	Gets the object name.
TableWrapper	getTable(Client client, Long fileId)	Gets a certain table linked to the object in OMERO
List<TableWrapper>	getTables(Client client)	Gets all tables linked to the object in OMERO.
List<TagAnnotationWrapper>	getTags(Client client)	Gets all tag linked to an object in OMERO, if possible.
String	getValue(Client client, String key)	Gets the value from a Key-Value pair associated to the object
protected void	removeLink(Client client, String linkType, long childId)	Removes the link of the given type with the given child ID.
<A extends GenericAnnotationWrapper<?>> void	unlink(Client client, A annotation)	Unlinks the given annotation from the current object.

Methods inherited from class fr.igred.omero.GenericObjectWrapper

canAnnotate, canChgrp, canChown, canDelete, canEdit, canLink, delete, getCreated, getGroupId, getId, getOwner, saveAndUpdate, toString, wrap, wrap

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

GenericRepositoryObjectWrapper

protected GenericRepositoryObjectWrapper(T object)

Constructor of the class GenericRepositoryObjectWrapper.

Parameters:

object - The object contained in the GenericRepositoryObjectWrapper.

Method Detail

annotationLinkType

protected abstract String annotationLinkType()

Returns the type of annotation link for this object

Returns:

See above.

getName

public abstract String getName()

Gets the object name.

Returns:

See above.

getDescription

public abstract String getDescription()

Gets the object description

Returns:

See above.

addTag

public void addTag(Client client,
                   String name,
                   String description)
            throws ServiceException,
                   AccessException,
                   ExecutionException

Adds a newly created tag to the object in OMERO, if possible.

Parameters:

client - The client handling the connection.

name - Tag Name.

description - Tag description.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

addTag

public void addTag(Client client,
                   TagAnnotationWrapper tag)
            throws ServiceException,
                   AccessException,
                   ExecutionException

Adds a tag to the object in OMERO, if possible.

Parameters:

client - The client handling the connection.

tag - Tag to be added.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

addTag

protected void addTag(Client client,
                      TagAnnotationData tagData)
               throws ServiceException,
                      AccessException,
                      ExecutionException

Protected function. Adds a tag to the object in OMERO, if possible.

Parameters:

client - The client handling the connection.

tagData - Tag to be added.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

addTag

public void addTag(Client client,
                   Long id)
            throws ServiceException,
                   AccessException,
                   ExecutionException

Adds multiple tags to the object in OMERO, if possible.

Parameters:

client - The client handling the connection.

id - ID of the tag to add to the object.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

addTags

public void addTags(Client client,
                    TagAnnotationWrapper... tags)
             throws ServiceException,
                    AccessException,
                    ExecutionException

Adds multiple tag to the object in OMERO, if possible.

Parameters:

client - The client handling the connection.

tags - Array of TagAnnotationWrapper to add.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

addTags

public void addTags(Client client,
                    Long... ids)
             throws ServiceException,
                    AccessException,
                    ExecutionException

Adds multiple tags by ID to the object in OMERO, if possible.

Parameters:

client - The client handling the connection.

ids - Array of tag id in OMERO to add.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

getTags

public List<TagAnnotationWrapper> getTags(Client client)
                                   throws ServiceException,
                                          AccessException,
                                          ExecutionException

Gets all tag linked to an object in OMERO, if possible.

Parameters:

client - The client handling the connection.

Returns:

Collection of TagAnnotationWrapper each containing a tag linked to the object.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

addPairKeyValue

public void addPairKeyValue(Client client,
                            String key,
                            String value)
                     throws ServiceException,
                            AccessException,
                            ExecutionException

Adds a single Key-Value pair to the object.

Parameters:

client - The client handling the connection.

key - Name of the key.

value - Value associated to the key.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

getKeyValuePairs

public Map<String,String> getKeyValuePairs(Client client)
                                          throws ServiceException,
                                                 AccessException,
                                                 ExecutionException

Gets the List of NamedValue (Key-Value pair) associated to an object.

Parameters:

client - The client handling the connection.

Returns:

Collection of NamedValue.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

getValue

public String getValue(Client client,
                       String key)
                throws ServiceException,
                       AccessException,
                       ExecutionException

Gets the value from a Key-Value pair associated to the object

Parameters:

client - The client handling the connection.

key - Key researched.

Returns:

Value associated to the key.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

NoSuchElementException - Key not found.

ExecutionException - A Facility can't be retrieved or instantiated.

addMapAnnotation

public void addMapAnnotation(Client client,
                             MapAnnotationWrapper mapAnnotation)
                      throws ServiceException,
                             AccessException,
                             ExecutionException

Adds a List of Key-Value pair to the object

The list is contained in the MapAnnotationWrapper

Parameters:

client - The client handling the connection.

mapAnnotation - MapAnnotationWrapper containing a list of NamedValue.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

addTable

public void addTable(Client client,
                     TableWrapper table)
              throws ServiceException,
                     AccessException,
                     ExecutionException

Adds a table to the object in OMERO

Parameters:

client - The client handling the connection.

table - Table to add to the object.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

getTable

public TableWrapper getTable(Client client,
                             Long fileId)
                      throws ServiceException,
                             AccessException,
                             ExecutionException

Gets a certain table linked to the object in OMERO

Parameters:

client - The client handling the connection.

fileId - FileId of the table researched.

Returns:

TableWrapper containing the table information.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

getTables

public List<TableWrapper> getTables(Client client)
                             throws ServiceException,
                                    AccessException,
                                    ExecutionException

Gets all tables linked to the object in OMERO.

Parameters:

client - The client handling the connection.

Returns:

List of TableWrapper containing the tables information.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

addFile

public long addFile(Client client,
                    File file)
             throws ExecutionException,
                    InterruptedException

Links a file to the object

Parameters:

client - The client handling the connection.

file - File to add.

Returns:

ID of the file created in OMERO.

Throws:

ExecutionException - A Facility can't be retrieved or instantiated.

InterruptedException - The thread was interrupted.

getFileAnnotations

public List<FileAnnotationWrapper> getFileAnnotations(Client client)
                                               throws ExecutionException,
                                                      ServiceException,
                                                      AccessException

Returns the file annotations

Parameters:

client - The client handling the connection.

Returns:

The list of tile annotations.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

unlink

public <A extends GenericAnnotationWrapper<?>> void unlink(Client client,
                                                           A annotation)
                                                    throws ServiceException,
                                                           AccessException,
                                                           ExecutionException,
                                                           OMEROServerError,
                                                           InterruptedException

Unlinks the given annotation from the current object.

Type Parameters:

A - The type of the annotation.

Parameters:

client - The client handling the connection.

annotation - An annotation.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

OMEROServerError - If the thread was interrupted.

InterruptedException - If block(long) does not return.

removeLink

protected void removeLink(Client client,
                          String linkType,
                          long childId)
                   throws ServiceException,
                          OMEROServerError,
                          AccessException,
                          ExecutionException,
                          InterruptedException

Removes the link of the given type with the given child ID.

Parameters:

client - The client handling the connection.

linkType - The link type.

childId - Link child ID.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

ExecutionException - A Facility can't be retrieved or instantiated.

OMEROServerError - If the thread was interrupted.

InterruptedException - If block(long) does not return.