You are viewing a plain text version of this content. The canonical link for it is here.
Posted to server-dev@james.apache.org by bt...@apache.org on 2018/06/12 00:03:29 UTC
[10/17] james-project git commit: JAMES-2414 Document custom
MailboxListener `async` configuration
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 <bt...@linagora.com>
Authored: Thu Jun 7 16:41:29 2018 +0700
Committer: benwa <bt...@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