oracle.dss.thin.beans
Class EventTargetImpl

java.lang.Object
  |
  +--oracle.dss.thin.beans.EventTargetImpl

All Implemented Interfaces:

EventTarget

public class EventTargetImpl

extends java.lang.Object

implements EventTarget

EventTargetImpl is an implementation of an EventTarget. EventTargets are used to define the following properties of certain ThinBeanUI events:

• destination URI, which can be used to change the servlet or JSP that the event is sent to.
• target frame, which can be used to specify the name of the HTML frame that the results of the event should be rendered into.
• ThinBean target, which can be used to change the name of the ThinBean that the event is delivered to. NOTE : The query parameter that identified the name of the ThinBean to deliver the event to is actually called "source" instead of "target".
• extra query parameters, which can be used to specify query parameter names and values that are event specific. This can be useful when application defined query parameters need to change for a specific event. Applications that need to specify the page to render within query parameters may find this feature very useful.

Constructor Summary

EventTargetImpl()
Constructs a new instance of an EventTargetImpl

EventTargetImpl(java.lang.String thinBeanTarget, java.util.Dictionary extraEventParameters)
Constructs a new instance of an EventTargetImpl

EventTargetImpl(java.lang.String destination, java.lang.String targetFrame, java.lang.String thinBeanTarget, java.util.Dictionary extraEventParameters)
Constructs a new instance of an EventTargetImpl

Method Summary

java.lang.String	getDestination() Retrieves the destination URI that the event is sent to.
java.util.Dictionary	getExtraEventParameters() Retrieves extra event parameters that should be added to the event.
java.lang.String	getTargetFrame() Retrieves the name of the HTML frame that the event is executed within.
java.lang.String	getThinBeanTarget() Retrieves the name of the ThinBeanUI instance that will handle this event.
void	setDestination(java.lang.String destination) Sets the destination URI that the event is sent to.
void	setExtraEventParameters(java.util.Dictionary extraEventParams) Sets extra event parameters that should be added to the event.
void	setTargetFrame(java.lang.String frameName) Sets the name of the HTML frame that the event is executed within.
void	setThinBeanTarget(java.lang.String thinBeanTarget) Sets the name of the ThinBeanUI instance that will handle this event.

Methods inherited from class java.lang.Object

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

Constructor Detail

EventTargetImpl

public EventTargetImpl()

Constructs a new instance of an EventTargetImpl

EventTargetImpl

public EventTargetImpl(java.lang.String thinBeanTarget,
                       java.util.Dictionary extraEventParameters)

Constructs a new instance of an EventTargetImpl

Parameters:

thinBeanTarget - the name ThinBeanUI instance that handles the event

extraEventParameters - a Dictionary of extra event parameters to add to the event

EventTargetImpl

public EventTargetImpl(java.lang.String destination,
                       java.lang.String targetFrame,
                       java.lang.String thinBeanTarget,
                       java.util.Dictionary extraEventParameters)

Constructs a new instance of an EventTargetImpl

Parameters:

destination - the destination URI for the event

targetFrame - the target frame that the event is executed in

thinBeanTarget - the name ThinBeanUI instance that handles the event

extraEventParameters - a Dictionary of extra event parameters to add to the event

Method Detail

setDestination

public void setDestination(java.lang.String destination)

Sets the destination URI that the event is sent to. If this property is null, then events are sent to either:

• the URI that was defined in the form that contains the ThinBeanUI instance.
• the URI for the current browser window, if a hyperlink is being generated

Parameters:

destination - the destination URI for the event

getDestination

public java.lang.String getDestination()

Retrieves the destination URI that the event is sent to. If this property is null, then events are sent to either:

• the URI that was defined in the form that contains the ThinBeanUI instance.
• the URI for the current browser window, if a hyperlink is being generated

Specified by:

getDestination in interface EventTarget

Returns:

the destination URI for the event

setTargetFrame

public void setTargetFrame(java.lang.String frameName)

Sets the name of the HTML frame that the event is executed within. If this property is null, then events are sent to the HTML frame that contains the rendered ThinBeanUI.

Parameters:

frameName - the target frame that the event is executed in

getTargetFrame

public java.lang.String getTargetFrame()

Retrieves the name of the HTML frame that the event is executed within. If this property is null, then events are sent to the HTML frame that contains the rendered ThinBeanUI.

Specified by:

getTargetFrame in interface EventTarget

Returns:

the target frame that the event is executed in

setThinBeanTarget

public void setThinBeanTarget(java.lang.String thinBeanTarget)

Sets the name of the ThinBeanUI instance that will handle this event. If this property is null, then events are sent to the same ThinBeanUI instance that rendered the event.

Parameters:

thinBeanTarget - the name ThinBeanUI instance that handles the event

getThinBeanTarget

public java.lang.String getThinBeanTarget()

Retrieves the name of the ThinBeanUI instance that will handle this event. If this property is null, then events are sent to the same ThinBeanUI instance that rendered the event.

Specified by:

getThinBeanTarget in interface EventTarget

Returns:

the name ThinBeanUI instance that handles the event

setExtraEventParameters

public void setExtraEventParameters(java.util.Dictionary extraEventParams)

Sets extra event parameters that should be added to the event. If this property is null, then no extra event parameters are added.

Parameters:

extraEventParams - a Dictionary of event parameters (query parameter name - query parameter value pairs)

getExtraEventParameters

public java.util.Dictionary getExtraEventParameters()

Retrieves extra event parameters that should be added to the event. If this property is null, then no extra event parameters are added.

Specified by:

getExtraEventParameters in interface EventTarget

Returns:

a Dictionary of event parameters (query parameter name - query parameter value pairs)