session

Documentation

Index

• type Config
• type Error
• type Session
  • func New(id string, config *Config) *Session
  • func (s *Session) Close() error
  • func (s *Session) Open() error
  • func (s *Session) Receive() (xml.XElement, *Error)
  • func (s *Session) Send(elem xml.XElement)
  • func (s *Session) SetJID(sessionJID *jid.JID)
  • func (s *Session) SetRemoteDomain(remoteDomain string)
  • func (s *Session) StreamID() string

Types

type Config

type Config struct {
	// JID defines an initial session JID.
	JID *jid.JID

	// Transport provides the underlying session transport
	// that will be used to send and received elements.
	Transport transport.Transport

	// MaxStanzaSize defines the maximum stanza size that
	// can be read from the session transport.
	MaxStanzaSize int

	// Remote domain represents the remote receiving entity domain name.
	RemoteDomain string

	// IsServer defines whether or not this session is established
	// by the server.
	IsServer bool

	// IsInitiating defines whether or not this is an initiating
	// entity session.
	IsInitiating bool
}

A Config structure is used to configure an XMPP session.

type Error

type Error struct {
	// Element returns the original incoming element that generated
	// the session error.
	Element xml.XElement

	// UnderlyingErr is the underlying session error.
	UnderlyingErr error
}

Error represents a session error.

type Session

type Session struct {
	// contains filtered or unexported fields
}

Session represents an XMPP session between the two peers.

func New

func New(id string, config *Config) *Session

New creates a new session instance.

func (*Session) Close

func (s *Session) Close() error

Close closes session sending the proper XMPP payload. Is responsability of the caller to close underlying transport.

func (*Session) Open

func (s *Session) Open() error

Open initializes a sending the proper XMPP payload.

func (*Session) Receive

func (s *Session) Receive() (xml.XElement, *Error)

Receive returns next incoming session element.

func (*Session) Send

func (s *Session) Send(elem xml.XElement)

Send writes an XML element to the underlying session transport.

func (*Session) SetJID

func (s *Session) SetJID(sessionJID *jid.JID)

SetJID updates current session JID.

func (*Session) SetRemoteDomain

func (s *Session) SetRemoteDomain(remoteDomain string)

SetRemoteDomain sets current session remote domain.

func (*Session) StreamID

func (s *Session) StreamID() string

StreamID returns session stream identifier.