Advanced β
This chapter covers Erupt's advanced usage and extension development, helping you tackle more complex business scenarios in real-world projects.
DataProxy13
DataProxy OverviewInject custom business logic at every CRUD stageCRUD InterceptionInject business logic around add, update, and delete via before* / after*Form ValidationValidate data before saving via validate, reject on failureQuery ConditionsbeforeFetch condition injection and default search valuesTable DisplayCell coloring, row-button control, custom content injectionCustom RowsAppend totals and summary rows via extraRowVirtual FieldsDisplay and populate non-database fields via @TransientForm BehaviorsPre-process data when forms open via addBehavior / editBehaviorForm ViewRender an Erupt class as a full-page form, ideal for settings pagesExcel Import & ExportCustomize export files and validate imported data via excel*Print ProcessingCustomize the printed HTML output via printInherited ProxyReuse DataProxy capabilities through inheritance via @PreDataProxyGlobal InterceptionPostDataProxy intercepts data operations globally, no per-class config
EruptDao Database Operations3
EruptDao OverviewJPA-based data operations: CRUD and native SQLChained QueriesStrongly-typed LambdaQuery: aggregation, pagination, associationsMulti-Datasource OperationsRun queries against a specific data source via getEntityManager
Data Sources & Storage4
Multiple Data SourcesConfigure and use multiple databasesCustom Data SourceManage non-database data with EruptSoft DeleteReplace physical deletion with a deleted flag fieldAttachment StorageStore attachments in S3 / OSS / MinIO or any custom AttachmentProxy
Authentication & Authorization3
Login & Authenticationerupt-sso single sign-on, LoginProxy, custom login page and issuing tokens yourselfAPI Auth & Operation LogsGuard custom REST endpoints by login / menu permission and record operation logsOpen APIToken via appid + secret so external systems can call without a login
Integration & Deployment2
Embedding External SystemsMount existing system pages under Erupt menus and share the login via tokenFrontend/Backend SeparationBuild and deploy the frontend independently, backend serves API only
Frontend Customization3
Messages & DialogsCall Erupt's message, modal and notification components from app.js or template pagesInternationalizationMultilingual support and custom translationsExtending Erupt AnnotationsPass custom annotation metadata to the frontend for your own renderers
Extension Development4
Event Listeners@EventListener hooks into internal framework events for decoupled extensionModule & Plugin DevelopmentImplement EruptModule to build reusable extension modulesUtility ClassesLogin user context, entity inheritance, JDBC helpers and other built-insHot BuildAnnotation changes apply on page refresh, no restart needed