diff --git a/reference/en/modules/basic_mapping.xml b/reference/en/modules/basic_mapping.xml index e24ca5f2d8..0c96fa5469 100644 --- a/reference/en/modules/basic_mapping.xml +++ b/reference/en/modules/basic_mapping.xml @@ -136,7 +136,7 @@ + ]]> @@ -1448,18 +1450,30 @@ property is dirty. + + + lazy (optional - defaults to false): Specifies + that this property should be fetched lazily when the instance variable is first + accessed (requires build-time bytecode instrumentation). + + - Setting a value of the cascade attribute to not - none will propagate certain operations to the - associated object (usually in a parent/child fashion). See - "Lifecycle Objects" discussed later. + Setting a value of the cascade attribute to any meaningful + value other than none will propagate certain operations to the + associated object. The meaningful values are the names of Hibernate's basic + operations, create, merge, delete, save-update, evict, replicate, lock, + refresh, as well as the special values delete-orphan + and all and comma-separated combinations of operation + names, for example, cascade="create,merge,evict" or + cascade="all,delete-orphan". See "Lifecycle Objects" for a full + explanation. - A typical many-to-one declaration looks as simple as + A typical many-to-one declaration looks as simple as this: ]]> @@ -1513,7 +1527,7 @@ + + ]]> @@ -2128,6 +2146,20 @@ legacy data.) + + + not-null (optional): Specifies that the foreign key columns + are not nullable (this is implied whenever the foreign key is also part of the + primary key). + + + + + update (optional): Specifies that the foreign key should never + be updated (this is implied whenever the foreign key is also part of the primary + key). + + @@ -2138,6 +2170,13 @@ DELETE statements. Be aware that this feature bypasses Hibernate's usual optimistic locking strategy for versioned data. + + + The not-null and update attributes are useful when + mapping a unidirectional one to many association. If you map a unidirectional one to many + to a non-nullable foreign key, you must declare the key column using + <key not-null="true">. + @@ -2520,7 +2559,7 @@ name="propertyName" id-type="idtypename" meta-type="metatypename" - cascade="none|all|save-update" + cascade="cascade_style" access="field|property|ClassName" optimistic-lock="true|false" >