View Javadoc

1   /************************************************************************
2    * Copyright (c) 2000-2006 The Apache Software Foundation.             *
3    * All rights reserved.                                                *
4    * ------------------------------------------------------------------- *
5    * Licensed under the Apache License, Version 2.0 (the "License"); you *
6    * may not use this file except in compliance with the License. You    *
7    * may obtain a copy of the License at:                                *
8    *                                                                     *
9    *     http://www.apache.org/licenses/LICENSE-2.0                      *
10   *                                                                     *
11   * Unless required by applicable law or agreed to in writing, software *
12   * distributed under the License is distributed on an "AS IS" BASIS,   *
13   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or     *
14   * implied.  See the License for the specific language governing       *
15   * permissions and limitations under the License.                      *
16   ***********************************************************************/
17  
18  package org.apache.james.transport.matchers;
19  
20  import org.apache.mailet.GenericMatcher;
21  import org.apache.mailet.Mail;
22  import org.apache.mailet.MailAddress;
23  
24  import java.util.Collection;
25  import java.util.StringTokenizer;
26  
27  /***
28   * <P>Matches mails that are sent by an SMTP authenticated user present in a supplied list.</P>
29   * <P>If the sender was not authenticated it will not match.</P>
30   * <P>Configuration string: a comma, tab or space separated list of James users.</P>
31   * <PRE><CODE>
32   * &lt;mailet match=&quot;SMTPAuthUserIs=&lt;list-of-user-names&gt;&quot; class=&quot;&lt;any-class&gt;&quot;&gt;
33   * </CODE></PRE>
34   *
35   * @version CVS $Revision: 365582 $ $Date: 2006-01-03 08:51:21 +0000 (mar, 03 gen 2006) $
36   * @since 2.2.0
37   */
38  public class SMTPAuthUserIs extends GenericMatcher {
39      
40      /***
41       * The mail attribute holding the SMTP AUTH user name, if any.
42       */
43      private final static String SMTP_AUTH_USER_ATTRIBUTE_NAME = "org.apache.james.SMTPAuthUser";
44      
45      private Collection users;
46  
47      public void init() throws javax.mail.MessagingException {
48          StringTokenizer st = new StringTokenizer(getCondition(), ", \t", false);
49          users = new java.util.HashSet();
50          while (st.hasMoreTokens()) {
51              users.add(st.nextToken());
52          }
53      }
54  
55      public Collection match(Mail mail) {
56          String authUser = (String) mail.getAttribute(SMTP_AUTH_USER_ATTRIBUTE_NAME);
57          if (authUser != null && users.contains(authUser)) {
58              return mail.getRecipients();
59          } else {
60              return null;
61          }
62      }
63  }