net/net.go at v1 · webnice/net · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
package net

import (
	"net"
	"os"
	"sync"
	"sync/atomic"
)

// New Конструктор объекта сущности пакета, возвращается интерфейс пакета.
func New() Interface {
	var nut = &impl{
		lck:        new(sync.Mutex),
		isRun:      new(atomic.Bool),
		isShutdown: new(atomic.Bool),
		fnFl:       net.FileListener,
		fnNf:       os.NewFile,
		fnFc:       fileClose,
	}

	nut.isRun.Store(false)
	nut.isShutdown.Store(false)

	return nut
}

// ID Уникальный идентификатор сервера.
// Если идентификатор не был указан в конфигурации, создаётся при запуске.
func (nut *impl) ID() string { return nut.conf.ID }

// Handler Назначение основной функции TCP или сокет сервера. Функция должна назначаться до запуска сервера.
func (nut *impl) Handler(fn HandlerFn) Interface { nut.handler = fn; return nut }

// HandlerUdp Назначение основной функции UDP сервера. Функция должна назначаться до запуска сервера.
func (nut *impl) HandlerUdp(fn HandlerUdpFn) Interface { nut.handlerUdp = fn; return nut }

// Clean Очистка последней ошибки.
func (nut *impl) Clean() Interface { nut.err = nil; return nut }

// Error Последняя ошибка сервера.
func (nut *impl) Error() error { return nut.err }

// Errors Справочник ошибок.
func (nut *impl) Errors() *Error { return errSingleton }

// Wait Блокируемая функция ожидания завершения веб сервера, если он запущен.
// Если сервер не запущен, функция завершается немедленно.
func (nut *impl) Wait() Interface {
	if !nut.isRun.Load() {
		//nut.err = ErrNotRunning()
		return nut
	}
	safeWait(nut.onShutdown)
	nut.onShutdown = nil

	return nut
}

// Stop Завершение работы сервера/функции сервера.
func (nut *impl) Stop() Interface {
	// Защита от возможной смертельной блокировки при остановке сервера из разных потоков.
	nut.lck.Lock()
	defer nut.lck.Unlock()
	// Выход, если сервер не запущен или уже начато завершение работы сервера.
	if !nut.isRun.Load() || nut.isShutdown.Load() {
		return nut
	}
	// Флаг начала завершения работы сервера.
	nut.isShutdown.Store(true)
	// Закрытие соединения.
	nut.err = nut.listener.Close()
	safeClose(nut.onShutdown)
	nut.onShutdown = nil

	return nut
}

// IsRunning Статус выполнения сервера.
// Вернётся истина, если сервер запущен.
func (nut *impl) IsRunning() (ret bool) {
	// Защита от возможной смертельной блокировки при остановке сервера из разных потоков.
	nut.lck.Lock()
	defer nut.lck.Unlock()
	// Выход, если сервер запущен или начато завершение работы сервера.
	if nut.isRun.Load() || nut.isShutdown.Load() {
		ret = true
	}

	return
}