dWebSpec Dictionary
CONTEXT: descriptors->event




All Details Standard Only Platform Only
Structured Web info and helpTechnologies
 Home Page
 Product Page
 Download Page
 Feedback
Javascript Tree Menu

Results for:

 event 
Prev  Topic  Next

This captures all events that could originate from the page, including information on the handler objects that process these events on the server side.

It should first be noted that events involving client scripting like mouse over effects, are not captured by the event descriptors. These specifications are strictly in regard to page interactions with the server.

In short, the event descriptors capture specification on 1) all event triggers on the page, and 2) provide associations between them and their handlers on the server side.

One method of providing handlers to page events is through backing beans or code behind. In these cases, backing beans or code behind that contain these handlers, would be declared in the behavior-define descriptors, along with other objects exposed to the page. It is based one these defined objects that the method bindings used for event handling are specified in the event descriptor.

Another way to expose handler object for use on the page is by associating a URL path to the event handler. This URL path, with optional method designation, would then be specified as the handler for the event. These are rarely involving page event, but more related to action events. As such, they are referred to as action paths, and action handlers.

dWebSpec provides for both means of exposing handlers to the page.

 JSF  

Example event descriptors entries are shown in the table below.

EVENT DESCRIPTORS

id

event-source

parameters

handler

handler-class

security

call-type

1 forms[payment].elements[pay].action   {bb.ccPayment}   accounts,manager  

The correspondence between dWebSpec event descriptor attributes and the JSF component attributes is shown in the table below. As shown, some of the descriptor attributes correspond to component attributes, whereas some of these would result in the use of nested components. For more details, follow the link for the attributes.

Descriptor Attribute JSF Component Attribute Description
id The event descriptor id is used for specification identity only
event-source Event-source would point to an element, which would provide identity of element to associate event with
handler valueChangeListener These three JSF attributes could be populated by the handler entry, depending on the event and the entry type.
actionListener
action
handler-class Nested components The component tags f:actionListener and f:valueChangeListener could be nested in the body of a component, to register a handler class for an event.
parameters Nested componentsThe parameters specified would be associated with a component, using the f:parameter components.
security This specification captures security roles that could access the event. There is no explicit translation into JSF artifacts, however, there are coding patterns that could be used to effect the specification.
call-type:
immediate
immediate
call-type:
ajax
Specification of Ajax event would require substitution with Ajax aware version component, or Ajax extender nested components.
call-type:
auto-postback
Apart from action event, all other events do not lead to post-back. JSF does not provide means of specifying auto-postback for events. However, this could be simulated through client scripting.
Prev Next