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

Interface PageCopyEvent

  • All Superinterfaces:
    BaseChannelEvent, PageEvent<PageCopyContext>, RuntimeExceptionEvent
    public interface PageCopyEvent
extends PageEvent<PageCopyContext>

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

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