Documentation

Documentation Menu
Go Back

Configuration Model Listener Reference

Use model listeners in your own configurations to listen for events and execute code in response. Creating a model listener requires only three steps:

  • Implement the ConfigurationModelListener interface

  • Register the listener with the @Component annotation: service = ConfigurationModelListener.class

  • Add your custom logic for what happens when the listener is triggered

See an implementation of the listener in Liferay’s PasswordPoliciesConfigurationModelListener.

Note these things:

  • The configuration model listener will trigger and verify upon System, Instance, and Site Settings configuration changes

  • The configuration model listener will trigger when the server is already started and the configuration file is deployed as the listener will be registered at that time

  • The configuration model listener will NOT trigger for configuration files that are deployed to an instance before startup

See Creating a Model Listener to learn more about model listeners.

Not finding what you're looking for?

Pardon our dust as we revamp and transition our product documentation to this site. If something seems missing, please check Liferay Help Center documentation for Liferay DXP 7.2 and previous versions.

Try Liferay's Help Center