Package de.elo.ix.client.feed
Interface FeedService
- All Superinterfaces:
byps.BRemote
,byps.Remote
,de.elo.utils.net.Remote
,java.rmi.Remote
public interface FeedService
extends byps.BRemote
This interface provides functions to access document feeds.
- Since:
- 9.00.000.003
-
Method Summary
Modifier and Type Method Description java.lang.String
checkinAction(ClientInfo ci, Action action, ActionZ actionZ)
Create or update a document feed entry.Action
checkoutAction(ClientInfo ci, java.lang.String actionGuid, ActionZ actionZ)
Read a document feed entry.HashTag
checkoutHashTag(ClientInfo ci, java.lang.String hashtagGuidOrName, HashTagZ hstgZ)
Read a HashTag Object from DatabaseAction
createAction(ClientInfo ci, EActionType type, java.lang.String parentGuid)
Initialize a document feed item object.Subscription
createHashTagSubscription(ClientInfo ci, java.lang.String hashtagGuidOrName, java.lang.String userGuidOrId)
Creates a HashTag SubscriptionFindResult
findFirstActions(ClientInfo ci, FindActionsInfo findInfo, int max, ActionZ actionZ)
Find actions of document feeds.FindResult
findFirstHashTagRelation(ClientInfo ci, FindHashTagInfo findInfo, int max, HashTagZ hashTagZ)
FindResult
findFirstNotification(ClientInfo ci, FindNotificationInfo findInfo, int max)
java.util.HashSet<HashTag>
findHashTagByActions(ClientInfo ci, java.lang.String[] actionGuids, HashTagZ hashTagZ)
Returns all HashTags which occurs in a given Array of Actionsjava.util.HashMap<java.lang.String,HashTag>
findHashTags(ClientInfo ci, FindHashTagInfo findInfo)
Returns all HashTags.FindResult
findNextActions(ClientInfo ci, java.lang.String searchId, int idx, int max, ActionZ actionZ)
Continue reading results from a search started with findFirstActions.FindResult
findNextHashTagRelation(ClientInfo ci, java.lang.String searchId, int idx, int max, HashTagZ hashTagZ)
FindResult
findNextNotification(ClientInfo ci, java.lang.String searchId, int idx, int max)
java.util.List<Action>
findPostActions(ClientInfo ci, java.lang.String actionGuid, ActionZ actionZ)
Returns a Feedpost with all comments.Action
internalInsertSystemAction(ClientInfo ci, Action action)
Reserved.void
registerNotify(ClientInfo ci, java.lang.String feedGuid, FeedNotification notify)
Register a callback interface.void
unregisterNotify(ClientInfo ci, java.lang.String feedGuid)
Unregister a callback interface.
-
Method Details
-
findFirstActions
FindResult findFirstActions(ClientInfo ci, FindActionsInfo findInfo, int max, ActionZ actionZ) throws byps.RemoteExceptionFind actions of document feeds.In order to receive all actions for a document feed, call this function with
FindActionsInfo.objId
set to a Sord ID, GUID, etc. The results are returned inFindResult.getActions()
. The Feed object associated to the Sord is returned inFindResult.getFeeds()
.Call IXServicePortIF.findClose to release internal resources when finished.
- Parameters:
ci
- ClientInfo object with session information.findInfo
- Describes the search criteria.max
- Maximum number of actions that should be returned by this call. This number might be passed over because the function always returns also all subordinated actions of the selected actions.actionZ
- Element selector, defines the Action members to be returned.- Returns:
- FindResult object, FindResult#actions contains the results.
- Throws:
byps.RemoteException
-
findNextActions
FindResult findNextActions(ClientInfo ci, java.lang.String searchId, int idx, int max, ActionZ actionZ) throws byps.RemoteExceptionContinue reading results from a search started with findFirstActions.- Parameters:
ci
- ClientInfo object with session information.searchId
- Search ID returned inFindResult.getSearchId()
by a previous call tofindFirstActions(ClientInfo, FindActionsInfo, int, ActionZ)
.idx
- Start index to read from.max
- Maximum number of actions that should be returned by this call, seefindFirstActions(ClientInfo, FindActionsInfo, int, ActionZ)
.actionZ
- Element selector, defines the Action members to be returned.- Returns:
- FindResult object, FindResult#actions contains the results.
- Throws:
byps.RemoteException
-
createAction
Action createAction(ClientInfo ci, EActionType type, java.lang.String parentGuid) throws byps.RemoteExceptionInitialize a document feed item object. This function does not store the created action in the database. UsecheckinAction(ClientInfo, Action, ActionZ)
to make an Action object persistent. The returned object allows read access for everyone.- Parameters:
ci
- ClientInfo object with session information.type
- Action type, must beEActionType.UserComment
orEActionType.AutoComment
.parentGuid
- GUID of an existing action, document feed or Sord object.- Returns:
- Action object
- Throws:
byps.RemoteException
- Since:
- 9.00.000.034
-
checkinAction
java.lang.String checkinAction(ClientInfo ci, Action action, ActionZ actionZ) throws byps.RemoteExceptionCreate or update a document feed entry.- Parameters:
ci
- ClientInfo object with session information.action
- Action object,Action.type
must beEActionType.UserComment
orEActionType.AutoComment
.actionZ
- Members to be written.- Returns:
- GUID of the Action object.
- Throws:
byps.RemoteException
-
checkoutAction
Action checkoutAction(ClientInfo ci, java.lang.String actionGuid, ActionZ actionZ) throws byps.RemoteExceptionRead a document feed entry.- Parameters:
ci
- ClientInfo object with session information.actionGuid
- Action GUID.actionZ
- Members to be read.- Returns:
- Action object.
- Throws:
byps.RemoteException
-
registerNotify
void registerNotify(ClientInfo ci, java.lang.String feedGuid, FeedNotification notify) throws byps.RemoteExceptionRegister a callback interface. The server calls functions of this interface if the document feed is modified.- Parameters:
ci
- ClientInfo object with session information.feedGuid
- Document feed GUID.notify
- Callback interface implementation.- Throws:
byps.RemoteException
-
unregisterNotify
Unregister a callback interface. Remove callback interface from internal list.- Parameters:
ci
- ClientInfo object with session information.feedGuid
- Document feed GUID.- Throws:
byps.RemoteException
-
internalInsertSystemAction
Reserved.- Parameters:
ci
- reservedaction
- reserved- Returns:
- Action object.
- Throws:
byps.RemoteException
- Since:
- 9.00.012.001
-
checkoutHashTag
HashTag checkoutHashTag(ClientInfo ci, java.lang.String hashtagGuidOrName, HashTagZ hstgZ) throws byps.RemoteExceptionRead a HashTag Object from Database- Parameters:
ci
- ClientInfo object with session information.hashtagGuidOrName
- HashTag GUID or NamehstgZ
- Element selector, defines the members to be returned.- Returns:
- HashTag Object
- Throws:
byps.RemoteException
- Since:
- 9.00.022.013
-
findFirstHashTagRelation
FindResult findFirstHashTagRelation(ClientInfo ci, FindHashTagInfo findInfo, int max, HashTagZ hashTagZ) throws byps.RemoteException- Parameters:
ci
- ClientInfo object with session information.findInfo
- - FindHashTagInfomax
- Maximum number of actions that should be returned by this call.hashTagZ
- Element selector, defines the members to be returned.- Returns:
- FindResult
- Throws:
byps.RemoteException
- Since:
- 9.00.022.013
-
findNextHashTagRelation
FindResult findNextHashTagRelation(ClientInfo ci, java.lang.String searchId, int idx, int max, HashTagZ hashTagZ) throws byps.RemoteException- Parameters:
ci
- ClientInfo object with session information.searchId
- Search ID returned inFindResult.getSearchId()
by a previous call of findFirstHashTagRelationidx
- Start index to read from.max
- Maximum number of actions that should be returned by this call.hashTagZ
- Element selector, defines the members to be returned.- Returns:
- FindResult
- Throws:
byps.RemoteException
- Since:
- 9.00.022.013
-
findHashTagByActions
java.util.HashSet<HashTag> findHashTagByActions(ClientInfo ci, java.lang.String[] actionGuids, HashTagZ hashTagZ) throws byps.RemoteExceptionReturns all HashTags which occurs in a given Array of Actions- Parameters:
ci
- ClientInfo object with session information.actionGuids
- String[] guids of ActionshashTagZ
- Element selector, defines the members to be returned.- Returns:
- HashSet
- Throws:
byps.RemoteException
- Since:
- 9.00.022.014
-
findHashTags
java.util.HashMap<java.lang.String,HashTag> findHashTags(ClientInfo ci, FindHashTagInfo findInfo) throws byps.RemoteExceptionReturns all HashTags. FindHashTagInfo filter the result by, createDateIso, lastUsedIso and minCount- Parameters:
ci
- ClientInfo object with session information.findInfo
- - FindHashTagInfo- Returns:
- HashMap
- - Throws:
byps.RemoteException
- Since:
- 9.00.030.004
-
findFirstNotification
FindResult findFirstNotification(ClientInfo ci, FindNotificationInfo findInfo, int max) throws byps.RemoteException- Parameters:
ci
- ClientInfo object with session information.findInfo
- - FindNotificationInfomax
- - int Maximum number of Notifications that should be returned by this call.- Returns:
- FindResult
- Throws:
byps.RemoteException
- Since:
- 9.00.030.006
-
findNextNotification
FindResult findNextNotification(ClientInfo ci, java.lang.String searchId, int idx, int max) throws byps.RemoteException- Parameters:
ci
- ClientInfo object with session informationsearchId
- Search ID returned inFindResult.getSearchId()
by a previous call of findFirstNotificaionidx
- Start index to read from.max
- int Maximum number of Notifications that should be returned by this call.- Returns:
- FindResult
- Throws:
byps.RemoteException
- Since:
- 9.00.030.008
-
findPostActions
java.util.List<Action> findPostActions(ClientInfo ci, java.lang.String actionGuid, ActionZ actionZ) throws byps.RemoteExceptionReturns a Feedpost with all comments.- Parameters:
ci
- ci ClientInfo object with session informationactionGuid
- parent or comment GuidactionZ
- Element selector, defines the Action members to be returned.- Returns:
- List
- Throws:
byps.RemoteException
- Since:
- 11.00.000.005
-
createHashTagSubscription
Subscription createHashTagSubscription(ClientInfo ci, java.lang.String hashtagGuidOrName, java.lang.String userGuidOrId) throws byps.RemoteExceptionCreates a HashTag Subscription- Parameters:
ci
- ClientInfo object with session informationhashtagGuidOrName
-userGuidOrId
- or null- Returns:
- Subscription
- Throws:
IXException
byps.RemoteException
- Since:
- 9.00.030.011
-