mirror of
https://github.com/hibiken/asynq.git
synced 2024-12-26 07:42:17 +08:00
64 lines
1.8 KiB
Go
64 lines
1.8 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 provides a framework for asynchronous task processing.
|
|
|
|
Asynq uses Redis as a message broker. To connect to redis server,
|
|
specify the options using one of RedisConnOpt types.
|
|
|
|
redis = &asynq.RedisClientOpt{
|
|
Addr: "127.0.0.1:6379",
|
|
Password: "xxxxx",
|
|
DB: 3,
|
|
}
|
|
|
|
The Client is used to enqueue a task to be processed at the specified time.
|
|
|
|
Task is created with two parameters: its type and payload.
|
|
|
|
client := asynq.NewClient(redis)
|
|
|
|
t := asynq.NewTask(
|
|
"send_email",
|
|
map[string]interface{}{"user_id": 42})
|
|
|
|
// Enqueue the task to be processed immediately.
|
|
err := client.Enqueue(t)
|
|
|
|
// Schedule the task to be processed after one minute.
|
|
err = client.EnqueueIn(time.Minute, t)
|
|
|
|
The Server is used to run the background task processing with a given
|
|
handler.
|
|
srv := asynq.NewServer(redis, asynq.Config{
|
|
Concurrency: 10,
|
|
})
|
|
|
|
srv.Run(handler)
|
|
|
|
Handler is an interface type with a method which
|
|
takes a task and returns an error. Handler should return nil if
|
|
the processing is successful, otherwise return a non-nil error.
|
|
If handler panics or returns a non-nil error, the task will be retried in the future.
|
|
|
|
Example of a type that implements the Handler interface.
|
|
type TaskHandler struct {
|
|
// ...
|
|
}
|
|
|
|
func (h *TaskHandler) ProcessTask(ctx context.Context, task *asynq.Task) error {
|
|
switch task.Type {
|
|
case "send_email":
|
|
id, err := task.Payload.GetInt("user_id")
|
|
// send email
|
|
//...
|
|
default:
|
|
return fmt.Errorf("unexpected task type %q", task.Type)
|
|
}
|
|
return nil
|
|
}
|
|
*/
|
|
package asynq
|