Package org.hippoecm.hst.pagecomposer.jaxrs.api

Interface PageUpdateEvent

All Superinterfaces:
BaseChannelEvent, PageEvent<PageUpdateContext>, RuntimeExceptionEvent
public interface PageUpdateEvent extends PageEvent<PageUpdateContext>

PageUpdateEvent which will be put on the internal Guava event bus for synchronous events dispatching where listeners to this event can inject logic or short-circuit processing by setting a RuntimeException through PageUpdateEvent#setException(java.lang.RuntimeException). When a RuntimeException is set on this PageUpdateEvent by a listener, the org.hippoecm.hst.pagecomposer.jaxrs.services.AbstractConfigResource#publishSynchronousEvent will rethrow the exception. The reason that this has to be done via this PageUpdateEvent object is that Guava EventBus always catches an exception thrown by a listener, even when injecting a custom SubscriberExceptionHandler

Note that listeners for PageUpdateEvents must never invoke HstRequestContext#getSession()#save(). Changes in the JCR Session will always be persisted by the code that posted the PageUpdateEvent to the guava event bus