org.springframework.integration.store

Class SimpleMessageGroup

java.lang.Object

org.springframework.integration.store.SimpleMessageGroup

All Implemented Interfaces:

MessageGroup

Direct Known Subclasses:

AbstractCorrelatingMessageHandler.SequenceAwareMessageGroup

public class SimpleMessageGroup
extends Object
implements MessageGroup

Represents a mutable group of correlated messages that is bound to a certain MessageStore and group id. The group will grow during its lifetime, when messages are added to it. This MessageGroup is thread safe.

Since:

2.0

Author:

Iwein Fuld, Oleg Zhurakousky, Dave Syer, Gary Russell

Field Summary

Fields

Modifier and Type	Field and Description
BlockingQueue<Message<?>>	messages

Constructor Summary

Constructors

Constructor and Description
SimpleMessageGroup(Collection<? extends Message<?>> messages, Object groupId)
SimpleMessageGroup(Collection<? extends Message<?>> messages, Object groupId, long timestamp, boolean complete)
SimpleMessageGroup(MessageGroup messageGroup)
SimpleMessageGroup(Object groupId)

Method Summary

Modifier and Type	Method and Description
void	add(Message<?> message)
boolean	canAdd(Message<?> message) Query if the message can be added.
void	clear()
void	complete() Complete the group.
Object	getGroupId()
long	getLastModified()
int	getLastReleasedMessageSequenceNumber()
Collection<Message<?>>	getMessages() Returns all available Messages from the group at the time of invocation
Message<?>	getOne()
int	getSequenceSize()
long	getTimestamp()
boolean	isComplete()
boolean	remove(Message<?> message)
void	setLastModified(long lastModified)
void	setLastReleasedMessageSequenceNumber(int sequenceNumber)
int	size()
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

messages

public final BlockingQueue<Message<?>> messages

Constructor Detail

SimpleMessageGroup

public SimpleMessageGroup(Object groupId)

SimpleMessageGroup

public SimpleMessageGroup(Collection<? extends Message<?>> messages,
                          Object groupId)

SimpleMessageGroup

public SimpleMessageGroup(Collection<? extends Message<?>> messages,
                          Object groupId,
                          long timestamp,
                          boolean complete)

SimpleMessageGroup

public SimpleMessageGroup(MessageGroup messageGroup)

Method Detail

getTimestamp

public long getTimestamp()

Specified by:

getTimestamp in interface MessageGroup

Returns:

the timestamp (milliseconds since epoch) associated with the creation of this group

setLastModified

public void setLastModified(long lastModified)

getLastModified

public long getLastModified()

Specified by:

getLastModified in interface MessageGroup

Returns:

the timestamp (milliseconds since epoch) associated with the time this group was last updated

canAdd

public boolean canAdd(Message<?> message)

Description copied from interface: MessageGroup

Query if the message can be added.

Specified by:

canAdd in interface MessageGroup

Parameters:

message - The message.

Returns:

true if the message can be added.

add

public void add(Message<?> message)

remove

public boolean remove(Message<?> message)

getLastReleasedMessageSequenceNumber

public int getLastReleasedMessageSequenceNumber()

Specified by:

getLastReleasedMessageSequenceNumber in interface MessageGroup

Returns:

the sequenceNumber of the last released message. Used in Resequencer use cases only

getMessages

public Collection<Message<?>> getMessages()

Description copied from interface: MessageGroup

Returns all available Messages from the group at the time of invocation

Specified by:

getMessages in interface MessageGroup

Returns:

The messages.

setLastReleasedMessageSequenceNumber

public void setLastReleasedMessageSequenceNumber(int sequenceNumber)

getGroupId

public Object getGroupId()

Specified by:

getGroupId in interface MessageGroup

Returns:

the key that links these messages together

isComplete

public boolean isComplete()

Specified by:

isComplete in interface MessageGroup

Returns:

true if the group is complete (i.e. no more messages are expected to be added)

complete

public void complete()

Description copied from interface: MessageGroup

Complete the group.

Specified by:

complete in interface MessageGroup

getSequenceSize

public int getSequenceSize()

Specified by:

getSequenceSize in interface MessageGroup

Returns:

the size of the sequence expected 0 if unknown

size

public int size()

Specified by:

size in interface MessageGroup

Returns:

the total number of messages in this group

getOne

public Message<?> getOne()

Specified by:

getOne in interface MessageGroup

Returns:

a single message from the group

clear

public void clear()

toString

public String toString()

Overrides:

toString in class Object