net.sf.sasl.language.placeholder.aop.resolver
Class ExceptionPlaceholderResolver

java.lang.Object
  net.sf.sasl.language.placeholder.aop.resolver.ExceptionPlaceholderResolver

All Implemented Interfaces:

IPlaceholderResolver

public class ExceptionPlaceholderResolver
extends Object
implements IPlaceholderResolver

The resolver offers placeholders to get informations of an occured exception.

exceptionStackTrace:
Returns the stack trace of an occurred exception. Same as calling occurredException.printStackTrace(...).
exceptionMessage:
Returns the exeception message of an occured exception. Same as calling occurredException.getMessage().
exceptionClassName{['qualification']}:
Returns the class name of an occured exception. If the optional parameter qualification is "simple", than the simple name of the class will be returned, else the full qualified name.

Since:

0.0.2 (sasl-common-aspect-library)

Author:

Philipp Förmer

Constructor Summary

ExceptionPlaceholderResolver()

Method Summary

Set<String>	getResolveablePlaceholders() Returns a set of all placeholder procedures names that can be resolved by the placeholder.
StackTraceHelper	getStackTraceHelper()
String	resolve(String placeholderName, Object[] placeholderArguments, IEnvironment environment) Resolves the given placeholder under the passed interpreter environment.
void	setStackTraceHelper(StackTraceHelper stackTraceHelper) Sets the stack trace helper which will be used for stack trace operations.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionPlaceholderResolver

public ExceptionPlaceholderResolver()

Method Detail

getStackTraceHelper

public StackTraceHelper getStackTraceHelper()

Returns:

non null

Since:

0.0.2 (sasl-common-aspect-library)

See Also:

setStackTraceHelper(StackTraceHelper)

setStackTraceHelper

public void setStackTraceHelper(StackTraceHelper stackTraceHelper)
                         throws IllegalArgumentException

Sets the stack trace helper which will be used for stack trace operations. Should be normally only relevant for test cases.

Parameters:

stackTraceHelper - non null.

Throws:

IllegalArgumentException - if stackeTraceHelper is null.

Since:

0.0.2 (sasl-common-aspect-library)

getResolveablePlaceholders

public Set<String> getResolveablePlaceholders()

Description copied from interface: IPlaceholderResolver

Returns a set of all placeholder procedures names that can be resolved by the placeholder.

Specified by:

getResolveablePlaceholders in interface IPlaceholderResolver

Returns:

non null.

Since:

0.0.2 (sasl-common-aspect-library)

See Also:

IPlaceholderResolver.getResolveablePlaceholders()

resolve

public String resolve(String placeholderName,
                      Object[] placeholderArguments,
                      IEnvironment environment)
               throws ResolveException

Description copied from interface: IPlaceholderResolver

Resolves the given placeholder under the passed interpreter environment. The placeholderArguments are static defined (in a placeholder script) or dynamic created parameters (by other placeholder calls) that are passed to the placeholder as procedure arguments.
The resolve method is only invoked for placeholders that the resolver defines that he offers them (IPlaceholderResolver.getResolveablePlaceholders()).

Specified by:

resolve in interface IPlaceholderResolver

Parameters:

placeholderName - non null.

placeholderArguments - non null.

environment - non null

Returns:

null or non null.

Throws:

ResolveException - if the placeholder could not get resolved, for example because the parameters mismatch, or the resolution is only successful for a specific target method execution phase.

Since:

0.0.2 (sasl-common-aspect-library)

See Also:

IPlaceholderResolver.resolve(java.lang.String, java.lang.Object[], net.sf.sasl.language.placeholder.aop.interpreter.IEnvironment)