View Javadoc

1   /************************************************************************
2    * Copyright (c) 1999-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.services;
19  
20  import org.apache.mailet.Matcher;
21  
22  import javax.mail.MessagingException;
23  
24  public interface MatcherLoader {
25  
26      /***
27       * The component role used by components implementing this service
28       */
29      String ROLE = "org.apache.james.services.MatcherLoader";
30  
31      /***
32       * Get a new Matcher with the specified name acting
33       * in the specified context.
34       *
35       * @param matchName the name of the matcher to be loaded
36       * @param context the MailetContext to be passed to the new
37       *                matcher
38       * @throws MessagingException if an error occurs
39       */
40      public Matcher getMatcher(String matchName) throws MessagingException;
41  
42  }