org.piax.gtrans.ov.ring.rq

クラス RQMessage

java.lang.Object

org.piax.gtrans.ov.ring.RequestMessage

org.piax.gtrans.ov.ring.rq.RQMessage

すべての実装されたインタフェース:

Serializable

直系の既知のサブクラス:

BasicRQMessage, ChordSharpRQMessage

public abstract class RQMessage
extends RequestMessage

an abstract class representing a message used for propagating range queries.

this class contains various data that are required to be transmitted to the target nodes. this class also contains failedLinks field, which represents a set of failed nodes that are found while processing the range query.

this class also manages (partial) results returned from child nodes ( rqRet).

関連項目:

直列化された形式

フィールドのサマリー

フィールド

修飾子とタイプ	フィールドと説明
Set<Endpoint>	failedLinks failed links. this field is used for avoiding and repairing dead links.
int	hops hop counter for gathering statistics
QueryId	qid query id
Object	query
RQReturn	rqRet
Collection<SubRange>	subRanges subranges, split by the range query algorithm
protected Collection<SubRange>	targetRanges the target ranges, that is not modified

クラスから継承されたフィールド org.piax.gtrans.ov.ring.RequestMessage

ackReceived, ackSent, isRecvdInstance, isRoot, msgframe, msgId, opts, readyToReceive, receiver, replyId, replySent, replyTo, sender, timeoutTask, timestamp

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	RQMessage(MessagingFramework msgframe, boolean isRoot, Endpoint replyTo, int replyId, Collection<SubRange> subRanges, QueryId qid, Object query, int hops, TransOptions opts) create an instance of RQMessage.

メソッドのサマリー

修飾子とタイプ	メソッドと説明
void	addFailedLinks(Collection<Endpoint> links)
Collection<SubRange>	adjustSubRangesForRetrans(Collection<SubRange> subRanges)
protected abstract RQMessage	createInstance(MessagingFramework sgmf, boolean isRoot, Endpoint replyTo, int replyId, Collection<SubRange> subRanges, TransOptions opts)
Object	getQuery()
abstract RQAlgorithm	getRangeQueryAlgorithm()
Collection<SubRange>	getTargetRanges()
RQMessage	newChildInstance(Collection<SubRange> newSubRange) create a child RQMessage from this instance.
RQMessage	newChildInstance(Collection<SubRange> newSubRange, boolean newIsRoot) create a child RQMessage from this instance.
abstract RQReplyMessage	newRQReplyMessage(Collection<DKRangeRValue<?>> vals, boolean isFinal, Collection<MessagePath> paths, int hops)
boolean	onReceivingReply(ReplyMessage reply0) this method is called when a reply message is received at the sender node.
void	onResponseTimeout() this method is called when the response message (ack/reply) for this message is timed-out.
String	shortName()
String	toString()

クラスから継承されたメソッド org.piax.gtrans.ov.ring.RequestMessage

dispose, execute, getManager, isAckTimedOut, mayReceiveReply, newAckMessage, responseReceived, send, sendAck

クラスから継承されたメソッド java.lang.Object

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

フィールドの詳細

targetRanges

protected final Collection<SubRange> targetRanges

the target ranges, that is not modified

subRanges

public Collection<SubRange> subRanges

subranges, split by the range query algorithm

qid

public final QueryId qid

query id

query

public final Object query

hops

public final int hops

hop counter for gathering statistics

rqRet

public transient RQReturn rqRet

failedLinks

public final Set<Endpoint> failedLinks

failed links. this field is used for avoiding and repairing dead links.

コンストラクタの詳細

RQMessage

protected RQMessage(MessagingFramework msgframe,
                    boolean isRoot,
                    Endpoint replyTo,
                    int replyId,
                    Collection<SubRange> subRanges,
                    QueryId qid,
                    Object query,
                    int hops,
                    TransOptions opts)

create an instance of RQMessage.

パラメータ:

msgframe - the MessagingFramework instance managing this message

isRoot - true if this instance is used at the root node

replyTo - the node that the reply message for this message should be sent to

replyId - the ID to distinguish queries at the replyTo node

subRanges - set of query ranges

qid - QueryId to uniquely distinguish this message

query - an object sent to all the nodes within the query ranges

hops - a hop count from the root node

opts - the transport options.

メソッドの詳細

createInstance

protected abstract RQMessage createInstance(MessagingFramework sgmf,
                                            boolean isRoot,
                                            Endpoint replyTo,
                                            int replyId,
                                            Collection<SubRange> subRanges,
                                            TransOptions opts)

getRangeQueryAlgorithm

public abstract RQAlgorithm getRangeQueryAlgorithm()

newChildInstance

public RQMessage newChildInstance(Collection<SubRange> newSubRange)

create a child RQMessage from this instance.

this method is used at intermediate nodes.

パラメータ:

newSubRange - new subrange for the child RQMessage

戻り値:

a instance of child RQMessage

newChildInstance

public RQMessage newChildInstance(Collection<SubRange> newSubRange,
                                  boolean newIsRoot)

create a child RQMessage from this instance.

this method is used both at intermediate nodes and at root node (in slow retransmission case)

パラメータ:

newSubRange - new subrange for the child RQMessage

newIsRoot - true if you want a root message

戻り値:

a instance of child RQMessage

shortName

public String shortName()

toString

public String toString()

オーバーライド:

toString クラス内 Object

addFailedLinks

public void addFailedLinks(Collection<Endpoint> links)

getTargetRanges

public Collection<SubRange> getTargetRanges()

getQuery

public Object getQuery()

onReceivingReply

public boolean onReceivingReply(ReplyMessage reply0)

クラスからコピーされた説明: RequestMessage

this method is called when a reply message is received at the sender node.

定義:

onReceivingReply クラス内 RequestMessage

パラメータ:

reply0 - the reply message

戻り値:

true if this instance is no longer required at the sender node.

onResponseTimeout

public void onResponseTimeout()

クラスからコピーされた説明: RequestMessage

this method is called when the response message (ack/reply) for this message is timed-out.

定義:

onResponseTimeout クラス内 RequestMessage

adjustSubRangesForRetrans

public Collection<SubRange> adjustSubRangesForRetrans(Collection<SubRange> subRanges)

newRQReplyMessage

public abstract RQReplyMessage newRQReplyMessage(Collection<DKRangeRValue<?>> vals,
                                                 boolean isFinal,
                                                 Collection<MessagePath> paths,
                                                 int hops)