Skip to content

Relation Components Overview

Erupt provides several relation components corresponding to different relationship types in JPA.

These components are relatively complex to use. It is recommended to familiarize yourself with JPA and understand one-to-one, one-to-many, and many-to-many relationships before using them.

Relation Type Reference

Component TypeJPA RelationshipUse CaseDocumentation
REFERENCE_TABLE@ManyToOneMany-to-one, select via table popupDetails
REFERENCE_TREE@ManyToOneMany-to-one, select via tree popupDetails
CHECKBOX@ManyToManyMany-to-many, checkbox formDetails
TAB_TREE@ManyToManyMany-to-many, tree selectionDetails
TAB_TABLE_REFER@ManyToManyMany-to-many, table selectionDetails
TAB_TABLE_ADD@OneToManyOne-to-many, inline child record creationDetails
COMBINE@OneToOneOne-to-one, inline creation, supports JSON storageDetails

Selection Guide

  • Many-to-one: Use REFERENCE_TABLE (list-style data) or REFERENCE_TREE (hierarchical data)
  • Many-to-many: Use CHECKBOX (few options), TAB_TREE (hierarchical), or TAB_TABLE_REFER (list-style)
  • One-to-many: Use TAB_TABLE_ADD to manage child table data directly within the parent record's edit dialog
  • One-to-one: Use COMBINE, which supports storing the associated object as JSON in the same column

Contributors

The avatar of contributor named as YuePeng YuePeng

Changelog

Released under the Apache-2.0 License.