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.