BusinessObjectLifecycleHandler Class

Base class for external handlers that receive lifecycle callbacks for every structured-content operation performed by CMSToolEngine. The engine invokes these hooks alongside the target object's own BusinessObjectBase virtual methods, so a domain-level handler can observe or veto CRUD/publish actions across all tools and site settings in the domain.

Because the hooks take BusinessObjectBase, the handler sees both BusinessObject<T> entities and BusinessObjectSiteSetting<T> instances (both inherit BusinessObjectBase). Use pattern matching or reflection inside the handler to filter by concrete type if needed.

Every hook returns true to allow the operation and false to abort. Exceptions thrown from a hook are caught by the engine, logged, and treated as a false return on Pre hooks. Post hooks run after the database write has committed; a failure there does not roll back the operation.

public abstract class BusinessObjectLifecycleHandler