Package omero.api
Interface _IShareOperationsNC
-
- All Superinterfaces:
_ServiceInterfaceOperationsNC
- All Known Subinterfaces:
IShare
- All Known Implementing Classes:
_IShareDisp,_IShareTie
public interface _IShareOperationsNC extends _ServiceInterfaceOperationsNC
Provides method for sharing - collaboration process for images, datasets, projects.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidactivate_async(AMD_IShare_activate __cb, long shareId)Turns on the access control lists attached to the given share for the current session.voidaddComment_async(AMD_IShare_addComment __cb, long shareId, java.lang.String comment)CreatesTextAnnotationcomment forSessionshare.voidaddGuest_async(AMD_IShare_addGuest __cb, long shareId, java.lang.String emailAddress)Adds guest email address to the share.voidaddGuests_async(AMD_IShare_addGuests __cb, long shareId, java.util.List<java.lang.String> emailAddresses)Adds guest email addresses to the share.voidaddObject_async(AMD_IShare_addObject __cb, long shareId, IObject iobject)voidaddObjects_async(AMD_IShare_addObjects __cb, long shareId, java.util.List<IObject> iobjects)voidaddReply_async(AMD_IShare_addReply __cb, long shareId, java.lang.String comment, TextAnnotation replyTo)CreatesTextAnnotationcomment which replies to an existing comment.voidaddUser_async(AMD_IShare_addUser __cb, long shareId, Experimenter exp)AddsExperimenterexperimenter toSessionshare.voidaddUsers_async(AMD_IShare_addUsers __cb, long shareId, java.util.List<Experimenter> exps)AddsExperimenterexperimenters toSessionshare.voidcloseShare_async(AMD_IShare_closeShare __cb, long shareId)ClosesSessionshare.voidcreateShare_async(AMD_IShare_createShare __cb, java.lang.String description, RTime expiration, java.util.List<IObject> items, java.util.List<Experimenter> exps, java.util.List<java.lang.String> guests, boolean enabled)voiddeactivate_async(AMD_IShare_deactivate __cb)Turns off the access control lists with the current share.voiddeleteComment_async(AMD_IShare_deleteComment __cb, Annotation comment)DeletesAnnotationcomment from the database.voidgetActiveConnections_async(AMD_IShare_getActiveConnections __cb, long shareId)Gets actual active connections toSessionshare.voidgetAllGuests_async(AMD_IShare_getAllGuests __cb, long shareId)Get the email addresses for all share guests.voidgetAllMembers_async(AMD_IShare_getAllMembers __cb, long shareId)Get allExperimenterusers who are a member of the share.voidgetAllUsers_async(AMD_IShare_getAllUsers __cb, long shareId)Get a single set containing theomero.model.Experimenter.getOmeNamelogin names of the users as well email addresses for guests.voidgetCommentCount_async(AMD_IShare_getCommentCount __cb, java.util.List<java.lang.Long> shareIds)Returns a map from share id to comment count.voidgetComments_async(AMD_IShare_getComments __cb, long shareId)Looks up allAnnotationcomments which belong to theSessionshare.voidgetContentMap_async(AMD_IShare_getContentMap __cb, long shareId)Returns the contents of the share keyed by type.voidgetContents_async(AMD_IShare_getContents __cb, long shareId)voidgetContentSize_async(AMD_IShare_getContentSize __cb, long shareId)Returns the number of items in the share.voidgetContentSubList_async(AMD_IShare_getContentSubList __cb, long shareId, int start, int finish)Returns a range of items from the share.voidgetEvents_async(AMD_IShare_getEvents __cb, long shareId, Experimenter exp, RTime from, RTime to)Gets events forSessionshare perExperimenterexperimenter for period of time.voidgetMemberCount_async(AMD_IShare_getMemberCount __cb, java.util.List<java.lang.Long> shareIds)Returns a map from share id to the count of total members (including the owner).voidgetMemberShares_async(AMD_IShare_getMemberShares __cb, boolean active)Gets all shares where currentExperimenteris a member.voidgetMemberSharesFor_async(AMD_IShare_getMemberSharesFor __cb, Experimenter user, boolean active)Gets all shares where givenExperimenteris a member.voidgetOwnShares_async(AMD_IShare_getOwnShares __cb, boolean active)Gets all owned shares for the currentExperimenter.voidgetPastConnections_async(AMD_IShare_getPastConnections __cb, long shareId)Gets previous connections toSessionshare.voidgetShare_async(AMD_IShare_getShare __cb, long shareId)Gets a share as aSessionwith all related:Annotationcomments,Experimentermembers, fully loaded.voidgetSharesOwnedBy_async(AMD_IShare_getSharesOwnedBy __cb, Experimenter user, boolean active)Gets all shares owned by the givenExperimenter.voidinvalidateConnection_async(AMD_IShare_invalidateConnection __cb, long shareId, Experimenter exp)Makes the connection invalid forSessionshare for specified user.voidnotifyMembersOfShare_async(AMD_IShare_notifyMembersOfShare __cb, long shareId, java.lang.String subject, java.lang.String message, boolean html)Notifies via email selected members of share.voidremoveGuest_async(AMD_IShare_removeGuest __cb, long shareId, java.lang.String emailAddress)Removes guest email address from share.voidremoveGuests_async(AMD_IShare_removeGuests __cb, long shareId, java.util.List<java.lang.String> emailAddresses)Removes guest email addresses from the share.voidremoveObject_async(AMD_IShare_removeObject __cb, long shareId, IObject iobject)voidremoveObjects_async(AMD_IShare_removeObjects __cb, long shareId, java.util.List<IObject> iobjects)Remove existing items from the share.voidremoveUser_async(AMD_IShare_removeUser __cb, long shareId, Experimenter exp)RemovesExperimenterexperimenter fromSessionshare.voidremoveUsers_async(AMD_IShare_removeUsers __cb, long shareId, java.util.List<Experimenter> exps)RemovesExperimenterexperimenters fromSessionshare.voidsetActive_async(AMD_IShare_setActive __cb, long shareId, boolean active)voidsetDescription_async(AMD_IShare_setDescription __cb, long shareId, java.lang.String description)voidsetExpiration_async(AMD_IShare_setExpiration __cb, long shareId, RTime expiration)
-
-
-
Method Detail
-
activate_async
void activate_async(AMD_IShare_activate __cb, long shareId) throws ServerError
Turns on the access control lists attached to the given share for the current session. Warning: this will slow down the execution of the current session for all database reads. Writing to the database will not be allowed. If share does not exist or is not accessible (non-members) or is disabled, then anValidationExceptionis thrown.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
deactivate_async
void deactivate_async(AMD_IShare_deactivate __cb) throws ServerError
Turns off the access control lists with the current share.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
getShare_async
void getShare_async(AMD_IShare_getShare __cb, long shareId) throws ServerError
Gets a share as aSessionwith all related:Annotationcomments,Experimentermembers, fully loaded. Unlike the other methods on this interface, if the sessionId is unknown, does not throw aValidationException.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
getMemberCount_async
void getMemberCount_async(AMD_IShare_getMemberCount __cb, java.util.List<java.lang.Long> shareIds) throws ServerError
Returns a map from share id to the count of total members (including the owner). This is represented byShareMemberlinks.- Parameters:
__cb- The callback object for the operation.shareIds- Not null.- Throws:
ValidationException- if a given share does not existServerError
-
getOwnShares_async
void getOwnShares_async(AMD_IShare_getOwnShares __cb, boolean active) throws ServerError
Gets all owned shares for the currentExperimenter.- Parameters:
__cb- The callback object for the operation.active- if true, then only shares which can be used for login will be returned. All draft shares (seecreateShare) and closed shares (seecloseShare) will be filtered.- Throws:
ServerError
-
getMemberShares_async
void getMemberShares_async(AMD_IShare_getMemberShares __cb, boolean active) throws ServerError
Gets all shares where currentExperimenteris a member.- Parameters:
__cb- The callback object for the operation.active- if true, then only shares which can be used for login will be returned. All draft shares (seecreateShare) and closed shares (seecloseShare) will be filtered.- Throws:
ServerError
-
getSharesOwnedBy_async
void getSharesOwnedBy_async(AMD_IShare_getSharesOwnedBy __cb, Experimenter user, boolean active) throws ServerError
Gets all shares owned by the givenExperimenter.- Parameters:
__cb- The callback object for the operation.user- the experimenteractive- if true, then only shares which can be used for login will be returned. All draft shares (seecreateShare) and closed shares (seecloseShare) will be filtered.- Throws:
ServerError
-
getMemberSharesFor_async
void getMemberSharesFor_async(AMD_IShare_getMemberSharesFor __cb, Experimenter user, boolean active) throws ServerError
Gets all shares where givenExperimenteris a member.- Parameters:
__cb- The callback object for the operation.user- the experimenteractive- if true, then only shares which can be used for login will be returned. All draft shares (seecreateShare) and closed shares (seecloseShare) will be filtered.- Throws:
ServerError
-
getContents_async
void getContents_async(AMD_IShare_getContents __cb, long shareId) throws ServerError
- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
getContentSubList_async
void getContentSubList_async(AMD_IShare_getContentSubList __cb, long shareId, int start, int finish) throws ServerError
Returns a range of items from the share.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
getContentSize_async
void getContentSize_async(AMD_IShare_getContentSize __cb, long shareId) throws ServerError
Returns the number of items in the share.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
getContentMap_async
void getContentMap_async(AMD_IShare_getContentMap __cb, long shareId) throws ServerError
Returns the contents of the share keyed by type.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
createShare_async
void createShare_async(AMD_IShare_createShare __cb, java.lang.String description, RTime expiration, java.util.List<IObject> items, java.util.List<Experimenter> exps, java.util.List<java.lang.String> guests, boolean enabled) throws ServerError
- Parameters:
__cb- The callback object for the operation.enabled- if true, then the share is immediately available for use. If false, then the share is in draft state. All methods on this interface will work for shares exceptactivate. Similarly, the share password cannot be used by guests to login.- Throws:
ServerError
-
setDescription_async
void setDescription_async(AMD_IShare_setDescription __cb, long shareId, java.lang.String description) throws ServerError
- Throws:
ServerError
-
setExpiration_async
void setExpiration_async(AMD_IShare_setExpiration __cb, long shareId, RTime expiration) throws ServerError
- Throws:
ServerError
-
setActive_async
void setActive_async(AMD_IShare_setActive __cb, long shareId, boolean active) throws ServerError
- Throws:
ServerError
-
closeShare_async
void closeShare_async(AMD_IShare_closeShare __cb, long shareId) throws ServerError
ClosesSessionshare. No further logins will be possible and all getters (e.g.getMemberShares,getOwnShares, ...) will filter these results ifonlyActiveis true.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
addObjects_async
void addObjects_async(AMD_IShare_addObjects __cb, long shareId, java.util.List<IObject> iobjects) throws ServerError
Adds newIObjectitems toSessionshare. Conceptually callsaddObjectsfor every argument passed, but the graphs will be merged.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
addObject_async
void addObject_async(AMD_IShare_addObject __cb, long shareId, IObject iobject) throws ServerError
Adds newIObjectitem toSessionshare. The entire object graph with the exception of all Details will be loaded into the share. If you would like to load a single object, then pass an unloaded reference.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
removeObjects_async
void removeObjects_async(AMD_IShare_removeObjects __cb, long shareId, java.util.List<IObject> iobjects) throws ServerError
Remove existing items from the share.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
removeObject_async
void removeObject_async(AMD_IShare_removeObject __cb, long shareId, IObject iobject) throws ServerError
- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
getCommentCount_async
void getCommentCount_async(AMD_IShare_getCommentCount __cb, java.util.List<java.lang.Long> shareIds) throws ServerError
Returns a map from share id to comment count.- Parameters:
__cb- The callback object for the operation.shareIds- Not null.- Throws:
ValidationException- if a given share does not existServerError
-
getComments_async
void getComments_async(AMD_IShare_getComments __cb, long shareId) throws ServerError
Looks up allAnnotationcomments which belong to theSessionshare.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
addComment_async
void addComment_async(AMD_IShare_addComment __cb, long shareId, java.lang.String comment) throws ServerError
CreatesTextAnnotationcomment forSessionshare.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
addReply_async
void addReply_async(AMD_IShare_addReply __cb, long shareId, java.lang.String comment, TextAnnotation replyTo) throws ServerError
CreatesTextAnnotationcomment which replies to an existing comment.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
deleteComment_async
void deleteComment_async(AMD_IShare_deleteComment __cb, Annotation comment) throws ServerError
DeletesAnnotationcomment from the database.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
getAllMembers_async
void getAllMembers_async(AMD_IShare_getAllMembers __cb, long shareId) throws ServerError
Get allExperimenterusers who are a member of the share.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
getAllGuests_async
void getAllGuests_async(AMD_IShare_getAllGuests __cb, long shareId) throws ServerError
Get the email addresses for all share guests.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
getAllUsers_async
void getAllUsers_async(AMD_IShare_getAllUsers __cb, long shareId) throws ServerError, ValidationException
Get a single set containing theomero.model.Experimenter.getOmeNamelogin names of the users as well email addresses for guests.- Parameters:
__cb- The callback object for the operation.shareId-- Throws:
ValidationException- if there is a conflict between email addresses and user names.ServerError
-
addUsers_async
void addUsers_async(AMD_IShare_addUsers __cb, long shareId, java.util.List<Experimenter> exps) throws ServerError
AddsExperimenterexperimenters toSessionshare.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
addGuests_async
void addGuests_async(AMD_IShare_addGuests __cb, long shareId, java.util.List<java.lang.String> emailAddresses) throws ServerError
Adds guest email addresses to the share.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
removeUsers_async
void removeUsers_async(AMD_IShare_removeUsers __cb, long shareId, java.util.List<Experimenter> exps) throws ServerError
RemovesExperimenterexperimenters fromSessionshare.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
removeGuests_async
void removeGuests_async(AMD_IShare_removeGuests __cb, long shareId, java.util.List<java.lang.String> emailAddresses) throws ServerError
Removes guest email addresses from the share.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
addUser_async
void addUser_async(AMD_IShare_addUser __cb, long shareId, Experimenter exp) throws ServerError
AddsExperimenterexperimenter toSessionshare.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
addGuest_async
void addGuest_async(AMD_IShare_addGuest __cb, long shareId, java.lang.String emailAddress) throws ServerError
Adds guest email address to the share.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
removeUser_async
void removeUser_async(AMD_IShare_removeUser __cb, long shareId, Experimenter exp) throws ServerError
RemovesExperimenterexperimenter fromSessionshare.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
removeGuest_async
void removeGuest_async(AMD_IShare_removeGuest __cb, long shareId, java.lang.String emailAddress) throws ServerError
Removes guest email address from share.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
getActiveConnections_async
void getActiveConnections_async(AMD_IShare_getActiveConnections __cb, long shareId) throws ServerError
Gets actual active connections toSessionshare.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
getPastConnections_async
void getPastConnections_async(AMD_IShare_getPastConnections __cb, long shareId) throws ServerError
Gets previous connections toSessionshare.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
invalidateConnection_async
void invalidateConnection_async(AMD_IShare_invalidateConnection __cb, long shareId, Experimenter exp) throws ServerError
Makes the connection invalid forSessionshare for specified user.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
getEvents_async
void getEvents_async(AMD_IShare_getEvents __cb, long shareId, Experimenter exp, RTime from, RTime to) throws ServerError
Gets events forSessionshare perExperimenterexperimenter for period of time.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
notifyMembersOfShare_async
void notifyMembersOfShare_async(AMD_IShare_notifyMembersOfShare __cb, long shareId, java.lang.String subject, java.lang.String message, boolean html) throws ServerError
Notifies via email selected members of share.- Parameters:
__cb- The callback object for the operation.- Throws:
ServerError
-
-