Commit 4ff46ad4 authored by Matthew Holt's avatar Matthew Holt

Refactor Server into TCPServer and UDPServer

parent 59c6513b
...@@ -235,20 +235,9 @@ func listenerAddrEqual(ln net.Listener, addr string) bool { ...@@ -235,20 +235,9 @@ func listenerAddrEqual(ln net.Listener, addr string) bool {
return false return false
} }
// Server is a type that can listen and serve. // TCPServer is a type that can listen and serve connections.
// // A TCPServer must associate with exactly or one net.Listeners.
// These methods must be implemented in pairs. If the server uses type TCPServer interface {
// TCP, it should implement Listen() and Serve(). If it uses UDP
// or some other protocol, it should implement ListenPacket() and
// ServePacket(). If it uses both, all four methods should be
// implemented. Any unimplemented methods should be made as no-ops
// that simply return nil values.
//
// A Server must associate with exactly or one listeners and
// zero or one packetconns.
type Server interface {
// TCP methods
// Listen starts listening by creating a new listener // Listen starts listening by creating a new listener
// and returning it. It does not start accepting // and returning it. It does not start accepting
// connections. For UDP-only servers, this method // connections. For UDP-only servers, this method
...@@ -262,9 +251,11 @@ type Server interface { ...@@ -262,9 +251,11 @@ type Server interface {
// words, until the server is stopped. For UDP-only // words, until the server is stopped. For UDP-only
// servers, this method can be a no-op that returns nil. // servers, this method can be a no-op that returns nil.
Serve(net.Listener) error Serve(net.Listener) error
}
// UDP methods // UDPServer is a type that can listen and serve packets.
// A UDPServer must associate with exactly or one net.PacketConns.
type UDPServer interface {
// ListenPacket starts listening by creating a new packetconn // ListenPacket starts listening by creating a new packetconn
// and returning it. It does not start accepting connections. // and returning it. It does not start accepting connections.
// TCP-only servers may leave this method blank and return // TCP-only servers may leave this method blank and return
...@@ -280,6 +271,20 @@ type Server interface { ...@@ -280,6 +271,20 @@ type Server interface {
ServePacket(net.PacketConn) error ServePacket(net.PacketConn) error
} }
// Server is a type that can listen and serve. It supports both
// TCP and UDP, although the UDPServer interface can be used
// for more than just UDP.
//
// If the server uses TCP, it should implement TCPServer completely.
// If it uses UDP or some other protocol, it should implement
// UDPServer completely. If it uses both, both interfaces should be
// fully implemented. Any unimplemented methods should be made as
// no-ops that simply return nil values.
type Server interface {
TCPServer
UDPServer
}
// Stopper is a type that can stop serving. The stop // Stopper is a type that can stop serving. The stop
// does not necessarily have to be graceful. // does not necessarily have to be graceful.
type Stopper interface { type Stopper interface {
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment