| <?xml version="1.0"?> |
| <!-- |
| Licensed to the Apache Software Foundation (ASF) under one |
| or more contributor license agreements. See the NOTICE file |
| distributed with this work for additional information |
| regarding copyright ownership. The ASF licenses this file |
| to you under the Apache License, Version 2.0 (the |
| "License"); you may not use this file except in compliance |
| with the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, |
| software distributed under the License is distributed on an |
| "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| KIND, either express or implied. See the License for the |
| specific language governing permissions and limitations |
| under the License. |
| --> |
| <document> |
| |
| <properties> |
| <title>Apache James Server 3 - Queue Priority</title> |
| </properties> |
| |
| <body> |
| |
| <section name="Priority in the Spooling Queues"> |
| |
| <p>Priority is supported when James (de)queues the mails during the spooling process.</p> |
| |
| <p>For this just add a Mail attribute with name "MAIL-PRIORITY" to the mail you send.</p> |
| |
| <p>This mail header should use one of the following value:</p> |
| |
| <ol> |
| <li>0 for LOW-PRIORITY</li> |
| <li>5 for NORMAL-PRIORITY (default)</li> |
| <li>9 for HIGH-PRIORITY</li> |
| </ol> |
| |
| <p>Default priority if no MAIL-PRIORITY attribute set is NORMAL-PRIORITY.</p> |
| |
| </section> |
| |
| <section name="Usage Scenario"> |
| |
| <p>There are two scenarios to set priority in the queue.</p> |
| <ul> |
| <li>Write a <a href="dev-extend-smtp-hook.html">SMTP hook</a> which sets the header |
| and add the hook to smtphandler chain.</li> |
| <li>You could also add the header in a mailet to let remotedelivery |
| pick it up again on redelivery.</li> |
| </ul> |
| |
| </section> |
| |
| </body> |
| |
| </document> |
