org.apache.james.rrt.lib

Class AbstractRecipientRewriteTable

java.lang.Object

org.apache.james.rrt.lib.AbstractRecipientRewriteTable

All Implemented Interfaces:

org.apache.james.lifecycle.api.Configurable, org.apache.james.lifecycle.api.LogEnabled, org.apache.james.rrt.api.RecipientRewriteTable

public abstract class AbstractRecipientRewriteTable
extends Object
implements org.apache.james.rrt.api.RecipientRewriteTable, org.apache.james.lifecycle.api.LogEnabled, org.apache.james.lifecycle.api.Configurable

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.james.rrt.api.RecipientRewriteTable

org.apache.james.rrt.api.RecipientRewriteTable.ErrorMappingException

Field Summary

Fields inherited from interface org.apache.james.rrt.api.RecipientRewriteTable

ALIASDOMAIN_PREFIX, ERROR_PREFIX, REGEX_PREFIX, WILDCARD

Constructor Summary

Constructors

Constructor and Description
AbstractRecipientRewriteTable()

Method Summary

Modifier and Type	Method and Description
void	addAddressMapping(String user, String domain, String address)
void	addAliasDomainMapping(String aliasDomain, String realDomain)
void	addErrorMapping(String user, String domain, String error)
void	addMapping(String user, String domain, String mapping)
protected abstract void	addMappingInternal(String user, String domain, String mapping) Add new mapping
void	addRegexMapping(String user, String domain, String regex)
void	configure(org.apache.commons.configuration.HierarchicalConfiguration config)
protected void	doConfigure(org.apache.commons.configuration.HierarchicalConfiguration conf) Override to handle config
Map<String,org.apache.james.rrt.lib.Mappings>	getAllMappings()
protected abstract Map<String,org.apache.james.rrt.lib.Mappings>	getAllMappingsInternal() Return a Map which holds all Mappings
protected String	getFixedDomain(String domain) Fix the domain for the given argument.
protected String	getFixedUser(String user) Return user String for the given argument.
protected org.slf4j.Logger	getLogger()
org.apache.james.rrt.lib.Mappings	getMappings(String user, String domain)
org.apache.james.rrt.lib.Mappings	getMappings(String user, String domain, int mappingLimit)
org.apache.james.rrt.lib.Mappings	getUserDomainMappings(String user, String domain)
protected abstract org.apache.james.rrt.lib.Mappings	getUserDomainMappingsInternal(String user, String domain) Return Collection of all mappings for the given username and domain
protected abstract String	mapAddressInternal(String user, String domain) Override to map virtual recipients to real recipients, both local and non-local.
void	removeAddressMapping(String user, String domain, String address)
void	removeAliasDomainMapping(String aliasDomain, String realDomain)
void	removeErrorMapping(String user, String domain, String error)
void	removeMapping(String user, String domain, String mapping)
protected abstract void	removeMappingInternal(String user, String domain, String mapping) Remove mapping
void	removeRegexMapping(String user, String domain, String regex)
void	setDomainList(org.apache.james.domainlist.api.DomainList domainList)
void	setLog(org.slf4j.Logger logger)
void	setMappingLimit(int mappingLimit) Set the mappingLimit
void	setRecursiveMapping(boolean recursive)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractRecipientRewriteTable

public AbstractRecipientRewriteTable()

Method Detail

setDomainList

@Inject
public void setDomainList(org.apache.james.domainlist.api.DomainList domainList)

configure

public void configure(org.apache.commons.configuration.HierarchicalConfiguration config)
               throws org.apache.commons.configuration.ConfigurationException

Specified by:

configure in interface org.apache.james.lifecycle.api.Configurable

Throws:

org.apache.commons.configuration.ConfigurationException

See Also:

Configurable.configure(HierarchicalConfiguration)

setLog

public void setLog(org.slf4j.Logger logger)

Specified by:

setLog in interface org.apache.james.lifecycle.api.LogEnabled

doConfigure

protected void doConfigure(org.apache.commons.configuration.HierarchicalConfiguration conf)
                    throws org.apache.commons.configuration.ConfigurationException

Override to handle config

Parameters:

conf -

Throws:

org.apache.commons.configuration.ConfigurationException

setRecursiveMapping

public void setRecursiveMapping(boolean recursive)

setMappingLimit

public void setMappingLimit(int mappingLimit)
                     throws IllegalArgumentException

Set the mappingLimit

Parameters:

mappingLimit - the mappingLimit

Throws:

IllegalArgumentException - get thrown if mappingLimit smaller then 1 is used

getMappings

public org.apache.james.rrt.lib.Mappings getMappings(String user,
                                                     String domain)
                                              throws org.apache.james.rrt.api.RecipientRewriteTable.ErrorMappingException,
                                                     org.apache.james.rrt.api.RecipientRewriteTableException

Specified by:

getMappings in interface org.apache.james.rrt.api.RecipientRewriteTable

Throws:

org.apache.james.rrt.api.RecipientRewriteTable.ErrorMappingException

org.apache.james.rrt.api.RecipientRewriteTableException

See Also:

RecipientRewriteTable.getMappings(String, String)

getMappings

public org.apache.james.rrt.lib.Mappings getMappings(String user,
                                                     String domain,
                                                     int mappingLimit)
                                              throws org.apache.james.rrt.api.RecipientRewriteTable.ErrorMappingException,
                                                     org.apache.james.rrt.api.RecipientRewriteTableException

Throws:

org.apache.james.rrt.api.RecipientRewriteTable.ErrorMappingException

org.apache.james.rrt.api.RecipientRewriteTableException

addRegexMapping

public void addRegexMapping(String user,
                            String domain,
                            String regex)
                     throws org.apache.james.rrt.api.RecipientRewriteTableException

Specified by:

addRegexMapping in interface org.apache.james.rrt.api.RecipientRewriteTable

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

See Also:

RecipientRewriteTable.addRegexMapping(java.lang.String, java.lang.String, java.lang.String)

removeRegexMapping

public void removeRegexMapping(String user,
                               String domain,
                               String regex)
                        throws org.apache.james.rrt.api.RecipientRewriteTableException

Specified by:

removeRegexMapping in interface org.apache.james.rrt.api.RecipientRewriteTable

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

See Also:

RecipientRewriteTable.removeRegexMapping(java.lang.String, java.lang.String, java.lang.String)

addAddressMapping

public void addAddressMapping(String user,
                              String domain,
                              String address)
                       throws org.apache.james.rrt.api.RecipientRewriteTableException

Specified by:

addAddressMapping in interface org.apache.james.rrt.api.RecipientRewriteTable

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

See Also:

RecipientRewriteTable.addAddressMapping(java.lang.String, java.lang.String, java.lang.String)

removeAddressMapping

public void removeAddressMapping(String user,
                                 String domain,
                                 String address)
                          throws org.apache.james.rrt.api.RecipientRewriteTableException

Specified by:

removeAddressMapping in interface org.apache.james.rrt.api.RecipientRewriteTable

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

See Also:

RecipientRewriteTable.removeAddressMapping(java.lang.String, java.lang.String, java.lang.String)

addErrorMapping

public void addErrorMapping(String user,
                            String domain,
                            String error)
                     throws org.apache.james.rrt.api.RecipientRewriteTableException

Specified by:

addErrorMapping in interface org.apache.james.rrt.api.RecipientRewriteTable

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

See Also:

RecipientRewriteTable.addErrorMapping(java.lang.String, java.lang.String, java.lang.String)

removeErrorMapping

public void removeErrorMapping(String user,
                               String domain,
                               String error)
                        throws org.apache.james.rrt.api.RecipientRewriteTableException

Specified by:

removeErrorMapping in interface org.apache.james.rrt.api.RecipientRewriteTable

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

See Also:

RecipientRewriteTable.removeErrorMapping(java.lang.String, java.lang.String, java.lang.String)

addMapping

public void addMapping(String user,
                       String domain,
                       String mapping)
                throws org.apache.james.rrt.api.RecipientRewriteTableException

Specified by:

addMapping in interface org.apache.james.rrt.api.RecipientRewriteTable

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

See Also:

RecipientRewriteTable.addMapping(java.lang.String, java.lang.String, java.lang.String)

removeMapping

public void removeMapping(String user,
                          String domain,
                          String mapping)
                   throws org.apache.james.rrt.api.RecipientRewriteTableException

Specified by:

removeMapping in interface org.apache.james.rrt.api.RecipientRewriteTable

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

See Also:

RecipientRewriteTable.removeMapping(java.lang.String, java.lang.String, java.lang.String)

getAllMappings

public Map<String,org.apache.james.rrt.lib.Mappings> getAllMappings()
                                                             throws org.apache.james.rrt.api.RecipientRewriteTableException

Specified by:

getAllMappings in interface org.apache.james.rrt.api.RecipientRewriteTable

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

See Also:

RecipientRewriteTable.getAllMappings()

getUserDomainMappings

public org.apache.james.rrt.lib.Mappings getUserDomainMappings(String user,
                                                               String domain)
                                                        throws org.apache.james.rrt.api.RecipientRewriteTableException

Specified by:

getUserDomainMappings in interface org.apache.james.rrt.api.RecipientRewriteTable

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

See Also:

RecipientRewriteTable.getUserDomainMappings(java.lang.String, java.lang.String)

addAliasDomainMapping

public void addAliasDomainMapping(String aliasDomain,
                                  String realDomain)
                           throws org.apache.james.rrt.api.RecipientRewriteTableException

Specified by:

addAliasDomainMapping in interface org.apache.james.rrt.api.RecipientRewriteTable

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

See Also:

RecipientRewriteTable.addAliasDomainMapping(java.lang.String, java.lang.String)

removeAliasDomainMapping

public void removeAliasDomainMapping(String aliasDomain,
                                     String realDomain)
                              throws org.apache.james.rrt.api.RecipientRewriteTableException

Specified by:

removeAliasDomainMapping in interface org.apache.james.rrt.api.RecipientRewriteTable

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

See Also:

RecipientRewriteTable.removeAliasDomainMapping(java.lang.String, java.lang.String)

getLogger

protected org.slf4j.Logger getLogger()

addMappingInternal

protected abstract void addMappingInternal(String user,
                                           String domain,
                                           String mapping)
                                    throws org.apache.james.rrt.api.RecipientRewriteTableException

Add new mapping

Parameters:

user - the user

domain - the domain

mapping - the mapping

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

removeMappingInternal

protected abstract void removeMappingInternal(String user,
                                              String domain,
                                              String mapping)
                                       throws org.apache.james.rrt.api.RecipientRewriteTableException

Remove mapping

Parameters:

user - the user

domain - the domain

mapping - the mapping

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

getUserDomainMappingsInternal

protected abstract org.apache.james.rrt.lib.Mappings getUserDomainMappingsInternal(String user,
                                                                                   String domain)
                                                                            throws org.apache.james.rrt.api.RecipientRewriteTableException

Return Collection of all mappings for the given username and domain

Parameters:

user - the user

domain - the domain

Returns:

Collection which hold the mappings

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

getAllMappingsInternal

protected abstract Map<String,org.apache.james.rrt.lib.Mappings> getAllMappingsInternal()
                                                                                 throws org.apache.james.rrt.api.RecipientRewriteTableException

Return a Map which holds all Mappings

Returns:

Map

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

mapAddressInternal

protected abstract String mapAddressInternal(String user,
                                             String domain)
                                      throws org.apache.james.rrt.api.RecipientRewriteTableException

Override to map virtual recipients to real recipients, both local and non-local. Each key in the provided map corresponds to a potential virtual recipient, stored as a MailAddress object. Translate virtual recipients to real recipients by mapping a string containing the address of the real recipient as a value to a key. Leave the value null if no mapping should be performed. Multiple recipients may be specified by delineating the mapped string with commas, semi-colons or colons.

Parameters:

user - the mapping of virtual to real recipients, as MailAddresses to Strings.

Throws:

org.apache.james.rrt.api.RecipientRewriteTableException

getFixedUser

protected String getFixedUser(String user)

Return user String for the given argument. If give value is null, return a wildcard.

Parameters:

user - the given user String

Returns:

fixedUser the fixed user String

getFixedDomain

protected String getFixedDomain(String domain)

Fix the domain for the given argument. If give value is null, return a wildcard.

Parameters:

domain - the given domain String

Returns:

fixedDomain the fixed domain String