Microservices Engine:Create a Java, Go, or Python application and connect it to XXL-JOB

Java

Golang

1. Configure the environment: Run the following command to obtain XXL-JOB on SchedulerX SDK for Go by using the latest tag: For more information about specific versions, see xxl-job-executor-go.

   go get github.com/xxl-job/xxl-job-executor-go@{Latest tag}

2. Write an initialization executor.

   package main
   
   import (
       "context"
       "fmt"
       xxl "github.com/xxl-job/xxl-job-executor-go"
       "github.com/xxl-job/xxl-job-executor-go/example/task"
       "log"
   )
   
   func main() {
       exec := xxl.NewExecutor(
           xxl.ServerAddr("xxxxxx"),       // The endpoint. To obtain the endpoint, find your application on the Application Management page of the XXL-JOB on SchedulerX console and click Access Configuration in the Operation column.
           xxl.AccessToken("xxxxxxx"),     // The access token. To obtain the access token, find your application on the Application Management page of the XXL-JOB on SchedulerX console and click Access Configuration in the Operation column.
           xxl.ExecutorPort("9999"),       // Optional. The port number of the executor. Default value: 9999.
           xxl.RegistryKey("golang-jobs"), // The name of the executor.
           xxl.SetLogger(&logger{}),       // The custom logger.
       )
       exec.Init()
       exec.Use(customMiddleware)
       // Configure a log handler.
       exec.LogHandler(customLogHandle)
       // Register a job handler.
       exec.RegTask("task.test", task.Test)
       exec.RegTask("task.shardingTest", task.ShardingTest)
       log.Fatal(exec.Run())
   }
   
   // Specify a custom log handler.
   func customLogHandle(req *xxl.LogReq) *xxl.LogRes {
       return &xxl.LogRes{Code: xxl.SuccessCode, Msg: "", Content: xxl.LogResContent{
           FromLineNum: req.FromLineNum,
           ToLineNum:   2,
           LogContent:  "This is a custom log handler.",
           IsEnd:       true,
       }}
   }
   
   // Implement the xxl.Logger interface.
   type logger struct{}
   
   func (l *logger) Info(format string, a ...interface{}) {
       fmt.Println(fmt.Sprintf("Custom log - "+format, a...))
   }
   
   func (l *logger) Error(format string, a ...interface{}) {
       log.Println(fmt.Sprintf("Custom log - "+format, a...))
   }
   
   // Specify custom middleware.
   func customMiddleware(tf xxl.TaskFunc) xxl.TaskFunc {
       return func(cxt context.Context, param *xxl.RunReq) string {
           log.Println("I am a middleware start")
           res := tf(cxt, param)
           log.Println("I am a middleware end")
           return res
       }
   }

3. Write the job execution code.

   package task
   
   import (
   	"context"
   	"fmt"
   	xxl "github.com/xxl-job/xxl-job-executor-go"
   )
   
   func Test(cxt context.Context, param *xxl.RunReq) (msg string) {
   	fmt.Println("test one task" + param.ExecutorHandler + " param:" + param.ExecutorParams + " log_id:" + xxl.Int64ToStr(param.LogID))
   	return "test done"
   }
   
   func ShardingTest(cxt context.Context, param *xxl.RunReq) (msg string) {
   	fmt.Println("shardingId:" + xxl.Int64ToStr(param.BroadcastIndex) + ", shardingTotal:" + xxl.Int64ToStr(param.BroadcastTotal))
   	return "ShardingTest done"
   }

Python

1. Pull dependencies. For more information about specific versions, see xxl-job-executor-python.

   pip install pyxxl
   
   # If logs need to be written to redis
   pip install "pyxxl[redis]"
   
   # If you need to load configurations from. env
   pip install "pyxxl[dotenv]"
   
   # Install all features
   pip install "pyxxl[all]"

2. Write the job execution code.

   import asyncio
   import time
   
   from pyxxl import ExecutorConfig, PyxxlRunner
   from pyxxl.ctx import g
   
   config = ExecutorConfig(
       xxl_admin_baseurl="http://xxljob-1b3fd81****.schedulerx.mse.aliyuncs.com/api/",
       executor_app_name="xueren-test",
       access_token="default_token",
       # executor_listen_host="0.0.0.0", # If the xxl-admin can directly connect to the IP address of the executor, do not specify the executor_listen_host
   )
   
   app = PyxxlRunner(config)
   
   
   @app.register(name="demoJobHandler")
   async def test_task():
       # you can get task params with "g"
       g.logger.info("get executor params: %s" % g.xxl_run_data.executorParams)
       for i in range(10):
           g.logger.warning("test logger %s" % i)
       await asyncio.sleep(5)
       return "Success..."
   
   @app.register(name="sync_func")
   def test_task4():
       # if you want to see the execution log on the xxl-admin, you must use g.logger to print the log. By default, only info and above logs are printed.
       n = 1
       g.logger.info("Job %s get executor params: %s" % (g.xxl_run_data.jobId, g.xxl_run_data.executorParams))
       # If the synchronization task contains loops, you must check the value of g.cancel_event every time to support the cancel operation.
       while n <= 10 and not g.cancel_event.is_set():
           # If you do not need to view the log from the xxl-admin, you can use your own logger.
           g.logger.info(
               "log to {} logger test_task4.{},params:{}".format(
                   g.xxl_run_data.jobId,
                   n,
                   g.xxl_run_data.executorParams,
               )
           )
           time.sleep(2)
           n += 1
       return "Success 3"
   
   
   if __name__ == "__main__":
       app.run_executor()