@ -19,6 +19,7 @@ type ByteFIFOQueueConfiguration struct {
WorkerPoolConfiguration
WorkerPoolConfiguration
Workers int
Workers int
Name string
Name string
WaitOnEmpty bool
}
}
var _ Queue = & ByteFIFOQueue { }
var _ Queue = & ByteFIFOQueue { }
@ -28,12 +29,16 @@ type ByteFIFOQueue struct {
* WorkerPool
* WorkerPool
byteFIFO ByteFIFO
byteFIFO ByteFIFO
typ Type
typ Type
closed chan struct { }
shutdownCtx context . Context
terminated chan struct { }
shutdownCtxCancel context . CancelFunc
terminateCtx context . Context
terminateCtxCancel context . CancelFunc
exemplar interface { }
exemplar interface { }
workers int
workers int
name string
name string
lock sync . Mutex
lock sync . Mutex
waitOnEmpty bool
pushed chan struct { }
}
}
// NewByteFIFOQueue creates a new ByteFIFOQueue
// NewByteFIFOQueue creates a new ByteFIFOQueue
@ -44,15 +49,22 @@ func NewByteFIFOQueue(typ Type, byteFIFO ByteFIFO, handle HandlerFunc, cfg, exem
}
}
config := configInterface . ( ByteFIFOQueueConfiguration )
config := configInterface . ( ByteFIFOQueueConfiguration )
terminateCtx , terminateCtxCancel := context . WithCancel ( context . Background ( ) )
shutdownCtx , shutdownCtxCancel := context . WithCancel ( terminateCtx )
return & ByteFIFOQueue {
return & ByteFIFOQueue {
WorkerPool : NewWorkerPool ( handle , config . WorkerPoolConfiguration ) ,
WorkerPool : NewWorkerPool ( handle , config . WorkerPoolConfiguration ) ,
byteFIFO : byteFIFO ,
byteFIFO : byteFIFO ,
typ : typ ,
typ : typ ,
closed : make ( chan struct { } ) ,
shutdownCtx : shutdownCtx ,
terminated : make ( chan struct { } ) ,
shutdownCtxCancel : shutdownCtxCancel ,
terminateCtx : terminateCtx ,
terminateCtxCancel : terminateCtxCancel ,
exemplar : exemplar ,
exemplar : exemplar ,
workers : config . Workers ,
workers : config . Workers ,
name : config . Name ,
name : config . Name ,
waitOnEmpty : config . WaitOnEmpty ,
pushed : make ( chan struct { } , 1 ) ,
} , nil
} , nil
}
}
@ -76,7 +88,15 @@ func (q *ByteFIFOQueue) PushFunc(data Data, fn func() error) error {
if err != nil {
if err != nil {
return err
return err
}
}
return q . byteFIFO . PushFunc ( bs , fn )
if q . waitOnEmpty {
defer func ( ) {
select {
case q . pushed <- struct { } { } :
default :
}
} ( )
}
return q . byteFIFO . PushFunc ( q . terminateCtx , bs , fn )
}
}
// IsEmpty checks if the queue is empty
// IsEmpty checks if the queue is empty
@ -86,135 +106,160 @@ func (q *ByteFIFOQueue) IsEmpty() bool {
if ! q . WorkerPool . IsEmpty ( ) {
if ! q . WorkerPool . IsEmpty ( ) {
return false
return false
}
}
return q . byteFIFO . Len ( ) == 0
return q . byteFIFO . Len ( q . terminateCtx ) == 0
}
}
// Run runs the bytefifo queue
// Run runs the bytefifo queue
func ( q * ByteFIFOQueue ) Run ( atShutdown , atTerminate func ( context . Context , func ( ) ) ) {
func ( q * ByteFIFOQueue ) Run ( atShutdown , atTerminate func ( func ( ) ) ) {
atShutdown ( context . Background ( ) , q . Shutdown )
atShutdown ( q . Shutdown )
atTerminate ( context . Background ( ) , q . Terminate )
atTerminate ( q . Terminate )
log . Debug ( "%s: %s Starting" , q . typ , q . name )
log . Debug ( "%s: %s Starting" , q . typ , q . name )
go func ( ) {
_ = q . AddWorkers ( q . workers , 0 )
_ = q . AddWorkers ( q . workers , 0 )
} ( )
go q . readToChan ( )
log . Trace ( "%s: %s Now running" , q . typ , q . name )
q . readToChan ( )
log . Trace ( "%s: %s Waiting til closed" , q . typ , q . name )
<- q . shutdownCtx . Done ( )
<- q . closed
log . Trace ( "%s: %s Waiting til done" , q . typ , q . name )
log . Trace ( "%s: %s Waiting til done" , q . typ , q . name )
q . Wait ( )
q . Wait ( )
log . Trace ( "%s: %s Waiting til cleaned" , q . typ , q . name )
log . Trace ( "%s: %s Waiting til cleaned" , q . typ , q . name )
ctx , cancel := context . WithCancel ( context . Background ( ) )
q . CleanUp ( q . terminateCtx )
atTerminate ( ctx , cancel )
q . terminateCtxCancel ( )
q . CleanUp ( ctx )
cancel ( )
}
}
const maxBackOffTime = time . Second * 3
func ( q * ByteFIFOQueue ) readToChan ( ) {
func ( q * ByteFIFOQueue ) readToChan ( ) {
// handle quick cancels
// handle quick cancels
select {
select {
case <- q . closed :
case <- q . shutdownCtx . Done ( ) :
// tell the pool to shutdown.
// tell the pool to shutdown.
q . c ancel( )
q . baseCtxC ancel( )
return
return
default :
default :
}
}
// Default backoff values
backOffTime := time . Millisecond * 100
backOffTime := time . Millisecond * 100
maxBackOffTime := time . Second * 3
loop :
for {
for {
success , resetBackoff := q . doPop ( )
err := q . doPop ( )
if resetBackoff {
if err == errQueueEmpty {
log . Trace ( "%s: %s Waiting on Empty" , q . typ , q . name )
select {
case <- q . pushed :
// reset backOffTime
backOffTime = 100 * time . Millisecond
backOffTime = 100 * time . Millisecond
continue loop
case <- q . shutdownCtx . Done ( ) :
// Oops we've been shutdown whilst waiting
// Make sure the worker pool is shutdown too
q . baseCtxCancel ( )
return
}
}
}
if success {
// Reset the backOffTime if there is no error or an unmarshalError
select {
if err == nil || err == errUnmarshal {
case <- q . closed :
backOffTime = 100 * time . Millisecond
// tell the pool to shutdown.
q . cancel ( )
return
default :
}
}
} else {
if err != nil {
// Need to Backoff
select {
select {
case <- q . closed :
case <- q . shutdownCtx . Done ( ) :
// tell the pool to shutdown.
// Oops we've been shutdown whilst backing off
q . cancel ( )
// Make sure the worker pool is shutdown too
q . baseCtxCancel ( )
return
return
case <- time . After ( backOffTime ) :
case <- time . After ( backOffTime ) :
}
// OK we've waited - so backoff a bit
backOffTime += backOffTime / 2
backOffTime += backOffTime / 2
if backOffTime > maxBackOffTime {
if backOffTime > maxBackOffTime {
backOffTime = maxBackOffTime
backOffTime = maxBackOffTime
}
}
continue loop
}
}
select {
case <- q . shutdownCtx . Done ( ) :
// Oops we've been shutdown
// Make sure the worker pool is shutdown too
q . baseCtxCancel ( )
return
default :
continue loop
}
}
}
}
}
}
func ( q * ByteFIFOQueue ) doPop ( ) ( success , resetBackoff bool ) {
var errQueueEmpty = fmt . Errorf ( "empty queue" )
var errEmptyBytes = fmt . Errorf ( "empty bytes" )
var errUnmarshal = fmt . Errorf ( "failed to unmarshal" )
func ( q * ByteFIFOQueue ) doPop ( ) error {
q . lock . Lock ( )
q . lock . Lock ( )
defer q . lock . Unlock ( )
defer q . lock . Unlock ( )
bs , err := q . byteFIFO . Pop ( )
bs , err := q . byteFIFO . Pop ( q . shutdownCtx )
if err != nil {
if err != nil {
if err == context . Canceled {
q . baseCtxCancel ( )
return err
}
log . Error ( "%s: %s Error on Pop: %v" , q . typ , q . name , err )
log . Error ( "%s: %s Error on Pop: %v" , q . typ , q . name , err )
return
return err
}
}
if len ( bs ) == 0 {
if len ( bs ) == 0 {
return
if q . waitOnEmpty && q . byteFIFO . Len ( q . shutdownCtx ) == 0 {
return errQueueEmpty
}
return errEmptyBytes
}
}
resetBackoff = true
data , err := unmarshalAs ( bs , q . exemplar )
data , err := unmarshalAs ( bs , q . exemplar )
if err != nil {
if err != nil {
log . Error ( "%s: %s Failed to unmarshal with error: %v" , q . typ , q . name , err )
log . Error ( "%s: %s Failed to unmarshal with error: %v" , q . typ , q . name , err )
return
return errUnmarshal
}
}
log . Trace ( "%s %s: Task found: %#v" , q . typ , q . name , data )
log . Trace ( "%s %s: Task found: %#v" , q . typ , q . name , data )
q . WorkerPool . Push ( data )
q . WorkerPool . Push ( data )
success = true
return nil
return
}
}
// Shutdown processing from this queue
// Shutdown processing from this queue
func ( q * ByteFIFOQueue ) Shutdown ( ) {
func ( q * ByteFIFOQueue ) Shutdown ( ) {
log . Trace ( "%s: %s Shutting down" , q . typ , q . name )
log . Trace ( "%s: %s Shutting down" , q . typ , q . name )
q . lock . Lock ( )
select {
select {
case <- q . closed :
case <- q . shutdownCtx . Done ( ) :
return
default :
default :
close ( q . closed )
}
}
q . lock . Unlock ( )
q . shutdownCtxCancel ( )
log . Debug ( "%s: %s Shutdown" , q . typ , q . name )
log . Debug ( "%s: %s Shutdown" , q . typ , q . name )
}
}
// IsShutdown returns a channel which is closed when this Queue is shutdown
// IsShutdown returns a channel which is closed when this Queue is shutdown
func ( q * ByteFIFOQueue ) IsShutdown ( ) <- chan struct { } {
func ( q * ByteFIFOQueue ) IsShutdown ( ) <- chan struct { } {
return q . closed
return q . shutdownCtx . Done ( )
}
}
// Terminate this queue and close the queue
// Terminate this queue and close the queue
func ( q * ByteFIFOQueue ) Terminate ( ) {
func ( q * ByteFIFOQueue ) Terminate ( ) {
log . Trace ( "%s: %s Terminating" , q . typ , q . name )
log . Trace ( "%s: %s Terminating" , q . typ , q . name )
q . Shutdown ( )
q . Shutdown ( )
q . lock . Lock ( )
select {
select {
case <- q . terminated :
case <- q . terminateCtx . Done ( ) :
q . lock . Unlock ( )
return
return
default :
default :
}
}
close ( q . terminated )
q . lock . Unlock ( )
if log . IsDebug ( ) {
if log . IsDebug ( ) {
log . Debug ( "%s: %s Closing with %d tasks left in queue" , q . typ , q . name , q . byteFIFO . Len ( ) )
log . Debug ( "%s: %s Closing with %d tasks left in queue" , q . typ , q . name , q . byteFIFO . Len ( q . terminateCtx ) )
}
}
q . terminateCtxCancel ( )
if err := q . byteFIFO . Close ( ) ; err != nil {
if err := q . byteFIFO . Close ( ) ; err != nil {
log . Error ( "Error whilst closing internal byte fifo in %s: %s: %v" , q . typ , q . name , err )
log . Error ( "Error whilst closing internal byte fifo in %s: %s: %v" , q . typ , q . name , err )
}
}
@ -223,7 +268,7 @@ func (q *ByteFIFOQueue) Terminate() {
// IsTerminated returns a channel which is closed when this Queue is terminated
// IsTerminated returns a channel which is closed when this Queue is terminated
func ( q * ByteFIFOQueue ) IsTerminated ( ) <- chan struct { } {
func ( q * ByteFIFOQueue ) IsTerminated ( ) <- chan struct { } {
return q . terminated
return q . terminateCtx . Done ( )
}
}
var _ UniqueQueue = & ByteFIFOUniqueQueue { }
var _ UniqueQueue = & ByteFIFOUniqueQueue { }
@ -240,14 +285,18 @@ func NewByteFIFOUniqueQueue(typ Type, byteFIFO UniqueByteFIFO, handle HandlerFun
return nil , err
return nil , err
}
}
config := configInterface . ( ByteFIFOQueueConfiguration )
config := configInterface . ( ByteFIFOQueueConfiguration )
terminateCtx , terminateCtxCancel := context . WithCancel ( context . Background ( ) )
shutdownCtx , shutdownCtxCancel := context . WithCancel ( terminateCtx )
return & ByteFIFOUniqueQueue {
return & ByteFIFOUniqueQueue {
ByteFIFOQueue : ByteFIFOQueue {
ByteFIFOQueue : ByteFIFOQueue {
WorkerPool : NewWorkerPool ( handle , config . WorkerPoolConfiguration ) ,
WorkerPool : NewWorkerPool ( handle , config . WorkerPoolConfiguration ) ,
byteFIFO : byteFIFO ,
byteFIFO : byteFIFO ,
typ : typ ,
typ : typ ,
closed : make ( chan struct { } ) ,
shutdownCtx : shutdownCtx ,
terminated : make ( chan struct { } ) ,
shutdownCtxCancel : shutdownCtxCancel ,
terminateCtx : terminateCtx ,
terminateCtxCancel : terminateCtxCancel ,
exemplar : exemplar ,
exemplar : exemplar ,
workers : config . Workers ,
workers : config . Workers ,
name : config . Name ,
name : config . Name ,
@ -265,5 +314,5 @@ func (q *ByteFIFOUniqueQueue) Has(data Data) (bool, error) {
if err != nil {
if err != nil {
return false , err
return false , err
}
}
return q . byteFIFO . ( UniqueByteFIFO ) . Has ( bs )
return q . byteFIFO . ( UniqueByteFIFO ) . Has ( q . terminateCtx , bs )
}
}