|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface KeyedBufferRemove
This interface defines methods that must be implemented by a buffer to allow components to get or delete messages from it, according to the key associated with each message. Such an interface is used by consumers of messages.
Note 1: all the messages that are stored in a buffer are not always available for removal (e.g. when the buffer implements an ordering policy). Note 2: buffer implementations MUST BE thread-safe .
Field Summary | |
---|---|
static String |
ITF_NAME
The commonly used name to refer to an interface with this signature. |
Method Summary | |
---|---|
Message |
get(Object key)
Gets the message from the buffer that is associated with the specified key object. |
Message |
remove(Object key)
Removes the message from the buffer that is associated with the specified key object. |
Message |
removeAll()
Removes all the available messages from the buffer. |
Message |
tryGet(Object key)
Gets the message from the buffer that is associated with the specified key object. |
Message |
tryRemove(Object key)
Removes the message from the buffer that is associated with the specified key object. |
Field Detail |
---|
static final String ITF_NAME
Method Detail |
---|
Message get(Object key) throws InterruptedException
key
- the key that is associated with the message to get.
null
.
InterruptedException
- if it is interrupted while waiting for a
message to be added.BufferRemove.get()
Message tryGet(Object key)
key
- the key that is associated with the message to get.
null
otherwise.BufferRemove.tryGet()
Message remove(Object key) throws InterruptedException
key
- the key that is associated with the message to be removed.
null
.
InterruptedException
- if it is interrupted while waiting for a
message to be added.BufferRemove.remove()
Message tryRemove(Object key)
key
- the key that is associated with the message to be removed.
null
otherwise.BufferRemove.tryRemove()
Message removeAll()
null
. This method does not block.
null
if no message was available.BufferRemove.removeAll()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |