This class listens for an error condition on a Region component when an error occurs retrieving remote content. The listener can then provide additional information to be sent to the user. <p/> In general the RemoteRegionErrorEvent is somewhat minimalistic in the types of events it returns. Although every Remote Region error will call this listener, only those events explicitly defined in
Type
will be explicitly defined. More event types may be added later.
IF a listener needs distinguish between different RemoteRegionErrorEvent types, it's suggested that you implement your listener in such a fashion that it will not break if other event types are added in the future. For instance: <p/>
switch(event.getType())
case HTTP_ERROR:
//do something
break;
case AUTHORIZATION_ERROR:
//do something
break;
default:
//all other cases
<p/> This way if another event type is added, your existing code still functions. Additionally, the String returned by this listener will be processed in the same way as a
af:outputFormattedText
component. As such, some minor formatting is allowed. Please refer to the documentation on
af:outputFormattedText
for more information. <p/> The listener which is used for the application should be defined in the web.xml in the following fashion:
<context-param>
<context-name>oracle.adf.view.rich.REMOTE_REGION_ERROR_LISTENER</context-name>
<context-value>myapp.MyRemoteRegionErrorListener</context-value>
</context-param>
<p/> The system makes no guarentees as to the longevity of this listener. It may be instantiated every remote region failure or it may span several requests. It is suggested that implementations of this listener interface remain thread-safe and stateless. Any state information required should be stored externally.