View Javadoc

1   /*****************************************************************
2    * Licensed to the Apache Software Foundation (ASF) under one   *
3    * or more contributor license agreements.  See the NOTICE file *
4    * distributed with this work for additional information        *
5    * regarding copyright ownership.  The ASF licenses this file   *
6    * to you under the Apache License, Version 2.0 (the            *
7    * "License"); you may not use this file except in compliance   *
8    * with the License.  You may obtain a copy of the License at   *
9    *                                                              *
10   *   http://www.apache.org/licenses/LICENSE-2.0                 *
11   *                                                              *
12   * Unless required by applicable law or agreed to in writing,   *
13   * software distributed under the License is distributed on an  *
14   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY       *
15   * KIND, either express or implied.  See the License for the    *
16   * specific language governing permissions and limitations      *
17   * under the License.                                           *
18   ****************************************************************/
19  
20  package org.apache.james.services;
21  
22  import org.apache.mailet.Matcher;
23  
24  import javax.mail.MessagingException;
25  
26  public interface MatcherLoader {
27  
28      /***
29       * The component role used by components implementing this service
30       */
31      String ROLE = "org.apache.james.services.MatcherLoader";
32  
33      /***
34       * Get a new Matcher with the specified name acting
35       * in the specified context.
36       *
37       * @param matchName the name of the matcher to be loaded
38       * @param context the MailetContext to be passed to the new
39       *                matcher
40       * @throws MessagingException if an error occurs
41       */
42      public Matcher getMatcher(String matchName) throws MessagingException;
43  
44  }