Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

proxy

package

Go to main page

Versions in this module

v1

v1.0.7

Jul 16, 2025

v1.0.6

Jun 10, 2025

v1.0.5

Jun 9, 2025

v1.0.4

Jun 9, 2025

v1.0.3

Jun 5, 2025

v1.0.2

Jun 5, 2025

retracted

v1.0.1

Jun 5, 2025

retracted

v1.0.0

Jun 1, 2025

Changes in this version

+ const HeaderID

+ const PingMsg

+ const PongMsg

+ var ErrChooseWrongBucket = errors.New("error choose wrong bucket")

+ var ErrNoAvailableInstance = errors.New("no available instance")

+ var ErrWrongPongResponse = errors.New("wrong pong response")

+ var ErrWrongSubject = errors.New("subscribe on unexpected subject")

+ func DefaultIDGetter(msg *nats.Msg) (string, error)

+ func GetPodSubject(subject string, instance string) string

+ func GetSubscribeSubject(subject string) string

+ func GetUnsubscribeSubject(subject string) string

+ type Balancer struct

+ func NewBalancer(s Storage) *Balancer

+ func (b *Balancer) AddInstance(subject, instanceID string) error

+ func (b *Balancer) DestroyInstance(instanceID string) error

+ func (b *Balancer) Execute(subject, id string) (string, error)

+ func (b *Balancer) GetAllInstances() []string

+ func (b *Balancer) GetSubjectInstances(subject string) []string

+ func (b *Balancer) RemoveInstance(subject, instanceID string) error

+ type Client struct

+ func NewClient(client NATSPopulator, proxyServiceSubject string, instanceGetter func() string) *Client

+ func (c *Client) PongListener(natsHandler *subscriber.Subscriber) error

+ func (c *Client) RunAndWait(natsHandler *subscriber.Subscriber, checkEvery, maxPingDelay time.Duration, ...) error

+ func (c *Client) ServiceHealthcheck(checkEvery, maxPingDelay time.Duration, stopFunction func())

+ func (c *Client) Subscribe(ctx context.Context, subjectToSubscribe string) (string, error)

+ func (c *Client) Unsubscribe(ctx context.Context, subjectToUnsubscribe string) error

+ type EasyJSON_exporter_Subscribe *Subscribe

+ type EasyJSON_exporter_Unsubscribe *Unsubscribe

+ type NATSPopulator interface

+ type NATSPublisher interface

+ Publish func(subj string, msg []byte, headers ...string) error

+ PublishWithContext func(ctx context.Context, subj string, msg []byte, headers ...string) error

+ type NATSRequester interface

+ Requester func(subj string, data []byte, timeout time.Duration, headers ...string) ([]byte, error)

+ RequesterWithContext func(ctx context.Context, subj string, msg []byte, headers ...string) ([]byte, error)

+ type Ping struct

+ func NewPing(client NATSRequester, pingEvery time.Duration) *Ping

+ func (p *Ping) Ping(srv *Server, instanceID string) error

+ func (p *Ping) Service(ctx context.Context, srv *Server)

+ type Server struct

+ func NewServer(client NATSPublisher, subject string, subjects []string) *Server

+ func NewServerWithStorage(storage Storage, client NATSPublisher, subject string, subjects []string) *Server

+ func (s *Server) GetInstances() []string

+ func (s *Server) Process(natsHandler *subscriber.Subscriber) error

+ func (s *Server) ProcessWithGetter(natsHandler *subscriber.Subscriber, ...) error

+ func (s *Server) Proxy(subject string) func(ctx context.Context, msg *nats.Msg) error

+ func (s *Server) ProxyWithGetter(subject string, idGetter func(msg *nats.Msg) (string, error)) func(ctx context.Context, msg *nats.Msg) error

+ func (s *Server) Subscribe(_ context.Context, msg *nats.Msg) error

+ func (s *Server) Unsubscribe(_ context.Context, msg *nats.Msg) error

+ type Storage interface

+ Add func(group string, id string) error

+ Delete func(group string, id string) error

+ DeleteByID func(id string) error

+ GetIDs func() []string

+ GetKeys func(group string) []string

+ Size func(group string) int

+ type Subscribe struct

+ InstanceID string

+ Subject string

+ func (*Subscribe) UnmarshalEasyJSON(l *jlexer.Lexer)

+ func (*Subscribe) UnmarshalJSON([]byte) error

+ func (Subscribe) MarshalEasyJSON(w *jwriter.Writer)

+ func (Subscribe) MarshalJSON() ([]byte, error)

+ type Unsubscribe struct

+ InstanceID string

+ Subject string

+ func (*Unsubscribe) UnmarshalEasyJSON(l *jlexer.Lexer)

+ func (*Unsubscribe) UnmarshalJSON([]byte) error

+ func (Unsubscribe) MarshalEasyJSON(w *jwriter.Writer)

+ func (Unsubscribe) MarshalJSON() ([]byte, error)