mirror of
https://gitee.com/milvus-io/milvus.git
synced 2025-12-07 01:28:27 +08:00
16b0aee97f
issue: #33285 - remove redundant goroutine by using insepctor. - remove the coutinous non-message timetick persistence - periodically push the time tick forward without persistent timetick message. - add 'message type filter' deliver filter. Signed-off-by: chyezh <chyezh@outlook.com>
109 lines
3.6 KiB
Go
109 lines
3.6 KiB
Go
package message
|
|
|
|
import "google.golang.org/protobuf/proto"
|
|
|
|
var (
|
|
_ BasicMessage = (*messageImpl)(nil)
|
|
_ MutableMessage = (*messageImpl)(nil)
|
|
_ ImmutableMessage = (*immutableMessageImpl)(nil)
|
|
)
|
|
|
|
// BasicMessage is the basic interface of message.
|
|
type BasicMessage interface {
|
|
// MessageType returns the type of message.
|
|
MessageType() MessageType
|
|
|
|
// Version returns the message version.
|
|
// 0: old version before streamingnode.
|
|
// from 1: new version after streamingnode.
|
|
Version() Version
|
|
|
|
// Message payload.
|
|
Payload() []byte
|
|
|
|
// EstimateSize returns the estimated size of message.
|
|
EstimateSize() int
|
|
|
|
// Properties returns the message properties.
|
|
// Should be used with read-only promise.
|
|
Properties() RProperties
|
|
|
|
// VChannel returns the virtual channel of current message.
|
|
// Available only when the message's version greater than 0.
|
|
// Return "" if message is broadcasted.
|
|
VChannel() string
|
|
|
|
// TimeTick returns the time tick of current message.
|
|
// Available only when the message's version greater than 0.
|
|
// Otherwise, it will panic.
|
|
TimeTick() uint64
|
|
}
|
|
|
|
// MutableMessage is the mutable message interface.
|
|
// Message can be modified before it is persistent by wal.
|
|
type MutableMessage interface {
|
|
BasicMessage
|
|
|
|
// WithLastConfirmed sets the last confirmed message id of current message.
|
|
// !!! preserved for streaming system internal usage, don't call it outside of streaming system.
|
|
WithLastConfirmed(id MessageID) MutableMessage
|
|
|
|
// WithLastConfirmedUseMessageID sets the last confirmed message id of current message to be the same as message id.
|
|
WithLastConfirmedUseMessageID() MutableMessage
|
|
|
|
// WithTimeTick sets the time tick of current message.
|
|
// !!! preserved for streaming system internal usage, don't call it outside of streaming system.
|
|
WithTimeTick(tt uint64) MutableMessage
|
|
|
|
// IntoImmutableMessage converts the mutable message to immutable message.
|
|
IntoImmutableMessage(msgID MessageID) ImmutableMessage
|
|
}
|
|
|
|
// ImmutableMessage is the read-only message interface.
|
|
// Once a message is persistent by wal or temporary generated by wal, it will be immutable.
|
|
type ImmutableMessage interface {
|
|
BasicMessage
|
|
|
|
// WALName returns the name of message related wal.
|
|
WALName() string
|
|
|
|
// MessageID returns the message id of current message.
|
|
MessageID() MessageID
|
|
|
|
// LastConfirmedMessageID returns the last confirmed message id of current message.
|
|
// last confirmed message is always a timetick message.
|
|
// Read from this message id will guarantee the time tick greater than this message is consumed.
|
|
// Available only when the message's version greater than 0.
|
|
// Otherwise, it will panic.
|
|
LastConfirmedMessageID() MessageID
|
|
}
|
|
|
|
// specializedMutableMessage is the specialized mutable message interface.
|
|
type specializedMutableMessage[H proto.Message, B proto.Message] interface {
|
|
BasicMessage
|
|
|
|
// MessageHeader returns the message header.
|
|
// Modifications to the returned header will be reflected in the message.
|
|
Header() H
|
|
|
|
// Body returns the message body.
|
|
// !!! Do these will trigger a unmarshal operation, so it should be used with caution.
|
|
Body() (B, error)
|
|
|
|
// OverwriteHeader overwrites the message header.
|
|
OverwriteHeader(header H)
|
|
}
|
|
|
|
// specializedImmutableMessage is the specialized immutable message interface.
|
|
type specializedImmutableMessage[H proto.Message, B proto.Message] interface {
|
|
ImmutableMessage
|
|
|
|
// Header returns the message header.
|
|
// Modifications to the returned header will be reflected in the message.
|
|
Header() H
|
|
|
|
// Body returns the message body.
|
|
// !!! Do these will trigger a unmarshal operation, so it should be used with caution.
|
|
Body() (B, error)
|
|
}
|