feat: ESL client, gateway management, event subscription

- Raw TCP ESL client with reconnect
- GatewayAdd/GatewayDelete/GatewaySyncAll
- SOFIA::gateway_* event processing
- SendAsync for deadlock-free bgapi commands
This commit is contained in:
Maksim Totmin 2026-06-25 16:56:42 +07:00
parent 44f5fa88e5
commit 533a1fba49
3 changed files with 150 additions and 117 deletions

View File

@ -38,7 +38,8 @@ type Client struct {
conn net.Conn conn net.Conn
reader *bufio.Reader reader *bufio.Reader
mu sync.Mutex // защищает отправку команд mu sync.Mutex // защищает отправку синхронных команд (auth, subscribe)
sendMu sync.Mutex // защищает запись в сокет (async gateway commands)
connected atomic.Bool connected atomic.Bool
eventsCh chan *Event eventsCh chan *Event
@ -160,13 +161,19 @@ func (c *Client) tryConnect() error {
func (c *Client) Disconnect() { func (c *Client) Disconnect() {
c.shouldReconn.Store(false) c.shouldReconn.Store(false)
c.mu.Lock() c.mu.Lock()
defer c.mu.Unlock()
c.connected.Store(false) c.connected.Store(false)
if c.conn != nil { if c.conn != nil {
c.conn.Close() c.conn.Close()
c.conn = nil c.conn = nil
} }
c.mu.Unlock()
// Безопасное закрытие closeCh (может быть уже закрыт)
select {
case <-c.closeCh:
// уже закрыт
default:
close(c.closeCh) close(c.closeCh)
}
} }
// IsConnected возвращает статус подключения. // IsConnected возвращает статус подключения.
@ -221,7 +228,28 @@ func (c *Client) StartReadingEvents() {
go c.readEventsLoop() go c.readEventsLoop()
} }
// SendAsync отправляет асинхронную команду (bgapi) без ожидания ответа.
// Ответ придёт как BACKGROUND_JOB событие в readEventsLoop.
// Использует sendMu для защиты записи в сокет.
func (c *Client) SendAsync(command string) error {
c.sendMu.Lock()
defer c.sendMu.Unlock()
if !c.connected.Load() || c.conn == nil {
return fmt.Errorf("esl не подключён")
}
fullCmd := command + "\n\n"
_, err := c.conn.Write([]byte(fullCmd))
if err != nil {
return fmt.Errorf("отправка команды: %w", err)
}
return nil
}
// readEventsLoop читает асинхронные сообщения (события) от FS. // readEventsLoop читает асинхронные сообщения (события) от FS.
// Не держит мьютекс во время блокирующего чтения — синхронные команды
// (Send) используют c.mu, асинхронные (SendAsync) используют sendMu.
func (c *Client) readEventsLoop() { func (c *Client) readEventsLoop() {
for { for {
select { select {
@ -235,9 +263,7 @@ func (c *Client) readEventsLoop() {
continue continue
} }
c.mu.Lock() headers, body, err := c.readMessageUnlocked()
headers, body, err := c.readMessageLocked()
c.mu.Unlock()
if err != nil { if err != nil {
if err == io.EOF || strings.Contains(err.Error(), "use of closed network connection") { if err == io.EOF || strings.Contains(err.Error(), "use of closed network connection") {
@ -304,8 +330,47 @@ func (c *Client) reconnect() {
// --- Приватные методы --- // --- Приватные методы ---
// readMessageUnlocked читает одно ESL-сообщение: заголовки + тело.
// Должна вызываться только из readEventsLoop (одиночный читатель).
func (c *Client) readMessageUnlocked() (map[string]string, string, error) {
headers := make(map[string]string)
for {
line, err := c.reader.ReadString('\n')
if err != nil {
return nil, "", err
}
line = strings.TrimRight(line, "\r\n")
if line == "" {
break // конец заголовков
}
parts := strings.SplitN(line, ":", 2)
if len(parts) == 2 {
headers[strings.TrimSpace(parts[0])] = strings.TrimSpace(parts[1])
}
}
// Читаем тело согласно Content-Length
cl := headers["Content-Length"]
if cl == "" {
return headers, "", nil
}
length, err := strconv.Atoi(cl)
if err != nil {
return headers, "", fmt.Errorf("некорректный Content-Length: %s", cl)
}
body := make([]byte, length)
if _, err := io.ReadFull(c.reader, body); err != nil {
return headers, "", fmt.Errorf("чтение тела (Content-Length=%d): %w", length, err)
}
return headers, strings.TrimSpace(string(body)), nil
}
// readMessageLocked читает одно ESL-сообщение: заголовки + тело. // readMessageLocked читает одно ESL-сообщение: заголовки + тело.
// Вызывающий держит c.mu. // Вызывающий держит c.mu (для синхронных команд Send).
func (c *Client) readMessageLocked() (map[string]string, string, error) { func (c *Client) readMessageLocked() (map[string]string, string, error) {
headers := make(map[string]string) headers := make(map[string]string)

View File

@ -11,6 +11,7 @@ import (
type EventHandler func(eventName string, headers map[string]string, body string) type EventHandler func(eventName string, headers map[string]string, body string)
// StartEventLoop запускает основной цикл реконнекта и чтения событий. // StartEventLoop запускает основной цикл реконнекта и чтения событий.
// Блокирует до тех пор, пока контекст не будет отменён (ctx.Done()).
// При успешном подключении: // При успешном подключении:
// - Вызывает onConnect (например, для GatewaySyncAll) // - Вызывает onConnect (например, для GatewaySyncAll)
// - Подписывается на события SOFIA::gateway_register/unregister // - Подписывается на события SOFIA::gateway_register/unregister
@ -19,7 +20,6 @@ type EventHandler func(eventName string, headers map[string]string, body string)
func (c *Client) StartEventLoop(ctx context.Context, profile string, onConnect func(), onEvent EventHandler) { func (c *Client) StartEventLoop(ctx context.Context, profile string, onConnect func(), onEvent EventHandler) {
const subscribeEvents = "SOFIA::gateway_register SOFIA::gateway_unregister SOFIA::gateway_expire" const subscribeEvents = "SOFIA::gateway_register SOFIA::gateway_unregister SOFIA::gateway_expire"
go func() {
for { for {
select { select {
case <-ctx.Done(): case <-ctx.Done():
@ -60,7 +60,6 @@ func (c *Client) StartEventLoop(ctx context.Context, profile string, onConnect f
go func() { go func() {
defer close(readEvents) defer close(readEvents)
c.readEventsLoop() c.readEventsLoop()
// Не ждём реконнект внутри readEventsLoop
}() }()
// Основной цикл обработки событий // Основной цикл обработки событий
@ -87,5 +86,4 @@ func (c *Client) StartEventLoop(ctx context.Context, profile string, onConnect f
c.Disconnect() c.Disconnect()
time.Sleep(c.backoff) time.Sleep(c.backoff)
} }
}()
} }

View File

@ -7,59 +7,29 @@ import (
) )
// GatewayAdd создаёт gateway на FreeSWITCH через Sofia профиль. // GatewayAdd создаёт gateway на FreeSWITCH через Sofia профиль.
// Возвращает nil если gateway создан или уже существует (идемпотентность). // Использует bgapi — асинхронная команда, результат приходит как BACKGROUND_JOB событие.
func (c *Client) GatewayAdd(profile, name, proxy string) error { func (c *Client) GatewayAdd(profile, name, proxy string) error {
cmd := fmt.Sprintf("api sofia profile %s gwadd %s %s", profile, name, proxy) cmd := fmt.Sprintf("bgapi sofia profile %s gwadd %s %s", profile, name, proxy)
headers, body, err := c.Send(cmd) if err := c.SendAsync(cmd); err != nil {
c.IncGatewayOps() log.Printf("[esl] GatewayAdd %s: ошибка: %v", name, err)
if err != nil {
log.Printf("[esl] GatewayAdd %s: ошибка команды: %v", name, err)
return err return err
} }
c.IncGatewayOps()
reply := headers["Reply-Text"] log.Printf("[esl] GatewayAdd %s: отправлен (%s → %s)", name, profile, proxy)
if strings.HasPrefix(reply, "+OK") {
log.Printf("[esl] GatewayAdd %s: создан (%s → %s)", name, profile, proxy)
return nil return nil
}
// Gateway уже существует — не ошибка
if strings.Contains(body, "GATEWAY ALREADY") || strings.Contains(reply, "GATEWAY ALREADY") {
log.Printf("[esl] GatewayAdd %s: уже существует, ок", name)
return nil
}
log.Printf("[esl] GatewayAdd %s: ошибка FS — Reply: %s, Body: %s", name, reply, body)
return fmt.Errorf("GatewayAdd %s: %s (%s)", name, reply, body)
} }
// GatewayDelete удаляет gateway на FreeSWITCH. // GatewayDelete удаляет gateway на FreeSWITCH.
// Возвращает nil если gateway удалён или не найден (идемпотентность). // Использует bgapi — асинхронная команда, результат приходит как BACKGROUND_JOB событие.
func (c *Client) GatewayDelete(profile, name string) error { func (c *Client) GatewayDelete(profile, name string) error {
cmd := fmt.Sprintf("api sofia profile %s gwdel %s", profile, name) cmd := fmt.Sprintf("bgapi sofia profile %s gwdel %s", profile, name)
headers, body, err := c.Send(cmd) if err := c.SendAsync(cmd); err != nil {
c.IncGatewayOps() log.Printf("[esl] GatewayDelete %s: ошибка: %v", name, err)
if err != nil {
log.Printf("[esl] GatewayDelete %s: ошибка команды: %v", name, err)
return err return err
} }
c.IncGatewayOps()
reply := headers["Reply-Text"] log.Printf("[esl] GatewayDelete %s: отправлен", name)
if strings.HasPrefix(reply, "+OK") {
log.Printf("[esl] GatewayDelete %s: удалён", name)
return nil return nil
}
// Gateway не найден — не ошибка
if strings.Contains(body, "GATEWAY NOT FOUND") || strings.Contains(reply, "GATEWAY NOT FOUND") {
log.Printf("[esl] GatewayDelete %s: не найден, ок", name)
return nil
}
log.Printf("[esl] GatewayDelete %s: ошибка FS — Reply: %s, Body: %s", name, reply, body)
return fmt.Errorf("GatewayDelete %s: %s (%s)", name, reply, body)
} }
// GatewayList возвращает список имён gateway в заданном профиле. // GatewayList возвращает список имён gateway в заданном профиле.