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 ro...@apache.org on 2018/01/11 09:40:38 UTC
[01/10] james-project git commit: JAMES-2263 Document error handling
configuration for mailet container
Repository: james-project
Updated Branches:
refs/heads/master 9edd55b14 -> c80beefc4
JAMES-2263 Document error handling configuration for mailet container
Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/282ddb04
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/282ddb04
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/282ddb04
Branch: refs/heads/master
Commit: 282ddb04bbc25a870f95cf87253c15aa4eab5a02
Parents: 55dc6ff
Author: benwa <bt...@linagora.com>
Authored: Fri Jan 5 10:30:45 2018 +0700
Committer: benwa <bt...@linagora.com>
Committed: Fri Jan 5 10:30:45 2018 +0700
----------------------------------------------------------------------
src/site/xdoc/server/config-mailetcontainer.xml | 22 ++++++++++++++++++++
1 file changed, 22 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/james-project/blob/282ddb04/src/site/xdoc/server/config-mailetcontainer.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/server/config-mailetcontainer.xml b/src/site/xdoc/server/config-mailetcontainer.xml
index 0931327..fbd0590 100644
--- a/src/site/xdoc/server/config-mailetcontainer.xml
+++ b/src/site/xdoc/server/config-mailetcontainer.xml
@@ -77,6 +77,28 @@
pair of ("processor", "spam").</p>
</subsection>
+
+ <subsection name="Error handling">
+ <p>If an exception is encountered during the execution of a mailet or a matcher, the default behaviour is to
+ process the mail using the <strong>error</strong> processor.</p>
+
+ <p>The <strong>onMailetException</strong> property allow you to override this behaviour. You can specify an other
+ processor than the error one for handling the errors of this mailet. The <strong>ignore</strong> special value also
+ allow to continue processing and ignore the error.</p>
+
+ <p>Moreover, the <strong>onMatcherException</strong> allow you to override matcher error handling logic. You can
+ specify an other processor than the error one for handling the errors of this mailet. The <strong>matchall</strong>
+ special value also allow you to match all recipients when there is an error. The <strong>nomatch</strong>
+ special value also allow you to match no recipients when there is an error.</p>
+
+ <p>Here is a short example to illustrate this:</p>
+
+ <pre><code><mailet match=RecipientIsLocal class="LocalDelivery">
+ <onMailetException>deliveryError</onMailetException>
+ <onMatcherException>nomatch</onMatcherException>
+</mailet>
+ </code></pre>
+ </subsection>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org
[02/10] james-project git commit: JAMES-2263 Link detailed features
description from config page
Posted by ro...@apache.org.
JAMES-2263 Link detailed features description from config page
This is intended to make navigating the site more easy.
Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/b471617d
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/b471617d
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/b471617d
Branch: refs/heads/master
Commit: b471617df821cd44af16943d9f060317b0bef65e
Parents: 282ddb0
Author: benwa <bt...@linagora.com>
Authored: Fri Jan 5 10:34:27 2018 +0700
Committer: benwa <bt...@linagora.com>
Committed: Fri Jan 5 10:34:27 2018 +0700
----------------------------------------------------------------------
src/site/xdoc/server/config-mailetcontainer.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/james-project/blob/b471617d/src/site/xdoc/server/config-mailetcontainer.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/server/config-mailetcontainer.xml b/src/site/xdoc/server/config-mailetcontainer.xml
index fbd0590..9ed2630 100644
--- a/src/site/xdoc/server/config-mailetcontainer.xml
+++ b/src/site/xdoc/server/config-mailetcontainer.xml
@@ -30,7 +30,7 @@
<p>This documents explains how to configure Mail processing. Mails pass through the MailetContainer. The
MailetContainer is a Matchers (condition for executing a mailet) and Mailets (execution units that perform
actions based on incoming mail) pipeline arranged into processors (List of mailet/matcher pairs allowing
- better logical organisation).</p>
+ better logical organisation). You can read more about these concepts on <a href="feature-mailetcontainer.html">the mailet container feature description</a>.</p>
<p>Apache James Server includes a number of pre-packaged <a href="dev-provided-mailets.html">Mailets and Matchers</a>.</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org
[10/10] james-project git commit: Merge remote-tracking branch
'benoit/JAMES-2263-doc'
Posted by ro...@apache.org.
Merge remote-tracking branch 'benoit/JAMES-2263-doc'
Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/c80beefc
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/c80beefc
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/c80beefc
Branch: refs/heads/master
Commit: c80beefc400c4b06731525c1212b8acd9f26218a
Parents: 9edd55b c4add18
Author: Raphael Ouazana <ra...@linagora.com>
Authored: Thu Jan 11 10:38:59 2018 +0100
Committer: Raphael Ouazana <ra...@linagora.com>
Committed: Thu Jan 11 10:38:59 2018 +0100
----------------------------------------------------------------------
src/site/xdoc/server/config-mailetcontainer.xml | 31 ++++++++++++++++----
.../xdoc/server/feature-mailetcontainer.xml | 21 +++++++------
2 files changed, 36 insertions(+), 16 deletions(-)
----------------------------------------------------------------------
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org
[04/10] james-project git commit: JAMES-2263 Provide link to custom
mailet/matcher page
Posted by ro...@apache.org.
JAMES-2263 Provide link to custom mailet/matcher page
Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/274e7a0a
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/274e7a0a
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/274e7a0a
Branch: refs/heads/master
Commit: 274e7a0a6d93b027501c4aa98f83d815b167232a
Parents: 2d9b69e
Author: benwa <bt...@linagora.com>
Authored: Fri Jan 5 10:43:51 2018 +0700
Committer: benwa <bt...@linagora.com>
Committed: Fri Jan 5 10:48:20 2018 +0700
----------------------------------------------------------------------
src/site/xdoc/server/feature-mailetcontainer.xml | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/james-project/blob/274e7a0a/src/site/xdoc/server/feature-mailetcontainer.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/server/feature-mailetcontainer.xml b/src/site/xdoc/server/feature-mailetcontainer.xml
index fa3def2..ae7b150 100644
--- a/src/site/xdoc/server/feature-mailetcontainer.xml
+++ b/src/site/xdoc/server/feature-mailetcontainer.xml
@@ -91,8 +91,8 @@
<p>More on configuration of the SpoolManager can be found <a href="config-mailetcontainer.html">here</a>.</p>
- <p>Much of the power of James lies in the SpoolManager component. Custom matchers and
- mailets can be easily developed to address an administrator's particular needs. The
+ <p>Much of the power of James lies in the SpoolManager component. <a href="dev-extend-matcher.html">Custom matchers</a> and
+ <a href="dev-extend-mailet.html">custom mailets</a> can be easily developed to address an administrator's particular needs. The
processor tree can easily be configured to sort, filter, and deliver mail based on any
number of criteria. Mail administrators new to James should spend some time learning how
to configure the SpoolManager to meet their needs.</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org
[08/10] james-project git commit: JAMES-2263 Fix typo
Posted by ro...@apache.org.
JAMES-2263 Fix typo
Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/208c56bf
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/208c56bf
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/208c56bf
Branch: refs/heads/master
Commit: 208c56bfbaea3c7dcd15ea97b6aa5375b0c692e7
Parents: ebd3278
Author: benwa <bt...@linagora.com>
Authored: Thu Jan 11 09:54:04 2018 +0700
Committer: benwa <bt...@linagora.com>
Committed: Thu Jan 11 09:59:24 2018 +0700
----------------------------------------------------------------------
src/site/xdoc/server/config-mailetcontainer.xml | 16 ++++++++--------
1 file changed, 8 insertions(+), 8 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/james-project/blob/208c56bf/src/site/xdoc/server/config-mailetcontainer.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/server/config-mailetcontainer.xml b/src/site/xdoc/server/config-mailetcontainer.xml
index 13e6e40..c20f9a2 100644
--- a/src/site/xdoc/server/config-mailetcontainer.xml
+++ b/src/site/xdoc/server/config-mailetcontainer.xml
@@ -81,14 +81,14 @@
<p>If an exception is encountered during the execution of a mailet or a matcher, the default behaviour is to
process the mail using the <strong>error</strong> processor.</p>
- <p>The <strong>onMailetException</strong> property allow you to override this behaviour. You can specify an other
- processor than the error one for handling the errors of this mailet. The <strong>ignore</strong> special value also
- allow to continue processing and ignore the error.</p>
-
- <p>Moreover, the <strong>onMatcherException</strong> allow you to override matcher error handling logic. You can
- specify an other processor than the error one for handling the errors of this mailet. The <strong>matchall</strong>
- special value also allow you to match all recipients when there is an error. The <strong>nomatch</strong>
- special value also allow you to match no recipients when there is an error.</p>
+ <p>The <strong>onMailetException</strong> property allows you to override this behaviour. You can specify another
+ processor than the <strong>error</strong> one for handling the errors of this mailet. The <strong>ignore</strong> special value also
+ allows to continue processing and ignore the error.</p>
+
+ <p>Moreover, the <strong>onMatcherException</strong> allows you to override matcher error handling. You can
+ specify another processor than the <strong>error</strong> one for handling the errors of this mailet. The <strong>matchall</strong>
+ special value also allows you to match all recipients when there is an error. The <strong>nomatch</strong>
+ special value also allows you to match no recipients when there is an error.</p>
<p>Here is a short example to illustrate this:</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org
[06/10] james-project git commit: JAMES-2263 Link custom mailet page
from configuration page
Posted by ro...@apache.org.
JAMES-2263 Link custom mailet page from configuration page
Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/4b24205c
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/4b24205c
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/4b24205c
Branch: refs/heads/master
Commit: 4b24205cf9f21fc685100667b4bd9bfab9d78004
Parents: 046c55d
Author: benwa <bt...@linagora.com>
Authored: Fri Jan 5 10:50:47 2018 +0700
Committer: benwa <bt...@linagora.com>
Committed: Fri Jan 5 10:50:47 2018 +0700
----------------------------------------------------------------------
src/site/xdoc/server/config-mailetcontainer.xml | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/james-project/blob/4b24205c/src/site/xdoc/server/config-mailetcontainer.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/server/config-mailetcontainer.xml b/src/site/xdoc/server/config-mailetcontainer.xml
index 9ed2630..f86b129 100644
--- a/src/site/xdoc/server/config-mailetcontainer.xml
+++ b/src/site/xdoc/server/config-mailetcontainer.xml
@@ -32,7 +32,9 @@
actions based on incoming mail) pipeline arranged into processors (List of mailet/matcher pairs allowing
better logical organisation). You can read more about these concepts on <a href="feature-mailetcontainer.html">the mailet container feature description</a>.</p>
- <p>Apache James Server includes a number of pre-packaged <a href="dev-provided-mailets.html">Mailets and Matchers</a>.</p>
+ <p>Apache James Server includes a number of pre-packaged <a href="dev-provided-mailets.html">Mailets and Matchers</a>.
+ Futhermore, you can write and use with James your own <a href="dev-extend-matcher.html">custom matchers</a> and
+ <a href="dev-extend-mailet.html">custom mailets</a>.</p>
<p>Consult <a href="https://github.com/apache/james-project/tree/master/server/app/src/main/resources/mailetcontainer.xml">mailetcontainer.xml</a> in GIT to get some examples and hints.</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org
[05/10] james-project git commit: JAMES-2263 Solve duplicated links
Posted by ro...@apache.org.
JAMES-2263 Solve duplicated links
Note that matchers are now included in mailet page
Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/046c55d3
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/046c55d3
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/046c55d3
Branch: refs/heads/master
Commit: 046c55d3901e978da718040659f5adce6d048593
Parents: 274e7a0
Author: benwa <bt...@linagora.com>
Authored: Fri Jan 5 10:45:41 2018 +0700
Committer: benwa <bt...@linagora.com>
Committed: Fri Jan 5 10:48:24 2018 +0700
----------------------------------------------------------------------
src/site/xdoc/server/feature-mailetcontainer.xml | 7 ++-----
1 file changed, 2 insertions(+), 5 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/james-project/blob/046c55d3/src/site/xdoc/server/feature-mailetcontainer.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/server/feature-mailetcontainer.xml b/src/site/xdoc/server/feature-mailetcontainer.xml
index ae7b150..5a7cb40 100644
--- a/src/site/xdoc/server/feature-mailetcontainer.xml
+++ b/src/site/xdoc/server/feature-mailetcontainer.xml
@@ -122,12 +122,9 @@
<p>The Mailet API is currently in its second revision. Although, the Mailet API is expected to undergo substantial changes in the near future, it is our aim that existing Mailets that abided purely by the prior Mailet API interfaces will continue to run with the revised specification.</p>
<p>The Javadoc for the Mailet API can be found <a href="http://james.apache.org/mailet/api/apidocs/">here</a>.</p>
-
- <p>James bundles a number of Matchers and Mailets in its distribution. Descriptions of provided matchers
- can be found <a href="dev-provided-matchers.html">here</a>, while descriptions of provided mailets can be found
- <a href="dev-provided-mailets.html">here</a>.</p>
- <p>You can retrieve the full list of mailets and matchers packaged in James <a href="dev-provided-mailets.html">here</a></p>
+ <p>James bundles a number of Matchers and Mailets in its distribution. You can retrieve the full list of mailets
+ and matchers packaged in James <a href="dev-provided-mailets.html">here</a></p>
<p>You can read more on mailets on following web sites:</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org
[07/10] james-project git commit: JAMES-2263 mailserver tag dispeared
and configuration files had be split
Posted by ro...@apache.org.
JAMES-2263 mailserver tag dispeared and configuration files had be split
Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/ebd32785
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/ebd32785
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/ebd32785
Branch: refs/heads/master
Commit: ebd32785ea08e1ece784caa760187052ea26f5dc
Parents: 4b24205
Author: benwa <bt...@linagora.com>
Authored: Fri Jan 5 10:52:15 2018 +0700
Committer: benwa <bt...@linagora.com>
Committed: Fri Jan 5 10:52:15 2018 +0700
----------------------------------------------------------------------
src/site/xdoc/server/config-mailetcontainer.xml | 3 ---
1 file changed, 3 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/james-project/blob/ebd32785/src/site/xdoc/server/config-mailetcontainer.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/server/config-mailetcontainer.xml b/src/site/xdoc/server/config-mailetcontainer.xml
index f86b129..13e6e40 100644
--- a/src/site/xdoc/server/config-mailetcontainer.xml
+++ b/src/site/xdoc/server/config-mailetcontainer.xml
@@ -38,9 +38,6 @@
<p>Consult <a href="https://github.com/apache/james-project/tree/master/server/app/src/main/resources/mailetcontainer.xml">mailetcontainer.xml</a> in GIT to get some examples and hints.</p>
- <p>This configuration block is defined by the <strong>mailserver</strong> tag. All administrators
- need to adjust the <strong>mailserver</strong> block upon installation.</p>
-
<dl>
<dt><strong>context.postmaster</strong></dt>
<dd>The body of this element is the address that the server
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org
[09/10] james-project git commit: JAMES-2263 Add link from feature to
error handling details
Posted by ro...@apache.org.
JAMES-2263 Add link from feature to error handling details
Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/c4add18f
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/c4add18f
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/c4add18f
Branch: refs/heads/master
Commit: c4add18f6f83e2674ab1d6521bdd2124e627a7c6
Parents: 208c56b
Author: benwa <bt...@linagora.com>
Authored: Thu Jan 11 09:54:26 2018 +0700
Committer: benwa <bt...@linagora.com>
Committed: Thu Jan 11 09:59:24 2018 +0700
----------------------------------------------------------------------
src/site/xdoc/server/feature-mailetcontainer.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/james-project/blob/c4add18f/src/site/xdoc/server/feature-mailetcontainer.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/server/feature-mailetcontainer.xml b/src/site/xdoc/server/feature-mailetcontainer.xml
index 5a7cb40..ed9b87f 100644
--- a/src/site/xdoc/server/feature-mailetcontainer.xml
+++ b/src/site/xdoc/server/feature-mailetcontainer.xml
@@ -58,7 +58,7 @@
and that message is processed by the mailet. The recipients for the other mail are set to the
non-matching recipients, and that message is not processed by the mailet.</p>
- <p>Note that you can specify per mailet and per matcher detailed error handling logic.</p>
+ <p>Note that you can specify per mailet and per matcher specific <a href="config-mailetcontainer.html#Error_handling">error handling logic.</a></p>
</subsection>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org
[03/10] james-project git commit: JAMES-2263 Document error handling
feature
Posted by ro...@apache.org.
JAMES-2263 Document error handling feature
Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/2d9b69eb
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/2d9b69eb
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/2d9b69eb
Branch: refs/heads/master
Commit: 2d9b69eb3e640c85574271a040d37483bf0f6dc4
Parents: b471617
Author: benwa <bt...@linagora.com>
Authored: Fri Jan 5 10:36:02 2018 +0700
Committer: benwa <bt...@linagora.com>
Committed: Fri Jan 5 10:36:02 2018 +0700
----------------------------------------------------------------------
src/site/xdoc/server/feature-mailetcontainer.xml | 10 ++++++----
1 file changed, 6 insertions(+), 4 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/james-project/blob/2d9b69eb/src/site/xdoc/server/feature-mailetcontainer.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/server/feature-mailetcontainer.xml b/src/site/xdoc/server/feature-mailetcontainer.xml
index f284413..fa3def2 100644
--- a/src/site/xdoc/server/feature-mailetcontainer.xml
+++ b/src/site/xdoc/server/feature-mailetcontainer.xml
@@ -47,16 +47,18 @@
to a local repository, or handling remote delivery. Both the Matcher and Mailet APIs are
public, allowing James users to write their own custom matchers and mailets. James
comes with a large set of pre-built matchers and mailets.</p>
-
- <p>Matchers and mailets are used in pairs. At each stage in processing a message is checked
+
+ <p>Matchers and mailets are used in pairs. At each stage in processing a message is checked
against a matcher. The matcher will attempt to match the mail message. The match is not simply
- a yes or no issue. Instead, the match method returns a collection of matched recipients. If the
+ a yes or no issue. Instead, the match method returns a collection of matched recipients. If the
this collection of matched recipients is empty, the mailet is not invoked. If the collection of
- matched recipients is the entire set of original recipients, the mail is then processed by the
+ matched recipients is the entire set of original recipients, the mail is then processed by the
associated mailet. Finally, if the matcher only matches a proper subset of the original recipients,
the original mail is duplicated. The recipients for one message are set to the matched recipients,
and that message is processed by the mailet. The recipients for the other mail are set to the
non-matching recipients, and that message is not processed by the mailet.</p>
+
+ <p>Note that you can specify per mailet and per matcher detailed error handling logic.</p>
</subsection>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org