Examples of org.apache.mailet.Matcher

org.apache.mailet.Matcher
This interface define the behaviour of the message "routing" inside the mailet container. The match(Mail) method returns a Collection of recipients that meet this class's criteria.
An important feature of the mailet container is the ability to fork processing of messages. When a message first arrives at the server, it might have multiple recipients specified. As a message is passed to a matcher, the matcher might only "match" one of the listed recipients. It would then return only the matching recipient in the Collection. The mailet container should then duplicate the message splitting the recipient list across the two messages as per what the matcher returned.
[THIS PARAGRAPH NOT YET IMPLEMENTED] The matcher can extend this forking to further separation by returning a Collection of Collection objects. This allows a matcher to fork multiple processes if there are multiple recipients that require separate processing. For example, we could write a ListservMatcher that handles multiple listservs. When someone cross-posts across multiple listservs that this matcher handles, it could put each listserv address (recipient) that it handles in a separate Collection object. By returning each of these Collections within a container Collection object, it could indicate to the mailet container how many forks to spawn.
This interface defines methods to initialize a matcher, to match messages, and to remove a matcher from the server. These are known as life-cycle methods and are called in the following sequence:
1. The matcher is constructed, then initialized with the init method.
2. Any calls from clients to the match method are handled.
3. The matcher is taken out of service, then destroyed with the destroy method, then garbage collected and finalized.
In addition to the life-cycle methods, this interface provides the getMatcherConfig method, which the matcher can use to get any startup information, and the getMatcherInfo method, which allows the matcher to return basic information about itself, such as author, version, and copyright. @version 1.0.0, 24/04/1999 @author Federico Barbieri @author Serge Knystautas


        String matchName = config.getMatcherName();


        try {


            final Matcher matcher = load(matchName);


            // init the matcher
            matcher.init(config);
            return matcher;


        } catch (MessagingException me) {
            throw me;
        } catch (Exception e) {

View Full Code Here

            jmxListener.dispose();
        }


        for (MatcherMailetPair pair : pairs) {
            Mailet mailet = pair.getMailet();
            Matcher matcher = pair.getMatcher();
            if (logger.isDebugEnabled()) {
                logger.debug("Shutdown matcher " + matcher.getMatcherInfo());
            }
            matcher.destroy();


            if (logger.isDebugEnabled()) {
                logger.debug("Shutdown mailet " + mailet.getMailetInfo());
            }
            mailet.destroy();

View Full Code Here

        for (HierarchicalConfiguration c : compMatcherConfs) {
            String compName = c.getString("[@name]", null);
            String matcherName = c.getString("[@match]", null);
            String invertedMatcherName = c.getString("[@notmatch]", null);


            Matcher matcher = null;
            if (matcherName != null && invertedMatcherName != null) {
                // if no matcher is configured throw an Exception
                throw new ConfigurationException("Please configure only match or nomatch per mailet");
            } else if (matcherName != null) {
                matcher = matcherLoader.getMatcher(createMatcherConfig(matcherName));
                if (matcher instanceof CompositeMatcher) {
                    CompositeMatcher compMatcher = (CompositeMatcher) matcher;


                    List<Matcher> childMatcher = loadCompositeMatchers(state, compMap, c.configurationsAt("matcher"));
                    for (Matcher aChildMatcher : childMatcher) {
                        compMatcher.add(aChildMatcher);
                    }
                }
            } else if (invertedMatcherName != null) {
                Matcher m = matcherLoader.getMatcher(createMatcherConfig(invertedMatcherName));
                if (m instanceof CompositeMatcher) {
                    CompositeMatcher compMatcher = (CompositeMatcher) m;


                    List<Matcher> childMatcher = loadCompositeMatchers(state, compMap, c.configurationsAt("matcher"));
                    for (Matcher aChildMatcher : childMatcher) {

View Full Code Here

            String mailetClassName = c.getString("[@class]");
            String matcherName = c.getString("[@match]", null);
            String invertedMatcherName = c.getString("[@notmatch]", null);


            Mailet mailet;
            Matcher matcher;


            try {


                if (matcherName != null && invertedMatcherName != null) {
                    // if no matcher is configured throw an Exception

View Full Code Here

        FakeMatcherConfig mci = new FakeMatcherConfig(matcherName, context);
        matcher.init(mci);
    }


    void setupChild(String matcherName) throws MessagingException {
        Matcher child;
        if (matcherName.equals("All")) {
            child = new All();
        }
        else {
            child = new RecipientIs();
        }
        FakeMatcherConfig sub = new FakeMatcherConfig(matcherName, context);
        child.init(sub);
        matcher.add(child);
    }

View Full Code Here

     * @return Collection of Recipient from the Or composition results of the
     *         child matchers.
     */
    public Collection match(Mail mail) throws MessagingException {
        Collection finalResult = null;
        Matcher matcher;
        boolean first = true;


        // the size of the complete set of recipients
        int size = mail.getRecipients().size();


        // Loop through until the finalResult is full or all the child matchers
        // have been executed
        for (Iterator matcherIter = iterator(); matcherIter.hasNext();) {
            matcher = (Matcher) matcherIter.next();
            // log("Matching with "
            // + matcher
            // .getMatcherConfig()
            // .getMatcherName()
            // );
            Collection result = matcher.match(mail);
            if (first) {
                if (result == null) {
                    result = new ArrayList(0);
                }
                finalResult = result;

View Full Code Here

     * @return Collectiom of Recipient from the Negated composition of the child
     *         Matcher(s).
     */
    public Collection match(Mail mail) throws MessagingException {
        Collection finalResult = mail.getRecipients();
        Matcher matcher;
        for (Iterator matcherIter = iterator(); matcherIter.hasNext();) {
            matcher = (Matcher) (matcherIter.next());
            // log("Matching with " +
            // matcher.getMatcherConfig().getMatcherName());
            Collection result = matcher.match(mail);
            if (result == finalResult) {
                // Not is an empty list
                finalResult = null;
            } else if (result != null) {
                finalResult = new ArrayList(finalResult);

View Full Code Here

     * @return Collection of Recipients from the Xor composition of the child
     *         matchers.
     */
    public Collection match(Mail mail) throws MessagingException {
        Collection finalResult = null;
        Matcher matcher;
        boolean first = true;
        for (Iterator matcherIter = iterator(); matcherIter.hasNext();) {
            matcher = (Matcher) (matcherIter.next());
            Collection result = matcher.match(mail);
            if (result == null) {
                result = new ArrayList(0);
            }
            // log("Matching with " +
            // matcher.getMatcherConfig().getMatcherName() +

View Full Code Here

    public Matcher getMatcher(MatcherConfig config) throws MessagingException {


        try {
            Class<Matcher> clazz = (Class<Matcher>) Thread.currentThread().getContextClassLoader().loadClass(config.
                    getMatcherName());
            Matcher m = clazz.newInstance();
            m.init(config);
            return m;
        } catch (Exception e) {
            throw new MessagingException("Unable to load matcher " + config.getMatcherName());
        }

View Full Code Here

     * @return Collection of Recipient from the And composition results of the
     *         child Matchers.
     */
    public Collection match(Mail mail) throws MessagingException {
        Collection finalResult = null;
        Matcher matcher;
        boolean first = true;
        for (Iterator matcherIter = iterator(); matcherIter.hasNext();) {
            matcher = (Matcher) (matcherIter.next());
            Collection result = matcher.match(mail);


            if (result == null) {
                // short-circuit
                // log("Matching with " +
                // matcher.getMatcherConfig().getMatcherName() +

View Full Code Here

0 1 2 3 4 5

TOP

Related Classes of org.apache.mailet.Matcher

org.apache.james.container.spring.bean.factory.mailetcontainer.MatcherLoaderBeanFactory

org.apache.james.mailetcontainer.api.mock.MockMatcherLoader

org.apache.james.mailetcontainer.camel.CamelMailProcessorList

org.apache.james.mailetcontainer.camel.CamelMailProcessorList$SpoolRouteBuilder

org.apache.james.mailetcontainer.impl.camel.CamelMailetProcessor$MailetContainerRouteBuilder

org.apache.james.mailetcontainer.impl.jmx.JMXStateMailetProcessorListener

org.apache.james.mailetcontainer.impl.matchers.And

org.apache.james.mailetcontainer.impl.matchers.BaseMatchersTest

org.apache.james.mailetcontainer.impl.matchers.Not

org.apache.james.mailetcontainer.impl.matchers.Or

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.