{"id":16696979,"url":"https://github.com/seratch/taskun","last_synced_at":"2025-04-10T02:52:28.577Z","repository":{"id":57722676,"uuid":"1557148","full_name":"seratch/taskun","owner":"seratch","description":"A simple crond thread on the JVM","archived":false,"fork":false,"pushed_at":"2016-01-19T13:25:28.000Z","size":3917,"stargazers_count":6,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-03-24T04:22:29.544Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/seratch/taskun","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seratch.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-04-01T20:00:33.000Z","updated_at":"2019-08-13T14:43:33.000Z","dependencies_parsed_at":"2022-08-28T08:40:42.116Z","dependency_job_id":null,"html_url":"https://github.com/seratch/taskun","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seratch%2Ftaskun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seratch%2Ftaskun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seratch%2Ftaskun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seratch%2Ftaskun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seratch","download_url":"https://codeload.github.com/seratch/taskun/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248147120,"owners_count":21055479,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-12T17:45:36.569Z","updated_at":"2025-04-10T02:52:28.552Z","avatar_url":"https://github.com/seratch.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# taskun - A simple cron daemon thread on the JVM\n\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.seratch.taskun/taskun-scheduler/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.github.seratch.taskun/taskun-scheduler)\n\n## What's this\n\n\"taskun\" is an implementation of UNIX \"crond\" on the JVM, and it also has some extended notations.\n\n## How to install\n\n### Maven\n\n```xml\n\u003cdependencies\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.seratch.taskun\u003c/groupId\u003e\n    \u003cartifactId\u003etaskun-scheduler\u003c/artifactId\u003e\n    \u003cversion\u003e[1.5,)\u003c/version\u003e\n  \u003c/dependency\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.seratch.taskun\u003c/groupId\u003e\n    \u003cartifactId\u003etaskun-servlet-extension\u003c/artifactId\u003e\n    \u003cversion\u003e[1.5,)\u003c/version\u003e\n  \u003c/dependency\u003e\n  \n  \u003c!-- OPTIONAL EXTENSIONS --\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.seratch.taskun\u003c/groupId\u003e\n    \u003cartifactId\u003etaskun-log4j-extension\u003c/artifactId\u003e\n    \u003cversion\u003e[1.5,)\u003c/version\u003e\n  \u003c/dependency\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.seratch.taskun\u003c/groupId\u003e\n    \u003cartifactId\u003etaskun-guice-extension\u003c/artifactId\u003e\n    \u003cversion\u003e[1.5,)\u003c/version\u003e\n  \u003c/dependency\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.seratch.taskun\u003c/groupId\u003e\n    \u003cartifactId\u003etaskun-spring-extension\u003c/artifactId\u003e\n    \u003cversion\u003e[1.5,)\u003c/version\u003e\n  \u003c/dependency\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.seratch.taskun\u003c/groupId\u003e\n    \u003cartifactId\u003etaskun-s2-extension\u003c/artifactId\u003e\n    \u003cversion\u003e[1.5,)\u003c/version\u003e\n  \u003c/dependency\u003e\n\u003c/dependencies\u003e\n```\n\n## Snippet1: Running taskun \n\n### src/main/java/snippet/EchoWorker.java\n\n```java\npackage snippet;\npublic class EchoWorker implements Runnable {\n  public void run() {\n    System.out.println(\"Hello, World!\");\n  }\n}\n```\n\n### src/main/resources/crontab.txt\n\n```\n*/1 * * * * snippet.EchoWorker\n```\n\n### src/main/java/snippet/SampleMain.java\n\n```java\npackage snippet;\npublic static void main(String[] args) throws Exception {\n  Taskun taskun = TaskunFactory.getInstance();\n  taskun.initialize(new TaskunConfig());\n  taskun.start();\n  Thread.sleep(20000L);\n}\n```\n\n## Snippet2: Running snippet servlet\n\n```sh\ngit clone git@github.com:seratch/taskun.git\ncd taskun/taskun-servlet-extension\nmvn jetty:run\n\n# And you will see \"Hello, World!\" endlessly in the console.\n\n[INFO] Started Jetty Server\n[INFO] Starting scanner at interval of 3 seconds.\n2011/04/02 0:00:53 com.github.seratch.taskun.taskun.crond.CronDaemon initialize\nINFO: ----- Taskun scheduler initialized -----\n2011/04/02 0:00:53 com.github.seratch.taskun.taskun.crond.CronDaemon initialize\nINFO: Working at seratch-imac(seratch-imac)\n2011/04/02 0:00:53 com.github.seratch.taskun.taskun.crond.CronDaemon initialize\nINFO: Interval invocation : 3sec,com.github.seratch.taskun.servlet.snippet.EchoWorker,1\n2011/04/02 0:00:53 com.github.seratch.taskun.taskun.crond.CronDaemon initialize\nINFO: Crontab invocation : */1 * * * * com.github.seratch.taskun.servlet.snippet.EchoWorker*3\n2011/04/02 0:00:53 com.github.seratch.taskun.taskun.crond.CronDaemon initialize\nINFO: ----------------------------------------\n2011/04/02 0:00:53 com.github.seratch.taskun.servlet.snippet.SnippetTaskunServlet init\nINFO: Taskun scheduler has started!\n[NamedServers:]\nHello, World! (Thread:20,Sat Apr 02 00:00:58 JST 2011)\nHello, World! (Thread:21,Sat Apr 02 00:01:00 JST 2011)\nHello, World! (Thread:20,Sat Apr 02 00:01:00 JST 2011)\n...\n```\n\n## Snippet3: Running taskun in your webapp\n\n### src/main/webapp/WEB-INF/web.xml\n\n```xml\n\u003cservlet\u003e\n  \u003cservlet-name\u003etaskunServlet\u003c/servlet-name\u003e\n  \u003cservlet-class\u003ecom.github.seratch.taskun.servlet.impl.SimpleTaskunServlet\u003c/servlet-class\u003e\n  \u003cload-on-startup\u003e3\u003c/load-on-startup\u003e\n\u003c/servlet\u003e\n```\n\n### src/main/resources/crontab.txt\n\n```\n*/1 * * * * com.github.seratch.taskun.servlet.snippet.EchoWorker*3\ninterval:3sec initial:5sec com.github.seratch.taskun.servlet.snippet.EchoWorker\n```\n### src/main/resources/taskun.properties\n\n```properties\nenableInvokingTaskun=true\nenableLoggingForEachCrondInvocation=true\nnamedServer1=.*server1\nnamedServer2=server2*.example.com\nnamedServer3=\n```\n\n### Deploy and run\n\n## Snippet4: Injecting taskun, config and worker instances\n\nNOTICE: taskun-guice-extension, taskun-spring-extension or taskun-s2-extension is required.\n\n+ [taskun-guice-extension](https://github.com/seratch/taskun/blob/master/taskun-guice-extension/readme.md)\n+ [taskun-spring-extension](https://github.com/seratch/taskun/blob/master/taskun-spring-extension/readme.md)\n+ [taskun-s2-extension](https://github.com/seratch/taskun/blob/master/taskun-s2-extension/readme.md)\n\n## Snippet5: Using extended notations\n\n### Invoking seconds intervals\n\n\"initial\" is waiting time for the first invoking since taskun taskun started.\n\n```\ninterval:3sec initial:5sec snippet.EchoWorker\n```\n\n### Invoking several threads at once.\n\nFollowing will invoke 3 threads to do same command(=EchoWorker) at once:\n\n```\n*/1 * * * * snippet.EchoWorker*3\n```\n\n## Snippet6: Using log4j for taskun logging\n\nNOTICE: taskun-log4j-extension is required.\n\n+ [taskun-log4j-extension](https://github.com/seratch/taskun/blob/master/taskun-log4j-extension/readme.md)\n\nIt is reuirqed to set LogImplClass to config.\n\n```java\npackage snippet;\n \nimport com.github.seratch.taskun.logging.TaskunLogLog4jImpl;\n \npublic static void main(String[] args) throws Exception {\n  Taskun taskun = TaskunFactory.getInstance();\n  TaskunConfig config = new TaskunConfig();\n  config.setLogImplClass(TaskunLogLog4jImpl.class); \n  taskun.initialize(config);\n  taskun.start();\n  Thread.sleep(20000L);\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseratch%2Ftaskun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseratch%2Ftaskun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseratch%2Ftaskun/lists"}