mirror of
https://github.com/hibiken/asynq.git
synced 2024-11-15 20:08:46 +08:00
125 lines
2.9 KiB
Go
125 lines
2.9 KiB
Go
// Copyright 2020 Kentaro Hibino. All rights reserved.
|
|
// Use of this source code is governed by a MIT license
|
|
// that can be found in the LICENSE file.
|
|
|
|
package asynq
|
|
|
|
import (
|
|
"strings"
|
|
"time"
|
|
|
|
"github.com/hibiken/asynq/internal/base"
|
|
"github.com/hibiken/asynq/internal/rdb"
|
|
"github.com/rs/xid"
|
|
)
|
|
|
|
// A Client is responsible for scheduling tasks.
|
|
//
|
|
// A Client is used to register tasks that should be processed
|
|
// immediately or some time in the future.
|
|
//
|
|
// Clients are safe for concurrent use by multiple goroutines.
|
|
type Client struct {
|
|
rdb *rdb.RDB
|
|
}
|
|
|
|
// NewClient and returns a new Client given a redis connection option.
|
|
func NewClient(r RedisConnOpt) *Client {
|
|
rdb := rdb.NewRDB(createRedisClient(r))
|
|
return &Client{rdb}
|
|
}
|
|
|
|
// Option specifies the task processing behavior.
|
|
type Option interface{}
|
|
|
|
// Internal option representations.
|
|
type (
|
|
retryOption int
|
|
queueOption string
|
|
timeoutOption time.Duration
|
|
)
|
|
|
|
// MaxRetry returns an option to specify the max number of times
|
|
// the task will be retried.
|
|
//
|
|
// Negative retry count is treated as zero retry.
|
|
func MaxRetry(n int) Option {
|
|
if n < 0 {
|
|
n = 0
|
|
}
|
|
return retryOption(n)
|
|
}
|
|
|
|
// Queue returns an option to specify the queue to enqueue the task into.
|
|
//
|
|
// Queue name is case-insensitive and the lowercased version is used.
|
|
func Queue(name string) Option {
|
|
return queueOption(strings.ToLower(name))
|
|
}
|
|
|
|
// Timeout returns an option to specify how long a task may run.
|
|
//
|
|
// Zero duration means no limit.
|
|
func Timeout(d time.Duration) Option {
|
|
return timeoutOption(d)
|
|
}
|
|
|
|
type option struct {
|
|
retry int
|
|
queue string
|
|
timeout time.Duration
|
|
}
|
|
|
|
func composeOptions(opts ...Option) option {
|
|
res := option{
|
|
retry: defaultMaxRetry,
|
|
queue: base.DefaultQueueName,
|
|
timeout: 0,
|
|
}
|
|
for _, opt := range opts {
|
|
switch opt := opt.(type) {
|
|
case retryOption:
|
|
res.retry = int(opt)
|
|
case queueOption:
|
|
res.queue = string(opt)
|
|
case timeoutOption:
|
|
res.timeout = time.Duration(opt)
|
|
default:
|
|
// ignore unexpected option
|
|
}
|
|
}
|
|
return res
|
|
}
|
|
|
|
const (
|
|
// Max retry count by default
|
|
defaultMaxRetry = 25
|
|
)
|
|
|
|
// Schedule registers a task to be processed at the specified time.
|
|
//
|
|
// Schedule returns nil if the task is registered successfully,
|
|
// otherwise returns a non-nil error.
|
|
//
|
|
// opts specifies the behavior of task processing. If there are conflicting
|
|
// Option values the last one overrides others.
|
|
func (c *Client) Schedule(task *Task, processAt time.Time, opts ...Option) error {
|
|
opt := composeOptions(opts...)
|
|
msg := &base.TaskMessage{
|
|
ID: xid.New(),
|
|
Type: task.Type,
|
|
Payload: task.Payload.data,
|
|
Queue: opt.queue,
|
|
Retry: opt.retry,
|
|
Timeout: opt.timeout.String(),
|
|
}
|
|
return c.enqueue(msg, processAt)
|
|
}
|
|
|
|
func (c *Client) enqueue(msg *base.TaskMessage, processAt time.Time) error {
|
|
if time.Now().After(processAt) {
|
|
return c.rdb.Enqueue(msg)
|
|
}
|
|
return c.rdb.Schedule(msg, processAt)
|
|
}
|