Skip to main content
summaryrefslogblamecommitdiffstats
blob: 80bc4813a54a6cd870f463f07bc09fc9c9b58744 (plain) (tree)
1
2
3
4
5
6
7
8
9
10



                                                                   
                                            
                                                  
                                                                        
                                  

                                                                   
                                                                                              
                                                        
                                          
                                                      
                                                   








                                                                                               
                            




                                                                                                                                                                                                                                                                                     



                                                                             



                              



                                                                                         

                              



                                                                                                                                                                                                                                                            

                              

                                                                       

                                                                     

                                                                                                                                                                                                       

                              



                                                                                                                                                                                                       

                              













                                                                                                                                                                                                                         
    

                                                                    
     

                                                                         


     

                                                                                                                                                                                                                                                                            

                              



                                                                                                                                                                                                                  

                              

                                                                                                                                       

                                                                  

                                                                                                        

                              

                                                                                                                                                                                                                        
    

                                              
     

                                              
     

                                                        



                                                                       

                                                                                                                                                  

                              

                                                                                                                                                                                                       
    
    

              
    




                                                                         

                                                        

                              


                                                                                                        
                                                                                                                                                                                                                                                                                  

                              

                                                                                                          
    

                                 
     
    

              
    

            
    

           





              

     

                                                                                                                                                                                                                                                                                   

                              



                                                                                                                                                                                      

                              

                                                                                                                                                                                                                        
    
    

                  
    

                  
    




                                                                      

                                                                                                                                                                                                                           

                              



                                                                                                                                                                                                                                                                    















                                                                                          
                                                                                                                                                                                                





                       
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<!-- Run date = January 22, 2008 9:11:23 -->
<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<title>General information</title>
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="Content-Script-Type" content="text/javascript" />
<meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 5.0" />
<meta name="date" content="2005-07-10T12:57:20+08:00" />
<meta name="robots" content="noarchive" />
<meta name="doctitle" content="General information" />
<meta name="relnum" content="M5 - Release 2.0.0" />
<meta name="partnum" content="" />
<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
<link rel="start" href="../../index.htm" title="Home" type="text/html" />
<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
</head>
<body>
<p><a id="CACBHFIJ" name="CACBHFIJ"></a></p>
<div class="sect3"><!-- infolevel="all" infotype="General" -->
<h1>General information</h1>
<p>This table lists the General properties available in the <span class="gui-object-title">Java Details view</span> for each mapping type.</p>
<div class="inftblruleinformal">
<table class="RuleInformal" title="This table describes the options on the Persistence Properties view." summary="This table describes the options on the Persistence Properties view." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
<thead>
<tr align="left" valign="top">
<th align="left" valign="bottom" id="r1c1-t7">Property</th>
<th align="left" valign="bottom" id="r1c2-t7">Description</th>
<th align="left" valign="bottom" id="r1c3-t7">Default</th>
<th align="left" valign="bottom" id="r1c4-t7">Available for Mapping Type</th>
</tr>
</thead>
<tbody>
<tr align="left" valign="top">
<td align="left" id="r2c1-t7" headers="r1c1-t7">Map As</td>
<td align="left" headers="r2c1-t7 r1c2-t7">Define the mapping type for the attribute</td>
<td align="left" headers="r2c1-t7 r1c3-t7">Basic</td>
<td align="left" headers="r2c1-t7 r1c4-t7">All mapping types</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r3c1-t7" headers="r1c1-t7"><a id="CACGCBHB" name="CACGCBHB"></a>Column</td>
<td align="left" headers="r3c1-t7 r1c2-t7"><a id="sthref201" name="sthref201"></a><a id="sthref202" name="sthref202"></a>The database column that contains the value for the attribute. This field corresponds to the <code>@Column</code> annotation.</td>
<td align="left" headers="r3c1-t7 r1c3-t7">By default, the Column is assumed to be named identically to the attribute.</td>
<td align="left" headers="r3c1-t7 r1c4-t7"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks008.htm#BABCBHDF">Embedded mapping</a>, <a href="tasks010.htm#BABGCBHG">ID mapping</a>, <a href="tasks016.htm#BABHIBII">Version mapping</a></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r4c1-t7" headers="r1c1-t7">&nbsp;&nbsp;Name</td>
<td align="left" headers="r4c1-t7 r1c2-t7">Name of the database column.
<p>This field corresponds to the <code>@Column</code> annotation.</p>
</td>
<td align="left" headers="r4c1-t7 r1c3-t7"><br /></td>
<td align="left" headers="r4c1-t7 r1c4-t7"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks008.htm#BABCBHDF">Embedded mapping</a>, <a href="tasks010.htm#BABGCBHG">ID mapping</a></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r5c1-t7" headers="r1c1-t7">&nbsp;&nbsp;Table</td>
<td align="left" headers="r5c1-t7 r1c2-t7">Name of the database table that contains the selected column.</td>
<td align="left" headers="r5c1-t7 r1c3-t7"><br /></td>
<td align="left" headers="r5c1-t7 r1c4-t7"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks008.htm#BABCBHDF">Embedded mapping</a>, <a href="tasks010.htm#BABGCBHG">ID mapping</a></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r6c1-t7" headers="r1c1-t7">&nbsp;&nbsp;Insertable</td>
<td align="left" headers="r6c1-t7 r1c2-t7">Specifies if the column is always included in <code>SQL INSERT</code> statements.</td>
<td align="left" headers="r6c1-t7 r1c3-t7">True</td>
<td align="left" headers="r6c1-t7 r1c4-t7"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks008.htm#BABCBHDF">Embedded mapping</a>, <a href="tasks010.htm#BABGCBHG">ID mapping</a></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r7c1-t7" headers="r1c1-t7">&nbsp;&nbsp;Updatable</td>
<td align="left" headers="r7c1-t7 r1c2-t7">Specifies if this column is always included in <code>SQL UPDATE</code> statements.</td>
<td align="left" headers="r7c1-t7 r1c3-t7">True</td>
<td align="left" headers="r7c1-t7 r1c4-t7"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks008.htm#BABCBHDF">Embedded mapping</a>, <a href="tasks010.htm#BABGCBHG">ID mapping</a></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r8c1-t7" headers="r1c1-t7"><a id="CACGGGHB" name="CACGGGHB"></a><a id="sthref203" name="sthref203"></a><a id="sthref204" name="sthref204"></a><a id="sthref205" name="sthref205"></a>Fetch Type</td>
<td align="left" headers="r8c1-t7 r1c2-t7">Defines how data is loaded from the database:
<ul>
<li>
<p>Eager &ndash; Data is loaded in before it is actually needed.</p>
</li>
<li>
<p>Lazy &ndash; Data is loaded only when required by the transaction.</p>
</li>
</ul>
</td>
<td align="left" headers="r8c1-t7 r1c3-t7">Eager</td>
<td align="left" headers="r8c1-t7 r1c4-t7"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks014.htm#BABFHBCJ">One-to-one mapping</a>, <a href="tasks011.htm#BABEIEGD">Many-to-many mapping</a>, <a href="tasks012.htm#BABHFAFJ">Many-to-one mapping</a></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r9c1-t7" headers="r1c1-t7">Optional</td>
<td align="left" headers="r9c1-t7 r1c2-t7">Specifies if this field is can be null.</td>
<td align="left" headers="r9c1-t7 r1c3-t7">Yes</td>
<td align="left" headers="r9c1-t7 r1c4-t7"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks014.htm#BABFHBCJ">One-to-one mapping</a>, <a href="tasks012.htm#BABHFAFJ">Many-to-one mapping</a></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r10c1-t7" headers="r1c1-t7"><a id="CACBBIBI" name="CACBBIBI"></a><a id="sthref206" name="sthref206"></a>Lob</td>
<td align="left" headers="r10c1-t7 r1c2-t7">Specify if the field is mapped to <code>java.sql.Clob</code> or <code>java.sql.Blob</code>.
<p>This field corresponds to the <code>@Lob</code> annotation.</p>
</td>
<td align="left" headers="r10c1-t7 r1c3-t7"><br /></td>
<td align="left" headers="r10c1-t7 r1c4-t7"><a href="tasks007.htm#BABBABCE">Basic mapping</a><br /></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r11c1-t7" headers="r1c1-t7"><a id="CACEAJGD" name="CACEAJGD"></a><a id="sthref207" name="sthref207"></a><a id="sthref208" name="sthref208"></a><a id="sthref209" name="sthref209"></a>Temporal</td>
<td align="left" headers="r11c1-t7 r1c2-t7">Specifies if this field is one of the following:
<ul>
<li>
<p>Date &ndash; <code>java.sql.Date</code></p>
</li>
<li>
<p>Time &ndash; <code>java.sql.Time</code></p>
</li>
<li>
<p>Timestamp &ndash; <code>java.sql.Timestamp</code></p>
</li>
</ul>
<p>This field corresponds to the <code>@Temporal</code> annotation.</p>
</td>
<td align="left" headers="r11c1-t7 r1c3-t7"><br /></td>
<td align="left" headers="r11c1-t7 r1c4-t7"><a href="tasks007.htm#BABBABCE">Basic mapping</a>, <a href="tasks010.htm#BABGCBHG">ID mapping</a></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r12c1-t7" headers="r1c1-t7"><a id="sthref210" name="sthref210"></a><a id="sthref211" name="sthref211"></a><a id="sthref212" name="sthref212"></a>Enumerated</td>
<td align="left" headers="r12c1-t7 r1c2-t7">Specify how to persist enumerated constraints if the <code>String</code> value suits your application requirements or to match an existing database schema.
<ul>
<li>
<p>ordinal</p>
</li>
<li>
<p><code>String</code></p>
</li>
</ul>
<p>This field corresponds to the <code>@Enumerated</code> annotation.</p>
</td>
<td align="left" headers="r12c1-t7 r1c3-t7">Ordinal</td>
<td align="left" headers="r12c1-t7 r1c4-t7"><br /></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r13c1-t7" headers="r1c1-t7">Target Entity</td>
<td align="left" headers="r13c1-t7 r1c2-t7">The persistent entity to which the attribute is mapped.</td>
<td align="left" headers="r13c1-t7 r1c3-t7"><br /></td>
<td align="left" headers="r13c1-t7 r1c4-t7"><a href="tasks014.htm#BABFHBCJ">One-to-one mapping</a>, <a href="tasks013.htm#BABHGEBD">One-to-many mapping</a> <a href="tasks011.htm#BABEIEGD">Many-to-many mapping</a>, <a href="tasks012.htm#BABHFAFJ">Many-to-one mapping</a></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r14c1-t7" headers="r1c1-t7"><a id="CACJAIHB" name="CACJAIHB"></a>Cascade Type</td>
<td align="left" headers="r14c1-t7 r1c2-t7">Specify which operations are propagated throughout the entity.
<ul>
<li>
<p>All &ndash; All operations</p>
</li>
<li>
<p>Persist</p>
</li>
<li>
<p>Merge</p>
</li>
<li>
<p>Move</p>
</li>
<li>
<p>Remove</p>
</li>
<li>
<p>Refresh</p>
</li>
</ul>
</td>
<td align="left" headers="r14c1-t7 r1c3-t7"><br /></td>
<td align="left" headers="r14c1-t7 r1c4-t7"><a href="tasks014.htm#BABFHBCJ">One-to-one mapping</a>, <a href="tasks013.htm#BABHGEBD">One-to-many mapping</a>, <a href="tasks011.htm#BABEIEGD">Many-to-many mapping</a>, <a href="tasks012.htm#BABHFAFJ">Many-to-one mapping</a></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r15c1-t7" headers="r1c1-t7"><a id="CACJDJJA" name="CACJDJJA"></a>Mapped By</td>
<td align="left" headers="r15c1-t7 r1c2-t7">The field in the database table that "owns" the relationship. This field is required only on the non-owning side of the relationship.</td>
<td align="left" headers="r15c1-t7 r1c3-t7"><br /></td>
<td align="left" headers="r15c1-t7 r1c4-t7"><a href="tasks014.htm#BABFHBCJ">One-to-one mapping</a>, <a href="tasks013.htm#BABHGEBD">One-to-many mapping</a></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r16c1-t7" headers="r1c1-t7"><a id="CACDADIH" name="CACDADIH"></a><a id="sthref213" name="sthref213"></a><a id="sthref214" name="sthref214"></a><a id="sthref215" name="sthref215"></a>Order By</td>
<td align="left" headers="r16c1-t7 r1c2-t7">Specify the default order for objects returned from a query:
<ul>
<li>
<p>No ordering</p>
</li>
<li>
<p>Primary key</p>
</li>
<li>
<p>Custom ordering</p>
</li>
</ul>
<p>This field corresponds to the <code>@OrderBy</code> annotation.</p>
</td>
<td align="left" headers="r16c1-t7 r1c3-t7">Primary key</td>
<td align="left" headers="r16c1-t7 r1c4-t7"><a href="tasks013.htm#BABHGEBD">One-to-many mapping</a>. <a href="tasks011.htm#BABEIEGD">Many-to-many mapping</a>, <a href="tasks012.htm#BABHFAFJ">Many-to-one mapping</a></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r17c1-t7" headers="r1c1-t7">Attribute Overrides</td>
<td align="left" headers="r17c1-t7 r1c2-t7">Overrides <span class="bold">Basic</span> mappings of a mapped superclass (for example, if the inherited column name is incompatible with a pre-existing data model, or invalid as a column name in your database).</td>
<td align="left" headers="r17c1-t7 r1c3-t7"><br /></td>
<td align="left" headers="r17c1-t7 r1c4-t7"><a href="tasks008.htm#BABCBHDF">Embedded mapping</a>
<p><a href="tasks008.htm#BABCBHDF">Embedded mapping</a></p>
<br /></td>
</tr>
</tbody>
</table>
<br /></div>
<!-- class="inftblruleinformal" -->
<p>&nbsp;</p>
<img src="img/ngrelt.png" alt="Related task" title="Related task" /><br />
<br />
<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></div>
<!-- class="sect3" -->
<!-- Start Footer -->
<div class="footer">
<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2008,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
</tr>
</table>
</div>
<!-- class="footer" -->
</body>
</html>

Back to the top