CyberGocybergodev/httpc

Русский

简体中文
English
한국어
日本語

Русский

简体中文
English
한국어
日本語

Тема

Русский

简体中文
English
한국어
日本語

Управление сессиями ​

SessionManager предоставляет потокобезопасное хранилище Cookie и заголовков запросов, используемое внутри DomainClient.

NewSessionManager ​

go
func NewSessionManager(config ...*SessionConfig) (*SessionManager, error)

Создаёт менеджер сессий.

go
sm, err := httpc.NewSessionManager()

// С конфигурацией
cfg := httpc.DefaultSessionConfig()
cfg.CookieSecurity = httpc.StrictCookieSecurityConfig()
sm, err := httpc.NewSessionManager(cfg)

SessionConfig ​

go
type SessionConfig struct {
    CookieSecurity *CookieSecurityConfig
}
ПолеТипОписание
CookieSecurity*CookieSecurityConfigКонфигурация проверки безопасности Cookie, nil означает без проверки
go
func DefaultSessionConfig() *SessionConfig

Возвращает конфигурацию по умолчанию (без проверки безопасности Cookie).

Управление заголовками ​

SetHeader ​

go
func (s *SessionManager) SetHeader(key, value string) error

Устанавливает заголовок сессии. Все последующие запросы будут автоматически его содержать. Проверяет корректность ключа и значения заголовка.

go
err := sm.SetHeader("Authorization", "Bearer "+token)

SetHeaders ​

go
func (s *SessionManager) SetHeaders(headers map[string]string) error

Массовая установка заголовков сессии.

go
err := sm.SetHeaders(map[string]string{
    "Authorization": "Bearer " + token,
    "Accept":        "application/json",
})

DeleteHeader ​

go
func (s *SessionManager) DeleteHeader(key string)

Удаляет указанный заголовок сессии.

ClearHeaders ​

go
func (s *SessionManager) ClearHeaders()

Очищает все заголовки сессии.

GetHeaders ​

go
func (s *SessionManager) GetHeaders() map[string]string

Возвращает копию всех заголовков сессии.

SetCookie ​

go
func (s *SessionManager) SetCookie(cookie *http.Cookie) error

Устанавливает Cookie сессии. Проверяет корректность Cookie, а при наличии CookieSecurity также проверяет атрибуты безопасности.

go
err := sm.SetCookie(&http.Cookie{
    Name:     "session",
    Value:    "abc123",
    Secure:   true,
    HttpOnly: true,
})

SetCookies ​

go
func (s *SessionManager) SetCookies(cookies []*http.Cookie) error

Массовая установка Cookie.

DeleteCookie ​

go
func (s *SessionManager) DeleteCookie(name string)

Удаляет Cookie по имени.

ClearCookies ​

go
func (s *SessionManager) ClearCookies()

Очищает все Cookie.

GetCookies ​

go
func (s *SessionManager) GetCookies() []*http.Cookie

Возвращает копию всех Cookie.

GetCookie ​

go
func (s *SessionManager) GetCookie(name string) *http.Cookie

Получает копию Cookie по имени, возвращает nil если не найден.

SetCookieSecurity ​

go
func (s *SessionManager) SetCookieSecurity(config *CookieSecurityConfig)

Обновляет конфигурацию проверки безопасности Cookie. Влияет на все последующие вызовы SetCookie.

go
sm.SetCookieSecurity(httpc.StrictCookieSecurityConfig())

UpdateFromResult ​

go
func (s *SessionManager) UpdateFromResult(result *Result)

Обновляет Cookie сессии из результата запроса. Небезопасные Cookie молча пропускаются.

UpdateFromCookies ​

go
func (s *SessionManager) UpdateFromCookies(cookies []*http.Cookie)

Обновляет Cookie сессии из среза Cookie.

См. также ​