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 stage🚦CRUD InterceptionInject business logic around add, update, and delete via before* / after*✅Form ValidationValidate data before saving via validate, reject on failure🔍Query ConditionsbeforeFetch condition injection and default search values🎨Table DisplayCell coloring, row-button control, custom content injection➕Custom RowsAppend totals and summary rows via extraRow🫥Virtual FieldsDisplay and populate non-database fields via @Transient📝Form BehaviorsPre-process data when forms open via addBehavior / editBehavior📋Form ViewRender an Erupt class as a full-page form, ideal for settings pages📊Excel Import & ExportCustomize export files and validate imported data via excel*🖨️Print ProcessingCustomize the printed HTML output via print🧬Inherited ProxyReuse DataProxy capabilities through inheritance via @PreDataProxy🎯Global InterceptionPostDataProxy intercepts data operations globally, no per-class config

EruptDao Database Operations3

🧾EruptDao OverviewJPA-based data operations: CRUD and native SQL⛓️Chained QueriesStrongly-typed LambdaQuery: aggregation, pagination, associations🔀Multi-Datasource OperationsRun queries against a specific data source via getEntityManager

Data Sources & Persistence3

🗄️Multiple Data SourcesConfigure and use multiple databases🛢️Custom Data SourceManage non-database data with Erupt🗑️Soft DeleteReplace physical deletion with a deleted flag field

Login & Security3

🔑Login & AuthenticationCustom login logic, token validation, permission extension🚪Custom Login PageCaptcha login, WeChat QR login and other custom login flows🔓Open APIToken via appid + secret for external system calls

API & Integration3

🧭API Development & LogsCustom REST endpoints and operation-log recording🔗Existing Project IntegrationPlug Erupt into an existing Spring Boot project🖥️Frontend/Backend SeparationBuild and deploy the frontend independently, backend serves API only

UI & Interaction3

💬Frontend NotificationsTrigger frontend messages and dialogs from the backend📤Custom File UploadIntegrate OSS, local storage, or any custom upload backend🌐InternationalizationMultilingual support and custom translations

Development & Extension5

📡Event ListenersListen to internal framework events for decoupled extension🔥Hot BuildAnnotation changes apply on page refresh, no restart needed🔧Utility ClassesErupt's built-in utility classes🧬Extending Erupt AnnotationsBuild on the Erupt annotation system🧩Plugin DevelopmentBuild custom plugins on top of the framework

Contributors

YuePeng

Claude Opus 5 (1M context)

Changelog

Last edited 2 minutes ago

View full history

f3752b9-filter: add a role-based row-level data filtering example