com.javahollic.jira.emh.api.extension.preproctask

Interface IJEMHMailHeaderPreProcTask

All Superinterfaces:

IJEMHModuleProvider

public interface IJEMHMailHeaderPreProcTask
extends IJEMHModuleProvider

Definition of filters for JEMH.

Author:

andy

Field Summary

Fields

Modifier and Type	Field and Description
static String	UTF8

Method Summary

Modifier and Type	Method and Description
String	filterHeader(String header, String value, IJEMHRuntimeConfig config, List<ConfigField> taskConfig) API exposes the config via ConfigFields rather than entities
String	filterPostProcessedMail(String content)
List<ConfigField>	getDefaultConfig() Allow JEMH to create example TaskConfig as need for this task, list is pre-sorted based on weight
Set<String>	getHeadersHandled() Collection of headers that are to be processed
void	init(IJEMHRuntimeConfig config, IJEMHInboundReport report, List<ConfigField> fields) Generic init method to allow setup if needed
boolean	isFilterPostProccessedMail()
boolean	isSelfTestCapable()
boolean	runSelfTest(List<ConfigField> updatedConfig) run a local self test, if implemented

Methods inherited from interface com.javahollic.jira.emh.api.extension.IJEMHModuleProvider

getDescription, getKey, getName, getStatus, getVendor, getVendorUrl, isUsable

Field Detail

UTF8

static final String UTF8

See Also:

Constant Field Values

Method Detail

init

void init(IJEMHRuntimeConfig config,
          IJEMHInboundReport report,
          List<ConfigField> fields)
   throws InitFailureException

Generic init method to allow setup if needed

Parameters:

config - the JEMH runtime configuration

report - to feedback from preproc tasks

fields - the pre-proc task configuration fields

Throws:

InitFailureException - if it breaks

getHeadersHandled

Set<String> getHeadersHandled()

Collection of headers that are to be processed

Returns:

set of headers handled by the PreProcTask, eg To:

filterHeader

String filterHeader(String header,
                    String value,
                    IJEMHRuntimeConfig config,
                    List<ConfigField> taskConfig)
             throws PreProcTaskFailureException

API exposes the config via ConfigFields rather than entities

Parameters:

header - the header to filter, eg To

value - the value of the header coming in

config - the JEMH runtime configuration

taskConfig - the list of pre-proc task configuration fields

Returns:

modified header value

Throws:

PreProcTaskFailureException - if it breaks

getDefaultConfig

List<ConfigField> getDefaultConfig()

Allow JEMH to create example TaskConfig as need for this task, list is pre-sorted based on weight

Returns:

default config for this pre-proc task

runSelfTest

boolean runSelfTest(List<ConfigField> updatedConfig)
             throws PreProcTaskFailureException

run a local self test, if implemented

Parameters:

updatedConfig - updated pre-proc task config

Returns:

true on success

Throws:

PreProcTaskFailureException - if it didn't

isSelfTestCapable

boolean isSelfTestCapable()

Returns:

true if is self test enabled

isFilterPostProccessedMail

boolean isFilterPostProccessedMail()

Returns:

true if this pre-proc task should also process the post-processed mail body

filterPostProcessedMail

String filterPostProcessedMail(String content)

Parameters:

content - the email body after other pre-proc tasks have manipulated headers

Returns:

full email body, after another pass