oracle.as.scheduler.substitution
Interface SubstitutionHandler

All Known Subinterfaces:

ReqParamCtxtSubstitutionHandler

All Known Implementing Classes:

RequestContextSubstitutionHandler, RequestParamSubstitutionHandler

public interface SubstitutionHandler

Interface for handlers used by classes implementing Substitutor (e.g., AbstractSubstitutor).

Since:

release specific (what release of product did this appear in)

Version:

$Header: ess/src/oracle/as/scheduler/substitution/SubstitutionHandler.java /main/3 2008/07/15 12:10:43 cfuentes Exp $

Author:

cfuentes

See Also:

Substitutor, AbstractSubstitutor

Method Summary

void	close() Used to release any resources the handler may have claimed, such as open files or connections.
boolean	containsKey(java.lang.String name) Reports whether the handler can return a value to substitute for name.
java.lang.String	get(java.lang.String name) Returns the value which will be used to replace the token.
java.lang.String	getId() An identifier that can be used to request that a specific handler (or set of handlers) should be used for a substitution.

Method Detail

getId

java.lang.String getId()

An identifier that can be used to request that a specific handler (or set of handlers) should be used for a substitution.

The returned ID should adhere to basic identifier rules, e.g., it should consist of letters, numbers, and underscores only. A null, blank, or invalid ID may result in the handler being skipped.

The method getId() may be called at any time.

Returns:

Handler identifier

containsKey

boolean containsKey(java.lang.String name)

Reports whether the handler can return a value to substitute for name. If containsKey returns false, then this handler will not be used for substituting name.

Parameters:

name -

Returns:

Returns true if it can handle name, false otherwise

get

java.lang.String get(java.lang.String name)

Returns the value which will be used to replace the token. If name is not supported, then get() should return null. Conversely, if the handler returns true for containsKey(name), then get() should return a non-null String.

Parameters:

name - The key value for the substitution

Returns:

New value, may contain other substitution tokens.

close

void close()

Used to release any resources the handler may have claimed, such as open files or connections.