JAVA實體對象 · Java 開源項目中文文檔

# JAVA實體對象 MyBatis Generator (MBG)根據數據庫表字段生成Java類. MBG生成的是簡單實體對象而非帶業務邏輯的實體對象(詳見[設計理念](../philosophy.html)介紹).MBG根據表特性和配置生成不同類型的實體對象. MBG生成字段和方法時包含JavaDoc標簽 `@mbggenerated`.運行Eclipse插件時,MBG會將每個Java對象中的JavaDoc標簽刪除或替換.其他地方不會發生變化. 在這種情況下,您在Java類中添加的字段和方法就不用擔心丟失--不包括包含了JavaDoc`@mbggenerated`標簽部分內容. 離開Eclipse插件，您需要手動合并Java文件,但是使用JavaDoc的`@mbggenerated`標簽用來了解刪除以前版本的文件是否安全. 以下描述生成不同的實體對象.MBG根據[<context>](../configreference/context.html)的`defaultModelType`屬性(支持conditional、flat、hierarchical三個值)和[<table>](../configreference/table.html)的`modelType`(此屬性用于覆蓋默認的defaultModelType)屬性配置生成不同的實體對象. 任何字段配置了[<ignoreColumn>](../configreference/ignoreColumn.html),自動生成時不會添加到Java對象中. 注意: 下面描述中"BLOB"指任何列的BLOB數據類型包括BLOB, CLOB, LONGVARCHAR, 和 LONGVARBINARY. ## 主鍵類主鍵類在表中包含一個主鍵的字段屬性. (MBG)根據表列明自動生成屬性名稱.自動生成的屬性名稱可以配置`<columnOverride>`屬性覆蓋. 類名默認情況是`?TableName?Key`,如果`<table>`配置了`domainObjectName`屬性那么類名是`?domainObjectName?Key`. 如果表中存在一個字段的主鍵將會生成hierarchical類型實體對象. 如果表中存在多列組合主鍵將會生成conditional類型實體對象.主鍵類是不會生成flat類型實體對象 model. ## 記錄類主鍵類在表中不包含主鍵、BLOB的字段屬性. 如果只有一個主鍵記錄類將繼承主鍵類. (MBG)根據表列明自動生成屬性名稱.自動生成的屬性名稱可以配置`<columnOverride>`屬性覆蓋. 類名默認情況是`?TableName?`,如果`<table>`配置了`domainObjectName`屬性那么類名是`?domainObjectName?`配置的值. 如果表中不存在組合主鍵、BLOB列將生成hierarchical類型實體對象.如果表中不存一個字段的主鍵、BLOB列或只有一個主鍵或者一個BLOB列將生成conditional類型實體對象.記錄類常常生成flat類型實體對象. ## BLOB記錄類 BLOB記錄類在表中包含BLOB字段屬性. 如果表中只存在一個字段該類將繼承基礎類, 或將繼承主鍵類(注意:MBG不支持表中只包含BLBO列). (MBG)根據表列明自動生成屬性名稱.自動生成的屬性名稱可以配置`<columnOverride>`屬性覆蓋. BLOB記錄類調用`selectByPrimaryKey`或`selectByExampleWithBLOBs`方法返回BLOB字段值. 類名默認情況是`?TableName?WithBLOBs`,如果`<table>`配置了`domainObjectName`屬性那么類名是`?domainObjectName?WithBLOBs`. 如果表中存在一個BLOB列將生成hierarchical類型實體對象. 如果表中存在多個BLOB列將生成conditional類型實體對象.BLOB記錄類是不會生成flat類型實體對象. ## Example類 Example類用來處理MBG動態查詢功能. Example類設置條件用于動態WHERE子句下列方法中: * `selectByExample` * `selectByExampleWithBLOBs` * `deleteByExample` * `countByExample` * `updateByExample` Example類不繼承任何實體對象. 類名默認情況是`?TableName?Example`,如果`<table>`配置了`domainObjectName`屬性那么類名是`?domainObjectName?Example`. 如果方法被啟動Example類將生成任何`*ByExample`方法.注意:如果表中有非常多的字段該類可能很大,但 DAO生成的XML是比較小的. 如果您不需要使用動態WHERE子句,您可以禁用生成這些方法. 詳見[Example類使用說明](exampleClassUsage.html)了解詳情.