mirror of
https://github.com/nabbar/golib.git
synced 2025-12-24 11:51:02 +08:00
3837f0b2bb
[file/bandwidth] - ADD documentation: add enhanced README and TESTING guidelines - ADD tests: complete test suites with benchmarks, concurrency, and edge cases [file/perm] - ADD documentation: add enhanced README and TESTING guidelines - ADD tests: complete test suites with benchmarks, concurrency, and edge cases - ADD function to parse form "rwx-wxr-x" or "-rwx-w-r-x" - ADD function to ParseFileMode to convert os.FileMode to file.Perm [file/progress] - ADD documentation: add enhanced README and TESTING guidelines - ADD tests: complete test suites with benchmarks, concurrency, and edge cases [ioutils/...] - UPDATE documentation: update enhanced README and TESTING guidelines - UPDATE tests: complete test suites with benchmarks, concurrency, and edge cases [logger/...] - UPDATE documentation: update enhanced README and TESTING guidelines - ADD documentation: add enhanced README and TESTING guidelines for sub packages - UPDATE tests: complete test suites with benchmarks, concurrency, and edge cases - UPDATE config: remove FileBufferSize from OptionFile (rework hookfile) - UPDATE fields: expose Store function in interface - REWORK hookfile: rework package, use aggregator to allow multi write and single file - FIX hookstderr: fix bug with NonColorable - FIX hookstdout: fix bug with NonColorable - FIX hookwriter: fix bug with NonColorable [network/protocol] - ADD function IsTCP, IsUDP, IsUnixLike to check type of protocol [runner] - FIX typo [socket] - UPDATE documentation: update enhanced README and TESTING guidelines - ADD documentation: add enhanced README and TESTING guidelines for sub packages - UPDATE tests: complete test suites with benchmarks, concurrency, and edge cases - REWORK server: use context compatible io.reader, io.writer, io.closer instead of reader / writer - REWORK server: simplify, optimize server - REMOVE reader, writer type - ADD context: add new interface in root socket interface to expose context interface that extend context, io reader/writer/closer, dediacted function to server (IsConnected, ...)
62 lines
2.7 KiB
Go
62 lines
2.7 KiB
Go
/*
|
|
* MIT License
|
|
*
|
|
* Copyright (c) 2022 Nicolas JUHEL
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
* in the Software without restriction, including without limitation the rights
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in all
|
|
* copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
* SOFTWARE.
|
|
*
|
|
*
|
|
*/
|
|
|
|
// Package udp provides a UDP server implementation with connectionless datagram support.
|
|
//
|
|
// This package implements the github.com/nabbar/golib/socket.Server interface
|
|
// for UDP protocol, providing a stateless datagram server with features including:
|
|
// - Connectionless UDP datagram handling
|
|
// - Single handler for all incoming datagrams
|
|
// - Callback hooks for errors and informational messages
|
|
// - Graceful shutdown support
|
|
// - Atomic state management
|
|
// - Context-aware operations
|
|
//
|
|
// Unlike TCP servers, UDP servers operate in a stateless mode where each datagram
|
|
// is processed independently without maintaining persistent connections.
|
|
//
|
|
// See github.com/nabbar/golib/socket for the Server interface definition.
|
|
package udp
|
|
|
|
import "fmt"
|
|
|
|
var (
|
|
// ErrInvalidAddress is returned when the server address is empty or malformed.
|
|
// The address must be in the format "host:port" or ":port" for all interfaces.
|
|
ErrInvalidAddress = fmt.Errorf("invalid listen address")
|
|
|
|
// ErrInvalidHandler is returned when attempting to start a server without a valid handler function.
|
|
// A handler must be provided via the New() constructor.
|
|
ErrInvalidHandler = fmt.Errorf("invalid handler")
|
|
|
|
// ErrShutdownTimeout is returned when the server shutdown exceeds the context timeout.
|
|
// This typically happens when StopListen() takes longer than expected.
|
|
ErrShutdownTimeout = fmt.Errorf("timeout on stopping socket")
|
|
|
|
// ErrInvalidInstance is returned when operating on a nil server instance.
|
|
ErrInvalidInstance = fmt.Errorf("invalid socket instance")
|
|
)
|