Skip navigation links

oracle.as.scheduler.substitution
Interface SubstitutionHandler

All Known Implementing Classes:

AppEnvSubstitutionHandler, EssEnvSubstitutionHandler, RequestContextSubstitutionHandler, RequestParamSubstitutionHandler, RequestSubstitutionHandler

public interface SubstitutionHandler

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

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, SubstitutorImpl

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)
                    throws SubstitutionException

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

Throws:

SubstitutionException - if an error occurs accessing the keys.

get

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

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.

Throws:

SubstitutionException - if an error occurs accessing the value.

close

void close()

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

Skip navigation links