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

Interface PageCreateEvent

  • All Superinterfaces:
    BaseChannelEvent, PageEvent<PageCreateContext>, RuntimeExceptionEvent
    public interface PageCreateEvent
extends PageEvent<PageCreateContext>

    PageCreateEvent 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 PageCreateEvent#setException(java.lang.RuntimeException). When a RuntimeException is set on this PageCreateEvent 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 PageCreateEvent object is that Guava EventBus always catches an exception thrown by a listener, even when injecting a custom SubscriberExceptionHandler

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