MiFaZhan
120 lines
3.1 KiB
Go
120 lines
3.1 KiB
Go
package httpapi
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"net"
|
|
"net/http"
|
|
"sync"
|
|
"time"
|
|
|
|
"github.com/gogf/gf/v2/errors/gerror"
|
|
)
|
|
|
|
// Config is deliberately independent of worker/config-file wiring. Addr must
|
|
// be explicit; use 127.0.0.1:0 to let the OS allocate a local test port.
|
|
type Config struct {
|
|
Addr string
|
|
BearerToken string // Optional for standalone callers; production Worker leaves it empty.
|
|
ShutdownTimeout time.Duration
|
|
}
|
|
|
|
// Server is single-use. Start reports bind errors synchronously; after a
|
|
// successful Start, Wait reports serve or shutdown errors. Canceling the Start
|
|
// context stops accepting requests and drains active requests up to the timeout.
|
|
type Server struct {
|
|
server *http.Server
|
|
shutdownTimeout time.Duration
|
|
mu sync.Mutex
|
|
started bool
|
|
addr net.Addr
|
|
done chan struct{}
|
|
err error
|
|
}
|
|
|
|
func NewServer(config Config, deps Dependencies) (*Server, error) {
|
|
if config.Addr == "" || config.ShutdownTimeout < 0 {
|
|
return nil, gerror.New("full-sync HTTP requires an address and a nonnegative shutdown timeout")
|
|
}
|
|
handler, err := NewHandler(config.BearerToken, deps)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
if config.ShutdownTimeout == 0 {
|
|
config.ShutdownTimeout = 10 * time.Second
|
|
}
|
|
return &Server{
|
|
server: &http.Server{
|
|
Addr: config.Addr, Handler: handler,
|
|
ReadHeaderTimeout: 5 * time.Second,
|
|
ReadTimeout: 30 * time.Second,
|
|
WriteTimeout: 30 * time.Second,
|
|
IdleTimeout: 60 * time.Second,
|
|
},
|
|
shutdownTimeout: config.ShutdownTimeout,
|
|
done: make(chan struct{}),
|
|
}, nil
|
|
}
|
|
|
|
func (s *Server) Start(ctx context.Context) error {
|
|
s.mu.Lock()
|
|
defer s.mu.Unlock()
|
|
if s.started {
|
|
return gerror.New("full-sync HTTP server has already been started")
|
|
}
|
|
s.started = true
|
|
if err := ctx.Err(); err != nil {
|
|
s.err = err
|
|
close(s.done)
|
|
return err
|
|
}
|
|
listener, err := (&net.ListenConfig{}).Listen(ctx, "tcp", s.server.Addr)
|
|
if err != nil {
|
|
s.err = gerror.Wrap(err, "listen for full-sync HTTP")
|
|
close(s.done)
|
|
return s.err
|
|
}
|
|
s.addr = listener.Addr()
|
|
go s.run(ctx, listener)
|
|
return nil
|
|
}
|
|
|
|
// Addr returns the bound address, or nil before a successful Start.
|
|
func (s *Server) Addr() net.Addr {
|
|
s.mu.Lock()
|
|
defer s.mu.Unlock()
|
|
return s.addr
|
|
}
|
|
|
|
// Wait may be called concurrently after Start (including a failed Start).
|
|
func (s *Server) Wait() error {
|
|
<-s.done
|
|
return s.err
|
|
}
|
|
|
|
func (s *Server) run(ctx context.Context, listener net.Listener) {
|
|
serveDone := make(chan error, 1)
|
|
go func() { serveDone <- s.server.Serve(listener) }()
|
|
var err error
|
|
select {
|
|
case err = <-serveDone:
|
|
// An unexpected listener failure also needs to drain active requests.
|
|
case <-ctx.Done():
|
|
}
|
|
shutdownCtx, cancel := context.WithTimeout(context.Background(), s.shutdownTimeout)
|
|
shutdownErr := s.server.Shutdown(shutdownCtx)
|
|
cancel()
|
|
if shutdownErr != nil {
|
|
// Shutdown does not close active connections when its deadline expires.
|
|
_ = s.server.Close()
|
|
}
|
|
if err == nil {
|
|
err = <-serveDone
|
|
}
|
|
if errors.Is(err, http.ErrServerClosed) {
|
|
err = nil
|
|
}
|
|
s.err = errors.Join(err, shutdownErr)
|
|
close(s.done)
|
|
}
|