org.hibernate.event.service.internal.PostCommitEventListenerGroupImpl Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of hibernate-core Show documentation
Show all versions of hibernate-core Show documentation
Hibernate's core ORM functionality
/*
* Hibernate, Relational Persistence for Idiomatic Java
*
* License: GNU Lesser General Public License (LGPL), version 2.1 or later.
* See the lgpl.txt file in the root directory or .
*/
package org.hibernate.event.service.internal;
import org.hibernate.event.spi.EventType;
import org.hibernate.event.spi.PostCommitDeleteEventListener;
import org.hibernate.event.spi.PostCommitInsertEventListener;
import org.hibernate.event.spi.PostCommitUpdateEventListener;
import org.hibernate.internal.CoreLogging;
import org.hibernate.internal.CoreMessageLogger;
/**
* Historically, the listeners for the post-commit events simply reused the
* contracts from the non-post-commit variants. That has changed as part of
* the work for HHH-1582. The purpose of this specialized EventListenerGroup
* implementation is to recognize cases where post-commit event listeners
* are still using the legacy contracts and to issue "deprecation warnings".
*
* @author Steve Ebersole
*/
class PostCommitEventListenerGroupImpl extends EventListenerGroupImpl {
private static final CoreMessageLogger log = CoreLogging.messageLogger( PostCommitEventListenerGroupImpl.class );
private final Class extendedListenerContract;
public PostCommitEventListenerGroupImpl(EventType eventType, EventListenerRegistryImpl listenerRegistry) {
super( eventType, listenerRegistry );
if ( eventType == EventType.POST_COMMIT_DELETE ) {
this.extendedListenerContract = PostCommitDeleteEventListener.class;
}
else if ( eventType == EventType.POST_COMMIT_INSERT ) {
this.extendedListenerContract = PostCommitInsertEventListener.class;
}
else if ( eventType == EventType.POST_COMMIT_UPDATE ) {
this.extendedListenerContract = PostCommitUpdateEventListener.class;
}
else {
throw new IllegalStateException( "Unexpected usage of PostCommitEventListenerGroupImpl" );
}
}
@Override
public void appendListener(T listener) {
checkAgainstExtendedContract( listener );
super.appendListener( listener );
}
private void checkAgainstExtendedContract(T listener) {
if ( !extendedListenerContract.isInstance( listener ) ) {
log.warnf(
"Encountered event listener [%s] for post-commit event [%s] "
+ "which did not implement the corresponding extended "
+ "listener contract [%s]",
listener.getClass().getName(),
getEventType().eventName(),
extendedListenerContract.getName()
);
}
}
@Override
public void prependListener(T listener) {
checkAgainstExtendedContract( listener );
super.prependListener( listener );
}
}