64 lines
1.4 KiB
Go
64 lines
1.4 KiB
Go
// Package transport is an interface for synchronous connection based communication
|
|
package transport
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
|
|
"go.unistack.org/micro/v3/metadata"
|
|
)
|
|
|
|
var (
|
|
// DefaultTransport is the global default transport
|
|
DefaultTransport = NewTransport()
|
|
// DefaultDialTimeout the default dial timeout
|
|
DefaultDialTimeout = time.Second * 5
|
|
)
|
|
|
|
// Transport is an interface which is used for communication between
|
|
// services. It uses connection based socket send/recv semantics and
|
|
// has various implementations; http, grpc, quic.
|
|
type Transport interface {
|
|
Init(...Option) error
|
|
Options() Options
|
|
Dial(ctx context.Context, addr string, opts ...DialOption) (Client, error)
|
|
Listen(ctx context.Context, addr string, opts ...ListenOption) (Listener, error)
|
|
String() string
|
|
}
|
|
|
|
// Message is used to transfer data
|
|
type Message struct {
|
|
Header metadata.Metadata
|
|
Body []byte
|
|
}
|
|
|
|
// Socket bastraction interface
|
|
type Socket interface {
|
|
Recv(*Message) error
|
|
Send(*Message) error
|
|
Close() error
|
|
Local() string
|
|
Remote() string
|
|
}
|
|
|
|
// Client is the socket owner
|
|
type Client interface {
|
|
Socket
|
|
}
|
|
|
|
// Listener is the interface for stream oriented messaging
|
|
type Listener interface {
|
|
Addr() string
|
|
Close() error
|
|
Accept(func(Socket)) error
|
|
}
|
|
|
|
// Option is the option signature
|
|
type Option func(*Options)
|
|
|
|
// DialOption is the option signature
|
|
type DialOption func(*DialOptions)
|
|
|
|
// ListenOption is the option signature
|
|
type ListenOption func(*ListenOptions)
|