james-server-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From btell...@apache.org
Subject [10/17] james-project git commit: JAMES-2414 Document custom MailboxListener `async` configuration
Date Tue, 12 Jun 2018 00:03:29 GMT
JAMES-2414 Document custom MailboxListener `async` configuration


Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/fd81b296
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/fd81b296
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/fd81b296

Branch: refs/heads/master
Commit: fd81b296583f635695fd096031bc3b7731ae1636
Parents: 041c55d
Author: benwa <btellier@linagora.com>
Authored: Thu Jun 7 16:41:29 2018 +0700
Committer: benwa <btellier@linagora.com>
Committed: Tue Jun 12 07:01:45 2018 +0700

----------------------------------------------------------------------
 src/site/xdoc/server/config-listeners.xml | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/james-project/blob/fd81b296/src/site/xdoc/server/config-listeners.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/server/config-listeners.xml b/src/site/xdoc/server/config-listeners.xml
index 45885b5..e0efeb8 100644
--- a/src/site/xdoc/server/config-listeners.xml
+++ b/src/site/xdoc/server/config-listeners.xml
@@ -41,12 +41,21 @@
             <p>To do so, just register the class that needs to be instantiated and
added to global listeners. These JAR can be
                part of James source code, or provided as an extension and thus should be
located in the<code>extensions-jars</code> folder.</p>
 
+            <p>
+                Some MailboxListener allows you to specify if you want to run them synchronously
or asynchronously. To do so,
+                for MailboxListener that supports this, you can use the <b>async</b>
attribute (optional, per mailet default) to govern the execution mode.
+                If <b>true</b> the execution will be scheduled by a FixedThreadPool
whose size is defined by the <b>poolSize</b>
+                attribute (optional, default to 8). If <b>false</b>, the execution
is synchronous, on the current thread.
+            </p>
+
             <ul>
                 Already provided additional listeners includes:
 
                  <li><code>org.apache.james.mailbox.spamassassin.SpamAssassinListener</code>:
                      Provides per user real-time HAM/SPAM feedback to a SpamAssassin server
depending on user actions.
-                     Please note that a <code>spamassassin.properties</code>
file is needed.</li>
+                     Please note that a <code>spamassassin.properties</code>
file is needed.<br/>
+                     This mailet is asynchronous by default, but this behaviour can be overridden
by the <b>async</b>
+                     configuration property.</li>
                  <li><code>org.apache.james.mailbox.cassandra.MailboxOperationLoggingListener</code>:
                      For Cassandra guice wiring. Provides more insights on mailbox operations</li>
                  <li><code>org.apache.james.mailbox.quota.mailing.listeners.QuotaThresholdCrossingListener</code>:


---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org


Mime
View raw message