You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
131 lines
4.2 KiB
Go
131 lines
4.2 KiB
Go
// MIT License
|
|
|
|
// Copyright (c) 2018 Andy Pan
|
|
|
|
// 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 ants
|
|
|
|
import (
|
|
"errors"
|
|
"log"
|
|
"math"
|
|
"os"
|
|
"runtime"
|
|
"time"
|
|
)
|
|
|
|
const (
|
|
// DefaultAntsPoolSize is the default capacity for a default goroutine pool.
|
|
DefaultAntsPoolSize = math.MaxInt32
|
|
|
|
// DefaultCleanIntervalTime is the interval time to clean up goroutines.
|
|
DefaultCleanIntervalTime = time.Second
|
|
)
|
|
|
|
const (
|
|
// OPENED represents that the pool is opened.
|
|
OPENED = iota
|
|
|
|
// CLOSED represents that the pool is closed.
|
|
CLOSED
|
|
)
|
|
|
|
var (
|
|
//
|
|
//--------------------------Error types for the Ants API------------------------------
|
|
|
|
// ErrLackPoolFunc will be returned when invokers don't provide function for pool.
|
|
ErrLackPoolFunc = errors.New("must provide function for pool")
|
|
|
|
// ErrInvalidPoolExpiry will be returned when setting a negative number as the periodic duration to purge goroutines.
|
|
ErrInvalidPoolExpiry = errors.New("invalid expiry for pool")
|
|
|
|
// ErrPoolClosed will be returned when submitting task to a closed pool.
|
|
ErrPoolClosed = errors.New("this pool has been closed")
|
|
|
|
// ErrPoolOverload will be returned when the pool is full and no workers available.
|
|
ErrPoolOverload = errors.New("too many goroutines blocked on submit or Nonblocking is set")
|
|
|
|
// ErrInvalidPreAllocSize will be returned when trying to set up a negative capacity under PreAlloc mode.
|
|
ErrInvalidPreAllocSize = errors.New("can not set up a negative capacity under PreAlloc mode")
|
|
|
|
// ErrTimeout will be returned after the operations timed out.
|
|
ErrTimeout = errors.New("operation timed out")
|
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
// workerChanCap determines whether the channel of a worker should be a buffered channel
|
|
// to get the best performance. Inspired by fasthttp at
|
|
// https://github.com/valyala/fasthttp/blob/master/workerpool.go#L139
|
|
workerChanCap = func() int {
|
|
// Use blocking channel if GOMAXPROCS=1.
|
|
// This switches context from sender to receiver immediately,
|
|
// which results in higher performance (under go1.5 at least).
|
|
if runtime.GOMAXPROCS(0) == 1 {
|
|
return 0
|
|
}
|
|
|
|
// Use non-blocking workerChan if GOMAXPROCS>1,
|
|
// since otherwise the sender might be dragged down if the receiver is CPU-bound.
|
|
return 1
|
|
}()
|
|
|
|
defaultLogger = Logger(log.New(os.Stderr, "", log.LstdFlags))
|
|
|
|
// Init an instance pool when importing ants.
|
|
defaultAntsPool, _ = NewPool(DefaultAntsPoolSize)
|
|
)
|
|
|
|
// Logger is used for logging formatted messages.
|
|
type Logger interface {
|
|
// Printf must have the same semantics as log.Printf.
|
|
Printf(format string, args ...interface{})
|
|
}
|
|
|
|
// Submit submits a task to pool.
|
|
func Submit(task func()) error {
|
|
return defaultAntsPool.Submit(task)
|
|
}
|
|
|
|
// Running returns the number of the currently running goroutines.
|
|
func Running() int {
|
|
return defaultAntsPool.Running()
|
|
}
|
|
|
|
// Cap returns the capacity of this default pool.
|
|
func Cap() int {
|
|
return defaultAntsPool.Cap()
|
|
}
|
|
|
|
// Free returns the available goroutines to work.
|
|
func Free() int {
|
|
return defaultAntsPool.Free()
|
|
}
|
|
|
|
// Release Closes the default pool.
|
|
func Release() {
|
|
defaultAntsPool.Release()
|
|
}
|
|
|
|
// Reboot reboots the default pool.
|
|
func Reboot() {
|
|
defaultAntsPool.Reboot()
|
|
}
|