You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sling.apache.org by gi...@apache.org on 2022/01/04 10:29:56 UTC
[sling-site] branch asf-site updated: Automatic website deployment from https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/370/
This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/sling-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new da80f62 Automatic website deployment from https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/370/
da80f62 is described below
commit da80f62d748acd49d09d70380aa0d19023225fc7
Author: jenkins <bu...@apache.org>
AuthorDate: Tue Jan 4 10:29:55 2022 +0000
Automatic website deployment from https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/370/
---
.../scheduler-service-commons-scheduler.html | 28 +++++++++++++++-------
sitemap.xml | 4 ++--
2 files changed, 22 insertions(+), 10 deletions(-)
diff --git a/documentation/bundles/scheduler-service-commons-scheduler.html b/documentation/bundles/scheduler-service-commons-scheduler.html
index a3ebdfc..57fbc02 100644
--- a/documentation/bundles/scheduler-service-commons-scheduler.html
+++ b/documentation/bundles/scheduler-service-commons-scheduler.html
@@ -136,7 +136,7 @@ public class ScheduledCronJob implements Runnable {
/** Default log. */
protected final Logger log = LoggerFactory.getLogger(this.getClass());
-
+
public void run() {
log.info("Executing a cron job (job#1) through the whiteboard pattern");
}
@@ -160,7 +160,7 @@ public class ScheduledPeriodicJob implements Runnable {
/** Default log. */
protected final Logger log = LoggerFactory.getLogger(this.getClass());
-
+
public void run() {
log.info("Executing a perodic job (job#2) through the whiteboard pattern");
}
@@ -227,18 +227,18 @@ import org.apache.felix.scr.annotations.Reference;
/**
* This service executes scheduled jobs
- *
+ *
*/
@Component
public class HelloWorldScheduledService {
-
+
/** Default log. */
protected final Logger log = LoggerFactory.getLogger(this.getClass());
-
+
/** The scheduler for rescheduling jobs. */
@Reference
private Scheduler scheduler;
-
+
protected void activate(ComponentContext componentContext) throws Exception {
//case 1: with addJob() method: executes the job every minute
@@ -256,7 +256,7 @@ public class HelloWorldScheduledService {
} catch (Exception e) {
job1.run();
}
-
+
//case 2: with addPeriodicJob(): executes the job every 3 minutes
String jobName2 = "case2";
long period = 180;
@@ -296,6 +296,18 @@ public class HelloWorldScheduledService {
}
</code></pre>
+<h2><a href="#using-dedicated-thread-pools" id="using-dedicated-thread-pools">Using dedicated thread pools</a></h2>
+<p>By default all scheduled jobs use the default thread pool of Sling (as provided by <a href="/documentation/bundles/apache-sling-commons-thread-pool.html">Apache Sling Commons Thread Pool</a>). But it is possible to define that a different thread pool to be used. This requires 2 steps: The thread pool must be explicitly allowed to be used and then the job must be configured accordingly. An optional 3rd step is to configure the thread pool.</p>
+<h3><a href="#allow-a-thread-pool-to-be-used-by-the-scheduler" id="allow-a-thread-pool-to-be-used-by-the-scheduler">Allow a thread pool to be used by the scheduler</a></h3>
+<p>You need to add the name of the threadpool to the OSGI property <code>allowedPoolNames</code> of the "Apache Sling Scheduler" service (pid: <code>org.apache.sling.commons.scheduler.impl.QuartzScheduler</code>).</p>
+<h3><a href="#specify-the-name-of-the-thread-pool-when-scheduling-a-job" id="specify-the-name-of-the-thread-pool-when-scheduling-a-job">Specify the name of the thread pool when scheduling a job</a></h3>
+<p>The way how you configure the thread pool to use depends on the way you schedule the job.</p>
+<p>If you use the whiteboard pattern, just add an additional property to the definition:</p>
+<pre><code>@Property(name=Scheduler.PROPERTY_SCHEDULER_THREAD_POOL,value="my-thread-pool")
+</code></pre>
+<p>If you use the scheduler API, you can specify the thread pool name via <a href="https://sling.apache.org/apidocs/sling11/org/apache/sling/commons/scheduler/ScheduleOptions.html#threadPoolName-java.lang.String-">SchedulingOptions.threadPoolName()</a>.</p>
+<h3><a href="#configure-the-thread-pool" id="configure-the-thread-pool">Configure the thread pool</a></h3>
+<p>By default the Scheduler will create <a href="/documentation/bundles/apache-sling-commons-thread-pool.html">Thread Pools</a> with default settings (5 threads at maximum). But you can also configure them explicitly and adjust them to your needs; for this you need to instantiate the "Apache Sling Thread Pool Configuration" service factory and provide the name of the threadpool as value of the OSGI property <code>name</code>.</p>
</section></div></div>
</div>
</div>
@@ -307,7 +319,7 @@ public class HelloWorldScheduledService {
content/documentation/bundles/scheduler-service-commons-scheduler.md
</a>
</div> <div class="revisionInfo">
- Last modified by <span class="author">Konrad Windszus</span> on <span class="comment">2021-11-17</span>
+ Last modified by <span class="author">Jörg Hoh</span> on <span class="comment">2022-01-04</span>
</div><p>
Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
</p><p>
diff --git a/sitemap.xml b/sitemap.xml
index 0545493..73c4889 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1,6 +1,8 @@
<?xml version="1.0"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd">
<url>
+ <loc>https://sling.apache.org/documentation/bundles/scheduler-service-commons-scheduler.html</loc><lastmod>2022-01-04</lastmod>
+ </url><url>
<loc>https://sling.apache.org/documentation/bundles/models.html</loc><lastmod>2022-01-03</lastmod>
</url><url>
<loc>https://sling.apache.org/releases.html</loc><lastmod>2021-12-21</lastmod>
@@ -27,8 +29,6 @@
</url><url>
<loc>https://sling.apache.org/documentation/development/sling-mock.html</loc><lastmod>2021-11-17</lastmod>
</url><url>
- <loc>https://sling.apache.org/documentation/bundles/scheduler-service-commons-scheduler.html</loc><lastmod>2021-11-17</lastmod>
- </url><url>
<loc>https://sling.apache.org/documentation/the-sling-engine/mappings-for-resource-resolution.html</loc><lastmod>2021-11-15</lastmod>
</url><url>
<loc>https://sling.apache.org/documentation/bundles/resource-access-security.html</loc><lastmod>2021-11-04</lastmod>