diff options
| author | Rick Sapir | 2012-09-19 17:40:04 +0000 |
|---|---|---|
| committer | Rick Sapir | 2012-09-19 17:40:04 +0000 |
| commit | fb70c890f6a9452cb9e8cb3dcf18ca27101b8dde (patch) | |
| tree | e432e45083cc86df82a78e38fd5b49d895d504b9 | |
| parent | b8216a510948c5450cddd673b9598e2847ff3e0c (diff) | |
| download | webtools.dali-fb70c890f6a9452cb9e8cb3dcf18ca27101b8dde.tar.gz webtools.dali-fb70c890f6a9452cb9e8cb3dcf18ca27101b8dde.tar.xz webtools.dali-fb70c890f6a9452cb9e8cb3dcf18ca27101b8dde.zip | |
updated doc. new jaxb doc
173 files changed, 7297 insertions, 6285 deletions
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/about.htm b/jpa/plugins/org.eclipse.jpt.doc.user/about.htm index d07445c03d..4626da6588 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/about.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/about.htm @@ -8,7 +8,7 @@ <title>About this content</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:45Z" /> +<meta name="date" content="2012-09-19T13:28:3Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="About this content" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<div class="sect1"><!-- infolevel="all" infotype="General" --><a id="sthref650" name="sthref650"></a> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<div class="sect1"><!-- infolevel="all" infotype="General" --><a id="sthref698" name="sthref698"></a> <h1>About this content</h1> <p>August, 2012</p> -<a id="sthref651" name="sthref651"></a> +<a id="sthref699" name="sthref699"></a> <p class="subhead2">License</p> <p>The Eclipse Foundation makes available all content in this plug-in ("Content"). Unless otherwise indicated below, the Content is provided to you under the terms and conditions of the Eclipse Public License Version 1.0 ("EPL"). A copy of the EPL is available at <code><a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></code>. For purposes of the EPL, "Program" will mean the Content.</p> <p>If you did not receive this Content directly from the Eclipse Foundation, the Content is being redistributed by another party ("Redistributor") and different terms and conditions may apply to your use of any object code in the Content. Check the Redistributor's license that was provided with the Content. If no such license exists, contact the Redistributor. Unless otherwise indicated below, the terms and conditions of the EPL still apply to any source code in the Content and such source code may be obtained at <code><a href="http://www.eclipse.org">http://www.eclipse.org</a></code>.</p> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/concept_mapping.htm b/jpa/plugins/org.eclipse.jpt.doc.user/concept_mapping.htm index 9d0dd9d343..fc0302f212 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/concept_mapping.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/concept_mapping.htm @@ -8,7 +8,7 @@ <title>Understanding OR mappings</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:37Z" /> +<meta name="date" content="2012-09-19T13:27:54Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Understanding OR mappings" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABBDJFI" name="BABBDJFI"></a></p> <div class="sect1"> <h1>Understanding OR mappings</h1> @@ -26,8 +26,12 @@ <p>You can use these mappings to map simple data types including primitives (such as <code>int</code>), JDK classes (such as <code>String</code>), and large object (LOB) values. You can also use them to transform object data members that reference other domain objects by way of association where data source representations require object identity maintenance (such as sequencing and back references) and possess various types of multiplicity and navigability. The appropriate mapping class is chosen primarily by the cardinality of the relationship.</p> <a id="sthref24" name="sthref24"></a> <p class="subhead2">Related tasks</p> -<br /> -<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></div> +<ul> +<li> +<p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> +</li> +</ul> +</div> <!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/concept_persistence.htm b/jpa/plugins/org.eclipse.jpt.doc.user/concept_persistence.htm index 0d0f63d0bb..58213bedca 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/concept_persistence.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/concept_persistence.htm @@ -8,7 +8,7 @@ <title>Understanding Java persistence</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:36Z" /> +<meta name="date" content="2012-09-19T13:27:54Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Understanding Java persistence" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABCAHIC" name="BABCAHIC"></a></p> <div class="sect1"> <h1>Understanding Java persistence</h1> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/concepts.htm b/jpa/plugins/org.eclipse.jpt.doc.user/concepts.htm index 26f981e398..f93e345703 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/concepts.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/concepts.htm @@ -8,7 +8,7 @@ <title>Concepts</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:36Z" /> +<meta name="date" content="2012-09-19T13:27:54Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Concepts" /> <meta name="relnum" content="Release 3.2" /> @@ -18,7 +18,7 @@ </head> <body> <p><a id="sthref19" name="sthref19"></a></p> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <h1>Concepts</h1> <p>This section contains an overview of concepts you should be familiar with when using Dali to create mappings for Java persistent entities.</p> <ul> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/concepts001.htm b/jpa/plugins/org.eclipse.jpt.doc.user/concepts001.htm index e6520d8c93..16045051b7 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/concepts001.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/concepts001.htm @@ -8,7 +8,7 @@ <title>Understanding Java Persistence API</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:37Z" /> +<meta name="date" content="2012-09-19T13:27:54Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Understanding Java Persistence API" /> <meta name="relnum" content="Release 3.2" /> @@ -17,17 +17,25 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABBGFJG" name="BABBGFJG"></a></p> <div class="sect1"> <h1>Understanding Java Persistence API</h1> <p><a id="sthref25" name="sthref25"></a>The Java Persistence API (JPA) part of the Java EE EJB 3.0 specification, simplifies Java persistence. It provides an object-relational mapping approach that lets you declaratively define how to map Java objects to relational database tables in a standard, portable way. JPA works both inside a Java EE application server and outside an EJB container in a Java Standard Edition (Java SE) application. An application written according to the JPA specification is scalable, transactional, and secure.</p> <a id="sthref26" name="sthref26"></a> <p class="subhead2">Related tasks</p> -<br /> -<a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a><a id="sthref27" name="sthref27"></a> +<ul> +<li> +<p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> +</li> +</ul> +<a id="sthref27" name="sthref27"></a> <p class="subhead2">Related concepts</p> +<ul> +<li> <p>Java Persistence Architecture 2.0 specification (<code><a href="http://jcp.org/en/jsr/detail?id=317">http://jcp.org/en/jsr/detail?id=317</a></code>)</p> +</li> +</ul> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/concepts002.htm b/jpa/plugins/org.eclipse.jpt.doc.user/concepts002.htm index d2e8e0c0eb..904d8c7ad4 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/concepts002.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/concepts002.htm @@ -8,7 +8,7 @@ <title>The persistence.xml file</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:37Z" /> +<meta name="date" content="2012-09-19T13:27:54Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="The persistence.xml file" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CHDHAGIH" name="CHDHAGIH"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1><a id="sthref28" name="sthref28"></a>The persistence.xml file</h1> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/concepts003.htm b/jpa/plugins/org.eclipse.jpt.doc.user/concepts003.htm index 5c76c673f5..920b466dca 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/concepts003.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/concepts003.htm @@ -8,7 +8,7 @@ <title>The orm.xml file</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:37Z" /> +<meta name="date" content="2012-09-19T13:27:54Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="The orm.xml file" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CHDBIJAC" name="CHDBIJAC"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1><a id="sthref31" name="sthref31"></a>The orm.xml file</h1> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/dcommon/css/blafdoc.css b/jpa/plugins/org.eclipse.jpt.doc.user/dcommon/css/blafdoc.css index ccecb96541..2f80e27062 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/dcommon/css/blafdoc.css +++ b/jpa/plugins/org.eclipse.jpt.doc.user/dcommon/css/blafdoc.css @@ -1,3 +1,7 @@ +/* +CSS for Dali Java Persistence Tools User Guide +*/ + @import url("../../../PRODUCT_PLUGIN/book.css"); @@ -5,13 +9,13 @@ span.control, span.gui-object-action, p.subhead2, span.bold, p.notep1 { font-weight: bold; } -span.name, p.titleinfigure, span.italic { +p.titleinexample, span.name, p.titleinfigure, span.italic { font-style: italic; } -p.titleinfigure {font-size:0.8em; font-weight:bold;} +p.titleinexample, p.titleinfigure {font-size:0.8em; font-weight:bold;} -p.titleinfigure, p.subhead2 { +p.titleinexample, p.titleinfigure, p.subhead2 { padding-top: 1em; } diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started.htm index 41e2daa933..c17022a576 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started.htm @@ -8,7 +8,7 @@ <title>Getting started</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:36Z" /> +<meta name="date" content="2012-09-19T13:27:53Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Getting started" /> <meta name="relnum" content="Release 3.2" /> @@ -18,7 +18,7 @@ </head> <body> <p><a id="sthref2" name="sthref2"></a></p> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <h1>Getting started</h1> <p>This section provides information on getting started with the Java Persistence Tools.</p> <ul> @@ -29,8 +29,7 @@ <p><a href="getting_started002.htm#BABIGCJA">Dali quick start</a></p> </li> </ul> -<p>For additional information, please visit the Dali home page at:</p> -<p><code><a href="http://www.eclipse.org/webtools/dali/">http://www.eclipse.org/webtools/dali/</a></code>.</p> +<p>For additional information, please visit the Dali home page at: <code><a href="http://www.eclipse.org/webtools/dali/">http://www.eclipse.org/webtools/dali/</a></code>.</p> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started001.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started001.htm index 1a5083f582..62e40772f6 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started001.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started001.htm @@ -8,7 +8,7 @@ <title>Requirements and installation</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:36Z" /> +<meta name="date" content="2012-09-19T13:27:53Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Requirements and installation" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABEFHCD" name="BABEFHCD"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1>Requirements and installation<a id="sthref3" name="sthref3"></a><a id="sthref4" name="sthref4"></a></h1> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started002.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started002.htm index 5ee28c73c4..6752246802 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started002.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started002.htm @@ -8,7 +8,7 @@ <title>Dali quick start</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:36Z" /> +<meta name="date" content="2012-09-19T13:27:53Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Dali quick start" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABIGCJA" name="BABIGCJA"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1>Dali quick start</h1> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started003.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started003.htm index 3d40f45c10..44e4625731 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started003.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started003.htm @@ -8,7 +8,7 @@ <title>Creating a new JPA project</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:36Z" /> +<meta name="date" content="2012-09-19T13:27:54Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Creating a new JPA project" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABDFHDA" name="BABDFHDA"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>Creating a new JPA project</h1> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started004.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started004.htm index a640c799b1..14c1bc4d15 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started004.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started004.htm @@ -8,7 +8,7 @@ <title>Creating a Java persistent entity with persistent fields</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:36Z" /> +<meta name="date" content="2012-09-19T13:27:54Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Creating a Java persistent entity with persistent fields" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABFGDDG" name="BABFGDDG"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>Creating a Java persistent entity with persistent fields</h1> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/new_jaxb_facet_task.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/new_jaxb_facet_task.png Binary files differnew file mode 100644 index 0000000000..08f5b02404 --- /dev/null +++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/new_jaxb_facet_task.png diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/new_jaxb_project_task.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/new_jaxb_project_task.png Binary files differnew file mode 100644 index 0000000000..d4cb295011 --- /dev/null +++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/new_jaxb_project_task.png diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/img/select_a_wizard_jaxb_project.png b/jpa/plugins/org.eclipse.jpt.doc.user/img/select_a_wizard_jaxb_project.png Binary files differnew file mode 100644 index 0000000000..56b5469c55 --- /dev/null +++ b/jpa/plugins/org.eclipse.jpt.doc.user/img/select_a_wizard_jaxb_project.png diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/index.xml b/jpa/plugins/org.eclipse.jpt.doc.user/index.xml index 19b6d75617..804d1b0619 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/index.xml +++ b/jpa/plugins/org.eclipse.jpt.doc.user/index.xml @@ -1,562 +1,624 @@ <?xml version='1.0' encoding='iso-8859-1'?> <index version="1.0"> <entry keyword="@Basic"> -<entry keyword="Basic mapping"><topic href="tasks010.htm#sthref172" /></entry> -<entry keyword="Basic Mapping"><topic href="reference025.htm#sthref474" /></entry> +<entry keyword="Basic mapping"><topic href="tasks011.htm#sthref185" /></entry> +<entry keyword="Basic Mapping"><topic href="reference029.htm#sthref501" /></entry> </entry> <entry keyword="@Column"> -<entry keyword="Basic Mapping"><topic href="reference025.htm#sthref476" /></entry> -<entry keyword="ID Mapping"><topic href="reference029.htm#sthref486" /></entry> -<entry keyword="Version Mapping"><topic href="reference034.htm#sthref503" /></entry> - </entry> -<entry keyword="@DiscriminatorColumn, Inheritance"><topic href="reference018.htm#sthref425" /></entry> -<entry keyword="@DiscriminatorValue, Inheritance"><topic href="reference018.htm#sthref423" /></entry> -<entry keyword="@Embeddable, Embeddable"><topic href="tasks003.htm#sthref82" /></entry> -<entry keyword="@Embedded, Embedded mapping"><topic href="tasks012.htm#sthref187" /></entry> -<entry keyword="@EmbeddedId, Embedded ID mapping"><topic href="tasks013.htm#sthref195" /></entry> -<entry keyword="@Entity, Entity"><topic href="tasks002.htm#sthref74" /></entry> -<entry keyword="@Enumerated, Type information"><topic href="reference035.htm#sthref511" /></entry> -<entry keyword="@GeneratedValue, Primary Key Generation information"><topic href="ref_primary_key.htm#sthref525" /></entry> +<entry keyword="Basic Mapping"><topic href="reference029.htm#sthref503" /></entry> +<entry keyword="ID Mapping"><topic href="reference033.htm#sthref513" /></entry> +<entry keyword="Version Mapping"><topic href="reference038.htm#sthref530" /></entry> + </entry> +<entry keyword="@DiscriminatorColumn, Inheritance"><topic href="reference022.htm#sthref450" /></entry> +<entry keyword="@DiscriminatorValue, Inheritance"><topic href="reference022.htm#sthref448" /></entry> +<entry keyword="@Embeddable, Embeddable"><topic href="tasks004.htm#sthref94" /></entry> +<entry keyword="@Embedded, Embedded mapping"><topic href="tasks013.htm#sthref200" /></entry> +<entry keyword="@EmbeddedId, Embedded ID mapping"><topic href="tasks014.htm#sthref208" /></entry> +<entry keyword="@Entity, Entity"><topic href="tasks003.htm#sthref86" /></entry> +<entry keyword="@Enumerated, Type information"><topic href="reference039.htm#sthref538" /></entry> +<entry keyword="@GeneratedValue, Primary Key Generation information"><topic href="ref_primary_key.htm#sthref552" /></entry> <entry keyword="@Id"> -<entry keyword="ID mapping"><topic href="tasks014.htm#sthref203" /></entry> -<entry keyword="ID Mapping"><topic href="reference029.htm#sthref484" /></entry> +<entry keyword="ID mapping"><topic href="tasks015.htm#sthref216" /></entry> +<entry keyword="ID Mapping"><topic href="reference033.htm#sthref511" /></entry> </entry> -<entry keyword="@Inheritance, Specifying entity inheritance"><topic href="task_inheritance.htm#sthref147" /></entry> -<entry keyword="@JoinColumn, Joining Strategy"><topic href="reference039.htm#sthref521" /></entry> -<entry keyword="@Lob, Type information"><topic href="reference035.htm#sthref506" /></entry> +<entry keyword="@Inheritance, Specifying entity inheritance"><topic href="task_inheritance.htm#sthref159" /></entry> +<entry keyword="@JoinColumn, Joining Strategy"><topic href="reference043.htm#sthref548" /></entry> +<entry keyword="@Lob, Type information"><topic href="reference039.htm#sthref533" /></entry> <entry keyword="@ManyToMany"> -<entry keyword="Many-to-many mapping"><topic href="tasks015.htm#sthref212" /></entry> -<entry keyword="Many-to-Many Mapping"><topic href="reference030.htm#sthref489" /></entry> +<entry keyword="Many-to-many mapping"><topic href="tasks016.htm#sthref225" /></entry> +<entry keyword="Many-to-Many Mapping"><topic href="reference034.htm#sthref516" /></entry> </entry> <entry keyword="@ManyToOne"> -<entry keyword="Many-to-one mapping"><topic href="tasks016.htm#sthref222" /></entry> -<entry keyword="Many-to-One Mapping"><topic href="reference031.htm#sthref492" /></entry> +<entry keyword="Many-to-one mapping"><topic href="tasks017.htm#sthref235" /></entry> +<entry keyword="Many-to-One Mapping"><topic href="reference035.htm#sthref519" /></entry> </entry> -<entry keyword="@MappedSuperclass, Mapped superclass"><topic href="tasks004.htm#sthref90" /></entry> -<entry keyword="@NamedQuery, Creating queries"><topic href="tasks009.htm#sthref159" /></entry> -<entry keyword="@ObjectTypeConverter, Converters"><topic href="reference023.htm#sthref450" /></entry> +<entry keyword="@MappedSuperclass, Mapped superclass"><topic href="tasks005.htm#sthref102" /></entry> +<entry keyword="@NamedQuery, Creating queries"><topic href="tasks010.htm#sthref171" /></entry> +<entry keyword="@ObjectTypeConverter, Converters"><topic href="reference027.htm#sthref475" /></entry> <entry keyword="@OneToMany"> -<entry keyword="One-to-many mapping"><topic href="tasks017.htm#sthref229" /></entry> -<entry keyword="One-to-Many Mapping"><topic href="reference032.htm#sthref495" /></entry> +<entry keyword="One-to-many mapping"><topic href="tasks018.htm#sthref242" /></entry> +<entry keyword="One-to-Many Mapping"><topic href="reference036.htm#sthref522" /></entry> </entry> <entry keyword="@OneToOne"> -<entry keyword="One-to-one mapping"><topic href="tasks018.htm#sthref237" /></entry> -<entry keyword="One-to-One Mapping"><topic href="reference033.htm#sthref498" /></entry> +<entry keyword="One-to-one mapping"><topic href="tasks019.htm#sthref250" /></entry> +<entry keyword="One-to-One Mapping"><topic href="reference037.htm#sthref525" /></entry> </entry> -<entry keyword="@OrderBy, Ordering"><topic href="reference038.htm#sthref516" /></entry> -<entry keyword="@SecondaryTable, Specifying additional tables"><topic href="task_additonal_tables.htm#sthref142" /></entry> +<entry keyword="@OrderBy, Ordering"><topic href="reference042.htm#sthref543" /></entry> +<entry keyword="@SecondaryTable, Specifying additional tables"><topic href="task_additonal_tables.htm#sthref154" /></entry> <entry keyword="@SequenceGenerator"> -<entry keyword="Primary Key Generation"><topic href="reference021.htm#sthref438" /></entry> -<entry keyword="Primary Key Generation"><topic href="reference021.htm#sthref440" /></entry> -<entry keyword="Primary Key Generation information"><topic href="ref_primary_key.htm#sthref527" /></entry> +<entry keyword="Primary Key Generation"><topic href="reference025.htm#sthref463" /></entry> +<entry keyword="Primary Key Generation"><topic href="reference025.htm#sthref465" /></entry> +<entry keyword="Primary Key Generation information"><topic href="ref_primary_key.htm#sthref554" /></entry> </entry> -<entry keyword="@StructConverter, Converters"><topic href="reference023.htm#sthref452" /></entry> +<entry keyword="@StructConverter, Converters"><topic href="reference027.htm#sthref477" /></entry> <entry keyword="@Temporal"> -<entry keyword="Type information"><topic href="reference035.htm#sthref508" /></entry> -<entry keyword="Type information"><topic href="reference035.htm#sthref509" /></entry> +<entry keyword="Type information"><topic href="reference039.htm#sthref535" /></entry> +<entry keyword="Type information"><topic href="reference039.htm#sthref536" /></entry> </entry> -<entry keyword="@Transient, Transient mapping"><topic href="tasks019.htm#sthref245" /></entry> -<entry keyword="@TypeConverter, Converters"><topic href="reference023.htm#sthref451" /></entry> +<entry keyword="@Transient, Transient mapping"><topic href="tasks020.htm#sthref258" /></entry> +<entry keyword="@TypeConverter, Converters"><topic href="reference027.htm#sthref476" /></entry> <entry keyword="@Version"> -<entry keyword="Version mapping"><topic href="tasks020.htm#sthref252" /></entry> -<entry keyword="Version Mapping"><topic href="reference034.htm#sthref501" /></entry> - </entry> -<entry keyword="@XMLPath, Tips and tricks"><topic href="tips_and_tricks.htm#sthref647" /></entry> -<entry keyword="Add Converter dialog, Add Converter dialog"><topic href="ref_add_converter.htm#sthref622" /></entry> -<entry keyword="Add Join Column dialog, Add Join Column dialog"><topic href="reference062.htm#sthref614" /></entry> -<entry keyword="Add Primary Key Join Column dialog, Add Primary Key Join Column dialog"><topic href="reference067.htm#sthref632" /></entry> -<entry keyword="Add Query dialog, Add Query dialog"><topic href="reference066.htm#sthref630" /></entry> -<entry keyword="Advanced - in Java Details view, Advanced"><topic href="reference024.htm#sthref457" /></entry> -<entry keyword="architecture of Dali feature, Dali Developer Documentation"><topic href="reference071.htm#sthref642" /></entry> -<entry keyword="association tables, Create New Association wizard"><topic href="ref_create_new_association_wizard.htm#sthref389" /></entry> -<entry keyword="Attribute Overrides - in Java Details view, Attribute Overrides"><topic href="reference019.htm#sthref431" /></entry> +<entry keyword="Version mapping"><topic href="tasks021.htm#sthref265" /></entry> +<entry keyword="Version Mapping"><topic href="reference038.htm#sthref528" /></entry> + </entry> +<entry keyword="@XMLPath, Tips and tricks"><topic href="tips_and_tricks.htm#sthref695" /></entry> +<entry keyword="about, JPA Details view (for attributes)"><topic href="ref_persistence_map_view.htm#sthref496" /></entry> +<entry keyword="Add Converter dialog, Add Converter dialog"><topic href="ref_add_converter.htm#sthref662" /></entry> +<entry keyword="Add Join Column dialog, Add Join Column dialog"><topic href="reference068.htm#sthref654" /></entry> +<entry keyword="Add Primary Key Join Column dialog, Add Primary Key Join Column dialog"><topic href="reference073.htm#sthref672" /></entry> +<entry keyword="Add Query dialog, Add Query dialog"><topic href="reference072.htm#sthref670" /></entry> +<entry keyword="Add Schema Location dialog, Add Schema Location dialog"><topic href="reference074.htm#sthref675" /></entry> +<entry keyword="Advanced - in Java Details view, Advanced"><topic href="reference028.htm#sthref482" /></entry> +<entry keyword="architecture of Dali feature, Dali Developer Documentation"><topic href="reference079.htm#sthref690" /></entry> +<entry keyword="association tables, Create New Association wizard"><topic href="ref_create_new_association_wizard.htm#sthref414" /></entry> +<entry keyword="Attribute Overrides - in Java Details view, Attribute Overrides"><topic href="reference023.htm#sthref456" /></entry> <entry keyword="attributes"> -<entry keyword="JPA Details view, JPA Details view (for attributes)"><topic href="ref_persistence_map_view.htm#sthref469" /></entry> +<entry keyword="JPA Details view, JPA Details view (for attributes)"><topic href="ref_persistence_map_view.htm#sthref494" /></entry> <entry keyword="mapping, Understanding OR mappings"><topic href="concept_mapping.htm#sthref22" /></entry> -<entry keyword="overrides, Attribute Overrides"><topic href="reference019.htm#sthref429" /></entry> -<entry keyword="virtual, Adding virtual attributes"><topic href="tasks005.htm#sthref96" /></entry> +<entry keyword="overrides, Attribute Overrides"><topic href="reference023.htm#sthref454" /></entry> +<entry keyword="virtual, Adding virtual attributes"><topic href="tasks006.htm#sthref108" /></entry> </entry> <entry keyword="basic mapping"> -<entry keyword="@Basic, Basic mapping"><topic href="tasks010.htm#sthref173" /></entry> +<entry keyword="@Basic, Basic mapping"><topic href="tasks011.htm#sthref186" /></entry> <entry keyword="about"> -<entry keyword="Basic mapping"><topic href="tasks010.htm#sthref171" /></entry> -<entry keyword="Basic Mapping"><topic href="reference025.htm#sthref475" /></entry> +<entry keyword="Basic mapping"><topic href="tasks011.htm#sthref184" /></entry> +<entry keyword="Basic Mapping"><topic href="reference029.htm#sthref502" /></entry> </entry> <entry keyword="(See also mappings)"></entry> </entry> -<entry keyword="batch writing - persistence unit, Connection"><topic href="reference046.htm#sthref565" /></entry> +<entry keyword="batch writing - persistence unit, Connection"><topic href="reference050.htm#sthref592" /></entry> <entry keyword="caching"> -<entry keyword="Caching"><topic href="reference016.htm#sthref414" /></entry> -<entry keyword="Caching"><topic href="reference048.htm#sthref569" /></entry> +<entry keyword="Caching"><topic href="reference020.htm#sthref439" /></entry> +<entry keyword="Caching"><topic href="reference052.htm#sthref596" /></entry> </entry> -<entry keyword="Caching - in persistence.xml editor, Caching"><topic href="reference048.htm#sthref570" /></entry> -<entry keyword="canonical metamodel, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref601" /></entry> -<entry keyword="cardinality - association tables, Association Cardinality"><topic href="ref_association_cardinality.htm#sthref397" /></entry> -<entry keyword="change tracking, Advanced"><topic href="reference024.htm#sthref462" /></entry> +<entry keyword="Caching - in persistence.xml editor, Caching"><topic href="reference052.htm#sthref597" /></entry> +<entry keyword="canonical metamodel, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref628" /></entry> +<entry keyword="cardinality - association tables, Association Cardinality"><topic href="ref_association_cardinality.htm#sthref422" /></entry> +<entry keyword="change tracking, Advanced"><topic href="reference028.htm#sthref487" /></entry> <entry keyword="classes"> -<entry keyword="adding persistence to, Adding persistence to a class"><topic href="task_add_persistence.htm#sthref66" /></entry> -<entry keyword="embeddable, Embeddable"><topic href="tasks003.htm#sthref81" /></entry> -<entry keyword="entity, Entity"><topic href="tasks002.htm#sthref72" /></entry> -<entry keyword="managed, General"><topic href="ref_persistence_general.htm#sthref561" /></entry> -<entry keyword="managing persistent classes, JPA Facet page"><topic href="ref_jpa_facet.htm#sthref378" /></entry> -<entry keyword="mapped superclass, Mapped superclass"><topic href="tasks004.htm#sthref88" /></entry> -<entry keyword="properties, Properties"><topic href="reference052.htm#sthref582" /></entry> -<entry keyword="synchronizing, Synchronizing classes"><topic href="tasks006.htm#sthref115" /></entry> - </entry> -<entry keyword="collection mappings, Element collection mapping"><topic href="tasks011.htm#sthref180" /></entry> +<entry keyword="adding persistence to, Adding persistence to a class"><topic href="task_add_persistence.htm#sthref78" /></entry> +<entry keyword="embeddable, Embeddable"><topic href="tasks004.htm#sthref93" /></entry> +<entry keyword="entity, Entity"><topic href="tasks003.htm#sthref84" /></entry> +<entry keyword="managed, General"><topic href="ref_persistence_general.htm#sthref588" /></entry> +<entry keyword="managing persistent classes, JPA Facet page"><topic href="ref_jpa_facet.htm#sthref391" /></entry> +<entry keyword="mapped superclass, Mapped superclass"><topic href="tasks005.htm#sthref100" /></entry> +<entry keyword="properties, Properties"><topic href="reference056.htm#sthref609" /></entry> +<entry keyword="synchronizing, Synchronizing classes"><topic href="tasks007.htm#sthref127" /></entry> + </entry> +<entry keyword="collection mappings, Element collection mapping"><topic href="tasks012.htm#sthref193" /></entry> <entry keyword="columns"> -<entry keyword="discriminator, Inheritance"><topic href="reference018.htm#sthref426" /></entry> -<entry keyword="join, Joining Strategy"><topic href="reference039.htm#sthref520" /></entry> +<entry keyword="discriminator, Inheritance"><topic href="reference022.htm#sthref451" /></entry> +<entry keyword="join, Joining Strategy"><topic href="reference043.htm#sthref547" /></entry> <entry keyword="mapping to"> -<entry keyword="Basic Mapping"><topic href="reference025.htm#sthref477" /></entry> -<entry keyword="ID Mapping"><topic href="reference029.htm#sthref487" /></entry> -<entry keyword="Version Mapping"><topic href="reference034.htm#sthref504" /></entry> +<entry keyword="Basic Mapping"><topic href="reference029.htm#sthref504" /></entry> +<entry keyword="ID Mapping"><topic href="reference033.htm#sthref514" /></entry> +<entry keyword="Version Mapping"><topic href="reference038.htm#sthref531" /></entry> </entry> -<entry keyword="value, Inheritance"><topic href="reference018.htm#sthref424" /></entry> +<entry keyword="value, Inheritance"><topic href="reference022.htm#sthref449" /></entry> </entry> -<entry keyword="connection pool, The persistence.xml Editor"><topic href="task_manage_persistence.htm#sthref101" /></entry> -<entry keyword="Connection - in persistence.xml Editor, Connection"><topic href="reference046.htm#sthref563" /></entry> -<entry keyword="connections - database, Tips and tricks"><topic href="tips_and_tricks.htm#sthref644" /></entry> -<entry keyword="converters, Converters"><topic href="reference037.htm#sthref513" /></entry> +<entry keyword="connection pool, The persistence.xml Editor"><topic href="task_manage_persistence.htm#sthref113" /></entry> +<entry keyword="Connection - in persistence.xml Editor, Connection"><topic href="reference050.htm#sthref590" /></entry> +<entry keyword="connections - database, Tips and tricks"><topic href="tips_and_tricks.htm#sthref692" /></entry> +<entry keyword="converters, Converters"><topic href="reference041.htm#sthref540" /></entry> <entry keyword="Converters - in JPA Details view"> -<entry keyword="Converters"><topic href="reference023.htm#sthref449" /></entry> -<entry keyword="Converters"><topic href="reference037.htm#sthref512" /></entry> -<entry keyword="Converters"><topic href="reference045.htm#sthref552" /></entry> +<entry keyword="Converters"><topic href="reference027.htm#sthref474" /></entry> +<entry keyword="Converters"><topic href="reference041.htm#sthref539" /></entry> +<entry keyword="Converters"><topic href="reference049.htm#sthref579" /></entry> </entry> <entry keyword="converting"> -<entry keyword="Java project to JPA, Converting a Java project to a JPA project"><topic href="tasks001.htm#sthref47" /></entry> -<entry keyword="JPA metadata to XML, Converting JPA metadata to XML"><topic href="tasks028.htm#sthref317" /></entry> - </entry> -<entry keyword="Create a JPA Project Wizard, Creating a new JPA project"><topic href="task_create_new_project.htm#sthref37" /></entry> -<entry keyword="Create JPA Entity wizard, Create JPA Entity wizard"><topic href="ref_create_jpa_entity_wizard.htm#sthref354" /></entry> -<entry keyword="Create New Association wizard, Create New Association wizard"><topic href="ref_create_new_association_wizard.htm#sthref391" /></entry> -<entry keyword="Create New JPA Project wizard, Create New JPA Project wizard"><topic href="ref_new_jpa_project_wizard.htm#sthref369" /></entry> -<entry keyword="Create ORM Mapping File wizard, Create ORM Mapping File wizard"><topic href="reference007.htm#sthref362" /></entry> -<entry keyword="Customization - in persistence.xml editor, Customization"><topic href="reference047.htm#sthref567" /></entry> -<entry keyword="customizer class - for entities, Advanced"><topic href="reference024.htm#sthref460" /></entry> -<entry keyword="database tables - generating entities from, Generating entities from tables"><topic href="tasks021.htm#sthref261" /></entry> +<entry keyword="Java project to JPA, Converting a Java project to a JPA project"><topic href="tasks002.htm#sthref59" /></entry> +<entry keyword="JPA metadata to XML, Converting JPA metadata to XML"><topic href="tasks029.htm#sthref330" /></entry> + </entry> + <entry keyword="Create a JPA Project Wizard"> +<entry keyword="Creating a new JPA project"><topic href="task_create_new_project.htm#sthref37" /></entry> +<entry keyword="Creating a new JAXB project"><topic href="tasks001.htm#sthref48" /></entry> + </entry> +<entry keyword="Create JPA Entity wizard, Create JPA Entity wizard"><topic href="ref_create_jpa_entity_wizard.htm#sthref367" /></entry> +<entry keyword="Create New Association wizard, Create New Association wizard"><topic href="ref_create_new_association_wizard.htm#sthref416" /></entry> +<entry keyword="Create New JAXB Project wizard, Create New JAXB Project wizard"><topic href="reference010.htm#sthref395" /></entry> +<entry keyword="Create New JPA Project wizard, Create New JPA Project wizard"><topic href="ref_new_jpa_project_wizard.htm#sthref382" /></entry> +<entry keyword="Create ORM Mapping File wizard, Create ORM Mapping File wizard"><topic href="reference007.htm#sthref375" /></entry> +<entry keyword="Customization - in persistence.xml editor, Customization"><topic href="reference051.htm#sthref594" /></entry> +<entry keyword="customizer class - for entities, Advanced"><topic href="reference028.htm#sthref485" /></entry> +<entry keyword="database tables - generating entities from, Generating entities from tables"><topic href="tasks022.htm#sthref274" /></entry> <entry keyword="database - persistence"> -<entry keyword="connection, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref596" /></entry> -<entry keyword="schema, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref598" /></entry> - </entry> -<entry keyword="DDL script - generating, Generating tables from entities"><topic href="tasks022.htm#sthref271" /></entry> -<entry keyword="DDL - generating, Generate Tables from Entities wizard"><topic href="reference010.htm#sthref385" /></entry> -<entry keyword="Derived Identity - in JPA Details view, Derived Identity"><topic href="reference040.htm#sthref523" /></entry> -<entry keyword="developer documentation - Dali, Dali Developer Documentation"><topic href="reference071.htm#sthref641" /></entry> -<entry keyword="dynamic entities - from tables, Generating dynamic entities from tables"><topic href="tasks023.htm#sthref277" /></entry> -<entry keyword="eager fetch, Basic Mapping"><topic href="reference025.htm#sthref479" /></entry> -<entry keyword="EclipseLink XML mapping file, General"><topic href="ref_persistence_general.htm#sthref562" /></entry> -<entry keyword="eclipselink-orm.xml file - with dynamic entities, Sample eclipselink-orm.xml File with Dynamic Entities"><topic href="tasks023.htm#sthref283" /></entry> -<entry keyword="Edit Join Columns dialog, Edit Join Columns Dialog"><topic href="reference061.htm#sthref612" /></entry> + <entry keyword="connection"> +<entry keyword="Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref623" /></entry> +<entry keyword="Project Properties page - JAXB Options"><topic href="reference064.htm#sthref644" /></entry> + </entry> +<entry keyword="schema, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref625" /></entry> + </entry> +<entry keyword="DDL script - generating, Generating tables from entities"><topic href="tasks023.htm#sthref284" /></entry> +<entry keyword="DDL - generating, Generate Tables from Entities wizard"><topic href="reference014.htm#sthref410" /></entry> +<entry keyword="Derived Identity - in JPA Details view, Derived Identity"><topic href="reference044.htm#sthref550" /></entry> +<entry keyword="developer documentation - Dali, Dali Developer Documentation"><topic href="reference079.htm#sthref689" /></entry> +<entry keyword="dynamic entities - from tables, Generating dynamic entities from tables"><topic href="tasks024.htm#sthref290" /></entry> +<entry keyword="eager fetch, Basic Mapping"><topic href="reference029.htm#sthref506" /></entry> +<entry keyword="EclipseLink XML mapping file, General"><topic href="ref_persistence_general.htm#sthref589" /></entry> +<entry keyword="eclipselink-orm.xml file - with dynamic entities, Sample eclipselink-orm.xml File with Dynamic Entities"><topic href="tasks024.htm#sthref296" /></entry> +<entry keyword="Edit Join Columns dialog, Edit Join Columns Dialog"><topic href="reference067.htm#sthref652" /></entry> <entry keyword="element collection mapping"> -<entry keyword="about, Element Collection Mapping"><topic href="reference026.htm#sthref482" /></entry> -<entry keyword="creating, Element collection mapping"><topic href="tasks011.htm#sthref179" /></entry> +<entry keyword="about, Element Collection Mapping"><topic href="reference030.htm#sthref509" /></entry> +<entry keyword="creating, Element collection mapping"><topic href="tasks012.htm#sthref192" /></entry> </entry> <entry keyword="embeddable class"> -<entry keyword="@Embeddable, Embeddable"><topic href="tasks003.htm#sthref83" /></entry> -<entry keyword="about, Embeddable"><topic href="tasks003.htm#sthref80" /></entry> -<entry keyword="JPA Details view, Embeddable"><topic href="reference014.htm#sthref408" /></entry> +<entry keyword="@Embeddable, Embeddable"><topic href="tasks004.htm#sthref95" /></entry> +<entry keyword="about, Embeddable"><topic href="tasks004.htm#sthref92" /></entry> +<entry keyword="JPA Details view, Embeddable"><topic href="reference018.htm#sthref433" /></entry> </entry> <entry keyword="embedded ID mapping"> -<entry keyword="@EmbeddedId, Embedded ID mapping"><topic href="tasks013.htm#sthref196" /></entry> -<entry keyword="about, Embedded ID mapping"><topic href="tasks013.htm#sthref194" /></entry> +<entry keyword="@EmbeddedId, Embedded ID mapping"><topic href="tasks014.htm#sthref209" /></entry> +<entry keyword="about, Embedded ID mapping"><topic href="tasks014.htm#sthref207" /></entry> </entry> <entry keyword="embedded mapping"> -<entry keyword="@Embedded, Embedded mapping"><topic href="tasks012.htm#sthref188" /></entry> -<entry keyword="about, Embedded mapping"><topic href="tasks012.htm#sthref186" /></entry> +<entry keyword="@Embedded, Embedded mapping"><topic href="tasks013.htm#sthref201" /></entry> +<entry keyword="about, Embedded mapping"><topic href="tasks013.htm#sthref199" /></entry> </entry> <entry keyword="entities"> -<entry keyword="@Entity annotation, Entity"><topic href="tasks002.htm#sthref75" /></entry> +<entry keyword="@Entity annotation, Entity"><topic href="tasks003.htm#sthref87" /></entry> <entry keyword="about, Understanding Java persistence"><topic href="concept_persistence.htm#sthref21" /></entry> <entry keyword="creating"> -<entry keyword="Creating a JPA entity"><topic href="task_create_jpa_entity.htm#sthref53" /></entry> -<entry keyword="Create JPA Entity wizard"><topic href="ref_create_jpa_entity_wizard.htm#sthref355" /></entry> +<entry keyword="Creating a JPA entity"><topic href="task_create_jpa_entity.htm#sthref65" /></entry> +<entry keyword="Create JPA Entity wizard"><topic href="ref_create_jpa_entity_wizard.htm#sthref368" /></entry> </entry> <entry keyword="creating tables from"> -<entry keyword="Generating tables from entities"><topic href="tasks022.htm#sthref270" /></entry> -<entry keyword="Generate Tables from Entities wizard"><topic href="reference010.htm#sthref384" /></entry> +<entry keyword="Generating tables from entities"><topic href="tasks023.htm#sthref283" /></entry> +<entry keyword="Generate Tables from Entities wizard"><topic href="reference014.htm#sthref409" /></entry> </entry> -<entry keyword="customer class, Advanced"><topic href="reference024.htm#sthref461" /></entry> +<entry keyword="customer class, Advanced"><topic href="reference028.htm#sthref486" /></entry> <entry keyword="customizing"> -<entry keyword="Customize Individual Entities"><topic href="ref_customizIndividualEntities.htm#sthref336" /></entry> -<entry keyword="Customize Individual Entities"><topic href="reference006.htm#sthref351" /></entry> +<entry keyword="Customize Individual Entities"><topic href="ref_customizIndividualEntities.htm#sthref349" /></entry> +<entry keyword="Customize Individual Entities"><topic href="reference006.htm#sthref364" /></entry> </entry> -<entry keyword="embeddable, Embeddable"><topic href="tasks003.htm#sthref84" /></entry> +<entry keyword="embeddable, Embeddable"><topic href="tasks004.htm#sthref96" /></entry> <entry keyword="from tables"> -<entry keyword="Generating entities from tables"><topic href="tasks021.htm#sthref258" /></entry> -<entry keyword="Generating dynamic entities from tables"><topic href="tasks023.htm#sthref275" /></entry> -<entry keyword="Select Tables"><topic href="ref_selectTables.htm#sthref326" /></entry> -<entry keyword="Select Tables"><topic href="reference003.htm#sthref341" /></entry> +<entry keyword="Generating entities from tables"><topic href="tasks022.htm#sthref271" /></entry> +<entry keyword="Generating dynamic entities from tables"><topic href="tasks024.htm#sthref288" /></entry> +<entry keyword="Select Tables"><topic href="ref_selectTables.htm#sthref339" /></entry> +<entry keyword="Select Tables"><topic href="reference003.htm#sthref354" /></entry> </entry> <entry keyword="generating"> -<entry keyword="Customize Default Entity Generation"><topic href="ref_customizeDefaultEntityGeneration.htm#sthref333" /></entry> -<entry keyword="Customize Default Entity Generation"><topic href="reference005.htm#sthref348" /></entry> +<entry keyword="Customize Default Entity Generation"><topic href="ref_customizeDefaultEntityGeneration.htm#sthref346" /></entry> +<entry keyword="Customize Default Entity Generation"><topic href="reference005.htm#sthref361" /></entry> </entry> -<entry keyword="JPA Details view, JPA Details view (for entities)"><topic href="ref_persistence_prop_view.htm#sthref403" /></entry> -<entry keyword="mapped superclass, Mapped superclass"><topic href="tasks004.htm#sthref91" /></entry> +<entry keyword="JPA Details view, JPA Details view (for entities)"><topic href="ref_persistence_prop_view.htm#sthref428" /></entry> +<entry keyword="mapped superclass, Mapped superclass"><topic href="tasks005.htm#sthref103" /></entry> <entry keyword="mapping"> <entry keyword="Creating a Java persistent entity with persistent fields"><topic href="getting_started004.htm#sthref14" /></entry> -<entry keyword="Mapping an entity"><topic href="task_mapping.htm#sthref168" /></entry> +<entry keyword="Mapping an entity"><topic href="task_mapping.htm#sthref181" /></entry> </entry> <entry keyword="persistent"> <entry keyword="Creating a Java persistent entity with persistent fields"><topic href="getting_started004.htm#sthref12" /></entry> -<entry keyword="Entity"><topic href="tasks002.htm#sthref70" /></entry> -<entry keyword="Entity"><topic href="tasks002.htm#sthref76" /></entry> +<entry keyword="Entity"><topic href="tasks003.htm#sthref82" /></entry> +<entry keyword="Entity"><topic href="tasks003.htm#sthref88" /></entry> </entry> -<entry keyword="read-only, Advanced"><topic href="reference024.htm#sthref459" /></entry> -<entry keyword="secondary tables, Secondary tables"><topic href="reference022.htm#sthref445" /></entry> -<entry keyword="tracking changes, Advanced"><topic href="reference024.htm#sthref465" /></entry> +<entry keyword="read-only, Advanced"><topic href="reference028.htm#sthref484" /></entry> +<entry keyword="secondary tables, Secondary tables"><topic href="reference026.htm#sthref470" /></entry> +<entry keyword="tracking changes, Advanced"><topic href="reference028.htm#sthref490" /></entry> </entry> -<entry keyword="Entity Class page, Selecting the Create a JPA Entity Wizard"><topic href="task_create_jpa_entity.htm#sthref57" /></entry> -<entry keyword="Entity Properties page, <a id="sthref57" name="sthref57"></a>The Entity Class Page"><topic href="task_create_jpa_entity.htm#sthref59" /></entry> -<entry keyword="enumerated, Type information"><topic href="reference035.htm#sthref510" /></entry> +<entry keyword="Entity Class page, Selecting the Create a JPA Entity Wizard"><topic href="task_create_jpa_entity.htm#sthref69" /></entry> +<entry keyword="Entity Properties page, <a id="sthref69" name="sthref69"></a>The Entity Class Page"><topic href="task_create_jpa_entity.htm#sthref71" /></entry> +<entry keyword="enumerated, Type information"><topic href="reference039.htm#sthref537" /></entry> <entry keyword="error messages - Dali"> -<entry keyword="Validating mappings and reporting problems"><topic href="tasks024.htm#sthref284" /></entry> -<entry keyword="Error messages"><topic href="tasks025.htm#sthref291" /></entry> - </entry> -<entry keyword="extension points - Dali feature, Dali Developer Documentation"><topic href="reference071.htm#sthref643" /></entry> -<entry keyword="fetch type, Basic Mapping"><topic href="reference025.htm#sthref478" /></entry> -<entry keyword="firewall, Tips and tricks"><topic href="tips_and_tricks.htm#sthref646" /></entry> -<entry keyword="General - in persistence.xml Editor, General"><topic href="ref_persistence_general.htm#sthref559" /></entry> -<entry keyword="Generate Dynamic Entities from Tables wizard, Generate Dynamic Entities from Tables wizard"><topic href="reference002.htm#sthref339" /></entry> +<entry keyword="Validating mappings and reporting problems"><topic href="tasks025.htm#sthref297" /></entry> +<entry keyword="Error messages"><topic href="tasks026.htm#sthref304" /></entry> + </entry> +<entry keyword="extension points - Dali feature, Dali Developer Documentation"><topic href="reference079.htm#sthref691" /></entry> +<entry keyword="fetch type, Basic Mapping"><topic href="reference029.htm#sthref505" /></entry> +<entry keyword="firewall, Tips and tricks"><topic href="tips_and_tricks.htm#sthref694" /></entry> +<entry keyword="General - in persistence.xml Editor, General"><topic href="ref_persistence_general.htm#sthref586" /></entry> +<entry keyword="Generate Dynamic Entities from Tables wizard, Generate Dynamic Entities from Tables wizard"><topic href="reference002.htm#sthref352" /></entry> <entry keyword="Generate Entities from Tables dialog"> -<entry keyword="Generating entities from tables"><topic href="tasks021.htm#sthref260" /></entry> -<entry keyword="Select Tables"><topic href="ref_selectTables.htm#sthref325" /></entry> -<entry keyword="Select Tables"><topic href="reference003.htm#sthref340" /></entry> +<entry keyword="Generating entities from tables"><topic href="tasks022.htm#sthref273" /></entry> +<entry keyword="Select Tables"><topic href="ref_selectTables.htm#sthref338" /></entry> +<entry keyword="Select Tables"><topic href="reference003.htm#sthref353" /></entry> </entry> -<entry keyword="Generate Entities from Tables wizard, Generate Entities from Tables wizard"><topic href="ref_create_custom_entities_wizard.htm#sthref324" /></entry> -<entry keyword="Generate Tables from Entities wizard, Generate Tables from Entities wizard"><topic href="reference010.htm#sthref382" /></entry> +<entry keyword="Generate Entities from Tables wizard, Generate Entities from Tables wizard"><topic href="ref_create_custom_entities_wizard.htm#sthref337" /></entry> +<entry keyword="Generate Tables from Entities wizard, Generate Tables from Entities wizard"><topic href="reference014.htm#sthref407" /></entry> <entry keyword="generated values"> -<entry keyword="entities - preferences, Project Properties Page - Entity Generation"><topic href="reference058.htm#sthref608" /></entry> -<entry keyword="ID mappings, Primary Key Generation information"><topic href="ref_primary_key.htm#sthref526" /></entry> +<entry keyword="entities - preferences, Project Properties page - Entity Generation"><topic href="reference062.htm#sthref635" /></entry> +<entry keyword="ID mappings, Primary Key Generation information"><topic href="ref_primary_key.htm#sthref553" /></entry> <entry keyword="sequence"> -<entry keyword="Primary Key Generation"><topic href="reference021.htm#sthref439" /></entry> -<entry keyword="Primary Key Generation"><topic href="reference021.htm#sthref441" /></entry> -<entry keyword="Primary Key Generation information"><topic href="ref_primary_key.htm#sthref528" /></entry> +<entry keyword="Primary Key Generation"><topic href="reference025.htm#sthref464" /></entry> +<entry keyword="Primary Key Generation"><topic href="reference025.htm#sthref466" /></entry> +<entry keyword="Primary Key Generation information"><topic href="ref_primary_key.htm#sthref555" /></entry> </entry> </entry> -<entry keyword="generating DDL, Generate Tables from Entities wizard"><topic href="reference010.htm#sthref386" /></entry> -<entry keyword="Generators - in JPA Detail view, Generators"><topic href="reference043.htm#sthref539" /></entry> +<entry keyword="generating DDL, Generate Tables from Entities wizard"><topic href="reference014.htm#sthref411" /></entry> +<entry keyword="Generators - in JPA Detail view, Generators"><topic href="reference047.htm#sthref566" /></entry> <entry keyword="hints - query"> -<entry keyword="Add Query Dialog"><topic href="tasks009.htm#sthref164" /></entry> -<entry keyword="Queries"><topic href="reference044.htm#sthref549" /></entry> +<entry keyword="Add Query Dialog"><topic href="tasks010.htm#sthref176" /></entry> +<entry keyword="Queries"><topic href="reference048.htm#sthref576" /></entry> </entry> <entry keyword="ID mapping"> -<entry keyword="@Id, ID mapping"><topic href="tasks014.htm#sthref204" /></entry> +<entry keyword="@Id, ID mapping"><topic href="tasks015.htm#sthref217" /></entry> <entry keyword="about"> -<entry keyword="ID mapping"><topic href="tasks014.htm#sthref202" /></entry> -<entry keyword="ID Mapping"><topic href="reference029.htm#sthref485" /></entry> +<entry keyword="ID mapping"><topic href="tasks015.htm#sthref215" /></entry> +<entry keyword="ID Mapping"><topic href="reference033.htm#sthref512" /></entry> </entry> </entry> -<entry keyword="identity - derived, Derived Identity"><topic href="reference040.htm#sthref522" /></entry> +<entry keyword="identity - derived, Derived Identity"><topic href="reference044.htm#sthref549" /></entry> <entry keyword="inheritance"> <entry keyword="entity"> -<entry keyword="Specifying entity inheritance"><topic href="task_inheritance.htm#sthref146" /></entry> -<entry keyword="Entity Class page"><topic href="ref_EntityClassPage.htm#sthref356" /></entry> -<entry keyword="Inheritance"><topic href="reference018.htm#sthref422" /></entry> +<entry keyword="Specifying entity inheritance"><topic href="task_inheritance.htm#sthref158" /></entry> +<entry keyword="Entity Class page"><topic href="ref_EntityClassPage.htm#sthref369" /></entry> +<entry keyword="Inheritance"><topic href="reference022.htm#sthref447" /></entry> </entry> -<entry keyword="joined tables, Single Table Inheritance"><topic href="task_inheritance.htm#sthref154" /></entry> -<entry keyword="single table, Specifying entity inheritance"><topic href="task_inheritance.htm#sthref149" /></entry> +<entry keyword="joined tables, Single Table Inheritance"><topic href="task_inheritance.htm#sthref166" /></entry> +<entry keyword="single table, Specifying entity inheritance"><topic href="task_inheritance.htm#sthref161" /></entry> </entry> -<entry keyword="Inheritance - in Java Details view, Inheritance"><topic href="reference018.htm#sthref421" /></entry> +<entry keyword="Inheritance - in Java Details view, Inheritance"><topic href="reference022.htm#sthref446" /></entry> <entry keyword="installation - Dali, Requirements and installation"><topic href="getting_started001.htm#sthref3" /></entry> <entry keyword="Java Persistence API (JPA)"> <entry keyword="about, Understanding Java Persistence API"><topic href="concepts001.htm#sthref25" /></entry> </entry> -<entry keyword="Java project - converting to JPA, Converting a Java project to a JPA project"><topic href="tasks001.htm#sthref45" /></entry> +<entry keyword="Java project - converting to JPA, Converting a Java project to a JPA project"><topic href="tasks002.htm#sthref57" /></entry> + <entry keyword="JAXB"> + <entry keyword="options"> +<entry keyword="Project Properties page - JAXB Options"><topic href="reference064.htm#sthref639" /></entry> +<entry keyword="Project Properties page - Schemas"><topic href="reference065.htm#sthref647" /></entry> + </entry> + </entry> + <entry keyword="JAXB project"> + <entry keyword="creating"> +<entry keyword="Creating a new JAXB project"><topic href="tasks001.htm#sthref46" /></entry> +<entry keyword="Create New JAXB Project wizard"><topic href="reference010.htm#sthref397" /></entry> + </entry> +<entry keyword="implementation, JAXB Facet page"><topic href="reference013.htm#sthref403" /></entry> + </entry> + <entry keyword="JAXB schema - adding"> +<entry keyword="Add Schema Location dialog"><topic href="reference074.htm#sthref677" /></entry> +<entry keyword="Select Schema Location dialog"><topic href="reference075.htm#sthref681" /></entry> + </entry> <entry keyword="join columns"> -<entry keyword="Join Columns"><topic href="ref_join_columns.htm#sthref394" /></entry> -<entry keyword="Add Join Column dialog"><topic href="reference062.htm#sthref615" /></entry> +<entry keyword="Join Columns"><topic href="ref_join_columns.htm#sthref419" /></entry> +<entry keyword="Add Join Column dialog"><topic href="reference068.htm#sthref655" /></entry> </entry> -<entry keyword="joined tables - inheritance, Single Table Inheritance"><topic href="task_inheritance.htm#sthref155" /></entry> -<entry keyword="joining, Joining Strategy"><topic href="reference039.htm#sthref518" /></entry> -<entry keyword="Joining Strategy - in JPA Details view, Joining Strategy"><topic href="reference039.htm#sthref519" /></entry> +<entry keyword="joined tables - inheritance, Single Table Inheritance"><topic href="task_inheritance.htm#sthref167" /></entry> +<entry keyword="joining, Joining Strategy"><topic href="reference043.htm#sthref545" /></entry> +<entry keyword="Joining Strategy - in JPA Details view, Joining Strategy"><topic href="reference043.htm#sthref546" /></entry> <entry keyword="JPA Details view"> -<entry keyword="attributes, JPA Details view (for attributes)"><topic href="ref_persistence_map_view.htm#sthref467" /></entry> -<entry keyword="entities, JPA Details view (for entities)"><topic href="ref_persistence_prop_view.htm#sthref401" /></entry> -<entry keyword="orm.xml file, JPA Details view (for orm.xml)"><topic href="ref_details_orm.htm#sthref531" /></entry> - </entry> -<entry keyword="JPA Development perspective, JPA Development perspective"><topic href="ref_persistence_perspective.htm#sthref635" /></entry> -<entry keyword="JPA entity - creating, Creating a JPA entity"><topic href="task_create_jpa_entity.htm#sthref54" /></entry> -<entry keyword="JPA Facet page, The Java Source Page"><topic href="task_create_new_project.htm#sthref41" /></entry> -<entry keyword="JPA Metadata Conversion dialog, JPA Metadata Conversion dialog"><topic href="reference064.htm#sthref626" /></entry> +<entry keyword="attributes, JPA Details view (for attributes)"><topic href="ref_persistence_map_view.htm#sthref492" /></entry> +<entry keyword="entities, JPA Details view (for entities)"><topic href="ref_persistence_prop_view.htm#sthref426" /></entry> +<entry keyword="Mappings tab, JPA Details view (for attributes)"><topic href="ref_persistence_map_view.htm#sthref497" /></entry> +<entry keyword="orm.xml file, JPA Details view (for orm.xml)"><topic href="ref_details_orm.htm#sthref558" /></entry> + </entry> +<entry keyword="JPA Development perspective, JPA Development perspective"><topic href="ref_persistence_perspective.htm#sthref683" /></entry> +<entry keyword="JPA entity - creating, Creating a JPA entity"><topic href="task_create_jpa_entity.htm#sthref66" /></entry> + <entry keyword="JPA Facet page"> +<entry keyword="The Java Source Page"><topic href="task_create_new_project.htm#sthref41" /></entry> +<entry keyword="The Java Source Page"><topic href="tasks001.htm#sthref53" /></entry> + </entry> +<entry keyword="JPA Metadata Conversion dialog, JPA Metadata Conversion dialog"><topic href="reference070.htm#sthref666" /></entry> <entry keyword="JPA project"> -<entry keyword="converting from Java, Converting a Java project to a JPA project"><topic href="tasks001.htm#sthref46" /></entry> -<entry keyword="converting metadata to XML, Converting JPA metadata to XML"><topic href="tasks028.htm#sthref318" /></entry> +<entry keyword="converting from Java, Converting a Java project to a JPA project"><topic href="tasks002.htm#sthref58" /></entry> +<entry keyword="converting metadata to XML, Converting JPA metadata to XML"><topic href="tasks029.htm#sthref331" /></entry> <entry keyword="creating"> <entry keyword="Creating a new JPA project"><topic href="task_create_new_project.htm#sthref35" /></entry> -<entry keyword="Create New JPA Project wizard"><topic href="ref_new_jpa_project_wizard.htm#sthref371" /></entry> - </entry> -<entry keyword="implementation, JPA Facet page"><topic href="ref_jpa_facet.htm#sthref376" /></entry> -<entry keyword="page, <a id="sthref37" name="sthref37"></a>Selecting the Create a JPA Project wizard"><topic href="task_create_new_project.htm#sthref39" /></entry> -<entry keyword="platform, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref595" /></entry> - </entry> -<entry keyword="JPA Structure view, JPA Structure view"><topic href="ref_persistence_outline.htm#sthref555" /></entry> -<entry keyword="key - primary, Primary Key Generation"><topic href="reference021.htm#sthref437" /></entry> -<entry keyword="lazy fetch, Basic Mapping"><topic href="reference025.htm#sthref480" /></entry> -<entry keyword="library - JPA, JPA Facet page"><topic href="ref_jpa_facet.htm#sthref377" /></entry> -<entry keyword="Logging - in persistence.xml editor, Logging"><topic href="reference049.htm#sthref572" /></entry> -<entry keyword="Make Persistent dialog, Make Persistent dialog"><topic href="reference065.htm#sthref628" /></entry> +<entry keyword="Create New JPA Project wizard"><topic href="ref_new_jpa_project_wizard.htm#sthref384" /></entry> + </entry> +<entry keyword="implementation, JPA Facet page"><topic href="ref_jpa_facet.htm#sthref389" /></entry> + <entry keyword="page"> +<entry keyword="<a id="sthref37" name="sthref37"></a>Selecting the Create a JPA Project wizard"><topic href="task_create_new_project.htm#sthref39" /></entry> +<entry keyword="<a id="sthref48" name="sthref48"></a>Selecting the Create a JAXB Project wizard"><topic href="tasks001.htm#sthref50" /></entry> + </entry> + <entry keyword="platform"> +<entry keyword="Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref622" /></entry> +<entry keyword="Project Properties page - JAXB Options"><topic href="reference064.htm#sthref643" /></entry> + </entry> + </entry> +<entry keyword="JPA Structure view, JPA Structure view"><topic href="ref_persistence_outline.htm#sthref582" /></entry> +<entry keyword="key - primary, Primary Key Generation"><topic href="reference025.htm#sthref462" /></entry> +<entry keyword="lazy fetch, Basic Mapping"><topic href="reference029.htm#sthref507" /></entry> +<entry keyword="library - JAXB, JAXB Facet page"><topic href="reference013.htm#sthref404" /></entry> +<entry keyword="library - JPA, JPA Facet page"><topic href="ref_jpa_facet.htm#sthref390" /></entry> +<entry keyword="Logging - in persistence.xml editor, Logging"><topic href="reference053.htm#sthref599" /></entry> +<entry keyword="Make Persistent dialog, Make Persistent dialog"><topic href="reference071.htm#sthref668" /></entry> <entry keyword="many-to-many mapping"> -<entry keyword="@ManyToMany, Many-to-many mapping"><topic href="tasks015.htm#sthref213" /></entry> +<entry keyword="@ManyToMany, Many-to-many mapping"><topic href="tasks016.htm#sthref226" /></entry> <entry keyword="about"> -<entry keyword="Many-to-many mapping"><topic href="tasks015.htm#sthref211" /></entry> -<entry keyword="Many-to-Many Mapping"><topic href="reference030.htm#sthref490" /></entry> +<entry keyword="Many-to-many mapping"><topic href="tasks016.htm#sthref224" /></entry> +<entry keyword="Many-to-Many Mapping"><topic href="reference034.htm#sthref517" /></entry> </entry> </entry> <entry keyword="many-to-one mapping"> -<entry keyword="@ManyToOne, Many-to-one mapping"><topic href="tasks016.htm#sthref221" /></entry> +<entry keyword="@ManyToOne, Many-to-one mapping"><topic href="tasks017.htm#sthref234" /></entry> <entry keyword="about"> -<entry keyword="Many-to-one mapping"><topic href="tasks016.htm#sthref220" /></entry> -<entry keyword="Many-to-One Mapping"><topic href="reference031.htm#sthref493" /></entry> +<entry keyword="Many-to-one mapping"><topic href="tasks017.htm#sthref233" /></entry> +<entry keyword="Many-to-One Mapping"><topic href="reference035.htm#sthref520" /></entry> </entry> </entry> <entry keyword="mapped superclass"> -<entry keyword="@MappedSuperclass, Mapped superclass"><topic href="tasks004.htm#sthref89" /></entry> -<entry keyword="about, Mapped superclass"><topic href="tasks004.htm#sthref87" /></entry> -<entry keyword="JPA Details view, Mapped Superclass"><topic href="reference015.htm#sthref411" /></entry> +<entry keyword="@MappedSuperclass, Mapped superclass"><topic href="tasks005.htm#sthref101" /></entry> +<entry keyword="about, Mapped superclass"><topic href="tasks005.htm#sthref99" /></entry> +<entry keyword="JPA Details view, Mapped Superclass"><topic href="reference019.htm#sthref436" /></entry> </entry> <entry keyword="mapping entities, Creating a Java persistent entity with persistent fields"><topic href="getting_started004.htm#sthref13" /></entry> <entry keyword="mapping file"> -<entry keyword="Creating an orm.xml file"><topic href="tasks007.htm#sthref127" /></entry> -<entry keyword="Entity Class page"><topic href="ref_EntityClassPage.htm#sthref357" /></entry> -<entry keyword="Create ORM Mapping File wizard"><topic href="reference007.htm#sthref363" /></entry> +<entry keyword="Creating an orm.xml file"><topic href="tasks008.htm#sthref139" /></entry> +<entry keyword="Entity Class page"><topic href="ref_EntityClassPage.htm#sthref370" /></entry> +<entry keyword="Create ORM Mapping File wizard"><topic href="reference007.htm#sthref376" /></entry> </entry> -<entry keyword="Mapping Type Selection dialog, Mapping Type Selection dialog"><topic href="reference063.htm#sthref624" /></entry> +<entry keyword="Mapping Type Selection dialog, Mapping Type Selection dialog"><topic href="reference069.htm#sthref664" /></entry> <entry keyword="mappings"> +<entry keyword="JPA Details view (for attributes)"><topic href="ref_persistence_map_view.htm#sthref495" /></entry> <entry keyword="about"> <entry keyword="Understanding OR mappings"><topic href="concept_mapping.htm#sthref23" /></entry> -<entry keyword="Mapping an entity"><topic href="task_mapping.htm#sthref167" /></entry> +<entry keyword="Mapping an entity"><topic href="task_mapping.htm#sthref180" /></entry> </entry> <entry keyword="basic"> -<entry keyword="Basic mapping"><topic href="tasks010.htm#sthref170" /></entry> -<entry keyword="Basic Mapping"><topic href="reference025.htm#sthref473" /></entry> +<entry keyword="Basic mapping"><topic href="tasks011.htm#sthref183" /></entry> +<entry keyword="Basic Mapping"><topic href="reference029.htm#sthref500" /></entry> </entry> <entry keyword="element collection"> -<entry keyword="Element collection mapping"><topic href="tasks011.htm#sthref178" /></entry> -<entry keyword="Element Collection Mapping"><topic href="reference026.htm#sthref481" /></entry> +<entry keyword="Element collection mapping"><topic href="tasks012.htm#sthref191" /></entry> +<entry keyword="Element Collection Mapping"><topic href="reference030.htm#sthref508" /></entry> </entry> -<entry keyword="embedded, Embedded mapping"><topic href="tasks012.htm#sthref185" /></entry> -<entry keyword="embedded ID, Embedded ID mapping"><topic href="tasks013.htm#sthref193" /></entry> +<entry keyword="embedded, Embedded mapping"><topic href="tasks013.htm#sthref198" /></entry> +<entry keyword="embedded ID, Embedded ID mapping"><topic href="tasks014.htm#sthref206" /></entry> <entry keyword="ID"> -<entry keyword="ID mapping"><topic href="tasks014.htm#sthref201" /></entry> -<entry keyword="ID Mapping"><topic href="reference029.htm#sthref483" /></entry> +<entry keyword="ID mapping"><topic href="tasks015.htm#sthref214" /></entry> +<entry keyword="ID Mapping"><topic href="reference033.htm#sthref510" /></entry> </entry> <entry keyword="many-to-many"> -<entry keyword="Many-to-many mapping"><topic href="tasks015.htm#sthref210" /></entry> -<entry keyword="Many-to-Many Mapping"><topic href="reference030.htm#sthref488" /></entry> +<entry keyword="Many-to-many mapping"><topic href="tasks016.htm#sthref223" /></entry> +<entry keyword="Many-to-Many Mapping"><topic href="reference034.htm#sthref515" /></entry> </entry> <entry keyword="many-to-one"> -<entry keyword="Many-to-one mapping"><topic href="tasks016.htm#sthref219" /></entry> -<entry keyword="Many-to-One Mapping"><topic href="reference031.htm#sthref491" /></entry> +<entry keyword="Many-to-one mapping"><topic href="tasks017.htm#sthref232" /></entry> +<entry keyword="Many-to-One Mapping"><topic href="reference035.htm#sthref518" /></entry> </entry> <entry keyword="one-to-many"> -<entry keyword="One-to-many mapping"><topic href="tasks017.htm#sthref227" /></entry> -<entry keyword="One-to-Many Mapping"><topic href="reference032.htm#sthref494" /></entry> +<entry keyword="One-to-many mapping"><topic href="tasks018.htm#sthref240" /></entry> +<entry keyword="One-to-Many Mapping"><topic href="reference036.htm#sthref521" /></entry> </entry> <entry keyword="one-to-one"> -<entry keyword="One-to-one mapping"><topic href="tasks018.htm#sthref235" /></entry> -<entry keyword="One-to-One Mapping"><topic href="reference033.htm#sthref497" /></entry> +<entry keyword="One-to-one mapping"><topic href="tasks019.htm#sthref248" /></entry> +<entry keyword="One-to-One Mapping"><topic href="reference037.htm#sthref524" /></entry> </entry> -<entry keyword="problems, Validating mappings and reporting problems"><topic href="tasks024.htm#sthref287" /></entry> -<entry keyword="transient, Transient mapping"><topic href="tasks019.htm#sthref243" /></entry> +<entry keyword="problems, Validating mappings and reporting problems"><topic href="tasks025.htm#sthref300" /></entry> +<entry keyword="transient, Transient mapping"><topic href="tasks020.htm#sthref256" /></entry> <entry keyword="version"> -<entry keyword="Version mapping"><topic href="tasks020.htm#sthref250" /></entry> -<entry keyword="Version Mapping"><topic href="reference034.htm#sthref500" /></entry> +<entry keyword="Version mapping"><topic href="tasks021.htm#sthref263" /></entry> +<entry keyword="Version Mapping"><topic href="reference038.htm#sthref527" /></entry> </entry> </entry> -<entry keyword="mappings - about, JPA Details view (for attributes)"><topic href="ref_persistence_map_view.htm#sthref470" /></entry> -<entry keyword="metadata - converting to XML, Converting JPA metadata to XML"><topic href="tasks028.htm#sthref316" /></entry> -<entry keyword="metamodel - canonical, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref602" /></entry> -<entry keyword="multitenancy, Multitenancy"><topic href="reference020.htm#sthref434" /></entry> +<entry keyword="metadata - converting to XML, Converting JPA metadata to XML"><topic href="tasks029.htm#sthref329" /></entry> +<entry keyword="metamodel - canonical, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref629" /></entry> +<entry keyword="multitenancy, Multitenancy"><topic href="reference024.htm#sthref459" /></entry> <entry keyword="named queries"> -<entry keyword="Queries"><topic href="reference044.htm#sthref546" /></entry> +<entry keyword="Queries"><topic href="reference048.htm#sthref573" /></entry> <entry keyword="entity"> -<entry keyword="Creating queries"><topic href="tasks009.htm#sthref158" /></entry> +<entry keyword="Creating queries"><topic href="tasks010.htm#sthref170" /></entry> </entry> -<entry keyword="hints, Add Query Dialog"><topic href="tasks009.htm#sthref165" /></entry> -<entry keyword="JPA Detail view, Queries"><topic href="reference017.htm#sthref417" /></entry> +<entry keyword="hints, Add Query Dialog"><topic href="tasks010.htm#sthref177" /></entry> +<entry keyword="JPA Detail view, Queries"><topic href="reference021.htm#sthref442" /></entry> </entry> <entry keyword="native queries"> -<entry keyword="Add Query Dialog"><topic href="tasks009.htm#sthref166" /></entry> -<entry keyword="Queries"><topic href="reference017.htm#sthref418" /></entry> -<entry keyword="Queries"><topic href="reference044.htm#sthref547" /></entry> +<entry keyword="Add Query Dialog"><topic href="tasks010.htm#sthref178" /></entry> +<entry keyword="Queries"><topic href="reference021.htm#sthref443" /></entry> +<entry keyword="Queries"><topic href="reference048.htm#sthref574" /></entry> </entry> -<entry keyword="New EclipseLink Mapping File dialog, New EclipseLink Mapping File dialog"><topic href="ref_eclipselink_mapping_file.htm#sthref618" /></entry> +<entry keyword="New EclipseLink Mapping File dialog, New EclipseLink Mapping File dialog"><topic href="ref_eclipselink_mapping_file.htm#sthref658" /></entry> <entry keyword="nonpersistent"> -<entry keyword="classes, Adding persistence to a class"><topic href="task_add_persistence.htm#sthref65" /></entry> +<entry keyword="classes, Adding persistence to a class"><topic href="task_add_persistence.htm#sthref77" /></entry> <entry keyword="fields. See transient"></entry> </entry> -<entry keyword="object type converter, Converters"><topic href="reference023.htm#sthref453" /></entry> -<entry keyword="ObjectChangePolicy, Advanced"><topic href="reference024.htm#sthref464" /></entry> +<entry keyword="object type converter, Converters"><topic href="reference027.htm#sthref478" /></entry> +<entry keyword="ObjectChangePolicy, Advanced"><topic href="reference028.htm#sthref489" /></entry> <entry keyword="one-to-many mapping"> -<entry keyword="@OneToMany, One-to-many mapping"><topic href="tasks017.htm#sthref230" /></entry> +<entry keyword="@OneToMany, One-to-many mapping"><topic href="tasks018.htm#sthref243" /></entry> <entry keyword="about"> -<entry keyword="One-to-many mapping"><topic href="tasks017.htm#sthref228" /></entry> -<entry keyword="One-to-Many Mapping"><topic href="reference032.htm#sthref496" /></entry> +<entry keyword="One-to-many mapping"><topic href="tasks018.htm#sthref241" /></entry> +<entry keyword="One-to-Many Mapping"><topic href="reference036.htm#sthref523" /></entry> </entry> </entry> <entry keyword="one-to-one mapping"> -<entry keyword="@OneToOne, One-to-one mapping"><topic href="tasks018.htm#sthref238" /></entry> +<entry keyword="@OneToOne, One-to-one mapping"><topic href="tasks019.htm#sthref251" /></entry> <entry keyword="about"> -<entry keyword="One-to-one mapping"><topic href="tasks018.htm#sthref236" /></entry> -<entry keyword="One-to-One Mapping"><topic href="reference033.htm#sthref499" /></entry> +<entry keyword="One-to-one mapping"><topic href="tasks019.htm#sthref249" /></entry> +<entry keyword="One-to-One Mapping"><topic href="reference037.htm#sthref526" /></entry> </entry> </entry> -<entry keyword="Options - in persistence.xml editor, Options"><topic href="reference050.htm#sthref576" /></entry> -<entry keyword="ordering, Ordering"><topic href="reference038.htm#sthref515" /></entry> -<entry keyword="Ordering - in JPA Details view, Ordering"><topic href="reference038.htm#sthref517" /></entry> +<entry keyword="Options - in persistence.xml editor, Options"><topic href="reference054.htm#sthref603" /></entry> +<entry keyword="ordering, Ordering"><topic href="reference042.htm#sthref542" /></entry> +<entry keyword="Ordering - in JPA Details view, Ordering"><topic href="reference042.htm#sthref544" /></entry> <entry keyword="orm.xml file"> <entry keyword="about, The orm.xml file"><topic href="concepts003.htm#sthref31" /></entry> <entry keyword="creating"> -<entry keyword="Create ORM Mapping File wizard"><topic href="reference007.htm#sthref364" /></entry> -<entry keyword="JPA Facet page"><topic href="ref_jpa_facet.htm#sthref379" /></entry> +<entry keyword="Create ORM Mapping File wizard"><topic href="reference007.htm#sthref377" /></entry> +<entry keyword="JPA Facet page"><topic href="ref_jpa_facet.htm#sthref392" /></entry> </entry> -<entry keyword="generators, Generators"><topic href="reference043.htm#sthref540" /></entry> -<entry keyword="JPA Details view, JPA Details view (for orm.xml)"><topic href="ref_details_orm.htm#sthref532" /></entry> -<entry keyword="managing, Managing the orm.xml file"><topic href="task_manage_orm.htm#sthref121" /></entry> -<entry keyword="queries, Queries"><topic href="reference044.htm#sthref545" /></entry> -<entry keyword="sample, Managing the orm.xml file"><topic href="task_manage_orm.htm#sthref122" /></entry> +<entry keyword="generators, Generators"><topic href="reference047.htm#sthref567" /></entry> +<entry keyword="JPA Details view, JPA Details view (for orm.xml)"><topic href="ref_details_orm.htm#sthref559" /></entry> +<entry keyword="managing, Managing the orm.xml file"><topic href="task_manage_orm.htm#sthref133" /></entry> +<entry keyword="queries, Queries"><topic href="reference048.htm#sthref572" /></entry> +<entry keyword="sample, Managing the orm.xml file"><topic href="task_manage_orm.htm#sthref134" /></entry> </entry> -<entry keyword="overrides - JPA attributes, Attribute Overrides"><topic href="reference019.htm#sthref430" /></entry> +<entry keyword="overrides - JPA attributes, Attribute Overrides"><topic href="reference023.htm#sthref455" /></entry> <entry keyword="persistence"> <entry keyword="about, Understanding Java persistence"><topic href="concept_persistence.htm#sthref20" /></entry> -<entry keyword="database connection, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref597" /></entry> -<entry keyword="database schema, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref600" /></entry> -<entry keyword="entity class, Adding persistence to a class"><topic href="task_add_persistence.htm#sthref64" /></entry> -<entry keyword="options, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref591" /></entry> -<entry keyword="provider, General"><topic href="ref_persistence_general.htm#sthref560" /></entry> -<entry keyword="unit, Persistence Unit"><topic href="reference042.htm#sthref536" /></entry> - </entry> -<entry keyword="Persistence Unit - in JPA Details, Persistence Unit"><topic href="reference042.htm#sthref535" /></entry> + <entry keyword="database connection"> +<entry keyword="Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref624" /></entry> +<entry keyword="Project Properties page - JAXB Options"><topic href="reference064.htm#sthref645" /></entry> + </entry> +<entry keyword="database schema, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref627" /></entry> +<entry keyword="entity class, Adding persistence to a class"><topic href="task_add_persistence.htm#sthref76" /></entry> +<entry keyword="options, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref618" /></entry> +<entry keyword="provider, General"><topic href="ref_persistence_general.htm#sthref587" /></entry> +<entry keyword="unit, Persistence Unit"><topic href="reference046.htm#sthref563" /></entry> + </entry> +<entry keyword="Persistence Unit - in JPA Details, Persistence Unit"><topic href="reference046.htm#sthref562" /></entry> <entry keyword="persistence.xml Editor"> <entry keyword="Managing the persistence.xml file"><topic href="task_manage_persistence.htm#ABC4949575SRI1" /></entry> -<entry keyword="persistence.xml Editor"><topic href="ref_persistence_xmll_editor.htm#sthref558" /></entry> +<entry keyword="persistence.xml Editor"><topic href="ref_persistence_xmll_editor.htm#sthref585" /></entry> </entry> <entry keyword="persistence.xml file"> <entry keyword="about, The persistence.xml file"><topic href="concepts002.htm#sthref28" /></entry> <entry keyword="managing"> <entry keyword="Managing the persistence.xml file"><topic href="task_manage_persistence.htm#ABC4949575" /></entry> -<entry keyword="Working with orm.xml file"><topic href="tasks008.htm#sthref135" /></entry> +<entry keyword="Working with orm.xml file"><topic href="tasks009.htm#sthref147" /></entry> </entry> -<entry keyword="sample, Managing the persistence.xml file"><topic href="task_manage_persistence.htm#sthref97" /></entry> -<entry keyword="schema based, Tips and tricks"><topic href="tips_and_tricks.htm#sthref645" /></entry> -<entry keyword="synchronizing with classes, Synchronizing classes"><topic href="tasks006.htm#sthref116" /></entry> +<entry keyword="sample, Managing the persistence.xml file"><topic href="task_manage_persistence.htm#sthref109" /></entry> +<entry keyword="schema based, Tips and tricks"><topic href="tips_and_tricks.htm#sthref693" /></entry> +<entry keyword="synchronizing with classes, Synchronizing classes"><topic href="tasks007.htm#sthref128" /></entry> + </entry> +<entry keyword="persistent entity, Entity"><topic href="tasks003.htm#sthref83" /></entry> +<entry keyword="perspective - JPA Development, JPA Development perspective"><topic href="ref_persistence_perspective.htm#sthref684" /></entry> + <entry keyword="platform - JPA"> +<entry keyword="Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref621" /></entry> +<entry keyword="Project Properties page - JAXB Options"><topic href="reference064.htm#sthref642" /></entry> </entry> -<entry keyword="persistent entity, Entity"><topic href="tasks002.htm#sthref71" /></entry> -<entry keyword="perspective - JPA Development, JPA Development perspective"><topic href="ref_persistence_perspective.htm#sthref636" /></entry> -<entry keyword="platform - JPA, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref594" /></entry> <entry keyword="preferences"> -<entry keyword="errors and warnings, Java Persistence Preferences page - Errors/Warnings"><topic href="reference056.htm#sthref589" /></entry> -<entry keyword="JPA, Java Persistence Preferences page - JPA"><topic href="reference055.htm#sthref587" /></entry> -<entry keyword="project - EclipseLink, Project Properties page - EclipseLink"><topic href="reference057.htm#sthref604" /></entry> -<entry keyword="project - Entity Generation, Project Properties Page - Entity Generation"><topic href="reference058.htm#sthref607" /></entry> -<entry keyword="project - errors and warnings, Project Properties page - Errors/Warnings"><topic href="reference059.htm#sthref610" /></entry> -<entry keyword="project - JPA, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref593" /></entry> - </entry> -<entry keyword="preferences - Dali, Preferences"><topic href="reference054.htm#sthref586" /></entry> +<entry keyword="errors and warnings, Java Persistence Preferences page - Errors/Warnings"><topic href="reference060.htm#sthref616" /></entry> +<entry keyword="JPA, Java Persistence Preferences page - JPA"><topic href="reference059.htm#sthref614" /></entry> +<entry keyword="project - EclipseLink, Project Properties page - EclipseLink"><topic href="reference061.htm#sthref631" /></entry> +<entry keyword="project - Entity Generation, Project Properties page - Entity Generation"><topic href="reference062.htm#sthref634" /></entry> +<entry keyword="project - errors and warnings, Project Properties page - Errors/Warnings"><topic href="reference063.htm#sthref637" /></entry> + <entry keyword="project - JAXB"> +<entry keyword="Project Properties page - JAXB Options"><topic href="reference064.htm#sthref641" /></entry> +<entry keyword="Project Properties page - Schemas"><topic href="reference065.htm#sthref649" /></entry> + </entry> +<entry keyword="project - JPA, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref620" /></entry> + </entry> +<entry keyword="preferences - Dali, Preferences"><topic href="reference058.htm#sthref613" /></entry> <entry keyword="Primary Key Generation - in JPA Details view"> -<entry keyword="Primary Key Generation"><topic href="reference021.htm#sthref436" /></entry> -<entry keyword="Primary Key Generation information"><topic href="ref_primary_key.htm#sthref524" /></entry> +<entry keyword="Primary Key Generation"><topic href="reference025.htm#sthref461" /></entry> +<entry keyword="Primary Key Generation information"><topic href="ref_primary_key.htm#sthref551" /></entry> + </entry> +<entry keyword="problems, Validating mappings and reporting problems"><topic href="tasks025.htm#sthref299" /></entry> + <entry keyword="projects - JAXB"> + <entry keyword="creating new"> +<entry keyword="Creating a new JAXB project"><topic href="tasks001.htm#sthref45" /></entry> +<entry keyword="Create New JAXB Project wizard"><topic href="reference010.htm#sthref396" /></entry> + </entry> + <entry keyword="options"> +<entry keyword="Project Properties page - JAXB Options"><topic href="reference064.htm#sthref640" /></entry> +<entry keyword="Project Properties page - Schemas"><topic href="reference065.htm#sthref648" /></entry> + </entry> </entry> -<entry keyword="problems, Validating mappings and reporting problems"><topic href="tasks024.htm#sthref286" /></entry> <entry keyword="projects - JPA"> <entry keyword="creating new"> <entry keyword="Creating a new JPA project"><topic href="getting_started003.htm#sthref10" /></entry> <entry keyword="Creating a new JPA project"><topic href="task_create_new_project.htm#sthref34" /></entry> -<entry keyword="Create New JPA Project wizard"><topic href="ref_new_jpa_project_wizard.htm#sthref370" /></entry> +<entry keyword="Create New JPA Project wizard"><topic href="ref_new_jpa_project_wizard.htm#sthref383" /></entry> </entry> -<entry keyword="options, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref592" /></entry> -<entry keyword="properties, Modifying persistent project properties"><topic href="tasks027.htm#sthref310" /></entry> +<entry keyword="options, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref619" /></entry> +<entry keyword="properties, Modifying persistent project properties"><topic href="tasks028.htm#sthref323" /></entry> </entry> <entry keyword="properties"> -<entry keyword="project, Modifying persistent project properties"><topic href="tasks027.htm#sthref311" /></entry> +<entry keyword="project, Modifying persistent project properties"><topic href="tasks028.htm#sthref324" /></entry> </entry> -<entry keyword="Properties - in persistence.xml editor, Properties"><topic href="reference052.htm#sthref580" /></entry> -<entry keyword="property pages, Property pages"><topic href="reference012.htm#sthref400" /></entry> +<entry keyword="Properties - in persistence.xml editor, Properties"><topic href="reference056.htm#sthref607" /></entry> +<entry keyword="property pages, Property pages"><topic href="reference016.htm#sthref425" /></entry> <entry keyword="queries"> -<entry keyword="Queries"><topic href="reference017.htm#sthref416" /></entry> -<entry keyword="Queries"><topic href="reference044.htm#sthref543" /></entry> +<entry keyword="Queries"><topic href="reference021.htm#sthref441" /></entry> +<entry keyword="Queries"><topic href="reference048.htm#sthref570" /></entry> </entry> <entry keyword="query hints"> -<entry keyword="Add Query Dialog"><topic href="tasks009.htm#sthref163" /></entry> -<entry keyword="Queries"><topic href="reference044.htm#sthref548" /></entry> +<entry keyword="Add Query Dialog"><topic href="tasks010.htm#sthref175" /></entry> +<entry keyword="Queries"><topic href="reference048.htm#sthref575" /></entry> </entry> -<entry keyword="Query - in JPA Details view, Queries"><topic href="reference044.htm#sthref544" /></entry> +<entry keyword="Query - in JPA Details view, Queries"><topic href="reference048.htm#sthref571" /></entry> <entry keyword="quick start - Dali, Dali quick start"><topic href="getting_started002.htm#sthref8" /></entry> -<entry keyword="read-only entities, Advanced"><topic href="reference024.htm#sthref458" /></entry> +<entry keyword="read-only entities, Advanced"><topic href="reference028.htm#sthref483" /></entry> <entry keyword="requirements"> <entry keyword="Dali Java Persistence Tools, Requirements and installation"><topic href="getting_started001.htm#sthref4" /></entry> -<entry keyword="persistent entities, Entity"><topic href="tasks002.htm#sthref73" /></entry> +<entry keyword="persistent entities, Entity"><topic href="tasks003.htm#sthref85" /></entry> + </entry> +<entry keyword="Schema Generation - in persistence.xml editor, Schema Generation"><topic href="reference055.htm#sthref605" /></entry> +<entry keyword="schema - database, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref626" /></entry> + <entry keyword="schema - JAXB"> +<entry keyword="Add Schema Location dialog"><topic href="reference074.htm#sthref676" /></entry> +<entry keyword="Select Schema Location dialog"><topic href="reference075.htm#sthref680" /></entry> </entry> -<entry keyword="Schema Generation - in persistence.xml editor, Schema Generation"><topic href="reference051.htm#sthref578" /></entry> -<entry keyword="schema - database, Project Properties page - JPA Options"><topic href="ref_project_properties.htm#sthref599" /></entry> <entry keyword="secondary tables"> -<entry keyword="Specifying additional tables"><topic href="task_additonal_tables.htm#sthref141" /></entry> -<entry keyword="Secondary tables"><topic href="reference022.htm#sthref443" /></entry> - </entry> -<entry keyword="Secondary Tables - in Java Details view, Secondary tables"><topic href="reference022.htm#sthref446" /></entry> -<entry keyword="Select Cascade dialog, Select Cascade dialog"><topic href="ref_select_cascade_dialog.htm#sthref617" /></entry> -<entry keyword="single table inheritance, Specifying entity inheritance"><topic href="task_inheritance.htm#sthref150" /></entry> -<entry keyword="Source - in persistence.xml editor, Source"><topic href="reference053.htm#sthref584" /></entry> -<entry keyword="struct converter, Converters"><topic href="reference023.htm#sthref455" /></entry> -<entry keyword="superclass, Mapped superclass"><topic href="tasks004.htm#sthref92" /></entry> -<entry keyword="synchronizing classes with persistence.xml file, Synchronizing classes"><topic href="tasks006.htm#sthref117" /></entry> +<entry keyword="Specifying additional tables"><topic href="task_additonal_tables.htm#sthref153" /></entry> +<entry keyword="Secondary tables"><topic href="reference026.htm#sthref468" /></entry> + </entry> +<entry keyword="Secondary Tables - in Java Details view, Secondary tables"><topic href="reference026.htm#sthref471" /></entry> +<entry keyword="Select Cascade dialog, Select Cascade dialog"><topic href="ref_select_cascade_dialog.htm#sthref657" /></entry> +<entry keyword="Select Schema Location dialog, Select Schema Location dialog"><topic href="reference075.htm#sthref679" /></entry> +<entry keyword="single table inheritance, Specifying entity inheritance"><topic href="task_inheritance.htm#sthref162" /></entry> +<entry keyword="Source - in persistence.xml editor, Source"><topic href="reference057.htm#sthref611" /></entry> +<entry keyword="struct converter, Converters"><topic href="reference027.htm#sthref480" /></entry> +<entry keyword="superclass, Mapped superclass"><topic href="tasks005.htm#sthref104" /></entry> +<entry keyword="synchronizing classes with persistence.xml file, Synchronizing classes"><topic href="tasks007.htm#sthref129" /></entry> <entry keyword="tables"> <entry keyword="associations"> -<entry keyword="Table Associations"><topic href="ref_tableAssociations.htm#sthref330" /></entry> -<entry keyword="Table Associations"><topic href="reference004.htm#sthref345" /></entry> -<entry keyword="Create New Association wizard"><topic href="ref_create_new_association_wizard.htm#sthref390" /></entry> +<entry keyword="Table Associations"><topic href="ref_tableAssociations.htm#sthref343" /></entry> +<entry keyword="Table Associations"><topic href="reference004.htm#sthref358" /></entry> +<entry keyword="Create New Association wizard"><topic href="ref_create_new_association_wizard.htm#sthref415" /></entry> </entry> -<entry keyword="creating dynamic entities from, Generating dynamic entities from tables"><topic href="tasks023.htm#sthref276" /></entry> +<entry keyword="creating dynamic entities from, Generating dynamic entities from tables"><topic href="tasks024.htm#sthref289" /></entry> <entry keyword="creating entities from"> -<entry keyword="Generating entities from tables"><topic href="tasks021.htm#sthref259" /></entry> -<entry keyword="Select Tables"><topic href="ref_selectTables.htm#sthref327" /></entry> -<entry keyword="Select Tables"><topic href="reference003.htm#sthref342" /></entry> +<entry keyword="Generating entities from tables"><topic href="tasks022.htm#sthref272" /></entry> +<entry keyword="Select Tables"><topic href="ref_selectTables.htm#sthref340" /></entry> +<entry keyword="Select Tables"><topic href="reference003.htm#sthref355" /></entry> </entry> -<entry keyword="creating from entities, Generate Tables from Entities wizard"><topic href="reference010.htm#sthref383" /></entry> -<entry keyword="from entities, Generating tables from entities"><topic href="tasks022.htm#sthref269" /></entry> -<entry keyword="inheritance, Specifying entity inheritance"><topic href="task_inheritance.htm#sthref151" /></entry> +<entry keyword="creating from entities, Generate Tables from Entities wizard"><topic href="reference014.htm#sthref408" /></entry> +<entry keyword="from entities, Generating tables from entities"><topic href="tasks023.htm#sthref282" /></entry> +<entry keyword="inheritance, Specifying entity inheritance"><topic href="task_inheritance.htm#sthref163" /></entry> <entry keyword="secondary"> -<entry keyword="Specifying additional tables"><topic href="task_additonal_tables.htm#sthref140" /></entry> -<entry keyword="Secondary tables"><topic href="reference022.htm#sthref444" /></entry> +<entry keyword="Specifying additional tables"><topic href="task_additonal_tables.htm#sthref152" /></entry> +<entry keyword="Secondary tables"><topic href="reference026.htm#sthref469" /></entry> </entry> </entry> -<entry keyword="temporal, Type information"><topic href="reference035.htm#sthref507" /></entry> -<entry keyword="thread identifier - in logging, Logging"><topic href="reference049.htm#sthref574" /></entry> -<entry keyword="timestamp - in logging, Logging"><topic href="reference049.htm#sthref573" /></entry> -<entry keyword="tracking changes, Advanced"><topic href="reference024.htm#sthref463" /></entry> -<entry keyword="transaction type - persistence unit, Connection"><topic href="reference046.htm#sthref564" /></entry> +<entry keyword="temporal, Type information"><topic href="reference039.htm#sthref534" /></entry> +<entry keyword="thread identifier - in logging, Logging"><topic href="reference053.htm#sthref601" /></entry> +<entry keyword="timestamp - in logging, Logging"><topic href="reference053.htm#sthref600" /></entry> +<entry keyword="tracking changes, Advanced"><topic href="reference028.htm#sthref488" /></entry> +<entry keyword="transaction type - persistence unit, Connection"><topic href="reference050.htm#sthref591" /></entry> <entry keyword="transient mapping"> -<entry keyword="@Transient, Transient mapping"><topic href="tasks019.htm#sthref246" /></entry> -<entry keyword="about, Transient mapping"><topic href="tasks019.htm#sthref244" /></entry> +<entry keyword="@Transient, Transient mapping"><topic href="tasks020.htm#sthref259" /></entry> +<entry keyword="about, Transient mapping"><topic href="tasks020.htm#sthref257" /></entry> </entry> -<entry keyword="type converter, Converters"><topic href="reference023.htm#sthref454" /></entry> -<entry keyword="Type Information - in JPA Details view, Type information"><topic href="reference035.htm#sthref505" /></entry> -<entry keyword="vendor-specific properties, Properties"><topic href="reference052.htm#sthref581" /></entry> +<entry keyword="type converter, Converters"><topic href="reference027.htm#sthref479" /></entry> +<entry keyword="Type Information - in JPA Details view, Type information"><topic href="reference039.htm#sthref532" /></entry> +<entry keyword="vendor-specific properties, Properties"><topic href="reference056.htm#sthref608" /></entry> <entry keyword="version mapping"> -<entry keyword="@Version, Version mapping"><topic href="tasks020.htm#sthref253" /></entry> +<entry keyword="@Version, Version mapping"><topic href="tasks021.htm#sthref266" /></entry> <entry keyword="about"> -<entry keyword="Version mapping"><topic href="tasks020.htm#sthref251" /></entry> -<entry keyword="Version Mapping"><topic href="reference034.htm#sthref502" /></entry> +<entry keyword="Version mapping"><topic href="tasks021.htm#sthref264" /></entry> +<entry keyword="Version Mapping"><topic href="reference038.htm#sthref529" /></entry> </entry> </entry> <entry keyword="views"> <entry keyword="JPA Details view"> -<entry keyword="JPA Details view (for entities)"><topic href="ref_persistence_prop_view.htm#sthref402" /></entry> -<entry keyword="JPA Details view (for attributes)"><topic href="ref_persistence_map_view.htm#sthref468" /></entry> +<entry keyword="JPA Details view (for entities)"><topic href="ref_persistence_prop_view.htm#sthref427" /></entry> +<entry keyword="JPA Details view (for attributes)"><topic href="ref_persistence_map_view.htm#sthref493" /></entry> </entry> -<entry keyword="JPA Structure view, JPA Structure view"><topic href="ref_persistence_outline.htm#sthref554" /></entry> +<entry keyword="JPA Structure view, JPA Structure view"><topic href="ref_persistence_outline.htm#sthref581" /></entry> </entry> -<entry keyword="virtual access type, Generating dynamic entities from tables"><topic href="tasks023.htm#sthref278" /></entry> -<entry keyword="virtual attributes - adding, Adding virtual attributes"><topic href="tasks005.htm#sthref95" /></entry> -<entry keyword="warning messages - Dali, Validating mappings and reporting problems"><topic href="tasks024.htm#sthref285" /></entry> +<entry keyword="virtual access type, Generating dynamic entities from tables"><topic href="tasks024.htm#sthref291" /></entry> +<entry keyword="virtual attributes - adding, Adding virtual attributes"><topic href="tasks006.htm#sthref107" /></entry> +<entry keyword="warning messages - Dali, Validating mappings and reporting problems"><topic href="tasks025.htm#sthref298" /></entry> <entry keyword="weaving"> -<entry keyword="EclipseLink, Project Properties page - EclipseLink"><topic href="reference057.htm#sthref605" /></entry> +<entry keyword="EclipseLink, Project Properties page - EclipseLink"><topic href="reference061.htm#sthref632" /></entry> </entry> <entry keyword="Web Tools Platform (WTP), Requirements and installation"><topic href="getting_started001.htm#sthref5" /></entry> -<entry keyword="wizards, Wizards"><topic href="reference001.htm#sthref323" /></entry> -<entry keyword="XML editor, Working with orm.xml file"><topic href="tasks008.htm#sthref134" /></entry> -<entry keyword="XML - project metatdata, Converting JPA metadata to XML"><topic href="tasks028.htm#sthref319" /></entry> -<entry keyword="XMLPath, Tips and tricks"><topic href="tips_and_tricks.htm#sthref648" /></entry> +<entry keyword="wizards, Wizards"><topic href="reference001.htm#sthref336" /></entry> +<entry keyword="XML editor, Working with orm.xml file"><topic href="tasks009.htm#sthref146" /></entry> +<entry keyword="XML - project metatdata, Converting JPA metadata to XML"><topic href="tasks029.htm#sthref332" /></entry> +<entry keyword="XMLPath, Tips and tricks"><topic href="tips_and_tricks.htm#sthref696" /></entry> </index>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/legal.htm b/jpa/plugins/org.eclipse.jpt.doc.user/legal.htm index d55fbdfd02..344af5687f 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/legal.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/legal.htm @@ -8,7 +8,7 @@ <title>Legal</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:45Z" /> +<meta name="date" content="2012-09-19T13:28:3Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content=" Legal" /> <meta name="relnum" content="Release 3.2" /> @@ -17,8 +17,8 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p><a id="sthref649" name="sthref649"></a></p> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p><a id="sthref697" name="sthref697"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <h1>Legal</h1> <p>Copyright © 2011, 2012, Oracle. All rights reserved.</p> <p>This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at:</p> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_EntityClassPage.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_EntityClassPage.htm index 437d4a2f4f..8860cd3aae 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_EntityClassPage.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_EntityClassPage.htm @@ -8,7 +8,7 @@ <title>Entity Class page</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Entity Class page" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAFEIGF" name="CIAFEIGF"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Entity Class page</h1> @@ -84,7 +84,7 @@ </tr> <tr align="left" valign="top"> <td align="left" id="r7c1-t10" headers="r1c1-t10"> -<p><a id="sthref356" name="sthref356"></a>Inheritance</p> +<p><a id="sthref369" name="sthref369"></a>Inheritance</p> </td> <td align="left" headers="r7c1-t10 r1c2-t10"> <p>Because the wizard creates a Java class with an <code>@Entity</code> notation, the <span class="bold">Entity</span> option is selected by default.</p> @@ -108,7 +108,7 @@ </tr> <tr align="left" valign="top"> <td align="left" id="r8c1-t10" headers="r1c1-t10"> -<p><a id="sthref357" name="sthref357"></a>XML Entity Mappings</p> +<p><a id="sthref370" name="sthref370"></a>XML Entity Mappings</p> </td> <td align="left" headers="r8c1-t10 r1c2-t10"> <p>Select <span class="bold">Add to entity mappings in XML</span> to create XML mappings in <code>orm.xml</code>, rather than annotations.</p> @@ -120,14 +120,14 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref358" name="sthref358"></a> +<a id="sthref371" name="sthref371"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_create_new_project.htm#CIHHEJCJ">Creating a new JPA project</a></p> </li> </ul> -<a id="sthref359" name="sthref359"></a> +<a id="sthref372" name="sthref372"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_EntityPropertiesPage.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_EntityPropertiesPage.htm index ab7a4bed86..717c7b1f61 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_EntityPropertiesPage.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_EntityPropertiesPage.htm @@ -8,7 +8,7 @@ <title>Entity Properties page</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Entity Properties page" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIADECIA" name="CIADECIA"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Entity Properties page</h1> @@ -89,7 +89,7 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref360" name="sthref360"></a> +<a id="sthref373" name="sthref373"></a> <p class="subhead2">Related tasks</p> <ul> <li> @@ -99,7 +99,7 @@ <p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> </ul> -<a id="sthref361" name="sthref361"></a> +<a id="sthref374" name="sthref374"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_add_converter.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_add_converter.htm index 2fddfc005f..8ac65c3aa0 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_add_converter.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_add_converter.htm @@ -8,7 +8,7 @@ <title>Add Converter dialog</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Add Converter dialog" /> <meta name="relnum" content="Release 3.2" /> @@ -17,35 +17,35 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAGCGIJ" name="CIAGCGIJ"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>Add Converter dialog</h1> -<p><a id="sthref622" name="sthref622"></a>Use this dialog to create a new EclipseLink converter.</p> +<p><a id="sthref662" name="sthref662"></a>Use this dialog to create a new EclipseLink converter.</p> <div class="inftblhruleinformal"> <table class="HRuleInformal" summary="This table lists the options on the New EclipseLink Mapping File dialog." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="24%" /> <col width="*" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t70">Property</th> -<th align="left" valign="bottom" id="r1c2-t70">Description</th> +<th align="left" valign="bottom" id="r1c1-t75">Property</th> +<th align="left" valign="bottom" id="r1c2-t75">Description</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t70" headers="r1c1-t70"> +<td align="left" id="r2c1-t75" headers="r1c1-t75"> <p>Name</p> </td> -<td align="left" headers="r2c1-t70 r1c2-t70"> +<td align="left" headers="r2c1-t75 r1c2-t75"> <p>Enter the name for this converter</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t70" headers="r1c1-t70"> +<td align="left" id="r3c1-t75" headers="r1c1-t75"> <p>Type</p> </td> -<td align="left" headers="r3c1-t70 r1c2-t70"> +<td align="left" headers="r3c1-t75 r1c2-t75"> <p>Select the converter type:</p> <ul> <li> @@ -67,11 +67,11 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref623" name="sthref623"></a> +<a id="sthref663" name="sthref663"></a> <p class="subhead2">Related reference</p> <ul> <li> -<p><a href="reference023.htm#CACJGDAJ">Converters</a></p> +<p><a href="reference027.htm#CACJGDAJ">Converters</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_association_cardinality.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_association_cardinality.htm index cbe8a130b6..a44abdeb7c 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_association_cardinality.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_association_cardinality.htm @@ -8,7 +8,7 @@ <title>Association Cardinality</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Association Cardinality" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAFIIFH" name="CIAFIIFH"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Association Cardinality</h1> -<p><a id="sthref397" name="sthref397"></a>Use this dialog to specify cardinality of an association table. Depending on the <span class="bold">Association Kind</span> and <span class="bold">Join Columns</span> that you selected previously, some associations may not be available.</p> +<p><a id="sthref422" name="sthref422"></a>Use this dialog to specify cardinality of an association table. Depending on the <span class="bold">Association Kind</span> and <span class="bold">Join Columns</span> that you selected previously, some associations may not be available.</p> <ul> <li> <p>Many to one</p> @@ -36,20 +36,20 @@ <p>Many to many</p> </li> </ul> -<a id="sthref398" name="sthref398"></a> +<a id="sthref423" name="sthref423"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="ref_create_new_association_wizard.htm#CIAFGHIF">Create New Association wizard</a></p> </li> <li> -<p><a href="tasks021.htm#BABBAGFI">Generating entities from tables</a></p> +<p><a href="tasks022.htm#BABBAGFI">Generating entities from tables</a></p> </li> <li> <p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> </ul> -<a id="sthref399" name="sthref399"></a> +<a id="sthref424" name="sthref424"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_association_table.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_association_table.htm index 53e3e00e5d..ff800af1c8 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_association_table.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_association_table.htm @@ -8,7 +8,7 @@ <title>Association Tables</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Association Tables" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAGJHDC" name="CIAGJHDC"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Association Tables</h1> @@ -28,24 +28,24 @@ <col width="*" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t19">Property</th> -<th align="left" valign="bottom" id="r1c2-t19">Description</th> +<th align="left" valign="bottom" id="r1c1-t22">Property</th> +<th align="left" valign="bottom" id="r1c2-t22">Description</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t19" headers="r1c1-t19"> +<td align="left" id="r2c1-t22" headers="r1c1-t22"> <p>Association kind</p> </td> -<td align="left" headers="r2c1-t19 r1c2-t19"> +<td align="left" headers="r2c1-t22 r1c2-t22"> <p>Specify if the association is <span class="bold">Simple</span> (1:M) or <span class="bold">Many to Many</span> (M:M).</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t19" headers="r1c1-t19"> +<td align="left" id="r3c1-t22" headers="r1c1-t22"> <p>Association tables</p> </td> -<td align="left" headers="r3c1-t19 r1c2-t19"> +<td align="left" headers="r3c1-t22 r1c2-t22"> <p>Click <span class="bold">Table Selection</span>, then select the two tables to associate.</p> <p>When creating a <span class="bold">Many to Many</span> association, you can select a <span class="bold">Join Table</span> for the association.</p> </td> @@ -54,20 +54,20 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref392" name="sthref392"></a> +<a id="sthref417" name="sthref417"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="ref_create_new_association_wizard.htm#CIAFGHIF">Create New Association wizard</a></p> </li> <li> -<p><a href="tasks021.htm#BABBAGFI">Generating entities from tables</a></p> +<p><a href="tasks022.htm#BABBAGFI">Generating entities from tables</a></p> </li> <li> <p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> </ul> -<a id="sthref393" name="sthref393"></a> +<a id="sthref418" name="sthref418"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_create_custom_entities_wizard.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_create_custom_entities_wizard.htm index e5efb5e9f6..2a7103ff3f 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_create_custom_entities_wizard.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_create_custom_entities_wizard.htm @@ -8,7 +8,7 @@ <title>Generate Entities from Tables wizard</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Generate Entities from Tables wizard" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAGBFJE" name="CIAGBFJE"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>Generate Entities from Tables wizard</h1> -<p><a id="sthref324" name="sthref324"></a>Use the Generate Custom Entities Wizard to create JPA entities from your database tables.</p> +<p><a id="sthref337" name="sthref337"></a>Use the Generate Custom Entities Wizard to create JPA entities from your database tables.</p> <p>The wizard consists of the following pages:</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_create_jpa_entity_wizard.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_create_jpa_entity_wizard.htm index f5d0997ac9..5c7adab8b7 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_create_jpa_entity_wizard.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_create_jpa_entity_wizard.htm @@ -8,7 +8,7 @@ <title>Create JPA Entity wizard</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Create JPA Entity wizard" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAGGGDF" name="CIAGGGDF"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>Create JPA Entity wizard</h1> -<p><a id="sthref354" name="sthref354"></a><a id="sthref355" name="sthref355"></a>The Create JPA wizard enables you to quickly add an entity and also add persistence fields to that entity. In addition, this wizard adds the accessor methods (<code>getter</code> and <code>setter</code>) in the class file. The wizard consists of the following pages:</p> +<p><a id="sthref367" name="sthref367"></a><a id="sthref368" name="sthref368"></a>The Create JPA wizard enables you to quickly add an entity and also add persistence fields to that entity. In addition, this wizard adds the accessor methods (<code>getter</code> and <code>setter</code>) in the class file. The wizard consists of the following pages:</p> <ul> <li> <p><a href="ref_EntityClassPage.htm#CIAFEIGF">Entity Class page</a></p> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_create_new_association_wizard.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_create_new_association_wizard.htm index c55354a5a2..2ed5aaef62 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_create_new_association_wizard.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_create_new_association_wizard.htm @@ -8,7 +8,7 @@ <title>Create New Association wizard</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Create New Association wizard" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAFGHIF" name="CIAFGHIF"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>Create New Association wizard</h1> -<p><a id="sthref389" name="sthref389"></a><a id="sthref390" name="sthref390"></a><a id="sthref391" name="sthref391"></a>Use the Create New Association wizard to specify association tables when generating an entity.</p> +<p><a id="sthref414" name="sthref414"></a><a id="sthref415" name="sthref415"></a><a id="sthref416" name="sthref416"></a>Use the Create New Association wizard to specify association tables when generating an entity.</p> <p>The wizard consists of the following pages:</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_customizIndividualEntities.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_customizIndividualEntities.htm index 8d22303405..e37c975f89 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_customizIndividualEntities.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_customizIndividualEntities.htm @@ -8,7 +8,7 @@ <title>Customize Individual Entities</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Customize Individual Entities" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIACIGEE" name="CIACIGEE"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Customize Individual Entities</h1> -<p><a id="sthref336" name="sthref336"></a>Use this page to customize each generated entity. Select an item in the <span class="bold">Table and columns</span> area, then complete the following fields for each item.</p> +<p><a id="sthref349" name="sthref349"></a>Use this page to customize each generated entity. Select an item in the <span class="bold">Table and columns</span> area, then complete the following fields for each item.</p> <div class="inftblhruleinformal"> <table class="HRuleInformal" title="Options on the Customize Entities page of the Generate Entities from Tables wizard" summary="Options on the Customize Entities page of the Generate Entities from Tables wizard" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="32%" /> @@ -138,20 +138,20 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref337" name="sthref337"></a> +<a id="sthref350" name="sthref350"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> </li> <li> -<p><a href="tasks021.htm#BABBAGFI">Generating entities from tables</a></p> +<p><a href="tasks022.htm#BABBAGFI">Generating entities from tables</a></p> </li> <li> <p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> </ul> -<a id="sthref338" name="sthref338"></a> +<a id="sthref351" name="sthref351"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_customizeDefaultEntityGeneration.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_customizeDefaultEntityGeneration.htm index c34578b545..41e006d495 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_customizeDefaultEntityGeneration.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_customizeDefaultEntityGeneration.htm @@ -8,7 +8,7 @@ <title>Customize Default Entity Generation</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Customize Default Entity Generation" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAEJDBE" name="CIAEJDBE"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Customize Default Entity Generation</h1> -<p><a id="sthref333" name="sthref333"></a>Use this page to specify the default information Dali will use when generating the entities from the database tables. You will be able to override this information for specific entities.</p> +<p><a id="sthref346" name="sthref346"></a>Use this page to specify the default information Dali will use when generating the entities from the database tables. You will be able to override this information for specific entities.</p> <div class="inftblhruleinformal"> <table class="HRuleInformal" title="Options on the Customize Defautl Entity page of the Generate Entities from Tables wizard" summary="Options on the Customize Defautl Entity page of the Generate Entities from Tables wizard" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="32%" /> @@ -102,20 +102,20 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref334" name="sthref334"></a> +<a id="sthref347" name="sthref347"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> </li> <li> -<p><a href="tasks021.htm#BABBAGFI">Generating entities from tables</a></p> +<p><a href="tasks022.htm#BABBAGFI">Generating entities from tables</a></p> </li> <li> <p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> </ul> -<a id="sthref335" name="sthref335"></a> +<a id="sthref348" name="sthref348"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_details_orm.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_details_orm.htm index 7a44e7c811..9979d20e16 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_details_orm.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_details_orm.htm @@ -8,7 +8,7 @@ <title>JPA Details view (for orm.xml)</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="JPA Details view (for orm.xml)" /> <meta name="relnum" content="Release 3.2" /> @@ -17,26 +17,26 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CACGDGHC" name="CACGDGHC"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>JPA Details view (for orm.xml)</h1> -<p><a id="sthref531" name="sthref531"></a><a id="sthref532" name="sthref532"></a>The <span class="gui-object-title">JPA Details</span> view displays the default mapping and persistence information for the project and contains the following areas:</p> +<p><a id="sthref558" name="sthref558"></a><a id="sthref559" name="sthref559"></a>The <span class="gui-object-title">JPA Details</span> view displays the default mapping and persistence information for the project and contains the following areas:</p> <ul> <li> -<p><a href="reference041.htm#CACCACGH">Entity Mappings</a></p> +<p><a href="reference045.htm#CACCACGH">Entity Mappings</a></p> </li> <li> -<p><a href="reference042.htm#CACEAGBG">Persistence Unit</a></p> +<p><a href="reference046.htm#CACEAGBG">Persistence Unit</a></p> </li> <li> -<p><a href="reference043.htm#CIAFGAIJ">Generators</a></p> +<p><a href="reference047.htm#CIAFGAIJ">Generators</a></p> </li> <li> -<p><a href="reference044.htm#CIAIBAAJ">Queries</a></p> +<p><a href="reference048.htm#CIAIBAAJ">Queries</a></p> </li> <li> -<p><a href="reference045.htm#CIADGCID">Converters</a> (when using EclipseLink)</p> +<p><a href="reference049.htm#CIADGCID">Converters</a> (when using EclipseLink)</p> </li> </ul> <p>These defaults can be overridden by the settings on a specific entity or mapping.</p> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_eclipselink_mapping_file.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_eclipselink_mapping_file.htm index d96df8f7cb..df3bf76720 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_eclipselink_mapping_file.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_eclipselink_mapping_file.htm @@ -8,7 +8,7 @@ <title>New EclipseLink Mapping File dialog</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="New EclipseLink Mapping File dialog" /> <meta name="relnum" content="Release 3.2" /> @@ -17,67 +17,67 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAEDEJF" name="CIAEDEJF"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>New EclipseLink Mapping File dialog</h1> -<p><a id="sthref618" name="sthref618"></a><a id="sthref619" name="sthref619"></a><a id="sthref620" name="sthref620"></a>Specify the location and properties of the EclipseLink mapping file (<code>eclipselink-orm.xml</code>).</p> +<p><a id="sthref658" name="sthref658"></a><a id="sthref659" name="sthref659"></a><a id="sthref660" name="sthref660"></a>Specify the location and properties of the EclipseLink mapping file (<code>eclipselink-orm.xml</code>).</p> <div class="inftblhruleinformal"> <table class="HRuleInformal" summary="This table lists the options on the New EclipseLink Mapping File dialog." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="24%" /> <col width="*" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t69">Property</th> -<th align="left" valign="bottom" id="r1c2-t69">Description</th> +<th align="left" valign="bottom" id="r1c1-t74">Property</th> +<th align="left" valign="bottom" id="r1c2-t74">Description</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t69" headers="r1c1-t69"> +<td align="left" id="r2c1-t74" headers="r1c1-t74"> <p>Project</p> </td> -<td align="left" headers="r2c1-t69 r1c2-t69"> +<td align="left" headers="r2c1-t74 r1c2-t74"> <p>Select the project in which to add the mapping file.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t69" headers="r1c1-t69"> +<td align="left" id="r3c1-t74" headers="r1c1-t74"> <p>Source folder</p> </td> -<td align="left" headers="r3c1-t69 r1c2-t69"> +<td align="left" headers="r3c1-t74 r1c2-t74"> <p>Click <span class="bold">Browse</span> and select the source file in which to add the mapping file. The default is <code>../</code><code><span class="codeinlineitalic"><PROJECT></span></code><code>/src</code>.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t69" headers="r1c1-t69"> +<td align="left" id="r4c1-t74" headers="r1c1-t74"> <p>File path</p> </td> -<td align="left" headers="r4c1-t69 r1c2-t69"> +<td align="left" headers="r4c1-t74 r1c2-t74"> <p>Enter the filename and path of the mapping file. The default is <code>META-INF/eclipselink-orm.xml</code>.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t69" headers="r1c1-t69"> +<td align="left" id="r5c1-t74" headers="r1c1-t74"> <p>Default access</p> </td> -<td align="left" headers="r5c1-t69 r1c2-t69"> +<td align="left" headers="r5c1-t74 r1c2-t74"> <p>Select whether the entity's access to instance variables is <span class="bold">field</span>-based or <span class="bold">property</span>-based, as defined in the JPA specification.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t69" headers="r1c1-t69"> +<td align="left" id="r6c1-t74" headers="r1c1-t74"> <p>Add to persistence unit</p> </td> -<td align="left" headers="r6c1-t69 r1c2-t69"> +<td align="left" headers="r6c1-t74 r1c2-t74"> <p>Specify if this mapping file should be added to the persistence unit (<code>persistence.xml</code>).</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r7c1-t69" headers="r1c1-t69"> +<td align="left" id="r7c1-t74" headers="r1c1-t74"> <p> Persistence Unit</p> </td> -<td align="left" headers="r7c1-t69 r1c2-t69"> +<td align="left" headers="r7c1-t74 r1c2-t74"> <p>Select the persistence unit in which to add the mapping file.</p> </td> </tr> @@ -85,7 +85,7 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref621" name="sthref621"></a> +<a id="sthref661" name="sthref661"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_java_page.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_java_page.htm index 194369bfed..0df55b4fb1 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_java_page.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_java_page.htm @@ -8,7 +8,7 @@ <title>Java Page</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Java Page" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAGEBAA" name="CIAGEBAA"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Java Page</h1> @@ -61,14 +61,14 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref374" name="sthref374"></a> +<a id="sthref387" name="sthref387"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_create_new_project.htm#CIHHEJCJ">Creating a new JPA project</a></p> </li> </ul> -<a id="sthref375" name="sthref375"></a> +<a id="sthref388" name="sthref388"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_join_columns.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_join_columns.htm index 765aeeb020..022b2d579b 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_join_columns.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_join_columns.htm @@ -8,7 +8,7 @@ <title>Join Columns</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Join Columns" /> <meta name="relnum" content="Release 3.2" /> @@ -17,26 +17,26 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAEGEEG" name="CIAEGEEG"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Join Columns</h1> -<p><a id="sthref394" name="sthref394"></a>Use this dialog to specify the join columns of an association table.</p> +<p><a id="sthref419" name="sthref419"></a>Use this dialog to specify the join columns of an association table.</p> <p>Click Add to specify the join columns between the two tables.</p> -<a id="sthref395" name="sthref395"></a> +<a id="sthref420" name="sthref420"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="ref_create_new_association_wizard.htm#CIAFGHIF">Create New Association wizard</a></p> </li> <li> -<p><a href="tasks021.htm#BABBAGFI">Generating entities from tables</a></p> +<p><a href="tasks022.htm#BABBAGFI">Generating entities from tables</a></p> </li> <li> <p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> </ul> -<a id="sthref396" name="sthref396"></a> +<a id="sthref421" name="sthref421"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_jpa_facet.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_jpa_facet.htm index 30cfc38b4c..820efc2a12 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_jpa_facet.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_jpa_facet.htm @@ -8,7 +8,7 @@ <title>JPA Facet page</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="JPA Facet page" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CACIFDIF" name="CACIFDIF"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>JPA Facet page</h1> @@ -48,7 +48,7 @@ </tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t16" headers="r1c1-t16"> -<p><a id="sthref376" name="sthref376"></a><a id="sthref377" name="sthref377"></a><span class="bold">JPA Implementation</span></p> +<p><a id="sthref389" name="sthref389"></a><a id="sthref390" name="sthref390"></a><span class="bold">JPA Implementation</span></p> </td> <td align="left" headers="r3c1-t16 r1c2-t16"> <p>Select a specific JPA library configuration.</p> @@ -113,7 +113,7 @@ </tr> <tr align="left" valign="top"> <td align="left" id="r9c1-t16" headers="r1c1-t16"> -<p><a id="sthref378" name="sthref378"></a><span class="bold">Persistent class management</span></p> +<p><a id="sthref391" name="sthref391"></a><span class="bold">Persistent class management</span></p> </td> <td align="left" headers="r9c1-t16 r1c2-t16"> <p>Specify if Dali will <span class="bold">discover annotated classes automatically</span>, or if the <span class="bold">annotated classes must be listed in the persistence.xml</span> file.</p> @@ -125,7 +125,7 @@ </tr> <tr align="left" valign="top"> <td align="left" id="r10c1-t16" headers="r1c1-t16"> -<p><a id="sthref379" name="sthref379"></a><span class="bold">Create mapping file (orm.xml)</span></p> +<p><a id="sthref392" name="sthref392"></a><span class="bold">Create mapping file (orm.xml)</span></p> </td> <td align="left" headers="r10c1-t16 r1c2-t16"> <p>Specify if Dali should create a default <code>orm.xml</code> file for your entity mappings and persistence unit defaults.</p> @@ -138,14 +138,14 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref380" name="sthref380"></a> +<a id="sthref393" name="sthref393"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_create_new_project.htm#CIHHEJCJ">Creating a new JPA project</a></p> </li> </ul> -<a id="sthref381" name="sthref381"></a> +<a id="sthref394" name="sthref394"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project.htm index ba2f75bee0..71ff0de8e4 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project.htm @@ -8,7 +8,7 @@ <title>New JPA Project page</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="New JPA Project page" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CACBJAGC" name="CACBJAGC"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>New JPA Project page</h1> @@ -113,14 +113,14 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref372" name="sthref372"></a> +<a id="sthref385" name="sthref385"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_create_new_project.htm#CIHHEJCJ">Creating a new JPA project</a></p> </li> </ul> -<a id="sthref373" name="sthref373"></a> +<a id="sthref386" name="sthref386"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project_wizard.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project_wizard.htm index 3e52c780e1..618bb9f944 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project_wizard.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_new_jpa_project_wizard.htm @@ -8,7 +8,7 @@ <title>Create New JPA Project wizard</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Create New JPA Project wizard" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CACBJGBG" name="CACBJGBG"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>Create New JPA Project wizard</h1> -<p><a id="sthref369" name="sthref369"></a><a id="sthref370" name="sthref370"></a><a id="sthref371" name="sthref371"></a>The Create New JPA Project wizard allows you to create a new Java project using JPA. The wizard consists of the following pages:</p> +<p><a id="sthref382" name="sthref382"></a><a id="sthref383" name="sthref383"></a><a id="sthref384" name="sthref384"></a>The Create New JPA Project wizard allows you to create a new Java project using JPA. The wizard consists of the following pages:</p> <ul> <li> <p><a href="ref_new_jpa_project.htm#CACBJAGC">New JPA Project page</a></p> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_general.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_general.htm index 28f90979da..99f6613bf7 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_general.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_general.htm @@ -8,7 +8,7 @@ <title>General</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="General" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIACIFGJ" name="CIACIFGJ"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>General</h1> -<p><a id="sthref559" name="sthref559"></a>The following table lists properties available in the General page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> +<p><a id="sthref586" name="sthref586"></a>The following table lists properties available in the General page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> <div class="inftblhruleinformal"> <table class="HRuleInformal" summary="The following table lists properties available in the General page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="24%" /> @@ -29,128 +29,128 @@ <col width="24%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t49">Property</th> -<th align="left" valign="bottom" id="r1c2-t49">Description</th> -<th align="left" valign="bottom" id="r1c3-t49">Default</th> +<th align="left" valign="bottom" id="r1c1-t52">Property</th> +<th align="left" valign="bottom" id="r1c2-t52">Description</th> +<th align="left" valign="bottom" id="r1c3-t52">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t49" headers="r1c1-t49"> +<td align="left" id="r2c1-t52" headers="r1c1-t52"> <p><span class="bold">General</span></p> </td> -<td align="left" headers="r2c1-t49 r1c2-t49"><br /></td> -<td align="left" headers="r2c1-t49 r1c3-t49"><br /></td> +<td align="left" headers="r2c1-t52 r1c2-t52"><br /></td> +<td align="left" headers="r2c1-t52 r1c3-t52"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t49" headers="r1c1-t49"> +<td align="left" id="r3c1-t52" headers="r1c1-t52"> <p>Name</p> </td> -<td align="left" headers="r3c1-t49 r1c2-t49"> +<td align="left" headers="r3c1-t52 r1c2-t52"> <p>Enter the name of the persistence unit.</p> <p>Defines the <code><persistence-unit name></code> element.</p> </td> -<td align="left" headers="r3c1-t49 r1c3-t49"> +<td align="left" headers="r3c1-t52 r1c3-t52"> <p>The project name</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t49" headers="r1c1-t49"> -<p><a id="sthref560" name="sthref560"></a>Persistence provider</p> +<td align="left" id="r4c1-t52" headers="r1c1-t52"> +<p><a id="sthref587" name="sthref587"></a>Persistence provider</p> </td> -<td align="left" headers="r4c1-t49 r1c2-t49"> +<td align="left" headers="r4c1-t52 r1c2-t52"> <p>Enter the name of the persistence provider.</p> <p>Defines the <code><provider></code> element.</p> </td> -<td align="left" headers="r4c1-t49 r1c3-t49"> +<td align="left" headers="r4c1-t52 r1c3-t52"> <p>Determined by the server</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t49" headers="r1c1-t49"> +<td align="left" id="r5c1-t52" headers="r1c1-t52"> <p>Description</p> </td> -<td align="left" headers="r5c1-t49 r1c2-t49"> +<td align="left" headers="r5c1-t52 r1c2-t52"> <p>Enter a description for this persistence unit. This is an optional property.</p> <p>Defines the <code><description></code> element.</p> </td> -<td align="left" headers="r5c1-t49 r1c3-t49"><br /></td> +<td align="left" headers="r5c1-t52 r1c3-t52"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t49" headers="r1c1-t49"> -<p><a id="sthref561" name="sthref561"></a><span class="bold">Managed Classes</span></p> +<td align="left" id="r6c1-t52" headers="r1c1-t52"> +<p><a id="sthref588" name="sthref588"></a><span class="bold">Managed Classes</span></p> </td> -<td align="left" headers="r6c1-t49 r1c2-t49"><br /></td> -<td align="left" headers="r6c1-t49 r1c3-t49"><br /></td> +<td align="left" headers="r6c1-t52 r1c2-t52"><br /></td> +<td align="left" headers="r6c1-t52 r1c3-t52"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r7c1-t49" headers="r1c1-t49"> +<td align="left" id="r7c1-t52" headers="r1c1-t52"> <p>Classes</p> </td> -<td align="left" headers="r7c1-t49 r1c2-t49"> +<td align="left" headers="r7c1-t52 r1c2-t52"> <p>Click <span class="bold">Add</span> to add a new class, or select an existing class and click <span class="bold">Remove</span>, to add or remove the classes managed through the persistence unit.</p> <p>Defines the <code><class></code> element.</p> <p>Select a class and click <span class="bold">Open</span> to modify the class in the editor.</p> </td> -<td align="left" headers="r7c1-t49 r1c3-t49"><br /></td> +<td align="left" headers="r7c1-t52 r1c3-t52"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r8c1-t49" headers="r1c1-t49"> +<td align="left" id="r8c1-t52" headers="r1c1-t52"> <p>Exclude Unlisted Classes</p> </td> -<td align="left" headers="r8c1-t49 r1c2-t49"> +<td align="left" headers="r8c1-t52 r1c2-t52"> <p>Select to include all annotated entity classes in the root of the persistence unit.</p> <p>Defines the <code><exclude-unlisted-classes></code> element.</p> </td> -<td align="left" headers="r8c1-t49 r1c3-t49"> +<td align="left" headers="r8c1-t52 r1c3-t52"> <p>False</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r9c1-t49" headers="r1c1-t49"> -<p><a id="sthref562" name="sthref562"></a><span class="bold">XML Mapping Files</span></p> +<td align="left" id="r9c1-t52" headers="r1c1-t52"> +<p><a id="sthref589" name="sthref589"></a><span class="bold">XML Mapping Files</span></p> </td> -<td align="left" headers="r9c1-t49 r1c2-t49"><br /></td> -<td align="left" headers="r9c1-t49 r1c3-t49"><br /></td> +<td align="left" headers="r9c1-t52 r1c2-t52"><br /></td> +<td align="left" headers="r9c1-t52 r1c3-t52"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r10c1-t49" headers="r1c1-t49"> +<td align="left" id="r10c1-t52" headers="r1c1-t52"> <p>Files</p> </td> -<td align="left" headers="r10c1-t49 r1c2-t49"> +<td align="left" headers="r10c1-t52 r1c2-t52"> <p>Click <span class="bold">Add</span> to select an XML mapping file, or select an existing file and click <span class="bold">Remove</span>, to add or remove an object/relational mapping XML files that define the classes to be managed by the persistence unit.</p> <p>Defines the <code><mapping-file></code> element.</p> </td> -<td align="left" headers="r10c1-t49 r1c3-t49"> +<td align="left" headers="r10c1-t52 r1c3-t52"> <p><code>Meta-INF\orm.xml</code></p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r11c1-t49" headers="r1c1-t49"> +<td align="left" id="r11c1-t52" headers="r1c1-t52"> <p>Exclude unlisted EclipseLink XML mapping file</p> </td> -<td align="left" headers="r11c1-t49 r1c2-t49"> +<td align="left" headers="r11c1-t52 r1c2-t52"> <p>Select to include all annotated EclipseLink mapping files. Defines the <code>eclipselink.exclude-eclipselink-orm property</code> element.<span class="bold">Note</span>: This field applies only when using EclipseLink JPA implementation</p> </td> -<td align="left" headers="r11c1-t49 r1c3-t49"> +<td align="left" headers="r11c1-t52 r1c3-t52"> <p>False</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r12c1-t49" headers="r1c1-t49"> +<td align="left" id="r12c1-t52" headers="r1c1-t52"> <p><span class="bold">JAR Files</span></p> </td> -<td align="left" headers="r12c1-t49 r1c2-t49"><br /></td> -<td align="left" headers="r12c1-t49 r1c3-t49"><br /></td> +<td align="left" headers="r12c1-t52 r1c2-t52"><br /></td> +<td align="left" headers="r12c1-t52 r1c3-t52"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r13c1-t49" headers="r1c1-t49"> +<td align="left" id="r13c1-t52" headers="r1c1-t52"> <p>Files</p> </td> -<td align="left" headers="r13c1-t49 r1c2-t49"> +<td align="left" headers="r13c1-t52 r1c2-t52"> <p>Click <span class="bold">Add</span> to select a JAR file, or select an existing file and click <span class="bold">Remove</span>, to add or remove JAR files and libraries in the persistence unit.</p> </td> -<td align="left" headers="r13c1-t49 r1c3-t49"><br /></td> +<td align="left" headers="r13c1-t52 r1c3-t52"><br /></td> </tr> </tbody> </table> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_map_view.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_map_view.htm index 8cd913dd2f..ee7c089eb1 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_map_view.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_map_view.htm @@ -8,7 +8,7 @@ <title>JPA Details view (for attributes)</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="JPA Details view (for attributes)" /> <meta name="relnum" content="Release 3.2" /> @@ -17,66 +17,66 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABIFBAF" name="BABIFBAF"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>JPA Details view (for attributes)</h1> -<p><a id="sthref467" name="sthref467"></a><a id="sthref468" name="sthref468"></a><a id="sthref469" name="sthref469"></a><a id="sthref470" name="sthref470"></a>The <span class="gui-object-title">JPA Details</span> view displays the persistence information for the currently selected mapped attribute and contains the following areas:</p> -<a id="sthref471" name="sthref471"></a> +<p><a id="sthref492" name="sthref492"></a><a id="sthref493" name="sthref493"></a><a id="sthref494" name="sthref494"></a><a id="sthref495" name="sthref495"></a><a id="sthref496" name="sthref496"></a><a id="sthref497" name="sthref497"></a>The <span class="gui-object-title">JPA Details</span> view displays the persistence information for the currently selected mapped attribute and contains the following areas:</p> +<a id="sthref498" name="sthref498"></a> <p class="subhead2">Mapping Type</p> <ul> <li> -<p><a href="reference025.htm#CACCGGCG">Basic Mapping</a></p> +<p><a href="reference029.htm#CACCGGCG">Basic Mapping</a></p> </li> <li> -<p><a href="reference026.htm#CACBCGDI">Element Collection Mapping</a></p> +<p><a href="reference030.htm#CACBCGDI">Element Collection Mapping</a></p> </li> <li> -<p><a href="reference027.htm#CACBJBFD">Embedded Mapping</a></p> +<p><a href="reference031.htm#CACBJBFD">Embedded Mapping</a></p> </li> <li> -<p><a href="reference028.htm#CACDIDIA">Embedded ID Mapping</a></p> +<p><a href="reference032.htm#CACDIDIA">Embedded ID Mapping</a></p> </li> <li> -<p><a href="reference029.htm#CACIAEFI">ID Mapping</a></p> +<p><a href="reference033.htm#CACIAEFI">ID Mapping</a></p> </li> <li> -<p><a href="reference030.htm#CACIHGCE">Many-to-Many Mapping</a></p> +<p><a href="reference034.htm#CACIHGCE">Many-to-Many Mapping</a></p> </li> <li> -<p><a href="reference031.htm#CACHAEDB">Many-to-One Mapping</a></p> +<p><a href="reference035.htm#CACHAEDB">Many-to-One Mapping</a></p> </li> <li> -<p><a href="reference032.htm#CACHGGHH">One-to-Many Mapping</a></p> +<p><a href="reference036.htm#CACHGGHH">One-to-Many Mapping</a></p> </li> <li> -<p><a href="reference033.htm#CACGGHDD">One-to-One Mapping</a></p> +<p><a href="reference037.htm#CACGGHDD">One-to-One Mapping</a></p> </li> <li> -<p><a href="reference034.htm#CACHAEBB">Version Mapping</a></p> +<p><a href="reference038.htm#CACHAEBB">Version Mapping</a></p> </li> </ul> -<a id="sthref472" name="sthref472"></a> +<a id="sthref499" name="sthref499"></a> <p class="subhead2">Additional Information</p> <p>Depending on the mapping type, the following additional areas will be available:</p> <ul> <li> -<p><a href="reference036.htm#CACJBFEA">Value</a></p> +<p><a href="reference040.htm#CACJBFEA">Value</a></p> </li> <li> -<p><a href="reference035.htm#CACIHAAF">Type information</a></p> +<p><a href="reference039.htm#CACIHAAF">Type information</a></p> </li> <li> -<p><a href="reference037.htm#CACJCHJB">Converters</a></p> +<p><a href="reference041.htm#CACJCHJB">Converters</a></p> </li> <li> -<p><a href="reference038.htm#CACBIJFD">Ordering</a></p> +<p><a href="reference042.htm#CACBIJFD">Ordering</a></p> </li> <li> -<p><a href="reference039.htm#CACIJEGI">Joining Strategy</a></p> +<p><a href="reference043.htm#CACIJEGI">Joining Strategy</a></p> </li> <li> -<p><a href="reference040.htm#CACGHHGB">Derived Identity</a></p> +<p><a href="reference044.htm#CACGHHGB">Derived Identity</a></p> </li> <li> <p><a href="ref_primary_key.htm#CACFCCAB">Primary Key Generation information</a></p> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_outline.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_outline.htm index fd7e735c16..f4bd177765 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_outline.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_outline.htm @@ -8,7 +8,7 @@ <title>JPA Structure view</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="JPA Structure view" /> <meta name="relnum" content="Release 3.2" /> @@ -17,16 +17,16 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABEGGFE" name="BABEGGFE"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>JPA Structure view</h1> -<p><a id="sthref554" name="sthref554"></a><a id="sthref555" name="sthref555"></a>The <span class="gui-object-title">JPA Structure</span> view displays an outline of the structure (its attributes and mappings) of the entity that is currently selected or opened in the editor. The structural elements shown in the outline are the entity and its fields.</p> -<div class="figure"><a id="sthref556" name="sthref556"></a> +<p><a id="sthref581" name="sthref581"></a><a id="sthref582" name="sthref582"></a>The <span class="gui-object-title">JPA Structure</span> view displays an outline of the structure (its attributes and mappings) of the entity that is currently selected or opened in the editor. The structural elements shown in the outline are the entity and its fields.</p> +<div class="figure"><a id="sthref583" name="sthref583"></a> <p class="titleinfigure">Sample JPA Structure View</p> <img src="img/persistence_outline_view.png" alt="Sample JPA Structure view for an entity." title="Sample JPA Structure view for an entity." /><br /></div> <!-- class="figure" --> -<a id="sthref557" name="sthref557"></a> +<a id="sthref584" name="sthref584"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_perspective.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_perspective.htm index 1deec061ea..2ef7e5b3b4 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_perspective.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_perspective.htm @@ -8,7 +8,7 @@ <title>JPA Development perspective</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:43Z" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="JPA Development perspective" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABIFBDB" name="BABIFBDB"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1>JPA Development perspective</h1> -<p><a id="sthref635" name="sthref635"></a><a id="sthref636" name="sthref636"></a>The <span class="bold">JPA Development perspective</span> defines the initial set and layout of views in the Workbench window when using Dali. By default, the <span class="gui-object-title">JPA Development perspective</span> includes the following views:</p> +<p><a id="sthref683" name="sthref683"></a><a id="sthref684" name="sthref684"></a>The <span class="bold">JPA Development perspective</span> defines the initial set and layout of views in the Workbench window when using Dali. By default, the <span class="gui-object-title">JPA Development perspective</span> includes the following views:</p> <ul> <li> <p><a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a></p> @@ -36,11 +36,11 @@ <p><a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a></p> </li> </ul> -<div class="figure"><a id="sthref637" name="sthref637"></a> +<div class="figure"><a id="sthref685" name="sthref685"></a> <p class="titleinfigure">Sample JPA Development Perspective</p> <img src="img/jpa_perspective.png" alt="JPA Development perspective with the JPA Structure and JPA Details views." title="JPA Development perspective with the JPA Structure and JPA Details views." /><br /></div> <!-- class="figure" --> -<a id="sthref638" name="sthref638"></a> +<a id="sthref686" name="sthref686"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_prop_view.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_prop_view.htm index fc829e7d90..1972cdb891 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_prop_view.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_prop_view.htm @@ -8,7 +8,7 @@ <title>JPA Details view (for entities)</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="JPA Details view (for entities)" /> <meta name="relnum" content="Release 3.2" /> @@ -17,55 +17,55 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABFAEBB" name="BABFAEBB"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>JPA Details view (for entities)</h1> -<p><a id="sthref401" name="sthref401"></a><a id="sthref402" name="sthref402"></a><a id="sthref403" name="sthref403"></a>The <span class="gui-object-title">JPA Details</span> view displays the persistence information for the currently selected entity and contains the following tabs:</p> -<a id="sthref404" name="sthref404"></a> +<p><a id="sthref426" name="sthref426"></a><a id="sthref427" name="sthref427"></a><a id="sthref428" name="sthref428"></a>The <span class="gui-object-title">JPA Details</span> view displays the persistence information for the currently selected entity and contains the following tabs:</p> +<a id="sthref429" name="sthref429"></a> <p class="subhead2">Entity Type</p> <p>Clicking the name of the mapping type, which is represented as a hyperlink, invokes the Mapping Type Selection dialog. Use this dialog to specify the type of entity: Mapped Superclass, Embeddable or the default mapping type.</p> <ul> <li> -<p><a href="reference013.htm#CACCAGGC">Entity</a></p> +<p><a href="reference017.htm#CACCAGGC">Entity</a></p> </li> <li> -<p><a href="reference014.htm#CACHJEJH">Embeddable</a></p> +<p><a href="reference018.htm#CACHJEJH">Embeddable</a></p> </li> <li> -<p><a href="reference015.htm#CACGIEFD">Mapped Superclass</a></p> +<p><a href="reference019.htm#CACGIEFD">Mapped Superclass</a></p> </li> </ul> -<a id="sthref405" name="sthref405"></a> +<a id="sthref430" name="sthref430"></a> <p class="subhead2">Additional Information</p> <p>Depending on the entity type, the following additional areas will be available:</p> <ul> <li> -<p><a href="reference016.htm#CACJBBCA">Caching</a></p> +<p><a href="reference020.htm#CACJBBCA">Caching</a></p> </li> <li> -<p><a href="reference017.htm#CACBICGJ">Queries</a></p> +<p><a href="reference021.htm#CACBICGJ">Queries</a></p> </li> <li> -<p><a href="reference018.htm#CACFHGHE">Inheritance</a></p> +<p><a href="reference022.htm#CACFHGHE">Inheritance</a></p> </li> <li> -<p><a href="reference019.htm#CACIJBGH">Attribute Overrides</a></p> +<p><a href="reference023.htm#CACIJBGH">Attribute Overrides</a></p> </li> <li> -<p><a href="reference020.htm#CACDIJEE">Multitenancy</a></p> +<p><a href="reference024.htm#CACDIJEE">Multitenancy</a></p> </li> <li> -<p><a href="reference021.htm#CACCJJDC">Primary Key Generation</a></p> +<p><a href="reference025.htm#CACCJJDC">Primary Key Generation</a></p> </li> <li> -<p><a href="reference023.htm#CACJGDAJ">Converters</a></p> +<p><a href="reference027.htm#CACJGDAJ">Converters</a></p> </li> <li> -<p><a href="reference022.htm#CACBHIDA">Secondary tables</a></p> +<p><a href="reference026.htm#CACBHIDA">Secondary tables</a></p> </li> <li> -<p><a href="reference024.htm#CACJEEDE">Advanced</a></p> +<p><a href="reference028.htm#CACJEEDE">Advanced</a></p> </li> </ul> <!-- Start Footer --> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_xmll_editor.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_xmll_editor.htm index 284beddccc..1223498f8f 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_xmll_editor.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_persistence_xmll_editor.htm @@ -8,7 +8,7 @@ <title>persistence.xml Editor</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="persistence.xml Editor" /> <meta name="relnum" content="Release 3.2" /> @@ -17,38 +17,38 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIACCHID" name="CIACCHID"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>persistence.xml Editor</h1> -<p><a id="sthref558" name="sthref558"></a>The persistence.xml Editor provides an interface that enables you to update the <code>persistence.xml</code> file. For projects using the EclipseLink platform, the <code>perisistence.xml</code> Editor consists of the following pages:</p> +<p><a id="sthref585" name="sthref585"></a>The persistence.xml Editor provides an interface that enables you to update the <code>persistence.xml</code> file. For projects using the EclipseLink platform, the <code>perisistence.xml</code> Editor consists of the following pages:</p> <ul> <li> <p><a href="ref_persistence_general.htm#CIACIFGJ">General</a></p> </li> <li> -<p><a href="reference046.htm#CIAFFJIE">Connection</a></p> +<p><a href="reference050.htm#CIAFFJIE">Connection</a></p> </li> <li> -<p><a href="reference047.htm#CIAJAFEG">Customization</a></p> +<p><a href="reference051.htm#CIAJAFEG">Customization</a></p> </li> <li> -<p><a href="reference048.htm#CIABEDCH">Caching</a></p> +<p><a href="reference052.htm#CIABEDCH">Caching</a></p> </li> <li> -<p><a href="reference049.htm#CIABGHHI">Logging</a></p> +<p><a href="reference053.htm#CIABGHHI">Logging</a></p> </li> <li> -<p><a href="reference050.htm#CIAFJCHE">Options</a></p> +<p><a href="reference054.htm#CIAFJCHE">Options</a></p> </li> <li> -<p><a href="reference051.htm#CIACCFCB">Schema Generation</a></p> +<p><a href="reference055.htm#CIACCFCB">Schema Generation</a></p> </li> <li> -<p><a href="reference052.htm#CIAHJDFF">Properties</a></p> +<p><a href="reference056.htm#CIAHJDFF">Properties</a></p> </li> <li> -<p><a href="reference053.htm#CIAHCJAH">Source</a></p> +<p><a href="reference057.htm#CIAHCJAH">Source</a></p> </li> </ul> <p>For projects using the Generic platform, the following subset of these pages is available:</p> @@ -57,13 +57,13 @@ <p><a href="ref_persistence_general.htm#CIACIFGJ">General</a></p> </li> <li> -<p><a href="reference046.htm#CIAFFJIE">Connection</a></p> +<p><a href="reference050.htm#CIAFFJIE">Connection</a></p> </li> <li> -<p><a href="reference052.htm#CIAHJDFF">Properties</a></p> +<p><a href="reference056.htm#CIAHJDFF">Properties</a></p> </li> <li> -<p><a href="reference053.htm#CIAHCJAH">Source</a></p> +<p><a href="reference057.htm#CIAHCJAH">Source</a></p> </li> </ul> <!-- Start Footer --> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_primary_key.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_primary_key.htm index a97ad6fe62..d611b1b018 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_primary_key.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_primary_key.htm @@ -8,7 +8,7 @@ <title>Primary Key Generation information</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Primary Key Generation information" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CACFCCAB" name="CACFCCAB"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref524" name="sthref524"></a>Primary Key Generation information</h1> -<p>This table lists the fields available in the <span class="gui-object-title">Primary Key Generation</span> area in JPA Details view for <a href="tasks014.htm#BABGCBHG">ID mapping</a> types.</p> +<h1><a id="sthref551" name="sthref551"></a>Primary Key Generation information</h1> +<p>This table lists the fields available in the <span class="gui-object-title">Primary Key Generation</span> area in JPA Details view for <a href="tasks015.htm#BABGCBHG">ID mapping</a> types.</p> <div class="inftblhruleinformal"> <table class="HRuleInformal" title="This table describes the options on the Join Columns tab." summary="This table describes the options on the Join Columns tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="26%" /> @@ -29,28 +29,28 @@ <col width="34%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t44">Property</th> -<th align="left" valign="bottom" id="r1c2-t44">Description</th> -<th align="left" valign="bottom" id="r1c3-t44">Default</th> +<th align="left" valign="bottom" id="r1c1-t47">Property</th> +<th align="left" valign="bottom" id="r1c2-t47">Description</th> +<th align="left" valign="bottom" id="r1c3-t47">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t44" headers="r1c1-t44"><a id="CACBAJBC" name="CACBAJBC"></a> +<td align="left" id="r2c1-t47" headers="r1c1-t47"><a id="CACBAJBC" name="CACBAJBC"></a> <p><span class="bold">Primary Key Generation</span></p> </td> -<td align="left" headers="r2c1-t44 r1c2-t44"> -<p><a id="sthref525" name="sthref525"></a><a id="sthref526" name="sthref526"></a>These fields define how the primary key is generated. These fields correspond to the <code>@GeneratedValue</code> annotation.</p> +<td align="left" headers="r2c1-t47 r1c2-t47"> +<p><a id="sthref552" name="sthref552"></a><a id="sthref553" name="sthref553"></a>These fields define how the primary key is generated. These fields correspond to the <code>@GeneratedValue</code> annotation.</p> </td> -<td align="left" headers="r2c1-t44 r1c3-t44"> +<td align="left" headers="r2c1-t47 r1c3-t47"> <p>Generated Value</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t44" headers="r1c1-t44"><a id="CACJEEEC" name="CACJEEEC"></a> +<td align="left" id="r3c1-t47" headers="r1c1-t47"><a id="CACJEEEC" name="CACJEEEC"></a> <p>Strategy</p> </td> -<td align="left" headers="r3c1-t44 r1c2-t44"> +<td align="left" headers="r3c1-t47 r1c2-t47"> <ul> <li> <p>Auto</p> @@ -66,170 +66,170 @@ </li> </ul> </td> -<td align="left" headers="r3c1-t44 r1c3-t44"> +<td align="left" headers="r3c1-t47 r1c3-t47"> <p>Auto</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t44" headers="r1c1-t44"><a id="BABEEAHJ" name="BABEEAHJ"></a> +<td align="left" id="r4c1-t47" headers="r1c1-t47"><a id="BABEEAHJ" name="BABEEAHJ"></a> <p>Generator Name</p> </td> -<td align="left" headers="r4c1-t44 r1c2-t44"> +<td align="left" headers="r4c1-t47 r1c2-t47"> <p>Unique name of the generated value.</p> </td> -<td align="left" headers="r4c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r4c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t44" headers="r1c1-t44"><a id="CACGFEAH" name="CACGFEAH"></a> +<td align="left" id="r5c1-t47" headers="r1c1-t47"><a id="CACGFEAH" name="CACGFEAH"></a> <p><span class="bold">Table Generator</span></p> </td> -<td align="left" headers="r5c1-t44 r1c2-t44"> +<td align="left" headers="r5c1-t47 r1c2-t47"> <p>These fields define the database table used for generating the primary key and correspond to the <code>@TableGenerator</code> annotation.</p> <p>These fields apply only when <span class="bold">Strategy</span> = <span class="bold">Table</span>.</p> </td> -<td align="left" headers="r5c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r5c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t44" headers="r1c1-t44"> +<td align="left" id="r6c1-t47" headers="r1c1-t47"> <p>Name</p> </td> -<td align="left" headers="r6c1-t44 r1c2-t44"> +<td align="left" headers="r6c1-t47 r1c2-t47"> <p>Unique name of the generator.</p> </td> -<td align="left" headers="r6c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r6c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r7c1-t44" headers="r1c1-t44"> +<td align="left" id="r7c1-t47" headers="r1c1-t47"> <p>Table</p> </td> -<td align="left" headers="r7c1-t44 r1c2-t44"> +<td align="left" headers="r7c1-t47 r1c2-t47"> <p>Database table that stores the generated ID values.</p> </td> -<td align="left" headers="r7c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r7c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r8c1-t44" headers="r1c1-t44"> +<td align="left" id="r8c1-t47" headers="r1c1-t47"> <p>Schema</p> </td> -<td align="left" headers="r8c1-t44 r1c2-t44"><br /></td> -<td align="left" headers="r8c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r8c1-t47 r1c2-t47"><br /></td> +<td align="left" headers="r8c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r9c1-t44" headers="r1c1-t44"> +<td align="left" id="r9c1-t47" headers="r1c1-t47"> <p>Catalog</p> </td> -<td align="left" headers="r9c1-t44 r1c2-t44"><br /></td> -<td align="left" headers="r9c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r9c1-t47 r1c2-t47"><br /></td> +<td align="left" headers="r9c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r10c1-t44" headers="r1c1-t44"> +<td align="left" id="r10c1-t47" headers="r1c1-t47"> <p>Primary Key Column</p> </td> -<td align="left" headers="r10c1-t44 r1c2-t44"> +<td align="left" headers="r10c1-t47 r1c2-t47"> <p>The column in the table generator's <span class="bold">Table</span> that contains the primary key.</p> </td> -<td align="left" headers="r10c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r10c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r11c1-t44" headers="r1c1-t44"> +<td align="left" id="r11c1-t47" headers="r1c1-t47"> <p>Value Column</p> </td> -<td align="left" headers="r11c1-t44 r1c2-t44"> +<td align="left" headers="r11c1-t47 r1c2-t47"> <p>The column that stores the generated ID values.</p> </td> -<td align="left" headers="r11c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r11c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r12c1-t44" headers="r1c1-t44"> +<td align="left" id="r12c1-t47" headers="r1c1-t47"> <p>Primary Key Column Value</p> </td> -<td align="left" headers="r12c1-t44 r1c2-t44"> +<td align="left" headers="r12c1-t47 r1c2-t47"> <p>The value for the <span class="bold">Primary Key Column</span> in the generator table.</p> </td> -<td align="left" headers="r12c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r12c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r13c1-t44" headers="r1c1-t44"> +<td align="left" id="r13c1-t47" headers="r1c1-t47"> <p>Allocation size</p> </td> -<td align="left" headers="r13c1-t44 r1c2-t44"><br /></td> -<td align="left" headers="r13c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r13c1-t47 r1c2-t47"><br /></td> +<td align="left" headers="r13c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r14c1-t44" headers="r1c1-t44"> +<td align="left" id="r14c1-t47" headers="r1c1-t47"> <p>Initial value</p> </td> -<td align="left" headers="r14c1-t44 r1c2-t44"><br /></td> -<td align="left" headers="r14c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r14c1-t47 r1c2-t47"><br /></td> +<td align="left" headers="r14c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r15c1-t44" headers="r1c1-t44"><a id="CACFFHEH" name="CACFFHEH"></a> +<td align="left" id="r15c1-t47" headers="r1c1-t47"><a id="CACFFHEH" name="CACFFHEH"></a> <p><span class="bold">Sequence Generator</span></p> </td> -<td align="left" headers="r15c1-t44 r1c2-t44"> -<p><a id="sthref527" name="sthref527"></a><a id="sthref528" name="sthref528"></a>These fields define the specific sequence used for generating the primary key and correspond to the <code>@SequenceGenerator</code> annotation.</p> +<td align="left" headers="r15c1-t47 r1c2-t47"> +<p><a id="sthref554" name="sthref554"></a><a id="sthref555" name="sthref555"></a>These fields define the specific sequence used for generating the primary key and correspond to the <code>@SequenceGenerator</code> annotation.</p> <p>These fields apply only when <span class="bold">Strategy</span> = <span class="bold">Sequence</span>.</p> </td> -<td align="left" headers="r15c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r15c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r16c1-t44" headers="r1c1-t44"> +<td align="left" id="r16c1-t47" headers="r1c1-t47"> <p>Name</p> </td> -<td align="left" headers="r16c1-t44 r1c2-t44"> +<td align="left" headers="r16c1-t47 r1c2-t47"> <p>Name of the sequence table to use for defining primary key values.</p> </td> -<td align="left" headers="r16c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r16c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r17c1-t44" headers="r1c1-t44"> +<td align="left" id="r17c1-t47" headers="r1c1-t47"> <p>Sequence</p> </td> -<td align="left" headers="r17c1-t44 r1c2-t44"> +<td align="left" headers="r17c1-t47 r1c2-t47"> <p>Unique name of the sequence.</p> </td> -<td align="left" headers="r17c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r17c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r18c1-t44" headers="r1c1-t44"> +<td align="left" id="r18c1-t47" headers="r1c1-t47"> <p>Schema</p> </td> -<td align="left" headers="r18c1-t44 r1c2-t44"><br /></td> -<td align="left" headers="r18c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r18c1-t47 r1c2-t47"><br /></td> +<td align="left" headers="r18c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r19c1-t44" headers="r1c1-t44"> +<td align="left" id="r19c1-t47" headers="r1c1-t47"> <p>Catalog</p> </td> -<td align="left" headers="r19c1-t44 r1c2-t44"><br /></td> -<td align="left" headers="r19c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r19c1-t47 r1c2-t47"><br /></td> +<td align="left" headers="r19c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r20c1-t44" headers="r1c1-t44"> +<td align="left" id="r20c1-t47" headers="r1c1-t47"> <p>Allocation size</p> </td> -<td align="left" headers="r20c1-t44 r1c2-t44"><br /></td> -<td align="left" headers="r20c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r20c1-t47 r1c2-t47"><br /></td> +<td align="left" headers="r20c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r21c1-t44" headers="r1c1-t44"> +<td align="left" id="r21c1-t47" headers="r1c1-t47"> <p>Initial value</p> </td> -<td align="left" headers="r21c1-t44 r1c2-t44"><br /></td> -<td align="left" headers="r21c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r21c1-t47 r1c2-t47"><br /></td> +<td align="left" headers="r21c1-t47 r1c3-t47"><br /></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref529" name="sthref529"></a> +<a id="sthref556" name="sthref556"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="tasks014.htm#BABGCBHG">ID mapping</a></p> +<p><a href="tasks015.htm#BABGCBHG">ID mapping</a></p> </li> </ul> -<a id="sthref530" name="sthref530"></a> +<a id="sthref557" name="sthref557"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_project_properties.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_project_properties.htm index 124c58452e..1a20bd503c 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_project_properties.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_project_properties.htm @@ -8,7 +8,7 @@ <title>Project Properties page – JPA Options</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Project Properties page – JPA Options" /> <meta name="relnum" content="Release 3.2" /> @@ -17,69 +17,69 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABJHBCI" name="BABJHBCI"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>Project Properties page – JPA Options</h1> -<p><a id="sthref591" name="sthref591"></a><a id="sthref592" name="sthref592"></a><a id="sthref593" name="sthref593"></a>Use the <span class="gui-object-title">Java Persistence</span> options on the <span class="gui-object-title">Properties</span> page to select the database connection to use with the project.</p> -<p>This table lists the properties available in the <span class="gui-object-title">JPA Details page</span>.</p> +<p><a id="sthref618" name="sthref618"></a><a id="sthref619" name="sthref619"></a><a id="sthref620" name="sthref620"></a>Use the <span class="gui-object-title">JPA</span> options on the <span class="gui-object-title">Properties</span> page to select the database connection to use with the project.</p> +<p>This table lists the properties available in the <span class="gui-object-title">JPA options preferences page</span>.</p> <div class="inftblinformal"> <table class="Informal" title="Options on the Java Persistence Preferences page > JPA Options" summary="Options on the Java Persistence Preferences page > JPA Options" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <col width="32%" /> <col width="*" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t63">Property</th> -<th align="left" valign="bottom" id="r1c2-t63">Description</th> +<th align="left" valign="bottom" id="r1c1-t66">Property</th> +<th align="left" valign="bottom" id="r1c2-t66">Description</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t63" headers="r1c1-t63"> -<p><a id="sthref594" name="sthref594"></a><a id="sthref595" name="sthref595"></a><a id="sthref596" name="sthref596"></a><a id="sthref597" name="sthref597"></a><span class="bold">Platform</span></p> +<td align="left" id="r2c1-t66" headers="r1c1-t66"> +<p><a id="sthref621" name="sthref621"></a><a id="sthref622" name="sthref622"></a><a id="sthref623" name="sthref623"></a><a id="sthref624" name="sthref624"></a><span class="bold">Platform</span></p> </td> -<td align="left" headers="r2c1-t63 r1c2-t63"> +<td align="left" headers="r2c1-t66 r1c2-t66"> <p>Select the vendor-specific platform.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t63" headers="r1c1-t63"> +<td align="left" id="r3c1-t66" headers="r1c1-t66"> <p><span class="bold">JPA Implementation</span></p> </td> -<td align="left" headers="r3c1-t63 r1c2-t63"><br /></td> +<td align="left" headers="r3c1-t66 r1c2-t66"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t63" headers="r1c1-t63"> +<td align="left" id="r4c1-t66" headers="r1c1-t66"> <p>Type</p> </td> -<td align="left" headers="r4c1-t63 r1c2-t63"> +<td align="left" headers="r4c1-t66 r1c2-t66"> <p>Select <span class="bold">User Library</span> to select from the available user-defined or downloaded libraries.</p> <p>If you select Disable, you must manually include the JPA implementation library on the project classpath.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t63" headers="r1c1-t63"> +<td align="left" id="r5c1-t66" headers="r1c1-t66"> <p>Library</p> </td> -<td align="left" headers="r5c1-t63 r1c2-t63"> +<td align="left" headers="r5c1-t66 r1c2-t66"> <p>Select a specific JPA library configuration.</p> <p>Click <span class="bold">Manage libraries</span> to create or update a user library.</p> <p>Click <span class="bold">Download libraries</span> to download a specific library configuration.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t63" headers="r1c1-t63"> +<td align="left" id="r6c1-t66" headers="r1c1-t66"> <p>Include libraries with this application</p> </td> -<td align="left" headers="r6c1-t63 r1c2-t63"> +<td align="left" headers="r6c1-t66 r1c2-t66"> <p>Specify if the selected libraries are included when deploying the application.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r7c1-t63" headers="r1c1-t63"> -<p><a id="sthref598" name="sthref598"></a><a id="sthref599" name="sthref599"></a><a id="sthref600" name="sthref600"></a><span class="bold">Connection</span></p> +<td align="left" id="r7c1-t66" headers="r1c1-t66"> +<p><a id="sthref625" name="sthref625"></a><a id="sthref626" name="sthref626"></a><a id="sthref627" name="sthref627"></a><span class="bold">Connection</span></p> </td> -<td align="left" headers="r7c1-t63 r1c2-t63"> +<td align="left" headers="r7c1-t66 r1c2-t66"> <p>The database connection used to map the persistent entities.</p> <ul> <li> @@ -92,35 +92,35 @@ </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r8c1-t63" headers="r1c1-t63"> +<td align="left" id="r8c1-t66" headers="r1c1-t66"> <p>Override default catalog from connection</p> </td> -<td align="left" headers="r8c1-t63 r1c2-t63"> +<td align="left" headers="r8c1-t66 r1c2-t66"> <p>Select a catalog other than the default one derived from the connection information. Use this option if the default catalog is incorrect or cannot be used.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r9c1-t63" headers="r1c1-t63"> +<td align="left" id="r9c1-t66" headers="r1c1-t66"> <p>Override default schema from connection</p> </td> -<td align="left" headers="r9c1-t63 r1c2-t63"> +<td align="left" headers="r9c1-t66 r1c2-t66"> <p>Select a schema other than the default one derived from the connection information. Use this option if the default schema is incorrect or cannot be used. For example, use this option when the deployment login differs from the design-time login.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r10c1-t63" headers="r1c1-t63"> +<td align="left" id="r10c1-t66" headers="r1c1-t66"> <p><span class="bold">Persistent Class Management</span></p> </td> -<td align="left" headers="r10c1-t63 r1c2-t63"> +<td align="left" headers="r10c1-t66 r1c2-t66"> <p>Specify if Dali will <span class="bold">discover annotated classes automatically</span>, or if the <span class="bold">annotated classes must be listed in the persistence.xml</span> file.</p> <p><span class="bold">Note</span>: To insure application portability, you should explicitly list the managed persistence classes that are included in the persistence unit.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r11c1-t63" headers="r1c1-t63"> -<p><a id="sthref601" name="sthref601"></a><a id="sthref602" name="sthref602"></a><span class="bold">Canonical Metamodel</span></p> +<td align="left" id="r11c1-t66" headers="r1c1-t66"> +<p><a id="sthref628" name="sthref628"></a><a id="sthref629" name="sthref629"></a><span class="bold">Canonical Metamodel</span></p> </td> -<td align="left" headers="r11c1-t63 r1c2-t63"> +<td align="left" headers="r11c1-t66 r1c2-t66"> <p>Select the location of the metamodel source.</p> </td> </tr> @@ -128,11 +128,11 @@ </table> <br /></div> <!-- class="inftblinformal" --> -<a id="sthref603" name="sthref603"></a> +<a id="sthref630" name="sthref630"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="tasks027.htm#BABDBCBI">Modifying persistent project properties</a></p> +<p><a href="tasks028.htm#BABDBCBI">Modifying persistent project properties</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_selectTables.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_selectTables.htm index cb70048987..a8f8e0906b 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_selectTables.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_selectTables.htm @@ -8,7 +8,7 @@ <title>Select Tables</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Select Tables" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAHCGEE" name="CIAHCGEE"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Select Tables</h1> -<p><a id="sthref325" name="sthref325"></a><a id="sthref326" name="sthref326"></a><a id="sthref327" name="sthref327"></a>Use the <span class="gui-object-title">Select Tables</span> dialog to specify the database connection and tables from which to create entities.</p> +<p><a id="sthref338" name="sthref338"></a><a id="sthref339" name="sthref339"></a><a id="sthref340" name="sthref340"></a>Use the <span class="gui-object-title">Select Tables</span> dialog to specify the database connection and tables from which to create entities.</p> <div class="inftblhruleinformal"> <table class="HRuleInformal" title="Options on the Select Tables page of the Generate Entities from Tables wizard" summary="Options on the Select Tables page of the Generate Entities from Tables wizard" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="32%" /> @@ -69,17 +69,17 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref328" name="sthref328"></a> +<a id="sthref341" name="sthref341"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> </li> <li> -<p><a href="tasks021.htm#BABBAGFI">Generating entities from tables</a></p> +<p><a href="tasks022.htm#BABBAGFI">Generating entities from tables</a></p> </li> </ul> -<a id="sthref329" name="sthref329"></a> +<a id="sthref342" name="sthref342"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_select_cascade_dialog.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_select_cascade_dialog.htm index 62ba764ae9..5086c00cf1 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_select_cascade_dialog.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_select_cascade_dialog.htm @@ -8,7 +8,7 @@ <title>Select Cascade dialog</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Select Cascade dialog" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAFDGIJ" name="CIAFDGIJ"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>Select Cascade dialog</h1> -<p><a id="sthref617" name="sthref617"></a>Specify which operations are propagated throughout the association: All, Persist, Merge, Remove, or Refresh.</p> +<p><a id="sthref657" name="sthref657"></a>Specify which operations are propagated throughout the association: All, Persist, Merge, Remove, or Refresh.</p> </div> <!-- class="sect2" --> <!-- Start Footer --> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/ref_tableAssociations.htm b/jpa/plugins/org.eclipse.jpt.doc.user/ref_tableAssociations.htm index e7153602c0..2d68d137d6 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/ref_tableAssociations.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/ref_tableAssociations.htm @@ -8,7 +8,7 @@ <title>Table Associations</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Table Associations" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIACDICB" name="CIACDICB"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Table Associations</h1> -<p><a id="sthref330" name="sthref330"></a>Use this page to create or edit the association between the database table and entity.</p> +<p><a id="sthref343" name="sthref343"></a>Use this page to create or edit the association between the database table and entity.</p> <div class="inftblhruleinformal"> <table class="HRuleInformal" title="This table describes the options on the Generate Entities dialog." summary="Options on the Table Associations page of the Generate Entities from Tables wizard" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="32%" /> @@ -62,20 +62,20 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref331" name="sthref331"></a> +<a id="sthref344" name="sthref344"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> </li> <li> -<p><a href="tasks021.htm#BABBAGFI">Generating entities from tables</a></p> +<p><a href="tasks022.htm#BABBAGFI">Generating entities from tables</a></p> </li> <li> <p><a href="ref_create_new_association_wizard.htm#CIAFGHIF">Create New Association wizard</a></p> </li> </ul> -<a id="sthref332" name="sthref332"></a> +<a id="sthref345" name="sthref345"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference.htm index eb56bbaa97..5f31b3a9ea 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference.htm @@ -8,7 +8,7 @@ <title>Reference</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Reference" /> <meta name="relnum" content="Release 3.2" /> @@ -17,8 +17,8 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p><a id="sthref322" name="sthref322"></a></p> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p><a id="sthref335" name="sthref335"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <h1>Reference</h1> <p>This section includes detailed help information for each of the following elements in the Dali OR Mapping Tool:</p> <ul> @@ -26,22 +26,22 @@ <p><a href="reference001.htm#CACJJJJH">Wizards</a></p> </li> <li> -<p><a href="reference012.htm#CACDJIIG">Property pages</a></p> +<p><a href="reference016.htm#CACDJIIG">Property pages</a></p> </li> <li> -<p><a href="reference054.htm#CACDEIEE">Preferences</a></p> +<p><a href="reference058.htm#CACDEIEE">Preferences</a></p> </li> <li> -<p><a href="reference060.htm#CACGEJDA">Dialogs</a></p> +<p><a href="reference066.htm#CACGEJDA">Dialogs</a></p> </li> <li> <p><a href="ref_persistence_perspective.htm#BABIFBDB">JPA Development perspective</a></p> </li> <li> -<p><a href="reference068.htm#CACDHCIA">Icons and buttons</a></p> +<p><a href="reference076.htm#CACDHCIA">Icons and buttons</a></p> </li> <li> -<p><a href="reference071.htm#CACBBDIB">Dali Developer Documentation</a></p> +<p><a href="reference079.htm#CACBBDIB">Dali Developer Documentation</a></p> </li> </ul> <!-- Start Footer --> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference001.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference001.htm index ee95577ab9..d35ab27c27 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference001.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference001.htm @@ -8,7 +8,7 @@ <title>Wizards</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Wizards" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CACJJJJH" name="CACJJJJH"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1>Wizards</h1> -<p><a id="sthref323" name="sthref323"></a>This section includes information on the following wizards:</p> +<p><a id="sthref336" name="sthref336"></a>This section includes information on the following wizards:</p> <ul> <li> <p><a href="ref_create_custom_entities_wizard.htm#CIAGBFJE">Generate Entities from Tables wizard</a></p> @@ -39,7 +39,10 @@ <p><a href="ref_new_jpa_project_wizard.htm#CACBJGBG">Create New JPA Project wizard</a></p> </li> <li> -<p><a href="reference010.htm#CIAGHCGA">Generate Tables from Entities wizard</a></p> +<p><a href="reference010.htm#CACIEJDJ">Create New JAXB Project wizard</a></p> +</li> +<li> +<p><a href="reference014.htm#CIAGHCGA">Generate Tables from Entities wizard</a></p> </li> <li> <p><a href="ref_create_new_association_wizard.htm#CIAFGHIF">Create New Association wizard</a></p> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference002.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference002.htm index 65eb5c8ceb..e1e220e5ab 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference002.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference002.htm @@ -8,7 +8,7 @@ <title>Generate Dynamic Entities from Tables wizard</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Generate Dynamic Entities from Tables wizard" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CACGDFDJ" name="CACGDFDJ"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>Generate Dynamic Entities from Tables wizard</h1> -<p><a id="sthref339" name="sthref339"></a>Use the Generate Dynamic Custom Entities wizard to create dynamic EclipseLink JPA entities from your database tables.</p> +<p><a id="sthref352" name="sthref352"></a>Use the Generate Dynamic Custom Entities wizard to create dynamic EclipseLink JPA entities from your database tables.</p> <p>The wizard consists of the following pages:</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference003.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference003.htm index f964eabad9..2187ceed42 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference003.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference003.htm @@ -8,7 +8,7 @@ <title>Select Tables</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Select Tables" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CACFGHJF" name="CACFGHJF"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Select Tables</h1> -<p><a id="sthref340" name="sthref340"></a><a id="sthref341" name="sthref341"></a><a id="sthref342" name="sthref342"></a>Use the <span class="gui-object-title">Select Tables</span> dialog to specify the database connection and tables from which to create entities.</p> +<p><a id="sthref353" name="sthref353"></a><a id="sthref354" name="sthref354"></a><a id="sthref355" name="sthref355"></a>Use the <span class="gui-object-title">Select Tables</span> dialog to specify the database connection and tables from which to create entities.</p> <div class="inftblhruleinformal"> <table class="HRuleInformal" title="Options on the Select Tables page of the Generate Entities from Tables wizard" summary="Options on the Select Tables page of the Generate Entities from Tables wizard" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="32%" /> @@ -69,17 +69,17 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref343" name="sthref343"></a> +<a id="sthref356" name="sthref356"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> </li> <li> -<p><a href="tasks023.htm#CIHHFGIG">Generating dynamic entities from tables</a></p> +<p><a href="tasks024.htm#CIHHFGIG">Generating dynamic entities from tables</a></p> </li> </ul> -<a id="sthref344" name="sthref344"></a> +<a id="sthref357" name="sthref357"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference004.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference004.htm index 38b2ef8d95..4209721e1d 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference004.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference004.htm @@ -8,7 +8,7 @@ <title>Table Associations</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Table Associations" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CACBDJAC" name="CACBDJAC"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Table Associations</h1> -<p><a id="sthref345" name="sthref345"></a>Use this page to create or edit the association between the database table and entity.</p> +<p><a id="sthref358" name="sthref358"></a>Use this page to create or edit the association between the database table and entity.</p> <div class="inftblhruleinformal"> <table class="HRuleInformal" title="Options on the Table Associations page of the Generate Entities from Tables wizard" summary="Options on the Table Associations page of the Generate Entities from Tables wizard." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="32%" /> @@ -62,20 +62,20 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref346" name="sthref346"></a> +<a id="sthref359" name="sthref359"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> </li> <li> -<p><a href="tasks021.htm#BABBAGFI">Generating entities from tables</a></p> +<p><a href="tasks022.htm#BABBAGFI">Generating entities from tables</a></p> </li> <li> <p><a href="ref_create_new_association_wizard.htm#CIAFGHIF">Create New Association wizard</a></p> </li> </ul> -<a id="sthref347" name="sthref347"></a> +<a id="sthref360" name="sthref360"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference005.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference005.htm index f3489fe072..cf196e0379 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference005.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference005.htm @@ -8,7 +8,7 @@ <title>Customize Default Entity Generation</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Customize Default Entity Generation" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CACHHEEH" name="CACHHEEH"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Customize Default Entity Generation</h1> -<p><a id="sthref348" name="sthref348"></a>Use this page to specify the default information Dali will use when generating the entities from the database tables. You will be able to override this information for specific entities.</p> +<p><a id="sthref361" name="sthref361"></a>Use this page to specify the default information Dali will use when generating the entities from the database tables. You will be able to override this information for specific entities.</p> <div class="inftblhruleinformal"> <table class="HRuleInformal" title="ptions on the Customize Default Entity page of the Generate Entities from Tables wizard" summary="Options on the Customize Default Entity page of the Generate Entities from Tables wizard" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="32%" /> @@ -85,20 +85,20 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref349" name="sthref349"></a> +<a id="sthref362" name="sthref362"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> </li> <li> -<p><a href="tasks023.htm#CIHHFGIG">Generating dynamic entities from tables</a></p> +<p><a href="tasks024.htm#CIHHFGIG">Generating dynamic entities from tables</a></p> </li> <li> <p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> </ul> -<a id="sthref350" name="sthref350"></a> +<a id="sthref363" name="sthref363"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference006.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference006.htm index f1ff3a7fa4..1503c27c83 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference006.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference006.htm @@ -8,7 +8,7 @@ <title>Customize Individual Entities</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Customize Individual Entities" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CACDGDIC" name="CACDGDIC"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Customize Individual Entities</h1> -<p><a id="sthref351" name="sthref351"></a>Use this page to customize each generated entity. Select an item in the <span class="bold">Table and columns</span> area, then complete the following fields for each item.</p> +<p><a id="sthref364" name="sthref364"></a>Use this page to customize each generated entity. Select an item in the <span class="bold">Table and columns</span> area, then complete the following fields for each item.</p> <div class="inftblhruleinformal"> <table class="HRuleInformal" title="Options on the Individual Entities page of the Generate Entities from Tables wizard" summary="Options on the Individual Entities page of the Generate Entities from Tables wizard" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="32%" /> @@ -84,20 +84,20 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref352" name="sthref352"></a> +<a id="sthref365" name="sthref365"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> </li> <li> -<p><a href="tasks023.htm#CIHHFGIG">Generating dynamic entities from tables</a></p> +<p><a href="tasks024.htm#CIHHFGIG">Generating dynamic entities from tables</a></p> </li> <li> <p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> </ul> -<a id="sthref353" name="sthref353"></a> +<a id="sthref366" name="sthref366"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference007.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference007.htm index cf4dddb39f..d3312222f3 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference007.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference007.htm @@ -8,7 +8,7 @@ <title>Create ORM Mapping File wizard</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Create ORM Mapping File wizard" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAIJCCE" name="CIAIJCCE"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1>Create ORM Mapping File wizard</h1> -<p><a id="sthref362" name="sthref362"></a><a id="sthref363" name="sthref363"></a><a id="sthref364" name="sthref364"></a>The New Mapping File wizard enables you to add an <code>orm.xml</code> file to a JPA project if no object map exists at the location specified. For example, if you cleared the <span class="bold">Create orm.xml</span> option on the <a href="ref_jpa_facet.htm#CACIFDIF">JPA Facet page</a>, you can later add the <code>orm.xml</code> file to the src file of the project using this wizard.</p> +<p><a id="sthref375" name="sthref375"></a><a id="sthref376" name="sthref376"></a><a id="sthref377" name="sthref377"></a>The New Mapping File wizard enables you to add an <code>orm.xml</code> file to a JPA project if no object map exists at the location specified. For example, if you cleared the <span class="bold">Create orm.xml</span> option on the <a href="ref_jpa_facet.htm#CACIFDIF">JPA Facet page</a>, you can later add the <code>orm.xml</code> file to the src file of the project using this wizard.</p> <p>The <a href="#CIAIJCCE">Create ORM Mapping File wizard</a> consists of the following pages:</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference008.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference008.htm index ae5cdf5a67..99e8a953ea 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference008.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference008.htm @@ -8,7 +8,7 @@ <title>Mapping File Location</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Mapping File Location" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIAJEIDJ" name="CIAJEIDJ"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Mapping File Location</h1> @@ -83,11 +83,11 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref365" name="sthref365"></a> +<a id="sthref378" name="sthref378"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="tasks007.htm#CIHDEFCA">Creating an orm.xml file</a></p> +<p><a href="tasks008.htm#CIHDEFCA">Creating an orm.xml file</a></p> </li> <li> <p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> @@ -96,7 +96,7 @@ <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref366" name="sthref366"></a> +<a id="sthref379" name="sthref379"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference009.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference009.htm index af2225c499..e44bd3f873 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference009.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference009.htm @@ -8,7 +8,7 @@ <title>Mapping File Options</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Mapping File Options" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CACDFCDB" name="CACDFCDB"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h1>Mapping File Options</h1> @@ -72,11 +72,11 @@ </table> <br /></div> <!-- class="inftblinformal" --> -<a id="sthref367" name="sthref367"></a> +<a id="sthref380" name="sthref380"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="tasks007.htm#CIHDEFCA">Creating an orm.xml file</a></p> +<p><a href="tasks008.htm#CIHDEFCA">Creating an orm.xml file</a></p> </li> <li> <p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> @@ -85,7 +85,7 @@ <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref368" name="sthref368"></a> +<a id="sthref381" name="sthref381"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference010.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference010.htm index bc7e80d3ba..f1bf68d540 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference010.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference010.htm @@ -5,38 +5,34 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Generate Tables from Entities wizard</title> +<title>Create New JAXB Project wizard</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Generate Tables from Entities wizard" /> +<meta name="doctitle" content="Create New JAXB Project wizard" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIAGHCGA" name="CIAGHCGA"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACIEJDJ" name="CACIEJDJ"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Generate Tables from Entities wizard</h1> -<p><a id="sthref382" name="sthref382"></a><a id="sthref383" name="sthref383"></a><a id="sthref384" name="sthref384"></a><a id="sthref385" name="sthref385"></a><a id="sthref386" name="sthref386"></a>Use the Generate Tables from Entities Wizard to quickly create DDL scripts from your persistent entities. Dali automatically creates the necessary primary and foreign keys, based on the entity mappings.</p> -<div align="center"> -<div class="inftblnotewarn"><br /> -<table class="NoteWarn oac_no_warn" summary="" cellpadding="3" cellspacing="0"> -<tbody> -<tr> -<td align="left"> -<p class="notep1">WARNING:</p> -<p class="warnsp">Generating tables will <code>DROP</code> any existing tables and <code>CREATE</code> new tables, based on the entities in your project.</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblnotewarn" --></div> -<p>The <a href="#CIAGHCGA">Generate Tables from Entities wizard</a> consists of the <a href="reference011.htm#CACHAJEG">Schema Generation</a> page.</p> +<h1>Create New JAXB Project wizard</h1> +<p><a id="sthref395" name="sthref395"></a><a id="sthref396" name="sthref396"></a><a id="sthref397" name="sthref397"></a>The Create New JAXB Project wizard allows you to create a new Java project using JAXB. The wizard consists of the following pages:</p> +<ul> +<li> +<p><a href="ref_new_jpa_project.htm#CACBJAGC">New JPA Project page</a></p> +</li> +<li> +<p><a href="ref_java_page.htm#CIAGEBAA">Java Page</a></p> +</li> +<li> +<p><a href="ref_jpa_facet.htm#CACIFDIF">JPA Facet page</a></p> +</li> +</ul> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference011.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference011.htm index 3befcac9dc..3cac00ef5b 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference011.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference011.htm @@ -5,82 +5,120 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Schema Generation</title> +<title>New JAXB Project page</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Schema Generation" /> +<meta name="doctitle" content="New JAXB Project page" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACHAJEG" name="CACHAJEG"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACHFJFI" name="CACHFJFI"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Schema Generation</h1> -<p>This table lists the properties of the Schema Generation page of the <a href="reference010.htm#CIAGHCGA">Generate Tables from Entities wizard</a>.</p> +<h1>New JAXB Project page</h1> +<p>This table lists the properties available on the New JPA Project page of the <a href="ref_new_jpa_project_wizard.htm#CACBJGBG">Create New JPA Project wizard</a>.</p> <div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="This table lists the properties of the Mapping File Wizard." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="23%" /> -<col width="*" /> +<table class="HRuleInformal" title="Options on the New JPA Project page of the New JPA Project wizard" summary="Options on the New JPA Project page of the New JPA Project wizard" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="24%" /> +<col width="*" /> +<col width="25%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t18">Property</th> -<th align="left" valign="bottom" id="r1c2-t18">Description</th> -<th align="left" valign="bottom" id="r1c3-t18">Default</th> +<th align="left" valign="bottom" id="r1c1-t17">Property</th> +<th align="left" valign="bottom" id="r1c2-t17">Description</th> +<th align="left" valign="bottom" id="r1c3-t17">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t18" headers="r1c1-t18"> -<p>Generation Output Mode</p> +<td align="left" id="r2c1-t17" headers="r1c1-t17"> +<p>Project name</p> </td> -<td align="left" headers="r2c1-t18 r1c2-t18"> -<p>Specify how Dali should generate the DDL:</p> -<ul> -<li> -<p>Database – DDL will be generated and written to the database only.</p> -</li> -<li> -<p>SQL-script – DDL will be generated and written to a file only.</p> -</li> -<li> -<p>Both – DDL will be generated and written to both the database and a file.</p> -</li> -</ul> +<td align="left" headers="r2c1-t17 r1c2-t17"> +<p>Name of the Eclipse JPA project.</p> +</td> +<td align="left" headers="r2c1-t17 r1c3-t17"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t17" headers="r1c1-t17"> +<p>Project location</p> +</td> +<td align="left" headers="r3c1-t17 r1c2-t17"> +<p>Location of the workspace in which to save the project.</p> +<p>Unselect the <span class="bold">Use default location</span> option and click <span class="bold">Browse</span> to select a new location.</p> +</td> +<td align="left" headers="r3c1-t17 r1c3-t17"> +<p>Current workspace</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t17" headers="r1c1-t17"> +<p>Target runtime</p> +</td> +<td align="left" headers="r4c1-t17 r1c2-t17"> +<p>Select a pre-defined target for the project.</p> +<p>Click <span class="bold">New Runtime</span> to create a new environment with the New Server Runtime wizard.</p> </td> -<td align="left" headers="r2c1-t18 r1c3-t18"> -<p>Database</p> +<td align="left" headers="r4c1-t17 r1c3-t17"> +<p><None></p> </td> </tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t17" headers="r1c1-t17"> +<p>JAXB Version</p> +</td> +<td align="left" headers="r5c1-t17 r1c2-t17"> +<p>Select the Java Architecture for XML Binding (JAXB) version for the project.</p> +</td> +<td align="left" headers="r5c1-t17 r1c3-t17"> +<p>2.2</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t17" headers="r1c1-t17"> +<p>Configurations</p> +</td> +<td align="left" headers="r6c1-t17 r1c2-t17"> +<p>Select a project configuration with pre-defined facets.</p> +<p>Select <span class="bold">Modify</span> to manually select the facets for this project.</p> +</td> +<td align="left" headers="r6c1-t17 r1c3-t17"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t17" headers="r1c1-t17"> +<p>Working sets</p> +</td> +<td align="left" headers="r7c1-t17 r1c2-t17"> +<p>Specify if this project should be included in an existing working set. The drop down field shows a list of previous selected working sets.</p> +<p>Select <span class="bold">Add project to working sets</span>, then select a <span class="bold">Working set</span> in which to add this project.</p> +</td> +<td align="left" headers="r7c1-t17 r1c3-t17"><br /></td> +</tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref387" name="sthref387"></a> +<a id="sthref398" name="sthref398"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="tasks021.htm#BABBAGFI">Generating entities from tables</a></p> -</li> -<li> -<p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> +<p><a href="tasks001.htm#CIHIBIJJ">Creating a new JAXB project</a></p> </li> </ul> -<a id="sthref388" name="sthref388"></a> +<a id="sthref399" name="sthref399"></a> <p class="subhead2">Related reference</p> <ul> <li> -<p><a href="reference007.htm#CIAIJCCE">Create ORM Mapping File wizard</a></p> +<p><a href="reference010.htm#CACIEJDJ">Create New JAXB Project wizard</a></p> </li> </ul> </div> <!-- class="sect3" --> -<!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference012.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference012.htm index 8d18d92259..e35a0fa5b6 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference012.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference012.htm @@ -5,40 +5,77 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Property pages</title> +<title>Java Page</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Property pages" /> +<meta name="doctitle" content="Java Page" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACDJIIG" name="CACDJIIG"></a></p> -<div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1>Property pages</h1> -<p><a id="sthref400" name="sthref400"></a>This section includes information each property page in the following views:</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref400" name="sthref400"></a> +<h1>Java Page</h1> +<p>This table lists the properties available on the Java page of the <a href="reference010.htm#CACIEJDJ">Create New JAXB Project wizard</a>.</p> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" title="Options on the Java page of the New JPA Project wizard" summary="Options on the Java page of the New JPA Project wizard" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="24%" /> +<col width="*" /> +<col width="25%" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t18">Property</th> +<th align="left" valign="bottom" id="r1c2-t18">Description</th> +<th align="left" valign="bottom" id="r1c3-t18">Default</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t18" headers="r1c1-t18"> +<p>Source folders on build path</p> +</td> +<td align="left" headers="r2c1-t18 r1c2-t18"> +<p>Click <span class="bold">Add Folder</span> to select an existing Java source folder to add to this project.</p> +</td> +<td align="left" headers="r2c1-t18 r1c3-t18"> +<p><code>src</code></p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t18" headers="r1c1-t18"> +<p>Default output folder</p> +</td> +<td align="left" headers="r3c1-t18 r1c2-t18"> +<p>Specify the location of the <code>.class</code> files.</p> +</td> +<td align="left" headers="r3c1-t18 r1c3-t18"> +<p><code>build\classes</code></p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<a id="sthref401" name="sthref401"></a> +<p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> -</li> -<li> -<p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> -</li> -<li> -<p><a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a></p> -</li> -<li> -<p><a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a></p> +<p><a href="tasks001.htm#CIHIBIJJ">Creating a new JAXB project</a></p> </li> +</ul> +<a id="sthref402" name="sthref402"></a> +<p class="subhead2">Related reference</p> +<ul> <li> -<p><a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a></p> +<p><a href="reference010.htm#CACIEJDJ">Create New JAXB Project wizard</a></p> </li> </ul> +</div> +<!-- class="sect3" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> @@ -50,6 +87,6 @@ </tr> </table> </div> -<!-- class="footer" --></div> +<!-- class="footer" --> </body> </html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference013.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference013.htm index e1b3733108..4465068e65 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference013.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference013.htm @@ -5,134 +5,103 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Entity</title> +<title>JAXB Facet page</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Entity" /> +<meta name="doctitle" content="JAXB Facet page" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACCAGGC" name="CACCAGGC"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACJGDEF" name="CACJGDEF"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Entity</h1> -<p>This table lists the Entity information fields available in the <span class="gui-object-title">JPA Details</span> view for an <a href="tasks002.htm#BABGBIEE">Entity</a>.</p> -<div class="inftblhruleinformalwide"> -<table class="HRuleInformalWide" title="JPA Details, Entity page" summary="JPA Details, Entity page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="20%" /> -<col width="*" /> +<h1>JAXB Facet page</h1> +<p>This table lists the properties available on the JPA Facet page of the <a href="reference010.htm#CACIEJDJ">Create New JAXB Project wizard</a>.</p> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" title="Options on the Java Facet page of the New JPA Project wizard" summary="Options on the Java Facet page of the New JPA Project wizard" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="24%" /> +<col width="*" /> +<col width="25%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t20">Property</th> -<th align="left" valign="bottom" id="r1c2-t20">Description</th> -<th align="left" valign="bottom" id="r1c3-t20">Default</th> +<th align="left" valign="bottom" id="r1c1-t19">Property</th> +<th align="left" valign="bottom" id="r1c2-t19">Description</th> +<th align="left" valign="bottom" id="r1c3-t19">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t20" headers="r1c1-t20"> -<p><span class="bold">Table</span></p> -</td> -<td align="left" headers="r2c1-t20 r1c2-t20"> -<p>The default database table information for this entity. These fields can be overridden by the information in the <a href="reference019.htm#CACIJBGH">Attribute Overrides</a> area.</p> +<td align="left" id="r2c1-t19" headers="r1c1-t19"> +<p><span class="bold">Platform</span></p> </td> -<td align="left" headers="r2c1-t20 r1c3-t20"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t20" headers="r1c1-t20"> -<p>Name</p> +<td align="left" headers="r2c1-t19 r1c2-t19"> +<p>Vendor-specific JPA implementation.</p> </td> -<td align="left" headers="r3c1-t20 r1c2-t20"> -<p>The name of the primary database table associated with the entity.</p> +<td align="left" headers="r2c1-t19 r1c3-t19"> +<p>Generic</p> </td> -<td align="left" headers="r3c1-t20 r1c3-t20"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t20" headers="r1c1-t20"> -<p>Catalog</p> -</td> -<td align="left" headers="r4c1-t20 r1c2-t20"> -<p>The database catalog that contains the <span class="bold">Table</span>.</p> +<td align="left" id="r3c1-t19" headers="r1c1-t19"> +<p><a id="sthref403" name="sthref403"></a><a id="sthref404" name="sthref404"></a><span class="bold">JAXB Implementation</span></p> </td> -<td align="left" headers="r4c1-t20 r1c3-t20"> -<p>As defined in <code>orm.xml</code>.</p> +<td align="left" headers="r3c1-t19 r1c2-t19"> +<p>Select a specific JPA library configuration.</p> +<p>Click <span class="bold">Manage libraries</span> to create or update a user library.</p> +<p>Click <span class="bold">Download libraries</span> to download a specific library configuration.</p> +<p>Depending on your JPA implementation (for example, Generic or EclipseLink), different options may be available when working with JPA projects</p> </td> +<td align="left" headers="r3c1-t19 r1c3-t19"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t20" headers="r1c1-t20"> -<p>Schema</p> +<td align="left" id="r4c1-t19" headers="r1c1-t19"> +<p>Type</p> </td> -<td align="left" headers="r5c1-t20 r1c2-t20"> -<p>The database schema that contains the <span class="bold">Table</span>.</p> +<td align="left" headers="r4c1-t19 r1c2-t19"> +<p>Select <span class="bold">User Library</span> to select from the available user-defined or downloaded libraries.</p> +<p>If you select <span class="bold">Disable</span>, you must manually include the JPA implementation library on the project classpath.</p> </td> -<td align="left" headers="r5c1-t20 r1c3-t20"> -<p>As defined in <code>orm.xml</code>.</p> +<td align="left" headers="r4c1-t19 r1c3-t19"> +<p>User Library</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t20" headers="r1c1-t20"> -<p><span class="bold">Name</span></p> -</td> -<td align="left" headers="r6c1-t20 r1c2-t20"> -<p>The name of this entity. By default, the class name is used as the entity name.</p> -</td> -<td align="left" headers="r6c1-t20 r1c3-t20"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t20" headers="r1c1-t20"> -<p><span class="bold">Access</span></p> -</td> -<td align="left" headers="r7c1-t20 r1c2-t20"> -<p>Specify how the entity its access instance variables.</p> -<ul> -<li> -<p>Property – Persistent state accessed through the property accessor methods. The property accessor methods must be <span class="bold">public</span> or <span class="bold">private</span>.</p> -</li> -<li> -<p>Field – Instance variables are accessed directly. All non-transient instance variables are persistent.</p> -</li> -</ul> -<p><span class="bold">Note</span>: This field is for display only, based on the properties in the <code>orm.xml</code>: If only the methods of the class are annotated, <span class="bold">property</span> access type is used. In all other cases, <span class="bold">field</span> access type is used.</p> +<td align="left" id="r5c1-t19" headers="r1c1-t19"> +<p>Include libraries with this application</p> </td> -<td align="left" headers="r7c1-t20 r1c3-t20"> -<p>Field</p> +<td align="left" headers="r5c1-t19 r1c2-t19"> +<p>Specify if the selected libraries are included when deploying the application.</p> </td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r8c1-t20" headers="r1c1-t20"> -<p><span class="bold">ID class</span></p> -</td> -<td align="left" headers="r8c1-t20 r1c2-t20"> -<p>Click <span class="bold">Browse</span> and select the primary key for the entity. Clicking the field name, which is represented as a hyperlink, allows you to create a new class.</p> +<td align="left" headers="r5c1-t19 r1c3-t19"> +<p>Selected</p> </td> -<td align="left" headers="r8c1-t20 r1c3-t20"><br /></td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformalwide" --> -<a id="sthref406" name="sthref406"></a> +<!-- class="inftblhruleinformal" --> +<a id="sthref405" name="sthref405"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> +<p><a href="tasks001.htm#CIHIBIJJ">Creating a new JAXB project</a></p> </li> </ul> -<a id="sthref407" name="sthref407"></a> +<a id="sthref406" name="sthref406"></a> <p class="subhead2">Related reference</p> <ul> <li> -<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> +<p><a href="reference010.htm#CACIEJDJ">Create New JAXB Project wizard</a></p> </li> </ul> </div> <!-- class="sect3" --> +<!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference014.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference014.htm index 0ae13b1a5e..c8f7c71194 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference014.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference014.htm @@ -5,76 +5,38 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Embeddable</title> +<title>Generate Tables from Entities wizard</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Embeddable" /> +<meta name="doctitle" content="Generate Tables from Entities wizard" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACHJEJH" name="CACHJEJH"></a></p> -<div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Embeddable</h1> -<p><a id="sthref408" name="sthref408"></a>This table lists the Embeddable information fields available in the <span class="gui-object-title">JPA Details</span> view for <a href="tasks003.htm#BABFEICE">Embeddable</a> entity type.</p> -<div class="inftblhruleinformalwide"> -<table class="HRuleInformalWide" summary="JPA Details view, Embeddable page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="19%" /> -<col width="*" /> -<col width="19%" /> -<thead> -<tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t21">Property</th> -<th align="left" valign="bottom" id="r1c2-t21">Description</th> -<th align="left" valign="bottom" id="r1c3-t21">Default</th> -</tr> -</thead> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIAGHCGA" name="CIAGHCGA"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Generate Tables from Entities wizard</h1> +<p><a id="sthref407" name="sthref407"></a><a id="sthref408" name="sthref408"></a><a id="sthref409" name="sthref409"></a><a id="sthref410" name="sthref410"></a><a id="sthref411" name="sthref411"></a>Use the Generate Tables from Entities Wizard to quickly create DDL scripts from your persistent entities. Dali automatically creates the necessary primary and foreign keys, based on the entity mappings.</p> +<div align="center"> +<div class="inftblnotewarn"><br /> +<table class="NoteWarn oac_no_warn" summary="" cellpadding="3" cellspacing="0"> <tbody> -<tr align="left" valign="top"> -<td align="left" id="r2c1-t21" headers="r1c1-t21"> -<p>Access</p> -</td> -<td align="left" headers="r2c1-t21 r1c2-t21"> -<p>Specify how the entity its access instance variables.</p> -<ul> -<li> -<p>Property – Persistent state accessed through the property accessor methods. The property accessor methods must be <span class="bold">public</span> or <span class="bold">private</span>.</p> -</li> -<li> -<p>Field – Instance variables are accessed directly. All non-transient instance variables are persistent.</p> -</li> -</ul> -<p><span class="bold">Note</span>: This field is for display only, based on the properties in the <code>orm.xml</code>: If only the methods of the class are annotated, <span class="bold">property</span> access type is used. In all other cases, <span class="bold">field</span> access type is used.</p> -</td> -<td align="left" headers="r2c1-t21 r1c3-t21"> -<p>Field</p> +<tr> +<td align="left"> +<p class="notep1">WARNING:</p> +<p class="warnsp">Generating tables will <code>DROP</code> any existing tables and <code>CREATE</code> new tables, based on the entities in your project.</p> </td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformalwide" --> -<a id="sthref409" name="sthref409"></a> -<p class="subhead2">Related tasks</p> -<ul> -<li> -<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> -</li> -</ul> -<a id="sthref410" name="sthref410"></a> -<p class="subhead2">Related reference</p> -<ul> -<li> -<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> -</li> -</ul> -</div> -<!-- class="sect3" --> +<!-- class="inftblnotewarn" --></div> +<p>The <a href="#CIAGHCGA">Generate Tables from Entities wizard</a> consists of the <a href="reference015.htm#CACHAJEG">Schema Generation</a> page.</p> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> @@ -86,6 +48,6 @@ </tr> </table> </div> -<!-- class="footer" --> +<!-- class="footer" --></div> </body> </html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference015.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference015.htm index b66d61b473..fb744da366 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference015.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference015.htm @@ -5,85 +5,82 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Mapped Superclass</title> +<title>Schema Generation</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Mapped Superclass" /> +<meta name="doctitle" content="Schema Generation" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACGIEFD" name="CACGIEFD"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACHAJEG" name="CACHAJEG"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Mapped Superclass</h1> -<p><a id="sthref411" name="sthref411"></a>This table lists the Embeddable information fields available in the <span class="gui-object-title">JPA Details</span> view for <a href="tasks004.htm#BABDAGCI">Mapped superclass</a> entity type.</p> -<div class="inftblhruleinformalwide"> -<table class="HRuleInformalWide" summary="JPA Details view, Mapped Superclass page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="19%" /> +<h1>Schema Generation</h1> +<p>This table lists the properties of the Schema Generation page of the <a href="reference014.htm#CIAGHCGA">Generate Tables from Entities wizard</a>.</p> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" summary="This table lists the properties of the Mapping File Wizard." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="23%" /> <col width="*" /> -<col width="19%" /> +<col width="24%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t22">Property</th> -<th align="left" valign="bottom" id="r1c2-t22">Description</th> -<th align="left" valign="bottom" id="r1c3-t22">Default</th> +<th align="left" valign="bottom" id="r1c1-t21">Property</th> +<th align="left" valign="bottom" id="r1c2-t21">Description</th> +<th align="left" valign="bottom" id="r1c3-t21">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t22" headers="r1c1-t22"> -<p>Access</p> +<td align="left" id="r2c1-t21" headers="r1c1-t21"> +<p>Generation Output Mode</p> </td> -<td align="left" headers="r2c1-t22 r1c2-t22"> -<p>Specify how the entity its access instance variables.</p> +<td align="left" headers="r2c1-t21 r1c2-t21"> +<p>Specify how Dali should generate the DDL:</p> <ul> <li> -<p>Property – Persistent state accessed through the property accessor methods. The property accessor methods must be <span class="bold">public</span> or <span class="bold">private</span>.</p> +<p>Database – DDL will be generated and written to the database only.</p> </li> <li> -<p>Field – Instance variables are accessed directly. All non-transient instance variables are persistent.</p> +<p>SQL-script – DDL will be generated and written to a file only.</p> +</li> +<li> +<p>Both – DDL will be generated and written to both the database and a file.</p> </li> </ul> -<p><span class="bold">Note</span>: This field is for display only, based on the properties in the <code>orm.xml</code>: If only the methods of the class are annotated, <span class="bold">property</span> access type is used. In all other cases, <span class="bold">field</span> access type is used.</p> -</td> -<td align="left" headers="r2c1-t22 r1c3-t22"> -<p>Field</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t22" headers="r1c1-t22"> -<p>ID class</p> </td> -<td align="left" headers="r3c1-t22 r1c2-t22"> -<p>Click <span class="bold">Browse</span> and select the primary key for the entity. Clicking the field name, which is represented as a hyperlink, allows you to create a new class.</p> +<td align="left" headers="r2c1-t21 r1c3-t21"> +<p>Database</p> </td> -<td align="left" headers="r3c1-t22 r1c3-t22"><br /></td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformalwide" --> +<!-- class="inftblhruleinformal" --> <a id="sthref412" name="sthref412"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> +<p><a href="tasks022.htm#BABBAGFI">Generating entities from tables</a></p> +</li> +<li> +<p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> <a id="sthref413" name="sthref413"></a> <p class="subhead2">Related reference</p> <ul> <li> -<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> +<p><a href="reference007.htm#CIAIJCCE">Create ORM Mapping File wizard</a></p> </li> </ul> </div> <!-- class="sect3" --> +<!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference016.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference016.htm index db69ffe003..2a196e0e71 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference016.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference016.htm @@ -5,252 +5,40 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Caching</title> +<title>Property pages</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Caching" /> +<meta name="doctitle" content="Property pages" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACJBBCA" name="CACJBBCA"></a></p> -<div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Caching</h1> -<p><a id="sthref414" name="sthref414"></a>This table lists the Caching information fields available in the <span class="gui-object-title">JPA Details</span> view for each entity type.</p> -<div class="inftblhruleinformalwide"> -<table class="HRuleInformalWide" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="16%" /> -<col width="*" /> -<col width="16%" /> -<col width="20%" /> -<thead> -<tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t23">Property</th> -<th align="left" valign="bottom" id="r1c2-t23">Description</th> -<th align="left" valign="bottom" id="r1c3-t23">Default</th> -<th align="left" valign="bottom" id="r1c4-t23">Available for Entity Type</th> -</tr> -</thead> -<tbody> -<tr align="left" valign="top"> -<td align="left" id="r2c1-t23" headers="r1c1-t23"> -<p><span class="bold">Cachable</span></p> -</td> -<td align="left" headers="r2c1-t23 r1c2-t23"> -<p>Specifies if the entity is cachable.</p> -<p>This field corresponds to the <code>@Cachable</code> annotation.</p> -</td> -<td align="left" headers="r2c1-t23 r1c3-t23"> -<p>True</p> -</td> -<td align="left" headers="r2c1-t23 r1c4-t23"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t23" headers="r1c1-t23"> -<p>Type</p> -</td> -<td align="left" headers="r3c1-t23 r1c2-t23"> -<p>Select one of the following as the Default Cache Type:</p> -<ul> -<li> -<p><span class="bold">Weak with Soft Subcache</span>–This option is similar to <span class="bold">Weak with Hard Subcache</span> except that it maintains a most frequently used subcache that uses soft references. The size of the subcache is proportional to the size of the identity map. The subcache uses soft references to ensure that these objects are garbage-collected only if the system is low on memory.</p> -<p>Use this identity map in most circumstances as a means to control memory used by the cache.</p> -</li> -<li> -<p><span class="bold">Weak with Hard Subcache</span>–This option is similar to <span class="bold">Soft with Weak</span> subcache except that it maintains a most frequently used subcache that uses hard references. Use this identity map if soft references are not suitable for your platform.</p> -</li> -<li> -<p><span class="bold">Weak</span>–This option is similar to <span class="bold">Full</span>, except that objects are referenced using weak references. This option uses less memory than <span class="bold">Full</span>, allows complete garbage collection and provides full caching and guaranteed identity.</p> -<p>Use this identity map for transactions that, once started, stay on the server side.</p> -</li> -<li> -<p><span class="bold">Soft</span>–This option is similar to <span class="bold">Weak</span> except that the map holds the objects using soft references. This identity map enables full garbage collection when memory is low. It provides full caching and guaranteed identity.</p> -</li> -<li> -<p><span class="bold">Full</span>–This option provides full caching and guaranteed identity: all objects are cached and not removed.</p> -<p>Note: This process may be memory-intensive when many objects are read.</p> -</li> -<li> -<p><span class="bold">None</span>–This option does not preserve object identity and does not cache objects.This option is not recommended.</p> -</li> -</ul> -</td> -<td align="left" headers="r3c1-t23 r1c3-t23"> -<p>Weak with Soft Subcache</p> -</td> -<td align="left" headers="r3c1-t23 r1c4-t23"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t23" headers="r1c1-t23"> -<p>Size</p> -</td> -<td align="left" headers="r4c1-t23 r1c2-t23"> -<p>Defines the size of cache to use (number of objects).</p> -</td> -<td align="left" headers="r4c1-t23 r1c3-t23"> -<p>100</p> -</td> -<td align="left" headers="r4c1-t23 r1c4-t23"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t23" headers="r1c1-t23"> -<p><span class="bold">Advanced</span></p> -</td> -<td align="left" headers="r5c1-t23 r1c2-t23"><br /></td> -<td align="left" headers="r5c1-t23 r1c3-t23"><br /></td> -<td align="left" headers="r5c1-t23 r1c4-t23"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t23" headers="r1c1-t23"> -<p>Expiry</p> -</td> -<td align="left" headers="r6c1-t23 r1c2-t23"> -<p>Enables the expiration of the cached instance after a fixed period of time (milliseconds). Queries executed against the cache after this will be forced back to the database for a refreshed copy.</p> -</td> -<td align="left" headers="r6c1-t23 r1c3-t23"> -<p>No expiry</p> -</td> -<td align="left" headers="r6c1-t23 r1c4-t23"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t23" headers="r1c1-t23"> -<p>Always refresh</p> -</td> -<td align="left" headers="r7c1-t23 r1c2-t23"> -<p>Specifies if all queries that go to the database should always refresh the cache.</p> -</td> -<td align="left" headers="r7c1-t23 r1c3-t23"> -<p>False</p> -</td> -<td align="left" headers="r7c1-t23 r1c4-t23"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r8c1-t23" headers="r1c1-t23"> -<p>Refresh only if newer</p> -</td> -<td align="left" headers="r8c1-t23 r1c2-t23"> -<p>Specifies if all queries that go to the database should refresh the cache only if the data received from the database by a query is newer than the data in the cache (as determined by the optimistic locking field).</p> -<p><span class="bold">Note</span>s:</p> -<ul> -<li> -<p>This option only applies if one of the other refreshing options, such as alwaysRefresh, is already enabled.</p> -</li> -<li> -<p>A version field is necessary to apply this feature.</p> -</li> -</ul> -</td> -<td align="left" headers="r8c1-t23 r1c3-t23"> -<p>False</p> -</td> -<td align="left" headers="r8c1-t23 r1c4-t23"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r9c1-t23" headers="r1c1-t23"> -<p>Disable hits</p> -</td> -<td align="left" headers="r9c1-t23 r1c2-t23"> -<p>Specifies if all queries should bypass the cache for hits, but still resolve against the cache for identity. This forces all queries to hit the database.</p> -</td> -<td align="left" headers="r9c1-t23 r1c3-t23"> -<p>False</p> -</td> -<td align="left" headers="r9c1-t23 r1c4-t23"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r10c1-t23" headers="r1c1-t23"> -<p>Coordination type</p> -</td> -<td align="left" headers="r10c1-t23 r1c2-t23"> -<p>Specify the cache coordination mode:</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACDJIIG" name="CACDJIIG"></a></p> +<div class="sect1"><!-- infolevel="all" infotype="General" --> +<h1>Property pages</h1> +<p><a id="sthref425" name="sthref425"></a>This section includes information each property page in the following views:</p> <ul> <li> -<p>Send Object Changes</p> -</li> -<li> -<p>Invalidate Changed Objects</p> -</li> -<li> -<p>Send New Objects with Changes</p> -</li> -<li> -<p>None</p> -</li> -</ul> -</td> -<td align="left" headers="r10c1-t23 r1c3-t23"> -<p>Send Object Changes</p> -</td> -<td align="left" headers="r10c1-t23 r1c4-t23"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r11c1-t23" headers="r1c1-t23"> -<p><span class="bold">Existence checking</span></p> -</td> -<td align="left" headers="r11c1-t23 r1c2-t23"> -<p>Specify how Dali should check to determine if an entity is new or exists.</p> -<ul> -<li> -<p>Check Cache – If the object's primary key does not include null and it is in the cache, then it must exist.</p> -</li> -<li> -<p>Check Cache then Database – Perform a "does exist check" on the database.</p> +<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> <li> -<p>Assume Existence – If the object's primary key does not include null then it must exist. You may use this option if the application guarantees or does not care about the existence check.</p> +<p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> </li> <li> -<p>Assume Non-existence – Assume that the object does not exist. You may use this option if the application guarantees or does not care about the existence check. This will always force an INSERT operation.</p> +<p><a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a></p> </li> -</ul> -</td> -<td align="left" headers="r11c1-t23 r1c3-t23"> -<p>Check Cache then Database</p> -</td> -<td align="left" headers="r11c1-t23 r1c4-t23"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblhruleinformalwide" --> -<a id="sthref415" name="sthref415"></a> -<p class="subhead2">Related reference</p> -<ul> <li> -<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> +<p><a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a></p> </li> <li> -<p>"Cache" in <span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span> <br /> -<code><a href="http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_cache.htm">http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_cache.htm</a></code></p> +<p><a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a></p> </li> </ul> -</div> -<!-- class="sect3" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> @@ -262,6 +50,6 @@ </tr> </table> </div> -<!-- class="footer" --> +<!-- class="footer" --></div> </body> </html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference017.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference017.htm index f9bf0db111..9a12747880 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference017.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference017.htm @@ -5,188 +5,126 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Queries</title> +<title>Entity</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Queries" /> +<meta name="doctitle" content="Entity" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACBICGJ" name="CACBICGJ"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACCAGGC" name="CACCAGGC"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Queries</h1> -<p><a id="sthref416" name="sthref416"></a><a id="sthref417" name="sthref417"></a><a id="sthref418" name="sthref418"></a>Use the queries area of the JPA Details view to create named queries and named native queries. Refer to <a href="tasks009.htm#BABIGBGG">"Creating queries"</a> for additional information.</p> +<h1>Entity</h1> +<p>This table lists the Entity information fields available in the <span class="gui-object-title">JPA Details</span> view for an <a href="tasks003.htm#BABGBIEE">Entity</a>.</p> <div class="inftblhruleinformalwide"> -<table class="HRuleInformalWide" title="This table describes the options on the Persistence Properties view, Inheritance tab." summary="This table describes the options on the Persistence Properties view, Inheritance tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="16%" /> +<table class="HRuleInformalWide" title="JPA Details, Entity page" summary="JPA Details, Entity page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="20%" /> <col width="*" /> -<col width="16%" /> -<col width="19%" /> +<col width="24%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t24">Property</th> -<th align="left" valign="bottom" id="r1c2-t24">Description</th> -<th align="left" valign="bottom" id="r1c3-t24">Default</th> -<th align="left" valign="bottom" id="r1c4-t24">Available for Entity Type</th> +<th align="left" valign="bottom" id="r1c1-t23">Property</th> +<th align="left" valign="bottom" id="r1c2-t23">Description</th> +<th align="left" valign="bottom" id="r1c3-t23">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t24" headers="r1c1-t24"> -<p><span class="bold">Queries</span></p> +<td align="left" id="r2c1-t23" headers="r1c1-t23"> +<p><span class="bold">Table</span></p> </td> -<td align="left" headers="r2c1-t24 r1c2-t24"> -<p>Displays the existing Named and Native queries.</p> -<p>Click <span class="bold">Add</span> to add a named or named native query by using the <a href="reference066.htm#CACJIFEG">Add Query dialog</a>.</p> +<td align="left" headers="r2c1-t23 r1c2-t23"> +<p>The default database table information for this entity. These fields can be overridden by the information in the <a href="reference023.htm#CACIJBGH">Attribute Overrides</a> area.</p> </td> -<td align="left" headers="r2c1-t24 r1c3-t24"><br /></td> -<td align="left" headers="r2c1-t24 r1c4-t24"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> +<td align="left" headers="r2c1-t23 r1c3-t23"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t23" headers="r1c1-t23"> +<p>Name</p> </td> +<td align="left" headers="r3c1-t23 r1c2-t23"> +<p>The name of the primary database table associated with the entity.</p> +</td> +<td align="left" headers="r3c1-t23 r1c3-t23"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t24" headers="r1c1-t24"> -<p><span class="bold">Named Queries</span></p> +<td align="left" id="r4c1-t23" headers="r1c1-t23"> +<p>Catalog</p> +</td> +<td align="left" headers="r4c1-t23 r1c2-t23"> +<p>The database catalog that contains the <span class="bold">Table</span>.</p> +</td> +<td align="left" headers="r4c1-t23 r1c3-t23"> +<p>As defined in <code>orm.xml</code>.</p> </td> -<td align="left" headers="r3c1-t24 r1c2-t24"><br /></td> -<td align="left" headers="r3c1-t24 r1c3-t24"><br /></td> -<td align="left" headers="r3c1-t24 r1c4-t24"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t24" headers="r1c1-t24"> -<p>Name</p> +<td align="left" id="r5c1-t23" headers="r1c1-t23"> +<p>Schema</p> </td> -<td align="left" headers="r4c1-t24 r1c2-t24"> -<p>Name of the query.</p> +<td align="left" headers="r5c1-t23 r1c2-t23"> +<p>The database schema that contains the <span class="bold">Table</span>.</p> </td> -<td align="left" headers="r4c1-t24 r1c3-t24"><br /></td> -<td align="left" headers="r4c1-t24 r1c4-t24"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> +<td align="left" headers="r5c1-t23 r1c3-t23"> +<p>As defined in <code>orm.xml</code>.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t24" headers="r1c1-t24"> -<p>Query</p> +<td align="left" id="r6c1-t23" headers="r1c1-t23"> +<p><span class="bold">Name</span></p> </td> -<td align="left" headers="r5c1-t24 r1c2-t24"><br /></td> -<td align="left" headers="r5c1-t24 r1c3-t24"><br /></td> -<td align="left" headers="r5c1-t24 r1c4-t24"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> +<td align="left" headers="r6c1-t23 r1c2-t23"> +<p>The name of this entity. By default, the class name is used as the entity name.</p> </td> +<td align="left" headers="r6c1-t23 r1c3-t23"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t24" headers="r1c1-t24"> -<p>Lock mode</p> +<td align="left" id="r7c1-t23" headers="r1c1-t23"> +<p><span class="bold">Access</span></p> </td> -<td align="left" headers="r6c1-t24 r1c2-t24"> +<td align="left" headers="r7c1-t23 r1c2-t23"> +<p>Specify how the entity its access instance variables.</p> <ul> <li> -<p>None</p> -</li> -<li> -<p>Optimistic</p> -</li> -<li> -<p>Optimistic Force Increment</p> -</li> -<li> -<p>Pessimistic Force Increment</p> -</li> -<li> -<p>Pessimistic Read</p> +<p>Property – Persistent state accessed through the property accessor methods. The property accessor methods must be <span class="bold">public</span> or <span class="bold">private</span>.</p> </li> <li> -<p>Pessimistic Write</p> -</li> -<li> -<p>Read</p> -</li> -<li> -<p>Write</p> +<p>Field – Instance variables are accessed directly. All non-transient instance variables are persistent.</p> </li> </ul> +<p><span class="bold">Note</span>: This field is for display only, based on the properties in the <code>orm.xml</code>: If only the methods of the class are annotated, <span class="bold">property</span> access type is used. In all other cases, <span class="bold">field</span> access type is used.</p> </td> -<td align="left" headers="r6c1-t24 r1c3-t24"> -<p>None</p> -</td> -<td align="left" headers="r6c1-t24 r1c4-t24"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> +<td align="left" headers="r7c1-t23 r1c3-t23"> +<p>Field</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r7c1-t24" headers="r1c1-t24"> -<p><span class="bold">Native Queries</span></p> -</td> -<td align="left" headers="r7c1-t24 r1c2-t24"><br /></td> -<td align="left" headers="r7c1-t24 r1c3-t24"><br /></td> -<td align="left" headers="r7c1-t24 r1c4-t24"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r8c1-t24" headers="r1c1-t24"> -<p>Name</p> -</td> -<td align="left" headers="r8c1-t24 r1c2-t24"> -<p>Name of the query.</p> -</td> -<td align="left" headers="r8c1-t24 r1c3-t24"><br /></td> -<td align="left" headers="r8c1-t24 r1c4-t24"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r9c1-t24" headers="r1c1-t24"> -<p>Result class</p> -</td> -<td align="left" headers="r9c1-t24 r1c2-t24"> -<p>The class of the result.</p> -<p><span class="bold">Note</span>: This field appears for Native Named Queries only.</p> -</td> -<td align="left" headers="r9c1-t24 r1c3-t24"><br /></td> -<td align="left" headers="r9c1-t24 r1c4-t24"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r10c1-t24" headers="r1c1-t24"> -<p>Query</p> -</td> -<td align="left" headers="r10c1-t24 r1c2-t24"><br /></td> -<td align="left" headers="r10c1-t24 r1c3-t24"><br /></td> -<td align="left" headers="r10c1-t24 r1c4-t24"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r11c1-t24" headers="r1c1-t24"> -<p><span class="bold">Query hints</span></p> -</td> -<td align="left" headers="r11c1-t24 r1c2-t24"> -<p>Displays the existing query hints (Name and Value).</p> -<p>Click Add to add a new query hint.</p> +<td align="left" id="r8c1-t23" headers="r1c1-t23"> +<p><span class="bold">ID class</span></p> </td> -<td align="left" headers="r11c1-t24 r1c3-t24"><br /></td> -<td align="left" headers="r11c1-t24 r1c4-t24"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> +<td align="left" headers="r8c1-t23 r1c2-t23"> +<p>Click <span class="bold">Browse</span> and select the primary key for the entity. Clicking the field name, which is represented as a hyperlink, allows you to create a new class.</p> </td> +<td align="left" headers="r8c1-t23 r1c3-t23"><br /></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformalwide" --> -<a id="sthref419" name="sthref419"></a> +<a id="sthref431" name="sthref431"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="tasks009.htm#BABIGBGG">Creating queries</a></p> +<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> </ul> -<a id="sthref420" name="sthref420"></a> +<a id="sthref432" name="sthref432"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference018.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference018.htm index 069e8a3102..0687c89e66 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference018.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference018.htm @@ -5,177 +5,73 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Inheritance</title> +<title>Embeddable</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Inheritance" /> +<meta name="doctitle" content="Embeddable" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACFHGHE" name="CACFHGHE"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACHJEJH" name="CACHJEJH"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Inheritance</h1> -<p><a id="sthref421" name="sthref421"></a><a id="sthref422" name="sthref422"></a>This table lists the fields available on the <span class="gui-object-title">Inheritance</span> area in the <span class="gui-object-title">JPA Details</span> view for each entity type.</p> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" title="This table describes the options on the Persistence Properties view, Inheritance tab." summary="This table describes the options on the Persistence Properties view, Inheritance tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="16%" /> +<h1>Embeddable</h1> +<p><a id="sthref433" name="sthref433"></a>This table lists the Embeddable information fields available in the <span class="gui-object-title">JPA Details</span> view for <a href="tasks004.htm#BABFEICE">Embeddable</a> entity type.</p> +<div class="inftblhruleinformalwide"> +<table class="HRuleInformalWide" summary="JPA Details view, Embeddable page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="19%" /> <col width="*" /> -<col width="15%" /> -<col width="20%" /> +<col width="19%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t25">Property</th> -<th align="left" valign="bottom" id="r1c2-t25">Description</th> -<th align="left" valign="bottom" id="r1c3-t25">Default</th> -<th align="left" valign="bottom" id="r1c4-t25">Available for Entity Type</th> +<th align="left" valign="bottom" id="r1c1-t24">Property</th> +<th align="left" valign="bottom" id="r1c2-t24">Description</th> +<th align="left" valign="bottom" id="r1c3-t24">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t25" headers="r1c1-t25"> -<p>Strategy</p> +<td align="left" id="r2c1-t24" headers="r1c1-t24"> +<p>Access</p> </td> -<td align="left" headers="r2c1-t25 r1c2-t25"> -<p>Specify the strategy to use when mapping a class or class hierarchy:</p> +<td align="left" headers="r2c1-t24 r1c2-t24"> +<p>Specify how the entity its access instance variables.</p> <ul> <li> -<p><span class="bold">Single table</span> – All classes in the hierarchy are mapped to a single table.</p> +<p>Property – Persistent state accessed through the property accessor methods. The property accessor methods must be <span class="bold">public</span> or <span class="bold">private</span>.</p> </li> <li> -<p><span class="bold">Joined</span> – The root of the hierarchy is mapped to a single table; each child maps to its own table.</p> -</li> -<li> -<p><span class="bold">Table per class</span> – Each class is mapped to a separate table.</p> +<p>Field – Instance variables are accessed directly. All non-transient instance variables are persistent.</p> </li> </ul> -<p>This field corresponds to the <code>@Inheritance</code> annotation.</p> -</td> -<td align="left" headers="r2c1-t25 r1c3-t25"> -<p>Single table</p> -</td> -<td align="left" headers="r2c1-t25 r1c4-t25"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t25" headers="r1c1-t25"> -<p><a id="sthref423" name="sthref423"></a><a id="sthref424" name="sthref424"></a>Discriminator Value</p> -</td> -<td align="left" headers="r3c1-t25 r1c2-t25"> -<p>Specify the discriminator value used to differentiate an entity in this inheritance hierarchy. The value must conform to the specified <span class="bold">Discriminator Type</span>.</p> -</td> -<td align="left" headers="r3c1-t25 r1c3-t25"><br /></td> -<td align="left" headers="r3c1-t25 r1c4-t25"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t25" headers="r1c1-t25"> -<p><a id="sthref425" name="sthref425"></a><a id="sthref426" name="sthref426"></a><span class="bold">Discriminator Column</span></p> -</td> -<td align="left" headers="r4c1-t25 r1c2-t25"> -<p>These fields are available when using a <span class="bold">Single</span> or <span class="bold">Joined</span> inheritance strategy.</p> -<p>This field corresponds to the <code>@DiscriminatorColumn</code> annotation.</p> -<p>Use the <span class="bold">Details</span> area to define the <span class="bold">Length</span> and <span class="bold">Column definition</span> of this Discriminator Column.</p> -</td> -<td align="left" headers="r4c1-t25 r1c3-t25"><br /></td> -<td align="left" headers="r4c1-t25 r1c4-t25"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t25" headers="r1c1-t25"> -<p>Name</p> -</td> -<td align="left" headers="r5c1-t25 r1c2-t25"> -<p>Name of the discriminator column</p> -</td> -<td align="left" headers="r5c1-t25 r1c3-t25"><br /></td> -<td align="left" headers="r5c1-t25 r1c4-t25"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t25" headers="r1c1-t25"> -<p>Type</p> +<p><span class="bold">Note</span>: This field is for display only, based on the properties in the <code>orm.xml</code>: If only the methods of the class are annotated, <span class="bold">property</span> access type is used. In all other cases, <span class="bold">field</span> access type is used.</p> </td> -<td align="left" headers="r6c1-t25 r1c2-t25"> -<p>Set this field to set the discriminator type to <code>Char</code> or <code>Integer</code> (instead of its default: <code>String</code>). The <span class="bold">Discriminator Value</span> must conform to this type.</p> +<td align="left" headers="r2c1-t24 r1c3-t24"> +<p>Field</p> </td> -<td align="left" headers="r6c1-t25 r1c3-t25"> -<p>String</p> -</td> -<td align="left" headers="r6c1-t25 r1c4-t25"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t25" headers="r1c1-t25"> -<p>Length</p> -</td> -<td align="left" headers="r7c1-t25 r1c2-t25"> -<p>The column length for String-based discriminator types.</p> -</td> -<td align="left" headers="r7c1-t25 r1c3-t25"> -<p>0</p> -</td> -<td align="left" headers="r7c1-t25 r1c4-t25"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r8c1-t25" headers="r1c1-t25"> -<p>Column definition</p> -</td> -<td align="left" headers="r8c1-t25 r1c2-t25"> -<p>The SQL fragment that is used when generating the DDL for the discriminator column.</p> -</td> -<td align="left" headers="r8c1-t25 r1c3-t25"><br /></td> -<td align="left" headers="r8c1-t25 r1c4-t25"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r9c1-t25" headers="r1c1-t25"> -<p><span class="bold">Primary Key Join Columns</span></p> -</td> -<td align="left" headers="r9c1-t25 r1c2-t25"> -<p>Use to override the default primary key join columns. Select <span class="bold">Override Default</span>, then click <span class="bold">Add</span> to select new Join Column with the <a href="reference067.htm#CACDGGDB">Add Primary Key Join Column dialog</a>.</p> -<p>This field corresponds with @<code>PrimaryKeyJoinColum</code>n annotation.</p> -</td> -<td align="left" headers="r9c1-t25 r1c3-t25"><br /></td> -<td align="left" headers="r9c1-t25 r1c4-t25"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformal" --> -<p>Refer to <a href="task_inheritance.htm#CIHCCCJD">"Specifying entity inheritance"</a> for additional information.</p> -<a id="sthref427" name="sthref427"></a> +<!-- class="inftblhruleinformalwide" --> +<a id="sthref434" name="sthref434"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="task_inheritance.htm#CIHCCCJD">Specifying entity inheritance</a></p> -</li> -<li> <p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> </ul> -<a id="sthref428" name="sthref428"></a> +<a id="sthref435" name="sthref435"></a> <p class="subhead2">Related reference</p> <ul> <li> <p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> -<li> -<p><a href="reference067.htm#CACDGGDB">Add Primary Key Join Column dialog</a></p> -</li> </ul> </div> <!-- class="sect3" --> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference019.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference019.htm index 8e273348a8..a5c92c903c 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference019.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference019.htm @@ -5,76 +5,77 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Attribute Overrides</title> +<title>Mapped Superclass</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Attribute Overrides" /> +<meta name="doctitle" content="Mapped Superclass" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACIJBGH" name="CACIJBGH"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACGIEFD" name="CACGIEFD"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Attribute Overrides</h1> -<p><a id="sthref429" name="sthref429"></a><a id="sthref430" name="sthref430"></a><a id="sthref431" name="sthref431"></a>Use the <span class="gui-object-title">Attribute Overrides</span> area in the <span class="gui-object-title">JPA Details</span> view to override the default settings specified in the <a href="reference013.htm#CACCAGGC">Entity</a> area of an attribute. Attribute overrides generally override/configure attributes that are inherited or embedded.</p> -<p>This table lists the Attribute override fields available in the <span class="gui-object-title">JPA Details</span> view for each entity type.</p> +<h1>Mapped Superclass</h1> +<p><a id="sthref436" name="sthref436"></a>This table lists the Embeddable information fields available in the <span class="gui-object-title">JPA Details</span> view for <a href="tasks005.htm#BABDAGCI">Mapped superclass</a> entity type.</p> <div class="inftblhruleinformalwide"> -<table class="HRuleInformalWide" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="16%" /> +<table class="HRuleInformalWide" summary="JPA Details view, Mapped Superclass page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="19%" /> <col width="*" /> -<col width="17%" /> -<col width="25%" /> +<col width="19%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t26">Property</th> -<th align="left" valign="bottom" id="r1c2-t26">Description</th> -<th align="left" valign="bottom" id="r1c3-t26">Default</th> -<th align="left" valign="bottom" id="r1c4-t26">Available for Entity Type</th> +<th align="left" valign="bottom" id="r1c1-t25">Property</th> +<th align="left" valign="bottom" id="r1c2-t25">Description</th> +<th align="left" valign="bottom" id="r1c3-t25">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t26" headers="r1c1-t26"> -<p>Attribute Overrides</p> +<td align="left" id="r2c1-t25" headers="r1c1-t25"> +<p>Access</p> </td> -<td align="left" headers="r2c1-t26 r1c2-t26"> -<p>Specify a property or field to be overridden (from the default mappings). Select <span class="bold">Override Default</span>.</p> +<td align="left" headers="r2c1-t25 r1c2-t25"> +<p>Specify how the entity its access instance variables.</p> +<ul> +<li> +<p>Property – Persistent state accessed through the property accessor methods. The property accessor methods must be <span class="bold">public</span> or <span class="bold">private</span>.</p> +</li> +<li> +<p>Field – Instance variables are accessed directly. All non-transient instance variables are persistent.</p> +</li> +</ul> +<p><span class="bold">Note</span>: This field is for display only, based on the properties in the <code>orm.xml</code>: If only the methods of the class are annotated, <span class="bold">property</span> access type is used. In all other cases, <span class="bold">field</span> access type is used.</p> +</td> +<td align="left" headers="r2c1-t25 r1c3-t25"> +<p>Field</p> </td> -<td align="left" headers="r2c1-t26 r1c3-t26"><br /></td> -<td align="left" headers="r2c1-t26 r1c4-t26"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t26" headers="r1c1-t26"> -<p>Join Columns</p> +<td align="left" id="r3c1-t25" headers="r1c1-t25"> +<p>ID class</p> +</td> +<td align="left" headers="r3c1-t25 r1c2-t25"> +<p>Click <span class="bold">Browse</span> and select the primary key for the entity. Clicking the field name, which is represented as a hyperlink, allows you to create a new class.</p> </td> -<td align="left" headers="r3c1-t26 r1c2-t26"><br /></td> -<td align="left" headers="r3c1-t26 r1c3-t26"><br /></td> -<td align="left" headers="r3c1-t26 r1c4-t26"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> +<td align="left" headers="r3c1-t25 r1c3-t25"><br /></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformalwide" --> -<a id="sthref432" name="sthref432"></a> +<a id="sthref437" name="sthref437"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="task_inheritance.htm#CIHCCCJD">Specifying entity inheritance</a></p> -</li> -<li> <p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> </ul> -<a id="sthref433" name="sthref433"></a> +<a id="sthref438" name="sthref438"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference020.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference020.htm index 37ba5b32e3..ac45e81f60 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference020.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference020.htm @@ -5,197 +5,248 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Multitenancy</title> +<title>Caching</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Multitenancy" /> +<meta name="doctitle" content="Caching" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACDIJEE" name="CACDIJEE"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACJBBCA" name="CACJBBCA"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Multitenancy</h1> -<p><a id="sthref434" name="sthref434"></a>Use the <span class="gui-object-title">Multitenancy</span> area in the <span class="gui-object-title">JPA Details</span> view to specify that a given entity is shared among multiple tenants of an application.</p> +<h1>Caching</h1> +<p><a id="sthref439" name="sthref439"></a>This table lists the Caching information fields available in the <span class="gui-object-title">JPA Details</span> view for each entity type.</p> <div class="inftblhruleinformalwide"> -<table class="HRuleInformalWide" title="JPA Details view, Multienancy page" summary="JPA Details view, Multienancy page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<table class="HRuleInformalWide" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="16%" /> <col width="*" /> -<col width="17%" /> -<col width="25%" /> +<col width="16%" /> +<col width="20%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t27">Property</th> -<th align="left" valign="bottom" id="r1c2-t27">Description</th> -<th align="left" valign="bottom" id="r1c3-t27">Default</th> -<th align="left" valign="bottom" id="r1c4-t27">Available for Entity Type</th> +<th align="left" valign="bottom" id="r1c1-t26">Property</th> +<th align="left" valign="bottom" id="r1c2-t26">Description</th> +<th align="left" valign="bottom" id="r1c3-t26">Default</th> +<th align="left" valign="bottom" id="r1c4-t26">Available for Entity Type</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t27" headers="r1c1-t27"> -<p>Multitenancy strategy</p> +<td align="left" id="r2c1-t26" headers="r1c1-t26"> +<p><span class="bold">Cachable</span></p> +</td> +<td align="left" headers="r2c1-t26 r1c2-t26"> +<p>Specifies if the entity is cachable.</p> +<p>This field corresponds to the <code>@Cachable</code> annotation.</p> +</td> +<td align="left" headers="r2c1-t26 r1c3-t26"> +<p>True</p> </td> -<td align="left" headers="r2c1-t27 r1c2-t27"> -<p>Specify the multitenant strategy to use:</p> +<td align="left" headers="r2c1-t26 r1c4-t26"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t26" headers="r1c1-t26"> +<p>Type</p> +</td> +<td align="left" headers="r3c1-t26 r1c2-t26"> +<p>Select one of the following as the Default Cache Type:</p> <ul> <li> -<p>Single table</p> +<p><span class="bold">Weak with Soft Subcache</span>–This option is similar to <span class="bold">Weak with Hard Subcache</span> except that it maintains a most frequently used subcache that uses soft references. The size of the subcache is proportional to the size of the identity map. The subcache uses soft references to ensure that these objects are garbage-collected only if the system is low on memory.</p> +<p>Use this identity map in most circumstances as a means to control memory used by the cache.</p> +</li> +<li> +<p><span class="bold">Weak with Hard Subcache</span>–This option is similar to <span class="bold">Soft with Weak</span> subcache except that it maintains a most frequently used subcache that uses hard references. Use this identity map if soft references are not suitable for your platform.</p> +</li> +<li> +<p><span class="bold">Weak</span>–This option is similar to <span class="bold">Full</span>, except that objects are referenced using weak references. This option uses less memory than <span class="bold">Full</span>, allows complete garbage collection and provides full caching and guaranteed identity.</p> +<p>Use this identity map for transactions that, once started, stay on the server side.</p> +</li> +<li> +<p><span class="bold">Soft</span>–This option is similar to <span class="bold">Weak</span> except that the map holds the objects using soft references. This identity map enables full garbage collection when memory is low. It provides full caching and guaranteed identity.</p> </li> <li> -<p>Table per tenant</p> +<p><span class="bold">Full</span>–This option provides full caching and guaranteed identity: all objects are cached and not removed.</p> +<p>Note: This process may be memory-intensive when many objects are read.</p> </li> <li> -<p>VPD</p> +<p><span class="bold">None</span>–This option does not preserve object identity and does not cache objects.This option is not recommended.</p> </li> </ul> </td> -<td align="left" headers="r2c1-t27 r1c3-t27"> -<p>Single table</p> +<td align="left" headers="r3c1-t26 r1c3-t26"> +<p>Weak with Soft Subcache</p> </td> -<td align="left" headers="r2c1-t27 r1c4-t27"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> +<td align="left" headers="r3c1-t26 r1c4-t26"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t27" headers="r1c1-t27"> -<p>Include criteria</p> +<td align="left" id="r4c1-t26" headers="r1c1-t26"> +<p>Size</p> </td> -<td align="left" headers="r3c1-t27 r1c2-t27"> -<p>Specify if the database requires the tenant criteria to be added to the <code>SELECT</code>, <code>UPDATE</code>, and <code>DELETE</code> queries.</p> +<td align="left" headers="r4c1-t26 r1c2-t26"> +<p>Defines the size of cache to use (number of objects).</p> </td> -<td align="left" headers="r3c1-t27 r1c3-t27"> -<p>True</p> +<td align="left" headers="r4c1-t26 r1c3-t26"> +<p>100</p> </td> -<td align="left" headers="r3c1-t27 r1c4-t27"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> +<td align="left" headers="r4c1-t26 r1c4-t26"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t27" headers="r1c1-t27"> -<p><span class="bold">Tenant descriptor columns</span></p> +<td align="left" id="r5c1-t26" headers="r1c1-t26"> +<p><span class="bold">Advanced</span></p> </td> -<td align="left" headers="r4c1-t27 r1c2-t27"> -<p>Use to limit what a persistence context can access in single-table mulitenancy</p> -</td> -<td align="left" headers="r4c1-t27 r1c3-t27"><br /></td> -<td align="left" headers="r4c1-t27 r1c4-t27"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> +<td align="left" headers="r5c1-t26 r1c2-t26"><br /></td> +<td align="left" headers="r5c1-t26 r1c3-t26"><br /></td> +<td align="left" headers="r5c1-t26 r1c4-t26"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t27" headers="r1c1-t27"> -<p>Override default</p> +<td align="left" id="r6c1-t26" headers="r1c1-t26"> +<p>Expiry</p> </td> -<td align="left" headers="r5c1-t27 r1c2-t27"><br /></td> -<td align="left" headers="r5c1-t27 r1c3-t27"><br /></td> -<td align="left" headers="r5c1-t27 r1c4-t27"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t27" headers="r1c1-t27"> -<p>Name</p> +<td align="left" headers="r6c1-t26 r1c2-t26"> +<p>Enables the expiration of the cached instance after a fixed period of time (milliseconds). Queries executed against the cache after this will be forced back to the database for a refreshed copy.</p> </td> -<td align="left" headers="r6c1-t27 r1c2-t27"> -<p>The name of column to be used for the tenant discriminator.</p> +<td align="left" headers="r6c1-t26 r1c3-t26"> +<p>No expiry</p> </td> -<td align="left" headers="r6c1-t27 r1c3-t27"> -<p>eclipselink.tenant-id</p> +<td align="left" headers="r6c1-t26 r1c4-t26"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r6c1-t27 r1c4-t27"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r7c1-t27" headers="r1c1-t27"> -<p>Table</p> +<td align="left" id="r7c1-t26" headers="r1c1-t26"> +<p>Always refresh</p> </td> -<td align="left" headers="r7c1-t27 r1c2-t27"> -<p>The name of the table that contains the column.</p> +<td align="left" headers="r7c1-t26 r1c2-t26"> +<p>Specifies if all queries that go to the database should always refresh the cache.</p> </td> -<td align="left" headers="r7c1-t27 r1c3-t27"><br /></td> -<td align="left" headers="r7c1-t27 r1c4-t27"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r8c1-t27" headers="r1c1-t27"> -<p>Context property</p> +<td align="left" headers="r7c1-t26 r1c3-t26"> +<p>False</p> </td> -<td align="left" headers="r8c1-t27 r1c2-t27"> -<p>The name of the context property to apply to the tenant discriminator column.</p> +<td align="left" headers="r7c1-t26 r1c4-t26"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r8c1-t27 r1c3-t27"><br /></td> -<td align="left" headers="r8c1-t27 r1c4-t27"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r9c1-t27" headers="r1c1-t27"> -<p>Discriminator type</p> +<td align="left" id="r8c1-t26" headers="r1c1-t26"> +<p>Refresh only if newer</p> </td> -<td align="left" headers="r9c1-t27 r1c2-t27"> -<p>The type of object/column to use as a class discriminator:</p> +<td align="left" headers="r8c1-t26 r1c2-t26"> +<p>Specifies if all queries that go to the database should refresh the cache only if the data received from the database by a query is newer than the data in the cache (as determined by the optimistic locking field).</p> +<p><span class="bold">Note</span>s:</p> <ul> <li> -<p>Character</p> -</li> -<li> -<p>Integer</p> +<p>This option only applies if one of the other refreshing options, such as alwaysRefresh, is already enabled.</p> </li> <li> -<p>String</p> +<p>A version field is necessary to apply this feature.</p> </li> </ul> </td> -<td align="left" headers="r9c1-t27 r1c3-t27"> -<p>String</p> +<td align="left" headers="r8c1-t26 r1c3-t26"> +<p>False</p> +</td> +<td align="left" headers="r8c1-t26 r1c4-t26"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r9c1-t27 r1c4-t27"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r10c1-t27" headers="r1c1-t27"> -<p>Length</p> +<td align="left" id="r9c1-t26" headers="r1c1-t26"> +<p>Disable hits</p> +</td> +<td align="left" headers="r9c1-t26 r1c2-t26"> +<p>Specifies if all queries should bypass the cache for hits, but still resolve against the cache for identity. This forces all queries to hit the database.</p> </td> -<td align="left" headers="r10c1-t27 r1c2-t27"> -<p>The column length for String-based discriminator types.</p> +<td align="left" headers="r9c1-t26 r1c3-t26"> +<p>False</p> +</td> +<td align="left" headers="r9c1-t26 r1c4-t26"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r10c1-t27 r1c3-t27"><br /></td> -<td align="left" headers="r10c1-t27 r1c4-t27"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r11c1-t27" headers="r1c1-t27"> -<p>Column definition</p> +<td align="left" id="r10c1-t26" headers="r1c1-t26"> +<p>Coordination type</p> +</td> +<td align="left" headers="r10c1-t26 r1c2-t26"> +<p>Specify the cache coordination mode:</p> +<ul> +<li> +<p>Send Object Changes</p> +</li> +<li> +<p>Invalidate Changed Objects</p> +</li> +<li> +<p>Send New Objects with Changes</p> +</li> +<li> +<p>None</p> +</li> +</ul> </td> -<td align="left" headers="r11c1-t27 r1c2-t27"> -<p>The SQL fragment that is used when generating the DDL for the discriminator column.</p> +<td align="left" headers="r10c1-t26 r1c3-t26"> +<p>Send Object Changes</p> +</td> +<td align="left" headers="r10c1-t26 r1c4-t26"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r11c1-t27 r1c3-t27"><br /></td> -<td align="left" headers="r11c1-t27 r1c4-t27"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r12c1-t27" headers="r1c1-t27"> -<p>Primary key</p> +<td align="left" id="r11c1-t26" headers="r1c1-t26"> +<p><span class="bold">Existence checking</span></p> </td> -<td align="left" headers="r12c1-t27 r1c2-t27"> -<p>Specifies that the tenant discriminator column is part of the primary key of the tables.</p> +<td align="left" headers="r11c1-t26 r1c2-t26"> +<p>Specify how Dali should check to determine if an entity is new or exists.</p> +<ul> +<li> +<p>Check Cache – If the object's primary key does not include null and it is in the cache, then it must exist.</p> +</li> +<li> +<p>Check Cache then Database – Perform a "does exist check" on the database.</p> +</li> +<li> +<p>Assume Existence – If the object's primary key does not include null then it must exist. You may use this option if the application guarantees or does not care about the existence check.</p> +</li> +<li> +<p>Assume Non-existence – Assume that the object does not exist. You may use this option if the application guarantees or does not care about the existence check. This will always force an INSERT operation.</p> +</li> +</ul> </td> -<td align="left" headers="r12c1-t27 r1c3-t27"> -<p>False</p> +<td align="left" headers="r11c1-t26 r1c3-t26"> +<p>Check Cache then Database</p> +</td> +<td align="left" headers="r11c1-t26 r1c4-t26"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r12c1-t27 r1c4-t27"><br /></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformalwide" --> -<a id="sthref435" name="sthref435"></a> +<a id="sthref440" name="sthref440"></a> <p class="subhead2">Related reference</p> <ul> <li> <p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> <li> -<p>"Multitenant" in <span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span> <br /> -<code><a href="http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_multitenant.htm">http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_multitenant.htm</a></code></p> +<p>"Cache" in <span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span> <br /> +<code><a href="http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_cache.htm">http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_cache.htm</a></code></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference021.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference021.htm index b7196347b5..20d5e6347f 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference021.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference021.htm @@ -5,232 +5,188 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Primary Key Generation</title> +<title>Queries</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Primary Key Generation" /> +<meta name="doctitle" content="Queries" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACCJJDC" name="CACCJJDC"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACBICGJ" name="CACBICGJ"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref436" name="sthref436"></a><a id="sthref437" name="sthref437"></a>Primary Key Generation</h1> +<h1>Queries</h1> +<p><a id="sthref441" name="sthref441"></a><a id="sthref442" name="sthref442"></a><a id="sthref443" name="sthref443"></a>Use the queries area of the JPA Details view to create named queries and named native queries. Refer to <a href="tasks010.htm#BABIGBGG">"Creating queries"</a> for additional information.</p> <div class="inftblhruleinformalwide"> -<table class="HRuleInformalWide" title="JPA Details view, Primary key page" summary="JPA Details view, Primary key page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<table class="HRuleInformalWide" title="This table describes the options on the Persistence Properties view, Inheritance tab." summary="This table describes the options on the Persistence Properties view, Inheritance tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="16%" /> <col width="*" /> -<col width="17%" /> -<col width="25%" /> +<col width="16%" /> +<col width="19%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t28">Property</th> -<th align="left" valign="bottom" id="r1c2-t28">Description</th> -<th align="left" valign="bottom" id="r1c3-t28">Default</th> -<th align="left" valign="bottom" id="r1c4-t28">Available for Entity Type</th> +<th align="left" valign="bottom" id="r1c1-t27">Property</th> +<th align="left" valign="bottom" id="r1c2-t27">Description</th> +<th align="left" valign="bottom" id="r1c3-t27">Default</th> +<th align="left" valign="bottom" id="r1c4-t27">Available for Entity Type</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t28" headers="r1c1-t28"> -<p><span class="bold">Table Generator</span></p> -</td> -<td align="left" headers="r2c1-t28 r1c2-t28"> -<p>These fields define the database table used for generating the primary key and correspond to the <code>@TableGenerator</code> annotation.</p> +<td align="left" id="r2c1-t27" headers="r1c1-t27"> +<p><span class="bold">Queries</span></p> </td> -<td align="left" headers="r2c1-t28 r1c3-t28"><br /></td> -<td align="left" headers="r2c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t28" headers="r1c1-t28"> -<p>Name</p> +<td align="left" headers="r2c1-t27 r1c2-t27"> +<p>Displays the existing Named and Native queries.</p> +<p>Click <span class="bold">Add</span> to add a named or named native query by using the <a href="reference072.htm#CACJIFEG">Add Query dialog</a>.</p> </td> -<td align="left" headers="r3c1-t28 r1c2-t28"> -<p>Unique name of the generator.</p> +<td align="left" headers="r2c1-t27 r1c3-t27"><br /></td> +<td align="left" headers="r2c1-t27 r1c4-t27"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r3c1-t28 r1c3-t28"><br /></td> -<td align="left" headers="r3c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t28" headers="r1c1-t28"> -<p>Table</p> -</td> -<td align="left" headers="r4c1-t28 r1c2-t28"> -<p>Database table that stores the generated ID values.</p> +<td align="left" id="r3c1-t27" headers="r1c1-t27"> +<p><span class="bold">Named Queries</span></p> </td> -<td align="left" headers="r4c1-t28 r1c3-t28"><br /></td> -<td align="left" headers="r4c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> +<td align="left" headers="r3c1-t27 r1c2-t27"><br /></td> +<td align="left" headers="r3c1-t27 r1c3-t27"><br /></td> +<td align="left" headers="r3c1-t27 r1c4-t27"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t28" headers="r1c1-t28"> -<p>Schema</p> -</td> -<td align="left" headers="r5c1-t28 r1c2-t28"><br /></td> -<td align="left" headers="r5c1-t28 r1c3-t28"><br /></td> -<td align="left" headers="r5c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t28" headers="r1c1-t28"> -<p>Catalog</p> -</td> -<td align="left" headers="r6c1-t28 r1c2-t28"><br /></td> -<td align="left" headers="r6c1-t28 r1c3-t28"><br /></td> -<td align="left" headers="r6c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t28" headers="r1c1-t28"> -<p>Primary key column</p> +<td align="left" id="r4c1-t27" headers="r1c1-t27"> +<p>Name</p> +</td> +<td align="left" headers="r4c1-t27 r1c2-t27"> +<p>Name of the query.</p> </td> -<td align="left" headers="r7c1-t28 r1c2-t28"> -<p>The column in the table generator's <span class="bold">Table</span> that contains the primary key.</p> +<td align="left" headers="r4c1-t27 r1c3-t27"><br /></td> +<td align="left" headers="r4c1-t27 r1c4-t27"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r7c1-t28 r1c3-t28"><br /></td> -<td align="left" headers="r7c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r8c1-t28" headers="r1c1-t28"> -<p>Value column</p> +<td align="left" id="r5c1-t27" headers="r1c1-t27"> +<p>Query</p> </td> -<td align="left" headers="r8c1-t28 r1c2-t28"> -<p>The column that stores the generated ID values.</p> +<td align="left" headers="r5c1-t27 r1c2-t27"><br /></td> +<td align="left" headers="r5c1-t27 r1c3-t27"><br /></td> +<td align="left" headers="r5c1-t27 r1c4-t27"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r8c1-t28 r1c3-t28"><br /></td> -<td align="left" headers="r8c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r9c1-t28" headers="r1c1-t28"> -<p>Allocation size</p> +<td align="left" id="r6c1-t27" headers="r1c1-t27"> +<p>Lock mode</p> </td> -<td align="left" headers="r9c1-t28 r1c2-t28"> -<p>The value for the <span class="bold">Primary Key Column</span> in the generator table.</p> -</td> -<td align="left" headers="r9c1-t28 r1c3-t28"> -<p>50</p> +<td align="left" headers="r6c1-t27 r1c2-t27"> +<ul> +<li> +<p>None</p> +</li> +<li> +<p>Optimistic</p> +</li> +<li> +<p>Optimistic Force Increment</p> +</li> +<li> +<p>Pessimistic Force Increment</p> +</li> +<li> +<p>Pessimistic Read</p> +</li> +<li> +<p>Pessimistic Write</p> +</li> +<li> +<p>Read</p> +</li> +<li> +<p>Write</p> +</li> +</ul> </td> -<td align="left" headers="r9c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r10c1-t28" headers="r1c1-t28"> -<p>Initial value</p> +<td align="left" headers="r6c1-t27 r1c3-t27"> +<p>None</p> </td> -<td align="left" headers="r10c1-t28 r1c2-t28"><br /></td> -<td align="left" headers="r10c1-t28 r1c3-t28"> -<p>0</p> +<td align="left" headers="r6c1-t27 r1c4-t27"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r10c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r11c1-t28" headers="r1c1-t28"> -<p><span class="bold">Sequence Generator</span></p> -</td> -<td align="left" headers="r11c1-t28 r1c2-t28"> -<p><a id="sthref438" name="sthref438"></a><a id="sthref439" name="sthref439"></a>These fields define the specific sequence used for generating the primary key and correspond to the <code>@SequenceGenerator</code> annotation.</p> -<p>These fields apply only when <span class="bold">Strategy</span> = <span class="bold">Sequence</span>.</p> +<td align="left" id="r7c1-t27" headers="r1c1-t27"> +<p><span class="bold">Native Queries</span></p> </td> -<td align="left" headers="r11c1-t28 r1c3-t28"><br /></td> -<td align="left" headers="r11c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> +<td align="left" headers="r7c1-t27 r1c2-t27"><br /></td> +<td align="left" headers="r7c1-t27 r1c3-t27"><br /></td> +<td align="left" headers="r7c1-t27 r1c4-t27"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r12c1-t28" headers="r1c1-t28"> +<td align="left" id="r8c1-t27" headers="r1c1-t27"> <p>Name</p> </td> -<td align="left" headers="r12c1-t28 r1c2-t28"> -<p>Name of the sequence table to use for defining primary key values.</p> +<td align="left" headers="r8c1-t27 r1c2-t27"> +<p>Name of the query.</p> +</td> +<td align="left" headers="r8c1-t27 r1c3-t27"><br /></td> +<td align="left" headers="r8c1-t27 r1c4-t27"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r12c1-t28 r1c3-t28"><br /></td> -<td align="left" headers="r12c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r13c1-t28" headers="r1c1-t28"> -<p>Sequence</p> +<td align="left" id="r9c1-t27" headers="r1c1-t27"> +<p>Result class</p> </td> -<td align="left" headers="r13c1-t28 r1c2-t28"> -<p>Unique name of the sequence.</p> +<td align="left" headers="r9c1-t27 r1c2-t27"> +<p>The class of the result.</p> +<p><span class="bold">Note</span>: This field appears for Native Named Queries only.</p> +</td> +<td align="left" headers="r9c1-t27 r1c3-t27"><br /></td> +<td align="left" headers="r9c1-t27 r1c4-t27"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r13c1-t28 r1c3-t28"><br /></td> -<td align="left" headers="r13c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r14c1-t28" headers="r1c1-t28"> -<p>Schema</p> -</td> -<td align="left" headers="r14c1-t28 r1c2-t28"><br /></td> -<td align="left" headers="r14c1-t28 r1c3-t28"><br /></td> -<td align="left" headers="r14c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r15c1-t28" headers="r1c1-t28"> -<p>Catalog</p> -</td> -<td align="left" headers="r15c1-t28 r1c2-t28"><br /></td> -<td align="left" headers="r15c1-t28 r1c3-t28"><br /></td> -<td align="left" headers="r15c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r16c1-t28" headers="r1c1-t28"> -<p>Allocation size</p> -</td> -<td align="left" headers="r16c1-t28 r1c2-t28"> -<p><a id="sthref440" name="sthref440"></a><a id="sthref441" name="sthref441"></a>These fields define the specific sequence used for generating the primary key and correspond to the <code>@SequenceGenerator</code> annotation.</p> -<p>These fields apply only when <span class="bold">Strategy</span> = <span class="bold">Sequence</span>.</p> +<td align="left" id="r10c1-t27" headers="r1c1-t27"> +<p>Query</p> </td> -<td align="left" headers="r16c1-t28 r1c3-t28"> -<p>50</p> +<td align="left" headers="r10c1-t27 r1c2-t27"><br /></td> +<td align="left" headers="r10c1-t27 r1c3-t27"><br /></td> +<td align="left" headers="r10c1-t27 r1c4-t27"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r16c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r17c1-t28" headers="r1c1-t28"> -<p>Initial value</p> +<td align="left" id="r11c1-t27" headers="r1c1-t27"> +<p><span class="bold">Query hints</span></p> </td> -<td align="left" headers="r17c1-t28 r1c2-t28"><br /></td> -<td align="left" headers="r17c1-t28 r1c3-t28"> -<p>1</p> +<td align="left" headers="r11c1-t27 r1c2-t27"> +<p>Displays the existing query hints (Name and Value).</p> +<p>Click Add to add a new query hint.</p> +</td> +<td align="left" headers="r11c1-t27 r1c3-t27"><br /></td> +<td align="left" headers="r11c1-t27 r1c4-t27"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> -<td align="left" headers="r17c1-t28 r1c4-t28"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformalwide" --> -<a id="sthref442" name="sthref442"></a> +<a id="sthref444" name="sthref444"></a> +<p class="subhead2">Related tasks</p> +<ul> +<li> +<p><a href="tasks010.htm#BABIGBGG">Creating queries</a></p> +</li> +</ul> +<a id="sthref445" name="sthref445"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference022.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference022.htm index 39d8abaec4..a774d3657f 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference022.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference022.htm @@ -5,40 +5,177 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Secondary tables</title> +<title>Inheritance</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Secondary tables" /> +<meta name="doctitle" content="Inheritance" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACBHIDA" name="CACBHIDA"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACFHGHE" name="CACFHGHE"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Secondary tables</h1> -<p><a id="sthref443" name="sthref443"></a><a id="sthref444" name="sthref444"></a><a id="sthref445" name="sthref445"></a><a id="sthref446" name="sthref446"></a>Use the <span class="gui-object-title">Secondary Tables</span> area in the <span class="gui-object-title">JPA Details</span> view to associate additional tables with an entity. Use this area if the data associated with an entity is spread across multiple tables.</p> -<p>Refer to <a href="task_additonal_tables.htm#CIHGBIEI">"Specifying additional tables"</a> for additional information.</p> -<a id="sthref447" name="sthref447"></a> +<h1>Inheritance</h1> +<p><a id="sthref446" name="sthref446"></a><a id="sthref447" name="sthref447"></a>This table lists the fields available on the <span class="gui-object-title">Inheritance</span> area in the <span class="gui-object-title">JPA Details</span> view for each entity type.</p> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" title="This table describes the options on the Persistence Properties view, Inheritance tab." summary="This table describes the options on the Persistence Properties view, Inheritance tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="16%" /> +<col width="*" /> +<col width="15%" /> +<col width="20%" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t28">Property</th> +<th align="left" valign="bottom" id="r1c2-t28">Description</th> +<th align="left" valign="bottom" id="r1c3-t28">Default</th> +<th align="left" valign="bottom" id="r1c4-t28">Available for Entity Type</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t28" headers="r1c1-t28"> +<p>Strategy</p> +</td> +<td align="left" headers="r2c1-t28 r1c2-t28"> +<p>Specify the strategy to use when mapping a class or class hierarchy:</p> +<ul> +<li> +<p><span class="bold">Single table</span> – All classes in the hierarchy are mapped to a single table.</p> +</li> +<li> +<p><span class="bold">Joined</span> – The root of the hierarchy is mapped to a single table; each child maps to its own table.</p> +</li> +<li> +<p><span class="bold">Table per class</span> – Each class is mapped to a separate table.</p> +</li> +</ul> +<p>This field corresponds to the <code>@Inheritance</code> annotation.</p> +</td> +<td align="left" headers="r2c1-t28 r1c3-t28"> +<p>Single table</p> +</td> +<td align="left" headers="r2c1-t28 r1c4-t28"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t28" headers="r1c1-t28"> +<p><a id="sthref448" name="sthref448"></a><a id="sthref449" name="sthref449"></a>Discriminator Value</p> +</td> +<td align="left" headers="r3c1-t28 r1c2-t28"> +<p>Specify the discriminator value used to differentiate an entity in this inheritance hierarchy. The value must conform to the specified <span class="bold">Discriminator Type</span>.</p> +</td> +<td align="left" headers="r3c1-t28 r1c3-t28"><br /></td> +<td align="left" headers="r3c1-t28 r1c4-t28"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t28" headers="r1c1-t28"> +<p><a id="sthref450" name="sthref450"></a><a id="sthref451" name="sthref451"></a><span class="bold">Discriminator Column</span></p> +</td> +<td align="left" headers="r4c1-t28 r1c2-t28"> +<p>These fields are available when using a <span class="bold">Single</span> or <span class="bold">Joined</span> inheritance strategy.</p> +<p>This field corresponds to the <code>@DiscriminatorColumn</code> annotation.</p> +<p>Use the <span class="bold">Details</span> area to define the <span class="bold">Length</span> and <span class="bold">Column definition</span> of this Discriminator Column.</p> +</td> +<td align="left" headers="r4c1-t28 r1c3-t28"><br /></td> +<td align="left" headers="r4c1-t28 r1c4-t28"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t28" headers="r1c1-t28"> +<p>Name</p> +</td> +<td align="left" headers="r5c1-t28 r1c2-t28"> +<p>Name of the discriminator column</p> +</td> +<td align="left" headers="r5c1-t28 r1c3-t28"><br /></td> +<td align="left" headers="r5c1-t28 r1c4-t28"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t28" headers="r1c1-t28"> +<p>Type</p> +</td> +<td align="left" headers="r6c1-t28 r1c2-t28"> +<p>Set this field to set the discriminator type to <code>Char</code> or <code>Integer</code> (instead of its default: <code>String</code>). The <span class="bold">Discriminator Value</span> must conform to this type.</p> +</td> +<td align="left" headers="r6c1-t28 r1c3-t28"> +<p>String</p> +</td> +<td align="left" headers="r6c1-t28 r1c4-t28"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t28" headers="r1c1-t28"> +<p>Length</p> +</td> +<td align="left" headers="r7c1-t28 r1c2-t28"> +<p>The column length for String-based discriminator types.</p> +</td> +<td align="left" headers="r7c1-t28 r1c3-t28"> +<p>0</p> +</td> +<td align="left" headers="r7c1-t28 r1c4-t28"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r8c1-t28" headers="r1c1-t28"> +<p>Column definition</p> +</td> +<td align="left" headers="r8c1-t28 r1c2-t28"> +<p>The SQL fragment that is used when generating the DDL for the discriminator column.</p> +</td> +<td align="left" headers="r8c1-t28 r1c3-t28"><br /></td> +<td align="left" headers="r8c1-t28 r1c4-t28"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r9c1-t28" headers="r1c1-t28"> +<p><span class="bold">Primary Key Join Columns</span></p> +</td> +<td align="left" headers="r9c1-t28 r1c2-t28"> +<p>Use to override the default primary key join columns. Select <span class="bold">Override Default</span>, then click <span class="bold">Add</span> to select new Join Column with the <a href="reference073.htm#CACDGGDB">Add Primary Key Join Column dialog</a>.</p> +<p>This field corresponds with @<code>PrimaryKeyJoinColum</code>n annotation.</p> +</td> +<td align="left" headers="r9c1-t28 r1c3-t28"><br /></td> +<td align="left" headers="r9c1-t28 r1c4-t28"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<p>Refer to <a href="task_inheritance.htm#CIHCCCJD">"Specifying entity inheritance"</a> for additional information.</p> +<a id="sthref452" name="sthref452"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="task_additonal_tables.htm#CIHGBIEI">Specifying additional tables</a></p> +<p><a href="task_inheritance.htm#CIHCCCJD">Specifying entity inheritance</a></p> </li> <li> <p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> </ul> -<a id="sthref448" name="sthref448"></a> +<a id="sthref453" name="sthref453"></a> <p class="subhead2">Related reference</p> <ul> <li> <p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> +<li> +<p><a href="reference073.htm#CACDGGDB">Add Primary Key Join Column dialog</a></p> +</li> </ul> </div> <!-- class="sect3" --> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference023.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference023.htm index e805c0c45a..87cd97c265 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference023.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference023.htm @@ -5,25 +5,26 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Converters</title> +<title>Attribute Overrides</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Converters" /> +<meta name="doctitle" content="Attribute Overrides" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACJGDAJ" name="CACJGDAJ"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACIJBGH" name="CACIJBGH"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Converters</h1> -<p><a id="sthref449" name="sthref449"></a><a id="sthref450" name="sthref450"></a><a id="sthref451" name="sthref451"></a><a id="sthref452" name="sthref452"></a><a id="sthref453" name="sthref453"></a><a id="sthref454" name="sthref454"></a><a id="sthref455" name="sthref455"></a>Use the Converter area in the <span class="gui-object-title">JPA Details</span> view to specify a way to modify data value(s) during the reading and writing of a mapped attribute.</p> +<h1>Attribute Overrides</h1> +<p><a id="sthref454" name="sthref454"></a><a id="sthref455" name="sthref455"></a><a id="sthref456" name="sthref456"></a>Use the <span class="gui-object-title">Attribute Overrides</span> area in the <span class="gui-object-title">JPA Details</span> view to override the default settings specified in the <a href="reference017.htm#CACCAGGC">Entity</a> area of an attribute. Attribute overrides generally override/configure attributes that are inherited or embedded.</p> +<p>This table lists the Attribute override fields available in the <span class="gui-object-title">JPA Details</span> view for each entity type.</p> <div class="inftblhruleinformalwide"> -<table class="HRuleInformalWide" title="JPA Details view, Advanced page" summary="JPA Details view, Advanced page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<table class="HRuleInformalWide" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="16%" /> <col width="*" /> <col width="17%" /> @@ -39,117 +40,45 @@ <tbody> <tr align="left" valign="top"> <td align="left" id="r2c1-t29" headers="r1c1-t29"> -<p>Converters</p> +<p>Attribute Overrides</p> </td> <td align="left" headers="r2c1-t29 r1c2-t29"> -<p>Click Add and use the <a href="ref_add_converter.htm#CIAGCGIJ">Add Converter dialog</a> to create a new converter.</p> -<ul> -<li> -<p>Object Type – converts a fixed number of database data value(s) to Java object value(s)</p> -</li> -<li> -<p>Type – modifies data values</p> -</li> -<li> -<p>Struct – Enable custom processing of <code>java.sql.Struct</code> types</p> -</li> -<li> -<p>Custom</p> -</li> -</ul> +<p>Specify a property or field to be overridden (from the default mappings). Select <span class="bold">Override Default</span>.</p> </td> <td align="left" headers="r2c1-t29 r1c3-t29"><br /></td> <td align="left" headers="r2c1-t29 r1c4-t29"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a>, <a href="tasks003.htm#BABFEICE">Embeddable</a>, and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t29" headers="r1c1-t29"> -<p>Name</p> -</td> -<td align="left" headers="r3c1-t29 r1c2-t29"> -<p>The <code>String</code> name for your converter, must be unique across the persistence unit</p> +<p>Join Columns</p> </td> +<td align="left" headers="r3c1-t29 r1c2-t29"><br /></td> <td align="left" headers="r3c1-t29 r1c3-t29"><br /></td> <td align="left" headers="r3c1-t29 r1c4-t29"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a>, <a href="tasks003.htm#BABFEICE">Embeddable</a>, and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t29" headers="r1c1-t29"> -<p>Class</p> -</td> -<td align="left" headers="r4c1-t29 r1c2-t29"> -<p>The class of your converter. This class must implement the <code>org.eclipse.persistence.mappings.converters.Converter</code> interface.</p> -<p>Appears for <span class="bold">Custom</span> and <span class="bold">Struct</span> converters only.</p> -</td> -<td align="left" headers="r4c1-t29 r1c3-t29"><br /></td> -<td align="left" headers="r4c1-t29 r1c4-t29"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a>, <a href="tasks003.htm#BABFEICE">Embeddable</a>, and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t29" headers="r1c1-t29"> -<p>Data type</p> -</td> -<td align="left" headers="r5c1-t29 r1c2-t29"> -<p>The type stored in the database.</p> -<p>Appears for <span class="bold">Object Type</span> and <span class="bold">Type</span> converters only.</p> -</td> -<td align="left" headers="r5c1-t29 r1c3-t29"><br /></td> -<td align="left" headers="r5c1-t29 r1c4-t29"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a>, <a href="tasks003.htm#BABFEICE">Embeddable</a>, and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t29" headers="r1c1-t29"> -<p>Object type</p> -</td> -<td align="left" headers="r6c1-t29 r1c2-t29"> -<p>The type stored on the entity.</p> -<p>Appears for <span class="bold">Object Type</span> and <span class="bold">Type</span> converters only.</p> -</td> -<td align="left" headers="r6c1-t29 r1c3-t29"><br /></td> -<td align="left" headers="r6c1-t29 r1c4-t29"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a>, <a href="tasks003.htm#BABFEICE">Embeddable</a>, and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t29" headers="r1c1-t29"> -<p>Conversion values</p> -</td> -<td align="left" headers="r7c1-t29 r1c2-t29"> -<p>The array of conversion values (instances of <code>ConversionValue</code>: <code>String</code> <code>objectValue</code> and <code>String</code> <code>dataValue</code>).</p> -<p>Appears for <span class="bold">Object Type</span> converters only.</p> -</td> -<td align="left" headers="r7c1-t29 r1c3-t29"><br /></td> -<td align="left" headers="r7c1-t29 r1c4-t29"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a>, <a href="tasks003.htm#BABFEICE">Embeddable</a>, and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r8c1-t29" headers="r1c1-t29"> -<p>Default object value</p> -</td> -<td align="left" headers="r8c1-t29 r1c2-t29"> -<p>Set the value of this attribute to the default object value. Note that this argument is for dealing with legacy data if the data value is missing.</p> -<p>Appears for <span class="bold">Object Type</span> converters only.</p> -</td> -<td align="left" headers="r8c1-t29 r1c3-t29"><br /></td> -<td align="left" headers="r8c1-t29 r1c4-t29"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a>, <a href="tasks003.htm#BABFEICE">Embeddable</a>, and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformalwide" --> -<a id="sthref456" name="sthref456"></a> +<a id="sthref457" name="sthref457"></a> +<p class="subhead2">Related tasks</p> +<ul> +<li> +<p><a href="task_inheritance.htm#CIHCCCJD">Specifying entity inheritance</a></p> +</li> +<li> +<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> +</li> +</ul> +<a id="sthref458" name="sthref458"></a> <p class="subhead2">Related reference</p> <ul> <li> -<p>"Converter" in <span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> -<code><a href="http://eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_converter.htm">http://eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_converter.htm</a></code></p> +<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference024.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference024.htm index b2145a0c43..115950daf4 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference024.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference024.htm @@ -5,25 +5,25 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Advanced</title> +<title>Multitenancy</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Advanced" /> +<meta name="doctitle" content="Multitenancy" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACJEEDE" name="CACJEEDE"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACDIJEE" name="CACDIJEE"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Advanced</h1> -<p><a id="sthref457" name="sthref457"></a><a id="sthref458" name="sthref458"></a><a id="sthref459" name="sthref459"></a><a id="sthref460" name="sthref460"></a><a id="sthref461" name="sthref461"></a><a id="sthref462" name="sthref462"></a><a id="sthref463" name="sthref463"></a><a id="sthref464" name="sthref464"></a><a id="sthref465" name="sthref465"></a>Use the <span class="gui-object-title">Advanced</span> area in the <span class="gui-object-title">JPA Details</span> view to configure additional settings for an entity.</p> +<h1>Multitenancy</h1> +<p><a id="sthref459" name="sthref459"></a>Use the <span class="gui-object-title">Multitenancy</span> area in the <span class="gui-object-title">JPA Details</span> view to specify that a given entity is shared among multiple tenants of an application.</p> <div class="inftblhruleinformalwide"> -<table class="HRuleInformalWide" title="JPA Details view, Advanced page" summary="JPA Details view, Advanced page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<table class="HRuleInformalWide" title="JPA Details view, Multienancy page" summary="JPA Details view, Multienancy page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="16%" /> <col width="*" /> <col width="17%" /> @@ -39,78 +39,167 @@ <tbody> <tr align="left" valign="top"> <td align="left" id="r2c1-t30" headers="r1c1-t30"> -<p>Read-only</p> +<p>Multitenancy strategy</p> </td> <td align="left" headers="r2c1-t30 r1c2-t30"> -<p>Specifies if a class is read-only.</p> +<p>Specify the multitenant strategy to use:</p> +<ul> +<li> +<p>Single table</p> +</li> +<li> +<p>Table per tenant</p> +</li> +<li> +<p>VPD</p> +</li> +</ul> </td> <td align="left" headers="r2c1-t30 r1c3-t30"> -<p>False</p> +<p>Single table</p> </td> <td align="left" headers="r2c1-t30 r1c4-t30"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a> and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> </tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t30" headers="r1c1-t30"> -<p>Customizer class</p> +<p>Include criteria</p> </td> <td align="left" headers="r3c1-t30 r1c2-t30"> -<p>Specifies a class that implements <code>DescriptorCustomizer</code> and is to run against an entity's class descriptor after all metadata processing has been completed.</p> +<p>Specify if the database requires the tenant criteria to be added to the <code>SELECT</code>, <code>UPDATE</code>, and <code>DELETE</code> queries.</p> </td> <td align="left" headers="r3c1-t30 r1c3-t30"> <p>True</p> </td> <td align="left" headers="r3c1-t30 r1c4-t30"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a>, <a href="tasks003.htm#BABFEICE">Embeddable</a>, and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </td> </tr> <tr align="left" valign="top"> <td align="left" id="r4c1-t30" headers="r1c1-t30"> -<p>Change tracking</p> +<p><span class="bold">Tenant descriptor columns</span></p> </td> <td align="left" headers="r4c1-t30 r1c2-t30"> -<p>Specifies the <code>ObjectChangePolicy</code> to use:</p> +<p>Use to limit what a persistence context can access in single-table mulitenancy</p> +</td> +<td align="left" headers="r4c1-t30 r1c3-t30"><br /></td> +<td align="left" headers="r4c1-t30 r1c4-t30"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t30" headers="r1c1-t30"> +<p>Override default</p> +</td> +<td align="left" headers="r5c1-t30 r1c2-t30"><br /></td> +<td align="left" headers="r5c1-t30 r1c3-t30"><br /></td> +<td align="left" headers="r5c1-t30 r1c4-t30"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t30" headers="r1c1-t30"> +<p>Name</p> +</td> +<td align="left" headers="r6c1-t30 r1c2-t30"> +<p>The name of column to be used for the tenant discriminator.</p> +</td> +<td align="left" headers="r6c1-t30 r1c3-t30"> +<p>eclipselink.tenant-id</p> +</td> +<td align="left" headers="r6c1-t30 r1c4-t30"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t30" headers="r1c1-t30"> +<p>Table</p> +</td> +<td align="left" headers="r7c1-t30 r1c2-t30"> +<p>The name of the table that contains the column.</p> +</td> +<td align="left" headers="r7c1-t30 r1c3-t30"><br /></td> +<td align="left" headers="r7c1-t30 r1c4-t30"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r8c1-t30" headers="r1c1-t30"> +<p>Context property</p> +</td> +<td align="left" headers="r8c1-t30 r1c2-t30"> +<p>The name of the context property to apply to the tenant discriminator column.</p> +</td> +<td align="left" headers="r8c1-t30 r1c3-t30"><br /></td> +<td align="left" headers="r8c1-t30 r1c4-t30"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r9c1-t30" headers="r1c1-t30"> +<p>Discriminator type</p> +</td> +<td align="left" headers="r9c1-t30 r1c2-t30"> +<p>The type of object/column to use as a class discriminator:</p> <ul> <li> -<p><span class="bold">Attribute</span> – Objects with changed attributes will be processed in the commit process to include any changes in the results of the commit. Unchanged objects will be ignored.</p> -</li> -<li> -<p><span class="bold">Object</span> – Changed objects will be processed in the commit process to include any changes in the results of the commit. Unchanged objects will be ignored.</p> +<p>Character</p> </li> <li> -<p><span class="bold">Deferred</span> – Defers all change detection to the UnitOfWork's change detection process.</p> +<p>Integer</p> </li> <li> -<p><span class="bold">Auto</span> – Does not set any change tracking policy; change tracking will be determined at runtime.</p> +<p>String</p> </li> </ul> </td> -<td align="left" headers="r4c1-t30 r1c3-t30"> -<p>Auto</p> +<td align="left" headers="r9c1-t30 r1c3-t30"> +<p>String</p> </td> -<td align="left" headers="r4c1-t30 r1c4-t30"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a>, <a href="tasks003.htm#BABFEICE">Embeddable</a>, and <a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> +<td align="left" headers="r9c1-t30 r1c4-t30"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r10c1-t30" headers="r1c1-t30"> +<p>Length</p> +</td> +<td align="left" headers="r10c1-t30 r1c2-t30"> +<p>The column length for String-based discriminator types.</p> +</td> +<td align="left" headers="r10c1-t30 r1c3-t30"><br /></td> +<td align="left" headers="r10c1-t30 r1c4-t30"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r11c1-t30" headers="r1c1-t30"> +<p>Column definition</p> +</td> +<td align="left" headers="r11c1-t30 r1c2-t30"> +<p>The SQL fragment that is used when generating the DDL for the discriminator column.</p> +</td> +<td align="left" headers="r11c1-t30 r1c3-t30"><br /></td> +<td align="left" headers="r11c1-t30 r1c4-t30"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r12c1-t30" headers="r1c1-t30"> +<p>Primary key</p> +</td> +<td align="left" headers="r12c1-t30 r1c2-t30"> +<p>Specifies that the tenant discriminator column is part of the primary key of the tables.</p> +</td> +<td align="left" headers="r12c1-t30 r1c3-t30"> +<p>False</p> </td> +<td align="left" headers="r12c1-t30 r1c4-t30"><br /></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformalwide" --> -<a id="sthref466" name="sthref466"></a> +<a id="sthref460" name="sthref460"></a> <p class="subhead2">Related reference</p> <ul> <li> <p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> <li> -<p>"Read Only" and "ChangeTracking" in <span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> -<code><a href="http://eclipse.org/eclipselink/documentation/2.4/jpa/">http://eclipse.org/eclipselink/documentation/2.4/jpa/</a></code></p> +<p>"Multitenant" in <span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span> <br /> +<code><a href="http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_multitenant.htm">http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_multitenant.htm</a></code></p> </li> </ul> </div> <!-- class="sect3" --> -<!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference025.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference025.htm index 3cbd92c04c..8e30134813 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference025.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference025.htm @@ -5,209 +5,236 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Basic Mapping</title> +<title>Primary Key Generation</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Basic Mapping" /> +<meta name="doctitle" content="Primary Key Generation" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACCGGCG" name="CACCGGCG"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACCJJDC" name="CACCJJDC"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref473" name="sthref473"></a><a id="sthref474" name="sthref474"></a><a id="sthref475" name="sthref475"></a>Basic Mapping</h1> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="JPA Details view, Version page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="22%" /> +<h1><a id="sthref461" name="sthref461"></a><a id="sthref462" name="sthref462"></a>Primary Key Generation</h1> +<div class="inftblhruleinformalwide"> +<table class="HRuleInformalWide" title="JPA Details view, Primary key page" summary="JPA Details view, Primary key page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="16%" /> <col width="*" /> -<col width="31%" /> +<col width="17%" /> +<col width="25%" /> <thead> <tr align="left" valign="top"> <th align="left" valign="bottom" id="r1c1-t31">Property</th> <th align="left" valign="bottom" id="r1c2-t31">Description</th> <th align="left" valign="bottom" id="r1c3-t31">Default</th> +<th align="left" valign="bottom" id="r1c4-t31">Available for Entity Type</th> </tr> </thead> <tbody> <tr align="left" valign="top"> <td align="left" id="r2c1-t31" headers="r1c1-t31"> -<p><span class="bold">Column</span></p> +<p><span class="bold">Table Generator</span></p> </td> <td align="left" headers="r2c1-t31 r1c2-t31"> -<p><a id="sthref476" name="sthref476"></a><a id="sthref477" name="sthref477"></a>The database column that contains the value for the attribute. This field corresponds to the <code>@Column</code> annotation.</p> -</td> -<td align="left" headers="r2c1-t31 r1c3-t31"> -<p>By default, the Column is assumed to be named identically to the attribute and always included in the <code>INSERT</code> and <code>UPDATE</code> statements.</p> +<p>These fields define the database table used for generating the primary key and correspond to the <code>@TableGenerator</code> annotation.</p> </td> +<td align="left" headers="r2c1-t31 r1c3-t31"><br /></td> +<td align="left" headers="r2c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t31" headers="r1c1-t31"> <p>Name</p> </td> <td align="left" headers="r3c1-t31 r1c2-t31"> -<p>The database column that contains the value for the attribute.</p> +<p>Unique name of the generator.</p> </td> <td align="left" headers="r3c1-t31 r1c3-t31"><br /></td> +<td align="left" headers="r3c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r4c1-t31" headers="r1c1-t31"> <p>Table</p> </td> <td align="left" headers="r4c1-t31 r1c2-t31"> -<p>Name of the database table that contains the selected column.</p> +<p>Database table that stores the generated ID values.</p> </td> <td align="left" headers="r4c1-t31 r1c3-t31"><br /></td> +<td align="left" headers="r4c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r5c1-t31" headers="r1c1-t31"> -<p><span class="bold">Details</span></p> +<p>Schema</p> </td> <td align="left" headers="r5c1-t31 r1c2-t31"><br /></td> <td align="left" headers="r5c1-t31 r1c3-t31"><br /></td> +<td align="left" headers="r5c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r6c1-t31" headers="r1c1-t31"> -<p>Insertable</p> -</td> -<td align="left" headers="r6c1-t31 r1c2-t31"> -<p>Specifies if the column is always included in <code>SQL INSERT</code> statements.</p> -</td> -<td align="left" headers="r6c1-t31 r1c3-t31"> -<p>True</p> +<p>Catalog</p> </td> +<td align="left" headers="r6c1-t31 r1c2-t31"><br /></td> +<td align="left" headers="r6c1-t31 r1c3-t31"><br /></td> +<td align="left" headers="r6c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r7c1-t31" headers="r1c1-t31"> -<p>Updatable</p> +<p>Primary key column</p> </td> <td align="left" headers="r7c1-t31 r1c2-t31"> -<p>Specifies if this column is always included in <code>SQL UPDATE</code> statements.</p> -</td> -<td align="left" headers="r7c1-t31 r1c3-t31"> -<p>True</p> +<p>The column in the table generator's <span class="bold">Table</span> that contains the primary key.</p> </td> +<td align="left" headers="r7c1-t31 r1c3-t31"><br /></td> +<td align="left" headers="r7c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r8c1-t31" headers="r1c1-t31"> -<p>Unique</p> +<p>Value column</p> </td> <td align="left" headers="r8c1-t31 r1c2-t31"> -<p>Sets the <code>UNIQUE</code> constraint for the column.</p> -</td> -<td align="left" headers="r8c1-t31 r1c3-t31"> -<p>False</p> +<p>The column that stores the generated ID values.</p> </td> +<td align="left" headers="r8c1-t31 r1c3-t31"><br /></td> +<td align="left" headers="r8c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r9c1-t31" headers="r1c1-t31"> -<p>Nullable</p> +<p>Allocation size</p> </td> <td align="left" headers="r9c1-t31 r1c2-t31"> -<p>Specifies if the column allows null values.</p> +<p>The value for the <span class="bold">Primary Key Column</span> in the generator table.</p> </td> <td align="left" headers="r9c1-t31 r1c3-t31"> -<p>True</p> +<p>50</p> </td> +<td align="left" headers="r9c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r10c1-t31" headers="r1c1-t31"> -<p>Length</p> -</td> -<td align="left" headers="r10c1-t31 r1c2-t31"> -<p>Sets the column length.</p> +<p>Initial value</p> </td> +<td align="left" headers="r10c1-t31 r1c2-t31"><br /></td> <td align="left" headers="r10c1-t31 r1c3-t31"> -<p>255</p> +<p>0</p> </td> +<td align="left" headers="r10c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r11c1-t31" headers="r1c1-t31"> -<p>Precision</p> +<p><span class="bold">Sequence Generator</span></p> </td> <td align="left" headers="r11c1-t31 r1c2-t31"> -<p>Sets the precision for the column values.</p> -</td> -<td align="left" headers="r11c1-t31 r1c3-t31"> -<p>0</p> +<p><a id="sthref463" name="sthref463"></a><a id="sthref464" name="sthref464"></a>These fields define the specific sequence used for generating the primary key and correspond to the <code>@SequenceGenerator</code> annotation.</p> +<p>These fields apply only when <span class="bold">Strategy</span> = <span class="bold">Sequence</span>.</p> </td> +<td align="left" headers="r11c1-t31 r1c3-t31"><br /></td> +<td align="left" headers="r11c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r12c1-t31" headers="r1c1-t31"> -<p>Scale</p> +<p>Name</p> </td> <td align="left" headers="r12c1-t31 r1c2-t31"> -<p>Sets the number of digits that appear to the right of the decimal point.</p> -</td> -<td align="left" headers="r12c1-t31 r1c3-t31"> -<p>0</p> +<p>Name of the sequence table to use for defining primary key values.</p> </td> +<td align="left" headers="r12c1-t31 r1c3-t31"><br /></td> +<td align="left" headers="r12c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r13c1-t31" headers="r1c1-t31"> -<p>Column definition</p> +<p>Sequence</p> </td> <td align="left" headers="r13c1-t31 r1c2-t31"> -<p>The SQL fragment that is used when generating the DDL for the column.</p> +<p>Unique name of the sequence.</p> </td> <td align="left" headers="r13c1-t31 r1c3-t31"><br /></td> +<td align="left" headers="r13c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r14c1-t31" headers="r1c1-t31"> -<p><a id="sthref478" name="sthref478"></a><a id="sthref479" name="sthref479"></a><a id="sthref480" name="sthref480"></a><span class="bold">Fetch</span></p> -</td> -<td align="left" headers="r14c1-t31 r1c2-t31"> -<p>Defines how data is loaded from the database:</p> -<ul> -<li> -<p>Eager – Data is loaded in before it is actually needed.</p> -</li> -<li> -<p>Lazy – Data is loaded only when required by the transaction.</p> -</li> -</ul> -</td> -<td align="left" headers="r14c1-t31 r1c3-t31"> -<p>Eager</p> +<p>Schema</p> </td> +<td align="left" headers="r14c1-t31 r1c2-t31"><br /></td> +<td align="left" headers="r14c1-t31 r1c3-t31"><br /></td> +<td align="left" headers="r14c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r15c1-t31" headers="r1c1-t31"> -<p><span class="bold">Optional</span></p> -</td> -<td align="left" headers="r15c1-t31 r1c2-t31"> -<p>Specifies if this field is can be null.</p> -</td> -<td align="left" headers="r15c1-t31 r1c3-t31"> -<p>True</p> +<p>Catalog</p> </td> +<td align="left" headers="r15c1-t31 r1c2-t31"><br /></td> +<td align="left" headers="r15c1-t31 r1c3-t31"><br /></td> +<td align="left" headers="r15c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r16c1-t31" headers="r1c1-t31"> -<p><span class="bold">Mutable</span></p> +<p>Allocation size</p> </td> <td align="left" headers="r16c1-t31 r1c2-t31"> -<p>Specify if the value of a complex field type can be changed (or not changed) instead of being replaced.</p> +<p><a id="sthref465" name="sthref465"></a><a id="sthref466" name="sthref466"></a>These fields define the specific sequence used for generating the primary key and correspond to the <code>@SequenceGenerator</code> annotation.</p> +<p>These fields apply only when <span class="bold">Strategy</span> = <span class="bold">Sequence</span>.</p> </td> <td align="left" headers="r16c1-t31 r1c3-t31"> -<p>True</p> +<p>50</p> </td> +<td align="left" headers="r16c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r17c1-t31" headers="r1c1-t31"> +<p>Initial value</p> +</td> +<td align="left" headers="r17c1-t31 r1c2-t31"><br /></td> +<td align="left" headers="r17c1-t31 r1c3-t31"> +<p>1</p> +</td> +<td align="left" headers="r17c1-t31 r1c4-t31"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformal" --> -<p>Basic mappings also include the following areas:</p> +<!-- class="inftblhruleinformalwide" --> +<a id="sthref467" name="sthref467"></a> +<p class="subhead2">Related reference</p> <ul> <li> -<p><a href="reference035.htm#CACIHAAF">Type information</a></p> -</li> -<li> -<p><a href="reference037.htm#CACJCHJB">Converters</a></p> +<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference026.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference026.htm index ebab1cd521..3ee82405b1 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference026.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference026.htm @@ -5,146 +5,39 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Element Collection Mapping</title> +<title>Secondary tables</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Element Collection Mapping" /> +<meta name="doctitle" content="Secondary tables" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACBCGDI" name="CACBCGDI"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACBHIDA" name="CACBHIDA"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref481" name="sthref481"></a><a id="sthref482" name="sthref482"></a>Element Collection Mapping</h1> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="JPA Details view, Version page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="29%" /> -<col width="*" /> -<col width="24%" /> -<thead> -<tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t32">Property</th> -<th align="left" valign="bottom" id="r1c2-t32">Description</th> -<th align="left" valign="bottom" id="r1c3-t32">Default</th> -</tr> -</thead> -<tbody> -<tr align="left" valign="top"> -<td align="left" id="r2c1-t32" headers="r1c1-t32"> -<p>Target class</p> -</td> -<td align="left" headers="r2c1-t32 r1c2-t32"> -<p>The class (basic or embeddable) that is the element type of the collection.</p> -</td> -<td align="left" headers="r2c1-t32 r1c3-t32"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t32" headers="r1c1-t32"> -<p>Fetch</p> -</td> -<td align="left" headers="r3c1-t32 r1c2-t32"> -<p>Defines how data is loaded from the database:</p> +<h1>Secondary tables</h1> +<p><a id="sthref468" name="sthref468"></a><a id="sthref469" name="sthref469"></a><a id="sthref470" name="sthref470"></a><a id="sthref471" name="sthref471"></a>Use the <span class="gui-object-title">Secondary Tables</span> area in the <span class="gui-object-title">JPA Details</span> view to associate additional tables with an entity. Use this area if the data associated with an entity is spread across multiple tables.</p> +<p>Refer to <a href="task_additonal_tables.htm#CIHGBIEI">"Specifying additional tables"</a> for additional information.</p> +<a id="sthref472" name="sthref472"></a> +<p class="subhead2">Related tasks</p> <ul> <li> -<p>Eager – Data is loaded in before it is actually needed.</p> +<p><a href="task_additonal_tables.htm#CIHGBIEI">Specifying additional tables</a></p> </li> <li> -<p>Lazy – Data is loaded only when required by the transaction.</p> +<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> </ul> -</td> -<td align="left" headers="r3c1-t32 r1c3-t32"> -<p>Lazy</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t32" headers="r1c1-t32"> -<p>Join fetch</p> -</td> -<td align="left" headers="r4c1-t32 r1c2-t32"> -<p>The type of fetch to use:</p> -<ul> -<li> -<p>Inner – Provides the inner join fetching of the related object.</p> -<p><span class="bold">Note</span>: Inner joining does not allow for null or empty values</p> -</li> -<li> -<p>Outer – Provides the outer join fetching of the related object</p> -<p><span class="bold">Note</span>: Outer joining allows for null or empty values.</p> -</li> -</ul> -</td> -<td align="left" headers="r4c1-t32 r1c3-t32"> -<p>None</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t32" headers="r1c1-t32"> -<p><span class="bold">Collection Table</span></p> -</td> -<td align="left" headers="r5c1-t32 r1c2-t32"><br /></td> -<td align="left" headers="r5c1-t32 r1c3-t32"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t32" headers="r1c1-t32"> -<p>Name</p> -</td> -<td align="left" headers="r6c1-t32 r1c2-t32"><br /></td> -<td align="left" headers="r6c1-t32 r1c3-t32"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t32" headers="r1c1-t32"> -<p>Schema</p> -</td> -<td align="left" headers="r7c1-t32 r1c2-t32"><br /></td> -<td align="left" headers="r7c1-t32 r1c3-t32"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r8c1-t32" headers="r1c1-t32"> -<p>Catalog</p> -</td> -<td align="left" headers="r8c1-t32 r1c2-t32"><br /></td> -<td align="left" headers="r8c1-t32 r1c3-t32"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r9c1-t32" headers="r1c1-t32"> -<p><span class="bold">Join Columns</span></p> -</td> -<td align="left" headers="r9c1-t32 r1c2-t32"><br /></td> -<td align="left" headers="r9c1-t32 r1c3-t32"> -<p>0</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r10c1-t32" headers="r1c1-t32"> -<p>Override default</p> -</td> -<td align="left" headers="r10c1-t32 r1c2-t32"> -<p>Click <span class="bold">Add</span> to create a new join column, by using the <a href="reference062.htm#CACJJBAD">Add Join Column dialog</a>.</p> -</td> -<td align="left" headers="r10c1-t32 r1c3-t32"> -<p>0</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblhruleinformal" --> -<p>Element collection mappings also include the following areas:</p> +<a id="sthref473" name="sthref473"></a> +<p class="subhead2">Related reference</p> <ul> <li> -<p><a href="reference036.htm#CACJBFEA">Value</a></p> -</li> -<li> -<p><a href="reference037.htm#CACJCHJB">Converters</a></p> -</li> -<li> -<p><a href="reference038.htm#CACBIJFD">Ordering</a></p> +<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference027.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference027.htm index 117bde58ce..de74984a49 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference027.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference027.htm @@ -5,22 +5,153 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Embedded Mapping</title> +<title>Converters</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Embedded Mapping" /> +<meta name="doctitle" content="Converters" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACBJBFD" name="CACBJBFD"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACJGDAJ" name="CACJGDAJ"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Embedded Mapping</h1> +<h1>Converters</h1> +<p><a id="sthref474" name="sthref474"></a><a id="sthref475" name="sthref475"></a><a id="sthref476" name="sthref476"></a><a id="sthref477" name="sthref477"></a><a id="sthref478" name="sthref478"></a><a id="sthref479" name="sthref479"></a><a id="sthref480" name="sthref480"></a>Use the Converter area in the <span class="gui-object-title">JPA Details</span> view to specify a way to modify data value(s) during the reading and writing of a mapped attribute.</p> +<div class="inftblhruleinformalwide"> +<table class="HRuleInformalWide" title="JPA Details view, Advanced page" summary="JPA Details view, Advanced page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="16%" /> +<col width="*" /> +<col width="17%" /> +<col width="25%" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t32">Property</th> +<th align="left" valign="bottom" id="r1c2-t32">Description</th> +<th align="left" valign="bottom" id="r1c3-t32">Default</th> +<th align="left" valign="bottom" id="r1c4-t32">Available for Entity Type</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t32" headers="r1c1-t32"> +<p>Converters</p> +</td> +<td align="left" headers="r2c1-t32 r1c2-t32"> +<p>Click Add and use the <a href="ref_add_converter.htm#CIAGCGIJ">Add Converter dialog</a> to create a new converter.</p> +<ul> +<li> +<p>Object Type – converts a fixed number of database data value(s) to Java object value(s)</p> +</li> +<li> +<p>Type – modifies data values</p> +</li> +<li> +<p>Struct – Enable custom processing of <code>java.sql.Struct</code> types</p> +</li> +<li> +<p>Custom</p> +</li> +</ul> +</td> +<td align="left" headers="r2c1-t32 r1c3-t32"><br /></td> +<td align="left" headers="r2c1-t32 r1c4-t32"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a>, <a href="tasks004.htm#BABFEICE">Embeddable</a>, and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t32" headers="r1c1-t32"> +<p>Name</p> +</td> +<td align="left" headers="r3c1-t32 r1c2-t32"> +<p>The <code>String</code> name for your converter, must be unique across the persistence unit</p> +</td> +<td align="left" headers="r3c1-t32 r1c3-t32"><br /></td> +<td align="left" headers="r3c1-t32 r1c4-t32"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a>, <a href="tasks004.htm#BABFEICE">Embeddable</a>, and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t32" headers="r1c1-t32"> +<p>Class</p> +</td> +<td align="left" headers="r4c1-t32 r1c2-t32"> +<p>The class of your converter. This class must implement the <code>org.eclipse.persistence.mappings.converters.Converter</code> interface.</p> +<p>Appears for <span class="bold">Custom</span> and <span class="bold">Struct</span> converters only.</p> +</td> +<td align="left" headers="r4c1-t32 r1c3-t32"><br /></td> +<td align="left" headers="r4c1-t32 r1c4-t32"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a>, <a href="tasks004.htm#BABFEICE">Embeddable</a>, and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t32" headers="r1c1-t32"> +<p>Data type</p> +</td> +<td align="left" headers="r5c1-t32 r1c2-t32"> +<p>The type stored in the database.</p> +<p>Appears for <span class="bold">Object Type</span> and <span class="bold">Type</span> converters only.</p> +</td> +<td align="left" headers="r5c1-t32 r1c3-t32"><br /></td> +<td align="left" headers="r5c1-t32 r1c4-t32"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a>, <a href="tasks004.htm#BABFEICE">Embeddable</a>, and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t32" headers="r1c1-t32"> +<p>Object type</p> +</td> +<td align="left" headers="r6c1-t32 r1c2-t32"> +<p>The type stored on the entity.</p> +<p>Appears for <span class="bold">Object Type</span> and <span class="bold">Type</span> converters only.</p> +</td> +<td align="left" headers="r6c1-t32 r1c3-t32"><br /></td> +<td align="left" headers="r6c1-t32 r1c4-t32"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a>, <a href="tasks004.htm#BABFEICE">Embeddable</a>, and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t32" headers="r1c1-t32"> +<p>Conversion values</p> +</td> +<td align="left" headers="r7c1-t32 r1c2-t32"> +<p>The array of conversion values (instances of <code>ConversionValue</code>: <code>String</code> <code>objectValue</code> and <code>String</code> <code>dataValue</code>).</p> +<p>Appears for <span class="bold">Object Type</span> converters only.</p> +</td> +<td align="left" headers="r7c1-t32 r1c3-t32"><br /></td> +<td align="left" headers="r7c1-t32 r1c4-t32"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a>, <a href="tasks004.htm#BABFEICE">Embeddable</a>, and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r8c1-t32" headers="r1c1-t32"> +<p>Default object value</p> +</td> +<td align="left" headers="r8c1-t32 r1c2-t32"> +<p>Set the value of this attribute to the default object value. Note that this argument is for dealing with legacy data if the data value is missing.</p> +<p>Appears for <span class="bold">Object Type</span> converters only.</p> +</td> +<td align="left" headers="r8c1-t32 r1c3-t32"><br /></td> +<td align="left" headers="r8c1-t32 r1c4-t32"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a>, <a href="tasks004.htm#BABFEICE">Embeddable</a>, and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformalwide" --> +<a id="sthref481" name="sthref481"></a> +<p class="subhead2">Related reference</p> +<ul> +<li> +<p>"Converter" in <span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> +<code><a href="http://eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_converter.htm">http://eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_converter.htm</a></code></p> +</li> +</ul> </div> <!-- class="sect3" --> <!-- Start Footer --> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference028.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference028.htm index e10aa159aa..04965f8c96 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference028.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference028.htm @@ -5,24 +5,112 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Embedded ID Mapping</title> +<title>Advanced</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Embedded ID Mapping" /> +<meta name="doctitle" content="Advanced" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACDIDIA" name="CACDIDIA"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACJEEDE" name="CACJEEDE"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Embedded ID Mapping</h1> +<h1>Advanced</h1> +<p><a id="sthref482" name="sthref482"></a><a id="sthref483" name="sthref483"></a><a id="sthref484" name="sthref484"></a><a id="sthref485" name="sthref485"></a><a id="sthref486" name="sthref486"></a><a id="sthref487" name="sthref487"></a><a id="sthref488" name="sthref488"></a><a id="sthref489" name="sthref489"></a><a id="sthref490" name="sthref490"></a>Use the <span class="gui-object-title">Advanced</span> area in the <span class="gui-object-title">JPA Details</span> view to configure additional settings for an entity.</p> +<div class="inftblhruleinformalwide"> +<table class="HRuleInformalWide" title="JPA Details view, Advanced page" summary="JPA Details view, Advanced page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="16%" /> +<col width="*" /> +<col width="17%" /> +<col width="25%" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t33">Property</th> +<th align="left" valign="bottom" id="r1c2-t33">Description</th> +<th align="left" valign="bottom" id="r1c3-t33">Default</th> +<th align="left" valign="bottom" id="r1c4-t33">Available for Entity Type</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t33" headers="r1c1-t33"> +<p>Read-only</p> +</td> +<td align="left" headers="r2c1-t33 r1c2-t33"> +<p>Specifies if a class is read-only.</p> +</td> +<td align="left" headers="r2c1-t33 r1c3-t33"> +<p>False</p> +</td> +<td align="left" headers="r2c1-t33 r1c4-t33"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a> and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t33" headers="r1c1-t33"> +<p>Customizer class</p> +</td> +<td align="left" headers="r3c1-t33 r1c2-t33"> +<p>Specifies a class that implements <code>DescriptorCustomizer</code> and is to run against an entity's class descriptor after all metadata processing has been completed.</p> +</td> +<td align="left" headers="r3c1-t33 r1c3-t33"> +<p>True</p> +</td> +<td align="left" headers="r3c1-t33 r1c4-t33"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a>, <a href="tasks004.htm#BABFEICE">Embeddable</a>, and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t33" headers="r1c1-t33"> +<p>Change tracking</p> +</td> +<td align="left" headers="r4c1-t33 r1c2-t33"> +<p>Specifies the <code>ObjectChangePolicy</code> to use:</p> +<ul> +<li> +<p><span class="bold">Attribute</span> – Objects with changed attributes will be processed in the commit process to include any changes in the results of the commit. Unchanged objects will be ignored.</p> +</li> +<li> +<p><span class="bold">Object</span> – Changed objects will be processed in the commit process to include any changes in the results of the commit. Unchanged objects will be ignored.</p> +</li> +<li> +<p><span class="bold">Deferred</span> – Defers all change detection to the UnitOfWork's change detection process.</p> +</li> +<li> +<p><span class="bold">Auto</span> – Does not set any change tracking policy; change tracking will be determined at runtime.</p> +</li> +</ul> +</td> +<td align="left" headers="r4c1-t33 r1c3-t33"> +<p>Auto</p> +</td> +<td align="left" headers="r4c1-t33 r1c4-t33"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a>, <a href="tasks004.htm#BABFEICE">Embeddable</a>, and <a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformalwide" --> +<a id="sthref491" name="sthref491"></a> +<p class="subhead2">Related reference</p> +<ul> +<li> +<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> +</li> +<li> +<p>"Read Only" and "ChangeTracking" in <span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> +<code><a href="http://eclipse.org/eclipselink/documentation/2.4/jpa/">http://eclipse.org/eclipselink/documentation/2.4/jpa/</a></code></p> +</li> +</ul> </div> <!-- class="sect3" --> +<!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference029.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference029.htm index eb9d3a6524..a201dca08b 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference029.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference029.htm @@ -5,165 +5,195 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>ID Mapping</title> +<title>Basic Mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="ID Mapping" /> +<meta name="doctitle" content="Basic Mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACIAEFI" name="CACIAEFI"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACCGGCG" name="CACCGGCG"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref483" name="sthref483"></a><a id="sthref484" name="sthref484"></a><a id="sthref485" name="sthref485"></a>ID Mapping</h1> +<h1><a id="sthref500" name="sthref500"></a><a id="sthref501" name="sthref501"></a><a id="sthref502" name="sthref502"></a>Basic Mapping</h1> <div class="inftblhruleinformal"> <table class="HRuleInformal" summary="JPA Details view, Version page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="29%" /> +<col width="22%" /> <col width="*" /> -<col width="24%" /> +<col width="31%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t33">Property</th> -<th align="left" valign="bottom" id="r1c2-t33">Description</th> -<th align="left" valign="bottom" id="r1c3-t33">Default</th> +<th align="left" valign="bottom" id="r1c1-t34">Property</th> +<th align="left" valign="bottom" id="r1c2-t34">Description</th> +<th align="left" valign="bottom" id="r1c3-t34">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t33" headers="r1c1-t33"> +<td align="left" id="r2c1-t34" headers="r1c1-t34"> <p><span class="bold">Column</span></p> </td> -<td align="left" headers="r2c1-t33 r1c2-t33"> -<p><a id="sthref486" name="sthref486"></a><a id="sthref487" name="sthref487"></a>The database column that contains the value for the attribute. This field corresponds to the <code>@Column</code> annotation.</p> +<td align="left" headers="r2c1-t34 r1c2-t34"> +<p><a id="sthref503" name="sthref503"></a><a id="sthref504" name="sthref504"></a>The database column that contains the value for the attribute. This field corresponds to the <code>@Column</code> annotation.</p> </td> -<td align="left" headers="r2c1-t33 r1c3-t33"> -<p>By default, the Column is assumed to be named identically to the attribute.</p> +<td align="left" headers="r2c1-t34 r1c3-t34"> +<p>By default, the Column is assumed to be named identically to the attribute and always included in the <code>INSERT</code> and <code>UPDATE</code> statements.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t33" headers="r1c1-t33"> +<td align="left" id="r3c1-t34" headers="r1c1-t34"> <p>Name</p> </td> -<td align="left" headers="r3c1-t33 r1c2-t33"> +<td align="left" headers="r3c1-t34 r1c2-t34"> <p>The database column that contains the value for the attribute.</p> </td> -<td align="left" headers="r3c1-t33 r1c3-t33"><br /></td> +<td align="left" headers="r3c1-t34 r1c3-t34"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t33" headers="r1c1-t33"> +<td align="left" id="r4c1-t34" headers="r1c1-t34"> <p>Table</p> </td> -<td align="left" headers="r4c1-t33 r1c2-t33"> +<td align="left" headers="r4c1-t34 r1c2-t34"> <p>Name of the database table that contains the selected column.</p> </td> -<td align="left" headers="r4c1-t33 r1c3-t33"><br /></td> +<td align="left" headers="r4c1-t34 r1c3-t34"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t33" headers="r1c1-t33"> +<td align="left" id="r5c1-t34" headers="r1c1-t34"> <p><span class="bold">Details</span></p> </td> -<td align="left" headers="r5c1-t33 r1c2-t33"><br /></td> -<td align="left" headers="r5c1-t33 r1c3-t33"><br /></td> +<td align="left" headers="r5c1-t34 r1c2-t34"><br /></td> +<td align="left" headers="r5c1-t34 r1c3-t34"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t33" headers="r1c1-t33"> +<td align="left" id="r6c1-t34" headers="r1c1-t34"> <p>Insertable</p> </td> -<td align="left" headers="r6c1-t33 r1c2-t33"> +<td align="left" headers="r6c1-t34 r1c2-t34"> <p>Specifies if the column is always included in <code>SQL INSERT</code> statements.</p> </td> -<td align="left" headers="r6c1-t33 r1c3-t33"> +<td align="left" headers="r6c1-t34 r1c3-t34"> <p>True</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r7c1-t33" headers="r1c1-t33"> +<td align="left" id="r7c1-t34" headers="r1c1-t34"> <p>Updatable</p> </td> -<td align="left" headers="r7c1-t33 r1c2-t33"> +<td align="left" headers="r7c1-t34 r1c2-t34"> <p>Specifies if this column is always included in <code>SQL UPDATE</code> statements.</p> </td> -<td align="left" headers="r7c1-t33 r1c3-t33"> +<td align="left" headers="r7c1-t34 r1c3-t34"> <p>True</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r8c1-t33" headers="r1c1-t33"> +<td align="left" id="r8c1-t34" headers="r1c1-t34"> <p>Unique</p> </td> -<td align="left" headers="r8c1-t33 r1c2-t33"> +<td align="left" headers="r8c1-t34 r1c2-t34"> <p>Sets the <code>UNIQUE</code> constraint for the column.</p> </td> -<td align="left" headers="r8c1-t33 r1c3-t33"> +<td align="left" headers="r8c1-t34 r1c3-t34"> <p>False</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r9c1-t33" headers="r1c1-t33"> +<td align="left" id="r9c1-t34" headers="r1c1-t34"> <p>Nullable</p> </td> -<td align="left" headers="r9c1-t33 r1c2-t33"> +<td align="left" headers="r9c1-t34 r1c2-t34"> <p>Specifies if the column allows null values.</p> </td> -<td align="left" headers="r9c1-t33 r1c3-t33"> +<td align="left" headers="r9c1-t34 r1c3-t34"> <p>True</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r10c1-t33" headers="r1c1-t33"> +<td align="left" id="r10c1-t34" headers="r1c1-t34"> <p>Length</p> </td> -<td align="left" headers="r10c1-t33 r1c2-t33"> +<td align="left" headers="r10c1-t34 r1c2-t34"> <p>Sets the column length.</p> </td> -<td align="left" headers="r10c1-t33 r1c3-t33"> +<td align="left" headers="r10c1-t34 r1c3-t34"> <p>255</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r11c1-t33" headers="r1c1-t33"> +<td align="left" id="r11c1-t34" headers="r1c1-t34"> <p>Precision</p> </td> -<td align="left" headers="r11c1-t33 r1c2-t33"> +<td align="left" headers="r11c1-t34 r1c2-t34"> <p>Sets the precision for the column values.</p> </td> -<td align="left" headers="r11c1-t33 r1c3-t33"> +<td align="left" headers="r11c1-t34 r1c3-t34"> <p>0</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r12c1-t33" headers="r1c1-t33"> +<td align="left" id="r12c1-t34" headers="r1c1-t34"> <p>Scale</p> </td> -<td align="left" headers="r12c1-t33 r1c2-t33"> +<td align="left" headers="r12c1-t34 r1c2-t34"> <p>Sets the number of digits that appear to the right of the decimal point.</p> </td> -<td align="left" headers="r12c1-t33 r1c3-t33"> +<td align="left" headers="r12c1-t34 r1c3-t34"> <p>0</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r13c1-t33" headers="r1c1-t33"> +<td align="left" id="r13c1-t34" headers="r1c1-t34"> <p>Column definition</p> </td> -<td align="left" headers="r13c1-t33 r1c2-t33"> +<td align="left" headers="r13c1-t34 r1c2-t34"> <p>The SQL fragment that is used when generating the DDL for the column.</p> </td> -<td align="left" headers="r13c1-t33 r1c3-t33"><br /></td> +<td align="left" headers="r13c1-t34 r1c3-t34"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r14c1-t33" headers="r1c1-t33"> +<td align="left" id="r14c1-t34" headers="r1c1-t34"> +<p><a id="sthref505" name="sthref505"></a><a id="sthref506" name="sthref506"></a><a id="sthref507" name="sthref507"></a><span class="bold">Fetch</span></p> +</td> +<td align="left" headers="r14c1-t34 r1c2-t34"> +<p>Defines how data is loaded from the database:</p> +<ul> +<li> +<p>Eager – Data is loaded in before it is actually needed.</p> +</li> +<li> +<p>Lazy – Data is loaded only when required by the transaction.</p> +</li> +</ul> +</td> +<td align="left" headers="r14c1-t34 r1c3-t34"> +<p>Eager</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r15c1-t34" headers="r1c1-t34"> +<p><span class="bold">Optional</span></p> +</td> +<td align="left" headers="r15c1-t34 r1c2-t34"> +<p>Specifies if this field is can be null.</p> +</td> +<td align="left" headers="r15c1-t34 r1c3-t34"> +<p>True</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r16c1-t34" headers="r1c1-t34"> <p><span class="bold">Mutable</span></p> </td> -<td align="left" headers="r14c1-t33 r1c2-t33"> +<td align="left" headers="r16c1-t34 r1c2-t34"> <p>Specify if the value of a complex field type can be changed (or not changed) instead of being replaced.</p> </td> -<td align="left" headers="r14c1-t33 r1c3-t33"> +<td align="left" headers="r16c1-t34 r1c3-t34"> <p>True</p> </td> </tr> @@ -171,16 +201,13 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<p>ID mappings also include the following areas:</p> +<p>Basic mappings also include the following areas:</p> <ul> <li> -<p><a href="reference035.htm#CACIHAAF">Type information</a></p> -</li> -<li> -<p><a href="reference037.htm#CACJCHJB">Converters</a></p> +<p><a href="reference039.htm#CACIHAAF">Type information</a></p> </li> <li> -<p><a href="ref_primary_key.htm#CACFCCAB">Primary Key Generation information</a></p> +<p><a href="reference041.htm#CACJCHJB">Converters</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference030.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference030.htm index cc510a61c3..6e447373f3 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference030.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference030.htm @@ -5,49 +5,49 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Many-to-Many Mapping</title> +<title>Element Collection Mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Many-to-Many Mapping" /> +<meta name="doctitle" content="Element Collection Mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACIHGCE" name="CACIHGCE"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACBCGDI" name="CACBCGDI"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref488" name="sthref488"></a><a id="sthref489" name="sthref489"></a><a id="sthref490" name="sthref490"></a>Many-to-Many Mapping</h1> +<h1><a id="sthref508" name="sthref508"></a><a id="sthref509" name="sthref509"></a>Element Collection Mapping</h1> <div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="JPA Details view, One-to-one page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<table class="HRuleInformal" summary="JPA Details view, Version page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="29%" /> <col width="*" /> <col width="24%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t34">Property</th> -<th align="left" valign="bottom" id="r1c2-t34">Description</th> -<th align="left" valign="bottom" id="r1c3-t34">Default</th> +<th align="left" valign="bottom" id="r1c1-t35">Property</th> +<th align="left" valign="bottom" id="r1c2-t35">Description</th> +<th align="left" valign="bottom" id="r1c3-t35">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t34" headers="r1c1-t34"> -<p>Target entity</p> +<td align="left" id="r2c1-t35" headers="r1c1-t35"> +<p>Target class</p> </td> -<td align="left" headers="r2c1-t34 r1c2-t34"> -<p>The persistent entity to which the attribute is mapped.</p> +<td align="left" headers="r2c1-t35 r1c2-t35"> +<p>The class (basic or embeddable) that is the element type of the collection.</p> </td> -<td align="left" headers="r2c1-t34 r1c3-t34"><br /></td> +<td align="left" headers="r2c1-t35 r1c3-t35"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t34" headers="r1c1-t34"> +<td align="left" id="r3c1-t35" headers="r1c1-t35"> <p>Fetch</p> </td> -<td align="left" headers="r3c1-t34 r1c2-t34"> +<td align="left" headers="r3c1-t35 r1c2-t35"> <p>Defines how data is loaded from the database:</p> <ul> <li> @@ -58,15 +58,15 @@ </li> </ul> </td> -<td align="left" headers="r3c1-t34 r1c3-t34"> +<td align="left" headers="r3c1-t35 r1c3-t35"> <p>Lazy</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t34" headers="r1c1-t34"> +<td align="left" id="r4c1-t35" headers="r1c1-t35"> <p>Join fetch</p> </td> -<td align="left" headers="r4c1-t34 r1c2-t34"> +<td align="left" headers="r4c1-t35 r1c2-t35"> <p>The type of fetch to use:</p> <ul> <li> @@ -79,55 +79,72 @@ </li> </ul> </td> -<td align="left" headers="r4c1-t34 r1c3-t34"> +<td align="left" headers="r4c1-t35 r1c3-t35"> <p>None</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t34" headers="r1c1-t34"> -<p>Cascade</p> +<td align="left" id="r5c1-t35" headers="r1c1-t35"> +<p><span class="bold">Collection Table</span></p> </td> -<td align="left" headers="r5c1-t34 r1c2-t34"> -<p>Specify which operations are propagated throughout the entity.</p> -<ul> -<li> -<p>All – 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 align="left" headers="r5c1-t35 r1c2-t35"><br /></td> +<td align="left" headers="r5c1-t35 r1c3-t35"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t35" headers="r1c1-t35"> +<p>Name</p> +</td> +<td align="left" headers="r6c1-t35 r1c2-t35"><br /></td> +<td align="left" headers="r6c1-t35 r1c3-t35"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t35" headers="r1c1-t35"> +<p>Schema</p> +</td> +<td align="left" headers="r7c1-t35 r1c2-t35"><br /></td> +<td align="left" headers="r7c1-t35 r1c3-t35"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r8c1-t35" headers="r1c1-t35"> +<p>Catalog</p> +</td> +<td align="left" headers="r8c1-t35 r1c2-t35"><br /></td> +<td align="left" headers="r8c1-t35 r1c3-t35"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r9c1-t35" headers="r1c1-t35"> +<p><span class="bold">Join Columns</span></p> +</td> +<td align="left" headers="r9c1-t35 r1c2-t35"><br /></td> +<td align="left" headers="r9c1-t35 r1c3-t35"> +<p>0</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r10c1-t35" headers="r1c1-t35"> +<p>Override default</p> +</td> +<td align="left" headers="r10c1-t35 r1c2-t35"> +<p>Click <span class="bold">Add</span> to create a new join column, by using the <a href="reference068.htm#CACJJBAD">Add Join Column dialog</a>.</p> </td> -<td align="left" headers="r5c1-t34 r1c3-t34"> -<p>True</p> +<td align="left" headers="r10c1-t35 r1c3-t35"> +<p>0</p> </td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformal" --> -<p>One-to-many mappings also include the following areas:</p> +<p>Element collection mappings also include the following areas:</p> <ul> <li> -<p><a href="reference039.htm#CACIJEGI">Joining Strategy</a></p> +<p><a href="reference040.htm#CACJBFEA">Value</a></p> </li> <li> -<p><a href="reference037.htm#CACJCHJB">Converters</a></p> +<p><a href="reference041.htm#CACJCHJB">Converters</a></p> </li> <li> -<p><a href="reference038.htm#CACBIJFD">Ordering</a></p> +<p><a href="reference042.htm#CACBIJFD">Ordering</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference031.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference031.htm index 3af72e5211..79b728096f 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference031.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference031.htm @@ -5,140 +5,22 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Many-to-One Mapping</title> +<title>Embedded Mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Many-to-One Mapping" /> +<meta name="doctitle" content="Embedded Mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACHAEDB" name="CACHAEDB"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACBJBFD" name="CACBJBFD"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref491" name="sthref491"></a><a id="sthref492" name="sthref492"></a><a id="sthref493" name="sthref493"></a>Many-to-One Mapping</h1> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="JPA Details view, One-to-one page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="29%" /> -<col width="*" /> -<col width="24%" /> -<thead> -<tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t35">Property</th> -<th align="left" valign="bottom" id="r1c2-t35">Description</th> -<th align="left" valign="bottom" id="r1c3-t35">Default</th> -</tr> -</thead> -<tbody> -<tr align="left" valign="top"> -<td align="left" id="r2c1-t35" headers="r1c1-t35"> -<p>Target entity</p> -</td> -<td align="left" headers="r2c1-t35 r1c2-t35"> -<p>The persistent entity to which the attribute is mapped.</p> -<p>You do not need to explicitly specify the target entity, since it can be inferred from the type of object being referenced.</p> -</td> -<td align="left" headers="r2c1-t35 r1c3-t35"> -<p>null</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t35" headers="r1c1-t35"> -<p>Fetch</p> -</td> -<td align="left" headers="r3c1-t35 r1c2-t35"> -<p>Defines how data is loaded from the database:</p> -<ul> -<li> -<p>Eager – Data is loaded in before it is actually needed.</p> -</li> -<li> -<p>Lazy – Data is loaded only when required by the transaction.</p> -</li> -</ul> -</td> -<td align="left" headers="r3c1-t35 r1c3-t35"> -<p>Lazy</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t35" headers="r1c1-t35"> -<p>Join fetch</p> -</td> -<td align="left" headers="r4c1-t35 r1c2-t35"> -<p>The type of fetch to use:</p> -<ul> -<li> -<p>Inner – Provides the inner join fetching of the related object.</p> -<p><span class="bold">Note</span>: Inner joining does not allow for null or empty values</p> -</li> -<li> -<p>Outer – Provides the outer join fetching of the related object</p> -<p><span class="bold">Note</span>: Outer joining allows for null or empty values.</p> -</li> -</ul> -</td> -<td align="left" headers="r4c1-t35 r1c3-t35"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t35" headers="r1c1-t35"> -<p>Optional</p> -</td> -<td align="left" headers="r5c1-t35 r1c2-t35"> -<p>Specifies if this field is can be null.</p> -</td> -<td align="left" headers="r5c1-t35 r1c3-t35"> -<p>True</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t35" headers="r1c1-t35"> -<p>Cascade</p> -</td> -<td align="left" headers="r6c1-t35 r1c2-t35"> -<p>Specify which operations are propagated throughout the entity.</p> -<ul> -<li> -<p>All – 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="r6c1-t35 r1c3-t35"> -<p>True</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblhruleinformal" --> -<p>Many-to-one mappings also include the following areas:</p> -<ul> -<li> -<p><a href="reference039.htm#CACIJEGI">Joining Strategy</a></p> -</li> -<li> -<p><a href="reference040.htm#CACGHHGB">Derived Identity</a></p> -</li> -</ul> +<h1>Embedded Mapping</h1> </div> <!-- class="sect3" --> <!-- Start Footer --> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference032.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference032.htm index c7b7bfc920..18040607b6 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference032.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference032.htm @@ -5,147 +5,22 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>One-to-Many Mapping</title> +<title>Embedded ID Mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="One-to-Many Mapping" /> +<meta name="doctitle" content="Embedded ID Mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACHGGHH" name="CACHGGHH"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACDIDIA" name="CACDIDIA"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref494" name="sthref494"></a><a id="sthref495" name="sthref495"></a><a id="sthref496" name="sthref496"></a>One-to-Many Mapping</h1> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="JPA Details view, One-to-one page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="29%" /> -<col width="*" /> -<col width="24%" /> -<thead> -<tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t36">Property</th> -<th align="left" valign="bottom" id="r1c2-t36">Description</th> -<th align="left" valign="bottom" id="r1c3-t36">Default</th> -</tr> -</thead> -<tbody> -<tr align="left" valign="top"> -<td align="left" id="r2c1-t36" headers="r1c1-t36"> -<p>Target entity</p> -</td> -<td align="left" headers="r2c1-t36 r1c2-t36"> -<p>The persistent entity to which the attribute is mapped.</p> -</td> -<td align="left" headers="r2c1-t36 r1c3-t36"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t36" headers="r1c1-t36"> -<p>Fetch</p> -</td> -<td align="left" headers="r3c1-t36 r1c2-t36"> -<p>Defines how data is loaded from the database:</p> -<ul> -<li> -<p>Eager – Data is loaded in before it is actually needed.</p> -</li> -<li> -<p>Lazy – Data is loaded only when required by the transaction.</p> -</li> -</ul> -</td> -<td align="left" headers="r3c1-t36 r1c3-t36"> -<p>Lazy</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t36" headers="r1c1-t36"> -<p>Join fetch</p> -</td> -<td align="left" headers="r4c1-t36 r1c2-t36"> -<p>The type of fetch to use:</p> -<ul> -<li> -<p>Inner – Provides the inner join fetching of the related object.</p> -<p><span class="bold">Note</span>: Inner joining does not allow for null or empty values</p> -</li> -<li> -<p>Outer – Provides the outer join fetching of the related object</p> -<p><span class="bold">Note</span>: Outer joining allows for null or empty values.</p> -</li> -</ul> -</td> -<td align="left" headers="r4c1-t36 r1c3-t36"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t36" headers="r1c1-t36"> -<p>Private owned</p> -</td> -<td align="left" headers="r5c1-t36 r1c2-t36"> -<p>Specify that a relationship is privately owned; target object is a dependent part of the source object and is not referenced by any other object and cannot exist on its own.</p> -</td> -<td align="left" headers="r5c1-t36 r1c3-t36"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t36" headers="r1c1-t36"> -<p>Orphan removal</p> -</td> -<td align="left" headers="r6c1-t36 r1c2-t36"><br /></td> -<td align="left" headers="r6c1-t36 r1c3-t36"> -<p>False</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t36" headers="r1c1-t36"> -<p>Cascade</p> -</td> -<td align="left" headers="r7c1-t36 r1c2-t36"> -<p>Specify which operations are propagated throughout the entity.</p> -<ul> -<li> -<p>All – 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="r7c1-t36 r1c3-t36"> -<p>True</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblhruleinformal" --> -<p>One-to-many mappings also include the following areas:</p> -<ul> -<li> -<p><a href="reference039.htm#CACIJEGI">Joining Strategy</a></p> -</li> -<li> -<p><a href="reference037.htm#CACJCHJB">Converters</a></p> -</li> -<li> -<p><a href="reference038.htm#CACBIJFD">Ordering</a></p> -</li> -</ul> +<h1>Embedded ID Mapping</h1> </div> <!-- class="sect3" --> <!-- Start Footer --> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference033.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference033.htm index c51a871d7e..0159bb88d6 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference033.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference033.htm @@ -5,141 +5,165 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>One-to-One Mapping</title> +<title>ID Mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="One-to-One Mapping" /> +<meta name="doctitle" content="ID Mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACGGHDD" name="CACGGHDD"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACIAEFI" name="CACIAEFI"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref497" name="sthref497"></a><a id="sthref498" name="sthref498"></a><a id="sthref499" name="sthref499"></a>One-to-One Mapping</h1> +<h1><a id="sthref510" name="sthref510"></a><a id="sthref511" name="sthref511"></a><a id="sthref512" name="sthref512"></a>ID Mapping</h1> <div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="JPA Details view, One-to-one page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<table class="HRuleInformal" summary="JPA Details view, Version page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="29%" /> <col width="*" /> <col width="24%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t37">Property</th> -<th align="left" valign="bottom" id="r1c2-t37">Description</th> -<th align="left" valign="bottom" id="r1c3-t37">Default</th> +<th align="left" valign="bottom" id="r1c1-t36">Property</th> +<th align="left" valign="bottom" id="r1c2-t36">Description</th> +<th align="left" valign="bottom" id="r1c3-t36">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t37" headers="r1c1-t37"> -<p>Target entity</p> +<td align="left" id="r2c1-t36" headers="r1c1-t36"> +<p><span class="bold">Column</span></p> </td> -<td align="left" headers="r2c1-t37 r1c2-t37"> -<p>The persistent entity to which the attribute is mapped.</p> +<td align="left" headers="r2c1-t36 r1c2-t36"> +<p><a id="sthref513" name="sthref513"></a><a id="sthref514" name="sthref514"></a>The database column that contains the value for the attribute. This field corresponds to the <code>@Column</code> annotation.</p> +</td> +<td align="left" headers="r2c1-t36 r1c3-t36"> +<p>By default, the Column is assumed to be named identically to the attribute.</p> </td> -<td align="left" headers="r2c1-t37 r1c3-t37"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t37" headers="r1c1-t37"> -<p>Fetch</p> +<td align="left" id="r3c1-t36" headers="r1c1-t36"> +<p>Name</p> </td> -<td align="left" headers="r3c1-t37 r1c2-t37"> -<p>Defines how data is loaded from the database:</p> -<ul> -<li> -<p>Eager – Data is loaded in before it is actually needed.</p> -</li> -<li> -<p>Lazy – Data is loaded only when required by the transaction.</p> -</li> -</ul> +<td align="left" headers="r3c1-t36 r1c2-t36"> +<p>The database column that contains the value for the attribute.</p> </td> -<td align="left" headers="r3c1-t37 r1c3-t37"> -<p>Eager</p> +<td align="left" headers="r3c1-t36 r1c3-t36"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t36" headers="r1c1-t36"> +<p>Table</p> +</td> +<td align="left" headers="r4c1-t36 r1c2-t36"> +<p>Name of the database table that contains the selected column.</p> </td> +<td align="left" headers="r4c1-t36 r1c3-t36"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t37" headers="r1c1-t37"> -<p>Join fetch</p> +<td align="left" id="r5c1-t36" headers="r1c1-t36"> +<p><span class="bold">Details</span></p> </td> -<td align="left" headers="r4c1-t37 r1c2-t37"> -<p>The type of fetch to use:</p> -<ul> -<li> -<p>Inner – Provides the inner join fetching of the related object.</p> -<p><span class="bold">Note</span>: Inner joining does not allow for null or empty values</p> -</li> -<li> -<p>Outer – Provides the outer join fetching of the related object</p> -<p><span class="bold">Note</span>: Outer joining allows for null or empty values.</p> -</li> -</ul> +<td align="left" headers="r5c1-t36 r1c2-t36"><br /></td> +<td align="left" headers="r5c1-t36 r1c3-t36"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t36" headers="r1c1-t36"> +<p>Insertable</p> +</td> +<td align="left" headers="r6c1-t36 r1c2-t36"> +<p>Specifies if the column is always included in <code>SQL INSERT</code> statements.</p> +</td> +<td align="left" headers="r6c1-t36 r1c3-t36"> +<p>True</p> </td> -<td align="left" headers="r4c1-t37 r1c3-t37"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t37" headers="r1c1-t37"> -<p>Optional</p> +<td align="left" id="r7c1-t36" headers="r1c1-t36"> +<p>Updatable</p> </td> -<td align="left" headers="r5c1-t37 r1c2-t37"> -<p>Specifies if this field is can be null.</p> +<td align="left" headers="r7c1-t36 r1c2-t36"> +<p>Specifies if this column is always included in <code>SQL UPDATE</code> statements.</p> </td> -<td align="left" headers="r5c1-t37 r1c3-t37"> +<td align="left" headers="r7c1-t36 r1c3-t36"> <p>True</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t37" headers="r1c1-t37"> -<p>Private owned</p> +<td align="left" id="r8c1-t36" headers="r1c1-t36"> +<p>Unique</p> </td> -<td align="left" headers="r6c1-t37 r1c2-t37"> -<p>Specify that a relationship is privately owned; target object is a dependent part of the source object and is not referenced by any other object and cannot exist on its own.</p> +<td align="left" headers="r8c1-t36 r1c2-t36"> +<p>Sets the <code>UNIQUE</code> constraint for the column.</p> </td> -<td align="left" headers="r6c1-t37 r1c3-t37"> +<td align="left" headers="r8c1-t36 r1c3-t36"> <p>False</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r7c1-t37" headers="r1c1-t37"> -<p>Orphan removal</p> +<td align="left" id="r9c1-t36" headers="r1c1-t36"> +<p>Nullable</p> </td> -<td align="left" headers="r7c1-t37 r1c2-t37"><br /></td> -<td align="left" headers="r7c1-t37 r1c3-t37"> -<p>False</p> +<td align="left" headers="r9c1-t36 r1c2-t36"> +<p>Specifies if the column allows null values.</p> +</td> +<td align="left" headers="r9c1-t36 r1c3-t36"> +<p>True</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r8c1-t37" headers="r1c1-t37"> -<p>Cascade</p> +<td align="left" id="r10c1-t36" headers="r1c1-t36"> +<p>Length</p> </td> -<td align="left" headers="r8c1-t37 r1c2-t37"> -<p>Specify which operations are propagated throughout the entity.</p> -<ul> -<li> -<p>All – 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 align="left" headers="r10c1-t36 r1c2-t36"> +<p>Sets the column length.</p> </td> -<td align="left" headers="r8c1-t37 r1c3-t37"> +<td align="left" headers="r10c1-t36 r1c3-t36"> +<p>255</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r11c1-t36" headers="r1c1-t36"> +<p>Precision</p> +</td> +<td align="left" headers="r11c1-t36 r1c2-t36"> +<p>Sets the precision for the column values.</p> +</td> +<td align="left" headers="r11c1-t36 r1c3-t36"> +<p>0</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r12c1-t36" headers="r1c1-t36"> +<p>Scale</p> +</td> +<td align="left" headers="r12c1-t36 r1c2-t36"> +<p>Sets the number of digits that appear to the right of the decimal point.</p> +</td> +<td align="left" headers="r12c1-t36 r1c3-t36"> +<p>0</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r13c1-t36" headers="r1c1-t36"> +<p>Column definition</p> +</td> +<td align="left" headers="r13c1-t36 r1c2-t36"> +<p>The SQL fragment that is used when generating the DDL for the column.</p> +</td> +<td align="left" headers="r13c1-t36 r1c3-t36"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r14c1-t36" headers="r1c1-t36"> +<p><span class="bold">Mutable</span></p> +</td> +<td align="left" headers="r14c1-t36 r1c2-t36"> +<p>Specify if the value of a complex field type can be changed (or not changed) instead of being replaced.</p> +</td> +<td align="left" headers="r14c1-t36 r1c3-t36"> <p>True</p> </td> </tr> @@ -147,13 +171,16 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<p>One-to-one mappings also include the following areas:</p> +<p>ID mappings also include the following areas:</p> <ul> <li> -<p><a href="reference040.htm#CACGHHGB">Derived Identity</a></p> +<p><a href="reference039.htm#CACIHAAF">Type information</a></p> +</li> +<li> +<p><a href="reference041.htm#CACJCHJB">Converters</a></p> </li> <li> -<p><a href="reference039.htm#CACIJEGI">Joining Strategy</a></p> +<p><a href="ref_primary_key.htm#CACFCCAB">Primary Key Generation information</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference034.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference034.htm index 6e1f750eb8..50901cc6a6 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference034.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference034.htm @@ -5,166 +5,112 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Version Mapping</title> +<title>Many-to-Many Mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:41Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Version Mapping" /> +<meta name="doctitle" content="Many-to-Many Mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACHAEBB" name="CACHAEBB"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACIHGCE" name="CACIHGCE"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref500" name="sthref500"></a><a id="sthref501" name="sthref501"></a><a id="sthref502" name="sthref502"></a>Version Mapping</h1> +<h1><a id="sthref515" name="sthref515"></a><a id="sthref516" name="sthref516"></a><a id="sthref517" name="sthref517"></a>Many-to-Many Mapping</h1> <div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="JPA Details view, Version page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<table class="HRuleInformal" summary="JPA Details view, One-to-one page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="29%" /> <col width="*" /> <col width="24%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t38">Property</th> -<th align="left" valign="bottom" id="r1c2-t38">Description</th> -<th align="left" valign="bottom" id="r1c3-t38">Default</th> +<th align="left" valign="bottom" id="r1c1-t37">Property</th> +<th align="left" valign="bottom" id="r1c2-t37">Description</th> +<th align="left" valign="bottom" id="r1c3-t37">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t38" headers="r1c1-t38"> -<p><span class="bold">Column</span></p> +<td align="left" id="r2c1-t37" headers="r1c1-t37"> +<p>Target entity</p> </td> -<td align="left" headers="r2c1-t38 r1c2-t38"> -<p><a id="sthref503" name="sthref503"></a><a id="sthref504" name="sthref504"></a>The database column that contains the value for the attribute. This field corresponds to the <code>@Column</code> annotation.</p> -</td> -<td align="left" headers="r2c1-t38 r1c3-t38"> -<p>By default, the Column is assumed to be named identically to the attribute.</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t38" headers="r1c1-t38"> -<p>Name</p> -</td> -<td align="left" headers="r3c1-t38 r1c2-t38"> -<p>The database column mapped to the entity attribute.</p> -<p>By default, the Column is assumed to be named identically to the attribute and always included in the <code>INSERT</code> and <code>UPDATE</code> statements.</p> -</td> -<td align="left" headers="r3c1-t38 r1c3-t38"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t38" headers="r1c1-t38"> -<p>Table</p> -</td> -<td align="left" headers="r4c1-t38 r1c2-t38"> -<p>Name of the database table that contains the selected column.</p> -</td> -<td align="left" headers="r4c1-t38 r1c3-t38"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t38" headers="r1c1-t38"> -<p><span class="bold">Details</span></p> -</td> -<td align="left" headers="r5c1-t38 r1c2-t38"><br /></td> -<td align="left" headers="r5c1-t38 r1c3-t38"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t38" headers="r1c1-t38"> -<p>Insertable</p> -</td> -<td align="left" headers="r6c1-t38 r1c2-t38"> -<p>Specifies if the column is always included in <code>SQL INSERT</code> statements.</p> -</td> -<td align="left" headers="r6c1-t38 r1c3-t38"> -<p>True</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t38" headers="r1c1-t38"> -<p>Updatable</p> -</td> -<td align="left" headers="r7c1-t38 r1c2-t38"> -<p>Specifies if this column is always included in <code>SQL UPDATE</code> statements.</p> -</td> -<td align="left" headers="r7c1-t38 r1c3-t38"> -<p>True</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r8c1-t38" headers="r1c1-t38"> -<p>Unique</p> -</td> -<td align="left" headers="r8c1-t38 r1c2-t38"> -<p>Sets the <code>UNIQUE</code> constraint for the column.</p> -</td> -<td align="left" headers="r8c1-t38 r1c3-t38"> -<p>False</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r9c1-t38" headers="r1c1-t38"> -<p>Nullable</p> -</td> -<td align="left" headers="r9c1-t38 r1c2-t38"> -<p>Specifies if the column allows null values.</p> -</td> -<td align="left" headers="r9c1-t38 r1c3-t38"> -<p>True</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r10c1-t38" headers="r1c1-t38"> -<p>Length</p> -</td> -<td align="left" headers="r10c1-t38 r1c2-t38"> -<p>Sets the column length.</p> -</td> -<td align="left" headers="r10c1-t38 r1c3-t38"> -<p>255</p> +<td align="left" headers="r2c1-t37 r1c2-t37"> +<p>The persistent entity to which the attribute is mapped.</p> </td> +<td align="left" headers="r2c1-t37 r1c3-t37"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r11c1-t38" headers="r1c1-t38"> -<p>Precision</p> +<td align="left" id="r3c1-t37" headers="r1c1-t37"> +<p>Fetch</p> </td> -<td align="left" headers="r11c1-t38 r1c2-t38"> -<p>Sets the precision for the column values.</p> +<td align="left" headers="r3c1-t37 r1c2-t37"> +<p>Defines how data is loaded from the database:</p> +<ul> +<li> +<p>Eager – Data is loaded in before it is actually needed.</p> +</li> +<li> +<p>Lazy – Data is loaded only when required by the transaction.</p> +</li> +</ul> </td> -<td align="left" headers="r11c1-t38 r1c3-t38"> -<p>0</p> +<td align="left" headers="r3c1-t37 r1c3-t37"> +<p>Lazy</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r12c1-t38" headers="r1c1-t38"> -<p>Scale</p> -</td> -<td align="left" headers="r12c1-t38 r1c2-t38"> -<p>Sets the number of digits that appear to the right of the decimal point.</p> -</td> -<td align="left" headers="r12c1-t38 r1c3-t38"> -<p>0</p> +<td align="left" id="r4c1-t37" headers="r1c1-t37"> +<p>Join fetch</p> </td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r13c1-t38" headers="r1c1-t38"> -<p>Column definition</p> +<td align="left" headers="r4c1-t37 r1c2-t37"> +<p>The type of fetch to use:</p> +<ul> +<li> +<p>Inner – Provides the inner join fetching of the related object.</p> +<p><span class="bold">Note</span>: Inner joining does not allow for null or empty values</p> +</li> +<li> +<p>Outer – Provides the outer join fetching of the related object</p> +<p><span class="bold">Note</span>: Outer joining allows for null or empty values.</p> +</li> +</ul> </td> -<td align="left" headers="r13c1-t38 r1c2-t38"> -<p>The SQL fragment that is used when generating the DDL for the column.</p> +<td align="left" headers="r4c1-t37 r1c3-t37"> +<p>None</p> </td> -<td align="left" headers="r13c1-t38 r1c3-t38"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r14c1-t38" headers="r1c1-t38"> -<p><span class="bold">Mutable</span></p> +<td align="left" id="r5c1-t37" headers="r1c1-t37"> +<p>Cascade</p> </td> -<td align="left" headers="r14c1-t38 r1c2-t38"> -<p>Specify if the value of a complex field type can be changed (or not changed) instead of being replaced.</p> +<td align="left" headers="r5c1-t37 r1c2-t37"> +<p>Specify which operations are propagated throughout the entity.</p> +<ul> +<li> +<p>All – 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-t38 r1c3-t38"> +<td align="left" headers="r5c1-t37 r1c3-t37"> <p>True</p> </td> </tr> @@ -172,13 +118,16 @@ </table> <br /></div> <!-- class="inftblhruleinformal" --> -<p>Version mappings also include the following areas:</p> +<p>One-to-many mappings also include the following areas:</p> <ul> <li> -<p><a href="reference035.htm#CACIHAAF">Type information</a></p> +<p><a href="reference043.htm#CACIJEGI">Joining Strategy</a></p> +</li> +<li> +<p><a href="reference041.htm#CACJCHJB">Converters</a></p> </li> <li> -<p><a href="reference037.htm#CACJCHJB">Converters</a></p> +<p><a href="reference042.htm#CACBIJFD">Ordering</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference035.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference035.htm index 2b9f4bd3c5..35179eda7b 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference035.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference035.htm @@ -5,125 +5,141 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Type information</title> +<title>Many-to-One Mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Type information" /> +<meta name="doctitle" content="Many-to-One Mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACIHAAF" name="CACIHAAF"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACHAEDB" name="CACHAEDB"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref505" name="sthref505"></a>Type information</h1> +<h1><a id="sthref518" name="sthref518"></a><a id="sthref519" name="sthref519"></a><a id="sthref520" name="sthref520"></a>Many-to-One Mapping</h1> <div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="JPA Details view, Type page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<table class="HRuleInformal" summary="JPA Details view, One-to-one page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="29%" /> <col width="*" /> <col width="24%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t39">Property</th> -<th align="left" valign="bottom" id="r1c2-t39">Description</th> -<th align="left" valign="bottom" id="r1c3-t39">Available for Mapping Type</th> +<th align="left" valign="bottom" id="r1c1-t38">Property</th> +<th align="left" valign="bottom" id="r1c2-t38">Description</th> +<th align="left" valign="bottom" id="r1c3-t38">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t39" headers="r1c1-t39"> -<p>Default</p> +<td align="left" id="r2c1-t38" headers="r1c1-t38"> +<p>Target entity</p> </td> -<td align="left" headers="r2c1-t39 r1c2-t39"><br /></td> -<td align="left" headers="r2c1-t39 r1c3-t39"> -<p><a href="tasks010.htm#BABBABCE">Basic mapping</a>, <a href="tasks014.htm#BABGCBHG">ID mapping</a>, and <a href="tasks020.htm#BABHIBII">Version mapping</a></p> +<td align="left" headers="r2c1-t38 r1c2-t38"> +<p>The persistent entity to which the attribute is mapped.</p> +<p>You do not need to explicitly specify the target entity, since it can be inferred from the type of object being referenced.</p> </td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t39" headers="r1c1-t39"> -<p><a id="sthref506" name="sthref506"></a>LOB</p> -</td> -<td align="left" headers="r3c1-t39 r1c2-t39"> -<p>Specify if the field is mapped to <code>java.sql.Clob</code> or <code>java.sql.Blob</code>.</p> -<p>This field corresponds to the <code>@Lob</code> annotation.</p> +<td align="left" headers="r2c1-t38 r1c3-t38"> +<p>null</p> </td> -<td align="left" headers="r3c1-t39 r1c3-t39"> -<p><a href="tasks010.htm#BABBABCE">Basic mapping</a></p> -<br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t39" headers="r1c1-t39"> -<p><a id="sthref507" name="sthref507"></a><a id="sthref508" name="sthref508"></a><a id="sthref509" name="sthref509"></a>Temporal</p> +<td align="left" id="r3c1-t38" headers="r1c1-t38"> +<p>Fetch</p> </td> -<td align="left" headers="r4c1-t39 r1c2-t39"> -<p>Specifies if this field is one of the following:</p> +<td align="left" headers="r3c1-t38 r1c2-t38"> +<p>Defines how data is loaded from the database:</p> <ul> <li> -<p>Date – <code>java.sql.Date</code></p> +<p>Eager – Data is loaded in before it is actually needed.</p> </li> <li> -<p>Time – <code>java.sql.Time</code></p> -</li> -<li> -<p>Timestamp – <code>java.sql.Timestamp</code></p> +<p>Lazy – Data is loaded only when required by the transaction.</p> </li> </ul> -<p>This field corresponds to the <code>@Temporal</code> annotation.</p> </td> -<td align="left" headers="r4c1-t39 r1c3-t39"> -<p><a href="tasks010.htm#BABBABCE">Basic mapping</a>, <a href="tasks014.htm#BABGCBHG">ID mapping</a>, and <a href="tasks020.htm#BABHIBII">Version mapping</a></p> +<td align="left" headers="r3c1-t38 r1c3-t38"> +<p>Lazy</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t39" headers="r1c1-t39"> -<p><a id="sthref510" name="sthref510"></a><a id="sthref511" name="sthref511"></a>Enumerated</p> +<td align="left" id="r4c1-t38" headers="r1c1-t38"> +<p>Join fetch</p> </td> -<td align="left" headers="r5c1-t39 r1c2-t39"> -<p>Specify how to persist enumerated constraints if the <code>String</code> value suits your application requirements or to match an existing database schema.</p> +<td align="left" headers="r4c1-t38 r1c2-t38"> +<p>The type of fetch to use:</p> <ul> <li> -<p><code>ordinal</code></p> +<p>Inner – Provides the inner join fetching of the related object.</p> +<p><span class="bold">Note</span>: Inner joining does not allow for null or empty values</p> </li> <li> -<p><code>String</code></p> +<p>Outer – Provides the outer join fetching of the related object</p> +<p><span class="bold">Note</span>: Outer joining allows for null or empty values.</p> </li> </ul> -<p>This field corresponds to the <code>@Enumerated</code> annotation.</p> </td> -<td align="left" headers="r5c1-t39 r1c3-t39"> -<p><a href="tasks010.htm#BABBABCE">Basic mapping</a></p> -<br /></td> +<td align="left" headers="r4c1-t38 r1c3-t38"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t38" headers="r1c1-t38"> +<p>Optional</p> +</td> +<td align="left" headers="r5c1-t38 r1c2-t38"> +<p>Specifies if this field is can be null.</p> +</td> +<td align="left" headers="r5c1-t38 r1c3-t38"> +<p>True</p> +</td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t39" headers="r1c1-t39"> -<p>Converted</p> +<td align="left" id="r6c1-t38" headers="r1c1-t38"> +<p>Cascade</p> </td> -<td align="left" headers="r6c1-t39 r1c2-t39"> -<p>Converter name:</p> +<td align="left" headers="r6c1-t38 r1c2-t38"> +<p>Specify which operations are propagated throughout the entity.</p> <ul> <li> -<p>None (default) –</p> +<p>All – All operations</p> +</li> +<li> +<p>Persist</p> </li> <li> -<p>class-instance –</p> +<p>Merge</p> </li> <li> -<p>serialized –</p> +<p>Move</p> +</li> +<li> +<p>Remove</p> +</li> +<li> +<p>Refresh</p> </li> </ul> </td> -<td align="left" headers="r6c1-t39 r1c3-t39"> -<p><a href="tasks010.htm#BABBABCE">Basic mapping</a>, <a href="tasks014.htm#BABGCBHG">ID mapping</a>, and <a href="tasks020.htm#BABHIBII">Version mapping</a></p> +<td align="left" headers="r6c1-t38 r1c3-t38"> +<p>True</p> </td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformal" --></div> +<!-- class="inftblhruleinformal" --> +<p>Many-to-one mappings also include the following areas:</p> +<ul> +<li> +<p><a href="reference043.htm#CACIJEGI">Joining Strategy</a></p> +</li> +<li> +<p><a href="reference044.htm#CACGHHGB">Derived Identity</a></p> +</li> +</ul> +</div> <!-- class="sect3" --> <!-- Start Footer --> <div class="footer"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference036.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference036.htm index 120c78eb3d..fb3eb59ef2 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference036.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference036.htm @@ -5,22 +5,147 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Value</title> +<title>One-to-Many Mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Value" /> +<meta name="doctitle" content="One-to-Many Mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACJBFEA" name="CACJBFEA"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACHGGHH" name="CACHGGHH"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Value</h1> +<h1><a id="sthref521" name="sthref521"></a><a id="sthref522" name="sthref522"></a><a id="sthref523" name="sthref523"></a>One-to-Many Mapping</h1> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" summary="JPA Details view, One-to-one page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="29%" /> +<col width="*" /> +<col width="24%" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t39">Property</th> +<th align="left" valign="bottom" id="r1c2-t39">Description</th> +<th align="left" valign="bottom" id="r1c3-t39">Default</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t39" headers="r1c1-t39"> +<p>Target entity</p> +</td> +<td align="left" headers="r2c1-t39 r1c2-t39"> +<p>The persistent entity to which the attribute is mapped.</p> +</td> +<td align="left" headers="r2c1-t39 r1c3-t39"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t39" headers="r1c1-t39"> +<p>Fetch</p> +</td> +<td align="left" headers="r3c1-t39 r1c2-t39"> +<p>Defines how data is loaded from the database:</p> +<ul> +<li> +<p>Eager – Data is loaded in before it is actually needed.</p> +</li> +<li> +<p>Lazy – Data is loaded only when required by the transaction.</p> +</li> +</ul> +</td> +<td align="left" headers="r3c1-t39 r1c3-t39"> +<p>Lazy</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t39" headers="r1c1-t39"> +<p>Join fetch</p> +</td> +<td align="left" headers="r4c1-t39 r1c2-t39"> +<p>The type of fetch to use:</p> +<ul> +<li> +<p>Inner – Provides the inner join fetching of the related object.</p> +<p><span class="bold">Note</span>: Inner joining does not allow for null or empty values</p> +</li> +<li> +<p>Outer – Provides the outer join fetching of the related object</p> +<p><span class="bold">Note</span>: Outer joining allows for null or empty values.</p> +</li> +</ul> +</td> +<td align="left" headers="r4c1-t39 r1c3-t39"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t39" headers="r1c1-t39"> +<p>Private owned</p> +</td> +<td align="left" headers="r5c1-t39 r1c2-t39"> +<p>Specify that a relationship is privately owned; target object is a dependent part of the source object and is not referenced by any other object and cannot exist on its own.</p> +</td> +<td align="left" headers="r5c1-t39 r1c3-t39"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t39" headers="r1c1-t39"> +<p>Orphan removal</p> +</td> +<td align="left" headers="r6c1-t39 r1c2-t39"><br /></td> +<td align="left" headers="r6c1-t39 r1c3-t39"> +<p>False</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t39" headers="r1c1-t39"> +<p>Cascade</p> +</td> +<td align="left" headers="r7c1-t39 r1c2-t39"> +<p>Specify which operations are propagated throughout the entity.</p> +<ul> +<li> +<p>All – 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="r7c1-t39 r1c3-t39"> +<p>True</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<p>One-to-many mappings also include the following areas:</p> +<ul> +<li> +<p><a href="reference043.htm#CACIJEGI">Joining Strategy</a></p> +</li> +<li> +<p><a href="reference041.htm#CACJCHJB">Converters</a></p> +</li> +<li> +<p><a href="reference042.htm#CACBIJFD">Ordering</a></p> +</li> +</ul> </div> <!-- class="sect3" --> <!-- Start Footer --> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference037.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference037.htm index 4054c59481..830438ed6f 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference037.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference037.htm @@ -5,133 +5,155 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Converters</title> +<title>One-to-One Mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Converters" /> +<meta name="doctitle" content="One-to-One Mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACJCHJB" name="CACJCHJB"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACGGHDD" name="CACGGHDD"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref512" name="sthref512"></a><a id="sthref513" name="sthref513"></a>Converters</h1> -<div class="inftblhruleinformalwide"> -<table class="HRuleInformalWide" title="JPA Details view, Advanced page" summary="JPA Details view, Advanced page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="16%" /> +<h1><a id="sthref524" name="sthref524"></a><a id="sthref525" name="sthref525"></a><a id="sthref526" name="sthref526"></a>One-to-One Mapping</h1> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" summary="JPA Details view, One-to-one page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="29%" /> <col width="*" /> -<col width="17%" /> -<col width="25%" /> +<col width="24%" /> <thead> <tr align="left" valign="top"> <th align="left" valign="bottom" id="r1c1-t40">Property</th> <th align="left" valign="bottom" id="r1c2-t40">Description</th> <th align="left" valign="bottom" id="r1c3-t40">Default</th> -<th align="left" valign="bottom" id="r1c4-t40">Available for Entity Type</th> </tr> </thead> <tbody> <tr align="left" valign="top"> <td align="left" id="r2c1-t40" headers="r1c1-t40"> -<p>Converters</p> +<p>Target entity</p> </td> <td align="left" headers="r2c1-t40 r1c2-t40"> -<p>Click Add and use the <a href="ref_add_converter.htm#CIAGCGIJ">Add Converter dialog</a> to create a new converter.</p> -<ul> -<li> -<p>Object Type</p> -</li> -<li> -<p>Type</p> -</li> -<li> -<p>Struct</p> -</li> -<li> -<p>Custom</p> -</li> -</ul> +<p>The persistent entity to which the attribute is mapped.</p> </td> <td align="left" headers="r2c1-t40 r1c3-t40"><br /></td> -<td align="left" headers="r2c1-t40 r1c4-t40"> -<p><a href="tasks010.htm#BABBABCE">Basic mapping</a>, <a href="tasks011.htm#CIHHJEBJ">Element collection mapping</a>, <a href="tasks014.htm#BABGCBHG">ID mapping</a>, <a href="tasks015.htm#BABEIEGD">Many-to-many mapping</a>, <a href="tasks017.htm#BABHGEBD">One-to-many mapping</a>, and <a href="tasks020.htm#BABHIBII">Version mapping</a></p> -</td> </tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t40" headers="r1c1-t40"> -<p>Name</p> +<p>Fetch</p> </td> <td align="left" headers="r3c1-t40 r1c2-t40"> -<p>Name of the converter.</p> +<p>Defines how data is loaded from the database:</p> +<ul> +<li> +<p>Eager – Data is loaded in before it is actually needed.</p> +</li> +<li> +<p>Lazy – Data is loaded only when required by the transaction.</p> +</li> +</ul> +</td> +<td align="left" headers="r3c1-t40 r1c3-t40"> +<p>Eager</p> </td> -<td align="left" headers="r3c1-t40 r1c3-t40"><br /></td> -<td align="left" headers="r3c1-t40 r1c4-t40"><br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r4c1-t40" headers="r1c1-t40"> -<p>Class</p> +<p>Join fetch</p> </td> <td align="left" headers="r4c1-t40 r1c2-t40"> -<p>Appears for <span class="bold">Custom</span> and <span class="bold">Struct</span> converters only.</p> +<p>The type of fetch to use:</p> +<ul> +<li> +<p>Inner – Provides the inner join fetching of the related object.</p> +<p><span class="bold">Note</span>: Inner joining does not allow for null or empty values</p> +</li> +<li> +<p>Outer – Provides the outer join fetching of the related object</p> +<p><span class="bold">Note</span>: Outer joining allows for null or empty values.</p> +</li> +</ul> </td> <td align="left" headers="r4c1-t40 r1c3-t40"><br /></td> -<td align="left" headers="r4c1-t40 r1c4-t40"><br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r5c1-t40" headers="r1c1-t40"> -<p>Data type</p> +<p>Optional</p> </td> <td align="left" headers="r5c1-t40 r1c2-t40"> -<p>Appears for <span class="bold">Object Type</span> and <span class="bold">Type</span> converters only.</p> +<p>Specifies if this field is can be null.</p> +</td> +<td align="left" headers="r5c1-t40 r1c3-t40"> +<p>True</p> </td> -<td align="left" headers="r5c1-t40 r1c3-t40"><br /></td> -<td align="left" headers="r5c1-t40 r1c4-t40"><br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r6c1-t40" headers="r1c1-t40"> -<p>Object type</p> +<p>Private owned</p> </td> <td align="left" headers="r6c1-t40 r1c2-t40"> -<p>Appears for <span class="bold">Object Type</span> and <span class="bold">Type</span> converters only.</p> +<p>Specify that a relationship is privately owned; target object is a dependent part of the source object and is not referenced by any other object and cannot exist on its own.</p> +</td> +<td align="left" headers="r6c1-t40 r1c3-t40"> +<p>False</p> </td> -<td align="left" headers="r6c1-t40 r1c3-t40"><br /></td> -<td align="left" headers="r6c1-t40 r1c4-t40"><br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r7c1-t40" headers="r1c1-t40"> -<p>Conversion values</p> +<p>Orphan removal</p> </td> -<td align="left" headers="r7c1-t40 r1c2-t40"> -<p>Appears for <span class="bold">Object Type</span> converters only.</p> +<td align="left" headers="r7c1-t40 r1c2-t40"><br /></td> +<td align="left" headers="r7c1-t40 r1c3-t40"> +<p>False</p> </td> -<td align="left" headers="r7c1-t40 r1c3-t40"><br /></td> -<td align="left" headers="r7c1-t40 r1c4-t40"><br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r8c1-t40" headers="r1c1-t40"> -<p>Default object value</p> +<p>Cascade</p> </td> <td align="left" headers="r8c1-t40 r1c2-t40"> -<p>Appears for <span class="bold">Object Type</span> converters only.</p> +<p>Specify which operations are propagated throughout the entity.</p> +<ul> +<li> +<p>All – 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="r8c1-t40 r1c3-t40"> +<p>True</p> </td> -<td align="left" headers="r8c1-t40 r1c3-t40"><br /></td> -<td align="left" headers="r8c1-t40 r1c4-t40"><br /></td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformalwide" --> -<a id="sthref514" name="sthref514"></a> -<p class="subhead2">Related reference</p> +<!-- class="inftblhruleinformal" --> +<p>One-to-one mappings also include the following areas:</p> <ul> <li> -<p>"Converter" in <span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> -<code><a href="http://eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_converter.htm">http://eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_converter.htm</a></code></p> +<p><a href="reference044.htm#CACGHHGB">Derived Identity</a></p> +</li> +<li> +<p><a href="reference043.htm#CACIJEGI">Joining Strategy</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference038.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference038.htm index bb3f476239..7c3cb21bce 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference038.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference038.htm @@ -5,114 +5,183 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Ordering</title> +<title>Version Mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Ordering" /> +<meta name="doctitle" content="Version Mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACBIJFD" name="CACBIJFD"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACHAEBB" name="CACHAEBB"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Ordering</h1> -<p><a id="sthref515" name="sthref515"></a><a id="sthref516" name="sthref516"></a><a id="sthref517" name="sthref517"></a>Specify the default order for objects returned from a query. These options correspond to the <code>@OrderBy</code> annotation.</p> -<div class="inftblhruleinformalwide"> -<table class="HRuleInformalWide" title="JPA Details view, Advanced page" summary="JPA Details view, Advanced page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="16%" /> +<h1><a id="sthref527" name="sthref527"></a><a id="sthref528" name="sthref528"></a><a id="sthref529" name="sthref529"></a>Version Mapping</h1> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" summary="JPA Details view, Version page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="29%" /> <col width="*" /> -<col width="17%" /> -<col width="25%" /> +<col width="24%" /> <thead> <tr align="left" valign="top"> <th align="left" valign="bottom" id="r1c1-t41">Property</th> <th align="left" valign="bottom" id="r1c2-t41">Description</th> <th align="left" valign="bottom" id="r1c3-t41">Default</th> -<th align="left" valign="bottom" id="r1c4-t41">Available for Entity Type</th> </tr> </thead> <tbody> <tr align="left" valign="top"> <td align="left" id="r2c1-t41" headers="r1c1-t41"> -<p><span class="bold">None</span></p> +<p><span class="bold">Column</span></p> </td> -<td align="left" headers="r2c1-t41 r1c2-t41"><br /></td> -<td align="left" headers="r2c1-t41 r1c3-t41"><br /></td> -<td align="left" headers="r2c1-t41 r1c4-t41"> -<p><a href="tasks011.htm#CIHHJEBJ">Element collection mapping</a>, <a href="tasks015.htm#BABEIEGD">Many-to-many mapping</a>, and <a href="tasks017.htm#BABHGEBD">One-to-many mapping</a></p> +<td align="left" headers="r2c1-t41 r1c2-t41"> +<p><a id="sthref530" name="sthref530"></a><a id="sthref531" name="sthref531"></a>The database column that contains the value for the attribute. This field corresponds to the <code>@Column</code> annotation.</p> +</td> +<td align="left" headers="r2c1-t41 r1c3-t41"> +<p>By default, the Column is assumed to be named identically to the attribute.</p> </td> </tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t41" headers="r1c1-t41"> -<p><span class="bold">Primary key</span></p> +<p>Name</p> +</td> +<td align="left" headers="r3c1-t41 r1c2-t41"> +<p>The database column mapped to the entity attribute.</p> +<p>By default, the Column is assumed to be named identically to the attribute and always included in the <code>INSERT</code> and <code>UPDATE</code> statements.</p> </td> -<td align="left" headers="r3c1-t41 r1c2-t41"><br /></td> <td align="left" headers="r3c1-t41 r1c3-t41"><br /></td> -<td align="left" headers="r3c1-t41 r1c4-t41"><br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r4c1-t41" headers="r1c1-t41"> -<p><span class="bold">Custom</span></p> +<p>Table</p> +</td> +<td align="left" headers="r4c1-t41 r1c2-t41"> +<p>Name of the database table that contains the selected column.</p> </td> -<td align="left" headers="r4c1-t41 r1c2-t41"><br /></td> <td align="left" headers="r4c1-t41 r1c3-t41"><br /></td> -<td align="left" headers="r4c1-t41 r1c4-t41"><br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r5c1-t41" headers="r1c1-t41"> -<p><span class="bold">Order column</span></p> +<p><span class="bold">Details</span></p> </td> <td align="left" headers="r5c1-t41 r1c2-t41"><br /></td> <td align="left" headers="r5c1-t41 r1c3-t41"><br /></td> -<td align="left" headers="r5c1-t41 r1c4-t41"><br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r6c1-t41" headers="r1c1-t41"> <p>Insertable</p> </td> -<td align="left" headers="r6c1-t41 r1c2-t41"><br /></td> +<td align="left" headers="r6c1-t41 r1c2-t41"> +<p>Specifies if the column is always included in <code>SQL INSERT</code> statements.</p> +</td> <td align="left" headers="r6c1-t41 r1c3-t41"> <p>True</p> </td> -<td align="left" headers="r6c1-t41 r1c4-t41"><br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r7c1-t41" headers="r1c1-t41"> <p>Updatable</p> </td> -<td align="left" headers="r7c1-t41 r1c2-t41"><br /></td> +<td align="left" headers="r7c1-t41 r1c2-t41"> +<p>Specifies if this column is always included in <code>SQL UPDATE</code> statements.</p> +</td> <td align="left" headers="r7c1-t41 r1c3-t41"> <p>True</p> </td> -<td align="left" headers="r7c1-t41 r1c4-t41"><br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r8c1-t41" headers="r1c1-t41"> -<p>Nullable</p> +<p>Unique</p> +</td> +<td align="left" headers="r8c1-t41 r1c2-t41"> +<p>Sets the <code>UNIQUE</code> constraint for the column.</p> </td> -<td align="left" headers="r8c1-t41 r1c2-t41"><br /></td> <td align="left" headers="r8c1-t41 r1c3-t41"> -<p>True</p> +<p>False</p> </td> -<td align="left" headers="r8c1-t41 r1c4-t41"><br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r9c1-t41" headers="r1c1-t41"> +<p>Nullable</p> +</td> +<td align="left" headers="r9c1-t41 r1c2-t41"> +<p>Specifies if the column allows null values.</p> +</td> +<td align="left" headers="r9c1-t41 r1c3-t41"> +<p>True</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r10c1-t41" headers="r1c1-t41"> +<p>Length</p> +</td> +<td align="left" headers="r10c1-t41 r1c2-t41"> +<p>Sets the column length.</p> +</td> +<td align="left" headers="r10c1-t41 r1c3-t41"> +<p>255</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r11c1-t41" headers="r1c1-t41"> +<p>Precision</p> +</td> +<td align="left" headers="r11c1-t41 r1c2-t41"> +<p>Sets the precision for the column values.</p> +</td> +<td align="left" headers="r11c1-t41 r1c3-t41"> +<p>0</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r12c1-t41" headers="r1c1-t41"> +<p>Scale</p> +</td> +<td align="left" headers="r12c1-t41 r1c2-t41"> +<p>Sets the number of digits that appear to the right of the decimal point.</p> +</td> +<td align="left" headers="r12c1-t41 r1c3-t41"> +<p>0</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r13c1-t41" headers="r1c1-t41"> <p>Column definition</p> </td> -<td align="left" headers="r9c1-t41 r1c2-t41"><br /></td> -<td align="left" headers="r9c1-t41 r1c3-t41"><br /></td> -<td align="left" headers="r9c1-t41 r1c4-t41"><br /></td> +<td align="left" headers="r13c1-t41 r1c2-t41"> +<p>The SQL fragment that is used when generating the DDL for the column.</p> +</td> +<td align="left" headers="r13c1-t41 r1c3-t41"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r14c1-t41" headers="r1c1-t41"> +<p><span class="bold">Mutable</span></p> +</td> +<td align="left" headers="r14c1-t41 r1c2-t41"> +<p>Specify if the value of a complex field type can be changed (or not changed) instead of being replaced.</p> +</td> +<td align="left" headers="r14c1-t41 r1c3-t41"> +<p>True</p> +</td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformalwide" --></div> +<!-- class="inftblhruleinformal" --> +<p>Version mappings also include the following areas:</p> +<ul> +<li> +<p><a href="reference039.htm#CACIHAAF">Type information</a></p> +</li> +<li> +<p><a href="reference041.htm#CACJCHJB">Converters</a></p> +</li> +</ul> +</div> <!-- class="sect3" --> <!-- Start Footer --> <div class="footer"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference039.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference039.htm index ee5fa7b162..ea626bbd98 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference039.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference039.htm @@ -5,23 +5,22 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Joining Strategy</title> +<title>Type information</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Joining Strategy" /> +<meta name="doctitle" content="Type information" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACIJEGI" name="CACIJEGI"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACIHAAF" name="CACIHAAF"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref518" name="sthref518"></a><a id="sthref519" name="sthref519"></a>Joining Strategy</h1> -<p>Use this area to specify a mapped column for joining an entity association. By default, the mapping is assumed to have a single join.</p> +<h1><a id="sthref532" name="sthref532"></a>Type information</h1> <div class="inftblhruleinformal"> <table class="HRuleInformal" summary="JPA Details view, Type page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="29%" /> @@ -37,93 +36,89 @@ <tbody> <tr align="left" valign="top"> <td align="left" id="r2c1-t42" headers="r1c1-t42"> -<p><span class="bold">Mapped by</span></p> -</td> -<td align="left" headers="r2c1-t42 r1c2-t42"> -<p>The field in the database table that "owns" the relationship. This field is required only on the non-owning side of the relationship.</p> +<p>Default</p> </td> +<td align="left" headers="r2c1-t42 r1c2-t42"><br /></td> <td align="left" headers="r2c1-t42 r1c3-t42"> -<p><a href="tasks015.htm#BABEIEGD">Many-to-many mapping</a>, <a href="tasks017.htm#BABHGEBD">One-to-many mapping</a>, and <a href="tasks018.htm#BABFHBCJ">One-to-one mapping</a></p> +<p><a href="tasks011.htm#BABBABCE">Basic mapping</a>, <a href="tasks015.htm#BABGCBHG">ID mapping</a>, and <a href="tasks021.htm#BABHIBII">Version mapping</a></p> </td> </tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t42" headers="r1c1-t42"> -<p>Attribute</p> +<p><a id="sthref533" name="sthref533"></a>LOB</p> +</td> +<td align="left" headers="r3c1-t42 r1c2-t42"> +<p>Specify if the field is mapped to <code>java.sql.Clob</code> or <code>java.sql.Blob</code>.</p> +<p>This field corresponds to the <code>@Lob</code> annotation.</p> </td> -<td align="left" headers="r3c1-t42 r1c2-t42"><br /></td> -<td align="left" headers="r3c1-t42 r1c3-t42"><br /></td> +<td align="left" headers="r3c1-t42 r1c3-t42"> +<p><a href="tasks011.htm#BABBABCE">Basic mapping</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r4c1-t42" headers="r1c1-t42"> -<p><span class="bold">Primary key join columns</span></p> +<p><a id="sthref534" name="sthref534"></a><a id="sthref535" name="sthref535"></a><a id="sthref536" name="sthref536"></a>Temporal</p> +</td> +<td align="left" headers="r4c1-t42 r1c2-t42"> +<p>Specifies if this field is one of the following:</p> +<ul> +<li> +<p>Date – <code>java.sql.Date</code></p> +</li> +<li> +<p>Time – <code>java.sql.Time</code></p> +</li> +<li> +<p>Timestamp – <code>java.sql.Timestamp</code></p> +</li> +</ul> +<p>This field corresponds to the <code>@Temporal</code> annotation.</p> </td> -<td align="left" headers="r4c1-t42 r1c2-t42"><br /></td> <td align="left" headers="r4c1-t42 r1c3-t42"> -<p><a href="tasks018.htm#BABFHBCJ">One-to-one mapping</a></p> -<br /></td> +<p><a href="tasks011.htm#BABBABCE">Basic mapping</a>, <a href="tasks015.htm#BABGCBHG">ID mapping</a>, and <a href="tasks021.htm#BABHIBII">Version mapping</a></p> +</td> </tr> <tr align="left" valign="top"> <td align="left" id="r5c1-t42" headers="r1c1-t42"> -<p><span class="bold">Join columns</span></p> +<p><a id="sthref537" name="sthref537"></a><a id="sthref538" name="sthref538"></a>Enumerated</p> </td> <td align="left" headers="r5c1-t42 r1c2-t42"> -<p><a id="sthref520" name="sthref520"></a><a id="sthref521" name="sthref521"></a>By default, the name is assumed to be the primary tables associated with the entities concatenated with an underscore.</p> -<p>Select <span class="bold">Override Default</span>, then Add, Edit, or Remove the join columns.</p> +<p>Specify how to persist enumerated constraints if the <code>String</code> value suits your application requirements or to match an existing database schema.</p> +<ul> +<li> +<p><code>ordinal</code></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="r5c1-t42 r1c3-t42"> -<p><a href="tasks016.htm#BABHFAFJ">Many-to-one mapping</a>, <a href="tasks017.htm#BABHGEBD">One-to-many mapping</a>, and <a href="tasks018.htm#BABFHBCJ">One-to-one mapping</a></p> -</td> +<p><a href="tasks011.htm#BABBABCE">Basic mapping</a></p> +<br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r6c1-t42" headers="r1c1-t42"> -<p><span class="bold">Join table</span></p> +<p>Converted</p> </td> <td align="left" headers="r6c1-t42 r1c2-t42"> -<p>Name of the join table that contains the foreign key column.You must specify the join table on the owning side.</p> -<p>By default, the name is assumed to be the primary tables associated with the entities concatenated with an underscore.</p> +<p>Converter name:</p> +<ul> +<li> +<p>None (default) –</p> +</li> +<li> +<p>class-instance –</p> +</li> +<li> +<p>serialized –</p> +</li> +</ul> </td> <td align="left" headers="r6c1-t42 r1c3-t42"> -<p><a href="tasks015.htm#BABEIEGD">Many-to-many mapping</a>, <a href="tasks016.htm#BABHFAFJ">Many-to-one mapping</a>, <a href="tasks017.htm#BABHGEBD">One-to-many mapping</a>, and <a href="tasks018.htm#BABFHBCJ">One-to-one mapping</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t42" headers="r1c1-t42"> -<p>Name</p> -</td> -<td align="left" headers="r7c1-t42 r1c2-t42"><br /></td> -<td align="left" headers="r7c1-t42 r1c3-t42"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r8c1-t42" headers="r1c1-t42"> -<p>Schema</p> -</td> -<td align="left" headers="r8c1-t42 r1c2-t42"><br /></td> -<td align="left" headers="r8c1-t42 r1c3-t42"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r9c1-t42" headers="r1c1-t42"> -<p>Catalog</p> -</td> -<td align="left" headers="r9c1-t42 r1c2-t42"><br /></td> -<td align="left" headers="r9c1-t42 r1c3-t42"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r10c1-t42" headers="r1c1-t42"> -<p>Join columns</p> -</td> -<td align="left" headers="r10c1-t42 r1c2-t42"> -<p>Mapped by</p> -</td> -<td align="left" headers="r10c1-t42 r1c3-t42"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r11c1-t42" headers="r1c1-t42"> -<p>Inverse join columns</p> -</td> -<td align="left" headers="r11c1-t42 r1c2-t42"> -<p>Mapped by</p> +<p><a href="tasks011.htm#BABBABCE">Basic mapping</a>, <a href="tasks015.htm#BABGCBHG">ID mapping</a>, and <a href="tasks021.htm#BABHIBII">Version mapping</a></p> </td> -<td align="left" headers="r11c1-t42 r1c3-t42"><br /></td> </tr> </tbody> </table> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference040.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference040.htm index 0b05a239ce..b427b5ed9c 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference040.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference040.htm @@ -5,66 +5,23 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Derived Identity</title> +<title>Value</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Derived Identity" /> +<meta name="doctitle" content="Value" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACGHHGB" name="CACGHHGB"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACJBFEA" name="CACJBFEA"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref522" name="sthref522"></a><a id="sthref523" name="sthref523"></a>Derived Identity</h1> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="JPA Details view, Type page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="29%" /> -<col width="*" /> -<col width="24%" /> -<thead> -<tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t43">Property</th> -<th align="left" valign="bottom" id="r1c2-t43">Description</th> -<th align="left" valign="bottom" id="r1c3-t43">Available for Mapping Type</th> -</tr> -</thead> -<tbody> -<tr align="left" valign="top"> -<td align="left" id="r2c1-t43" headers="r1c1-t43"> -<p>None</p> -</td> -<td align="left" headers="r2c1-t43 r1c2-t43"><br /></td> -<td align="left" headers="r2c1-t43 r1c3-t43"> -<p><a href="tasks016.htm#BABHFAFJ">Many-to-one mapping</a> and <a href="tasks018.htm#BABFHBCJ">One-to-one mapping</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t43" headers="r1c1-t43"> -<p>ID</p> -</td> -<td align="left" headers="r3c1-t43 r1c2-t43"><br /></td> -<td align="left" headers="r3c1-t43 r1c3-t43"> -<p><a href="tasks016.htm#BABHFAFJ">Many-to-one mapping</a> and <a href="tasks018.htm#BABFHBCJ">One-to-one mapping</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t43" headers="r1c1-t43"> -<p>Maps ID</p> -</td> -<td align="left" headers="r4c1-t43 r1c2-t43"><br /></td> -<td align="left" headers="r4c1-t43 r1c3-t43"> -<p><a href="tasks016.htm#BABHFAFJ">Many-to-one mapping</a> and <a href="tasks018.htm#BABFHBCJ">One-to-one mapping</a></p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblhruleinformal" --></div> +<h1>Value</h1> +</div> <!-- class="sect3" --> <!-- Start Footer --> <div class="footer"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference041.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference041.htm index 57a215ee48..5ca042c287 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference041.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference041.htm @@ -5,99 +5,133 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Entity Mappings</title> +<title>Converters</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Entity Mappings" /> +<meta name="doctitle" content="Converters" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACCACGH" name="CACCACGH"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACJCHJB" name="CACJCHJB"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Entity Mappings</h1> -<p>This table lists the Entity Mappings fields available in the <span class="gui-object-title">JPA Details</span> view for each entity type.</p> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="21%" /> +<h1><a id="sthref539" name="sthref539"></a><a id="sthref540" name="sthref540"></a>Converters</h1> +<div class="inftblhruleinformalwide"> +<table class="HRuleInformalWide" title="JPA Details view, Advanced page" summary="JPA Details view, Advanced page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="16%" /> <col width="*" /> -<col width="22%" /> +<col width="17%" /> +<col width="25%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t45">Property</th> -<th align="left" valign="bottom" id="r1c2-t45">Description</th> -<th align="left" valign="bottom" id="r1c3-t45">Default</th> +<th align="left" valign="bottom" id="r1c1-t43">Property</th> +<th align="left" valign="bottom" id="r1c2-t43">Description</th> +<th align="left" valign="bottom" id="r1c3-t43">Default</th> +<th align="left" valign="bottom" id="r1c4-t43">Available for Entity Type</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t45" headers="r1c1-t45"> -<p>Package</p> +<td align="left" id="r2c1-t43" headers="r1c1-t43"> +<p>Converters</p> </td> -<td align="left" headers="r2c1-t45 r1c2-t45"> -<p>The Java package that contains the persistent entities. Click <span class="bold">Browse</span> and select the package</p> +<td align="left" headers="r2c1-t43 r1c2-t43"> +<p>Click Add and use the <a href="ref_add_converter.htm#CIAGCGIJ">Add Converter dialog</a> to create a new converter.</p> +<ul> +<li> +<p>Object Type</p> +</li> +<li> +<p>Type</p> +</li> +<li> +<p>Struct</p> +</li> +<li> +<p>Custom</p> +</li> +</ul> +</td> +<td align="left" headers="r2c1-t43 r1c3-t43"><br /></td> +<td align="left" headers="r2c1-t43 r1c4-t43"> +<p><a href="tasks011.htm#BABBABCE">Basic mapping</a>, <a href="tasks012.htm#CIHHJEBJ">Element collection mapping</a>, <a href="tasks015.htm#BABGCBHG">ID mapping</a>, <a href="tasks016.htm#BABEIEGD">Many-to-many mapping</a>, <a href="tasks018.htm#BABHGEBD">One-to-many mapping</a>, and <a href="tasks021.htm#BABHIBII">Version mapping</a></p> </td> -<td align="left" headers="r2c1-t45 r1c3-t45"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t45" headers="r1c1-t45"> -<p>Schema</p> +<td align="left" id="r3c1-t43" headers="r1c1-t43"> +<p>Name</p> </td> -<td align="left" headers="r3c1-t45 r1c2-t45"> -<p>The database schema that contains the <span class="bold">Table</span>.</p> -<p>This field corresponds to the <code><schema></code> element in the <code>orm.xml</code> file.</p> +<td align="left" headers="r3c1-t43 r1c2-t43"> +<p>Name of the converter.</p> </td> -<td align="left" headers="r3c1-t45 r1c3-t45"><br /></td> +<td align="left" headers="r3c1-t43 r1c3-t43"><br /></td> +<td align="left" headers="r3c1-t43 r1c4-t43"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t45" headers="r1c1-t45"> -<p>Catalog</p> +<td align="left" id="r4c1-t43" headers="r1c1-t43"> +<p>Class</p> </td> -<td align="left" headers="r4c1-t45 r1c2-t45"> -<p>The database catalog that contains the <span class="bold">Table</span>.</p> -<p>This field corresponds to the <code><catalog></code> element in the <code>orm.xml</code> file.</p> +<td align="left" headers="r4c1-t43 r1c2-t43"> +<p>Appears for <span class="bold">Custom</span> and <span class="bold">Struct</span> converters only.</p> </td> -<td align="left" headers="r4c1-t45 r1c3-t45"><br /></td> +<td align="left" headers="r4c1-t43 r1c3-t43"><br /></td> +<td align="left" headers="r4c1-t43 r1c4-t43"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t45" headers="r1c1-t45"> -<p>Access</p> +<td align="left" id="r5c1-t43" headers="r1c1-t43"> +<p>Data type</p> </td> -<td align="left" headers="r5c1-t45 r1c2-t45"> -<p>Specify the default access method for the variables in the project:</p> -<ul> -<li> -<p>Property</p> -</li> -<li> -<p>Field</p> -</li> -</ul> -<p>This field corresponds to the <code><access></code> element in the <code>orm.xml</code> file.</p> +<td align="left" headers="r5c1-t43 r1c2-t43"> +<p>Appears for <span class="bold">Object Type</span> and <span class="bold">Type</span> converters only.</p> </td> -<td align="left" headers="r5c1-t45 r1c3-t45"><br /></td> +<td align="left" headers="r5c1-t43 r1c3-t43"><br /></td> +<td align="left" headers="r5c1-t43 r1c4-t43"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t43" headers="r1c1-t43"> +<p>Object type</p> +</td> +<td align="left" headers="r6c1-t43 r1c2-t43"> +<p>Appears for <span class="bold">Object Type</span> and <span class="bold">Type</span> converters only.</p> +</td> +<td align="left" headers="r6c1-t43 r1c3-t43"><br /></td> +<td align="left" headers="r6c1-t43 r1c4-t43"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t43" headers="r1c1-t43"> +<p>Conversion values</p> +</td> +<td align="left" headers="r7c1-t43 r1c2-t43"> +<p>Appears for <span class="bold">Object Type</span> converters only.</p> +</td> +<td align="left" headers="r7c1-t43 r1c3-t43"><br /></td> +<td align="left" headers="r7c1-t43 r1c4-t43"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r8c1-t43" headers="r1c1-t43"> +<p>Default object value</p> +</td> +<td align="left" headers="r8c1-t43 r1c2-t43"> +<p>Appears for <span class="bold">Object Type</span> converters only.</p> +</td> +<td align="left" headers="r8c1-t43 r1c3-t43"><br /></td> +<td align="left" headers="r8c1-t43 r1c4-t43"><br /></td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformal" --> -<a id="sthref533" name="sthref533"></a> -<p class="subhead2">Related tasks</p> -<ul> -<li> -<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> -</li> -</ul> -<a id="sthref534" name="sthref534"></a> +<!-- class="inftblhruleinformalwide" --> +<a id="sthref541" name="sthref541"></a> <p class="subhead2">Related reference</p> <ul> <li> -<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> +<p>"Converter" in <span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> +<code><a href="http://eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_converter.htm">http://eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_converter.htm</a></code></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference042.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference042.htm index b5213266f1..28a8f456c6 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference042.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference042.htm @@ -5,119 +5,114 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Persistence Unit</title> +<title>Ordering</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Persistence Unit" /> +<meta name="doctitle" content="Ordering" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACEAGBG" name="CACEAGBG"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACBIJFD" name="CACBIJFD"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref535" name="sthref535"></a><a id="sthref536" name="sthref536"></a>Persistence Unit</h1> -<p>This table lists the Persistence Unit information fields available in the <span class="gui-object-title">JPA Details</span> view for each entity type. These fields are contained in the <code><persistence-unit-metadata></code> element in the <code>orm.xml</code> file.</p> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="21%" /> +<h1>Ordering</h1> +<p><a id="sthref542" name="sthref542"></a><a id="sthref543" name="sthref543"></a><a id="sthref544" name="sthref544"></a>Specify the default order for objects returned from a query. These options correspond to the <code>@OrderBy</code> annotation.</p> +<div class="inftblhruleinformalwide"> +<table class="HRuleInformalWide" title="JPA Details view, Advanced page" summary="JPA Details view, Advanced page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="16%" /> <col width="*" /> -<col width="22%" /> +<col width="17%" /> +<col width="25%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t46">Property</th> -<th align="left" valign="bottom" id="r1c2-t46">Description</th> -<th align="left" valign="bottom" id="r1c3-t46">Default</th> +<th align="left" valign="bottom" id="r1c1-t44">Property</th> +<th align="left" valign="bottom" id="r1c2-t44">Description</th> +<th align="left" valign="bottom" id="r1c3-t44">Default</th> +<th align="left" valign="bottom" id="r1c4-t44">Available for Entity Type</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t46" headers="r1c1-t46"> -<p>XML Mapping Data Complete</p> +<td align="left" id="r2c1-t44" headers="r1c1-t44"> +<p><span class="bold">None</span></p> </td> -<td align="left" headers="r2c1-t46 r1c2-t46"> -<p>Specifies that the Java classes in this persistence unit are fully specified by their metadata. Any annotations will be ignored.</p> -<p>This field corresponds to the <code><xml-mapping-metadata-complete></code> element in the <code>orm.xml</code> file.</p> +<td align="left" headers="r2c1-t44 r1c2-t44"><br /></td> +<td align="left" headers="r2c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r2c1-t44 r1c4-t44"> +<p><a href="tasks012.htm#CIHHJEBJ">Element collection mapping</a>, <a href="tasks016.htm#BABEIEGD">Many-to-many mapping</a>, and <a href="tasks018.htm#BABHGEBD">One-to-many mapping</a></p> </td> -<td align="left" headers="r2c1-t46 r1c3-t46"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t46" headers="r1c1-t46"> -<p>Cascade Persist</p> +<td align="left" id="r3c1-t44" headers="r1c1-t44"> +<p><span class="bold">Primary key</span></p> </td> -<td align="left" headers="r3c1-t46 r1c2-t46"> -<p>Adds cascade-persist to the set of cascade options in entity relationships of the persistence unit.</p> -<p>This field corresponds to the <code><cascade-persist></code> element in the <code>orm.xml</code> file.</p> +<td align="left" headers="r3c1-t44 r1c2-t44"><br /></td> +<td align="left" headers="r3c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r3c1-t44 r1c4-t44"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t44" headers="r1c1-t44"> +<p><span class="bold">Custom</span></p> +</td> +<td align="left" headers="r4c1-t44 r1c2-t44"><br /></td> +<td align="left" headers="r4c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r4c1-t44 r1c4-t44"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t44" headers="r1c1-t44"> +<p><span class="bold">Order column</span></p> </td> -<td align="left" headers="r3c1-t46 r1c3-t46"><br /></td> +<td align="left" headers="r5c1-t44 r1c2-t44"><br /></td> +<td align="left" headers="r5c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r5c1-t44 r1c4-t44"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t46" headers="r1c1-t46"> -<p>Schema</p> +<td align="left" id="r6c1-t44" headers="r1c1-t44"> +<p>Insertable</p> </td> -<td align="left" headers="r4c1-t46 r1c2-t46"> -<p>The database schema that contains the <span class="bold">Table</span>.</p> -<p>This field corresponds to the <code><schema></code> element in the <code>orm.xml</code> file.</p> +<td align="left" headers="r6c1-t44 r1c2-t44"><br /></td> +<td align="left" headers="r6c1-t44 r1c3-t44"> +<p>True</p> </td> -<td align="left" headers="r4c1-t46 r1c3-t46"><br /></td> +<td align="left" headers="r6c1-t44 r1c4-t44"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t46" headers="r1c1-t46"> -<p>Catalog</p> +<td align="left" id="r7c1-t44" headers="r1c1-t44"> +<p>Updatable</p> </td> -<td align="left" headers="r5c1-t46 r1c2-t46"> -<p>The database catalog that contains the <span class="bold">Table</span>.</p> -<p>This field corresponds to the <code><catalog></code> element in the <code>orm.xml</code> file.</p> +<td align="left" headers="r7c1-t44 r1c2-t44"><br /></td> +<td align="left" headers="r7c1-t44 r1c3-t44"> +<p>True</p> </td> -<td align="left" headers="r5c1-t46 r1c3-t46"><br /></td> +<td align="left" headers="r7c1-t44 r1c4-t44"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t46" headers="r1c1-t46"> -<p>Access</p> +<td align="left" id="r8c1-t44" headers="r1c1-t44"> +<p>Nullable</p> </td> -<td align="left" headers="r6c1-t46 r1c2-t46"> -<p>Specify how the entity its access instance variables.</p> -<ul> -<li> -<p>Property – Persistent state accessed through the property accessor methods. The property accessor methods must be <span class="bold">public</span> or <span class="bold">private</span>.</p> -</li> -<li> -<p>Field – Instance variables are accessed directly. All non-transient instance variables are persistent.</p> -</li> -</ul> +<td align="left" headers="r8c1-t44 r1c2-t44"><br /></td> +<td align="left" headers="r8c1-t44 r1c3-t44"> +<p>True</p> </td> -<td align="left" headers="r6c1-t46 r1c3-t46"><br /></td> +<td align="left" headers="r8c1-t44 r1c4-t44"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r7c1-t46" headers="r1c1-t46"> -<p>Deliminated identifiers</p> +<td align="left" id="r9c1-t44" headers="r1c1-t44"> +<p>Column definition</p> </td> -<td align="left" headers="r7c1-t46 r1c2-t46"><br /></td> -<td align="left" headers="r7c1-t46 r1c3-t46"><br /></td> +<td align="left" headers="r9c1-t44 r1c2-t44"><br /></td> +<td align="left" headers="r9c1-t44 r1c3-t44"><br /></td> +<td align="left" headers="r9c1-t44 r1c4-t44"><br /></td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformal" --> -<a id="sthref537" name="sthref537"></a> -<p class="subhead2">Related tasks</p> -<ul> -<li> -<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> -</li> -</ul> -<a id="sthref538" name="sthref538"></a> -<p class="subhead2">Related reference</p> -<ul> -<li> -<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> -</li> -</ul> -</div> +<!-- class="inftblhruleinformalwide" --></div> <!-- class="sect3" --> <!-- Start Footer --> <div class="footer"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference043.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference043.htm index 8f8e4e148d..2e1c923897 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference043.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference043.htm @@ -5,177 +5,130 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Generators</title> +<title>Joining Strategy</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Generators" /> +<meta name="doctitle" content="Joining Strategy" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIAFGAIJ" name="CIAFGAIJ"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACIJEGI" name="CACIJEGI"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref539" name="sthref539"></a><a id="sthref540" name="sthref540"></a>Generators</h1> -<p>This table lists the Generator fields available in the <span class="gui-object-title">JPA Details</span> view for the <code>orm.xml</code> file.</p> +<h1><a id="sthref545" name="sthref545"></a><a id="sthref546" name="sthref546"></a>Joining Strategy</h1> +<p>Use this area to specify a mapped column for joining an entity association. By default, the mapping is assumed to have a single join.</p> <div class="inftblhruleinformal"> -<table class="HRuleInformal" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="21%" /> +<table class="HRuleInformal" summary="JPA Details view, Type page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="29%" /> <col width="*" /> <col width="24%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t47">Property</th> -<th align="left" valign="bottom" id="r1c2-t47">Description</th> -<th align="left" valign="bottom" id="r1c3-t47">Default</th> +<th align="left" valign="bottom" id="r1c1-t45">Property</th> +<th align="left" valign="bottom" id="r1c2-t45">Description</th> +<th align="left" valign="bottom" id="r1c3-t45">Available for Mapping Type</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t47" headers="r1c1-t47"> -<p><span class="bold">Generators</span></p> +<td align="left" id="r2c1-t45" headers="r1c1-t45"> +<p><span class="bold">Mapped by</span></p> </td> -<td align="left" headers="r2c1-t47 r1c2-t47"> -<p>Click <span class="bold">Add</span> to create a new table or sequence generator, or select an existing generator and click <span class="bold">Remove</span>, to add or remove a generator.</p> +<td align="left" headers="r2c1-t45 r1c2-t45"> +<p>The field in the database table that "owns" the relationship. This field is required only on the non-owning side of the relationship.</p> </td> -<td align="left" headers="r2c1-t47 r1c3-t47"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t47" headers="r1c1-t47"> -<p><span class="bold">Sequence Generators</span></p> -</td> -<td align="left" headers="r3c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r3c1-t47 r1c3-t47"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t47" headers="r1c1-t47"> -<p>Name</p> +<td align="left" headers="r2c1-t45 r1c3-t45"> +<p><a href="tasks016.htm#BABEIEGD">Many-to-many mapping</a>, <a href="tasks018.htm#BABHGEBD">One-to-many mapping</a>, and <a href="tasks019.htm#BABFHBCJ">One-to-one mapping</a></p> </td> -<td align="left" headers="r4c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r4c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t47" headers="r1c1-t47"> -<p>Sequence</p> +<td align="left" id="r3c1-t45" headers="r1c1-t45"> +<p>Attribute</p> </td> -<td align="left" headers="r5c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r5c1-t47 r1c3-t47"><br /></td> +<td align="left" headers="r3c1-t45 r1c2-t45"><br /></td> +<td align="left" headers="r3c1-t45 r1c3-t45"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t47" headers="r1c1-t47"> -<p>Schema</p> +<td align="left" id="r4c1-t45" headers="r1c1-t45"> +<p><span class="bold">Primary key join columns</span></p> </td> -<td align="left" headers="r6c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r6c1-t47 r1c3-t47"><br /></td> +<td align="left" headers="r4c1-t45 r1c2-t45"><br /></td> +<td align="left" headers="r4c1-t45 r1c3-t45"> +<p><a href="tasks019.htm#BABFHBCJ">One-to-one mapping</a></p> +<br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r7c1-t47" headers="r1c1-t47"> -<p>Catalog</p> +<td align="left" id="r5c1-t45" headers="r1c1-t45"> +<p><span class="bold">Join columns</span></p> </td> -<td align="left" headers="r7c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r7c1-t47 r1c3-t47"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r8c1-t47" headers="r1c1-t47"> -<p>Allocation size</p> +<td align="left" headers="r5c1-t45 r1c2-t45"> +<p><a id="sthref547" name="sthref547"></a><a id="sthref548" name="sthref548"></a>By default, the name is assumed to be the primary tables associated with the entities concatenated with an underscore.</p> +<p>Select <span class="bold">Override Default</span>, then Add, Edit, or Remove the join columns.</p> </td> -<td align="left" headers="r8c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r8c1-t47 r1c3-t47"> -<p>50</p> +<td align="left" headers="r5c1-t45 r1c3-t45"> +<p><a href="tasks017.htm#BABHFAFJ">Many-to-one mapping</a>, <a href="tasks018.htm#BABHGEBD">One-to-many mapping</a>, and <a href="tasks019.htm#BABFHBCJ">One-to-one mapping</a></p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r9c1-t47" headers="r1c1-t47"> -<p>Initial value</p> +<td align="left" id="r6c1-t45" headers="r1c1-t45"> +<p><span class="bold">Join table</span></p> </td> -<td align="left" headers="r9c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r9c1-t47 r1c3-t47"> -<p>1</p> +<td align="left" headers="r6c1-t45 r1c2-t45"> +<p>Name of the join table that contains the foreign key column.You must specify the join table on the owning side.</p> +<p>By default, the name is assumed to be the primary tables associated with the entities concatenated with an underscore.</p> </td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r10c1-t47" headers="r1c1-t47"> -<p><span class="bold">Table Generators</span></p> +<td align="left" headers="r6c1-t45 r1c3-t45"> +<p><a href="tasks016.htm#BABEIEGD">Many-to-many mapping</a>, <a href="tasks017.htm#BABHFAFJ">Many-to-one mapping</a>, <a href="tasks018.htm#BABHGEBD">One-to-many mapping</a>, and <a href="tasks019.htm#BABFHBCJ">One-to-one mapping</a></p> </td> -<td align="left" headers="r10c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r10c1-t47 r1c3-t47"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r11c1-t47" headers="r1c1-t47"> +<td align="left" id="r7c1-t45" headers="r1c1-t45"> <p>Name</p> </td> -<td align="left" headers="r11c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r11c1-t47 r1c3-t47"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r12c1-t47" headers="r1c1-t47"> -<p>Table</p> -</td> -<td align="left" headers="r12c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r12c1-t47 r1c3-t47"><br /></td> +<td align="left" headers="r7c1-t45 r1c2-t45"><br /></td> +<td align="left" headers="r7c1-t45 r1c3-t45"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r13c1-t47" headers="r1c1-t47"> +<td align="left" id="r8c1-t45" headers="r1c1-t45"> <p>Schema</p> </td> -<td align="left" headers="r13c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r13c1-t47 r1c3-t47"><br /></td> +<td align="left" headers="r8c1-t45 r1c2-t45"><br /></td> +<td align="left" headers="r8c1-t45 r1c3-t45"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r14c1-t47" headers="r1c1-t47"> +<td align="left" id="r9c1-t45" headers="r1c1-t45"> <p>Catalog</p> </td> -<td align="left" headers="r14c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r14c1-t47 r1c3-t47"><br /></td> +<td align="left" headers="r9c1-t45 r1c2-t45"><br /></td> +<td align="left" headers="r9c1-t45 r1c3-t45"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r15c1-t47" headers="r1c1-t47"> -<p>Primary key column value</p> +<td align="left" id="r10c1-t45" headers="r1c1-t45"> +<p>Join columns</p> </td> -<td align="left" headers="r15c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r15c1-t47 r1c3-t47"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r16c1-t47" headers="r1c1-t47"> -<p>Allocation size</p> -</td> -<td align="left" headers="r16c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r16c1-t47 r1c3-t47"> -<p>50</p> +<td align="left" headers="r10c1-t45 r1c2-t45"> +<p>Mapped by</p> </td> +<td align="left" headers="r10c1-t45 r1c3-t45"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r17c1-t47" headers="r1c1-t47"> -<p>Initial value</p> +<td align="left" id="r11c1-t45" headers="r1c1-t45"> +<p>Inverse join columns</p> </td> -<td align="left" headers="r17c1-t47 r1c2-t47"><br /></td> -<td align="left" headers="r17c1-t47 r1c3-t47"> -<p>1</p> +<td align="left" headers="r11c1-t45 r1c2-t45"> +<p>Mapped by</p> </td> +<td align="left" headers="r11c1-t45 r1c3-t45"><br /></td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformal" --> -<a id="sthref541" name="sthref541"></a> -<p class="subhead2">Related tasks</p> -<ul> -<li> -<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> -</li> -</ul> -<a id="sthref542" name="sthref542"></a> -<p class="subhead2">Related reference</p> -<ul> -<li> -<p><a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a></p> -</li> -</ul> -</div> +<!-- class="inftblhruleinformal" --></div> <!-- class="sect3" --> <!-- Start Footer --> <div class="footer"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference044.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference044.htm index 4109728065..d9fd996109 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference044.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference044.htm @@ -5,135 +5,66 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Queries</title> +<title>Derived Identity</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:27:59Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Queries" /> +<meta name="doctitle" content="Derived Identity" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIAIBAAJ" name="CIAIBAAJ"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACGHHGB" name="CACGHHGB"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref543" name="sthref543"></a><a id="sthref544" name="sthref544"></a><a id="sthref545" name="sthref545"></a><a id="sthref546" name="sthref546"></a><a id="sthref547" name="sthref547"></a><a id="sthref548" name="sthref548"></a><a id="sthref549" name="sthref549"></a>Queries</h1> -<p>This table lists the Query information fields available in the <span class="gui-object-title">JPA Details</span> view for the <code>orm.xml</code> file.</p> +<h1><a id="sthref549" name="sthref549"></a><a id="sthref550" name="sthref550"></a>Derived Identity</h1> <div class="inftblhruleinformal"> -<table class="HRuleInformal" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="21%" /> +<table class="HRuleInformal" summary="JPA Details view, Type page" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="29%" /> <col width="*" /> -<col width="23%" /> +<col width="24%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t48">Property</th> -<th align="left" valign="bottom" id="r1c2-t48">Description</th> -<th align="left" valign="bottom" id="r1c3-t48">Default</th> +<th align="left" valign="bottom" id="r1c1-t46">Property</th> +<th align="left" valign="bottom" id="r1c2-t46">Description</th> +<th align="left" valign="bottom" id="r1c3-t46">Available for Mapping Type</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t48" headers="r1c1-t48"> -<p><span class="bold">Queries</span></p> -</td> -<td align="left" headers="r2c1-t48 r1c2-t48"> -<p>Displays the existing Named and Native queries.</p> -<p>Click <span class="bold">Add</span> to add a named query, or <span class="bold">Add Native</span> for a native query.</p> -<p>For named queries, enter the query in the Query field.</p> -<p>For native queries, select a result class, then enter the query in the Query field.</p> -</td> -<td align="left" headers="r2c1-t48 r1c3-t48"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t48" headers="r1c1-t48"> -<p><span class="bold">Named Queries</span></p> -</td> -<td align="left" headers="r3c1-t48 r1c2-t48"><br /></td> -<td align="left" headers="r3c1-t48 r1c3-t48"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t48" headers="r1c1-t48"> -<p>Name</p> -</td> -<td align="left" headers="r4c1-t48 r1c2-t48"><br /></td> -<td align="left" headers="r4c1-t48 r1c3-t48"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t48" headers="r1c1-t48"> -<p>Query</p> -</td> -<td align="left" headers="r5c1-t48 r1c2-t48"><br /></td> -<td align="left" headers="r5c1-t48 r1c3-t48"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t48" headers="r1c1-t48"> -<p>Lock mode</p> -</td> -<td align="left" headers="r6c1-t48 r1c2-t48"><br /></td> -<td align="left" headers="r6c1-t48 r1c3-t48"> +<td align="left" id="r2c1-t46" headers="r1c1-t46"> <p>None</p> </td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t48" headers="r1c1-t48"> -<p><span class="bold">Native Queries</span></p> +<td align="left" headers="r2c1-t46 r1c2-t46"><br /></td> +<td align="left" headers="r2c1-t46 r1c3-t46"> +<p><a href="tasks017.htm#BABHFAFJ">Many-to-one mapping</a> and <a href="tasks019.htm#BABFHBCJ">One-to-one mapping</a></p> </td> -<td align="left" headers="r7c1-t48 r1c2-t48"><br /></td> -<td align="left" headers="r7c1-t48 r1c3-t48"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r8c1-t48" headers="r1c1-t48"> -<p>Name</p> +<td align="left" id="r3c1-t46" headers="r1c1-t46"> +<p>ID</p> </td> -<td align="left" headers="r8c1-t48 r1c2-t48"><br /></td> -<td align="left" headers="r8c1-t48 r1c3-t48"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r9c1-t48" headers="r1c1-t48"> -<p>Result class</p> +<td align="left" headers="r3c1-t46 r1c2-t46"><br /></td> +<td align="left" headers="r3c1-t46 r1c3-t46"> +<p><a href="tasks017.htm#BABHFAFJ">Many-to-one mapping</a> and <a href="tasks019.htm#BABFHBCJ">One-to-one mapping</a></p> </td> -<td align="left" headers="r9c1-t48 r1c2-t48"><br /></td> -<td align="left" headers="r9c1-t48 r1c3-t48"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r10c1-t48" headers="r1c1-t48"> -<p>Query</p> +<td align="left" id="r4c1-t46" headers="r1c1-t46"> +<p>Maps ID</p> </td> -<td align="left" headers="r10c1-t48 r1c2-t48"><br /></td> -<td align="left" headers="r10c1-t48 r1c3-t48"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r11c1-t48" headers="r1c1-t48"> -<p><span class="bold">Query Hints</span></p> +<td align="left" headers="r4c1-t46 r1c2-t46"><br /></td> +<td align="left" headers="r4c1-t46 r1c3-t46"> +<p><a href="tasks017.htm#BABHFAFJ">Many-to-one mapping</a> and <a href="tasks019.htm#BABFHBCJ">One-to-one mapping</a></p> </td> -<td align="left" headers="r11c1-t48 r1c2-t48"> -<p>Displays the existing query hints (Name and Value).</p> -<p>Click <span class="bold">Add</span> to add a new query hint.</p> -</td> -<td align="left" headers="r11c1-t48 r1c3-t48"><br /></td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformal" --> -<a id="sthref550" name="sthref550"></a> -<p class="subhead2">Related tasks</p> -<ul> -<li> -<p><a href="tasks009.htm#BABIGBGG">Creating queries</a></p> -</li> -</ul> -<a id="sthref551" name="sthref551"></a> -<p class="subhead2">Related reference</p> -<ul> -<li> -<p><a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a></p> -</li> -</ul> -</div> +<!-- class="inftblhruleinformal" --></div> <!-- class="sect3" --> <!-- Start Footer --> <div class="footer"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference045.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference045.htm index 18ae5ae3f7..e0dbf9e54c 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference045.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference045.htm @@ -5,34 +5,103 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Converters</title> +<title>Entity Mappings</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Converters" /> +<meta name="doctitle" content="Entity Mappings" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIADGCID" name="CIADGCID"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACCACGH" name="CACCACGH"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Converters</h1> -<p><a id="sthref552" name="sthref552"></a>The Converters information in the JPA Details view applies only when using EclipseLink.</p> -<p>Click <span class="bold">Add</span> to create a new converter, using the <a href="ref_add_converter.htm#CIAGCGIJ">Add Converter dialog</a>.</p> -<a id="sthref553" name="sthref553"></a> +<h1>Entity Mappings</h1> +<p>This table lists the Entity Mappings fields available in the <span class="gui-object-title">JPA Details</span> view for each entity type.</p> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="21%" /> +<col width="*" /> +<col width="22%" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t48">Property</th> +<th align="left" valign="bottom" id="r1c2-t48">Description</th> +<th align="left" valign="bottom" id="r1c3-t48">Default</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t48" headers="r1c1-t48"> +<p>Package</p> +</td> +<td align="left" headers="r2c1-t48 r1c2-t48"> +<p>The Java package that contains the persistent entities. Click <span class="bold">Browse</span> and select the package</p> +</td> +<td align="left" headers="r2c1-t48 r1c3-t48"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t48" headers="r1c1-t48"> +<p>Schema</p> +</td> +<td align="left" headers="r3c1-t48 r1c2-t48"> +<p>The database schema that contains the <span class="bold">Table</span>.</p> +<p>This field corresponds to the <code><schema></code> element in the <code>orm.xml</code> file.</p> +</td> +<td align="left" headers="r3c1-t48 r1c3-t48"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t48" headers="r1c1-t48"> +<p>Catalog</p> +</td> +<td align="left" headers="r4c1-t48 r1c2-t48"> +<p>The database catalog that contains the <span class="bold">Table</span>.</p> +<p>This field corresponds to the <code><catalog></code> element in the <code>orm.xml</code> file.</p> +</td> +<td align="left" headers="r4c1-t48 r1c3-t48"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t48" headers="r1c1-t48"> +<p>Access</p> +</td> +<td align="left" headers="r5c1-t48 r1c2-t48"> +<p>Specify the default access method for the variables in the project:</p> +<ul> +<li> +<p>Property</p> +</li> +<li> +<p>Field</p> +</li> +</ul> +<p>This field corresponds to the <code><access></code> element in the <code>orm.xml</code> file.</p> +</td> +<td align="left" headers="r5c1-t48 r1c3-t48"><br /></td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<a id="sthref560" name="sthref560"></a> +<p class="subhead2">Related tasks</p> +<ul> +<li> +<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> +</li> +</ul> +<a id="sthref561" name="sthref561"></a> <p class="subhead2">Related reference</p> <ul> <li> -<p><a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a></p> +<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> </ul> </div> <!-- class="sect3" --> -<!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference046.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference046.htm index 081dde8587..87195f704f 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference046.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference046.htm @@ -5,238 +5,116 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Connection</title> +<title>Persistence Unit</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Connection" /> +<meta name="doctitle" content="Persistence Unit" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> -<meta name="topic-id" content="ref_persistence_connection" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIAFFJIE" name="CIAFFJIE"></a><a id="ref_persistence_connection" name="ref_persistence_connection"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACEAGBG" name="CACEAGBG"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Connection</h1> -<p><a id="sthref563" name="sthref563"></a>The following table lists the properties available in the Connection page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> +<h1><a id="sthref562" name="sthref562"></a><a id="sthref563" name="sthref563"></a>Persistence Unit</h1> +<p>This table lists the Persistence Unit information fields available in the <span class="gui-object-title">JPA Details</span> view for each entity type. These fields are contained in the <code><persistence-unit-metadata></code> element in the <code>orm.xml</code> file.</p> <div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="The following table lists the properties available in the Connection page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="25%" /> +<table class="HRuleInformal" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="21%" /> <col width="*" /> -<col width="24%" /> +<col width="22%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t50">Property</th> -<th align="left" valign="bottom" id="r1c2-t50">Description</th> -<th align="left" valign="bottom" id="r1c3-t50">Default</th> +<th align="left" valign="bottom" id="r1c1-t49">Property</th> +<th align="left" valign="bottom" id="r1c2-t49">Description</th> +<th align="left" valign="bottom" id="r1c3-t49">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t50" headers="r1c1-t50"> -<p>Transaction type<a id="sthref564" name="sthref564"></a></p> +<td align="left" id="r2c1-t49" headers="r1c1-t49"> +<p>XML Mapping Data Complete</p> </td> -<td align="left" headers="r2c1-t50 r1c2-t50"> -<p>Specify if the connection for this persistence unit uses one of the following transaction types:</p> -<ul> -<li> -<p><span class="bold">Default</span> -- Select to use the container used by the container.</p> -</li> -<li> -<p><span class="bold">JTA</span> (Java Transaction API) -- Transactions of the Java EE server.</p> -</li> -<li> -<p><span class="bold">Resource Local</span> -- Native actions of a JDBC driver that are referenced by a persistence unit.</p> -</li> -</ul> -</td> -<td align="left" headers="r2c1-t50 r1c3-t50"> -<p>JTA</p> +<td align="left" headers="r2c1-t49 r1c2-t49"> +<p>Specifies that the Java classes in this persistence unit are fully specified by their metadata. Any annotations will be ignored.</p> +<p>This field corresponds to the <code><xml-mapping-metadata-complete></code> element in the <code>orm.xml</code> file.</p> </td> +<td align="left" headers="r2c1-t49 r1c3-t49"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t50" headers="r1c1-t50"> -<p>Batch writing<a id="sthref565" name="sthref565"></a></p> +<td align="left" id="r3c1-t49" headers="r1c1-t49"> +<p>Cascade Persist</p> </td> -<td align="left" headers="r3c1-t50 r1c2-t50"> -<p>Specify the use of batch writing to optimize transactions with multiple write operations.</p> -<p>Set the value of this property into the session at deployment time.</p> -<p><span class="bold">Note</span>: This property applies when used both in a Java SE and Java EE environment.</p> -<p>The following are the valid values for oracle.toplink.config.BatchWriting:</p> -<ul> -<li> -<p><span class="bold">JDBC</span>–Use JDBC batch writing.</p> -</li> -<li> -<p><span class="bold">Buffered</span>–Do not use either JDBC batch writing nor native platform batch writing.</p> -</li> -<li> -<p><span class="bold">OracleJDBC</span>–Use both JDBC batch writing and Oracle native platform batch writing.</p> -</li> -<li> -<p><span class="bold">None</span>–Do not use batch writing (turn it off).</p> -</li> -</ul> -</td> -<td align="left" headers="r3c1-t50 r1c3-t50"> -<p>None</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t50" headers="r1c1-t50"> -<p>Statement caching</p> -</td> -<td align="left" headers="r4c1-t50 r1c2-t50"> -<p>Specify if the query caches its JDBC statement. If enabled, you can also set the number of statements to cache.</p> -</td> -<td align="left" headers="r4c1-t50 r1c3-t50"> -<p>50</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t50" headers="r1c1-t50"> -<p>Native SQL</p> -</td> -<td align="left" headers="r5c1-t50 r1c2-t50"> -<p>Specify if Dali includes platform-specific (that is, "native") SQL statements. If false, Dali uses generic SLQ.</p> -</td> -<td align="left" headers="r5c1-t50 r1c3-t50"> -<p>False</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t50" headers="r1c1-t50"> -<p><span class="bold">Database</span></p> +<td align="left" headers="r3c1-t49 r1c2-t49"> +<p>Adds cascade-persist to the set of cascade options in entity relationships of the persistence unit.</p> +<p>This field corresponds to the <code><cascade-persist></code> element in the <code>orm.xml</code> file.</p> </td> -<td align="left" headers="r6c1-t50 r1c2-t50"><br /></td> -<td align="left" headers="r6c1-t50 r1c3-t50"><br /></td> +<td align="left" headers="r3c1-t49 r1c3-t49"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r7c1-t50" headers="r1c1-t50"> -<p>JTA Data Source Name</p> +<td align="left" id="r4c1-t49" headers="r1c1-t49"> +<p>Schema</p> </td> -<td align="left" headers="r7c1-t50 r1c2-t50"> -<p>If you selected <span class="bold">JTA</span> as the transaction type, then enter the name of the default JTA data source for the persistence unit.</p> +<td align="left" headers="r4c1-t49 r1c2-t49"> +<p>The database schema that contains the <span class="bold">Table</span>.</p> +<p>This field corresponds to the <code><schema></code> element in the <code>orm.xml</code> file.</p> </td> -<td align="left" headers="r7c1-t50 r1c3-t50"><br /></td> +<td align="left" headers="r4c1-t49 r1c3-t49"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r8c1-t50" headers="r1c1-t50"> -<p>Non-JTA Data Source Name</p> +<td align="left" id="r5c1-t49" headers="r1c1-t49"> +<p>Catalog</p> </td> -<td align="left" headers="r8c1-t50 r1c2-t50"> -<p>If you selected <span class="bold">Resource Local</span> as the transaction type, then enter the name of the non-JTA data source.</p> -<p>This property is not available for projects using the <span class="bold">Generic</span> platform.</p> +<td align="left" headers="r5c1-t49 r1c2-t49"> +<p>The database catalog that contains the <span class="bold">Table</span>.</p> +<p>This field corresponds to the <code><catalog></code> element in the <code>orm.xml</code> file.</p> </td> -<td align="left" headers="r8c1-t50 r1c3-t50"><br /></td> +<td align="left" headers="r5c1-t49 r1c3-t49"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r9c1-t50" headers="r1c1-t50"> -<p><span class="bold">EclipseLink connection pool</span></p> +<td align="left" id="r6c1-t49" headers="r1c1-t49"> +<p>Access</p> </td> -<td align="left" headers="r9c1-t50 r1c2-t50"> -<p>Define the connection pool driver, URL, user name and password.</p> -<p>These properties are note available for projects using the Generic platform.</p> -</td> -<td align="left" headers="r9c1-t50 r1c3-t50"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r10c1-t50" headers="r1c1-t50"> -<p>Bind parameters</p> -</td> -<td align="left" headers="r10c1-t50 r1c2-t50"> -<p>Control whether or not the query uses parameter binding.</p> -<p>Note: This property applies when used in a Java SE environment.</p> -<p>This property is not available for projects using the Generic platform.</p> -</td> -<td align="left" headers="r10c1-t50 r1c3-t50"> -<p>True</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r11c1-t50" headers="r1c1-t50"> -<p>Read Connection</p> -</td> -<td align="left" headers="r11c1-t50 r1c2-t50"> -<p>The maximum and minimum number of connections allowed in the JDBC read connection pool.</p> -<p><span class="bold">Note</span>: These property apply when used in a Java SE environment.</p> -<p>These properties are not available for projects using the Generic platform</p> -</td> -<td align="left" headers="r11c1-t50 r1c3-t50"> -<p>Minimum: 2</p> -<p>Maximum 2</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r12c1-t50" headers="r1c1-t50"> -<p>Write Connection</p> -</td> -<td align="left" headers="r12c1-t50 r1c2-t50"> -<p>The maximum and minimum number of connections allowed in the JDBC read connection pool.</p> -<p><span class="bold">Note</span>: These property apply when used in a Java SE environment.</p> -<p>These properties are not available for projects using the Generic platform</p> -</td> -<td align="left" headers="r12c1-t50 r1c3-t50"> -<p>Minimum: 5</p> -<p>Maximum 10</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r13c1-t50" headers="r1c1-t50"> -<p><span class="bold">Exclusive connections</span></p> -</td> -<td align="left" headers="r13c1-t50 r1c2-t50"> -<p>These fields are available only when <span class="bold">Transaction Type</span> is <span class="bold">Local Resource</span>.</p> -</td> -<td align="left" headers="r13c1-t50 r1c3-t50"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r14c1-t50" headers="r1c1-t50"> -<p>Exclusive connection mode</p> -</td> -<td align="left" headers="r14c1-t50 r1c2-t50"> -<p>Specify when Dali performs reads through the write connection.</p> +<td align="left" headers="r6c1-t49 r1c2-t49"> +<p>Specify how the entity its access instance variables.</p> <ul> <li> -<p>Always – Create an exclusive isolated client session if reading an isolated entity, otherwise create an exclusive client session.</p> -</li> -<li> -<p>Isolated – Create an exclusive isolated client session if reading an isolated entity, otherwise raise an error.</p> +<p>Property – Persistent state accessed through the property accessor methods. The property accessor methods must be <span class="bold">public</span> or <span class="bold">private</span>.</p> </li> <li> -<p>Transactional – Create an isolated client session if some or all entities require isolated cache, otherwise create a client session.</p> +<p>Field – Instance variables are accessed directly. All non-transient instance variables are persistent.</p> </li> </ul> </td> -<td align="left" headers="r14c1-t50 r1c3-t50"> -<p>Transactional</p> -</td> +<td align="left" headers="r6c1-t49 r1c3-t49"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r15c1-t50" headers="r1c1-t50"> -<p>Lazy connection acquisition</p> -</td> -<td align="left" headers="r15c1-t50 r1c2-t50"> -<p>Specify if Dali acquires write connections lazily.</p> -</td> -<td align="left" headers="r15c1-t50 r1c3-t50"> -<p>True</p> +<td align="left" id="r7c1-t49" headers="r1c1-t49"> +<p>Deliminated identifiers</p> </td> +<td align="left" headers="r7c1-t49 r1c2-t49"><br /></td> +<td align="left" headers="r7c1-t49 r1c3-t49"><br /></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref566" name="sthref566"></a> -<p class="subhead2">Related references</p> +<a id="sthref564" name="sthref564"></a> +<p class="subhead2">Related tasks</p> +<ul> +<li> +<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> +</li> +</ul> +<a id="sthref565" name="sthref565"></a> +<p class="subhead2">Related reference</p> <ul> <li> -<p><span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> -<code><a href="http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm">http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm</a></code></p> +<p><a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference047.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference047.htm index 16d8f50f5f..49e51d0689 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference047.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference047.htm @@ -5,219 +5,174 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Customization</title> +<title>Generators</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Customization" /> +<meta name="doctitle" content="Generators" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> -<meta name="topic-id" content="ref_persistence_customization" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIAJAFEG" name="CIAJAFEG"></a><a id="ref_persistence_customization" name="ref_persistence_customization"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIAFGAIJ" name="CIAFGAIJ"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1>Customization</h1> -<p><a id="sthref567" name="sthref567"></a>The following table lists the properties available in the Customization page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> +<h1><a id="sthref566" name="sthref566"></a><a id="sthref567" name="sthref567"></a>Generators</h1> +<p>This table lists the Generator fields available in the <span class="gui-object-title">JPA Details</span> view for the <code>orm.xml</code> file.</p> <div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="The following table lists the properties available in the Customization page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="24%" /> +<table class="HRuleInformal" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="21%" /> <col width="*" /> <col width="24%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t51">Property</th> -<th align="left" valign="bottom" id="r1c2-t51">Description</th> -<th align="left" valign="bottom" id="r1c3-t51">Default</th> +<th align="left" valign="bottom" id="r1c1-t50">Property</th> +<th align="left" valign="bottom" id="r1c2-t50">Description</th> +<th align="left" valign="bottom" id="r1c3-t50">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t51" headers="r1c1-t51"> -<p><span class="bold">Weaving</span></p> -</td> -<td align="left" headers="r2c1-t51 r1c2-t51"> -<p>Specifies if weaving of the entity classes is performed. The EclipseLink JPA persistence provider uses weaving to enhance JPA entities for such properties as lazy loading, change tracking, fetch groups, and internal optimizations. Select from the following options:</p> -<ul> -<li> -<p><span class="bold">No Weaving</span></p> -</li> -<li> -<p><span class="bold">Weave Dynamically</span></p> -</li> -<li> -<p><span class="bold">Weave Statically</span> -- Use this option if you plan to execute your application outside of a Java EE 5 container in an environment that does not permit the use of <code>-javaagent:eclipselink.jar</code> on the JVM command line. This assumes that classes have already been statically woven. Run the static weaver on the classes before deploying them.</p> -</li> -</ul> +<td align="left" id="r2c1-t50" headers="r1c1-t50"> +<p><span class="bold">Generators</span></p> </td> -<td align="left" headers="r2c1-t51 r1c3-t51"> -<p>Weave Dynamically</p> +<td align="left" headers="r2c1-t50 r1c2-t50"> +<p>Click <span class="bold">Add</span> to create a new table or sequence generator, or select an existing generator and click <span class="bold">Remove</span>, to add or remove a generator.</p> </td> +<td align="left" headers="r2c1-t50 r1c3-t50"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t51" headers="r1c1-t51"> -<p>Lazy</p> -</td> -<td align="left" headers="r3c1-t51 r1c2-t51"> -<p>Select this option to enable lazy weaving.</p> -</td> -<td align="left" headers="r3c1-t51 r1c3-t51"> -<p>True</p> +<td align="left" id="r3c1-t50" headers="r1c1-t50"> +<p><span class="bold">Sequence Generators</span></p> </td> +<td align="left" headers="r3c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r3c1-t50 r1c3-t50"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t51" headers="r1c1-t51"> -<p>Fetch Groups</p> -</td> -<td align="left" headers="r4c1-t51 r1c2-t51"> -<p>Select this option to enable fetch groups through weaving. Set this option to false if:</p> -<ul> -<li> -<p>There is no weaving.</p> -</li> -<li> -<p>Classes should not be changed during weaving (for example, when debugging).</p> -</li> -</ul> -<p>Set this property to false for platforms where it is not supported.</p> -</td> -<td align="left" headers="r4c1-t51 r1c3-t51"> -<p>True</p> +<td align="left" id="r4c1-t50" headers="r1c1-t50"> +<p>Name</p> </td> +<td align="left" headers="r4c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r4c1-t50 r1c3-t50"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t51" headers="r1c1-t51"> -<p>Internal</p> -</td> -<td align="left" headers="r5c1-t51 r1c2-t51"> -<p>Specify if Dali uses internal optimizations through weaving.</p> -<p>If enabled, enables lazy one-to-one and many-to-one mappings through weaving.</p> -</td> -<td align="left" headers="r5c1-t51 r1c3-t51"> -<p>True</p> +<td align="left" id="r5c1-t50" headers="r1c1-t50"> +<p>Sequence</p> </td> +<td align="left" headers="r5c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r5c1-t50 r1c3-t50"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t51" headers="r1c1-t51"> -<p>Eager</p> -</td> -<td align="left" headers="r6c1-t51 r1c2-t51"> -<p>Specify if Dali uses indirection on eager relationships.</p> -</td> -<td align="left" headers="r6c1-t51 r1c3-t51"> -<p>False</p> +<td align="left" id="r6c1-t50" headers="r1c1-t50"> +<p>Schema</p> </td> +<td align="left" headers="r6c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r6c1-t50 r1c3-t50"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r7c1-t51" headers="r1c1-t51"> -<p>Change Tracking</p> +<td align="left" id="r7c1-t50" headers="r1c1-t50"> +<p>Catalog</p> </td> -<td align="left" headers="r7c1-t51 r1c2-t51"> -<p>Select this option to use weaving to detect which fields or properties of the object change.</p> +<td align="left" headers="r7c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r7c1-t50 r1c3-t50"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r8c1-t50" headers="r1c1-t50"> +<p>Allocation size</p> </td> -<td align="left" headers="r7c1-t51 r1c3-t51"> -<p>True</p> +<td align="left" headers="r8c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r8c1-t50 r1c3-t50"> +<p>50</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r8c1-t51" headers="r1c1-t51"> -<p><span class="bold">Validation only</span></p> -</td> -<td align="left" headers="r8c1-t51 r1c2-t51"> -<p>Specify if Dali should validate deployments by initializing descriptors but not connecting to the data source.</p> +<td align="left" id="r9c1-t50" headers="r1c1-t50"> +<p>Initial value</p> </td> -<td align="left" headers="r8c1-t51 r1c3-t51"> -<p>True</p> +<td align="left" headers="r9c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r9c1-t50 r1c3-t50"> +<p>1</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r9c1-t51" headers="r1c1-t51"> -<p><span class="bold">Mapping files schema validation</span></p> -</td> -<td align="left" headers="r9c1-t51 r1c2-t51"><br /></td> -<td align="left" headers="r9c1-t51 r1c3-t51"> -<p>False</p> +<td align="left" id="r10c1-t50" headers="r1c1-t50"> +<p><span class="bold">Table Generators</span></p> </td> +<td align="left" headers="r10c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r10c1-t50 r1c3-t50"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r10c1-t51" headers="r1c1-t51"> -<p><span class="bold">Throw exceptions</span></p> +<td align="left" id="r11c1-t50" headers="r1c1-t50"> +<p>Name</p> </td> -<td align="left" headers="r10c1-t51 r1c2-t51"> -<p>Select this option to set EclipseLink to throw an exception or log a warning when it encounters a problem with any of the files listed in a <span class="bold">persistence.xml</span> file <code><mapping-file></code> element.</p> +<td align="left" headers="r11c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r11c1-t50 r1c3-t50"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r12c1-t50" headers="r1c1-t50"> +<p>Table</p> </td> -<td align="left" headers="r10c1-t51 r1c3-t51"> -<p>True</p> +<td align="left" headers="r12c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r12c1-t50 r1c3-t50"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r13c1-t50" headers="r1c1-t50"> +<p>Schema</p> </td> +<td align="left" headers="r13c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r13c1-t50 r1c3-t50"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r11c1-t51" headers="r1c1-t51"> -<p>Exception handler</p> +<td align="left" id="r14c1-t50" headers="r1c1-t50"> +<p>Catalog</p> </td> -<td align="left" headers="r11c1-t51 r1c2-t51"> -<p>Select (or create) a Java class to handle exceptions.</p> +<td align="left" headers="r14c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r14c1-t50 r1c3-t50"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r15c1-t50" headers="r1c1-t50"> +<p>Primary key column value</p> </td> -<td align="left" headers="r11c1-t51 r1c3-t51"><br /></td> +<td align="left" headers="r15c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r15c1-t50 r1c3-t50"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r12c1-t51" headers="r1c1-t51"> -<p><span class="bold">Session Customizer</span></p> +<td align="left" id="r16c1-t50" headers="r1c1-t50"> +<p>Allocation size</p> </td> -<td align="left" headers="r12c1-t51 r1c2-t51"> -<p>Select a session customizer class: a Java class that implements the <code>eclipselink.tools.sessionconfiguration.SessionCustomizer</code> interface and provides a default (zero-argument) constructor. Use this class' <code>customize</code> method, which takes an <code>eclipselink.sessions.Session</code>, to programmatically access advanced EclipseLink session API.</p> +<td align="left" headers="r16c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r16c1-t50 r1c3-t50"> +<p>50</p> </td> -<td align="left" headers="r12c1-t51 r1c3-t51"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r13c1-t51" headers="r1c1-t51"> -<p>Profiler</p> +<td align="left" id="r17c1-t50" headers="r1c1-t50"> +<p>Initial value</p> </td> -<td align="left" headers="r13c1-t51 r1c2-t51"> -<p>Specify which performance profiler to use in order to capture runtime statistics.</p> -<ul> -<li> -<p>No Profiler – Do not use a performance profiler.</p> -</li> -<li> -<p>Performance Profiler – Use EclipseLink performance profiler (<code>org.eclipse.persistence.tools.profiler.PerformanceProfiler class</code>).</p> -</li> -<li> -<p>Query Monitor – Monitor query executions and cache hits (<code>org.eclipse.persistence.tools.profiler.QueryMonitor class</code>).</p> -</li> -</ul> -</td> -<td align="left" headers="r13c1-t51 r1c3-t51"> -<p>NoProfiler</p> +<td align="left" headers="r17c1-t50 r1c2-t50"><br /></td> +<td align="left" headers="r17c1-t50 r1c3-t50"> +<p>1</p> </td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformal" --> -<div align="center"> -<div class="inftblnote"><br /> -<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> -<tbody> -<tr> -<td align="left"> -<p class="notep1">Note:</p> -<p>This page is not available for projects using the <span class="bold">Generic</span> platform.</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblnote" --></div> <a id="sthref568" name="sthref568"></a> -<p class="subhead2">Related references</p> +<p class="subhead2">Related tasks</p> +<ul> +<li> +<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> +</li> +</ul> +<a id="sthref569" name="sthref569"></a> +<p class="subhead2">Related reference</p> <ul> <li> -<p><span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> -<code><a href="http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm">http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm</a></code></p> +<p><a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference048.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference048.htm index fcfe9669ac..13e66efec4 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference048.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference048.htm @@ -5,155 +5,132 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Caching</title> +<title>Queries</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Caching" /> +<meta name="doctitle" content="Queries" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIABEDCH" name="CIABEDCH"></a><a id="ref_persistence_caching" name="ref_persistence_caching"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIAIBAAJ" name="CIAIBAAJ"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref569" name="sthref569"></a><a id="sthref570" name="sthref570"></a>Caching</h1> -<p>This table lists the properties of the Caching page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> +<h1><a id="sthref570" name="sthref570"></a><a id="sthref571" name="sthref571"></a><a id="sthref572" name="sthref572"></a><a id="sthref573" name="sthref573"></a><a id="sthref574" name="sthref574"></a><a id="sthref575" name="sthref575"></a><a id="sthref576" name="sthref576"></a>Queries</h1> +<p>This table lists the Query information fields available in the <span class="gui-object-title">JPA Details</span> view for the <code>orm.xml</code> file.</p> <div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="This table lists the properties of the Caching page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="24%" /> +<table class="HRuleInformal" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="21%" /> <col width="*" /> -<col width="24%" /> +<col width="23%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t53">Property</th> -<th align="left" valign="bottom" id="r1c2-t53">Description</th> -<th align="left" valign="bottom" id="r1c3-t53">Default</th> +<th align="left" valign="bottom" id="r1c1-t51">Property</th> +<th align="left" valign="bottom" id="r1c2-t51">Description</th> +<th align="left" valign="bottom" id="r1c3-t51">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t53" headers="r1c1-t53"> -<p>Shared cache mode</p> +<td align="left" id="r2c1-t51" headers="r1c1-t51"> +<p><span class="bold">Queries</span></p> </td> -<td align="left" headers="r2c1-t53 r1c2-t53"> -<p>Select one of the following as the shared cache mode:</p> -<ul> -<li> -<p><span class="bold">All</span> – .</p> -</li> -<li> -<p><span class="bold">None</span> –</p> -</li> -<li> -<p><span class="bold">Enable Selective</span> –</p> -</li> -<li> -<p><span class="bold">Disable Selective</span> –</p> -</li> -<li> -<p><span class="bold">Unspecified</span> –</p> -</li> -</ul> -</td> -<td align="left" headers="r2c1-t53 r1c3-t53"> -<p>Disable selective</p> +<td align="left" headers="r2c1-t51 r1c2-t51"> +<p>Displays the existing Named and Native queries.</p> +<p>Click <span class="bold">Add</span> to add a named query, or <span class="bold">Add Native</span> for a native query.</p> +<p>For named queries, enter the query in the Query field.</p> +<p>For native queries, select a result class, then enter the query in the Query field.</p> </td> +<td align="left" headers="r2c1-t51 r1c3-t51"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t53" headers="r1c1-t53"> -<p>Default Cache Type</p> +<td align="left" id="r3c1-t51" headers="r1c1-t51"> +<p><span class="bold">Named Queries</span></p> </td> -<td align="left" headers="r3c1-t53 r1c2-t53"> -<p>Select one of the following as the Default Cache Type:</p> -<ul> -<li> -<p><span class="bold">Weak with Soft Subcache</span>–This option is similar to <span class="bold">Weak with Hard Subcache</span> except that it maintains a most frequently used subcache that uses soft references. The size of the subcache is proportional to the size of the identity map. The subcache uses soft references to ensure that these objects are garbage-collected only if the system is low on memory.</p> -<p>Use this identity map in most circumstances as a means to control memory used by the cache.</p> -</li> -<li> -<p><span class="bold">Weak with Hard Subcache</span>–This option is similar to <span class="bold">Soft with Weak</span> subcache except that it maintains a most frequently used subcache that uses hard references. Use this identity map if soft references are not suitable for your platform.</p> -</li> -<li> -<p><span class="bold">Weak</span>–This option is similar to <span class="bold">Full</span>, except that objects are referenced using weak references. This option uses less memory than <span class="bold">Full</span>, allows complete garbage collection and provides full caching and guaranteed identity.</p> -<p>Use this identity map for transactions that, once started, stay on the server side.</p> -</li> -<li> -<p><span class="bold">Soft</span>–This option is similar to <span class="bold">Weak</span> except that the map holds the objects using soft references. This identity map enables full garbage collection when memory is low. It provides full caching and guaranteed identity.</p> -</li> -<li> -<p><span class="bold">Full</span>–This option provides full caching and guaranteed identity: all objects are cached and not removed.</p> -<p>Note: This process may be memory-intensive when many objects are read.</p> -</li> -<li> -<p><span class="bold">None</span>–This option does not preserve object identity and does not cache objects.This option is not recommended.</p> -</li> -</ul> +<td align="left" headers="r3c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r3c1-t51 r1c3-t51"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t51" headers="r1c1-t51"> +<p>Name</p> </td> -<td align="left" headers="r3c1-t53 r1c3-t53"> -<p>Weak with soft subcache</p> +<td align="left" headers="r4c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r4c1-t51 r1c3-t51"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t51" headers="r1c1-t51"> +<p>Query</p> </td> +<td align="left" headers="r5c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r5c1-t51 r1c3-t51"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t53" headers="r1c1-t53"> -<p>Default Cache Size</p> +<td align="left" id="r6c1-t51" headers="r1c1-t51"> +<p>Lock mode</p> </td> -<td align="left" headers="r4c1-t53 r1c2-t53"> -<p>Set the size (maximum number of objects) of the cache.</p> +<td align="left" headers="r6c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r6c1-t51 r1c3-t51"> +<p>None</p> </td> -<td align="left" headers="r4c1-t53 r1c3-t53"> -<p>100</p> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t51" headers="r1c1-t51"> +<p><span class="bold">Native Queries</span></p> </td> +<td align="left" headers="r7c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r7c1-t51 r1c3-t51"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t53" headers="r1c1-t53"> -<p>Flush clear cache</p> +<td align="left" id="r8c1-t51" headers="r1c1-t51"> +<p>Name</p> </td> -<td align="left" headers="r5c1-t53 r1c2-t53"> -<p>Select one of the following as the Default Cache Type:</p> -<ul> -<li> -<p><span class="bold">Drop</span> – This mode is the fastest and uses the least memory. However, after commit the shared cache might potentially contain stale data.</p> -</li> -<li> -<p><span class="bold">Drop Invalidate</span> – Classes that have at least one object updated or deleted are invalidated in the shared cache at commit time. This mode is slower than <span class="bold">Drop</span>, but as efficient memory usage-wise, and prevents stale data.</p> -</li> -<li> -<p><span class="bold">Merge</span> – Drop classes from the EntityManager's cache of objects that have not been flushed. This mode leaves the shared cache in a perfect state after commit. However, it is the least memory-efficient mode; the memory might even run out in a very large transaction.</p> -</li> -</ul> +<td align="left" headers="r8c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r8c1-t51 r1c3-t51"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r9c1-t51" headers="r1c1-t51"> +<p>Result class</p> </td> -<td align="left" headers="r5c1-t53 r1c3-t53"> -<p>Drop Invalidate</p> +<td align="left" headers="r9c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r9c1-t51 r1c3-t51"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r10c1-t51" headers="r1c1-t51"> +<p>Query</p> </td> +<td align="left" headers="r10c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r10c1-t51 r1c3-t51"><br /></td> </tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblhruleinformal" --> -<div align="center"> -<div class="inftblnote"><br /> -<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> -<tbody> -<tr> -<td align="left"> -<p class="notep1">Note:</p> -<p>This page is not available for projects using the <span class="bold">Generic</span> platform.</p> +<tr align="left" valign="top"> +<td align="left" id="r11c1-t51" headers="r1c1-t51"> +<p><span class="bold">Query Hints</span></p> +</td> +<td align="left" headers="r11c1-t51 r1c2-t51"> +<p>Displays the existing query hints (Name and Value).</p> +<p>Click <span class="bold">Add</span> to add a new query hint.</p> </td> +<td align="left" headers="r11c1-t51 r1c3-t51"><br /></td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblnote" --></div> -<a id="sthref571" name="sthref571"></a> -<p class="subhead2">Related references</p> +<!-- class="inftblhruleinformal" --> +<a id="sthref577" name="sthref577"></a> +<p class="subhead2">Related tasks</p> +<ul> +<li> +<p><a href="tasks010.htm#BABIGBGG">Creating queries</a></p> +</li> +</ul> +<a id="sthref578" name="sthref578"></a> +<p class="subhead2">Related reference</p> <ul> <li> -<p><span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> -<code><a href="http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm">http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm</a></code></p> +<p><a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference049.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference049.htm index 8e3b458438..daa9cf9317 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference049.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference049.htm @@ -5,289 +5,34 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Logging</title> +<title>Converters</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Logging" /> +<meta name="doctitle" content="Converters" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIABGHHI" name="CIABGHHI"></a><a id="ref_persistence_logging" name="ref_persistence_logging"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIADGCID" name="CIADGCID"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref572" name="sthref572"></a>Logging</h1> -<p>This table lists the properties of the Logging page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> -<div align="center"> -<div class="inftblnote"><br /> -<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> -<tbody> -<tr> -<td align="left"> -<p class="notep1">Note:</p> -<p>This page is not available for projects using the <span class="bold">Generic</span> platform.</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblnote" --></div> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="This table lists the properties of the Logging page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="24%" /> -<col width="*" /> -<col width="24%" /> -<thead> -<tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t56">Property</th> -<th align="left" valign="bottom" id="r1c2-t56">Description</th> -<th align="left" valign="bottom" id="r1c3-t56">Default</th> -</tr> -</thead> -<tbody> -<tr align="left" valign="top"> -<td align="left" id="r2c1-t56" headers="r1c1-t56"> -<p>Logging Level</p> -</td> -<td align="left" headers="r2c1-t56 r1c2-t56"> -<p>Specifies the amount and detail of log output by selecting the log level (in ascending order of information):</p> -<p>The following are the valid values for the <code>java.util.logging.Level</code>:</p> -<ul> -<li> -<p><span class="bold">OFF</span>–disables logging</p> -</li> -<li> -<p><span class="bold">SEVERE</span>–logs exceptions indicating TopLink cannot continue, as well as any exceptions generated during login. This includes a stack trace.</p> -</li> -<li> -<p><span class="bold">WARNING</span>–logs exceptions that do not force TopLink to stop, including all exceptions not logged with severe level. This does not include a stack trace.</p> -</li> -<li> -<p><span class="bold">INFO</span>–logs the login/logout per sever session, including the user name. After acquiring the session, detailed information is logged.</p> -</li> -<li> -<p><span class="bold">CONFIG</span>–logs only login, JDBC connection, and database information.</p> -</li> -<li> -<p><span class="bold">FINE</span>–logs SQL.</p> -</li> -<li> -<p><span class="bold">FINER</span>–similar to warning. Includes stack trace.</p> -</li> -<li> -<p><span class="bold">FINEST</span>–includes additional low level information.</p> -</li> -</ul> -<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> -<pre xml:space="preserve" class="oac_no_warn"> -<property name="eclipselink.logging.level" value="INFO"/> -</pre></td> -<td align="left" headers="r2c1-t56 r1c3-t56"> -<p>Info</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t56" headers="r1c1-t56"> -<p>Timestamp<a id="sthref573" name="sthref573"></a></p> -</td> -<td align="left" headers="r3c1-t56 r1c2-t56"> -<p>Control whether the timestamp is logged in each log entry.</p> -<p>The following are the valid values:</p> -<ul> -<li> -<p><span class="bold">True</span>–log a timestamp.</p> -</li> -<li> -<p><span class="bold">False</span>–do not log a timestamp.</p> -</li> -</ul> -<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> -<pre xml:space="preserve" class="oac_no_warn"> -<property name="eclipselink.logging.timestamp" value="false"/> -</pre></td> -<td align="left" headers="r3c1-t56 r1c3-t56"> -<p>True</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t56" headers="r1c1-t56"> -<p>Thread<a id="sthref574" name="sthref574"></a></p> -</td> -<td align="left" headers="r4c1-t56 r1c2-t56"> -<p>Control whether a thread identifier is logged in each log entry.</p> -<p>The following are the valid values:</p> -<ul> -<li> -<p><span class="bold">true</span>–log a thread identifier.</p> -</li> -<li> -<p><span class="bold">false</span>–do not log a thread identifier.</p> -</li> -</ul> -</td> -<td align="left" headers="r4c1-t56 r1c3-t56"> -<p>True</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t56" headers="r1c1-t56"> -<p>Session</p> -</td> -<td align="left" headers="r5c1-t56 r1c2-t56"> -<p>Control whether an EclipseLink session identifier is logged in each log entry.</p> -<p>The following are the valid values:</p> -<ul> -<li> -<p><span class="bold">true</span>–log a EclipseLink session identifier.</p> -</li> -<li> -<p><span class="bold">false</span>–do not log a EclipseLink session identifier.</p> -</li> -</ul> -<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> -<pre xml:space="preserve" class="oac_no_warn"> -<property name="eclipselink.logging.session" value="false"/> -</pre></td> -<td align="left" headers="r5c1-t56 r1c3-t56"> -<p>true</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t56" headers="r1c1-t56"> -<p>Exceptions</p> -</td> -<td align="left" headers="r6c1-t56 r1c2-t56"> -<p>Control whether the exceptions thrown from within the EclipseLink code are logged prior to returning the exception to the calling application. Ensures that all exceptions are logged and not masked by the application code.</p> -<p>The following are the valid values:</p> -<ul> -<li> -<p><span class="bold">true</span>–log all exceptions.</p> -</li> -<li> -<p><span class="bold">false</span>–do not log exceptions.</p> -</li> -</ul> -<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> -<pre xml:space="preserve" class="oac_no_warn"> -<property name="eclipselink.logging.exceptions" value="true"/> -</pre></td> -<td align="left" headers="r6c1-t56 r1c3-t56"> -<p>false</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t56" headers="r1c1-t56"> -<p>Log file</p> -</td> -<td align="left" headers="r7c1-t56 r1c2-t56"> -<p>Specify a file location for the log output (instead of the standard out).</p> -<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> -<pre xml:space="preserve" class="oac_no_warn"> -<property name="eclipselink.logging.file" value="C:\myout\" /> -</pre></td> -<td align="left" headers="r7c1-t56 r1c3-t56"> -<p>stdout</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r8c1-t56" headers="r1c1-t56"> -<p>Logger</p> -</td> -<td align="left" headers="r8c1-t56 r1c2-t56"> -<p>Select the type of logger to use:</p> -<p>The following are the valid values:</p> -<ul> -<li> -<p><span class="bold">DefaultLogger</span>–the EclipseLink native logger <code>eclipselink.logging.DefaultSessionLog</code>.</p> -</li> -<li> -<p><span class="bold">JavaLogger</span>–the <code>java.util.logging</code> logger <code>eclipselink.logging.JavaLog</code>.</p> -</li> -<li> -<p><span class="bold">ServerLogger</span>–the <code>java.util.logging</code> logger <code>eclipselink.platform.server.ServerLog</code>. Integrates with the application server's logging as define in the <code>eclipselink.platform.server.ServerPlatform.</code></p> -</li> -<li> -<p>Fully qualified class name of a custom logger. The custom logger must implement the <code>eclipselink.logging.SessionLog</code> interface.</p> -</li> -</ul> -<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> -<pre xml:space="preserve" class="oac_no_warn"> -<property name="eclipselink.logging.logger" value="acme.loggers.MyCustomLogger" /> -</pre></td> -<td align="left" headers="r8c1-t56 r1c3-t56"> -<p>DefaultLogger</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r9c1-t56" headers="r1c1-t56"> -<p>Logging Categories</p> -</td> -<td align="left" headers="r9c1-t56 r1c2-t56"> -<p>You can also specify the logging level for the following specific categories:</p> -<ul> -<li> -<p>SQL</p> -</li> -<li> -<p>Connection</p> -</li> -<li> -<p>Event</p> -</li> -<li> -<p>Query</p> -</li> -<li> -<p>Cache</p> -</li> -<li> -<p>Propagation</p> -</li> -<li> -<p>EJB</p> -</li> -<li> -<p>DMS</p> -</li> -<li> -<p>EJB or metatdata</p> -</li> -<li> -<p>JPA metadata</p> -</li> -<li> -<p>Weaving</p> -</li> -<li> -<p>Properties</p> -</li> -<li> -<p>Server</p> -</li> -</ul> -</td> -<td align="left" headers="r9c1-t56 r1c3-t56"> -<p>Info</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblhruleinformal" --> -<a id="sthref575" name="sthref575"></a> -<p class="subhead2">Related references</p> +<h1>Converters</h1> +<p><a id="sthref579" name="sthref579"></a>The Converters information in the JPA Details view applies only when using EclipseLink.</p> +<p>Click <span class="bold">Add</span> to create a new converter, using the <a href="ref_add_converter.htm#CIAGCGIJ">Add Converter dialog</a>.</p> +<a id="sthref580" name="sthref580"></a> +<p class="subhead2">Related reference</p> <ul> <li> -<p><span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> -<code><a href="http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm">http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm</a></code></p> +<p><a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a></p> </li> </ul> </div> <!-- class="sect3" --> +<!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference050.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference050.htm index 6e090447f2..a709798652 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference050.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference050.htm @@ -5,212 +5,233 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Options</title> +<title>Connection</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Options" /> +<meta name="doctitle" content="Connection" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> +<meta name="topic-id" content="ref_persistence_connection" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIAFJCHE" name="CIAFJCHE"></a><a id="ref_persistence_options" name="ref_persistence_options"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIAFFJIE" name="CIAFFJIE"></a><a id="ref_persistence_connection" name="ref_persistence_connection"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref576" name="sthref576"></a>Options</h1> -<p>This table lists the properties of the Options page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> -<div align="center"> -<div class="inftblnote"><br /> -<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> -<tbody> -<tr> -<td align="left"> -<p class="notep1">Note:</p> -<p>This page is not available for projects using the <span class="bold">Generic</span> platform.</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblnote" --></div> +<h1>Connection</h1> +<p><a id="sthref590" name="sthref590"></a>The following table lists the properties available in the Connection page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> <div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="This table lists the properties of the Options page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="24%" /> +<table class="HRuleInformal" summary="The following table lists the properties available in the Connection page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="25%" /> <col width="*" /> <col width="24%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t58">Property</th> -<th align="left" valign="bottom" id="r1c2-t58">Description</th> -<th align="left" valign="bottom" id="r1c3-t58">Default</th> +<th align="left" valign="bottom" id="r1c1-t53">Property</th> +<th align="left" valign="bottom" id="r1c2-t53">Description</th> +<th align="left" valign="bottom" id="r1c3-t53">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t58" headers="r1c1-t58"> -<p><span class="bold">Session Options</span></p> +<td align="left" id="r2c1-t53" headers="r1c1-t53"> +<p>Transaction type<a id="sthref591" name="sthref591"></a></p> +</td> +<td align="left" headers="r2c1-t53 r1c2-t53"> +<p>Specify if the connection for this persistence unit uses one of the following transaction types:</p> +<ul> +<li> +<p><span class="bold">Default</span> -- Select to use the container used by the container.</p> +</li> +<li> +<p><span class="bold">JTA</span> (Java Transaction API) -- Transactions of the Java EE server.</p> +</li> +<li> +<p><span class="bold">Resource Local</span> -- Native actions of a JDBC driver that are referenced by a persistence unit.</p> +</li> +</ul> +</td> +<td align="left" headers="r2c1-t53 r1c3-t53"> +<p>JTA</p> </td> -<td align="left" headers="r2c1-t58 r1c2-t58"><br /></td> -<td align="left" headers="r2c1-t58 r1c3-t58"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t58" headers="r1c1-t58"> -<p>Session Name</p> -</td> -<td align="left" headers="r3c1-t58 r1c2-t58"> -<p>Specify the name by which the EclipseLink session is stored in the static session manager. Use this option if you need to access the EclipseLink shared session outside of the context of the JPA or to use a pre-existing EclipseLink session configured through a EclipseLink <code>sessions.xml</code> file</p> -<p>Valid values: a valid EclipseLink session name that is unique in a server deployment.</p> -<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> -<pre xml:space="preserve" class="oac_no_warn"> -<property name="eclipselink.session-name" value="MySession"/> -</pre></td> -<td align="left" headers="r3c1-t58 r1c3-t58"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t58" headers="r1c1-t58"> -<p>Sessions XML</p> -</td> -<td align="left" headers="r4c1-t58 r1c2-t58"> -<p>Specify persistence information loaded from the EclipseLink session configuration file (<code>sessions.xml</code>).</p> -<p>You can use this option as an alternative to annotations and deployment XML. If you specify this property, EclipseLink will override all class annotation and the object relational mapping from the <code>persistence.xml</code>, as well as <code>ORM.xml</code> and other mapping files, if present.</p> -<p>Indicate the session by setting the <code>eclipselink.session-name</code> property.</p> -<p>Note: If you do not specify the value for this property, <code>sessions.xml</code> file will not be used.</p> -<p>Valid values: the resource name of the sessions XML file.</p> -<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> -<pre xml:space="preserve" class="oac_no_warn"> -<property name="toplink.session-xml" value="mysession.xml"/> -</pre></td> -<td align="left" headers="r4c1-t58 r1c3-t58"><br /></td> +<td align="left" id="r3c1-t53" headers="r1c1-t53"> +<p>Batch writing<a id="sthref592" name="sthref592"></a></p> +</td> +<td align="left" headers="r3c1-t53 r1c2-t53"> +<p>Specify the use of batch writing to optimize transactions with multiple write operations.</p> +<p>Set the value of this property into the session at deployment time.</p> +<p><span class="bold">Note</span>: This property applies when used both in a Java SE and Java EE environment.</p> +<p>The following are the valid values for oracle.toplink.config.BatchWriting:</p> +<ul> +<li> +<p><span class="bold">JDBC</span>–Use JDBC batch writing.</p> +</li> +<li> +<p><span class="bold">Buffered</span>–Do not use either JDBC batch writing nor native platform batch writing.</p> +</li> +<li> +<p><span class="bold">OracleJDBC</span>–Use both JDBC batch writing and Oracle native platform batch writing.</p> +</li> +<li> +<p><span class="bold">None</span>–Do not use batch writing (turn it off).</p> +</li> +</ul> +</td> +<td align="left" headers="r3c1-t53 r1c3-t53"> +<p>None</p> +</td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t58" headers="r1c1-t58"> -<p>Target Database</p> +<td align="left" id="r4c1-t53" headers="r1c1-t53"> +<p>Statement caching</p> </td> -<td align="left" headers="r5c1-t58 r1c2-t58"> -<p>Select the target database. You can also set the value to the fully qualified class name of a subclass of the <code>org.eclipse.persistence.platform.DatabasePlatform class</code>.</p> -<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> -<pre xml:space="preserve" class="oac_no_warn"> -<property name="eclipselink.target-database" value="Oracle"/> -</pre></td> -<td align="left" headers="r5c1-t58 r1c3-t58"> -<p>Auto</p> +<td align="left" headers="r4c1-t53 r1c2-t53"> +<p>Specify if the query caches its JDBC statement. If enabled, you can also set the number of statements to cache.</p> +</td> +<td align="left" headers="r4c1-t53 r1c3-t53"> +<p>50</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t58" headers="r1c1-t58"> -<p>Target Server</p> -</td> -<td align="left" headers="r6c1-t58 r1c2-t58"> -<p>Select the target server for your JPA application.</p> -<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> -<pre xml:space="preserve" class="oac_no_warn"> -<property name="eclipselink.target-server" value="OC4J_10_1_3"/> -</pre></td> -<td align="left" headers="r6c1-t58 r1c3-t58"> -<p>None</p> +<td align="left" id="r5c1-t53" headers="r1c1-t53"> +<p>Native SQL</p> +</td> +<td align="left" headers="r5c1-t53 r1c2-t53"> +<p>Specify if Dali includes platform-specific (that is, "native") SQL statements. If false, Dali uses generic SLQ.</p> +</td> +<td align="left" headers="r5c1-t53 r1c3-t53"> +<p>False</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r7c1-t58" headers="r1c1-t58"> -<p>Event Listener</p> -</td> -<td align="left" headers="r7c1-t58 r1c2-t58"> -<p>Specify a descriptor event listener to be added during bootstrapping.</p> -<p>Valid values: qualified class name for a class that implements the <code>eclipselink.sessions.SessionEventListener</code> interface.</p> -<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> -<pre xml:space="preserve" class="oac_no_warn"> -<property name="eclipselink.session-event-listener" value="mypackage.MyClass.class"/> -</pre></td> -<td align="left" headers="r7c1-t58 r1c3-t58"><br /></td> +<td align="left" id="r6c1-t53" headers="r1c1-t53"> +<p><span class="bold">Database</span></p> +</td> +<td align="left" headers="r6c1-t53 r1c2-t53"><br /></td> +<td align="left" headers="r6c1-t53 r1c3-t53"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r8c1-t58" headers="r1c1-t58"> -<p>Include Descriptor Queries</p> +<td align="left" id="r7c1-t53" headers="r1c1-t53"> +<p>JTA Data Source Name</p> </td> -<td align="left" headers="r8c1-t58 r1c2-t58"> -<p>Enable or disable the default copying of all named queries from the descriptors to the session. These queries include the ones defined using EclipseLink API, descriptor amendment methods, and so on.</p> -</td> -<td align="left" headers="r8c1-t58 r1c3-t58"> -<p>True</p> +<td align="left" headers="r7c1-t53 r1c2-t53"> +<p>If you selected <span class="bold">JTA</span> as the transaction type, then enter the name of the default JTA data source for the persistence unit.</p> </td> +<td align="left" headers="r7c1-t53 r1c3-t53"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r9c1-t58" headers="r1c1-t58"> -<p><span class="bold">Miscellaneous Options</span></p> +<td align="left" id="r8c1-t53" headers="r1c1-t53"> +<p>Non-JTA Data Source Name</p> </td> -<td align="left" headers="r9c1-t58 r1c2-t58"><br /></td> -<td align="left" headers="r9c1-t58 r1c3-t58"><br /></td> +<td align="left" headers="r8c1-t53 r1c2-t53"> +<p>If you selected <span class="bold">Resource Local</span> as the transaction type, then enter the name of the non-JTA data source.</p> +<p>This property is not available for projects using the <span class="bold">Generic</span> platform.</p> +</td> +<td align="left" headers="r8c1-t53 r1c3-t53"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r10c1-t58" headers="r1c1-t58"> -<p>Temporal mutable</p> -</td> -<td align="left" headers="r10c1-t58 r1c2-t58"> -<p>Specify if all <code>Date</code> and <code>Calendar</code> persistent fields should be handled as mutable objects.</p> -<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> -<pre xml:space="preserve" class="oac_no_warn"> -<property name="eclipselink.temporal.mutable" value="true"/> -</pre></td> -<td align="left" headers="r10c1-t58 r1c3-t58"> -<p>False</p> +<td align="left" id="r9c1-t53" headers="r1c1-t53"> +<p><span class="bold">EclipseLink connection pool</span></p> </td> +<td align="left" headers="r9c1-t53 r1c2-t53"> +<p>Define the connection pool driver, URL, user name and password.</p> +<p>These properties are note available for projects using the Generic platform.</p> +</td> +<td align="left" headers="r9c1-t53 r1c3-t53"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r11c1-t58" headers="r1c1-t58"> -<p>Lock timeout</p> +<td align="left" id="r10c1-t53" headers="r1c1-t53"> +<p>Bind parameters</p> +</td> +<td align="left" headers="r10c1-t53 r1c2-t53"> +<p>Control whether or not the query uses parameter binding.</p> +<p>Note: This property applies when used in a Java SE environment.</p> +<p>This property is not available for projects using the Generic platform.</p> </td> -<td align="left" headers="r11c1-t58 r1c2-t58"><br /></td> -<td align="left" headers="r11c1-t58 r1c3-t58"> -<p>5</p> +<td align="left" headers="r10c1-t53 r1c3-t53"> +<p>True</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r12c1-t58" headers="r1c1-t58"> -<p>Query timeout</p> +<td align="left" id="r11c1-t53" headers="r1c1-t53"> +<p>Read Connection</p> +</td> +<td align="left" headers="r11c1-t53 r1c2-t53"> +<p>The maximum and minimum number of connections allowed in the JDBC read connection pool.</p> +<p><span class="bold">Note</span>: These property apply when used in a Java SE environment.</p> +<p>These properties are not available for projects using the Generic platform</p> </td> -<td align="left" headers="r12c1-t58 r1c2-t58"><br /></td> -<td align="left" headers="r12c1-t58 r1c3-t58"> -<p>5</p> +<td align="left" headers="r11c1-t53 r1c3-t53"> +<p>Minimum: 2</p> +<p>Maximum 2</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r13c1-t58" headers="r1c1-t58"> -<p>Validation mode</p> +<td align="left" id="r12c1-t53" headers="r1c1-t53"> +<p>Write Connection</p> </td> -<td align="left" headers="r13c1-t58 r1c2-t58"><br /></td> -<td align="left" headers="r13c1-t58 r1c3-t58"> -<p>Auto</p> +<td align="left" headers="r12c1-t53 r1c2-t53"> +<p>The maximum and minimum number of connections allowed in the JDBC read connection pool.</p> +<p><span class="bold">Note</span>: These property apply when used in a Java SE environment.</p> +<p>These properties are not available for projects using the Generic platform</p> +</td> +<td align="left" headers="r12c1-t53 r1c3-t53"> +<p>Minimum: 5</p> +<p>Maximum 10</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r14c1-t58" headers="r1c1-t58"> -<p>Validate pre-persist group</p> +<td align="left" id="r13c1-t53" headers="r1c1-t53"> +<p><span class="bold">Exclusive connections</span></p> +</td> +<td align="left" headers="r13c1-t53 r1c2-t53"> +<p>These fields are available only when <span class="bold">Transaction Type</span> is <span class="bold">Local Resource</span>.</p> </td> -<td align="left" headers="r14c1-t58 r1c2-t58"><br /></td> -<td align="left" headers="r14c1-t58 r1c3-t58"><br /></td> +<td align="left" headers="r13c1-t53 r1c3-t53"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r15c1-t58" headers="r1c1-t58"> -<p>Validate pre-update group</p> +<td align="left" id="r14c1-t53" headers="r1c1-t53"> +<p>Exclusive connection mode</p> +</td> +<td align="left" headers="r14c1-t53 r1c2-t53"> +<p>Specify when Dali performs reads through the write connection.</p> +<ul> +<li> +<p>Always – Create an exclusive isolated client session if reading an isolated entity, otherwise create an exclusive client session.</p> +</li> +<li> +<p>Isolated – Create an exclusive isolated client session if reading an isolated entity, otherwise raise an error.</p> +</li> +<li> +<p>Transactional – Create an isolated client session if some or all entities require isolated cache, otherwise create a client session.</p> +</li> +</ul> +</td> +<td align="left" headers="r14c1-t53 r1c3-t53"> +<p>Transactional</p> </td> -<td align="left" headers="r15c1-t58 r1c2-t58"><br /></td> -<td align="left" headers="r15c1-t58 r1c3-t58"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r16c1-t58" headers="r1c1-t58"> -<p>Validate pre-remove group</p> +<td align="left" id="r15c1-t53" headers="r1c1-t53"> +<p>Lazy connection acquisition</p> +</td> +<td align="left" headers="r15c1-t53 r1c2-t53"> +<p>Specify if Dali acquires write connections lazily.</p> +</td> +<td align="left" headers="r15c1-t53 r1c3-t53"> +<p>True</p> </td> -<td align="left" headers="r16c1-t58 r1c2-t58"><br /></td> -<td align="left" headers="r16c1-t58 r1c3-t58"><br /></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref577" name="sthref577"></a> +<a id="sthref593" name="sthref593"></a> <p class="subhead2">Related references</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference051.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference051.htm index f8fef136ce..056e92bf97 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference051.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference051.htm @@ -5,128 +5,214 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Schema Generation</title> +<title>Customization</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Schema Generation" /> +<meta name="doctitle" content="Customization" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> +<meta name="topic-id" content="ref_persistence_customization" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIACCFCB" name="CIACCFCB"></a><a id="ref_persistence_schema_generation" name="ref_persistence_schema_generation"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIAJAFEG" name="CIAJAFEG"></a><a id="ref_persistence_customization" name="ref_persistence_customization"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref578" name="sthref578"></a>Schema Generation</h1> -<p>This table lists the properties of the Schema Generation page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> -<div align="center"> -<div class="inftblnote"><br /> -<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> -<tbody> -<tr> -<td align="left"> -<p class="notep1">Note:</p> -<p>This page is not available for projects using the <span class="bold">Generic</span> platform.</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblnote" --></div> +<h1>Customization</h1> +<p><a id="sthref594" name="sthref594"></a>The following table lists the properties available in the Customization page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> <div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="This table lists the properties of the Schema Generation page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<table class="HRuleInformal" summary="The following table lists the properties available in the Customization page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> <col width="24%" /> <col width="*" /> <col width="24%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t60">Property</th> -<th align="left" valign="bottom" id="r1c2-t60">Description</th> -<th align="left" valign="bottom" id="r1c3-t60">Default</th> +<th align="left" valign="bottom" id="r1c1-t54">Property</th> +<th align="left" valign="bottom" id="r1c2-t54">Description</th> +<th align="left" valign="bottom" id="r1c3-t54">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t60" headers="r1c1-t60"> -<p>DDL Generation Type</p> +<td align="left" id="r2c1-t54" headers="r1c1-t54"> +<p><span class="bold">Weaving</span></p> </td> -<td align="left" headers="r2c1-t60 r1c2-t60"> -<p>Select the type of DDL generation:</p> +<td align="left" headers="r2c1-t54 r1c2-t54"> +<p>Specifies if weaving of the entity classes is performed. The EclipseLink JPA persistence provider uses weaving to enhance JPA entities for such properties as lazy loading, change tracking, fetch groups, and internal optimizations. Select from the following options:</p> <ul> <li> -<p><span class="bold">None</span> -- Do not generate DDL; no schema is generated.</p> +<p><span class="bold">No Weaving</span></p> </li> <li> -<p><span class="bold">Create Tables</span> -- Create DDL for non-existent tables; leave existing tables unchanged.</p> +<p><span class="bold">Weave Dynamically</span></p> </li> <li> -<p><span class="bold">Drop and Create Tables</span> -- Create DDL for all tables; drop all existing tables.</p> +<p><span class="bold">Weave Statically</span> -- Use this option if you plan to execute your application outside of a Java EE 5 container in an environment that does not permit the use of <code>-javaagent:eclipselink.jar</code> on the JVM command line. This assumes that classes have already been statically woven. Run the static weaver on the classes before deploying them.</p> </li> </ul> </td> -<td align="left" headers="r2c1-t60 r1c3-t60"> -<p>None</p> +<td align="left" headers="r2c1-t54 r1c3-t54"> +<p>Weave Dynamically</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t54" headers="r1c1-t54"> +<p>Lazy</p> +</td> +<td align="left" headers="r3c1-t54 r1c2-t54"> +<p>Select this option to enable lazy weaving.</p> +</td> +<td align="left" headers="r3c1-t54 r1c3-t54"> +<p>True</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t60" headers="r1c1-t60"> -<p>Output Mode</p> +<td align="left" id="r4c1-t54" headers="r1c1-t54"> +<p>Fetch Groups</p> </td> -<td align="left" headers="r3c1-t60 r1c2-t60"> -<p>Select the DDL generation target:</p> +<td align="left" headers="r4c1-t54 r1c2-t54"> +<p>Select this option to enable fetch groups through weaving. Set this option to false if:</p> <ul> <li> -<p><span class="bold">Both</span> -- Generate SQL files and execute them on the database.</p> -</li> -<li> -<p><span class="bold">Database</span> -- Execute SQL on the database only (do not generate SQL files).</p> +<p>There is no weaving.</p> </li> <li> -<p><span class="bold">SQL Script</span> -- Generate SQL files only (do not execute them on the database).</p> +<p>Classes should not be changed during weaving (for example, when debugging).</p> </li> </ul> +<p>Set this property to false for platforms where it is not supported.</p> +</td> +<td align="left" headers="r4c1-t54 r1c3-t54"> +<p>True</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t54" headers="r1c1-t54"> +<p>Internal</p> +</td> +<td align="left" headers="r5c1-t54 r1c2-t54"> +<p>Specify if Dali uses internal optimizations through weaving.</p> +<p>If enabled, enables lazy one-to-one and many-to-one mappings through weaving.</p> +</td> +<td align="left" headers="r5c1-t54 r1c3-t54"> +<p>True</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t54" headers="r1c1-t54"> +<p>Eager</p> +</td> +<td align="left" headers="r6c1-t54 r1c2-t54"> +<p>Specify if Dali uses indirection on eager relationships.</p> +</td> +<td align="left" headers="r6c1-t54 r1c3-t54"> +<p>False</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t54" headers="r1c1-t54"> +<p>Change Tracking</p> +</td> +<td align="left" headers="r7c1-t54 r1c2-t54"> +<p>Select this option to use weaving to detect which fields or properties of the object change.</p> +</td> +<td align="left" headers="r7c1-t54 r1c3-t54"> +<p>True</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r8c1-t54" headers="r1c1-t54"> +<p><span class="bold">Validation only</span></p> +</td> +<td align="left" headers="r8c1-t54 r1c2-t54"> +<p>Specify if Dali should validate deployments by initializing descriptors but not connecting to the data source.</p> +</td> +<td align="left" headers="r8c1-t54 r1c3-t54"> +<p>True</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r9c1-t54" headers="r1c1-t54"> +<p><span class="bold">Mapping files schema validation</span></p> +</td> +<td align="left" headers="r9c1-t54 r1c2-t54"><br /></td> +<td align="left" headers="r9c1-t54 r1c3-t54"> +<p>False</p> </td> -<td align="left" headers="r3c1-t60 r1c3-t60"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t60" headers="r1c1-t60"> -<p>DDL Generation Location</p> +<td align="left" id="r10c1-t54" headers="r1c1-t54"> +<p><span class="bold">Throw exceptions</span></p> +</td> +<td align="left" headers="r10c1-t54 r1c2-t54"> +<p>Select this option to set EclipseLink to throw an exception or log a warning when it encounters a problem with any of the files listed in a <span class="bold">persistence.xml</span> file <code><mapping-file></code> element.</p> </td> -<td align="left" headers="r4c1-t60 r1c2-t60"> -<p>Specify where EclipseLink writes DDL output. Specify a file specification to a directory in which you have write access. The file specification may be relative to your current working directory or absolute. If it does not end in a file separator, then EclipseLink appends one that is valid for your operating system.</p> +<td align="left" headers="r10c1-t54 r1c3-t54"> +<p>True</p> </td> -<td align="left" headers="r4c1-t60 r1c3-t60"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t60" headers="r1c1-t60"> -<p>Create DDL File Name</p> +<td align="left" id="r11c1-t54" headers="r1c1-t54"> +<p>Exception handler</p> +</td> +<td align="left" headers="r11c1-t54 r1c2-t54"> +<p>Select (or create) a Java class to handle exceptions.</p> </td> -<td align="left" headers="r5c1-t60 r1c2-t60"> -<p>Specify the file name of the DDL file that EclipseLink generates that contains SQL statements for creating tables for JPA entities. Specify a file name valid for your operating system.</p> +<td align="left" headers="r11c1-t54 r1c3-t54"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r12c1-t54" headers="r1c1-t54"> +<p><span class="bold">Session Customizer</span></p> </td> -<td align="left" headers="r5c1-t60 r1c3-t60"> -<p><code>createDDL.jdbc</code></p> +<td align="left" headers="r12c1-t54 r1c2-t54"> +<p>Select a session customizer class: a Java class that implements the <code>eclipselink.tools.sessionconfiguration.SessionCustomizer</code> interface and provides a default (zero-argument) constructor. Use this class' <code>customize</code> method, which takes an <code>eclipselink.sessions.Session</code>, to programmatically access advanced EclipseLink session API.</p> </td> +<td align="left" headers="r12c1-t54 r1c3-t54"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t60" headers="r1c1-t60"> -<p>Drop DDL File Name</p> +<td align="left" id="r13c1-t54" headers="r1c1-t54"> +<p>Profiler</p> </td> -<td align="left" headers="r6c1-t60 r1c2-t60"> -<p>Specify the file name of the DDL file that EclipseLink generates that contains SQL statements for dropping tables for JPA entities.</p> +<td align="left" headers="r13c1-t54 r1c2-t54"> +<p>Specify which performance profiler to use in order to capture runtime statistics.</p> +<ul> +<li> +<p>No Profiler – Do not use a performance profiler.</p> +</li> +<li> +<p>Performance Profiler – Use EclipseLink performance profiler (<code>org.eclipse.persistence.tools.profiler.PerformanceProfiler class</code>).</p> +</li> +<li> +<p>Query Monitor – Monitor query executions and cache hits (<code>org.eclipse.persistence.tools.profiler.QueryMonitor class</code>).</p> +</li> +</ul> </td> -<td align="left" headers="r6c1-t60 r1c3-t60"> -<p><code>dropDDL.jdbc</code></p> +<td align="left" headers="r13c1-t54 r1c3-t54"> +<p>NoProfiler</p> </td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref579" name="sthref579"></a> +<div align="center"> +<div class="inftblnote"><br /> +<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> +<tbody> +<tr> +<td align="left"> +<p class="notep1">Note:</p> +<p>This page is not available for projects using the <span class="bold">Generic</span> platform.</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblnote" --></div> +<a id="sthref595" name="sthref595"></a> <p class="subhead2">Related references</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference052.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference052.htm index 1220da1f28..a8ec678dfc 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference052.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference052.htm @@ -5,25 +5,150 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Properties</title> +<title>Caching</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Properties" /> +<meta name="doctitle" content="Caching" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIAHJDFF" name="CIAHJDFF"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIABEDCH" name="CIABEDCH"></a><a id="ref_persistence_caching" name="ref_persistence_caching"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref580" name="sthref580"></a><a id="sthref581" name="sthref581"></a><a id="sthref582" name="sthref582"></a>Properties</h1> -<p>This page enables you to add or remove the vendor-specific <code><properties></code> elements of <code>persistence.xml</code>.</p> -<p>To add a property, click <span class="bold">Add</span> then enter the property <span class="bold">Name</span> and <span class="bold">Value</span>.</p> -<a id="sthref583" name="sthref583"></a> +<h1><a id="sthref596" name="sthref596"></a><a id="sthref597" name="sthref597"></a>Caching</h1> +<p>This table lists the properties of the Caching page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" summary="This table lists the properties of the Caching page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="24%" /> +<col width="*" /> +<col width="24%" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t56">Property</th> +<th align="left" valign="bottom" id="r1c2-t56">Description</th> +<th align="left" valign="bottom" id="r1c3-t56">Default</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t56" headers="r1c1-t56"> +<p>Shared cache mode</p> +</td> +<td align="left" headers="r2c1-t56 r1c2-t56"> +<p>Select one of the following as the shared cache mode:</p> +<ul> +<li> +<p><span class="bold">All</span> – .</p> +</li> +<li> +<p><span class="bold">None</span> –</p> +</li> +<li> +<p><span class="bold">Enable Selective</span> –</p> +</li> +<li> +<p><span class="bold">Disable Selective</span> –</p> +</li> +<li> +<p><span class="bold">Unspecified</span> –</p> +</li> +</ul> +</td> +<td align="left" headers="r2c1-t56 r1c3-t56"> +<p>Disable selective</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t56" headers="r1c1-t56"> +<p>Default Cache Type</p> +</td> +<td align="left" headers="r3c1-t56 r1c2-t56"> +<p>Select one of the following as the Default Cache Type:</p> +<ul> +<li> +<p><span class="bold">Weak with Soft Subcache</span>–This option is similar to <span class="bold">Weak with Hard Subcache</span> except that it maintains a most frequently used subcache that uses soft references. The size of the subcache is proportional to the size of the identity map. The subcache uses soft references to ensure that these objects are garbage-collected only if the system is low on memory.</p> +<p>Use this identity map in most circumstances as a means to control memory used by the cache.</p> +</li> +<li> +<p><span class="bold">Weak with Hard Subcache</span>–This option is similar to <span class="bold">Soft with Weak</span> subcache except that it maintains a most frequently used subcache that uses hard references. Use this identity map if soft references are not suitable for your platform.</p> +</li> +<li> +<p><span class="bold">Weak</span>–This option is similar to <span class="bold">Full</span>, except that objects are referenced using weak references. This option uses less memory than <span class="bold">Full</span>, allows complete garbage collection and provides full caching and guaranteed identity.</p> +<p>Use this identity map for transactions that, once started, stay on the server side.</p> +</li> +<li> +<p><span class="bold">Soft</span>–This option is similar to <span class="bold">Weak</span> except that the map holds the objects using soft references. This identity map enables full garbage collection when memory is low. It provides full caching and guaranteed identity.</p> +</li> +<li> +<p><span class="bold">Full</span>–This option provides full caching and guaranteed identity: all objects are cached and not removed.</p> +<p>Note: This process may be memory-intensive when many objects are read.</p> +</li> +<li> +<p><span class="bold">None</span>–This option does not preserve object identity and does not cache objects.This option is not recommended.</p> +</li> +</ul> +</td> +<td align="left" headers="r3c1-t56 r1c3-t56"> +<p>Weak with soft subcache</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t56" headers="r1c1-t56"> +<p>Default Cache Size</p> +</td> +<td align="left" headers="r4c1-t56 r1c2-t56"> +<p>Set the size (maximum number of objects) of the cache.</p> +</td> +<td align="left" headers="r4c1-t56 r1c3-t56"> +<p>100</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t56" headers="r1c1-t56"> +<p>Flush clear cache</p> +</td> +<td align="left" headers="r5c1-t56 r1c2-t56"> +<p>Select one of the following as the Default Cache Type:</p> +<ul> +<li> +<p><span class="bold">Drop</span> – This mode is the fastest and uses the least memory. However, after commit the shared cache might potentially contain stale data.</p> +</li> +<li> +<p><span class="bold">Drop Invalidate</span> – Classes that have at least one object updated or deleted are invalidated in the shared cache at commit time. This mode is slower than <span class="bold">Drop</span>, but as efficient memory usage-wise, and prevents stale data.</p> +</li> +<li> +<p><span class="bold">Merge</span> – Drop classes from the EntityManager's cache of objects that have not been flushed. This mode leaves the shared cache in a perfect state after commit. However, it is the least memory-efficient mode; the memory might even run out in a very large transaction.</p> +</li> +</ul> +</td> +<td align="left" headers="r5c1-t56 r1c3-t56"> +<p>Drop Invalidate</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<div align="center"> +<div class="inftblnote"><br /> +<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> +<tbody> +<tr> +<td align="left"> +<p class="notep1">Note:</p> +<p>This page is not available for projects using the <span class="bold">Generic</span> platform.</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblnote" --></div> +<a id="sthref598" name="sthref598"></a> <p class="subhead2">Related references</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference053.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference053.htm index d70da846fa..3563aa4f1a 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference053.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference053.htm @@ -5,35 +5,289 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Source</title> +<title>Logging</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Source" /> +<meta name="doctitle" content="Logging" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIAHCJAH" name="CIAHCJAH"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIABGHHI" name="CIABGHHI"></a><a id="ref_persistence_logging" name="ref_persistence_logging"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref584" name="sthref584"></a>Source</h1> -<p>Using this page, you can manually edit the <code>persistence.xml</code> file.</p> -<p>See <a href="task_manage_persistence.htm#CIHDAJID">"Managing the persistence.xml file"</a> for additional information.</p> -<a id="sthref585" name="sthref585"></a> -<p class="subhead2">Related tasks</p> +<h1><a id="sthref599" name="sthref599"></a>Logging</h1> +<p>This table lists the properties of the Logging page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> +<div align="center"> +<div class="inftblnote"><br /> +<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> +<tbody> +<tr> +<td align="left"> +<p class="notep1">Note:</p> +<p>This page is not available for projects using the <span class="bold">Generic</span> platform.</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblnote" --></div> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" summary="This table lists the properties of the Logging page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="24%" /> +<col width="*" /> +<col width="24%" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t59">Property</th> +<th align="left" valign="bottom" id="r1c2-t59">Description</th> +<th align="left" valign="bottom" id="r1c3-t59">Default</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t59" headers="r1c1-t59"> +<p>Logging Level</p> +</td> +<td align="left" headers="r2c1-t59 r1c2-t59"> +<p>Specifies the amount and detail of log output by selecting the log level (in ascending order of information):</p> +<p>The following are the valid values for the <code>java.util.logging.Level</code>:</p> +<ul> +<li> +<p><span class="bold">OFF</span>–disables logging</p> +</li> +<li> +<p><span class="bold">SEVERE</span>–logs exceptions indicating TopLink cannot continue, as well as any exceptions generated during login. This includes a stack trace.</p> +</li> +<li> +<p><span class="bold">WARNING</span>–logs exceptions that do not force TopLink to stop, including all exceptions not logged with severe level. This does not include a stack trace.</p> +</li> +<li> +<p><span class="bold">INFO</span>–logs the login/logout per sever session, including the user name. After acquiring the session, detailed information is logged.</p> +</li> +<li> +<p><span class="bold">CONFIG</span>–logs only login, JDBC connection, and database information.</p> +</li> +<li> +<p><span class="bold">FINE</span>–logs SQL.</p> +</li> +<li> +<p><span class="bold">FINER</span>–similar to warning. Includes stack trace.</p> +</li> +<li> +<p><span class="bold">FINEST</span>–includes additional low level information.</p> +</li> +</ul> +<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> +<pre xml:space="preserve" class="oac_no_warn"> +<property name="eclipselink.logging.level" value="INFO"/> +</pre></td> +<td align="left" headers="r2c1-t59 r1c3-t59"> +<p>Info</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t59" headers="r1c1-t59"> +<p>Timestamp<a id="sthref600" name="sthref600"></a></p> +</td> +<td align="left" headers="r3c1-t59 r1c2-t59"> +<p>Control whether the timestamp is logged in each log entry.</p> +<p>The following are the valid values:</p> +<ul> +<li> +<p><span class="bold">True</span>–log a timestamp.</p> +</li> +<li> +<p><span class="bold">False</span>–do not log a timestamp.</p> +</li> +</ul> +<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> +<pre xml:space="preserve" class="oac_no_warn"> +<property name="eclipselink.logging.timestamp" value="false"/> +</pre></td> +<td align="left" headers="r3c1-t59 r1c3-t59"> +<p>True</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t59" headers="r1c1-t59"> +<p>Thread<a id="sthref601" name="sthref601"></a></p> +</td> +<td align="left" headers="r4c1-t59 r1c2-t59"> +<p>Control whether a thread identifier is logged in each log entry.</p> +<p>The following are the valid values:</p> +<ul> +<li> +<p><span class="bold">true</span>–log a thread identifier.</p> +</li> +<li> +<p><span class="bold">false</span>–do not log a thread identifier.</p> +</li> +</ul> +</td> +<td align="left" headers="r4c1-t59 r1c3-t59"> +<p>True</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t59" headers="r1c1-t59"> +<p>Session</p> +</td> +<td align="left" headers="r5c1-t59 r1c2-t59"> +<p>Control whether an EclipseLink session identifier is logged in each log entry.</p> +<p>The following are the valid values:</p> +<ul> +<li> +<p><span class="bold">true</span>–log a EclipseLink session identifier.</p> +</li> +<li> +<p><span class="bold">false</span>–do not log a EclipseLink session identifier.</p> +</li> +</ul> +<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> +<pre xml:space="preserve" class="oac_no_warn"> +<property name="eclipselink.logging.session" value="false"/> +</pre></td> +<td align="left" headers="r5c1-t59 r1c3-t59"> +<p>true</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t59" headers="r1c1-t59"> +<p>Exceptions</p> +</td> +<td align="left" headers="r6c1-t59 r1c2-t59"> +<p>Control whether the exceptions thrown from within the EclipseLink code are logged prior to returning the exception to the calling application. Ensures that all exceptions are logged and not masked by the application code.</p> +<p>The following are the valid values:</p> +<ul> +<li> +<p><span class="bold">true</span>–log all exceptions.</p> +</li> +<li> +<p><span class="bold">false</span>–do not log exceptions.</p> +</li> +</ul> +<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> +<pre xml:space="preserve" class="oac_no_warn"> +<property name="eclipselink.logging.exceptions" value="true"/> +</pre></td> +<td align="left" headers="r6c1-t59 r1c3-t59"> +<p>false</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t59" headers="r1c1-t59"> +<p>Log file</p> +</td> +<td align="left" headers="r7c1-t59 r1c2-t59"> +<p>Specify a file location for the log output (instead of the standard out).</p> +<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> +<pre xml:space="preserve" class="oac_no_warn"> +<property name="eclipselink.logging.file" value="C:\myout\" /> +</pre></td> +<td align="left" headers="r7c1-t59 r1c3-t59"> +<p>stdout</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r8c1-t59" headers="r1c1-t59"> +<p>Logger</p> +</td> +<td align="left" headers="r8c1-t59 r1c2-t59"> +<p>Select the type of logger to use:</p> +<p>The following are the valid values:</p> +<ul> +<li> +<p><span class="bold">DefaultLogger</span>–the EclipseLink native logger <code>eclipselink.logging.DefaultSessionLog</code>.</p> +</li> +<li> +<p><span class="bold">JavaLogger</span>–the <code>java.util.logging</code> logger <code>eclipselink.logging.JavaLog</code>.</p> +</li> +<li> +<p><span class="bold">ServerLogger</span>–the <code>java.util.logging</code> logger <code>eclipselink.platform.server.ServerLog</code>. Integrates with the application server's logging as define in the <code>eclipselink.platform.server.ServerPlatform.</code></p> +</li> +<li> +<p>Fully qualified class name of a custom logger. The custom logger must implement the <code>eclipselink.logging.SessionLog</code> interface.</p> +</li> +</ul> +<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> +<pre xml:space="preserve" class="oac_no_warn"> +<property name="eclipselink.logging.logger" value="acme.loggers.MyCustomLogger" /> +</pre></td> +<td align="left" headers="r8c1-t59 r1c3-t59"> +<p>DefaultLogger</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r9c1-t59" headers="r1c1-t59"> +<p>Logging Categories</p> +</td> +<td align="left" headers="r9c1-t59 r1c2-t59"> +<p>You can also specify the logging level for the following specific categories:</p> +<ul> +<li> +<p>SQL</p> +</li> +<li> +<p>Connection</p> +</li> +<li> +<p>Event</p> +</li> +<li> +<p>Query</p> +</li> +<li> +<p>Cache</p> +</li> +<li> +<p>Propagation</p> +</li> +<li> +<p>EJB</p> +</li> +<li> +<p>DMS</p> +</li> +<li> +<p>EJB or metatdata</p> +</li> +<li> +<p>JPA metadata</p> +</li> +<li> +<p>Weaving</p> +</li> +<li> +<p>Properties</p> +</li> +<li> +<p>Server</p> +</li> +</ul> +</td> +<td align="left" headers="r9c1-t59 r1c3-t59"> +<p>Info</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<a id="sthref602" name="sthref602"></a> +<p class="subhead2">Related references</p> <ul> <li> -<p><a href="task_manage_persistence.htm#CIHDAJID">Managing the persistence.xml file</a></p> +<p><span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> +<code><a href="http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm">http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm</a></code></p> </li> </ul> </div> <!-- class="sect3" --> -<!-- class="sect2" --> -<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference054.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference054.htm index 28646b134b..f22be7dbc8 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference054.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference054.htm @@ -5,46 +5,221 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Preferences</title> +<title>Options</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Preferences" /> +<meta name="doctitle" content="Options" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACDEIEE" name="CACDEIEE"></a></p> -<div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1>Preferences</h1> -<p><a id="sthref586" name="sthref586"></a>This section includes information on the following preference pages:</p> -<ul> -<li> -<p><a href="reference055.htm#CACBFACC">Java Persistence Preferences page – JPA</a></p> -</li> -<li> -<p><a href="reference056.htm#CACFGIDG">Java Persistence Preferences page – Errors/Warnings</a></p> -</li> -</ul> -<p>This section also includes information on the following project property pages:</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIAFJCHE" name="CIAFJCHE"></a><a id="ref_persistence_options" name="ref_persistence_options"></a></p> +<div class="sect3"><!-- infolevel="all" infotype="General" --> +<h1><a id="sthref603" name="sthref603"></a>Options</h1> +<p>This table lists the properties of the Options page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> +<div align="center"> +<div class="inftblnote"><br /> +<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> +<tbody> +<tr> +<td align="left"> +<p class="notep1">Note:</p> +<p>This page is not available for projects using the <span class="bold">Generic</span> platform.</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblnote" --></div> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" summary="This table lists the properties of the Options page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="24%" /> +<col width="*" /> +<col width="24%" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t61">Property</th> +<th align="left" valign="bottom" id="r1c2-t61">Description</th> +<th align="left" valign="bottom" id="r1c3-t61">Default</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t61" headers="r1c1-t61"> +<p><span class="bold">Session Options</span></p> +</td> +<td align="left" headers="r2c1-t61 r1c2-t61"><br /></td> +<td align="left" headers="r2c1-t61 r1c3-t61"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t61" headers="r1c1-t61"> +<p>Session Name</p> +</td> +<td align="left" headers="r3c1-t61 r1c2-t61"> +<p>Specify the name by which the EclipseLink session is stored in the static session manager. Use this option if you need to access the EclipseLink shared session outside of the context of the JPA or to use a pre-existing EclipseLink session configured through a EclipseLink <code>sessions.xml</code> file</p> +<p>Valid values: a valid EclipseLink session name that is unique in a server deployment.</p> +<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> +<pre xml:space="preserve" class="oac_no_warn"> +<property name="eclipselink.session-name" value="MySession"/> +</pre></td> +<td align="left" headers="r3c1-t61 r1c3-t61"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t61" headers="r1c1-t61"> +<p>Sessions XML</p> +</td> +<td align="left" headers="r4c1-t61 r1c2-t61"> +<p>Specify persistence information loaded from the EclipseLink session configuration file (<code>sessions.xml</code>).</p> +<p>You can use this option as an alternative to annotations and deployment XML. If you specify this property, EclipseLink will override all class annotation and the object relational mapping from the <code>persistence.xml</code>, as well as <code>ORM.xml</code> and other mapping files, if present.</p> +<p>Indicate the session by setting the <code>eclipselink.session-name</code> property.</p> +<p>Note: If you do not specify the value for this property, <code>sessions.xml</code> file will not be used.</p> +<p>Valid values: the resource name of the sessions XML file.</p> +<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> +<pre xml:space="preserve" class="oac_no_warn"> +<property name="toplink.session-xml" value="mysession.xml"/> +</pre></td> +<td align="left" headers="r4c1-t61 r1c3-t61"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t61" headers="r1c1-t61"> +<p>Target Database</p> +</td> +<td align="left" headers="r5c1-t61 r1c2-t61"> +<p>Select the target database. You can also set the value to the fully qualified class name of a subclass of the <code>org.eclipse.persistence.platform.DatabasePlatform class</code>.</p> +<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> +<pre xml:space="preserve" class="oac_no_warn"> +<property name="eclipselink.target-database" value="Oracle"/> +</pre></td> +<td align="left" headers="r5c1-t61 r1c3-t61"> +<p>Auto</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t61" headers="r1c1-t61"> +<p>Target Server</p> +</td> +<td align="left" headers="r6c1-t61 r1c2-t61"> +<p>Select the target server for your JPA application.</p> +<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> +<pre xml:space="preserve" class="oac_no_warn"> +<property name="eclipselink.target-server" value="OC4J_10_1_3"/> +</pre></td> +<td align="left" headers="r6c1-t61 r1c3-t61"> +<p>None</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t61" headers="r1c1-t61"> +<p>Event Listener</p> +</td> +<td align="left" headers="r7c1-t61 r1c2-t61"> +<p>Specify a descriptor event listener to be added during bootstrapping.</p> +<p>Valid values: qualified class name for a class that implements the <code>eclipselink.sessions.SessionEventListener</code> interface.</p> +<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> +<pre xml:space="preserve" class="oac_no_warn"> +<property name="eclipselink.session-event-listener" value="mypackage.MyClass.class"/> +</pre></td> +<td align="left" headers="r7c1-t61 r1c3-t61"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r8c1-t61" headers="r1c1-t61"> +<p>Include Descriptor Queries</p> +</td> +<td align="left" headers="r8c1-t61 r1c2-t61"> +<p>Enable or disable the default copying of all named queries from the descriptors to the session. These queries include the ones defined using EclipseLink API, descriptor amendment methods, and so on.</p> +</td> +<td align="left" headers="r8c1-t61 r1c3-t61"> +<p>True</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r9c1-t61" headers="r1c1-t61"> +<p><span class="bold">Miscellaneous Options</span></p> +</td> +<td align="left" headers="r9c1-t61 r1c2-t61"><br /></td> +<td align="left" headers="r9c1-t61 r1c3-t61"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r10c1-t61" headers="r1c1-t61"> +<p>Temporal mutable</p> +</td> +<td align="left" headers="r10c1-t61 r1c2-t61"> +<p>Specify if all <code>Date</code> and <code>Calendar</code> persistent fields should be handled as mutable objects.</p> +<p><span class="bold">Example</span>: <code>persistence.xml</code> file</p> +<pre xml:space="preserve" class="oac_no_warn"> +<property name="eclipselink.temporal.mutable" value="true"/> +</pre></td> +<td align="left" headers="r10c1-t61 r1c3-t61"> +<p>False</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r11c1-t61" headers="r1c1-t61"> +<p>Lock timeout</p> +</td> +<td align="left" headers="r11c1-t61 r1c2-t61"><br /></td> +<td align="left" headers="r11c1-t61 r1c3-t61"> +<p>5</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r12c1-t61" headers="r1c1-t61"> +<p>Query timeout</p> +</td> +<td align="left" headers="r12c1-t61 r1c2-t61"><br /></td> +<td align="left" headers="r12c1-t61 r1c3-t61"> +<p>5</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r13c1-t61" headers="r1c1-t61"> +<p>Validation mode</p> +</td> +<td align="left" headers="r13c1-t61 r1c2-t61"><br /></td> +<td align="left" headers="r13c1-t61 r1c3-t61"> +<p>Auto</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r14c1-t61" headers="r1c1-t61"> +<p>Validate pre-persist group</p> +</td> +<td align="left" headers="r14c1-t61 r1c2-t61"><br /></td> +<td align="left" headers="r14c1-t61 r1c3-t61"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r15c1-t61" headers="r1c1-t61"> +<p>Validate pre-update group</p> +</td> +<td align="left" headers="r15c1-t61 r1c2-t61"><br /></td> +<td align="left" headers="r15c1-t61 r1c3-t61"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r16c1-t61" headers="r1c1-t61"> +<p>Validate pre-remove group</p> +</td> +<td align="left" headers="r16c1-t61 r1c2-t61"><br /></td> +<td align="left" headers="r16c1-t61 r1c3-t61"><br /></td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<a id="sthref604" name="sthref604"></a> +<p class="subhead2">Related references</p> <ul> <li> -<p><a href="ref_project_properties.htm#BABJHBCI">Project Properties page – JPA Options</a></p> -</li> -<li> -<p><a href="reference057.htm#CACFJJGG">Project Properties page – EclipseLink</a></p> -</li> -<li> -<p><a href="reference058.htm#CACDCIGD">Project Properties Page – Entity Generation</a></p> -</li> -<li> -<p><a href="reference059.htm#CACEEJJB">Project Properties page – Errors/Warnings</a></p> +<p><span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> +<code><a href="http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm">http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm</a></code></p> </li> </ul> +</div> +<!-- class="sect3" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> @@ -56,6 +231,6 @@ </tr> </table> </div> -<!-- class="footer" --></div> +<!-- class="footer" --> </body> </html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference055.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference055.htm index 6784ed62e8..3c527c5a05 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference055.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference055.htm @@ -5,88 +5,137 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Java Persistence Preferences page – JPA</title> +<title>Schema Generation</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Java Persistence Preferences page – JPA" /> +<meta name="doctitle" content="Schema Generation" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACBFACC" name="CACBFACC"></a></p> -<div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Java Persistence Preferences page – JPA<a id="sthref587" name="sthref587"></a></h1> -<div class="inftblinformal"> -<table class="Informal" title="Options on the Java Persistence Preferences page > JPA" summary="Options on the Java Persistence Preferences page > JPA" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> -<col width="32%" /> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIACCFCB" name="CIACCFCB"></a><a id="ref_persistence_schema_generation" name="ref_persistence_schema_generation"></a></p> +<div class="sect3"><!-- infolevel="all" infotype="General" --> +<h1><a id="sthref605" name="sthref605"></a>Schema Generation</h1> +<p>This table lists the properties of the Schema Generation page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> +<div align="center"> +<div class="inftblnote"><br /> +<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> +<tbody> +<tr> +<td align="left"> +<p class="notep1">Note:</p> +<p>This page is not available for projects using the <span class="bold">Generic</span> platform.</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblnote" --></div> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" summary="This table lists the properties of the Schema Generation page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="24%" /> <col width="*" /> +<col width="24%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t61">Property</th> -<th align="left" valign="bottom" id="r1c2-t61">Description</th> +<th align="left" valign="bottom" id="r1c1-t63">Property</th> +<th align="left" valign="bottom" id="r1c2-t63">Description</th> +<th align="left" valign="bottom" id="r1c3-t63">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t61" headers="r1c1-t61"> -<p><span class="bold">Entity generation from tables</span></p> +<td align="left" id="r2c1-t63" headers="r1c1-t63"> +<p>DDL Generation Type</p> </td> -<td align="left" headers="r2c1-t61 r1c2-t61"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t61" headers="r1c1-t61"> -<p>Default package</p> +<td align="left" headers="r2c1-t63 r1c2-t63"> +<p>Select the type of DDL generation:</p> +<ul> +<li> +<p><span class="bold">None</span> -- Do not generate DDL; no schema is generated.</p> +</li> +<li> +<p><span class="bold">Create Tables</span> -- Create DDL for non-existent tables; leave existing tables unchanged.</p> +</li> +<li> +<p><span class="bold">Drop and Create Tables</span> -- Create DDL for all tables; drop all existing tables.</p> +</li> +</ul> </td> -<td align="left" headers="r3c1-t61 r1c2-t61"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t61" headers="r1c1-t61"> -<p><span class="bold">JPQL Editing</span></p> +<td align="left" headers="r2c1-t63 r1c3-t63"> +<p>None</p> </td> -<td align="left" headers="r4c1-t61 r1c2-t61"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t61" headers="r1c1-t61"> -<p>Specify the case ...</p> +<td align="left" id="r3c1-t63" headers="r1c1-t63"> +<p>Output Mode</p> </td> -<td align="left" headers="r5c1-t61 r1c2-t61"> +<td align="left" headers="r3c1-t63 r1c2-t63"> +<p>Select the DDL generation target:</p> <ul> <li> -<p>Lowercase</p> +<p><span class="bold">Both</span> -- Generate SQL files and execute them on the database.</p> </li> <li> -<p>Uppercase</p> +<p><span class="bold">Database</span> -- Execute SQL on the database only (do not generate SQL files).</p> +</li> +<li> +<p><span class="bold">SQL Script</span> -- Generate SQL files only (do not execute them on the database).</p> </li> </ul> </td> +<td align="left" headers="r3c1-t63 r1c3-t63"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r6c1-t61" headers="r1c1-t61"> -<p>Match case of first character</p> +<td align="left" id="r4c1-t63" headers="r1c1-t63"> +<p>DDL Generation Location</p> +</td> +<td align="left" headers="r4c1-t63 r1c2-t63"> +<p>Specify where EclipseLink writes DDL output. Specify a file specification to a directory in which you have write access. The file specification may be relative to your current working directory or absolute. If it does not end in a file separator, then EclipseLink appends one that is valid for your operating system.</p> +</td> +<td align="left" headers="r4c1-t63 r1c3-t63"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t63" headers="r1c1-t63"> +<p>Create DDL File Name</p> +</td> +<td align="left" headers="r5c1-t63 r1c2-t63"> +<p>Specify the file name of the DDL file that EclipseLink generates that contains SQL statements for creating tables for JPA entities. Specify a file name valid for your operating system.</p> +</td> +<td align="left" headers="r5c1-t63 r1c3-t63"> +<p><code>createDDL.jdbc</code></p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t63" headers="r1c1-t63"> +<p>Drop DDL File Name</p> +</td> +<td align="left" headers="r6c1-t63 r1c2-t63"> +<p>Specify the file name of the DDL file that EclipseLink generates that contains SQL statements for dropping tables for JPA entities.</p> +</td> +<td align="left" headers="r6c1-t63 r1c3-t63"> +<p><code>dropDDL.jdbc</code></p> </td> -<td align="left" headers="r6c1-t61 r1c2-t61"><br /></td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblinformal" --> -<a id="sthref588" name="sthref588"></a> -<p class="subhead2">Related tasks</p> +<!-- class="inftblhruleinformal" --> +<a id="sthref606" name="sthref606"></a> +<p class="subhead2">Related references</p> <ul> <li> -<p><a href="tasks021.htm#BABBAGFI">Generating entities from tables</a></p> -</li> -<li> -<p><a href="tasks023.htm#CIHHFGIG">Generating dynamic entities from tables</a></p> +<p><span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> +<code><a href="http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm">http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm</a></code></p> </li> </ul> </div> -<!-- class="sect2" --> +<!-- class="sect3" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference056.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference056.htm index 4715332679..076427df13 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference056.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference056.htm @@ -5,94 +5,34 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Java Persistence Preferences page – Errors/Warnings</title> +<title>Properties</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Java Persistence Preferences page – Errors/Warnings" /> +<meta name="doctitle" content="Properties" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACFGIDG" name="CACFGIDG"></a></p> -<div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Java Persistence Preferences page – Errors/Warnings<a id="sthref589" name="sthref589"></a></h1> -<div class="inftblinformal"> -<table class="Informal" title="Options on the Java Persistence Preferences page > Errors/Warnings" summary="Options on the Java Persistence Preferences page > Errors/Warnings" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> -<col width="32%" /> -<col width="*" /> -<thead> -<tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t62">Property</th> -<th align="left" valign="bottom" id="r1c2-t62">Description</th> -</tr> -</thead> -<tbody> -<tr align="left" valign="top"> -<td align="left" id="r2c1-t62" headers="r1c1-t62"> -<p><span class="bold">Enable project specific settings</span></p> -</td> -<td align="left" headers="r2c1-t62 r1c2-t62"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t62" headers="r1c1-t62"> -<p>Project</p> -</td> -<td align="left" headers="r3c1-t62 r1c2-t62"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t62" headers="r1c1-t62"> -<p>Persistence unit</p> -</td> -<td align="left" headers="r4c1-t62 r1c2-t62"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t62" headers="r1c1-t62"> -<p>Type</p> -</td> -<td align="left" headers="r5c1-t62 r1c2-t62"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t62" headers="r1c1-t62"> -<p>Attribute</p> -</td> -<td align="left" headers="r6c1-t62 r1c2-t62"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t62" headers="r1c1-t62"> -<p>DAtabase</p> -</td> -<td align="left" headers="r7c1-t62 r1c2-t62"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r8c1-t62" headers="r1c1-t62"> -<p>Inheritance</p> -</td> -<td align="left" headers="r8c1-t62 r1c2-t62"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r9c1-t62" headers="r1c1-t62"> -<p>Queries and generators</p> -</td> -<td align="left" headers="r9c1-t62 r1c2-t62"><br /></td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblinformal" --> -<a id="sthref590" name="sthref590"></a> -<p class="subhead2">Related tasks</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIAHJDFF" name="CIAHJDFF"></a></p> +<div class="sect3"><!-- infolevel="all" infotype="General" --> +<h1><a id="sthref607" name="sthref607"></a><a id="sthref608" name="sthref608"></a><a id="sthref609" name="sthref609"></a>Properties</h1> +<p>This page enables you to add or remove the vendor-specific <code><properties></code> elements of <code>persistence.xml</code>.</p> +<p>To add a property, click <span class="bold">Add</span> then enter the property <span class="bold">Name</span> and <span class="bold">Value</span>.</p> +<a id="sthref610" name="sthref610"></a> +<p class="subhead2">Related references</p> <ul> <li> -<p><a href="tasks024.htm#BABFAIBA">Validating mappings and reporting problems</a></p> +<p><span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> +<code><a href="http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm">http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm</a></code></p> </li> </ul> </div> -<!-- class="sect2" --> +<!-- class="sect3" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference057.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference057.htm index 7997d2425f..7ee324436d 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference057.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference057.htm @@ -5,95 +5,35 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Project Properties page – EclipseLink</title> +<title>Source</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Project Properties page – EclipseLink" /> +<meta name="doctitle" content="Source" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACFJJGG" name="CACFJJGG"></a></p> -<div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Project Properties page – EclipseLink <a id="sthref604" name="sthref604"></a><a id="sthref605" name="sthref605"></a></h1> -<p>Use the <span class="gui-object-title">EclipseLink</span> options on the <span class="gui-object-title">Properties</span> page to select the EclipseLink-specific options to use with the project.</p> -<p>This table lists the properties available in the <span class="gui-object-title">EclipseLink page</span>.</p> -<div class="inftblinformal"> -<table class="Informal" title="Options on the Project Properties page > EclipseLink" summary="Options on the Project Properties page > EclipseLink" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> -<col width="32%" /> -<col width="*" /> -<thead> -<tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t64">Property</th> -<th align="left" valign="bottom" id="r1c2-t64">Description</th> -</tr> -</thead> -<tbody> -<tr align="left" valign="top"> -<td align="left" id="r2c1-t64" headers="r1c1-t64"> -<p><span class="bold">Static weaving</span></p> -</td> -<td align="left" headers="r2c1-t64 r1c2-t64"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t64" headers="r1c1-t64"> -<p>Weave classes on build</p> -</td> -<td align="left" headers="r3c1-t64 r1c2-t64"> -<p>If enabled, Dali will weave all applicable class files at build time so that you can deliver pre-woven class files.</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t64" headers="r1c1-t64"> -<p>Source classes</p> -</td> -<td align="left" headers="r4c1-t64 r1c2-t64"> -<p>Specifies the location of the Java source files to weave: either a directory or a JAR file.</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t64" headers="r1c1-t64"> -<p>Target classes</p> -</td> -<td align="left" headers="r5c1-t64 r1c2-t64"> -<p>Specifies the output location: either a directory or a JAR file.</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t64" headers="r1c1-t64"> -<p>Log level</p> -</td> -<td align="left" headers="r6c1-t64 r1c2-t64"> -<p>Specifies the amount and detail of log output. See <a href="reference049.htm#CIABGHHI">"Logging"</a> for information on the different logging levels.</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t64" headers="r1c1-t64"> -<p>Persistence XML root</p> -</td> -<td align="left" headers="r7c1-t64 r1c2-t64"> -<p>Specifies the location of the persistence.xml file if it is not in the same location as the source.</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblinformal" --> -<a id="sthref606" name="sthref606"></a> -<p class="subhead2">Related References</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIAHCJAH" name="CIAHCJAH"></a></p> +<div class="sect3"><!-- infolevel="all" infotype="General" --> +<h1><a id="sthref611" name="sthref611"></a>Source</h1> +<p>Using this page, you can manually edit the <code>persistence.xml</code> file.</p> +<p>See <a href="task_manage_persistence.htm#CIHDAJID">"Managing the persistence.xml file"</a> for additional information.</p> +<a id="sthref612" name="sthref612"></a> +<p class="subhead2">Related tasks</p> <ul> <li> -<p><span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span> <br /> -<code><a href="http://www.eclipse.org/eclipselink/documentation/">http://www.eclipse.org/eclipselink/documentation/</a></code></p> +<p><a href="task_manage_persistence.htm#CIHDAJID">Managing the persistence.xml file</a></p> </li> </ul> </div> +<!-- class="sect3" --> <!-- class="sect2" --> +<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference058.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference058.htm index b91b0000aa..f52fff887a 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference058.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference058.htm @@ -5,65 +5,49 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Project Properties Page – Entity Generation</title> +<title>Preferences</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Project Properties Page – Entity Generation" /> +<meta name="doctitle" content="Preferences" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACDCIGD" name="CACDCIGD"></a></p> -<div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Project Properties Page – Entity Generation <a id="sthref607" name="sthref607"></a><a id="sthref608" name="sthref608"></a></h1> -<p>Use the <span class="gui-object-title">Entity Generation</span> options on the <span class="gui-object-title">Properties</span> page to configure the defaults Dali uses when generating entities</p> -<p>This table lists the properties available in the <span class="gui-object-title">Entity Generation page</span>.</p> -<div class="inftblinformal"> -<table class="Informal" title="Options on the Project Properties page > Entity Generation" summary="Options on the Project Properties page > Entity Generation" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> -<col width="32%" /> -<col width="*" /> -<thead> -<tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t65">Property</th> -<th align="left" valign="bottom" id="r1c2-t65">Description</th> -</tr> -</thead> -<tbody> -<tr align="left" valign="top"> -<td align="left" id="r2c1-t65" headers="r1c1-t65"> -<p><span class="bold">Entity generation from tables</span></p> -</td> -<td align="left" headers="r2c1-t65 r1c2-t65"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t65" headers="r1c1-t65"> -<p>Default package</p> -</td> -<td align="left" headers="r3c1-t65 r1c2-t65"> -<p>Specify the default package name used for generated entities.</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblinformal" --> -<a id="sthref609" name="sthref609"></a> -<p class="subhead2">Related tasks</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACDEIEE" name="CACDEIEE"></a></p> +<div class="sect1"><!-- infolevel="all" infotype="General" --> +<h1>Preferences</h1> +<p><a id="sthref613" name="sthref613"></a>This section includes information on the following preference pages:</p> <ul> <li> -<p><a href="tasks021.htm#BABBAGFI">Generating entities from tables</a></p> +<p><a href="reference059.htm#CACBFACC">Java Persistence Preferences page – JPA</a></p> </li> <li> -<p><a href="tasks023.htm#CIHHFGIG">Generating dynamic entities from tables</a></p> +<p><a href="reference060.htm#CACFGIDG">Java Persistence Preferences page – Errors/Warnings</a></p> +</li> +</ul> +<p>This section also includes information on the following project property pages:</p> +<ul> +<li> +<p><a href="ref_project_properties.htm#BABJHBCI">Project Properties page – JPA Options</a></p> +</li> +<li> +<p><a href="reference061.htm#CACFJJGG">Project Properties page – EclipseLink</a></p> +</li> +<li> +<p><a href="reference062.htm#CACDCIGD">Project Properties page – Entity Generation</a></p> +</li> +<li> +<p><a href="reference063.htm#CACEEJJB">Project Properties page – Errors/Warnings</a></p> +</li> +<li> +<p><a href="reference064.htm#CACFAAIB">Project Properties page – JAXB Options</a></p> </li> </ul> -</div> -<!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> @@ -75,6 +59,6 @@ </tr> </table> </div> -<!-- class="footer" --> +<!-- class="footer" --></div> </body> </html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference059.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference059.htm index 38c9313f16..7b372dfe4d 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference059.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference059.htm @@ -5,81 +5,88 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Project Properties page – Errors/Warnings</title> +<title>Java Persistence Preferences page – JPA</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Project Properties page – Errors/Warnings" /> +<meta name="doctitle" content="Java Persistence Preferences page – JPA" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACEEJJB" name="CACEEJJB"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACBFACC" name="CACBFACC"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Project Properties page – Errors/Warnings <a id="sthref610" name="sthref610"></a></h1> -<p>Use the <span class="gui-object-title">Errors/Warnings</span> options on the <span class="gui-object-title">Properties</span> page to specify if Dali should report errors and warnings for the project.</p> -<p>This table lists the properties available in the <span class="gui-object-title">Errors/Warnings page</span>.</p> +<h1>Java Persistence Preferences page – JPA<a id="sthref614" name="sthref614"></a></h1> <div class="inftblinformal"> -<table class="Informal" title="Options on the Project Properties page > Errors/Warnings" summary="Options on the Project Properties page > Errors/Warnings" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> +<table class="Informal" title="Options on the Java Persistence Preferences page > JPA" summary="Options on the Java Persistence Preferences page > JPA" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <col width="32%" /> <col width="*" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t66">Property</th> -<th align="left" valign="bottom" id="r1c2-t66">Description</th> +<th align="left" valign="bottom" id="r1c1-t64">Property</th> +<th align="left" valign="bottom" id="r1c2-t64">Description</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t66" headers="r1c1-t66"> -<p><span class="bold">Enable project specific settings</span></p> +<td align="left" id="r2c1-t64" headers="r1c1-t64"> +<p><span class="bold">Entity generation from tables</span></p> </td> -<td align="left" headers="r2c1-t66 r1c2-t66"> -<p>Specify if Dali reports errors and warning for the following features:</p> +<td align="left" headers="r2c1-t64 r1c2-t64"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t64" headers="r1c1-t64"> +<p>Default package</p> +</td> +<td align="left" headers="r3c1-t64 r1c2-t64"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t64" headers="r1c1-t64"> +<p><span class="bold">JPQL Editing</span></p> +</td> +<td align="left" headers="r4c1-t64 r1c2-t64"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t64" headers="r1c1-t64"> +<p>Specify the case ...</p> +</td> +<td align="left" headers="r5c1-t64 r1c2-t64"> <ul> <li> -<p>Project</p> -</li> -<li> -<p>Persistence unit</p> -</li> -<li> -<p>TYpe</p> -</li> -<li> -<p>Attribute</p> -</li> -<li> -<p>Database</p> -</li> -<li> -<p>Inheritance</p> +<p>Lowercase</p> </li> <li> -<p>Queries and generators</p> +<p>Uppercase</p> </li> </ul> -<p>You can expand each category to display the possible error and warning messages.</p> </td> </tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t64" headers="r1c1-t64"> +<p>Match case of first character</p> +</td> +<td align="left" headers="r6c1-t64 r1c2-t64"><br /></td> +</tr> </tbody> </table> <br /></div> <!-- class="inftblinformal" --> -<a id="sthref611" name="sthref611"></a> +<a id="sthref615" name="sthref615"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="tasks024.htm#BABFAIBA">Validating mappings and reporting problems</a></p> +<p><a href="tasks022.htm#BABBAGFI">Generating entities from tables</a></p> +</li> +<li> +<p><a href="tasks024.htm#CIHHFGIG">Generating dynamic entities from tables</a></p> </li> </ul> </div> <!-- class="sect2" --> -<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference060.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference060.htm index 18a578da49..5b80ebb471 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference060.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference060.htm @@ -5,46 +5,94 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Dialogs</title> +<title>Java Persistence Preferences page – Errors/Warnings</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Dialogs" /> +<meta name="doctitle" content="Java Persistence Preferences page – Errors/Warnings" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACGEJDA" name="CACGEJDA"></a></p> -<div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1>Dialogs</h1> -<p>This section includes information on the following dialogs:</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACFGIDG" name="CACFGIDG"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Java Persistence Preferences page – Errors/Warnings<a id="sthref616" name="sthref616"></a></h1> +<div class="inftblinformal"> +<table class="Informal" title="Options on the Java Persistence Preferences page > Errors/Warnings" summary="Options on the Java Persistence Preferences page > Errors/Warnings" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> +<col width="32%" /> +<col width="*" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t65">Property</th> +<th align="left" valign="bottom" id="r1c2-t65">Description</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t65" headers="r1c1-t65"> +<p><span class="bold">Enable project specific settings</span></p> +</td> +<td align="left" headers="r2c1-t65 r1c2-t65"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t65" headers="r1c1-t65"> +<p>Project</p> +</td> +<td align="left" headers="r3c1-t65 r1c2-t65"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t65" headers="r1c1-t65"> +<p>Persistence unit</p> +</td> +<td align="left" headers="r4c1-t65 r1c2-t65"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t65" headers="r1c1-t65"> +<p>Type</p> +</td> +<td align="left" headers="r5c1-t65 r1c2-t65"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t65" headers="r1c1-t65"> +<p>Attribute</p> +</td> +<td align="left" headers="r6c1-t65 r1c2-t65"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t65" headers="r1c1-t65"> +<p>DAtabase</p> +</td> +<td align="left" headers="r7c1-t65 r1c2-t65"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r8c1-t65" headers="r1c1-t65"> +<p>Inheritance</p> +</td> +<td align="left" headers="r8c1-t65 r1c2-t65"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r9c1-t65" headers="r1c1-t65"> +<p>Queries and generators</p> +</td> +<td align="left" headers="r9c1-t65 r1c2-t65"><br /></td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblinformal" --> +<a id="sthref617" name="sthref617"></a> +<p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="reference061.htm#CACCGEHC">Edit Join Columns Dialog</a></p> -</li> -<li> -<p><a href="ref_select_cascade_dialog.htm#CIAFDGIJ">Select Cascade dialog</a></p> -</li> -<li> -<p><a href="ref_eclipselink_mapping_file.htm#CIAEDEJF">New EclipseLink Mapping File dialog</a></p> -</li> -<li> -<p><a href="ref_add_converter.htm#CIAGCGIJ">Add Converter dialog</a></p> -</li> -<li> -<p><a href="reference063.htm#CACFEGAG">Mapping Type Selection dialog</a></p> -</li> -<li> -<p><a href="reference064.htm#CACJBCGG">JPA Metadata Conversion dialog</a></p> -</li> -<li> -<p><a href="reference065.htm#CACIBDFB">Make Persistent dialog</a></p> +<p><a href="tasks025.htm#BABFAIBA">Validating mappings and reporting problems</a></p> </li> </ul> +</div> +<!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> @@ -56,6 +104,6 @@ </tr> </table> </div> -<!-- class="footer" --></div> +<!-- class="footer" --> </body> </html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference061.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference061.htm index c140226c13..e3d7b5256c 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference061.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference061.htm @@ -5,26 +5,26 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Edit Join Columns Dialog</title> +<title>Project Properties page – EclipseLink</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Edit Join Columns Dialog" /> +<meta name="doctitle" content="Project Properties page – EclipseLink" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACCGEHC" name="CACCGEHC"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACFJJGG" name="CACFJJGG"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Edit Join Columns Dialog</h1> -<p><a id="sthref612" name="sthref612"></a>Use the <span class="gui-object-title">Join Columns</span> dialog to create or modify the join tables and columns in relationship mappings.</p> -<p>This table lists the properties available in the <span class="gui-object-title">Join Columns</span> dialog.</p> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" title="This table describes the options on the Join Columns dialog." summary="This table describes the options on the Join Columns dialog." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<h1>Project Properties page – EclipseLink <a id="sthref631" name="sthref631"></a><a id="sthref632" name="sthref632"></a></h1> +<p>Use the <span class="gui-object-title">EclipseLink</span> options on the <span class="gui-object-title">Properties</span> page to select the EclipseLink-specific options to use with the project.</p> +<p>This table lists the properties available in the <span class="gui-object-title">EclipseLink page</span>.</p> +<div class="inftblinformal"> +<table class="Informal" title="Options on the Project Properties page > EclipseLink" summary="Options on the Project Properties page > EclipseLink" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <col width="32%" /> <col width="*" /> <thead> @@ -36,29 +36,60 @@ <tbody> <tr align="left" valign="top"> <td align="left" id="r2c1-t67" headers="r1c1-t67"> -<p>Name</p> -</td> -<td align="left" headers="r2c1-t67 r1c2-t67"> -<p>Name of the joint table column that contains the foreign key column.</p> +<p><span class="bold">Static weaving</span></p> </td> +<td align="left" headers="r2c1-t67 r1c2-t67"><br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t67" headers="r1c1-t67"> -<p>Referenced Column Name</p> +<p>Weave classes on build</p> </td> <td align="left" headers="r3c1-t67 r1c2-t67"> -<p>Name of the database column that contains the foreign key reference for the entity relationship.</p> +<p>If enabled, Dali will weave all applicable class files at build time so that you can deliver pre-woven class files.</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t67" headers="r1c1-t67"> +<p>Source classes</p> +</td> +<td align="left" headers="r4c1-t67 r1c2-t67"> +<p>Specifies the location of the Java source files to weave: either a directory or a JAR file.</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t67" headers="r1c1-t67"> +<p>Target classes</p> +</td> +<td align="left" headers="r5c1-t67 r1c2-t67"> +<p>Specifies the output location: either a directory or a JAR file.</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t67" headers="r1c1-t67"> +<p>Log level</p> +</td> +<td align="left" headers="r6c1-t67 r1c2-t67"> +<p>Specifies the amount and detail of log output. See <a href="reference053.htm#CIABGHHI">"Logging"</a> for information on the different logging levels.</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t67" headers="r1c1-t67"> +<p>Persistence XML root</p> +</td> +<td align="left" headers="r7c1-t67 r1c2-t67"> +<p>Specifies the location of the persistence.xml file if it is not in the same location as the source.</p> </td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformal" --> -<a id="sthref613" name="sthref613"></a> -<p class="subhead2">Related reference</p> +<!-- class="inftblinformal" --> +<a id="sthref633" name="sthref633"></a> +<p class="subhead2">Related References</p> <ul> <li> -<p><a href="reference039.htm#CACIJEGI">Joining Strategy</a></p> +<p><span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span> <br /> +<code><a href="http://www.eclipse.org/eclipselink/documentation/">http://www.eclipse.org/eclipselink/documentation/</a></code></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference062.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference062.htm index fce164122e..5060d4dab9 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference062.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference062.htm @@ -5,26 +5,26 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Add Join Column dialog</title> +<title>Project Properties page – Entity Generation</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Add Join Column dialog" /> +<meta name="doctitle" content="Project Properties page – Entity Generation" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACJJBAD" name="CACJJBAD"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACDCIGD" name="CACDCIGD"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Add Join Column dialog</h1> -<p><a id="sthref614" name="sthref614"></a><a id="sthref615" name="sthref615"></a>Use the <span class="gui-object-title">Join Columns</span> dialog to create or modify the join tables and columns in relationship mappings.</p> -<p>This table lists the properties available in the <span class="gui-object-title">Add Join Column</span> dialog.</p> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" title="Fields on the Add Join Column dialog" summary="Fields on the Add Join Column dialog" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<h1>Project Properties page – Entity Generation <a id="sthref634" name="sthref634"></a><a id="sthref635" name="sthref635"></a></h1> +<p>Use the <span class="gui-object-title">Entity Generation</span> options on the <span class="gui-object-title">Properties</span> page to configure the defaults Dali uses when generating entities</p> +<p>This table lists the properties available in the <span class="gui-object-title">Entity Generation page</span>.</p> +<div class="inftblinformal"> +<table class="Informal" title="Options on the Project Properties page > Entity Generation" summary="Options on the Project Properties page > Entity Generation" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <col width="32%" /> <col width="*" /> <thead> @@ -36,65 +36,30 @@ <tbody> <tr align="left" valign="top"> <td align="left" id="r2c1-t68" headers="r1c1-t68"> -<p>Name</p> -</td> -<td align="left" headers="r2c1-t68 r1c2-t68"> -<p>Name of the joint table column that contains the foreign key column.</p> +<p><span class="bold">Entity generation from tables</span></p> </td> +<td align="left" headers="r2c1-t68 r1c2-t68"><br /></td> </tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t68" headers="r1c1-t68"> -<p>Referenced Column Name</p> +<p>Default package</p> </td> <td align="left" headers="r3c1-t68 r1c2-t68"> -<p>Name of the database column that contains the foreign key reference for the entity relationship.</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t68" headers="r1c1-t68"> -<p>Table</p> +<p>Specify the default package name used for generated entities.</p> </td> -<td align="left" headers="r4c1-t68 r1c2-t68"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t68" headers="r1c1-t68"> -<p>Column definition</p> -</td> -<td align="left" headers="r5c1-t68 r1c2-t68"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t68" headers="r1c1-t68"> -<p>Insertable</p> -</td> -<td align="left" headers="r6c1-t68 r1c2-t68"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t68" headers="r1c1-t68"> -<p>Updatable</p> -</td> -<td align="left" headers="r7c1-t68 r1c2-t68"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r8c1-t68" headers="r1c1-t68"> -<p>Unique</p> -</td> -<td align="left" headers="r8c1-t68 r1c2-t68"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r9c1-t68" headers="r1c1-t68"> -<p>Mutable</p> -</td> -<td align="left" headers="r9c1-t68 r1c2-t68"><br /></td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformal" --> -<a id="sthref616" name="sthref616"></a> -<p class="subhead2">Related reference</p> +<!-- class="inftblinformal" --> +<a id="sthref636" name="sthref636"></a> +<p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="reference026.htm#CACBCGDI">Element Collection Mapping</a></p> +<p><a href="tasks022.htm#BABBAGFI">Generating entities from tables</a></p> +</li> +<li> +<p><a href="tasks024.htm#CIHHFGIG">Generating dynamic entities from tables</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference063.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference063.htm index 152efe1450..a7c7e31470 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference063.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference063.htm @@ -5,60 +5,76 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Mapping Type Selection dialog</title> +<title>Project Properties page – Errors/Warnings</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Mapping Type Selection dialog" /> +<meta name="doctitle" content="Project Properties page – Errors/Warnings" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACFEGAG" name="CACFEGAG"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACEEJJB" name="CACEEJJB"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Mapping Type Selection dialog</h1> -<p><a id="sthref624" name="sthref624"></a>Use this dialog to select a specific mapping type for the attribute or entity.</p> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="This table lists the options on the JPA Global Metadata Conversion dialog." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="24%" /> +<h1>Project Properties page – Errors/Warnings <a id="sthref637" name="sthref637"></a></h1> +<p>Use the <span class="gui-object-title">Errors/Warnings</span> options on the <span class="gui-object-title">Properties</span> page to specify if Dali should report errors and warnings for the project.</p> +<p>This table lists the properties available in the <span class="gui-object-title">Errors/Warnings page</span>.</p> +<div class="inftblinformal"> +<table class="Informal" title="Options on the Project Properties page > Errors/Warnings" summary="Options on the Project Properties page > Errors/Warnings" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> +<col width="32%" /> <col width="*" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t71">Property</th> -<th align="left" valign="bottom" id="r1c2-t71">Description</th> +<th align="left" valign="bottom" id="r1c1-t69">Property</th> +<th align="left" valign="bottom" id="r1c2-t69">Description</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t71" headers="r1c1-t71"> -<p>Enter mapping type or pattern</p> +<td align="left" id="r2c1-t69" headers="r1c1-t69"> +<p><span class="bold">Enable project specific settings</span></p> </td> -<td align="left" headers="r2c1-t71 r1c2-t71"> -<p>Enter the name (or part of a name) of a mapping type.</p> -<p>Leave blank to show all available options.</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t71" headers="r1c1-t71"> -<p>Matched items</p> -</td> -<td align="left" headers="r3c1-t71 r1c2-t71"> -<p>Dali displays the mapping types that match your search pattern.</p> +<td align="left" headers="r2c1-t69 r1c2-t69"> +<p>Specify if Dali reports errors and warning for the following features:</p> +<ul> +<li> +<p>Project</p> +</li> +<li> +<p>Persistence unit</p> +</li> +<li> +<p>TYpe</p> +</li> +<li> +<p>Attribute</p> +</li> +<li> +<p>Database</p> +</li> +<li> +<p>Inheritance</p> +</li> +<li> +<p>Queries and generators</p> +</li> +</ul> +<p>You can expand each category to display the possible error and warning messages.</p> </td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblhruleinformal" --> -<a id="sthref625" name="sthref625"></a> +<!-- class="inftblinformal" --> +<a id="sthref638" name="sthref638"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> +<p><a href="tasks025.htm#BABFAIBA">Validating mappings and reporting problems</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference064.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference064.htm index f4fe81164c..f7389d0001 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference064.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference064.htm @@ -5,66 +5,85 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>JPA Metadata Conversion dialog</title> +<title>Project Properties page – JAXB Options</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="JPA Metadata Conversion dialog" /> +<meta name="doctitle" content="Project Properties page – JAXB Options" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACJBCGG" name="CACJBCGG"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACFAAIB" name="CACFAAIB"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>JPA Metadata Conversion dialog</h1> -<p><a id="sthref626" name="sthref626"></a>Use this dialog to export your JPA metadata (converters, queries, and generators) to an XML mapping file.</p> -<p>Duplicated or overridden annotations <span class="italic">will not</span> be included in the generated mapping file.</p> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="This table lists the options on the JPA Global Metadata Conversion dialog." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="24%" /> +<h1>Project Properties page – JAXB Options</h1> +<p><a id="sthref639" name="sthref639"></a><a id="sthref640" name="sthref640"></a><a id="sthref641" name="sthref641"></a>Use the <span class="gui-object-title">JAXB</span> options on the <span class="gui-object-title">Properties</span> page to select the specific JAXB implementation use with the JAXB project.</p> +<p>This table lists the properties available in the <span class="gui-object-title">JAXB project properties page</span>.</p> +<div class="inftblinformal"> +<table class="Informal" title="Options on the Java Persistence Preferences page > JPA Options" summary="Options on the Java Persistence Preferences page > JPA Options" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> +<col width="32%" /> <col width="*" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t72">Property</th> -<th align="left" valign="bottom" id="r1c2-t72">Description</th> +<th align="left" valign="bottom" id="r1c1-t70">Property</th> +<th align="left" valign="bottom" id="r1c2-t70">Description</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t72" headers="r1c1-t72"> -<p>Mapping file</p> +<td align="left" id="r2c1-t70" headers="r1c1-t70"> +<p><a id="sthref642" name="sthref642"></a><a id="sthref643" name="sthref643"></a><a id="sthref644" name="sthref644"></a><a id="sthref645" name="sthref645"></a><span class="bold">Platform</span></p> </td> -<td align="left" headers="r2c1-t72 r1c2-t72"> -<p>Name and location of the XML file in which to save the JPA metadata</p> +<td align="left" headers="r2c1-t70 r1c2-t70"> +<p>Select the vendor-specific platform.</p> </td> </tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblhruleinformal" --> -<div align="center"> -<div class="inftblnotewarn"><br /> -<table class="NoteWarn oac_no_warn" summary="" cellpadding="3" cellspacing="0"> -<tbody> -<tr> -<td align="left"> -<p class="notep1">WARNING:</p> -<p class="warnsp">Malformed metadata will result in a non-functional mapping file</p> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t70" headers="r1c1-t70"> +<p><span class="bold">JAXB Implementation</span></p> +</td> +<td align="left" headers="r3c1-t70 r1c2-t70"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t70" headers="r1c1-t70"> +<p>Type</p> +</td> +<td align="left" headers="r4c1-t70 r1c2-t70"> +<p>Select <span class="bold">User Library</span> to select from the available user-defined or downloaded libraries.</p> +<p>If you select Disable, you must manually include the JPA implementation library on the project classpath.</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t70" headers="r1c1-t70"> +<p>Library</p> +</td> +<td align="left" headers="r5c1-t70 r1c2-t70"> +<p>Select a specific JPA library configuration.</p> +<p>Click <span class="bold">Manage libraries</span> to create or update a user library.</p> +<p>Click <span class="bold">Download libraries</span> to download a specific library configuration.</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t70" headers="r1c1-t70"> +<p>Include libraries with this application</p> +</td> +<td align="left" headers="r6c1-t70 r1c2-t70"> +<p>Specify if the selected libraries are included when deploying the application.</p> </td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblnotewarn" --></div> -<a id="sthref627" name="sthref627"></a> +<!-- class="inftblinformal" --> +<a id="sthref646" name="sthref646"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="tasks028.htm#CIHEHCHB">Converting JPA metadata to XML</a></p> +<p><a href="tasks001.htm#CIHIBIJJ">Creating a new JAXB project</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference065.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference065.htm index 037fb27005..3ab72f9ad1 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference065.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference065.htm @@ -5,93 +5,72 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Make Persistent dialog</title> +<title>Project Properties page – Schemas</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:42Z" /> +<meta name="date" content="2012-09-19T13:28:0Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Make Persistent dialog" /> +<meta name="doctitle" content="Project Properties page – Schemas" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACIBDFB" name="CACIBDFB"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACJGBFJ" name="CACJGBFJ"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Make Persistent dialog</h1> -<p><a id="sthref628" name="sthref628"></a>Use this dialog to add persistence to a Java class.</p> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="This table lists the options on the Make Persistent dialog." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="24%" /> +<h1>Project Properties page – Schemas</h1> +<p><a id="sthref647" name="sthref647"></a><a id="sthref648" name="sthref648"></a><a id="sthref649" name="sthref649"></a>Use the <span class="gui-object-title">Schemas</span> options on the <span class="gui-object-title">Properties</span> page to configure the JAXB schemas to use for validation and content assistance.</p> +<p>Click Add to</p> +<p>This table lists the properties available in the <span class="gui-object-title">Schemas properties page</span>.</p> +<div class="inftblinformal"> +<table class="Informal" title="Options on the Java Persistence Preferences page > JPA Options" summary="Options on the Java Persistence Preferences page > JPA Options" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> +<col width="32%" /> <col width="*" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t74">Property</th> -<th align="left" valign="bottom" id="r1c2-t74">Description</th> +<th align="left" valign="bottom" id="r1c1-t71">Property</th> +<th align="left" valign="bottom" id="r1c2-t71">Description</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t74" headers="r1c1-t74"> -<p>Annotate in Java</p> -</td> -<td align="left" headers="r2c1-t74 r1c2-t74"> -<p>Specify if Dali should use annotations. If disabled, Dali will add persistence information in the XML mapping file.</p> +<td align="left" id="r2c1-t71" headers="r1c1-t71"> +<p>Namespace</p> </td> +<td align="left" headers="r2c1-t71 r1c2-t71"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t74" headers="r1c1-t74"> -<p>Add to XML mapping file</p> -</td> -<td align="left" headers="r3c1-t74 r1c2-t74"> -<p>Specify if Dali should add persistence information in the XML mapping file. If disabled, Dali will use annotations.</p> +<td align="left" id="r3c1-t71" headers="r1c1-t71"> +<p>Location</p> </td> +<td align="left" headers="r3c1-t71 r1c2-t71"><br /></td> </tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t74" headers="r1c1-t74"> -<p>Java classes</p> -</td> -<td align="left" headers="r4c1-t74 r1c2-t74"> -<p>For each Java class, select the Mapping type:</p> +</tbody> +</table> +<br /></div> +<!-- class="inftblinformal" --> +<a id="sthref650" name="sthref650"></a> +<p class="subhead2">Related reference</p> <ul> <li> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> +<p><a href="reference074.htm#CACBGDHI">Add Schema Location dialog</a></p> </li> <li> -<p><a href="tasks003.htm#BABFEICE">Embeddable</a></p> -</li> -<li> -<p><a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> +<p><a href="reference075.htm#CACCEGGC">Select Schema Location dialog</a></p> </li> </ul> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t74" headers="r1c1-t74"> -<p>List in persistence.xml</p> -</td> -<td align="left" headers="r5c1-t74 r1c2-t74"> -<p>Specify if Dali should add persistence properties to the persistence.xml file.</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblhruleinformal" --> -<a id="sthref629" name="sthref629"></a> +<a id="sthref651" name="sthref651"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> -</li> -<li> -<p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> +<p><a href="tasks001.htm#CIHIBIJJ">Creating a new JAXB project</a></p> </li> </ul> </div> <!-- class="sect2" --> +<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference066.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference066.htm index cb05c33ce6..93a9fdbb07 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference066.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference066.htm @@ -5,71 +5,52 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Add Query dialog</title> +<title>Dialogs</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:43Z" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Add Query dialog" /> +<meta name="doctitle" content="Dialogs" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACJIFEG" name="CACJIFEG"></a></p> -<div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Add Query dialog</h1> -<p><a id="sthref630" name="sthref630"></a>Use this dialog to add a new named query or native named query .</p> -<div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="This table lists the options on the Add Query dialog." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="24%" /> -<col width="*" /> -<thead> -<tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t75">Property</th> -<th align="left" valign="bottom" id="r1c2-t75">Description</th> -</tr> -</thead> -<tbody> -<tr align="left" valign="top"> -<td align="left" id="r2c1-t75" headers="r1c1-t75"> -<p>Name</p> -</td> -<td align="left" headers="r2c1-t75 r1c2-t75"> -<p>Name of the query</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t75" headers="r1c1-t75"> -<p>Type</p> -</td> -<td align="left" headers="r3c1-t75 r1c2-t75"> -<p>Select the type of query to create:</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACGEJDA" name="CACGEJDA"></a></p> +<div class="sect1"><!-- infolevel="all" infotype="General" --> +<h1>Dialogs</h1> +<p>This section includes information on the following dialogs:</p> <ul> <li> -<p>Named query</p> +<p><a href="reference067.htm#CACCGEHC">Edit Join Columns Dialog</a></p> </li> <li> -<p>Native named query</p> +<p><a href="ref_select_cascade_dialog.htm#CIAFDGIJ">Select Cascade dialog</a></p> +</li> +<li> +<p><a href="ref_eclipselink_mapping_file.htm#CIAEDEJF">New EclipseLink Mapping File dialog</a></p> +</li> +<li> +<p><a href="ref_add_converter.htm#CIAGCGIJ">Add Converter dialog</a></p> +</li> +<li> +<p><a href="reference069.htm#CACFEGAG">Mapping Type Selection dialog</a></p> +</li> +<li> +<p><a href="reference070.htm#CACJBCGG">JPA Metadata Conversion dialog</a></p> </li> -</ul> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblhruleinformal" --> -<a id="sthref631" name="sthref631"></a> -<p class="subhead2">Related tasks</p> -<ul> <li> -<p><a href="tasks009.htm#BABIGBGG">Creating queries</a></p> +<p><a href="reference071.htm#CACIBDFB">Make Persistent dialog</a></p> +</li> +<li> +<p><a href="reference072.htm#CACJIFEG">Add Query dialog</a></p> +</li> +<li> +<p><a href="reference073.htm#CACDGGDB">Add Primary Key Join Column dialog</a></p> </li> </ul> -</div> -<!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> @@ -81,6 +62,6 @@ </tr> </table> </div> -<!-- class="footer" --> +<!-- class="footer" --></div> </body> </html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference067.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference067.htm index f6dac8e667..27030e8678 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference067.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference067.htm @@ -5,78 +5,64 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Add Primary Key Join Column dialog</title> +<title>Edit Join Columns Dialog</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:43Z" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Add Primary Key Join Column dialog" /> +<meta name="doctitle" content="Edit Join Columns Dialog" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACDGGDB" name="CACDGGDB"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACCGEHC" name="CACCGEHC"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Add Primary Key Join Column dialog<a id="sthref632" name="sthref632"></a></h1> +<h1>Edit Join Columns Dialog</h1> +<p><a id="sthref652" name="sthref652"></a>Use the <span class="gui-object-title">Join Columns</span> dialog to create or modify the join tables and columns in relationship mappings.</p> +<p>This table lists the properties available in the <span class="gui-object-title">Join Columns</span> dialog.</p> <div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="Add Primary Key Join Column dialog" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="27%" /> +<table class="HRuleInformal" title="This table describes the options on the Join Columns dialog." summary="This table describes the options on the Join Columns dialog." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="32%" /> <col width="*" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t76">Property</th> -<th align="left" valign="bottom" id="r1c2-t76">Description</th> +<th align="left" valign="bottom" id="r1c1-t72">Property</th> +<th align="left" valign="bottom" id="r1c2-t72">Description</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t76" headers="r1c1-t76"> +<td align="left" id="r2c1-t72" headers="r1c1-t72"> <p>Name</p> </td> -<td align="left" headers="r2c1-t76 r1c2-t76"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t76" headers="r1c1-t76"> -<p>Referenced column name</p> +<td align="left" headers="r2c1-t72 r1c2-t72"> +<p>Name of the joint table column that contains the foreign key column.</p> </td> -<td align="left" headers="r3c1-t76 r1c2-t76"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t76" headers="r1c1-t76"> -<p>Table</p> +<td align="left" id="r3c1-t72" headers="r1c1-t72"> +<p>Referenced Column Name</p> </td> -<td align="left" headers="r4c1-t76 r1c2-t76"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t76" headers="r1c1-t76"> -<p>Column definitions</p> +<td align="left" headers="r3c1-t72 r1c2-t72"> +<p>Name of the database column that contains the foreign key reference for the entity relationship.</p> </td> -<td align="left" headers="r5c1-t76 r1c2-t76"><br /></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref633" name="sthref633"></a> +<a id="sthref653" name="sthref653"></a> <p class="subhead2">Related reference</p> <ul> <li> -<p><a href="reference018.htm#CACFHGHE">Inheritance</a></p> -</li> -</ul> -<a id="sthref634" name="sthref634"></a> -<p class="subhead2">Related tasks</p> -<ul> -<li> -<p><a href="task_inheritance.htm#CIHCCCJD">Specifying entity inheritance</a></p> +<p><a href="reference043.htm#CACIJEGI">Joining Strategy</a></p> </li> </ul> </div> <!-- class="sect2" --> -<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference068.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference068.htm index 0f18281359..aa94f164df 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference068.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference068.htm @@ -5,31 +5,100 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Icons and buttons</title> +<title>Add Join Column dialog</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:43Z" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Icons and buttons" /> +<meta name="doctitle" content="Add Join Column dialog" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACDHCIA" name="CACDHCIA"></a></p> -<div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1>Icons and buttons</h1> -<p>This section includes information on each of the icons and buttons used in the Dali OR Mapping Tool.</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACJJBAD" name="CACJJBAD"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Add Join Column dialog</h1> +<p><a id="sthref654" name="sthref654"></a><a id="sthref655" name="sthref655"></a>Use the <span class="gui-object-title">Join Columns</span> dialog to create or modify the join tables and columns in relationship mappings.</p> +<p>This table lists the properties available in the <span class="gui-object-title">Add Join Column</span> dialog.</p> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" title="Fields on the Add Join Column dialog" summary="Fields on the Add Join Column dialog" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="32%" /> +<col width="*" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t73">Property</th> +<th align="left" valign="bottom" id="r1c2-t73">Description</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t73" headers="r1c1-t73"> +<p>Name</p> +</td> +<td align="left" headers="r2c1-t73 r1c2-t73"> +<p>Name of the joint table column that contains the foreign key column.</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t73" headers="r1c1-t73"> +<p>Referenced Column Name</p> +</td> +<td align="left" headers="r3c1-t73 r1c2-t73"> +<p>Name of the database column that contains the foreign key reference for the entity relationship.</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t73" headers="r1c1-t73"> +<p>Table</p> +</td> +<td align="left" headers="r4c1-t73 r1c2-t73"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t73" headers="r1c1-t73"> +<p>Column definition</p> +</td> +<td align="left" headers="r5c1-t73 r1c2-t73"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t73" headers="r1c1-t73"> +<p>Insertable</p> +</td> +<td align="left" headers="r6c1-t73 r1c2-t73"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t73" headers="r1c1-t73"> +<p>Updatable</p> +</td> +<td align="left" headers="r7c1-t73 r1c2-t73"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r8c1-t73" headers="r1c1-t73"> +<p>Unique</p> +</td> +<td align="left" headers="r8c1-t73 r1c2-t73"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r9c1-t73" headers="r1c1-t73"> +<p>Mutable</p> +</td> +<td align="left" headers="r9c1-t73 r1c2-t73"><br /></td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<a id="sthref656" name="sthref656"></a> +<p class="subhead2">Related reference</p> <ul> <li> -<p><a href="reference069.htm#CACGEACG">Icons</a></p> -</li> -<li> -<p><a href="reference070.htm#CACDJCEI">Buttons</a></p> +<p><a href="reference030.htm#CACBCGDI">Element Collection Mapping</a></p> </li> </ul> +</div> +<!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> @@ -41,6 +110,6 @@ </tr> </table> </div> -<!-- class="footer" --></div> +<!-- class="footer" --> </body> </html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference069.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference069.htm index 7a9074a926..a31cecfedc 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference069.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference069.htm @@ -5,173 +5,60 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Icons</title> +<title>Mapping Type Selection dialog</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:43Z" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Icons" /> +<meta name="doctitle" content="Mapping Type Selection dialog" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACGEACG" name="CACGEACG"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACFEGAG" name="CACFEGAG"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Icons</h1> -<p>The following icons are used throughout the Dali OR Mapping Tool.</p> +<h1>Mapping Type Selection dialog</h1> +<p><a id="sthref664" name="sthref664"></a>Use this dialog to select a specific mapping type for the attribute or entity.</p> <div class="inftblhruleinformal"> -<table class="HRuleInformal" title="This table describes the icons used in the Dali plug-in." summary="This table describes the icons used in the Dali plug-in." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="23%" /> +<table class="HRuleInformal" summary="This table lists the options on the JPA Global Metadata Conversion dialog." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="24%" /> <col width="*" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t77">Icon</th> -<th align="left" valign="bottom" id="r1c2-t77">Description</th> +<th align="left" valign="bottom" id="r1c1-t76">Property</th> +<th align="left" valign="bottom" id="r1c2-t76">Description</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t77" headers="r1c1-t77"> -<p><span class="bold">Entity icons</span></p> +<td align="left" id="r2c1-t76" headers="r1c1-t76"> +<p>Enter mapping type or pattern</p> </td> -<td align="left" headers="r2c1-t77 r1c2-t77"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r3c1-t77" headers="r1c1-t77"> -<p><img src="img/new_icon_mappedentity.png" alt="" title="" /></p> -<br /></td> -<td align="left" headers="r3c1-t77 r1c2-t77"> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r4c1-t77" headers="r1c1-t77"><img src="img/new_icon_embeddableentitymapping.png" alt="Embeddable entity icon" title="Embeddable entity icon" /><br /></td> -<td align="left" headers="r4c1-t77 r1c2-t77"> -<p><a href="tasks003.htm#BABFEICE">Embeddable</a> entity</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r5c1-t77" headers="r1c1-t77"><img src="img/new_icon_mappedsuperclass.png" alt="Mapped superclass icon" title="Mapped superclass icon" /><br /></td> -<td align="left" headers="r5c1-t77 r1c2-t77"> -<p><a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r6c1-t77" headers="r1c1-t77"> -<p><span class="bold">Mapping icons</span></p> -</td> -<td align="left" headers="r6c1-t77 r1c2-t77"><br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r7c1-t77" headers="r1c1-t77"><img src="img/icon_arraymapping.png" alt="Array mapping icon" title="Array mapping icon" /><br /></td> -<td align="left" headers="r7c1-t77 r1c2-t77"> -<p>Array mapping</p> +<td align="left" headers="r2c1-t76 r1c2-t76"> +<p>Enter the name (or part of a name) of a mapping type.</p> +<p>Leave blank to show all available options.</p> </td> </tr> <tr align="left" valign="top"> -<td align="left" id="r8c1-t77" headers="r1c1-t77"><img src="img/new_icon_basicmappings.png" alt="Basic mapping icon" title="Basic mapping icon" /><br /></td> -<td align="left" headers="r8c1-t77 r1c2-t77"> -<p><a href="tasks010.htm#BABBABCE">Basic mapping</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r9c1-t77" headers="r1c1-t77"><img src="img/icon_basicmapmappings.png" alt="Basic mapping icon" title="Basic mapping icon" /><br /></td> -<td align="left" headers="r9c1-t77 r1c2-t77"> -<p>Basic collection mapping</p> +<td align="left" id="r3c1-t76" headers="r1c1-t76"> +<p>Matched items</p> </td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r10c1-t77" headers="r1c1-t77"><img src="img/icon_basicmapmappings.png" alt="Basic mapping icon" title="Basic mapping icon" /><br /></td> -<td align="left" headers="r10c1-t77 r1c2-t77"> -<p>Basic map mapping</p> +<td align="left" headers="r3c1-t76 r1c2-t76"> +<p>Dali displays the mapping types that match your search pattern.</p> </td> </tr> -<tr align="left" valign="top"> -<td align="left" id="r11c1-t77" headers="r1c1-t77"><img src="img/icon_elementcollection.png" alt="Element collection mapping icon" title="Element collection mapping icon" /><br /></td> -<td align="left" headers="r11c1-t77 r1c2-t77"> -<p><a href="tasks011.htm#CIHHJEBJ">Element collection mapping</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r12c1-t77" headers="r1c1-t77"><img src="img/new_icon_embeddedidmapping.png" alt="Embedded mapping icon" title="Embedded mapping icon" /><br /></td> -<td align="left" headers="r12c1-t77 r1c2-t77"> -<p><a href="tasks012.htm#BABCBHDF">Embedded mapping</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r13c1-t77" headers="r1c1-t77"><img src="img/new_icon_embeddedmapping.png" alt="Embedded ID mapping icon" title="Embedded ID mapping icon" /><br /></td> -<td align="left" headers="r13c1-t77 r1c2-t77"> -<p><a href="tasks013.htm#CIHDIAEE">Embedded ID mapping</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r14c1-t77" headers="r1c1-t77"><img src="img/new_icon_idmapping.png" alt="ID mapping icon" title="ID mapping icon" /><br /></td> -<td align="left" headers="r14c1-t77 r1c2-t77"> -<p><a href="tasks014.htm#BABGCBHG">ID mapping</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r15c1-t77" headers="r1c1-t77"><img src="img/new_icon_manytomanymapping.png" alt="Many-to-many mapping icon" title="Many-to-many mapping icon" /><br /></td> -<td align="left" headers="r15c1-t77 r1c2-t77"> -<p><a href="tasks015.htm#BABEIEGD">Many-to-many mapping</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r16c1-t77" headers="r1c1-t77"><img src="img/new_icon_manytoonemapping.png" alt="Many-to-one mapping icon." title="Many-to-one mapping icon." /><br /></td> -<td align="left" headers="r16c1-t77 r1c2-t77"> -<p><a href="tasks016.htm#BABHFAFJ">Many-to-one mapping</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r17c1-t77" headers="r1c1-t77"><img src="img/new_icon_onetomanymapping.png" alt="One-to-many mapping icon" title="One-to-many mapping icon" /><br /></td> -<td align="left" headers="r17c1-t77 r1c2-t77"> -<p><a href="tasks017.htm#BABHGEBD">One-to-many mapping</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r18c1-t77" headers="r1c1-t77"><img src="img/new_icon_onetoonemapping.png" alt="One-to-one mapping icon." title="One-to-one mapping icon." /><br /></td> -<td align="left" headers="r18c1-t77 r1c2-t77"> -<p><a href="tasks018.htm#BABFHBCJ">One-to-one mapping</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r19c1-t77" headers="r1c1-t77"><img src="img/icon_basicmapmappings.png" alt="Basic mapping icon" title="Basic mapping icon" /><br /></td> -<td align="left" headers="r19c1-t77 r1c2-t77"> -<p>Transformation mappings</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r20c1-t77" headers="r1c1-t77"><img src="img/new_icon_transientmapping.png" alt="Transient mapping icon." title="Transient mapping icon." /><br /></td> -<td align="left" headers="r20c1-t77 r1c2-t77"> -<p><a href="tasks019.htm#BABHFHEI">Transient mapping</a></p> -<br /></td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r21c1-t77" headers="r1c1-t77"><img src="img/icon_basicmapmappings.png" alt="Basic mapping icon" title="Basic mapping icon" /><br /></td> -<td align="left" headers="r21c1-t77 r1c2-t77"> -<p>Variable one-to-one mappings</p> -</td> -</tr> -<tr align="left" valign="top"> -<td align="left" id="r22c1-t77" headers="r1c1-t77"> -<p><img src="img/new_icon_versionmapping.png" alt="Version mapping icon." title="Version mapping icon." /></p> -<br /></td> -<td align="left" headers="r22c1-t77 r1c2-t77"> -<p><a href="tasks020.htm#BABHIBII">Version mapping</a></p> -<br /></td> -</tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref639" name="sthref639"></a> -<p class="subhead2">Related concepts</p> +<a id="sthref665" name="sthref665"></a> +<p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="reference068.htm#CACDHCIA">Icons and buttons</a></p> +<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference070.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference070.htm index 9e211c166a..db0ec0b5d2 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference070.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference070.htm @@ -5,54 +5,70 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Buttons</title> +<title>JPA Metadata Conversion dialog</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:44Z" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Buttons" /> +<meta name="doctitle" content="JPA Metadata Conversion dialog" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACDJCEI" name="CACDJCEI"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACJBCGG" name="CACJBCGG"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Buttons</h1> -<p>The following buttons are used throughout the Dali OR Mapping Tool.</p> +<h1>JPA Metadata Conversion dialog</h1> +<p><a id="sthref666" name="sthref666"></a>Use this dialog to export your JPA metadata (converters, queries, and generators) to an XML mapping file.</p> +<p>Duplicated or overridden annotations <span class="italic">will not</span> be included in the generated mapping file.</p> <div class="inftblhruleinformal"> -<table class="HRuleInformal" title="This table describes the buttons used in the Dali plug-in." summary="This table describes the buttons used in the Dali plug-in." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="27%" /> +<table class="HRuleInformal" summary="This table lists the options on the JPA Global Metadata Conversion dialog." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="24%" /> <col width="*" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t78">Icon</th> -<th align="left" valign="bottom" id="r1c2-t78">Description</th> +<th align="left" valign="bottom" id="r1c1-t77">Property</th> +<th align="left" valign="bottom" id="r1c2-t77">Description</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t78" headers="r1c1-t78"><img src="img/new_jpa_perspective_button.png" alt="The JPA Perspective icon" title="The JPA Perspective icon" /><br /></td> -<td align="left" headers="r2c1-t78 r1c2-t78"> -<p>JPA Development perspective</p> +<td align="left" id="r2c1-t77" headers="r1c1-t77"> +<p>Mapping file</p> +</td> +<td align="left" headers="r2c1-t77 r1c2-t77"> +<p>Name and location of the XML file in which to save the JPA metadata</p> </td> </tr> </tbody> </table> <br /></div> <!-- class="inftblhruleinformal" --> -<a id="sthref640" name="sthref640"></a> -<p class="subhead2">Related concepts</p> +<div align="center"> +<div class="inftblnotewarn"><br /> +<table class="NoteWarn oac_no_warn" summary="" cellpadding="3" cellspacing="0"> +<tbody> +<tr> +<td align="left"> +<p class="notep1">WARNING:</p> +<p class="warnsp">Malformed metadata will result in a non-functional mapping file</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblnotewarn" --></div> +<a id="sthref667" name="sthref667"></a> +<p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="reference068.htm#CACDHCIA">Icons and buttons</a></p> +<p><a href="tasks029.htm#CIHEHCHB">Converting JPA metadata to XML</a></p> </li> </ul> </div> <!-- class="sect2" --> -<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference071.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference071.htm index e43263d3df..3928b2dcd4 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference071.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference071.htm @@ -5,38 +5,93 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Dali Developer Documentation</title> +<title>Make Persistent dialog</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:44Z" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Dali Developer Documentation" /> +<meta name="doctitle" content="Make Persistent dialog" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CACBBDIB" name="CACBBDIB"></a></p> -<div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1>Dali Developer Documentation</h1> -<p><a id="sthref641" name="sthref641"></a><a id="sthref642" name="sthref642"></a><a id="sthref643" name="sthref643"></a>Additional Dali documentation is available online at:</p> -<p><code><a href="http://wiki.eclipse.org/index.php/Dali_Developer_Documentation">http://wiki.eclipse.org/index.php/Dali_Developer_Documentation</a></code></p> -<p>This developer documentation includes information about:</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACIBDFB" name="CACIBDFB"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Make Persistent dialog</h1> +<p><a id="sthref668" name="sthref668"></a>Use this dialog to add persistence to a Java class.</p> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" summary="This table lists the options on the Make Persistent dialog." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="24%" /> +<col width="*" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t79">Property</th> +<th align="left" valign="bottom" id="r1c2-t79">Description</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t79" headers="r1c1-t79"> +<p>Annotate in Java</p> +</td> +<td align="left" headers="r2c1-t79 r1c2-t79"> +<p>Specify if Dali should use annotations. If disabled, Dali will add persistence information in the XML mapping file.</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t79" headers="r1c1-t79"> +<p>Add to XML mapping file</p> +</td> +<td align="left" headers="r3c1-t79 r1c2-t79"> +<p>Specify if Dali should add persistence information in the XML mapping file. If disabled, Dali will use annotations.</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t79" headers="r1c1-t79"> +<p>Java classes</p> +</td> +<td align="left" headers="r4c1-t79 r1c2-t79"> +<p>For each Java class, select the Mapping type:</p> <ul> <li> -<p>Dali architecture</p> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> </li> <li> -<p>Plugins that comprise the Dali JPA Eclipse feature</p> +<p><a href="tasks004.htm#BABFEICE">Embeddable</a></p> +</li> +<li> +<p><a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</li> +</ul> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t79" headers="r1c1-t79"> +<p>List in persistence.xml</p> +</td> +<td align="left" headers="r5c1-t79 r1c2-t79"> +<p>Specify if Dali should add persistence properties to the persistence.xml file.</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<a id="sthref669" name="sthref669"></a> +<p class="subhead2">Related tasks</p> +<ul> +<li> +<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> <li> -<p>Extension points</p> +<p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> </li> </ul> </div> -<!-- class="sect1" --> +<!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference072.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference072.htm new file mode 100644 index 0000000000..cf906db19e --- /dev/null +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference072.htm @@ -0,0 +1,86 @@ +<!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> +<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> +<meta http-equiv="Content-Style-Type" content="text/css" /> +<meta http-equiv="Content-Script-Type" content="text/javascript" /> +<title>Add Query dialog</title> +<meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> +<meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> +<meta name="robots" content="noarchive" /> +<meta name="doctitle" content="Add Query dialog" /> +<meta name="relnum" content="Release 3.2" /> +<meta name="partnum" content="Release 3.2" /> +<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" /> +</head> +<body> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACJIFEG" name="CACJIFEG"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Add Query dialog</h1> +<p><a id="sthref670" name="sthref670"></a>Use this dialog to add a new named query or native named query .</p> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" summary="This table lists the options on the Add Query dialog." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="24%" /> +<col width="*" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t80">Property</th> +<th align="left" valign="bottom" id="r1c2-t80">Description</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t80" headers="r1c1-t80"> +<p>Name</p> +</td> +<td align="left" headers="r2c1-t80 r1c2-t80"> +<p>Name of the query</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t80" headers="r1c1-t80"> +<p>Type</p> +</td> +<td align="left" headers="r3c1-t80 r1c2-t80"> +<p>Select the type of query to create:</p> +<ul> +<li> +<p>Named query</p> +</li> +<li> +<p>Native named query</p> +</li> +</ul> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<a id="sthref671" name="sthref671"></a> +<p class="subhead2">Related tasks</p> +<ul> +<li> +<p><a href="tasks010.htm#BABIGBGG">Creating queries</a></p> +</li> +</ul> +</div> +<!-- class="sect2" --> +<!-- Start Footer --> +<div class="footer"> +<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> +<col width="86%" /> +<col width="*" /> +<tr> +<td align="left"><span class="copyrightlogo">Copyright © 2011, 2012, Oracle and/or its affiliates. All rights reserved.</span><br /> +<a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Legal Notices</span></a></td> +</tr> +</table> +</div> +<!-- class="footer" --> +</body> +</html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference073.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference073.htm new file mode 100644 index 0000000000..67c04a5238 --- /dev/null +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference073.htm @@ -0,0 +1,92 @@ +<!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> +<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> +<meta http-equiv="Content-Style-Type" content="text/css" /> +<meta http-equiv="Content-Script-Type" content="text/javascript" /> +<title>Add Primary Key Join Column dialog</title> +<meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> +<meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> +<meta name="robots" content="noarchive" /> +<meta name="doctitle" content="Add Primary Key Join Column dialog" /> +<meta name="relnum" content="Release 3.2" /> +<meta name="partnum" content="Release 3.2" /> +<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" /> +</head> +<body> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACDGGDB" name="CACDGGDB"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Add Primary Key Join Column dialog<a id="sthref672" name="sthref672"></a></h1> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" summary="Add Primary Key Join Column dialog" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="27%" /> +<col width="*" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t81">Property</th> +<th align="left" valign="bottom" id="r1c2-t81">Description</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t81" headers="r1c1-t81"> +<p>Name</p> +</td> +<td align="left" headers="r2c1-t81 r1c2-t81"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t81" headers="r1c1-t81"> +<p>Referenced column name</p> +</td> +<td align="left" headers="r3c1-t81 r1c2-t81"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t81" headers="r1c1-t81"> +<p>Table</p> +</td> +<td align="left" headers="r4c1-t81 r1c2-t81"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t81" headers="r1c1-t81"> +<p>Column definitions</p> +</td> +<td align="left" headers="r5c1-t81 r1c2-t81"><br /></td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<a id="sthref673" name="sthref673"></a> +<p class="subhead2">Related reference</p> +<ul> +<li> +<p><a href="reference022.htm#CACFHGHE">Inheritance</a></p> +</li> +</ul> +<a id="sthref674" name="sthref674"></a> +<p class="subhead2">Related tasks</p> +<ul> +<li> +<p><a href="task_inheritance.htm#CIHCCCJD">Specifying entity inheritance</a></p> +</li> +</ul> +</div> +<!-- class="sect2" --> +<!-- Start Footer --> +<div class="footer"> +<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> +<col width="86%" /> +<col width="*" /> +<tr> +<td align="left"><span class="copyrightlogo">Copyright © 2011, 2012, Oracle and/or its affiliates. All rights reserved.</span><br /> +<a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Legal Notices</span></a></td> +</tr> +</table> +</div> +<!-- class="footer" --> +</body> +</html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference074.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference074.htm new file mode 100644 index 0000000000..e72b165969 --- /dev/null +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference074.htm @@ -0,0 +1,79 @@ +<!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> +<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> +<meta http-equiv="Content-Style-Type" content="text/css" /> +<meta http-equiv="Content-Script-Type" content="text/javascript" /> +<title>Add Schema Location dialog</title> +<meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> +<meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> +<meta name="robots" content="noarchive" /> +<meta name="doctitle" content="Add Schema Location dialog" /> +<meta name="relnum" content="Release 3.2" /> +<meta name="partnum" content="Release 3.2" /> +<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" /> +</head> +<body> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACBGDHI" name="CACBGDHI"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Add Schema Location<a id="sthref675" name="sthref675"></a><a id="sthref676" name="sthref676"></a><a id="sthref677" name="sthref677"></a> dialog</h1> +<p>Use this dialog to configure a new schema namespace and the location where it can be found.</p> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" summary="Add Primary Key Join Column dialog" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="27%" /> +<col width="*" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t82">Property</th> +<th align="left" valign="bottom" id="r1c2-t82">Description</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t82" headers="r1c1-t82"> +<p>Location</p> +</td> +<td align="left" headers="r2c1-t82 r1c2-t82"> +<p>Click Browse and use the <a href="reference075.htm#CACCEGGC">Select Schema Location dialog</a> to specify the location of the schema.</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t82" headers="r1c1-t82"> +<p>Namespace</p> +</td> +<td align="left" headers="r3c1-t82 r1c2-t82"><br /></td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<a id="sthref678" name="sthref678"></a> +<p class="subhead2">Related reference</p> +<ul> +<li> +<p><a href="reference075.htm#CACCEGGC">Select Schema Location dialog</a></p> +</li> +<li> +<p><a href="reference065.htm#CACJGBFJ">Project Properties page – Schemas</a></p> +</li> +</ul> +</div> +<!-- class="sect2" --> +<!-- Start Footer --> +<div class="footer"> +<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> +<col width="86%" /> +<col width="*" /> +<tr> +<td align="left"><span class="copyrightlogo">Copyright © 2011, 2012, Oracle and/or its affiliates. All rights reserved.</span><br /> +<a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Legal Notices</span></a></td> +</tr> +</table> +</div> +<!-- class="footer" --> +</body> +</html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference075.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference075.htm new file mode 100644 index 0000000000..ad3d0684eb --- /dev/null +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference075.htm @@ -0,0 +1,83 @@ +<!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> +<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> +<meta http-equiv="Content-Style-Type" content="text/css" /> +<meta http-equiv="Content-Script-Type" content="text/javascript" /> +<title>Select Schema Location dialog</title> +<meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> +<meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> +<meta name="robots" content="noarchive" /> +<meta name="doctitle" content="Select Schema Location dialog" /> +<meta name="relnum" content="Release 3.2" /> +<meta name="partnum" content="Release 3.2" /> +<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" /> +</head> +<body> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACCEGGC" name="CACCEGGC"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Select Schema Location dialog<a id="sthref679" name="sthref679"></a><a id="sthref680" name="sthref680"></a><a id="sthref681" name="sthref681"></a></h1> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" summary="Add Primary Key Join Column dialog" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="27%" /> +<col width="*" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t83">Property</th> +<th align="left" valign="bottom" id="r1c2-t83">Description</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t83" headers="r1c1-t83"> +<p>Select file from Workspace</p> +</td> +<td align="left" headers="r2c1-t83 r1c2-t83"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t83" headers="r1c1-t83"> +<p>Select XML catalog entry</p> +</td> +<td align="left" headers="r3c1-t83 r1c2-t83"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t83" headers="r1c1-t83"> +<p>Workspace files</p> +</td> +<td align="left" headers="r4c1-t83 r1c2-t83"><br /></td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<a id="sthref682" name="sthref682"></a> +<p class="subhead2">Related reference</p> +<ul> +<li> +<p><a href="reference074.htm#CACBGDHI">Add Schema Location dialog</a></p> +</li> +<li> +<p><a href="reference065.htm#CACJGBFJ">Project Properties page – Schemas</a></p> +</li> +</ul> +</div> +<!-- class="sect2" --> +<!-- class="sect1" --> +<!-- Start Footer --> +<div class="footer"> +<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> +<col width="86%" /> +<col width="*" /> +<tr> +<td align="left"><span class="copyrightlogo">Copyright © 2011, 2012, Oracle and/or its affiliates. All rights reserved.</span><br /> +<a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Legal Notices</span></a></td> +</tr> +</table> +</div> +<!-- class="footer" --> +</body> +</html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference076.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference076.htm new file mode 100644 index 0000000000..f32ee53550 --- /dev/null +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference076.htm @@ -0,0 +1,46 @@ +<!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> +<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> +<meta http-equiv="Content-Style-Type" content="text/css" /> +<meta http-equiv="Content-Script-Type" content="text/javascript" /> +<title>Icons and buttons</title> +<meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> +<meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> +<meta name="robots" content="noarchive" /> +<meta name="doctitle" content="Icons and buttons" /> +<meta name="relnum" content="Release 3.2" /> +<meta name="partnum" content="Release 3.2" /> +<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" /> +</head> +<body> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACDHCIA" name="CACDHCIA"></a></p> +<div class="sect1"><!-- infolevel="all" infotype="General" --> +<h1>Icons and buttons</h1> +<p>This section includes information on each of the icons and buttons used in the Dali OR Mapping Tool.</p> +<ul> +<li> +<p><a href="reference077.htm#CACGEACG">Icons</a></p> +</li> +<li> +<p><a href="reference078.htm#CACDJCEI">Buttons</a></p> +</li> +</ul> +<!-- Start Footer --> +<div class="footer"> +<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> +<col width="86%" /> +<col width="*" /> +<tr> +<td align="left"><span class="copyrightlogo">Copyright © 2011, 2012, Oracle and/or its affiliates. All rights reserved.</span><br /> +<a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Legal Notices</span></a></td> +</tr> +</table> +</div> +<!-- class="footer" --></div> +</body> +</html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference077.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference077.htm new file mode 100644 index 0000000000..66fc6d79f7 --- /dev/null +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference077.htm @@ -0,0 +1,192 @@ +<!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> +<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> +<meta http-equiv="Content-Style-Type" content="text/css" /> +<meta http-equiv="Content-Script-Type" content="text/javascript" /> +<title>Icons</title> +<meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> +<meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> +<meta name="date" content="2012-09-19T13:28:1Z" /> +<meta name="robots" content="noarchive" /> +<meta name="doctitle" content="Icons" /> +<meta name="relnum" content="Release 3.2" /> +<meta name="partnum" content="Release 3.2" /> +<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" /> +</head> +<body> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACGEACG" name="CACGEACG"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Icons</h1> +<p>The following icons are used throughout the Dali OR Mapping Tool.</p> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" title="This table describes the icons used in the Dali plug-in." summary="This table describes the icons used in the Dali plug-in." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="23%" /> +<col width="*" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t84">Icon</th> +<th align="left" valign="bottom" id="r1c2-t84">Description</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t84" headers="r1c1-t84"> +<p><span class="bold">Entity icons</span></p> +</td> +<td align="left" headers="r2c1-t84 r1c2-t84"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r3c1-t84" headers="r1c1-t84"> +<p><img src="img/new_icon_mappedentity.png" alt="" title="" /></p> +<br /></td> +<td align="left" headers="r3c1-t84 r1c2-t84"> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t84" headers="r1c1-t84"><img src="img/new_icon_embeddableentitymapping.png" alt="Embeddable entity icon" title="Embeddable entity icon" /><br /></td> +<td align="left" headers="r4c1-t84 r1c2-t84"> +<p><a href="tasks004.htm#BABFEICE">Embeddable</a> entity</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t84" headers="r1c1-t84"><img src="img/new_icon_mappedsuperclass.png" alt="Mapped superclass icon" title="Mapped superclass icon" /><br /></td> +<td align="left" headers="r5c1-t84 r1c2-t84"> +<p><a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r6c1-t84" headers="r1c1-t84"> +<p><span class="bold">Mapping icons</span></p> +</td> +<td align="left" headers="r6c1-t84 r1c2-t84"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t84" headers="r1c1-t84"><img src="img/icon_arraymapping.png" alt="Array mapping icon" title="Array mapping icon" /><br /></td> +<td align="left" headers="r7c1-t84 r1c2-t84"> +<p>Array mapping</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r8c1-t84" headers="r1c1-t84"><img src="img/new_icon_basicmappings.png" alt="Basic mapping icon" title="Basic mapping icon" /><br /></td> +<td align="left" headers="r8c1-t84 r1c2-t84"> +<p><a href="tasks011.htm#BABBABCE">Basic mapping</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r9c1-t84" headers="r1c1-t84"><img src="img/icon_basicmapmappings.png" alt="Basic mapping icon" title="Basic mapping icon" /><br /></td> +<td align="left" headers="r9c1-t84 r1c2-t84"> +<p>Basic collection mapping</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r10c1-t84" headers="r1c1-t84"><img src="img/icon_basicmapmappings.png" alt="Basic mapping icon" title="Basic mapping icon" /><br /></td> +<td align="left" headers="r10c1-t84 r1c2-t84"> +<p>Basic map mapping</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r11c1-t84" headers="r1c1-t84"><img src="img/icon_elementcollection.png" alt="Element collection mapping icon" title="Element collection mapping icon" /><br /></td> +<td align="left" headers="r11c1-t84 r1c2-t84"> +<p><a href="tasks012.htm#CIHHJEBJ">Element collection mapping</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r12c1-t84" headers="r1c1-t84"><img src="img/new_icon_embeddedidmapping.png" alt="Embedded mapping icon" title="Embedded mapping icon" /><br /></td> +<td align="left" headers="r12c1-t84 r1c2-t84"> +<p><a href="tasks013.htm#BABCBHDF">Embedded mapping</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r13c1-t84" headers="r1c1-t84"><img src="img/new_icon_embeddedmapping.png" alt="Embedded ID mapping icon" title="Embedded ID mapping icon" /><br /></td> +<td align="left" headers="r13c1-t84 r1c2-t84"> +<p><a href="tasks014.htm#CIHDIAEE">Embedded ID mapping</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r14c1-t84" headers="r1c1-t84"><img src="img/new_icon_idmapping.png" alt="ID mapping icon" title="ID mapping icon" /><br /></td> +<td align="left" headers="r14c1-t84 r1c2-t84"> +<p><a href="tasks015.htm#BABGCBHG">ID mapping</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r15c1-t84" headers="r1c1-t84"><img src="img/new_icon_manytomanymapping.png" alt="Many-to-many mapping icon" title="Many-to-many mapping icon" /><br /></td> +<td align="left" headers="r15c1-t84 r1c2-t84"> +<p><a href="tasks016.htm#BABEIEGD">Many-to-many mapping</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r16c1-t84" headers="r1c1-t84"><img src="img/new_icon_manytoonemapping.png" alt="Many-to-one mapping icon." title="Many-to-one mapping icon." /><br /></td> +<td align="left" headers="r16c1-t84 r1c2-t84"> +<p><a href="tasks017.htm#BABHFAFJ">Many-to-one mapping</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r17c1-t84" headers="r1c1-t84"><img src="img/new_icon_onetomanymapping.png" alt="One-to-many mapping icon" title="One-to-many mapping icon" /><br /></td> +<td align="left" headers="r17c1-t84 r1c2-t84"> +<p><a href="tasks018.htm#BABHGEBD">One-to-many mapping</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r18c1-t84" headers="r1c1-t84"><img src="img/new_icon_onetoonemapping.png" alt="One-to-one mapping icon." title="One-to-one mapping icon." /><br /></td> +<td align="left" headers="r18c1-t84 r1c2-t84"> +<p><a href="tasks019.htm#BABFHBCJ">One-to-one mapping</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r19c1-t84" headers="r1c1-t84"><img src="img/icon_basicmapmappings.png" alt="Basic mapping icon" title="Basic mapping icon" /><br /></td> +<td align="left" headers="r19c1-t84 r1c2-t84"> +<p>Transformation mappings</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r20c1-t84" headers="r1c1-t84"><img src="img/new_icon_transientmapping.png" alt="Transient mapping icon." title="Transient mapping icon." /><br /></td> +<td align="left" headers="r20c1-t84 r1c2-t84"> +<p><a href="tasks020.htm#BABHFHEI">Transient mapping</a></p> +<br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r21c1-t84" headers="r1c1-t84"><img src="img/icon_basicmapmappings.png" alt="Basic mapping icon" title="Basic mapping icon" /><br /></td> +<td align="left" headers="r21c1-t84 r1c2-t84"> +<p>Variable one-to-one mappings</p> +</td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r22c1-t84" headers="r1c1-t84"> +<p><img src="img/new_icon_versionmapping.png" alt="Version mapping icon." title="Version mapping icon." /></p> +<br /></td> +<td align="left" headers="r22c1-t84 r1c2-t84"> +<p><a href="tasks021.htm#BABHIBII">Version mapping</a></p> +<br /></td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<a id="sthref687" name="sthref687"></a> +<p class="subhead2">Related concepts</p> +<ul> +<li> +<p><a href="reference076.htm#CACDHCIA">Icons and buttons</a></p> +</li> +</ul> +</div> +<!-- class="sect2" --> +<!-- Start Footer --> +<div class="footer"> +<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> +<col width="86%" /> +<col width="*" /> +<tr> +<td align="left"><span class="copyrightlogo">Copyright © 2011, 2012, Oracle and/or its affiliates. All rights reserved.</span><br /> +<a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Legal Notices</span></a></td> +</tr> +</table> +</div> +<!-- class="footer" --> +</body> +</html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference078.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference078.htm new file mode 100644 index 0000000000..e9c475e173 --- /dev/null +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference078.htm @@ -0,0 +1,69 @@ +<!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> +<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> +<meta http-equiv="Content-Style-Type" content="text/css" /> +<meta http-equiv="Content-Script-Type" content="text/javascript" /> +<title>Buttons</title> +<meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> +<meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> +<meta name="date" content="2012-09-19T13:28:2Z" /> +<meta name="robots" content="noarchive" /> +<meta name="doctitle" content="Buttons" /> +<meta name="relnum" content="Release 3.2" /> +<meta name="partnum" content="Release 3.2" /> +<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" /> +</head> +<body> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACDJCEI" name="CACDJCEI"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Buttons</h1> +<p>The following buttons are used throughout the Dali OR Mapping Tool.</p> +<div class="inftblhruleinformal"> +<table class="HRuleInformal" title="This table describes the buttons used in the Dali plug-in." summary="This table describes the buttons used in the Dali plug-in." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="27%" /> +<col width="*" /> +<thead> +<tr align="left" valign="top"> +<th align="left" valign="bottom" id="r1c1-t85">Icon</th> +<th align="left" valign="bottom" id="r1c2-t85">Description</th> +</tr> +</thead> +<tbody> +<tr align="left" valign="top"> +<td align="left" id="r2c1-t85" headers="r1c1-t85"><img src="img/new_jpa_perspective_button.png" alt="The JPA Perspective icon" title="The JPA Perspective icon" /><br /></td> +<td align="left" headers="r2c1-t85 r1c2-t85"> +<p>JPA Development perspective</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblhruleinformal" --> +<a id="sthref688" name="sthref688"></a> +<p class="subhead2">Related concepts</p> +<ul> +<li> +<p><a href="reference076.htm#CACDHCIA">Icons and buttons</a></p> +</li> +</ul> +</div> +<!-- class="sect2" --> +<!-- class="sect1" --> +<!-- Start Footer --> +<div class="footer"> +<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> +<col width="86%" /> +<col width="*" /> +<tr> +<td align="left"><span class="copyrightlogo">Copyright © 2011, 2012, Oracle and/or its affiliates. All rights reserved.</span><br /> +<a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Legal Notices</span></a></td> +</tr> +</table> +</div> +<!-- class="footer" --> +</body> +</html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference079.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference079.htm new file mode 100644 index 0000000000..a133d2b445 --- /dev/null +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference079.htm @@ -0,0 +1,53 @@ +<!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> +<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> +<meta http-equiv="Content-Style-Type" content="text/css" /> +<meta http-equiv="Content-Script-Type" content="text/javascript" /> +<title>Dali Developer Documentation</title> +<meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> +<meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> +<meta name="date" content="2012-09-19T13:28:2Z" /> +<meta name="robots" content="noarchive" /> +<meta name="doctitle" content="Dali Developer Documentation" /> +<meta name="relnum" content="Release 3.2" /> +<meta name="partnum" content="Release 3.2" /> +<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" /> +</head> +<body> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CACBBDIB" name="CACBBDIB"></a></p> +<div class="sect1"><!-- infolevel="all" infotype="General" --> +<h1>Dali Developer Documentation</h1> +<p><a id="sthref689" name="sthref689"></a><a id="sthref690" name="sthref690"></a><a id="sthref691" name="sthref691"></a>Additional Dali documentation is available online at:</p> +<p><code><a href="http://wiki.eclipse.org/index.php/Dali_Developer_Documentation">http://wiki.eclipse.org/index.php/Dali_Developer_Documentation</a></code></p> +<p>This developer documentation includes information about:</p> +<ul> +<li> +<p>Dali architecture</p> +</li> +<li> +<p>Plugins that comprise the Dali JPA Eclipse feature</p> +</li> +<li> +<p>Extension points</p> +</li> +</ul> +</div> +<!-- class="sect1" --> +<!-- Start Footer --> +<div class="footer"> +<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> +<col width="86%" /> +<col width="*" /> +<tr> +<td align="left"><span class="copyrightlogo">Copyright © 2011, 2012, Oracle and/or its affiliates. All rights reserved.</span><br /> +<a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Legal Notices</span></a></td> +</tr> +</table> +</div> +<!-- class="footer" --> +</body> +</html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_add_persistence.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_add_persistence.htm index d29de1ed9a..908a9c3514 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/task_add_persistence.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_add_persistence.htm @@ -8,7 +8,7 @@ <title>Adding persistence to a class</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:37Z" /> +<meta name="date" content="2012-09-19T13:27:55Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Adding persistence to a class" /> <meta name="relnum" content="Release 3.2" /> @@ -17,36 +17,36 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABHICAI" name="BABHICAI"></a></p> <div class="sect1"> <h1>Adding persistence to a class</h1> -<p><a id="sthref64" name="sthref64"></a><a id="sthref65" name="sthref65"></a><a id="sthref66" name="sthref66"></a>You can make a Java class into one of the following persistent types:</p> +<p><a id="sthref76" name="sthref76"></a><a id="sthref77" name="sthref77"></a><a id="sthref78" name="sthref78"></a>You can make a Java class into one of the following persistent types:</p> <ul> <li> -<p><a href="tasks002.htm#BABGBIEE">Entity</a></p> +<p><a href="tasks003.htm#BABGBIEE">Entity</a></p> </li> <li> -<p><a href="tasks003.htm#BABFEICE">Embeddable</a></p> +<p><a href="tasks004.htm#BABFEICE">Embeddable</a></p> </li> <li> -<p><a href="tasks004.htm#BABDAGCI">Mapped superclass</a></p> +<p><a href="tasks005.htm#BABDAGCI">Mapped superclass</a></p> </li> </ul> <p>To add persistence to an existing Java class:</p> <ol> <li> -<p>Right-click the class in the <span class="gui-object-title">Project Explorer</span> and select <span class="gui-object-action">JPA Tools > Make Persistent</span>. The <a href="reference065.htm#CACIBDFB">Make Persistent dialog</a> appears.</p> -<div class="figure"><a id="sthref67" name="sthref67"></a> +<p>Right-click the class in the <span class="gui-object-title">Project Explorer</span> and select <span class="gui-object-action">JPA Tools > Make Persistent</span>. The <a href="reference071.htm#CACIBDFB">Make Persistent dialog</a> appears.</p> +<div class="figure"><a id="sthref79" name="sthref79"></a> <p class="titleinfigure">Make Persistence Dialog</p> <img src="img/make_persistence_dialog.png" alt="" title="" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete the fields on the <a href="reference065.htm#CACIBDFB">Make Persistent dialog</a>, specify the persistence mapping for each class, and click <span class="bold">Finish</span>.</p> +<p>Complete the fields on the <a href="reference071.htm#CACIBDFB">Make Persistent dialog</a>, specify the persistence mapping for each class, and click <span class="bold">Finish</span>.</p> </li> </ol> <p>Dali adds the necessary annotation or entry in the XML mapping file for the class.</p> -<a id="sthref68" name="sthref68"></a> +<a id="sthref80" name="sthref80"></a> <p class="subhead2">Related reference</p> <ul> <li> @@ -59,7 +59,7 @@ <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref69" name="sthref69"></a> +<a id="sthref81" name="sthref81"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_additonal_tables.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_additonal_tables.htm index 6345035291..dd932824f8 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/task_additonal_tables.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_additonal_tables.htm @@ -8,7 +8,7 @@ <title>Specifying additional tables</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:56Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Specifying additional tables" /> <meta name="relnum" content="Release 3.2" /> @@ -17,11 +17,11 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIHGBIEI" name="CIHGBIEI"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1>Specifying additional tables</h1> -<p><a id="sthref140" name="sthref140"></a><a id="sthref141" name="sthref141"></a><a id="sthref142" name="sthref142"></a>Add a secondary table annotation to an entity if its data is split across more than one table.</p> +<p><a id="sthref152" name="sthref152"></a><a id="sthref153" name="sthref153"></a><a id="sthref154" name="sthref154"></a>Add a secondary table annotation to an entity if its data is split across more than one table.</p> <p>To add a secondary table to the entity,</p> <ol> <li> @@ -29,7 +29,7 @@ </li> <li> <p>In the <span class="gui-object-title">JPA Details</span> view, select the <span class="gui-object-action">Secondary Tables</span> information.</p> -<div class="figure"><a id="sthref143" name="sthref143"></a> +<div class="figure"><a id="sthref155" name="sthref155"></a> <p class="titleinfigure">Specifying Secondary Tables</p> <img src="img/secondary_tables.png" alt="Secondary Tables area on the JPA Details view." title="Secondary Tables area on the JPA Details view." /><br /></div> <!-- class="figure" --></li> @@ -57,14 +57,14 @@ @SecondaryTable(name="NAME", catalog = "CATALOG", schema = "SCHEMA", pkJoinColumns = {@PrimaryKeyJoinColumn(name="id", referencedColumnName = "id"),@PrimaryKeyJoinColumn(name="NAME", referencedColumnName = "REFERENCED COLUMN NAME", columnDefinition = "COLUMN DEFINITION")}) </pre></li> </ol> -<a id="sthref144" name="sthref144"></a> +<a id="sthref156" name="sthref156"></a> <p class="subhead2">Related reference</p> <ul> <li> <p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> </ul> -<a id="sthref145" name="sthref145"></a> +<a id="sthref157" name="sthref157"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_create_jpa_entity.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_create_jpa_entity.htm index b71c97ccca..688ef19786 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/task_create_jpa_entity.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_create_jpa_entity.htm @@ -8,7 +8,7 @@ <title>Creating a JPA entity</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:37Z" /> +<meta name="date" content="2012-09-19T13:27:55Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Creating a JPA entity" /> <meta name="relnum" content="Release 3.2" /> @@ -17,15 +17,15 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABFBJBG" name="BABFBJBG"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref53" name="sthref53"></a>Creating a JPA entity</h1> -<p><a id="sthref54" name="sthref54"></a>Use this procedure to create a JPA entity with the <a href="ref_create_jpa_entity_wizard.htm#CIAGGGDF">Create JPA Entity wizard</a>:</p> +<h1><a id="sthref65" name="sthref65"></a>Creating a JPA entity</h1> +<p><a id="sthref66" name="sthref66"></a>Use this procedure to create a JPA entity with the <a href="ref_create_jpa_entity_wizard.htm#CIAGGGDF">Create JPA Entity wizard</a>:</p> <ol> <li> <p>From the Navigator or Project Explorer, select the JPA project and then <span class="bold">File > New > Other</span>. The Select a Wizard dialog appears.</p> -<div class="figure"><a id="sthref55" name="sthref55"></a> +<div class="figure"><a id="sthref67" name="sthref67"></a> <p class="titleinfigure">Selecting the Create a JPA Entity Wizard</p> <img src="img/select_a_wizard_entity.png" alt="The Select a Wizard dialog with Entity selected." title="The Select a Wizard dialog with Entity selected." /><br /></div> <!-- class="figure" --> @@ -46,8 +46,8 @@ </li> <li> <p>Select <span class="bold">JPA > JPA Entity</span> and then click <span class="bold">Next</span>. The <a href="ref_EntityClassPage.htm#CIAFEIGF">Entity Class page</a> appears.</p> -<div class="figure"><a id="sthref56" name="sthref56"></a> -<p class="titleinfigure"><a id="sthref57" name="sthref57"></a>The Entity Class Page</p> +<div class="figure"><a id="sthref68" name="sthref68"></a> +<p class="titleinfigure"><a id="sthref69" name="sthref69"></a>The Entity Class Page</p> <img src="img/create_jpa_entity_wizard.png" alt="The Entity Class page of the Create a JPA Entity wizard." title="The Entity Class page of the Create a JPA Entity wizard." /><br /></div> <!-- class="figure" --> <p>Complete the fields on the <a href="ref_EntityClassPage.htm#CIAFEIGF">Entity Class page</a> as follows:</p> @@ -74,7 +74,7 @@ <p>Accept the <span class="bold">Entity</span> option (the default) to create a Java class with the <code>@Entity</code> option.</p> </li> <li> -<p>Alternatively, select <a href="tasks004.htm#BABDAGCI">Mapped superclass</a> (if you defined a super class).</p> +<p>Alternatively, select <a href="tasks005.htm#BABDAGCI">Mapped superclass</a> (if you defined a super class).</p> </li> <li> <p>Select <span class="bold">Inheritance</span> and then select one of the JSR 220 inheritance mapping strategies (SINGLE_TABLE, TABLE_PER_CLASS, JOINED).</p> @@ -88,8 +88,8 @@ </li> <li> <p>Click <span class="bold">Next</span> to proceed to the <a href="ref_EntityPropertiesPage.htm#CIADECIA">Entity Properties page</a> where you define the persistent fields for the entity.</p> -<div class="figure"><a id="sthref58" name="sthref58"></a> -<p class="titleinfigure"><a id="sthref59" name="sthref59"></a>The Entity Properties Page</p> +<div class="figure"><a id="sthref70" name="sthref70"></a> +<p class="titleinfigure"><a id="sthref71" name="sthref71"></a>The Entity Properties Page</p> <img src="img/create_jpa_fields.png" alt="The Entity Properties page of the Create JPA Entity wizard." title="The Entity Properties page of the Create JPA Entity wizard." /><br /></div> <!-- class="figure" --> <p>Alternatively, click <span class="bold">Finish</span> to complete the entity.</p> @@ -109,7 +109,7 @@ <tr> <td align="left"> <p class="notep1">Note:</p> -<p>The Entity Name-related options are not available if you selected <a href="tasks004.htm#BABDAGCI">Mapped superclass</a> on the <a href="ref_EntityClassPage.htm#CIAFEIGF">Entity Class page</a></p> +<p>The Entity Name-related options are not available if you selected <a href="tasks005.htm#BABDAGCI">Mapped superclass</a> on the <a href="ref_EntityClassPage.htm#CIAFEIGF">Entity Class page</a></p> </td> </tr> </tbody> @@ -119,7 +119,7 @@ </li> <li> <p>Add persistence fields to the entity by clicking <span class="bold">Add</span>. The Entity Fields dialog appears.</p> -<div class="figure"><a id="sthref60" name="sthref60"></a> +<div class="figure"><a id="sthref72" name="sthref72"></a> <p class="titleinfigure">The Entity Fields Dialog</p> <img src="img/jpa_wizard_create_fields.png" alt="The Entity Fields dialog." title="The Entity Fields dialog." /><br /></div> <!-- class="figure" --></li> @@ -141,7 +141,7 @@ <p>Click <span class="bold">Finish</span>. Eclipse adds the entity to your project.</p> </li> </ol> -<a id="sthref61" name="sthref61"></a> +<a id="sthref73" name="sthref73"></a> <p class="subhead2">Related reference</p> <ul> <li> @@ -154,14 +154,14 @@ <p><a href="ref_create_jpa_entity_wizard.htm#CIAGGGDF">Create JPA Entity wizard</a></p> </li> </ul> -<a id="sthref62" name="sthref62"></a> +<a id="sthref74" name="sthref74"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> </ul> -<a id="sthref63" name="sthref63"></a> +<a id="sthref75" name="sthref75"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_create_new_project.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_create_new_project.htm index 812e825ed6..96bc093c7c 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/task_create_new_project.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_create_new_project.htm @@ -8,7 +8,7 @@ <title>Creating a new JPA project</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:37Z" /> +<meta name="date" content="2012-09-19T13:27:54Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Creating a new JPA project" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIHHEJCJ" name="CIHHEJCJ"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1>Creating a new JPA project</h1> @@ -131,7 +131,7 @@ <p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> <li> -<p><a href="tasks001.htm#BEIBADHH">Converting a Java project to a JPA project</a></p> +<p><a href="tasks002.htm#BEIBADHH">Converting a Java project to a JPA project</a></p> </li> </ul> <a id="sthref44" name="sthref44"></a> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_inheritance.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_inheritance.htm index ee33492ef6..01c6bd4007 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/task_inheritance.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_inheritance.htm @@ -8,7 +8,7 @@ <title>Specifying entity inheritance</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:56Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Specifying entity inheritance" /> <meta name="relnum" content="Release 3.2" /> @@ -17,19 +17,19 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIHCCCJD" name="CIHCCCJD"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1>Specifying entity inheritance</h1> -<p><a id="sthref146" name="sthref146"></a><a id="sthref147" name="sthref147"></a>An entity may inherit properties from other entities. You can specify a specific strategy to use for inheritance.</p> +<p><a id="sthref158" name="sthref158"></a><a id="sthref159" name="sthref159"></a>An entity may inherit properties from other entities. You can specify a specific strategy to use for inheritance.</p> <p>Use this procedure to specify inheritance (<code>@Inheritance)</code> for an existing entity (<code>@Entity</code>):</p> <ol> <li> <p>Select the entity in the <span class="gui-object-title">Project Explorer</span>.</p> </li> <li> -<p>In the <span class="gui-object-title">JPA Details</span> view, select the <a href="reference018.htm#CACFHGHE">Inheritance</a> information.</p> -<div class="figure"><a id="sthref148" name="sthref148"></a> +<p>In the <span class="gui-object-title">JPA Details</span> view, select the <a href="reference022.htm#CACFHGHE">Inheritance</a> information.</p> +<div class="figure"><a id="sthref160" name="sthref160"></a> <p class="titleinfigure">Specifying Inheritance</p> <img src="img/inheritance_tab.png" alt="Selecting the Inheritance area on the JPA Details view." title="Selecting the Inheritance area on the JPA Details view." /><br /></div> <!-- class="figure" --></li> @@ -48,8 +48,8 @@ </ul> </li> <li> -<p>Complete the fields in the <a href="reference018.htm#CACFHGHE">Inheritance</a> area.</p> -<p>Use the following table to complete the remaining fields on the tab. See <a href="reference018.htm#CACFHGHE">"Inheritance"</a> for additional details.</p> +<p>Complete the fields in the <a href="reference022.htm#CACFHGHE">Inheritance</a> area.</p> +<p>Use the following table to complete the remaining fields on the tab. See <a href="reference022.htm#CACFHGHE">"Inheritance"</a> for additional details.</p> </li> </ol> <p>Eclipse adds the following annotations the entity field:</p> @@ -62,23 +62,23 @@ referencedColumnName = "<span class="italic"><REFERENCED_COLUMN_NAME></span>") </pre> -<p><a id="sthref149" name="sthref149"></a><a id="sthref150" name="sthref150"></a><a id="sthref151" name="sthref151"></a>The following figures illustrates the different inheritance strategies.</p> -<div class="figure"><a id="sthref152" name="sthref152"></a> +<p><a id="sthref161" name="sthref161"></a><a id="sthref162" name="sthref162"></a><a id="sthref163" name="sthref163"></a>The following figures illustrates the different inheritance strategies.</p> +<div class="figure"><a id="sthref164" name="sthref164"></a> <p class="titleinfigure">Single Table Inheritance</p> <img src="img/inheritance_single.png" alt="This figure illustrates entity inheritance in a single table." title="This figure illustrates entity inheritance in a single table." /><br /></div> <!-- class="figure" --> -<div class="figure"><a id="sthref153" name="sthref153"></a> -<p class="titleinfigure"><a id="sthref154" name="sthref154"></a><a id="sthref155" name="sthref155"></a>Joined Table Inheritance</p> +<div class="figure"><a id="sthref165" name="sthref165"></a> +<p class="titleinfigure"><a id="sthref166" name="sthref166"></a><a id="sthref167" name="sthref167"></a>Joined Table Inheritance</p> <img src="img/inheritance_join.png" alt="This figure illustrates a joined subclass inheritance strategy." title="This figure illustrates a joined subclass inheritance strategy." /><br /></div> <!-- class="figure" --> -<a id="sthref156" name="sthref156"></a> +<a id="sthref168" name="sthref168"></a> <p class="subhead2">Related reference</p> <ul> <li> <p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> </ul> -<a id="sthref157" name="sthref157"></a> +<a id="sthref169" name="sthref169"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_orm.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_orm.htm index b8d404eeac..a510968b4c 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_orm.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_orm.htm @@ -8,7 +8,7 @@ <title>Managing the orm.xml file</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:38Z" /> +<meta name="date" content="2012-09-19T13:27:56Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Managing the orm.xml file" /> <meta name="relnum" content="Release 3.2" /> @@ -17,13 +17,13 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIHDGDCD" name="CIHDGDCD"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref121" name="sthref121"></a>Managing the orm.xml file</h1> +<h1><a id="sthref133" name="sthref133"></a>Managing the orm.xml file</h1> <p>When creating a JPA project, (see <a href="task_create_new_project.htm#CIHHEJCJ">"Creating a new JPA project"</a>) you can also create the <code>orm.xml</code> file that defines the mapping metadata and defaults.</p> -<p><a id="sthref122" name="sthref122"></a>Eclipse creates the <code>META-INF\orm.xml</code> file in your project's directory:</p> -<div class="example"><a id="sthref123" name="sthref123"></a> +<p><a id="sthref134" name="sthref134"></a>Eclipse creates the <code>META-INF\orm.xml</code> file in your project's directory:</p> +<div class="example"><a id="sthref135" name="sthref135"></a> <p class="titleinexample">Sample orm.xml File</p> <pre xml:space="preserve" class="oac_no_warn"> <?xml version="1.0" encoding="UTF-8"?> @@ -38,7 +38,7 @@ </persistence> </pre></div> <!-- class="example" --> -<a id="sthref124" name="sthref124"></a> +<a id="sthref136" name="sthref136"></a> <p class="subhead2">Related reference</p> <ul> <li> @@ -48,17 +48,17 @@ <p><a href="ref_eclipselink_mapping_file.htm#CIAEDEJF">New EclipseLink Mapping File dialog</a></p> </li> </ul> -<a id="sthref125" name="sthref125"></a> +<a id="sthref137" name="sthref137"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="ref_new_jpa_project_wizard.htm#CACBJGBG">Create New JPA Project wizard</a></p> </li> <li> -<p><a href="tasks008.htm#CIHBCDCE">Working with orm.xml file</a></p> +<p><a href="tasks009.htm#CIHBCDCE">Working with orm.xml file</a></p> </li> </ul> -<a id="sthref126" name="sthref126"></a> +<a id="sthref138" name="sthref138"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_persistence.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_persistence.htm index a9b3ed3c38..de53c2c5f7 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_persistence.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_manage_persistence.htm @@ -8,7 +8,7 @@ <title>Managing the persistence.xml file</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:38Z" /> +<meta name="date" content="2012-09-19T13:27:56Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Managing the persistence.xml file" /> <meta name="relnum" content="Release 3.2" /> @@ -17,12 +17,12 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CIHDAJID" name="CIHDAJID"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1><a id="ABC4949575" name="ABC4949575"></a><a id="ABC4949575SRI1" name="ABC4949575SRI1"></a>Managing the persistence.xml file</h1> -<p><a id="sthref97" name="sthref97"></a>When you create a project, Eclipse creates the <code>META-INF\persistence.xml</code> file in the project's directory.</p> -<div class="example"><a id="sthref98" name="sthref98"></a> +<p><a id="sthref109" name="sthref109"></a>When you create a project, Eclipse creates the <code>META-INF\persistence.xml</code> file in the project's directory.</p> +<div class="example"><a id="sthref110" name="sthref110"></a> <p class="titleinexample">Sample persistence.xml File</p> <pre xml:space="preserve" class="oac_no_warn"> <?xml version="1.0" encoding="UTF-8"?> @@ -35,7 +35,7 @@ </pre></div> <!-- class="example" --> <p>You can manage this file either through the XML editor or through the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> -<div class="figure"><a id="sthref99" name="sthref99"></a> +<div class="figure"><a id="sthref111" name="sthref111"></a> <p class="titleinfigure">The persistence.xml Editor</p> <img src="img/persistence_editor_general.png" alt="General tab of persistence.xml editor" title="General tab of persistence.xml editor" /><br /></div> <!-- class="figure" --> @@ -52,32 +52,32 @@ <p><a href="ref_persistence_general.htm#CIACIFGJ">General</a> – Use this page to define the classes, mapping files, and JAR files for the persistence unit.</p> </li> <li> -<p><a href="reference046.htm#CIAFFJIE">Connection</a> – Use this page to define the datasource (JTA and non-JTA elements) for the project.</p> +<p><a href="reference050.htm#CIAFFJIE">Connection</a> – Use this page to define the datasource (JTA and non-JTA elements) for the project.</p> </li> <li> -<p><a href="reference047.htm#CIAJAFEG">Customization</a> – Use this page to define change-tracking and session customizer-related properties.</p> +<p><a href="reference051.htm#CIAJAFEG">Customization</a> – Use this page to define change-tracking and session customizer-related properties.</p> </li> <li> -<p><a href="reference048.htm#CIABEDCH">Caching</a> – Use this page to define caching properties.</p> +<p><a href="reference052.htm#CIABEDCH">Caching</a> – Use this page to define caching properties.</p> </li> <li> -<p><a href="reference049.htm#CIABGHHI">Logging</a> – Use this page to define logging properties.</p> +<p><a href="reference053.htm#CIABGHHI">Logging</a> – Use this page to define logging properties.</p> </li> <li> -<p><a href="reference050.htm#CIAFJCHE">Options</a> – Use this page to define session and target database properties.</p> +<p><a href="reference054.htm#CIAFJCHE">Options</a> – Use this page to define session and target database properties.</p> </li> <li> -<p><a href="reference051.htm#CIACCFCB">Schema Generation</a> – Use this page to define DDL-related properties.</p> +<p><a href="reference055.htm#CIACCFCB">Schema Generation</a> – Use this page to define DDL-related properties.</p> </li> <li> -<p><a href="reference052.htm#CIAHJDFF">Properties</a> – Use to add or remove vender-specific properties.</p> +<p><a href="reference056.htm#CIAHJDFF">Properties</a> – Use to add or remove vender-specific properties.</p> </li> <li> -<p><a href="reference053.htm#CIAHCJAH">Source</a> – Use to view or modify the XML source of the <code>persistence.xml</code> file.</p> +<p><a href="reference057.htm#CIAHCJAH">Source</a> – Use to view or modify the XML source of the <code>persistence.xml</code> file.</p> </li> </ul> <p>For projects using the EclipseLink JPA implementation, the Connections page also includes JDBC connection pool properties.</p> -<p>If the project uses the Generic platform, then only the <a href="ref_persistence_general.htm#CIACIFGJ">General</a>, <a href="reference046.htm#CIAFFJIE">Connection</a>, <a href="reference052.htm#CIAHJDFF">Properties</a> and <a href="reference053.htm#CIAHCJAH">Source</a> pages are available.</p> +<p>If the project uses the Generic platform, then only the <a href="ref_persistence_general.htm#CIACIFGJ">General</a>, <a href="reference050.htm#CIAFFJIE">Connection</a>, <a href="reference056.htm#CIAHJDFF">Properties</a> and <a href="reference057.htm#CIAHCJAH">Source</a> pages are available.</p> </td> </tr> </tbody> @@ -105,7 +105,7 @@ </table> <br /></div> <!-- class="inftblnotealso" --></div> -<div class="figure"><a id="sthref100" name="sthref100"></a> +<div class="figure"><a id="sthref112" name="sthref112"></a> <p class="titleinfigure">General tab of persistence.xml Editor</p> <img src="img/persistence_editor_general.png" alt="General tab of persistence.xml editor" title="General tab of persistence.xml editor" /><br /></div> <!-- class="figure" --></li> @@ -113,7 +113,7 @@ <p>Complete each field on the <a href="ref_persistence_general.htm#CIACIFGJ">General</a> page.</p> </li> <li> -<p>Use the <a href="reference046.htm#CIAFFJIE">Connection</a> page to define the <code><jta-data-source></code> and <code><non-jta-data-source></code> elements as follows:</p> +<p>Use the <a href="reference050.htm#CIAFFJIE">Connection</a> page to define the <code><jta-data-source></code> and <code><non-jta-data-source></code> elements as follows:</p> <p>To configure the JTA (Java Transaction API) source used by the persistence provider:</p> <ol> <li> @@ -146,13 +146,13 @@ <!-- class="inftblnote" --></div> </li> </ol> -<p><a id="sthref101" name="sthref101"></a>For projects using the Generic platform, you can also define the EclipseLink connection pool driver, connection pool driver, URL, user name and password.</p> -<div class="figure"><a id="sthref102" name="sthref102"></a> +<p><a id="sthref113" name="sthref113"></a>For projects using the Generic platform, you can also define the EclipseLink connection pool driver, connection pool driver, URL, user name and password.</p> +<div class="figure"><a id="sthref114" name="sthref114"></a> <p class="titleinfigure">Connection tab of persistence.xml Editor</p> <img src="img/persistence_editor_connection.png" alt="Connection tab of persistence.xml Editor" title="Connection tab of persistence.xml Editor" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete each field on the <a href="reference046.htm#CIAFFJIE">Connection</a> page.</p> +<p>Complete each field on the <a href="reference050.htm#CIAFFJIE">Connection</a> page.</p> </li> <li> <p>Use the table in the Properties page to set the vendor-specific <code><properties></code> element.</p> @@ -180,68 +180,68 @@ </table> <br /></div> <!-- class="inftblnote" --></div> -<div class="figure"><a id="sthref103" name="sthref103"></a> +<div class="figure"><a id="sthref115" name="sthref115"></a> <p class="titleinfigure">Customization tab of persistence.xml Editor</p> <img src="img/persistence_editor_customization.png" alt="Customization tab of persistence.xml Editor" title="Customization tab of persistence.xml Editor" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete each field on the <a href="reference047.htm#CIAJAFEG">Customization</a> page.</p> +<p>Complete each field on the <a href="reference051.htm#CIAJAFEG">Customization</a> page.</p> </li> </ol> <p>Additional pages may be available for the persistence.xml editor, depending on your JPA provider. See <a href="ref_persistence_xmll_editor.htm#CIACCHID">"persistence.xml Editor"</a> for more information.</p> <ul> <li> -<p><a href="reference048.htm#CIABEDCH">Caching</a> page</p> -<div class="figure"><a id="sthref104" name="sthref104"></a> +<p><a href="reference052.htm#CIABEDCH">Caching</a> page</p> +<div class="figure"><a id="sthref116" name="sthref116"></a> <p class="titleinfigure">Caching tab of persistence.xml Editor</p> <img src="img/persistence_editor_caching.png" alt="persistence.xml Editor - Caching tab" title="persistence.xml Editor - Caching tab" /><br /></div> <!-- class="figure" --></li> <li> -<p><a href="reference049.htm#CIABGHHI">Logging</a> page</p> -<div class="figure"><a id="sthref105" name="sthref105"></a> +<p><a href="reference053.htm#CIABGHHI">Logging</a> page</p> +<div class="figure"><a id="sthref117" name="sthref117"></a> <p class="titleinfigure">Logging tab of persistence.xml Editor</p> <img src="img/persistence_editor_logging.png" alt="persistence.xml Editor - Logging tab" title="persistence.xml Editor - Logging tab" /><br /></div> <!-- class="figure" --></li> <li> -<p><a href="reference050.htm#CIAFJCHE">Options</a> page</p> -<div class="figure"><a id="sthref106" name="sthref106"></a> +<p><a href="reference054.htm#CIAFJCHE">Options</a> page</p> +<div class="figure"><a id="sthref118" name="sthref118"></a> <p class="titleinfigure">Options tab of persistence.xml Editor</p> <img src="img/persistence_editor_options.png" alt="persistence.xml Editor - Options tab" title="persistence.xml Editor - Options tab" /><br /></div> <!-- class="figure" --></li> <li> -<p><a href="reference051.htm#CIACCFCB">Schema Generation</a> page</p> -<div class="figure"><a id="sthref107" name="sthref107"></a> +<p><a href="reference055.htm#CIACCFCB">Schema Generation</a> page</p> +<div class="figure"><a id="sthref119" name="sthref119"></a> <p class="titleinfigure">Schema Generation tab of persistence.xml Editor</p> <img src="img/persistence_editor_schemageneration.png" alt="persistence.xml Editor - Schema Generation tab" title="persistence.xml Editor - Schema Generation tab" /><br /></div> <!-- class="figure" --></li> <li> -<p><a href="reference052.htm#CIAHJDFF">Properties</a> page</p> -<div class="figure"><a id="sthref108" name="sthref108"></a> +<p><a href="reference056.htm#CIAHJDFF">Properties</a> page</p> +<div class="figure"><a id="sthref120" name="sthref120"></a> <p class="titleinfigure">Properties tab of persistence.xml Editor</p> <img src="img/persistence_editor_properties.png" alt="persistence.xml Editor - Properties tab" title="persistence.xml Editor - Properties tab" /><br /></div> <!-- class="figure" --></li> <li> -<p><a id="sthref109" name="sthref109"></a><a id="sthref110" name="sthref110"></a><a href="reference053.htm#CIAHCJAH">Source</a> page</p> -<div class="figure"><a id="sthref111" name="sthref111"></a> +<p><a id="sthref121" name="sthref121"></a><a id="sthref122" name="sthref122"></a><a href="reference057.htm#CIAHCJAH">Source</a> page</p> +<div class="figure"><a id="sthref123" name="sthref123"></a> <p class="titleinfigure">Source tab of persistence.xml Editor</p> <img src="img/persistence_editor_source.png" alt="persistence.xml Editor - Source tab" title="persistence.xml Editor - Source tab" /><br /></div> <!-- class="figure" --></li> </ul> -<a id="sthref112" name="sthref112"></a> +<a id="sthref124" name="sthref124"></a> <p class="subhead2">Related reference</p> <ul> <li> <p><a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a></p> </li> </ul> -<a id="sthref113" name="sthref113"></a> +<a id="sthref125" name="sthref125"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="tasks006.htm#CIHFEBAI">Synchronizing classes</a></p> +<p><a href="tasks007.htm#CIHFEBAI">Synchronizing classes</a></p> </li> </ul> -<a id="sthref114" name="sthref114"></a> +<a id="sthref126" name="sthref126"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/task_mapping.htm b/jpa/plugins/org.eclipse.jpt.doc.user/task_mapping.htm index 88090586a0..616726f70e 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/task_mapping.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/task_mapping.htm @@ -8,7 +8,7 @@ <title>Mapping an entity</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Mapping an entity" /> <meta name="relnum" content="Release 3.2" /> @@ -17,44 +17,44 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="BABDGBIJ" name="BABDGBIJ"></a></p> <div class="sect1"> <h1>Mapping an entity</h1> -<p><a id="sthref167" name="sthref167"></a><a id="sthref168" name="sthref168"></a>Dali supports the following mapping types for Java persistent entities:</p> +<p><a id="sthref180" name="sthref180"></a><a id="sthref181" name="sthref181"></a>Dali supports the following mapping types for Java persistent entities:</p> <ul> <li> -<p><a href="tasks010.htm#BABBABCE">Basic mapping</a></p> +<p><a href="tasks011.htm#BABBABCE">Basic mapping</a></p> </li> <li> -<p><a href="tasks011.htm#CIHHJEBJ">Element collection mapping</a></p> +<p><a href="tasks012.htm#CIHHJEBJ">Element collection mapping</a></p> </li> <li> -<p><a href="tasks012.htm#BABCBHDF">Embedded mapping</a></p> +<p><a href="tasks013.htm#BABCBHDF">Embedded mapping</a></p> </li> <li> -<p><a href="tasks013.htm#CIHDIAEE">Embedded ID mapping</a></p> +<p><a href="tasks014.htm#CIHDIAEE">Embedded ID mapping</a></p> </li> <li> -<p><a href="tasks014.htm#BABGCBHG">ID mapping</a></p> +<p><a href="tasks015.htm#BABGCBHG">ID mapping</a></p> </li> <li> -<p><a href="tasks015.htm#BABEIEGD">Many-to-many mapping</a></p> +<p><a href="tasks016.htm#BABEIEGD">Many-to-many mapping</a></p> </li> <li> -<p><a href="tasks016.htm#BABHFAFJ">Many-to-one mapping</a></p> +<p><a href="tasks017.htm#BABHFAFJ">Many-to-one mapping</a></p> </li> <li> -<p><a href="tasks017.htm#BABHGEBD">One-to-many mapping</a></p> +<p><a href="tasks018.htm#BABHGEBD">One-to-many mapping</a></p> </li> <li> -<p><a href="tasks018.htm#BABFHBCJ">One-to-one mapping</a></p> +<p><a href="tasks019.htm#BABFHBCJ">One-to-one mapping</a></p> </li> <li> -<p><a href="tasks019.htm#BABHFHEI">Transient mapping</a></p> +<p><a href="tasks020.htm#BABHFHEI">Transient mapping</a></p> </li> <li> -<p><a href="tasks020.htm#BABHIBII">Version mapping</a></p> +<p><a href="tasks021.htm#BABHIBII">Version mapping</a></p> </li> </ul> <div align="center"> @@ -71,7 +71,7 @@ </table> <br /></div> <!-- class="inftblnote" --></div> -<a id="sthref169" name="sthref169"></a> +<a id="sthref182" name="sthref182"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks.htm index d968da0076..97e0268534 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks.htm @@ -8,7 +8,7 @@ <title>Tasks</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:37Z" /> +<meta name="date" content="2012-09-19T13:27:54Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Tasks" /> <meta name="relnum" content="Release 3.2" /> @@ -18,7 +18,7 @@ </head> <body> <p><a id="sthref33" name="sthref33"></a></p> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <h1>Tasks</h1> <p>This section includes detailed step-by-step procedures for accessing the Dali OR mapping tool functionality.</p> <ul> @@ -26,7 +26,10 @@ <p><a href="task_create_new_project.htm#CIHHEJCJ">Creating a new JPA project</a></p> </li> <li> -<p><a href="tasks001.htm#BEIBADHH">Converting a Java project to a JPA project</a></p> +<p><a href="tasks001.htm#CIHIBIJJ">Creating a new JAXB project</a></p> +</li> +<li> +<p><a href="tasks002.htm#BEIBADHH">Converting a Java project to a JPA project</a></p> </li> <li> <p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> @@ -35,7 +38,7 @@ <p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> <li> -<p><a href="tasks005.htm#CIHIAJHC">Adding virtual attributes</a></p> +<p><a href="tasks006.htm#CIHIAJHC">Adding virtual attributes</a></p> </li> <li> <p><a href="task_manage_persistence.htm#CIHDAJID">Managing the persistence.xml file</a></p> @@ -50,28 +53,28 @@ <p><a href="task_inheritance.htm#CIHCCCJD">Specifying entity inheritance</a></p> </li> <li> -<p><a href="tasks009.htm#BABIGBGG">Creating queries</a></p> +<p><a href="tasks010.htm#BABIGBGG">Creating queries</a></p> </li> <li> <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> <li> -<p><a href="tasks021.htm#BABBAGFI">Generating entities from tables</a></p> +<p><a href="tasks022.htm#BABBAGFI">Generating entities from tables</a></p> </li> <li> -<p><a href="tasks022.htm#CIHJIGBE">Generating tables from entities</a></p> +<p><a href="tasks023.htm#CIHJIGBE">Generating tables from entities</a></p> </li> <li> -<p><a href="tasks023.htm#CIHHFGIG">Generating dynamic entities from tables</a></p> +<p><a href="tasks024.htm#CIHHFGIG">Generating dynamic entities from tables</a></p> </li> <li> -<p><a href="tasks024.htm#BABFAIBA">Validating mappings and reporting problems</a></p> +<p><a href="tasks025.htm#BABFAIBA">Validating mappings and reporting problems</a></p> </li> <li> -<p><a href="tasks027.htm#BABDBCBI">Modifying persistent project properties</a></p> +<p><a href="tasks028.htm#BABDBCBI">Modifying persistent project properties</a></p> </li> <li> -<p><a href="tasks028.htm#CIHEHCHB">Converting JPA metadata to XML</a></p> +<p><a href="tasks029.htm#CIHEHCHB">Converting JPA metadata to XML</a></p> </li> </ul> <!-- Start Footer --> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks001.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks001.htm index 5471a993c7..18cb917d42 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks001.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks001.htm @@ -5,67 +5,116 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Converting a Java project to a JPA project</title> +<title>Creating a new JAXB project</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:37Z" /> +<meta name="date" content="2012-09-19T13:27:54Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Converting a Java project to a JPA project" /> +<meta name="doctitle" content="Creating a new JAXB project" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BEIBADHH" name="BEIBADHH"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIHIBIJJ" name="CIHIBIJJ"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1>Converting a Java project to a JPA project</h1> -<p><a id="sthref45" name="sthref45"></a><a id="sthref46" name="sthref46"></a><a id="sthref47" name="sthref47"></a>Use this procedure to convert an existing Java project to a JPA project.</p> +<h1>Creating a new JAXB project</h1> +<p><a id="sthref45" name="sthref45"></a><a id="sthref46" name="sthref46"></a>Use this procedure to create a new JPA project.</p> <ol> <li> -<p>From the Navigator or Project explorer, right-click the Java project and then select <span class="bold">Configure > Convert to JPA Project.</span> The Project Facets page of the Modify Faceted Project wizard appears.</p> -<div class="figure"><a id="sthref48" name="sthref48"></a> -<p class="titleinfigure">Modify Faceted Project Page</p> -<img src="img/modify_faceted_project.png" alt="" title="" /><br /></div> +<p>From the Navigator or Project Explorer, select <span class="bold">File > New > Project</span>. The Select a wizard dialog appears.</p> +<div align="center"> +<div class="inftblnotealso"><br /> +<table class="NoteAlso oac_no_warn" summary="" cellpadding="3" cellspacing="0"> +<tbody> +<tr> +<td align="left"> +<p class="notep1">Tip:</p> +<p>You can also select the JPA perspective and then select <span class="bold">File > New > JAXB Project</span>.</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblnotealso" --></div> +<div class="figure"><a id="sthref47" name="sthref47"></a> +<p class="titleinfigure"><a id="sthref48" name="sthref48"></a>Selecting the Create a JAXB Project wizard</p> +<img src="img/select_a_wizard_jaxb_project.png" alt="The Select a Wizard dialog with JPA project selected." title="The Select a Wizard dialog with JPA project selected." /><br /></div> <!-- class="figure" --></li> <li> -<p>Change the <span class="bold">Configuration</span> to <span class="bold">Default JPA Configuration</span>.</p> +<p>Select <span class="bold">JAXB Project</span> and then click <span class="bold">Next</span>. The <a href="reference011.htm#CACHFJFI">New JAXB Project page</a> appears.</p> +<div class="figure"><a id="sthref49" name="sthref49"></a> +<p class="titleinfigure"><a id="sthref50" name="sthref50"></a>The JAXB Project Page</p> +<img src="img/new_jaxb_project_task.png" alt="The JPA Project page of the Create a JPA Project wizard." title="The JPA Project page of the Create a JPA Project wizard." /><br /></div> +<!-- class="figure" --></li> +<li> +<p>Complete the fields on the <a href="reference011.htm#CACHFJFI">New JAXB Project page</a> to specify the project name and location, target runtime, and pre-defined configuration.</p> +<div align="center"> +<div class="inftblnote"><br /> +<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> +<tbody> +<tr> +<td align="left"> +<p class="notep1">Note:</p> +<p>The Target Runtime is not required for Java SE development.</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblnote" --></div> </li> <li> -<p>Click <span class="bold">Next</span>. The Java source page appears (see <a href="task_create_new_project.htm#CIHIFEGJ">Figure: The Java Source Page</a>).</p> +<p>Click <span class="bold">Next</span>. The Java source page appears.</p> +<div class="figure"><a id="sthref51" name="sthref51"></a> +<p class="titleinfigure">The Java Source Page</p> +<img src="img/new_jpa_project_source.png" alt="The JPA Facet page of the Create a JPA Project wizard." title="The JPA Facet page of the Create a JPA Project wizard." /><br /></div> +<!-- class="figure" --></li> +<li> +<p>Click <span class="bold">Add Folder</span> to add existing Java source files to the project.</p> </li> <li> -<p>Click <span class="bold">Add Folder</span> to add existing Java source files to the project and click <span class="bold">Next</span>. The <a href="ref_jpa_facet.htm#CACIFDIF">JPA Facet page</a> appears.</p> -<div class="figure"><a id="sthref49" name="sthref49"></a> -<p class="titleinfigure">JPA Facet Page</p> -<img src="img/new_jpa_facet_task.png" alt="" title="" /><br /></div> +<p>Click <span class="bold">Next</span>. <a href="reference013.htm#CACJGDEF">JAXB Facet page</a> appears.</p> +<div class="figure"><a id="sthref52" name="sthref52"></a> +<p class="titleinfigure"><a id="sthref53" name="sthref53"></a>The JAXB Facet Page</p> +<img src="img/new_jaxb_facet_task.png" alt="The JPA Facet page of the Create a JPA Project wizard." title="The JPA Facet page of the Create a JPA Project wizard." /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete the fields on the <a href="ref_jpa_facet.htm#CACIFDIF">JPA Facet page</a> to specify your vender-specific platform, JPA implementation library, and database connection.</p> +<p>Complete the fields on the <a href="reference013.htm#CACJGDEF">JAXB Facet page</a> to specify your vender-specific platform, JPA implementation library, and database connection.</p> <p>Click <span class="bold">Manage libraries</span> to create or update your JPA user libraries. Click <span class="bold">Download libraries</span> to obtain additional JPA implementation libraries.</p> -<p>If Dali derives the incorrect schema, select <span class="bold">Override the Default Schema for Connection</span>. Using this option, you can select a development time schema for defaults and validation.</p> -<p>If you clear the <span class="bold">Create mapping file (orm.xml)</span> option (which is selected by default), you can later add a mapping file to the project using the <a href="reference007.htm#CIAIJCCE">Create ORM Mapping File wizard</a>.</p> +<div align="center"> +<div class="inftblnote"><br /> +<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> +<tbody> +<tr> +<td align="left"> +<p class="notep1">Note:</p> +<p>Depending on your JAXB implementation (for example, Generic or EclipseLink), different options may be available when creating JAXB projects.</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblnote" --></div> </li> <li> -<p>Click <span class="bold">Finish</span>.</p> +<p>Click <span class="bold">Finish</span>. Dali creates the new JAXB project.</p> +<p>You should now open the <a href="ref_persistence_perspective.htm#BABIFBDB">JPA Development perspective</a>.</p> </li> </ol> -<p>The Dali OR Mapping Tool adds the JPA implementation libraries to your project and creates the necessary <code>orm.xml</code> and <code>perisistence.xml</code> files.</p> -<a id="sthref50" name="sthref50"></a> +<a id="sthref54" name="sthref54"></a> <p class="subhead2">Related reference</p> <ul> <li> -<p><a href="ref_new_jpa_project_wizard.htm#CACBJGBG">Create New JPA Project wizard</a></p> +<p><a href="reference010.htm#CACIEJDJ">Create New JAXB Project wizard</a></p> </li> <li> <p><a href="ref_persistence_perspective.htm#BABIFBDB">JPA Development perspective</a></p> </li> -<li> -<p><a href="reference007.htm#CIAIJCCE">Create ORM Mapping File wizard</a></p> -</li> </ul> -<a id="sthref51" name="sthref51"></a> +<a id="sthref55" name="sthref55"></a> <p class="subhead2">Related tasks</p> <ul> <li> @@ -75,10 +124,10 @@ <p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> <li> -<p><a href="task_create_new_project.htm#CIHHEJCJ">Creating a new JPA project</a></p> +<p><a href="tasks002.htm#BEIBADHH">Converting a Java project to a JPA project</a></p> </li> </ul> -<a id="sthref52" name="sthref52"></a> +<a id="sthref56" name="sthref56"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks002.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks002.htm index 1592819c48..58c23c8257 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks002.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks002.htm @@ -5,90 +5,91 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Entity</title> +<title>Converting a Java project to a JPA project</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:37Z" /> +<meta name="date" content="2012-09-19T13:27:55Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Entity" /> +<meta name="doctitle" content="Converting a Java project to a JPA project" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABGBIEE" name="BABGBIEE"></a></p> -<div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Entity</h1> -<p><a id="sthref70" name="sthref70"></a><a id="sthref71" name="sthref71"></a><a id="sthref72" name="sthref72"></a><a id="sthref73" name="sthref73"></a>An <span class="bold">Entity</span> is a persistent domain object.</p> -<p>An entity <span class="italic">can be</span>:</p> -<ul> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BEIBADHH" name="BEIBADHH"></a></p> +<div class="sect1"><!-- infolevel="all" infotype="General" --> +<h1>Converting a Java project to a JPA project</h1> +<p><a id="sthref57" name="sthref57"></a><a id="sthref58" name="sthref58"></a><a id="sthref59" name="sthref59"></a>Use this procedure to convert an existing Java project to a JPA project.</p> +<ol> +<li> +<p>From the Navigator or Project explorer, right-click the Java project and then select <span class="bold">Configure > Convert to JPA Project.</span> The Project Facets page of the Modify Faceted Project wizard appears.</p> +<div class="figure"><a id="sthref60" name="sthref60"></a> +<p class="titleinfigure">Modify Faceted Project Page</p> +<img src="img/modify_faceted_project.png" alt="" title="" /><br /></div> +<!-- class="figure" --></li> <li> -<p>Abstract or concrete classes. Entities may also extend non-entity classes as well as entity classes, and non-entity classes may extend entity classes.</p> +<p>Change the <span class="bold">Configuration</span> to <span class="bold">Default JPA Configuration</span>.</p> </li> -</ul> -<p>An entity <span class="italic">must have</span>:</p> -<ul> <li> -<p>A no-arg constructor (public or protected); the entity class may have other constructors as well.</p> +<p>Click <span class="bold">Next</span>. The Java source page appears (see <a href="task_create_new_project.htm#CIHIFEGJ">Figure: The Java Source Page</a>).</p> </li> -</ul> -<p><a id="sthref74" name="sthref74"></a><a id="sthref75" name="sthref75"></a><a id="sthref76" name="sthref76"></a>Each persistent entity must be mapped to a database table and contain a primary key. Persistent entities are identified by the <code>@Entity</code> annotation.</p> -<p>Use this procedure to add persistence to an existing entity:</p> -<ol> <li> -<p>Open the Java class in the <span class="gui-object-title">Project Explorer.</span></p> +<p>Click <span class="bold">Add Folder</span> to add existing Java source files to the project and click <span class="bold">Next</span>. The <a href="ref_jpa_facet.htm#CACIFDIF">JPA Facet page</a> appears.</p> +<div class="figure"><a id="sthref61" name="sthref61"></a> +<p class="titleinfigure">JPA Facet Page</p> +<img src="img/new_jpa_facet_task.png" alt="" title="" /><br /></div> +<!-- class="figure" --></li> +<li> +<p>Complete the fields on the <a href="ref_jpa_facet.htm#CACIFDIF">JPA Facet page</a> to specify your vender-specific platform, JPA implementation library, and database connection.</p> +<p>Click <span class="bold">Manage libraries</span> to create or update your JPA user libraries. Click <span class="bold">Download libraries</span> to obtain additional JPA implementation libraries.</p> +<p>If Dali derives the incorrect schema, select <span class="bold">Override the Default Schema for Connection</span>. Using this option, you can select a development time schema for defaults and validation.</p> +<p>If you clear the <span class="bold">Create mapping file (orm.xml)</span> option (which is selected by default), you can later add a mapping file to the project using the <a href="reference007.htm#CIAIJCCE">Create ORM Mapping File wizard</a>.</p> </li> <li> -<p>Select the class in the JPA Structure view.</p> +<p>Click <span class="bold">Finish</span>.</p> </li> +</ol> +<p>The Dali OR Mapping Tool adds the JPA implementation libraries to your project and creates the necessary <code>orm.xml</code> and <code>perisistence.xml</code> files.</p> +<a id="sthref62" name="sthref62"></a> +<p class="subhead2">Related reference</p> +<ul> <li> -<p>In the JPA Details view, click the mapping type hyperlink to access the <a href="reference063.htm#CACFEGAG">Mapping Type Selection dialog</a>. In the following figure, clicking <span class="italic">entity</span> invokes the dialog from the JPA Details View.</p> -<div class="figure"><a id="sthref77" name="sthref77"></a> -<p class="titleinfigure">The Mapping Type Hyperlink</p> -<img src="img/mapped_entity_type_link.png" alt="The JPA Details view for an entity showing the mapping type hyperlink." title="The JPA Details view for an entity showing the mapping type hyperlink." /><br /></div> -<!-- class="figure" --> -<div align="center"> -<div class="inftblnotealso"><br /> -<table class="NoteAlso oac_no_warn" summary="" cellpadding="3" cellspacing="0"> -<tbody> -<tr> -<td align="left"> -<p class="notep1">Tip:</p> -<p>You can also change (or add) persistence for an entity by right-clicking the class in the JPA Structure View and then clicking <span class="bold">Map As > Entity</span>.</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblnotealso" --></div> +<p><a href="ref_new_jpa_project_wizard.htm#CACBJGBG">Create New JPA Project wizard</a></p> </li> <li> -<p>Select <span class="bold">Entity</span> from the <a href="reference063.htm#CACFEGAG">Mapping Type Selection dialog</a> and then click <span class="bold">OK</span>.</p> -<div class="figure"><a id="sthref78" name="sthref78"></a> -<p class="titleinfigure">The Mapping Type Selection Dialog</p> -<img src="img/mapping_type_selection_entity.png" alt="The Mapping Type selection dialog with Enity selected." title="The Mapping Type selection dialog with Enity selected." /><br /></div> -<!-- class="figure" --></li> +<p><a href="ref_persistence_perspective.htm#BABIFBDB">JPA Development perspective</a></p> +</li> <li> -<p>Complete the remaining <a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a>.</p> +<p><a href="reference007.htm#CIAIJCCE">Create ORM Mapping File wizard</a></p> </li> -</ol> -<a id="sthref79" name="sthref79"></a> -<p class="subhead2">Related reference</p> +</ul> +<a id="sthref63" name="sthref63"></a> +<p class="subhead2">Related tasks</p> <ul> <li> +<p><a href="task_manage_persistence.htm#CIHDAJID">Managing the persistence.xml file</a></p> +</li> +<li> <p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> </li> <li> -<p><a href="task_additonal_tables.htm#CIHGBIEI">Specifying additional tables</a></p> +<p><a href="task_create_new_project.htm#CIHHEJCJ">Creating a new JPA project</a></p> +</li> +</ul> +<a id="sthref64" name="sthref64"></a> +<p class="subhead2">Related concepts</p> +<ul> +<li> +<p><a href="concept_persistence.htm#BABCAHIC">Understanding Java persistence</a></p> </li> <li> -<p><a href="task_inheritance.htm#CIHCCCJD">Specifying entity inheritance</a></p> +<p><a href="concepts002.htm#CHDHAGIH">The persistence.xml file</a></p> </li> </ul> </div> -<!-- class="sect2" --> +<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks003.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks003.htm index 32f89d5a5c..e3ca33c82d 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks003.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks003.htm @@ -5,47 +5,76 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Embeddable</title> +<title>Entity</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:37Z" /> +<meta name="date" content="2012-09-19T13:27:55Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Embeddable" /> +<meta name="doctitle" content="Entity" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABFEICE" name="BABFEICE"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABGBIEE" name="BABGBIEE"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Embeddable</h1> -<p><a id="sthref80" name="sthref80"></a><a id="sthref81" name="sthref81"></a>An <span class="bold">Embedded</span> class is a class whose instances are stored as part of an owning entity; it shares the identity of the owning entity. Each field of the embedded class is mapped to the database table associated with the owning entity.</p> -<p>To override the mapping information for a specific subclass, use the <code>@AttributeOverride</code> annotation for that specific class.</p> -<p><a id="sthref82" name="sthref82"></a><a id="sthref83" name="sthref83"></a><a id="sthref84" name="sthref84"></a>An embeddable entity is identified by the <code>@Embeddable</code> annotation.</p> -<p>Use this procedure to add embeddable persistence to an existing entity:</p> +<h1>Entity</h1> +<p><a id="sthref82" name="sthref82"></a><a id="sthref83" name="sthref83"></a><a id="sthref84" name="sthref84"></a><a id="sthref85" name="sthref85"></a>An <span class="bold">Entity</span> is a persistent domain object.</p> +<p>An entity <span class="italic">can be</span>:</p> +<ul> +<li> +<p>Abstract or concrete classes. Entities may also extend non-entity classes as well as entity classes, and non-entity classes may extend entity classes.</p> +</li> +</ul> +<p>An entity <span class="italic">must have</span>:</p> +<ul> +<li> +<p>A no-arg constructor (public or protected); the entity class may have other constructors as well.</p> +</li> +</ul> +<p><a id="sthref86" name="sthref86"></a><a id="sthref87" name="sthref87"></a><a id="sthref88" name="sthref88"></a>Each persistent entity must be mapped to a database table and contain a primary key. Persistent entities are identified by the <code>@Entity</code> annotation.</p> +<p>Use this procedure to add persistence to an existing entity:</p> <ol> <li> -<p>Open the Java class in the <span class="gui-object-title">Project Explorer</span>.</p> +<p>Open the Java class in the <span class="gui-object-title">Project Explorer.</span></p> </li> <li> <p>Select the class in the JPA Structure view.</p> </li> <li> -<p>Click the mapping type hyperlink to open the <a href="reference063.htm#CACFEGAG">Mapping Type Selection dialog</a>.</p> +<p>In the JPA Details view, click the mapping type hyperlink to access the <a href="reference069.htm#CACFEGAG">Mapping Type Selection dialog</a>. In the following figure, clicking <span class="italic">entity</span> invokes the dialog from the JPA Details View.</p> +<div class="figure"><a id="sthref89" name="sthref89"></a> +<p class="titleinfigure">The Mapping Type Hyperlink</p> +<img src="img/mapped_entity_type_link.png" alt="The JPA Details view for an entity showing the mapping type hyperlink." title="The JPA Details view for an entity showing the mapping type hyperlink." /><br /></div> +<!-- class="figure" --> +<div align="center"> +<div class="inftblnotealso"><br /> +<table class="NoteAlso oac_no_warn" summary="" cellpadding="3" cellspacing="0"> +<tbody> +<tr> +<td align="left"> +<p class="notep1">Tip:</p> +<p>You can also change (or add) persistence for an entity by right-clicking the class in the JPA Structure View and then clicking <span class="bold">Map As > Entity</span>.</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblnotealso" --></div> </li> <li> -<p>Select <span class="bold">Embeddable</span> and then click <span class="bold">OK</span>.</p> -<div class="figure"><a id="sthref85" name="sthref85"></a> -<p class="titleinfigure">Mapping Type Selection Dialog (Embeddable)</p> -<img src="img/mapping_type_selection_embed.png" alt="The Mapping Type Selection dialog with Embeddable selected." title="The Mapping Type Selection dialog with Embeddable selected." /><br /></div> +<p>Select <span class="bold">Entity</span> from the <a href="reference069.htm#CACFEGAG">Mapping Type Selection dialog</a> and then click <span class="bold">OK</span>.</p> +<div class="figure"><a id="sthref90" name="sthref90"></a> +<p class="titleinfigure">The Mapping Type Selection Dialog</p> +<img src="img/mapping_type_selection_entity.png" alt="The Mapping Type selection dialog with Enity selected." title="The Mapping Type selection dialog with Enity selected." /><br /></div> <!-- class="figure" --></li> <li> <p>Complete the remaining <a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a>.</p> </li> </ol> -<a id="sthref86" name="sthref86"></a> +<a id="sthref91" name="sthref91"></a> <p class="subhead2">Related reference</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks004.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks004.htm index 424ee202b6..5f470264af 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks004.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks004.htm @@ -5,41 +5,26 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Mapped superclass</title> +<title>Embeddable</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:38Z" /> +<meta name="date" content="2012-09-19T13:27:56Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Mapped superclass" /> +<meta name="doctitle" content="Embeddable" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABDAGCI" name="BABDAGCI"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABFEICE" name="BABFEICE"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Mapped superclass</h1> -<p><a id="sthref87" name="sthref87"></a><a id="sthref88" name="sthref88"></a>An entity that extends a <span class="bold">Mapped Superclass</span> class inherits the persistent state and mapping information from a superclass. You should use a mapped superclass to define mapping information that is common to multiple entity classes.</p> -<p>A mapped superclass <span class="italic">can be</span>:</p> -<ul> -<li> -<p>Abstract or concrete classes</p> -</li> -</ul> -<p>A mapped superclass <span class="italic">cannot be</span>:</p> -<ul> -<li> -<p>Be queried or passed as an argument to Entity-Manager or Query operations</p> -</li> -<li> -<p>Be the target of a persistent relationship</p> -</li> -</ul> -<p>A mapped superclass does not have a defined database table. Instead, its mapping information is derived from its superclass. To override the mapping information for a specific subclass, use the <code>@AttributeOverride</code> annotation for that specific class.</p> -<p><a id="sthref89" name="sthref89"></a><a id="sthref90" name="sthref90"></a><a id="sthref91" name="sthref91"></a><a id="sthref92" name="sthref92"></a>A mapped superclass is identified by the <code>@MappedSuperclass</code> annotation.</p> -<p>Use this procedure to add Mapped Superclass persistence to an existing entity:</p> +<h1>Embeddable</h1> +<p><a id="sthref92" name="sthref92"></a><a id="sthref93" name="sthref93"></a>An <span class="bold">Embedded</span> class is a class whose instances are stored as part of an owning entity; it shares the identity of the owning entity. Each field of the embedded class is mapped to the database table associated with the owning entity.</p> +<p>To override the mapping information for a specific subclass, use the <code>@AttributeOverride</code> annotation for that specific class.</p> +<p><a id="sthref94" name="sthref94"></a><a id="sthref95" name="sthref95"></a><a id="sthref96" name="sthref96"></a>An embeddable entity is identified by the <code>@Embeddable</code> annotation.</p> +<p>Use this procedure to add embeddable persistence to an existing entity:</p> <ol> <li> <p>Open the Java class in the <span class="gui-object-title">Project Explorer</span>.</p> @@ -48,19 +33,19 @@ <p>Select the class in the JPA Structure view.</p> </li> <li> -<p>In the JPA Details view, click the mapping type hyperlink to open the <a href="reference063.htm#CACFEGAG">Mapping Type Selection dialog</a>.</p> +<p>Click the mapping type hyperlink to open the <a href="reference069.htm#CACFEGAG">Mapping Type Selection dialog</a>.</p> </li> <li> -<p>Select <span class="bold">Mapped Superclass</span> and then <span class="bold">OK</span>.</p> -<div class="figure"><a id="sthref93" name="sthref93"></a> -<p class="titleinfigure">Mapping Type Selection Dialog (Mapped Superclass)</p> -<img src="img/mapping_type_selection_superclass.png" alt="The Mapping Type Selection dialog with Mapped Superclass selected." title="The Mapping Type Selection dialog with Mapped Superclass selected." /><br /></div> +<p>Select <span class="bold">Embeddable</span> and then click <span class="bold">OK</span>.</p> +<div class="figure"><a id="sthref97" name="sthref97"></a> +<p class="titleinfigure">Mapping Type Selection Dialog (Embeddable)</p> +<img src="img/mapping_type_selection_embed.png" alt="The Mapping Type Selection dialog with Embeddable selected." title="The Mapping Type Selection dialog with Embeddable selected." /><br /></div> <!-- class="figure" --></li> <li> <p>Complete the remaining <a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a>.</p> </li> </ol> -<a id="sthref94" name="sthref94"></a> +<a id="sthref98" name="sthref98"></a> <p class="subhead2">Related reference</p> <ul> <li> @@ -75,7 +60,6 @@ </ul> </div> <!-- class="sect2" --> -<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks005.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks005.htm index e7085e28e9..f4f9c89872 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks005.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks005.htm @@ -5,23 +5,76 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Adding virtual attributes</title> +<title>Mapped superclass</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:38Z" /> +<meta name="date" content="2012-09-19T13:27:56Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Adding virtual attributes" /> +<meta name="doctitle" content="Mapped superclass" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIHIAJHC" name="CIHIAJHC"></a></p> -<div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref95" name="sthref95"></a><a id="sthref96" name="sthref96"></a>Adding virtual attributes</h1> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABDAGCI" name="BABDAGCI"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Mapped superclass</h1> +<p><a id="sthref99" name="sthref99"></a><a id="sthref100" name="sthref100"></a>An entity that extends a <span class="bold">Mapped Superclass</span> class inherits the persistent state and mapping information from a superclass. You should use a mapped superclass to define mapping information that is common to multiple entity classes.</p> +<p>A mapped superclass <span class="italic">can be</span>:</p> +<ul> +<li> +<p>Abstract or concrete classes</p> +</li> +</ul> +<p>A mapped superclass <span class="italic">cannot be</span>:</p> +<ul> +<li> +<p>Be queried or passed as an argument to Entity-Manager or Query operations</p> +</li> +<li> +<p>Be the target of a persistent relationship</p> +</li> +</ul> +<p>A mapped superclass does not have a defined database table. Instead, its mapping information is derived from its superclass. To override the mapping information for a specific subclass, use the <code>@AttributeOverride</code> annotation for that specific class.</p> +<p><a id="sthref101" name="sthref101"></a><a id="sthref102" name="sthref102"></a><a id="sthref103" name="sthref103"></a><a id="sthref104" name="sthref104"></a>A mapped superclass is identified by the <code>@MappedSuperclass</code> annotation.</p> +<p>Use this procedure to add Mapped Superclass persistence to an existing entity:</p> +<ol> +<li> +<p>Open the Java class in the <span class="gui-object-title">Project Explorer</span>.</p> +</li> +<li> +<p>Select the class in the JPA Structure view.</p> +</li> +<li> +<p>In the JPA Details view, click the mapping type hyperlink to open the <a href="reference069.htm#CACFEGAG">Mapping Type Selection dialog</a>.</p> +</li> +<li> +<p>Select <span class="bold">Mapped Superclass</span> and then <span class="bold">OK</span>.</p> +<div class="figure"><a id="sthref105" name="sthref105"></a> +<p class="titleinfigure">Mapping Type Selection Dialog (Mapped Superclass)</p> +<img src="img/mapping_type_selection_superclass.png" alt="The Mapping Type Selection dialog with Mapped Superclass selected." title="The Mapping Type Selection dialog with Mapped Superclass selected." /><br /></div> +<!-- class="figure" --></li> +<li> +<p>Complete the remaining <a href="ref_persistence_prop_view.htm#BABFAEBB">JPA Details view (for entities)</a>.</p> +</li> +</ol> +<a id="sthref106" name="sthref106"></a> +<p class="subhead2">Related reference</p> +<ul> +<li> +<p><a href="task_add_persistence.htm#BABHICAI">Adding persistence to a class</a></p> +</li> +<li> +<p><a href="task_additonal_tables.htm#CIHGBIEI">Specifying additional tables</a></p> +</li> +<li> +<p><a href="task_inheritance.htm#CIHCCCJD">Specifying entity inheritance</a></p> +</li> +</ul> </div> +<!-- class="sect2" --> <!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks006.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks006.htm index 0e624356c4..a365d56567 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks006.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks006.htm @@ -5,67 +5,23 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Synchronizing classes</title> +<title>Adding virtual attributes</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:38Z" /> +<meta name="date" content="2012-09-19T13:27:56Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Synchronizing classes" /> +<meta name="doctitle" content="Adding virtual attributes" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIHFEBAI" name="CIHFEBAI"></a></p> -<div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Synchronizing classes</h1> -<p>As you work with the classes in your Java project, you will need to update the <code>persistence.xml</code> file to reflect the changes. <a id="sthref115" name="sthref115"></a><a id="sthref116" name="sthref116"></a><a id="sthref117" name="sthref117"></a></p> -<p>Use this procedure to synchronize the <code>persistence.xml</code> file:</p> -<ol> -<li> -<p>Right-click the <code>persistence.xml</code> file in the <span class="gui-object-title">Project Explorer</span> and select <span class="gui-object-action">JPA Tools > Synchronize Class List</span>.</p> -<div align="center"> -<div class="inftblnote"><br /> -<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> -<tbody> -<tr> -<td align="left"> -<p class="notep1">Note:</p> -<p>Use this function if you selected <span class="bold">Annotated classes must be listed in the persistence.xml option</span> in the <a href="ref_jpa_facet.htm#CACIFDIF">JPA Facet page</a>. In general, you do not have to use this function within the container.</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblnote" --></div> -<div class="figure"><a id="sthref118" name="sthref118"></a> -<p class="titleinfigure">Synchronizing the persistence.xml File</p> -<img src="img/synchornize_classes.png" alt="This figure shows the JPA Tools > Synchronize Classes option." title="This figure shows the JPA Tools > Synchronize Classes option." /><br /></div> -<!-- class="figure" --> -<p>Dali adds the necessary <code><class></code> elements to the <code>persistence.xml</code> file.</p> -</li> -<li> -<p>Use the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a> to continue editing the <code>persistence.xml</code> file.</p> -</li> -</ol> -<a id="sthref119" name="sthref119"></a> -<p class="subhead2">Related reference</p> -<ul> -<li> -<p><a href="task_manage_persistence.htm#CIHDAJID">Managing the persistence.xml file</a></p> -</li> -</ul> -<a id="sthref120" name="sthref120"></a> -<p class="subhead2">Related concepts</p> -<ul> -<li> -<p><a href="concepts002.htm#CHDHAGIH">The persistence.xml file</a></p> -</li> -</ul> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIHIAJHC" name="CIHIAJHC"></a></p> +<div class="sect1"><!-- infolevel="all" infotype="General" --> +<h1><a id="sthref107" name="sthref107"></a><a id="sthref108" name="sthref108"></a>Adding virtual attributes</h1> </div> -<!-- class="sect2" --> <!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks007.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks007.htm index 377e34562c..98922d3de7 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks007.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks007.htm @@ -5,77 +5,68 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Creating an orm.xml file</title> +<title>Synchronizing classes</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:38Z" /> +<meta name="date" content="2012-09-19T13:27:56Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Creating an orm.xml file" /> +<meta name="doctitle" content="Synchronizing classes" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIHDEFCA" name="CIHDEFCA"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIHFEBAI" name="CIHFEBAI"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Creating an orm.xml file</h1> -<p><a id="sthref127" name="sthref127"></a>If you opt not to create an <code>orm.xml</code> file when you create a JPA project, you can create one using the <a href="reference007.htm#CIAIJCCE">Create ORM Mapping File wizard</a>.</p> -<p>Use this procedure to create an <code>orm.xml</code> file:</p> +<h1>Synchronizing classes</h1> +<p>As you work with the classes in your Java project, you will need to update the <code>persistence.xml</code> file to reflect the changes. <a id="sthref127" name="sthref127"></a><a id="sthref128" name="sthref128"></a><a id="sthref129" name="sthref129"></a></p> +<p>Use this procedure to synchronize the <code>persistence.xml</code> file:</p> <ol> <li> -<p>From the Navigator or Project Explorer, select <span class="bold">File > New > Other</span>. The Select a Wizard dialog appears.</p> -<div class="figure"><a id="sthref128" name="sthref128"></a> -<p class="titleinfigure">The Select a Wizard Dialog</p> -<img src="img/select_a_wizard_mapping.png" alt="The Select a Wizard dialog with Mapping file selected." title="The Select a Wizard dialog with Mapping file selected." /><br /></div> -<!-- class="figure" --></li> -<li> -<p>Select <span class="bold">JPA ORM Mapping File</span> and then click <span class="bold">Next</span>. The Mapping File page of the <a href="reference007.htm#CIAIJCCE">Create ORM Mapping File wizard</a> appears.</p> -<p>If you are using EclipseLink, you can select <span class="bold">EclipseLink > EclipseLink ORM Mapping File</span>.</p> -<div class="figure"><a id="sthref129" name="sthref129"></a> -<p class="titleinfigure">New Mapping File Location Page</p> -<img src="img/mapping_file_new.png" alt="The Mapping File page." title="The Mapping File page." /><br /></div> -<!-- class="figure" --></li> -<li> -<p>Select the name and location of your mapping file and click <span class="bold">Next</span>. The <a href="reference009.htm#CACDFCDB">Mapping File Options</a> page appears.</p> +<p>Right-click the <code>persistence.xml</code> file in the <span class="gui-object-title">Project Explorer</span> and select <span class="gui-object-action">JPA Tools > Synchronize Class List</span>.</p> +<div align="center"> +<div class="inftblnote"><br /> +<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> +<tbody> +<tr> +<td align="left"> +<p class="notep1">Note:</p> +<p>Use this function if you selected <span class="bold">Annotated classes must be listed in the persistence.xml option</span> in the <a href="ref_jpa_facet.htm#CACIFDIF">JPA Facet page</a>. In general, you do not have to use this function within the container.</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblnote" --></div> <div class="figure"><a id="sthref130" name="sthref130"></a> -<p class="titleinfigure">New Mapping File Options Page</p> -<img src="img/new_mapping_file_options.png" alt="New Mapping File Options Page" title="New Mapping File Options Page" /><br /></div> -<!-- class="figure" --></li> +<p class="titleinfigure">Synchronizing the persistence.xml File</p> +<img src="img/synchornize_classes.png" alt="This figure shows the JPA Tools > Synchronize Classes option." title="This figure shows the JPA Tools > Synchronize Classes option." /><br /></div> +<!-- class="figure" --> +<p>Dali adds the necessary <code><class></code> elements to the <code>persistence.xml</code> file.</p> +</li> <li> -<p>Define the properties in the <a href="reference009.htm#CACDFCDB">Mapping File Options</a> page and click <span class="bold">Finish</span>. The <code>orm.xml</code> file appears in the <code>src</code> directory of the selected JPA project. You can manage the <code>orm.xml</code> file using the JPA Details view or through the XML Editor. See also <a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a>.</p> +<p>Use the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a> to continue editing the <code>persistence.xml</code> file.</p> </li> </ol> <a id="sthref131" name="sthref131"></a> <p class="subhead2">Related reference</p> <ul> <li> -<p><a href="ref_new_jpa_project_wizard.htm#CACBJGBG">Create New JPA Project wizard</a></p> -</li> -<li> -<p><a href="ref_eclipselink_mapping_file.htm#CIAEDEJF">New EclipseLink Mapping File dialog</a></p> +<p><a href="task_manage_persistence.htm#CIHDAJID">Managing the persistence.xml file</a></p> </li> </ul> <a id="sthref132" name="sthref132"></a> -<p class="subhead2">Related tasks</p> -<ul> -<li> -<p><a href="ref_new_jpa_project_wizard.htm#CACBJGBG">Create New JPA Project wizard</a></p> -</li> -<li> -<p><a href="tasks008.htm#CIHBCDCE">Working with orm.xml file</a></p> -</li> -</ul> -<a id="sthref133" name="sthref133"></a> <p class="subhead2">Related concepts</p> <ul> <li> -<p><a href="concepts003.htm#CHDBIJAC">The orm.xml file</a></p> +<p><a href="concepts002.htm#CHDHAGIH">The persistence.xml file</a></p> </li> </ul> </div> <!-- class="sect2" --> +<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks008.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks008.htm index 8a13a8c318..695c580a6e 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks008.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks008.htm @@ -5,59 +5,69 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Working with orm.xml file</title> +<title>Creating an orm.xml file</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:38Z" /> +<meta name="date" content="2012-09-19T13:27:56Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Working with orm.xml file" /> +<meta name="doctitle" content="Creating an orm.xml file" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIHBCDCE" name="CIHBCDCE"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIHDEFCA" name="CIHDEFCA"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Working with orm.xml file</h1> -<p><a id="sthref134" name="sthref134"></a><a id="sthref135" name="sthref135"></a>You can work with the <code>orm.xml</code> by using the JPA Details view.</p> -<p>Use this procedure to work with the <code>orm.xml</code> file:</p> +<h1>Creating an orm.xml file</h1> +<p><a id="sthref139" name="sthref139"></a>If you opt not to create an <code>orm.xml</code> file when you create a JPA project, you can create one using the <a href="reference007.htm#CIAIJCCE">Create ORM Mapping File wizard</a>.</p> +<p>Use this procedure to create an <code>orm.xml</code> file:</p> <ol> <li> -<p>Right-click the <code>orm.xml</code> file in the <span class="gui-object-title">Project Explorer</span> and select <span class="gui-object-action">Open</span>.</p> -</li> +<p>From the Navigator or Project Explorer, select <span class="bold">File > New > Other</span>. The Select a Wizard dialog appears.</p> +<div class="figure"><a id="sthref140" name="sthref140"></a> +<p class="titleinfigure">The Select a Wizard Dialog</p> +<img src="img/select_a_wizard_mapping.png" alt="The Select a Wizard dialog with Mapping file selected." title="The Select a Wizard dialog with Mapping file selected." /><br /></div> +<!-- class="figure" --></li> <li> -<p>In the JPA Structure view, select <span class="bold">EntityMappings</span>.</p> -</li> +<p>Select <span class="bold">JPA ORM Mapping File</span> and then click <span class="bold">Next</span>. The Mapping File page of the <a href="reference007.htm#CIAIJCCE">Create ORM Mapping File wizard</a> appears.</p> +<p>If you are using EclipseLink, you can select <span class="bold">EclipseLink > EclipseLink ORM Mapping File</span>.</p> +<div class="figure"><a id="sthref141" name="sthref141"></a> +<p class="titleinfigure">New Mapping File Location Page</p> +<img src="img/mapping_file_new.png" alt="The Mapping File page." title="The Mapping File page." /><br /></div> +<!-- class="figure" --></li> <li> -<p>Use the JPA Details view to configure the entity mapping and persistence unit defaults.</p> -<div class="figure"><a id="sthref136" name="sthref136"></a> -<p class="titleinfigure">JPA Details view for EntityMappings (orm.xml)</p> -<img src="img/details_entitymappings.png" alt="JPA Details view for orm.xml file." title="JPA Details view for orm.xml file." /><br /></div> +<p>Select the name and location of your mapping file and click <span class="bold">Next</span>. The <a href="reference009.htm#CACDFCDB">Mapping File Options</a> page appears.</p> +<div class="figure"><a id="sthref142" name="sthref142"></a> +<p class="titleinfigure">New Mapping File Options Page</p> +<img src="img/new_mapping_file_options.png" alt="New Mapping File Options Page" title="New Mapping File Options Page" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete the fields on the JPA Details view.</p> +<p>Define the properties in the <a href="reference009.htm#CACDFCDB">Mapping File Options</a> page and click <span class="bold">Finish</span>. The <code>orm.xml</code> file appears in the <code>src</code> directory of the selected JPA project. You can manage the <code>orm.xml</code> file using the JPA Details view or through the XML Editor. See also <a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a>.</p> </li> </ol> -<a id="sthref137" name="sthref137"></a> +<a id="sthref143" name="sthref143"></a> <p class="subhead2">Related reference</p> <ul> <li> -<p><a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a></p> +<p><a href="ref_new_jpa_project_wizard.htm#CACBJGBG">Create New JPA Project wizard</a></p> +</li> +<li> +<p><a href="ref_eclipselink_mapping_file.htm#CIAEDEJF">New EclipseLink Mapping File dialog</a></p> </li> </ul> -<a id="sthref138" name="sthref138"></a> +<a id="sthref144" name="sthref144"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="#CIHBCDCE">Working with orm.xml file</a></p> +<p><a href="ref_new_jpa_project_wizard.htm#CACBJGBG">Create New JPA Project wizard</a></p> </li> <li> -<p><a href="../org.eclipse.wst.xmleditor.doc.user/topics/cworkXML.html">Working with XML Files</a></p> +<p><a href="tasks009.htm#CIHBCDCE">Working with orm.xml file</a></p> </li> </ul> -<a id="sthref139" name="sthref139"></a> +<a id="sthref145" name="sthref145"></a> <p class="subhead2">Related concepts</p> <ul> <li> @@ -66,7 +76,6 @@ </ul> </div> <!-- class="sect2" --> -<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks009.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks009.htm index 0a1feaa4b3..099908a725 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks009.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks009.htm @@ -5,55 +5,67 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Creating queries</title> +<title>Working with orm.xml file</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:56Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Creating queries" /> +<meta name="doctitle" content="Working with orm.xml file" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABIGBGG" name="BABIGBGG"></a></p> -<div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1>Creating queries</h1> -<p><a id="sthref158" name="sthref158"></a><a id="sthref159" name="sthref159"></a>Named queries improve application performance because they are prepared once and they (and all of their associated supporting objects) can be efficiently reused thereafter, making them well suited for complex and frequently executed operations. Named queries use the JPA query language for portable execution on any underlying database; named native queries use the SQL language native to the underlying database.</p> -<p>Use this procedure to add <code>@NamedQuery</code> and <code>@NamedNativeQuery</code> annotations to the entity.</p> -<p>To create a named query:</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIHBCDCE" name="CIHBCDCE"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Working with orm.xml file</h1> +<p><a id="sthref146" name="sthref146"></a><a id="sthref147" name="sthref147"></a>You can work with the <code>orm.xml</code> by using the JPA Details view.</p> +<p>Use this procedure to work with the <code>orm.xml</code> file:</p> <ol> <li> -<p>Select the entity in the Project Explorer.</p> +<p>Right-click the <code>orm.xml</code> file in the <span class="gui-object-title">Project Explorer</span> and select <span class="gui-object-action">Open</span>.</p> </li> <li> -<p>In the JPA Details view, expand the <a href="reference017.htm#CACBICGJ">Queries</a> area.</p> -<div class="figure"><a id="sthref160" name="sthref160"></a> -<p class="titleinfigure">JPA Details, Queries Tab</p> -<img src="img/jpa_details_query_1.png" alt="" title="" /><br /></div> -<!-- class="figure" --></li> +<p>In the JPA Structure view, select <span class="bold">EntityMappings</span>.</p> +</li> <li> -<p>Click <span class="bold">Add</span> to add a new query. The <a href="reference066.htm#CACJIFEG">Add Query dialog</a> appears</p> -<div class="figure"><a id="sthref161" name="sthref161"></a> -<p class="titleinfigure">Add Query Dialog</p> -<img src="img/add_query.png" alt="Add Query dialog" title="Add Query dialog" /><br /></div> +<p>Use the JPA Details view to configure the entity mapping and persistence unit defaults.</p> +<div class="figure"><a id="sthref148" name="sthref148"></a> +<p class="titleinfigure">JPA Details view for EntityMappings (orm.xml)</p> +<img src="img/details_entitymappings.png" alt="JPA Details view for orm.xml file." title="JPA Details view for orm.xml file." /><br /></div> <!-- class="figure" --></li> <li> -<p>Enter the name of the query, select the query type (<span class="bold">Named Query</span> or <span class="bold">Named Native Query</span>), and click <span class="bold">OK</span>. The <a href="reference017.htm#CACBICGJ">Queries</a> area expands to show additional fields.</p> -<div class="figure"><a id="sthref162" name="sthref162"></a> -<p class="titleinfigure">JPA Details, Queries Tab</p> -<img src="img/jpa_details_query_2.png" alt="" title="" /><br /></div> -<!-- class="figure" --></li> +<p>Complete the fields on the <a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a>.</p> +</li> +</ol> +<a id="sthref149" name="sthref149"></a> +<p class="subhead2">Related reference</p> +<ul> <li> -<p>Enter the query in the Query field.</p> +<p><a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a></p> </li> +</ul> +<a id="sthref150" name="sthref150"></a> +<p class="subhead2">Related tasks</p> +<ul> <li> -<p><a id="sthref163" name="sthref163"></a><a id="sthref164" name="sthref164"></a><a id="sthref165" name="sthref165"></a><a id="sthref166" name="sthref166"></a>To add a Query hint, click <span class="bold">Add</span>.</p> +<p><a href="#CIHBCDCE">Working with orm.xml file</a></p> </li> -</ol> +<li> +<p><a href="../org.eclipse.wst.xmleditor.doc.user/topics/cworkXML.html">Working with XML Files</a></p> +</li> +</ul> +<a id="sthref151" name="sthref151"></a> +<p class="subhead2">Related concepts</p> +<ul> +<li> +<p><a href="concepts003.htm#CHDBIJAC">The orm.xml file</a></p> +</li> +</ul> </div> +<!-- class="sect2" --> <!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks010.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks010.htm index 9ca2561c84..77fc75d662 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks010.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks010.htm @@ -5,115 +5,66 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Basic mapping</title> +<title>Creating queries</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Basic mapping" /> +<meta name="doctitle" content="Creating queries" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABBABCE" name="BABBABCE"></a></p> -<div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Basic mapping</h1> -<p><a id="sthref170" name="sthref170"></a><a id="sthref171" name="sthref171"></a><a id="sthref172" name="sthref172"></a><a id="sthref173" name="sthref173"></a>Use a <span class="bold">Basic Mapping</span> to map an attribute directly to a database column. Basic mappings may be used only with the following attribute types:</p> -<ul> -<li> -<p>Java primitive types and wrappers of the primitive types</p> -</li> -<li> -<p><code>java.lang.String, java.math.BigInteger</code></p> -</li> -<li> -<p><code>java.math.BigDecimal</code></p> -</li> -<li> -<p><code>java.util.Date</code></p> -</li> -<li> -<p><code>java.util.Calendar, java.sql.Date</code></p> -</li> -<li> -<p><code>java.sql.Time</code></p> -</li> -<li> -<p><code>java.sql.Timestamp</code></p> -</li> -<li> -<p><code>byte[]</code></p> -</li> -<li> -<p><code>Byte[]</code></p> -</li> -<li> -<p><code>char[]</code></p> -</li> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABIGBGG" name="BABIGBGG"></a></p> +<div class="sect1"><!-- infolevel="all" infotype="General" --> +<h1>Creating queries</h1> +<p><a id="sthref170" name="sthref170"></a><a id="sthref171" name="sthref171"></a>Named queries improve application performance because they are prepared once and they (and all of their associated supporting objects) can be efficiently reused thereafter, making them well suited for complex and frequently executed operations. Named queries use the JPA query language for portable execution on any underlying database; named native queries use the SQL language native to the underlying database.</p> +<p>Use this procedure to add <code>@NamedQuery</code> and <code>@NamedNativeQuery</code> annotations to the entity.</p> +<p>To create a named query:</p> +<ol> <li> -<p><code>Character[]</code></p> +<p>Select the entity in the Project Explorer.</p> </li> <li> -<p>enums</p> -</li> +<p>In the JPA Details view, expand the <a href="reference021.htm#CACBICGJ">Queries</a> area.</p> +<div class="figure"><a id="sthref172" name="sthref172"></a> +<p class="titleinfigure">JPA Details, Queries Tab</p> +<img src="img/jpa_details_query_1.png" alt="" title="" /><br /></div> +<!-- class="figure" --></li> <li> -<p>any other type that implements <code>Serializable</code></p> -</li> -</ul> -<p>To create a basic mapping:</p> -<ol> +<p>Click <span class="bold">Add</span> to add a new query. The <a href="reference072.htm#CACJIFEG">Add Query dialog</a> appears</p> +<div class="figure"><a id="sthref173" name="sthref173"></a> +<p class="titleinfigure">Add Query Dialog</p> +<img src="img/add_query.png" alt="Add Query dialog" title="Add Query dialog" /><br /></div> +<!-- class="figure" --></li> <li> -<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, right-click the field to map. Select <span class="bold">Map As > Basic</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected field.</p> +<p>Enter the name of the query, select the query type (<span class="bold">Named Query</span> or <span class="bold">Named Native Query</span>), and click <span class="bold">OK</span>. The <a href="reference021.htm#CACBICGJ">Queries</a> area expands to show additional fields.</p> <div class="figure"><a id="sthref174" name="sthref174"></a> -<p class="titleinfigure">JPA Details, Basic mapping</p> -<img src="img/jpa_details_basic.png" alt="PA Details, Basic mapping" title="PA Details, Basic mapping" /><br /></div> +<p class="titleinfigure">JPA Details, Queries Tab</p> +<img src="img/jpa_details_query_2.png" alt="" title="" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete each field in the <a href="reference025.htm#CACCGGCG">Basic Mapping</a> area.</p> -</li> -<li> -<p>Complete the remaining areas in the <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>.</p> +<p>Enter the query in the <span class="bold">Query</span> field.</p> </li> -</ol> -<p>Eclipse adds the following annotations to the field:</p> -<pre xml:space="preserve" class="oac_no_warn"> -@Column(name="<span class="italic"><COLUMN_NAME></span>", table="<span class="italic"><COLUMN_TABLE></span>", - insertable=<span class="italic"><INSERTABLE></span>, updatable=<span class="italic"><UPDATABLE></span>) -@Basic(fetch=FetchType.<span class="italic"><FETCH_TYPE></span>, optional = <span class="italic"><OPTIONAL></span>) -@Temporal(TemporalType.<span class="italic"><TEMPORAL></span>) -</pre> -<a id="sthref175" name="sthref175"></a> -<p class="subhead2">Related tasks</p> -<ul> -<li> -<p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> -</li> -</ul> -<a id="sthref176" name="sthref176"></a> -<p class="subhead2">Related references</p> -<ul> <li> -<p><a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a></p> +<p>Complete the rest of the field on the <a href="reference021.htm#CACBICGJ">Queries</a> page.</p> </li> <li> -<p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> +<p><a id="sthref175" name="sthref175"></a><a id="sthref176" name="sthref176"></a><a id="sthref177" name="sthref177"></a><a id="sthref178" name="sthref178"></a>To add a Query hint, click <span class="bold">Add</span>. Enter the <span class="bold">Name</span> and <span class="bold">Value</span> of the hint.</p> </li> -</ul> -<a id="sthref177" name="sthref177"></a> -<p class="subhead2">Related concepts</p> +</ol> +<a id="sthref179" name="sthref179"></a> +<p class="subhead2">Related reference</p> <ul> <li> -<p><a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a></p> -</li> -<li> -<p><a href="concepts001.htm#BABBGFJG">Understanding Java Persistence API</a></p> +<p><a href="reference021.htm#CACBICGJ">Queries</a></p> </li> </ul> </div> -<!-- class="sect2" --> +<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm index 83b5b96577..6bfa7f079e 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm @@ -5,32 +5,74 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Element collection mapping</title> +<title>Basic mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Element collection mapping" /> +<meta name="doctitle" content="Basic mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIHHJEBJ" name="CIHHJEBJ"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABBABCE" name="BABBABCE"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Element collection mapping<a id="sthref178" name="sthref178"></a><a id="sthref179" name="sthref179"></a><a id="sthref180" name="sthref180"></a></h1> -<p>To create an element collection mapping:</p> +<h1>Basic mapping</h1> +<p><a id="sthref183" name="sthref183"></a><a id="sthref184" name="sthref184"></a><a id="sthref185" name="sthref185"></a><a id="sthref186" name="sthref186"></a>Use a <span class="bold">Basic Mapping</span> to map an attribute directly to a database column. Basic mappings may be used only with the following attribute types:</p> +<ul> +<li> +<p>Java primitive types and wrappers of the primitive types</p> +</li> +<li> +<p><code>java.lang.String, java.math.BigInteger</code></p> +</li> +<li> +<p><code>java.math.BigDecimal</code></p> +</li> +<li> +<p><code>java.util.Date</code></p> +</li> +<li> +<p><code>java.util.Calendar, java.sql.Date</code></p> +</li> +<li> +<p><code>java.sql.Time</code></p> +</li> +<li> +<p><code>java.sql.Timestamp</code></p> +</li> +<li> +<p><code>byte[]</code></p> +</li> +<li> +<p><code>Byte[]</code></p> +</li> +<li> +<p><code>char[]</code></p> +</li> +<li> +<p><code>Character[]</code></p> +</li> +<li> +<p>enums</p> +</li> +<li> +<p>any other type that implements <code>Serializable</code></p> +</li> +</ul> +<p>To create a basic mapping:</p> <ol> <li> -<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, right-click the field to map. Select <span class="bold">Map As > Element Collection</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected field.</p> -<div class="figure"><a id="sthref181" name="sthref181"></a> -<p class="titleinfigure">JPA Details, Element collection mapping</p> -<img src="img/jpa_details_elementcollection.png" alt="PA Details, Element collection mapping" title="PA Details, Element collection mapping" /><br /></div> +<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, right-click the field to map. Select <span class="bold">Map As > Basic</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected field.</p> +<div class="figure"><a id="sthref187" name="sthref187"></a> +<p class="titleinfigure">JPA Details, Basic mapping</p> +<img src="img/jpa_details_basic.png" alt="PA Details, Basic mapping" title="PA Details, Basic mapping" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete each field in the <a href="reference026.htm#CACBCGDI">Element Collection Mapping</a> area.</p> +<p>Complete each field in the <a href="reference029.htm#CACCGGCG">Basic Mapping</a> area.</p> </li> <li> <p>Complete the remaining areas in the <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>.</p> @@ -38,18 +80,19 @@ </ol> <p>Eclipse adds the following annotations to the field:</p> <pre xml:space="preserve" class="oac_no_warn"> - - - +@Column(name="<span class="italic"><COLUMN_NAME></span>", table="<span class="italic"><COLUMN_TABLE></span>", + insertable=<span class="italic"><INSERTABLE></span>, updatable=<span class="italic"><UPDATABLE></span>) +@Basic(fetch=FetchType.<span class="italic"><FETCH_TYPE></span>, optional = <span class="italic"><OPTIONAL></span>) +@Temporal(TemporalType.<span class="italic"><TEMPORAL></span>) </pre> -<a id="sthref182" name="sthref182"></a> +<a id="sthref188" name="sthref188"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref183" name="sthref183"></a> +<a id="sthref189" name="sthref189"></a> <p class="subhead2">Related references</p> <ul> <li> @@ -59,7 +102,7 @@ <p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> </li> </ul> -<a id="sthref184" name="sthref184"></a> +<a id="sthref190" name="sthref190"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks012.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks012.htm index 43cbc30e75..a56f950f21 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks012.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks012.htm @@ -5,51 +5,51 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Embedded mapping</title> +<title>Element collection mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Embedded mapping" /> +<meta name="doctitle" content="Element collection mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABCBHDF" name="BABCBHDF"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIHHJEBJ" name="CIHHJEBJ"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Embedded mapping</h1> -<p><a id="sthref185" name="sthref185"></a><a id="sthref186" name="sthref186"></a><a id="sthref187" name="sthref187"></a><a id="sthref188" name="sthref188"></a>Use an <span class="bold">Embedded Mapping</span> to specify a persistent field or property of an entity whose value is an instance of an embeddable class.</p> +<h1>Element collection mapping<a id="sthref191" name="sthref191"></a><a id="sthref192" name="sthref192"></a><a id="sthref193" name="sthref193"></a></h1> +<p>To create an element collection mapping:</p> <ol> <li> -<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, right-click the field to map.</p> -</li> -<li> -<p>Select <span class="bold">Map as > Embedded</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected field.</p> -<div class="figure"><a id="sthref189" name="sthref189"></a> -<p class="titleinfigure">JPA Details, Embedded mapping</p> -<img src="img/jpa_details_embedded.png" alt="PA Details, Element collection mapping" title="PA Details, Element collection mapping" /><br /></div> +<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, right-click the field to map. Select <span class="bold">Map As > Element Collection</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected field.</p> +<div class="figure"><a id="sthref194" name="sthref194"></a> +<p class="titleinfigure">JPA Details, Element collection mapping</p> +<img src="img/jpa_details_elementcollection.png" alt="PA Details, Element collection mapping" title="PA Details, Element collection mapping" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete each field in the <a href="reference027.htm#CACBJBFD">Embedded Mapping</a> area.</p> +<p>Complete each field in the <a href="reference030.htm#CACBCGDI">Element Collection Mapping</a> area.</p> +</li> +<li> +<p>Complete the remaining areas in the <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>.</p> </li> </ol> <p>Eclipse adds the following annotations to the field:</p> <pre xml:space="preserve" class="oac_no_warn"> -@Embedded -@AttributeOverride(column=@Column(table="<span class="italic"><COLUMN_TABLE></span>", name = "<span class="italic"><COLUMN_NAME></span>")) + + </pre> -<a id="sthref190" name="sthref190"></a> +<a id="sthref195" name="sthref195"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref191" name="sthref191"></a> +<a id="sthref196" name="sthref196"></a> <p class="subhead2">Related references</p> <ul> <li> @@ -59,7 +59,7 @@ <p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> </li> </ul> -<a id="sthref192" name="sthref192"></a> +<a id="sthref197" name="sthref197"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks013.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks013.htm index d3991410a4..c9b113710e 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks013.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks013.htm @@ -5,49 +5,51 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Embedded ID mapping</title> +<title>Embedded mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Embedded ID mapping" /> +<meta name="doctitle" content="Embedded mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIHDIAEE" name="CIHDIAEE"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABCBHDF" name="BABCBHDF"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Embedded ID mapping</h1> -<p><a id="sthref193" name="sthref193"></a><a id="sthref194" name="sthref194"></a><a id="sthref195" name="sthref195"></a><a id="sthref196" name="sthref196"></a>Use an <span class="bold">Embedded ID Mapping</span> to specify the primary key of an embedded ID. These mappings may be used with a <a href="tasks003.htm#BABFEICE">Embeddable</a> entities.</p> +<h1>Embedded mapping</h1> +<p><a id="sthref198" name="sthref198"></a><a id="sthref199" name="sthref199"></a><a id="sthref200" name="sthref200"></a><a id="sthref201" name="sthref201"></a>Use an <span class="bold">Embedded Mapping</span> to specify a persistent field or property of an entity whose value is an instance of an embeddable class.</p> <ol> <li> -<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map.</p> +<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, right-click the field to map.</p> </li> <li> -<p>Right-click the field and then select <span class="bold">Map As > Embedded Id</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected field.</p> -<div class="figure"><a id="sthref197" name="sthref197"></a> -<p class="titleinfigure">JPA Details, Embedded ID mapping</p> +<p>Select <span class="bold">Map as > Embedded</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected field.</p> +<div class="figure"><a id="sthref202" name="sthref202"></a> +<p class="titleinfigure">JPA Details, Embedded mapping</p> <img src="img/jpa_details_embedded.png" alt="PA Details, Element collection mapping" title="PA Details, Element collection mapping" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete each field in the <a href="reference028.htm#CACDIDIA">Embedded ID Mapping</a> area.</p> +<p>Complete each field in the <a href="reference031.htm#CACBJBFD">Embedded Mapping</a> area.</p> </li> </ol> <p>Eclipse adds the following annotations to the field:</p> <pre xml:space="preserve" class="oac_no_warn"> -@EmbeddedId +@Embedded +@AttributeOverride(column=@Column(table="<span class="italic"><COLUMN_TABLE></span>", name = "<span class="italic"><COLUMN_NAME></span>")) + </pre> -<a id="sthref198" name="sthref198"></a> +<a id="sthref203" name="sthref203"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref199" name="sthref199"></a> +<a id="sthref204" name="sthref204"></a> <p class="subhead2">Related references</p> <ul> <li> @@ -57,7 +59,7 @@ <p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> </li> </ul> -<a id="sthref200" name="sthref200"></a> +<a id="sthref205" name="sthref205"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks014.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks014.htm index 6668d445f0..775e4fb37a 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks014.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks014.htm @@ -5,70 +5,49 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>ID mapping</title> +<title>Embedded ID mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="ID mapping" /> +<meta name="doctitle" content="Embedded ID mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABGCBHG" name="BABGCBHG"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIHDIAEE" name="CIHDIAEE"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>ID mapping</h1> -<p><a id="sthref201" name="sthref201"></a><a id="sthref202" name="sthref202"></a><a id="sthref203" name="sthref203"></a><a id="sthref204" name="sthref204"></a>Use an <span class="bold">ID Mapping</span> to specify the primary key of an entity. ID mappings may be used with a <a href="tasks002.htm#BABGBIEE">Entity</a> or <a href="tasks004.htm#BABDAGCI">Mapped superclass</a>. Each <a href="tasks002.htm#BABGBIEE">Entity</a> must have an ID mapping.</p> +<h1>Embedded ID mapping</h1> +<p><a id="sthref206" name="sthref206"></a><a id="sthref207" name="sthref207"></a><a id="sthref208" name="sthref208"></a><a id="sthref209" name="sthref209"></a>Use an <span class="bold">Embedded ID Mapping</span> to specify the primary key of an embedded ID. These mappings may be used with a <a href="tasks004.htm#BABFEICE">Embeddable</a> entities.</p> <ol> <li> <p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map.</p> </li> <li> -<p>Right click the filed and then select <span class="bold">Map as > ID</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> -<div class="figure"><a id="sthref205" name="sthref205"></a> -<p class="titleinfigure">JPA Details, ID mapping</p> -<img src="img/jpa_details_idmapping.png" alt="" title="" /><br /></div> +<p>Right-click the field and then select <span class="bold">Map As > Embedded Id</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected field.</p> +<div class="figure"><a id="sthref210" name="sthref210"></a> +<p class="titleinfigure">JPA Details, Embedded ID mapping</p> +<img src="img/jpa_details_embedded.png" alt="PA Details, Element collection mapping" title="PA Details, Element collection mapping" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete each field in the <a href="reference029.htm#CACIAEFI">ID Mapping</a> area.</p> -</li> -<li> -<p>Use the Primary Key Generation area to specify ...................</p> -<div class="figure"><a id="sthref206" name="sthref206"></a> -<p class="titleinfigure">JPA Details, Primary key generation</p> -<img src="img/jpa_details_primarykeygeneration.png" alt="JPA Details, Primary key generation" title="JPA Details, Primary key generation" /><br /></div> -<!-- class="figure" --></li> -<li> -<p>Complete each field in the <a href="ref_primary_key.htm#CACFCCAB">Primary Key Generation information</a> area.</p> -</li> -<li> -<p>Complete the remaining areas in the <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>.</p> +<p>Complete each field in the <a href="reference032.htm#CACDIDIA">Embedded ID Mapping</a> area.</p> </li> </ol> -<p>Additional fields will appear in the <a href="ref_primary_key.htm#CACFCCAB">Primary Key Generation information</a> area, depending on the selected Strategy. See <a href="ref_persistence_map_view.htm#BABIFBAF">"JPA Details view (for attributes)"</a> for additional information.</p> <p>Eclipse adds the following annotations to the field:</p> <pre xml:space="preserve" class="oac_no_warn"> -@Id -@Column(name="<span class="italic"><COLUMN_NAME></span>", table="<span class="italic"><TABLE_NAME></span>", insertable=<span class="italic"><INSERTABLE></span>, - updatable=<span class="italic"><UPDATABLE></span>) -@Temporal(<span class="italic"><TEMPORAL></span>) -@GeneratedValue(strategy=GeneratorType.<span class="italic"><STRATEGY></span>, generator="<span class="italic"><GENERATOR_NAME></span>")@TableGenerator(name="<span class="italic"><TABLE_GENERATOR_NAME></span>", table = "<span class="italic"><TABLE_GENERATOR_TABLE></span>", - pkColumnName = "<span class="italic"><TABLE_GENERATOR_PK></span>", - valueColumnName = "<span class="italic"><TABLE_GENERATOR_VALUE_COLUMN></span>", - pkColumnValue = "<span class="italic"><TABLE_GENERATOR_PK_COLUMN_VALUE></span>")@SequenceGenerator(name="<span class="italic"><SEQUENCE_GENERATOR_NAME></span>", - sequenceName="<span class="italic"><SEQUENCE_GENERATOR_SEQUENCE></span>") +@EmbeddedId </pre> -<a id="sthref207" name="sthref207"></a> +<a id="sthref211" name="sthref211"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref208" name="sthref208"></a> +<a id="sthref212" name="sthref212"></a> <p class="subhead2">Related references</p> <ul> <li> @@ -77,11 +56,8 @@ <li> <p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> </li> -<li> -<p><a href="ref_primary_key.htm#CACFCCAB">Primary Key Generation information</a></p> -</li> </ul> -<a id="sthref209" name="sthref209"></a> +<a id="sthref213" name="sthref213"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks015.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks015.htm index 7dc7743a89..aac85e3ff9 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks015.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks015.htm @@ -5,66 +5,70 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Many-to-many mapping</title> +<title>ID mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Many-to-many mapping" /> +<meta name="doctitle" content="ID mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABEIEGD" name="BABEIEGD"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABGCBHG" name="BABGCBHG"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Many-to-many mapping</h1> -<p><a id="sthref210" name="sthref210"></a><a id="sthref211" name="sthref211"></a><a id="sthref212" name="sthref212"></a><a id="sthref213" name="sthref213"></a>Use a <span class="bold">Many-to-Many Mapping</span> to define a many-valued association with many-to-many multiplicity. A many-to-many mapping has two sides: the <span class="italic">owning side</span> and <span class="italic">non-owning side</span>. You must specify the join table on the owning side. For bidirectional mappings, either side may be the owning side.</p> +<h1>ID mapping</h1> +<p><a id="sthref214" name="sthref214"></a><a id="sthref215" name="sthref215"></a><a id="sthref216" name="sthref216"></a><a id="sthref217" name="sthref217"></a>Use an <span class="bold">ID Mapping</span> to specify the primary key of an entity. ID mappings may be used with a <a href="tasks003.htm#BABGBIEE">Entity</a> or <a href="tasks005.htm#BABDAGCI">Mapped superclass</a>. Each <a href="tasks003.htm#BABGBIEE">Entity</a> must have an ID mapping.</p> <ol> <li> <p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map.</p> </li> <li> -<p>Right-click the field and then select <span class="bold">Map As > Many-to-Many</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected field.</p> -<div class="figure"><a id="sthref214" name="sthref214"></a> -<p class="titleinfigure">JPA Details, Many to many mapping</p> -<img src="img/jpa_details.manytomany.png" alt="JPA Details, Primary key generation" title="JPA Details, Primary key generation" /><br /></div> +<p>Right click the filed and then select <span class="bold">Map as > ID</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> +<div class="figure"><a id="sthref218" name="sthref218"></a> +<p class="titleinfigure">JPA Details, ID mapping</p> +<img src="img/jpa_details_idmapping.png" alt="" title="" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete each field in the <a href="reference030.htm#CACIHGCE">Many-to-Many Mapping</a> area.</p> +<p>Complete each field in the <a href="reference033.htm#CACIAEFI">ID Mapping</a> area.</p> </li> <li> -<p>Use the Joining Strategy area to specify ...................</p> -<div class="figure"><a id="sthref215" name="sthref215"></a> -<p class="titleinfigure">JPA Details, Joining Strategy</p> -<img src="img/jpa_details_joiningstrategy.png" alt="JPA Details, Joining Strategy" title="JPA Details, Joining Strategy" /><br /></div> +<p>Use the Primary Key Generation area to specify ...................</p> +<div class="figure"><a id="sthref219" name="sthref219"></a> +<p class="titleinfigure">JPA Details, Primary key generation</p> +<img src="img/jpa_details_primarykeygeneration.png" alt="JPA Details, Primary key generation" title="JPA Details, Primary key generation" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete each field in the <a href="reference039.htm#CACIJEGI">Joining Strategy</a> area.</p> +<p>Complete each field in the <a href="ref_primary_key.htm#CACFCCAB">Primary Key Generation information</a> area.</p> </li> <li> <p>Complete the remaining areas in the <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>.</p> </li> </ol> +<p>Additional fields will appear in the <a href="ref_primary_key.htm#CACFCCAB">Primary Key Generation information</a> area, depending on the selected Strategy. See <a href="ref_persistence_map_view.htm#BABIFBAF">"JPA Details view (for attributes)"</a> for additional information.</p> <p>Eclipse adds the following annotations to the field:</p> <pre xml:space="preserve" class="oac_no_warn"> -@JoinTable(joinColumns=@JoinColumn(name="<span class="italic"><JOIN_COLUMN></span>"), - name = "<span class="italic"><JOIN_TABLE_NAME></span>") -@ManyToMany(=Type.<span class="italic"><_TYPE></span>, fetch=FetchType.<span class="italic"><FETCH_TYPE></span>, - targetEntity=<span class="italic"><TARGET_ENTITY></span>, mappedBy = "<span class="italic"><MAPPED_BY></span>") -@OrderBy("<span class="italic"><ORDER_BY></span>") - +@Id +@Column(name="<span class="italic"><COLUMN_NAME></span>", table="<span class="italic"><TABLE_NAME></span>", insertable=<span class="italic"><INSERTABLE></span>, + updatable=<span class="italic"><UPDATABLE></span>) +@Temporal(<span class="italic"><TEMPORAL></span>) +@GeneratedValue(strategy=GeneratorType.<span class="italic"><STRATEGY></span>, generator="<span class="italic"><GENERATOR_NAME></span>")@TableGenerator(name="<span class="italic"><TABLE_GENERATOR_NAME></span>", table = "<span class="italic"><TABLE_GENERATOR_TABLE></span>", + pkColumnName = "<span class="italic"><TABLE_GENERATOR_PK></span>", + valueColumnName = "<span class="italic"><TABLE_GENERATOR_VALUE_COLUMN></span>", + pkColumnValue = "<span class="italic"><TABLE_GENERATOR_PK_COLUMN_VALUE></span>")@SequenceGenerator(name="<span class="italic"><SEQUENCE_GENERATOR_NAME></span>", + sequenceName="<span class="italic"><SEQUENCE_GENERATOR_SEQUENCE></span>") </pre> -<a id="sthref216" name="sthref216"></a> +<a id="sthref220" name="sthref220"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref217" name="sthref217"></a> +<a id="sthref221" name="sthref221"></a> <p class="subhead2">Related references</p> <ul> <li> @@ -74,10 +78,10 @@ <p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> </li> <li> -<p><a href="reference039.htm#CACIJEGI">Joining Strategy</a></p> +<p><a href="ref_primary_key.htm#CACFCCAB">Primary Key Generation information</a></p> </li> </ul> -<a id="sthref218" name="sthref218"></a> +<a id="sthref222" name="sthref222"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks016.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks016.htm index cc721d5dbb..d70f6a6e8e 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks016.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks016.htm @@ -5,35 +5,44 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Many-to-one mapping</title> +<title>Many-to-many mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Many-to-one mapping" /> +<meta name="doctitle" content="Many-to-many mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABHFAFJ" name="BABHFAFJ"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABEIEGD" name="BABEIEGD"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Many-to-one mapping</h1> -<p><a id="sthref219" name="sthref219"></a><a id="sthref220" name="sthref220"></a><a id="sthref221" name="sthref221"></a><a id="sthref222" name="sthref222"></a>Use a <span class="bold">Many-to-One</span> mapping to defines a single-valued association to another entity class that has many-to-one multiplicity.</p> +<h1>Many-to-many mapping</h1> +<p><a id="sthref223" name="sthref223"></a><a id="sthref224" name="sthref224"></a><a id="sthref225" name="sthref225"></a><a id="sthref226" name="sthref226"></a>Use a <span class="bold">Many-to-Many Mapping</span> to define a many-valued association with many-to-many multiplicity. A many-to-many mapping has two sides: the <span class="italic">owning side</span> and <span class="italic">non-owning side</span>. You must specify the join table on the owning side. For bidirectional mappings, either side may be the owning side.</p> <ol> <li> <p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map.</p> </li> <li> -<p>Right click the field and then select <span class="bold">Map As > Many-to-One</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> -<div class="figure"><a id="sthref223" name="sthref223"></a> -<p class="titleinfigure">JPA Details, Many-to-one mapping</p> -<img src="img/jpa_details_manytoone.png" alt="JPA Details, Many-to-one mapping" title="JPA Details, Many-to-one mapping" /><br /></div> +<p>Right-click the field and then select <span class="bold">Map As > Many-to-Many</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected field.</p> +<div class="figure"><a id="sthref227" name="sthref227"></a> +<p class="titleinfigure">JPA Details, Many to many mapping</p> +<img src="img/jpa_details.manytomany.png" alt="JPA Details, Primary key generation" title="JPA Details, Primary key generation" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete each field in the <a href="reference030.htm#CACIHGCE">Many-to-Many Mapping</a> area.</p> +<p>Complete each field in the <a href="reference034.htm#CACIHGCE">Many-to-Many Mapping</a> area.</p> +</li> +<li> +<p>Use the Joining Strategy area to specify ...................</p> +<div class="figure"><a id="sthref228" name="sthref228"></a> +<p class="titleinfigure">JPA Details, Joining Strategy</p> +<img src="img/jpa_details_joiningstrategy.png" alt="JPA Details, Joining Strategy" title="JPA Details, Joining Strategy" /><br /></div> +<!-- class="figure" --></li> +<li> +<p>Complete each field in the <a href="reference043.htm#CACIJEGI">Joining Strategy</a> area.</p> </li> <li> <p>Complete the remaining areas in the <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>.</p> @@ -43,17 +52,19 @@ <pre xml:space="preserve" class="oac_no_warn"> @JoinTable(joinColumns=@JoinColumn(name="<span class="italic"><JOIN_COLUMN></span>"), name = "<span class="italic"><JOIN_TABLE_NAME></span>") -@ManyToOne(targetEntity=<span class="italic"><TARGET_ENTITY></span>, fetch=<span class="italic"><FETCH_TYPE></span>, - =<span class="italic"><_TYPE></span>) +@ManyToMany(=Type.<span class="italic"><_TYPE></span>, fetch=FetchType.<span class="italic"><FETCH_TYPE></span>, + targetEntity=<span class="italic"><TARGET_ENTITY></span>, mappedBy = "<span class="italic"><MAPPED_BY></span>") +@OrderBy("<span class="italic"><ORDER_BY></span>") + </pre> -<a id="sthref224" name="sthref224"></a> +<a id="sthref229" name="sthref229"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref225" name="sthref225"></a> +<a id="sthref230" name="sthref230"></a> <p class="subhead2">Related references</p> <ul> <li> @@ -62,8 +73,11 @@ <li> <p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> </li> +<li> +<p><a href="reference043.htm#CACIJEGI">Joining Strategy</a></p> +</li> </ul> -<a id="sthref226" name="sthref226"></a> +<a id="sthref231" name="sthref231"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks017.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks017.htm index c91ccbc837..9a9d0289e5 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks017.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks017.htm @@ -5,73 +5,55 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>One-to-many mapping</title> +<title>Many-to-one mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="One-to-many mapping" /> +<meta name="doctitle" content="Many-to-one mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABHGEBD" name="BABHGEBD"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABHFAFJ" name="BABHFAFJ"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>One-to-many mapping</h1> -<p><a id="sthref227" name="sthref227"></a><a id="sthref228" name="sthref228"></a><a id="sthref229" name="sthref229"></a><a id="sthref230" name="sthref230"></a>Use a <span class="bold">One-to-Many Mapping</span> to define a relationship with one-to-many multiplicity.</p> +<h1>Many-to-one mapping</h1> +<p><a id="sthref232" name="sthref232"></a><a id="sthref233" name="sthref233"></a><a id="sthref234" name="sthref234"></a><a id="sthref235" name="sthref235"></a>Use a <span class="bold">Many-to-One</span> mapping to defines a single-valued association to another entity class that has many-to-one multiplicity.</p> <ol> <li> <p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map.</p> </li> <li> -<p>Right-click the field and then select <span class="bold">Map As > One-to-many</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> -<div class="figure"><a id="sthref231" name="sthref231"></a> -<p class="titleinfigure">JPA Details, One-to-many Mapping</p> -<img src="img/jpa_details_onetomany.png" alt="JPA Details, One-to-many Mapping" title="JPA Details, One-to-many Mapping" /><br /></div> +<p>Right click the field and then select <span class="bold">Map As > Many-to-One</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> +<div class="figure"><a id="sthref236" name="sthref236"></a> +<p class="titleinfigure">JPA Details, Many-to-one mapping</p> +<img src="img/jpa_details_manytoone.png" alt="JPA Details, Many-to-one mapping" title="JPA Details, Many-to-one mapping" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete each field in the <a href="reference032.htm#CACHGGHH">One-to-Many Mapping</a> area.</p> +<p>Complete each field in the <a href="reference034.htm#CACIHGCE">Many-to-Many Mapping</a> area.</p> </li> <li> -<p>Complete the remaining areas in the <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>:</p> -<ul> -<li> -<p><a href="reference039.htm#CACIJEGI">Joining Strategy</a></p> -</li> -<li> -<p><a href="reference037.htm#CACJCHJB">Converters</a></p> -</li> -<li> -<p><a href="reference038.htm#CACBIJFD">Ordering</a></p> -</li> -</ul> +<p>Complete the remaining areas in the <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>.</p> </li> </ol> <p>Eclipse adds the following annotations to the field:</p> <pre xml:space="preserve" class="oac_no_warn"> -@OneToMany(targetEntity=<span class="italic"><TARGET_ENTITY></span>) -@Column(name="<span class="italic"><COLUMN></span>") - - -@OneToMany(targetEntity=<span class="italic"><TARGET_ENTITY></span>.class, =Type.<span class="italic"><_TYPE></span>, - fetch = FetchType.<span class="italic"><FETCH_TYPE></span>, mappedBy = "<span class="italic"><MAPPED_BY></span>")@OrderBy("<span class="italic"><ORDER_BY></span>") -@JoinTable(name="<span class="italic"><JOIN_TABLE_NAME></span>", joinColumns=@JoinColumn(name= - "<span class="italic"><JOIN_COLUMN_NAME></span>", referencedColumnName="<span class="italic"><JOIN_COLUMN_REFERENCED_COLUMN></span>"), - inverseJoinColumns=@JoinColumn(name="<span class="italic"><INVERSE_JOIN_COLUMN_NAME></span>", - referencedColumnName="<span class="italic"><INVERSE_JOIN_COLUMN_REFERENCED_COLUMN></span>")) - +@JoinTable(joinColumns=@JoinColumn(name="<span class="italic"><JOIN_COLUMN></span>"), + name = "<span class="italic"><JOIN_TABLE_NAME></span>") +@ManyToOne(targetEntity=<span class="italic"><TARGET_ENTITY></span>, fetch=<span class="italic"><FETCH_TYPE></span>, + =<span class="italic"><_TYPE></span>) </pre> -<a id="sthref232" name="sthref232"></a> +<a id="sthref237" name="sthref237"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref233" name="sthref233"></a> +<a id="sthref238" name="sthref238"></a> <p class="subhead2">Related references</p> <ul> <li> @@ -81,7 +63,7 @@ <p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> </li> </ul> -<a id="sthref234" name="sthref234"></a> +<a id="sthref239" name="sthref239"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks018.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks018.htm index 5ef90b88aa..4883d96cd3 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks018.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks018.htm @@ -5,64 +5,73 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>One-to-one mapping</title> +<title>One-to-many mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="One-to-one mapping" /> +<meta name="doctitle" content="One-to-many mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABFHBCJ" name="BABFHBCJ"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABHGEBD" name="BABHGEBD"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>One-to-one mapping</h1> -<p><a id="sthref235" name="sthref235"></a><a id="sthref236" name="sthref236"></a><a id="sthref237" name="sthref237"></a><a id="sthref238" name="sthref238"></a>Use a <span class="bold">One-to-One Mapping</span> to define a relationship with one-to-many multiplicity.</p> +<h1>One-to-many mapping</h1> +<p><a id="sthref240" name="sthref240"></a><a id="sthref241" name="sthref241"></a><a id="sthref242" name="sthref242"></a><a id="sthref243" name="sthref243"></a>Use a <span class="bold">One-to-Many Mapping</span> to define a relationship with one-to-many multiplicity.</p> <ol> <li> <p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map.</p> </li> <li> -<p>Right-click the field and then select <span class="bold">Map As > One-to-One</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> -<div class="figure"><a id="sthref239" name="sthref239"></a> -<p class="titleinfigure">JPA Details, One-to-one Mapping</p> -<img src="img/jpa_details_onetoone.png" alt="JPA Details, One-to-one Mapping" title="JPA Details, One-to-one Mapping" /><br /></div> +<p>Right-click the field and then select <span class="bold">Map As > One-to-many</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> +<div class="figure"><a id="sthref244" name="sthref244"></a> +<p class="titleinfigure">JPA Details, One-to-many Mapping</p> +<img src="img/jpa_details_onetomany.png" alt="JPA Details, One-to-many Mapping" title="JPA Details, One-to-many Mapping" /><br /></div> <!-- class="figure" --></li> <li> -<p>Complete each field in the <a href="reference033.htm#CACGGHDD">One-to-One Mapping</a> area.</p> +<p>Complete each field in the <a href="reference036.htm#CACHGGHH">One-to-Many Mapping</a> area.</p> </li> <li> <p>Complete the remaining areas in the <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>:</p> <ul> <li> -<p><a href="reference039.htm#CACIJEGI">Joining Strategy</a></p> +<p><a href="reference043.htm#CACIJEGI">Joining Strategy</a></p> </li> <li> -<p><a href="reference040.htm#CACGHHGB">Derived Identity</a></p> +<p><a href="reference041.htm#CACJCHJB">Converters</a></p> +</li> +<li> +<p><a href="reference042.htm#CACBIJFD">Ordering</a></p> </li> </ul> </li> </ol> <p>Eclipse adds the following annotations to the field:</p> <pre xml:space="preserve" class="oac_no_warn"> -@OneToOne(targetEntity=<span class="italic"><TARGET_ENTITY></span>, =Type.<span class="italic"><_TYPE></span>, - fetch = FetchType.<span class="italic"><FETCH_TYPE></span>, mappedBy = "<span class="italic"><MAPPED_BY></span>") -@JoinColumn(name="<span class="italic"><JOIN_COLUMN_NAME></span>", referencedColumnName= - "<span class="italic"><JOIN_COLUMN_REFERENCED_COLUMN></span>", insertable = <span class="italic"><INSERTABLE></span>, - updatable = <span class="italic"><UPDATABLE></span>) +@OneToMany(targetEntity=<span class="italic"><TARGET_ENTITY></span>) +@Column(name="<span class="italic"><COLUMN></span>") + + +@OneToMany(targetEntity=<span class="italic"><TARGET_ENTITY></span>.class, =Type.<span class="italic"><_TYPE></span>, + fetch = FetchType.<span class="italic"><FETCH_TYPE></span>, mappedBy = "<span class="italic"><MAPPED_BY></span>")@OrderBy("<span class="italic"><ORDER_BY></span>") +@JoinTable(name="<span class="italic"><JOIN_TABLE_NAME></span>", joinColumns=@JoinColumn(name= + "<span class="italic"><JOIN_COLUMN_NAME></span>", referencedColumnName="<span class="italic"><JOIN_COLUMN_REFERENCED_COLUMN></span>"), + inverseJoinColumns=@JoinColumn(name="<span class="italic"><INVERSE_JOIN_COLUMN_NAME></span>", + referencedColumnName="<span class="italic"><INVERSE_JOIN_COLUMN_REFERENCED_COLUMN></span>")) + </pre> -<a id="sthref240" name="sthref240"></a> +<a id="sthref245" name="sthref245"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref241" name="sthref241"></a> +<a id="sthref246" name="sthref246"></a> <p class="subhead2">Related references</p> <ul> <li> @@ -72,7 +81,7 @@ <p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> </li> </ul> -<a id="sthref242" name="sthref242"></a> +<a id="sthref247" name="sthref247"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks019.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks019.htm index d0eb11e759..2d8fb1f6c6 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks019.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks019.htm @@ -5,44 +5,64 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Transient mapping</title> +<title>One-to-one mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Transient mapping" /> +<meta name="doctitle" content="One-to-one mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABHFHEI" name="BABHFHEI"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABFHBCJ" name="BABFHBCJ"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Transient mapping</h1> -<p><a id="sthref243" name="sthref243"></a><a id="sthref244" name="sthref244"></a><a id="sthref245" name="sthref245"></a><a id="sthref246" name="sthref246"></a>Use the Transient Mapping to specify a field of the entity class that <span class="italic">is not</span> persistent.</p> -<p>To create a transient mapping:</p> +<h1>One-to-one mapping</h1> +<p><a id="sthref248" name="sthref248"></a><a id="sthref249" name="sthref249"></a><a id="sthref250" name="sthref250"></a><a id="sthref251" name="sthref251"></a>Use a <span class="bold">One-to-One Mapping</span> to define a relationship with one-to-many multiplicity.</p> <ol> <li> <p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map.</p> </li> <li> -<p>Right-click the field and then select <span class="bold">Map As Transient</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> +<p>Right-click the field and then select <span class="bold">Map As > One-to-One</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> +<div class="figure"><a id="sthref252" name="sthref252"></a> +<p class="titleinfigure">JPA Details, One-to-one Mapping</p> +<img src="img/jpa_details_onetoone.png" alt="JPA Details, One-to-one Mapping" title="JPA Details, One-to-one Mapping" /><br /></div> +<!-- class="figure" --></li> +<li> +<p>Complete each field in the <a href="reference037.htm#CACGGHDD">One-to-One Mapping</a> area.</p> +</li> +<li> +<p>Complete the remaining areas in the <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>:</p> +<ul> +<li> +<p><a href="reference043.htm#CACIJEGI">Joining Strategy</a></p> +</li> +<li> +<p><a href="reference044.htm#CACGHHGB">Derived Identity</a></p> +</li> +</ul> </li> </ol> -<p>Eclipse adds the following annotation to the field:</p> +<p>Eclipse adds the following annotations to the field:</p> <pre xml:space="preserve" class="oac_no_warn"> -@Transient +@OneToOne(targetEntity=<span class="italic"><TARGET_ENTITY></span>, =Type.<span class="italic"><_TYPE></span>, + fetch = FetchType.<span class="italic"><FETCH_TYPE></span>, mappedBy = "<span class="italic"><MAPPED_BY></span>") +@JoinColumn(name="<span class="italic"><JOIN_COLUMN_NAME></span>", referencedColumnName= + "<span class="italic"><JOIN_COLUMN_REFERENCED_COLUMN></span>", insertable = <span class="italic"><INSERTABLE></span>, + updatable = <span class="italic"><UPDATABLE></span>) </pre> -<a id="sthref247" name="sthref247"></a> +<a id="sthref253" name="sthref253"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref248" name="sthref248"></a> +<a id="sthref254" name="sthref254"></a> <p class="subhead2">Related references</p> <ul> <li> @@ -52,7 +72,7 @@ <p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> </li> </ul> -<a id="sthref249" name="sthref249"></a> +<a id="sthref255" name="sthref255"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks020.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks020.htm index 9753776535..44bcebc41f 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks020.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks020.htm @@ -5,80 +5,44 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Version mapping</title> +<title>Transient mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:39Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Version mapping" /> +<meta name="doctitle" content="Transient mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABHIBII" name="BABHIBII"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABHFHEI" name="BABHFHEI"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Version mapping</h1> -<p><a id="sthref250" name="sthref250"></a><a id="sthref251" name="sthref251"></a><a id="sthref252" name="sthref252"></a><a id="sthref253" name="sthref253"></a>Use a <span class="bold">Version Mapping</span> to specify the field used for optimistic locking. If the entity is associated with multiple tables, you should use a version mapping only with the primary table. You should have only a single version mapping per persistent entity. Version mappings may be used only with the following attribute types:</p> -<ul> -<li> -<p><code>int</code></p> -</li> -<li> -<p><code>Integer</code></p> -</li> -<li> -<p><code>short, Short</code></p> -</li> -<li> -<p><code>long, Long</code></p> -</li> -<li> -<p><code>Timestamp</code></p> -</li> -</ul> -<p>To create a version mapping:</p> +<h1>Transient mapping</h1> +<p><a id="sthref256" name="sthref256"></a><a id="sthref257" name="sthref257"></a><a id="sthref258" name="sthref258"></a><a id="sthref259" name="sthref259"></a>Use the Transient Mapping to specify a field of the entity class that <span class="italic">is not</span> persistent.</p> +<p>To create a transient mapping:</p> <ol> <li> <p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map.</p> </li> <li> -<p>Right-click the field and then select <span class="bold">Map As > Version</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> -<div class="figure"><a id="sthref254" name="sthref254"></a> -<p class="titleinfigure">JPA Details, Version Mapping</p> -<img src="img/jpa_details_version.png" alt="JPA Details, Version Mapping" title="JPA Details, Version Mapping" /><br /></div> -<!-- class="figure" --></li> -<li> -<p>Complete each field in the <a href="reference034.htm#CACHAEBB">Version Mapping</a> area.</p> -</li> -<li> -<p>Complete the remaining areas in the <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>:</p> -<ul> -<li> -<p><a href="reference035.htm#CACIHAAF">Type information</a></p> -</li> -<li> -<p><a href="reference037.htm#CACJCHJB">Converters</a></p> -</li> -</ul> +<p>Right-click the field and then select <span class="bold">Map As Transient</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> </li> </ol> -<p>Eclipse adds the following annotations to the field:</p> +<p>Eclipse adds the following annotation to the field:</p> <pre xml:space="preserve" class="oac_no_warn"> -@Version -@Column(table="<span class="italic"><COLUMN_TABLE></span>", name="<<span class="italic">COLUMN_NAME</span>>") - +@Transient </pre> -<a id="sthref255" name="sthref255"></a> +<a id="sthref260" name="sthref260"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref256" name="sthref256"></a> +<a id="sthref261" name="sthref261"></a> <p class="subhead2">Related references</p> <ul> <li> @@ -88,7 +52,7 @@ <p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> </li> </ul> -<a id="sthref257" name="sthref257"></a> +<a id="sthref262" name="sthref262"></a> <p class="subhead2">Related concepts</p> <ul> <li> @@ -100,7 +64,6 @@ </ul> </div> <!-- class="sect2" --> -<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm index cac09a1c46..1ada5ec141 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm @@ -5,88 +5,101 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Generating entities from tables</title> +<title>Version mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Generating entities from tables" /> +<meta name="doctitle" content="Version mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABBAGFI" name="BABBAGFI"></a></p> -<div class="sect1"> -<h1>Generating entities from tables</h1> -<p><a id="sthref258" name="sthref258"></a><a id="sthref259" name="sthref259"></a>Use this procedure to generate Java persistent entities from database tables. You must create a JPA project and establish a database connection <span class="italic">before</span> generating persistent entities. See <a href="task_create_new_project.htm#CIHHEJCJ">"Creating a new JPA project"</a> for more information.<a id="sthref260" name="sthref260"></a><a id="sthref261" name="sthref261"></a></p> -<p>To use the <a href="reference010.htm#CIAGHCGA">Generate Tables from Entities wizard</a>:</p> -<ol> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABHIBII" name="BABHIBII"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Version mapping</h1> +<p><a id="sthref263" name="sthref263"></a><a id="sthref264" name="sthref264"></a><a id="sthref265" name="sthref265"></a><a id="sthref266" name="sthref266"></a>Use a <span class="bold">Version Mapping</span> to specify the field used for optimistic locking. If the entity is associated with multiple tables, you should use a version mapping only with the primary table. You should have only a single version mapping per persistent entity. Version mappings may be used only with the following attribute types:</p> +<ul> <li> -<p>Right-click the JPA project in the <span class="gui-object-title">Project Explorer</span> and select <span class="gui-object-action">JPA Tools > Generate Entities from Tables</span>.</p> -<div class="figure"><a id="sthref262" name="sthref262"></a> -<p class="titleinfigure">Generating Entities from Tables</p> -<img src="img/generate_entities.png" alt="Using the JPA Tools > Generate Entities menu option." title="Using the JPA Tools > Generate Entities menu option." /><br /></div> -<!-- class="figure" --></li> +<p><code>int</code></p> +</li> <li> -<p>On the <a href="ref_selectTables.htm#CIAHCGEE">Select Tables</a> page of the <a href="ref_create_custom_entities_wizard.htm#CIAGBFJE">Generate Entities from Tables wizard</a>, select your database connection and schema.</p> -<p>To create a new database connection, click <span class="bold">Add connection</span>.</p> -<p>If you are not currently connected to the database, the Database Connection page appears. Select your database connection and schema, and click <span class="bold">Reconnect</span>.</p> -<div class="figure"><a id="sthref263" name="sthref263"></a> -<p class="titleinfigure">Select Tables</p> -<img src="img/select_tables.png" alt="" title="" /><br /></div> -<!-- class="figure" --></li> +<p><code>Integer</code></p> +</li> <li> -<p>After selecting a schema, select the tables from which to generate Java persistent entities and click <span class="bold">Next</span>.</p> +<p><code>short, Short</code></p> </li> <li> -<p>On the <a href="ref_tableAssociations.htm#CIACDICB">Table Associations</a> page, select the associations to generate. You can specify to generate specific references for each association.</p> -<p>To create a new association, click <span class="bold">Add Association</span>. Use the <a href="ref_create_new_association_wizard.htm#CIAFGHIF">Create New Association wizard</a> wizard to define the association.</p> -<div class="figure"><a id="sthref264" name="sthref264"></a> -<p class="titleinfigure">Table Associations</p> -<img src="img/table_associations.png" alt="" title="" /><br /></div> -<!-- class="figure" --></li> +<p><code>long, Long</code></p> +</li> <li> -<p>After editing the table associations, click <span class="bold">Next</span>.</p> +<p><code>Timestamp</code></p> +</li> +</ul> +<p>To create a version mapping:</p> +<ol> +<li> +<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map.</p> </li> <li> -<p>On the <a href="ref_customizeDefaultEntityGeneration.htm#CIAEJDBE">Customize Default Entity Generation</a> page, customize the mapping and class information for each generated entity.</p> -<div class="figure"><a id="sthref265" name="sthref265"></a> -<p class="titleinfigure">Customize Default Entity Generation</p> -<img src="img/customize_default_entity_generation.png" alt="" title="" /><br /></div> +<p>Right-click the field and then select <span class="bold">Map As > Version</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> +<div class="figure"><a id="sthref267" name="sthref267"></a> +<p class="titleinfigure">JPA Details, Version Mapping</p> +<img src="img/jpa_details_version.png" alt="JPA Details, Version Mapping" title="JPA Details, Version Mapping" /><br /></div> <!-- class="figure" --></li> <li> -<p>After customizing the mappings, click <span class="bold">Next</span>.</p> +<p>Complete each field in the <a href="reference038.htm#CACHAEBB">Version Mapping</a> area.</p> </li> <li> -<p>On the <a href="ref_customizIndividualEntities.htm#CIACIGEE">Customize Individual Entities</a> page, review the mapping and class information for each entity that will be generated, then click <span class="bold">Finish</span>.</p> -<div class="figure"><a id="sthref266" name="sthref266"></a> -<p class="titleinfigure">Customize Individual Entities</p> -<img src="img/customize_individual_entities.png" alt="" title="" /><br /></div> -<!-- class="figure" --></li> +<p>Complete the remaining areas in the <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>:</p> +<ul> +<li> +<p><a href="reference039.htm#CACIHAAF">Type information</a></p> +</li> +<li> +<p><a href="reference041.htm#CACJCHJB">Converters</a></p> +</li> +</ul> +</li> </ol> -<p>Eclipse creates a Java persistent entity for each database table. Each entity contains fields based on the table's columns. Eclipse will also generate entity relationships (such as one-to-one) based on the table constraints. <a href="#CIHJIJJC">Figure: Generating Entities from Tables</a> illustrates how Eclipse generates entities from tables.</p> -<div class="figure"><a id="CIHJIJJC" name="CIHJIJJC"></a> -<p class="titleinfigure">Generating Entities from Tables</p> -<img src="img/table_entity.png" alt="This figure shows the EMPLOYEE and ADDRESS entities generated from database tables." title="This figure shows the EMPLOYEE and ADDRESS entities generated from database tables." /><br /></div> -<!-- class="figure" --> -<a id="sthref267" name="sthref267"></a> +<p>Eclipse adds the following annotations to the field:</p> +<pre xml:space="preserve" class="oac_no_warn"> +@Version +@Column(table="<span class="italic"><COLUMN_TABLE></span>", name="<<span class="italic">COLUMN_NAME</span>>") + +</pre> +<a id="sthref268" name="sthref268"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="task_create_new_project.htm#CIHHEJCJ">Creating a new JPA project</a></p> +<p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref268" name="sthref268"></a> -<p class="subhead2">Related reference</p> +<a id="sthref269" name="sthref269"></a> +<p class="subhead2">Related references</p> <ul> <li> -<p><a href="reference058.htm#CACDCIGD">Project Properties Page – Entity Generation</a></p> +<p><a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a></p> +</li> +<li> +<p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> +</li> +</ul> +<a id="sthref270" name="sthref270"></a> +<p class="subhead2">Related concepts</p> +<ul> +<li> +<p><a href="concept_mapping.htm#BABBDJFI">Understanding OR mappings</a></p> +</li> +<li> +<p><a href="concepts001.htm#BABBGFJG">Understanding Java Persistence API</a></p> </li> </ul> </div> +<!-- class="sect2" --> <!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks022.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks022.htm index d7b76768b4..275a852db8 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks022.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks022.htm @@ -5,104 +5,85 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Generating tables from entities</title> +<title>Generating entities from tables</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:57Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Generating tables from entities" /> +<meta name="doctitle" content="Generating entities from tables" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIHJIGBE" name="CIHJIGBE"></a></p> -<div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1>Generating tables from entities</h1> -<p><a id="sthref269" name="sthref269"></a><a id="sthref270" name="sthref270"></a><a id="sthref271" name="sthref271"></a>When using a vendor-specific platform, you can create a DDL script from your persistent entities.</p> -<div align="center"> -<div class="inftblnote"><br /> -<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> -<tbody> -<tr> -<td align="left"> -<p class="notep1">Note:</p> -<p>The DDL script will <code>DROP</code> existing tables on the database and <code>CREATE</code> new tables, based on the entities in your project.</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblnote" --></div> -<p>To generate a DDL script:</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABBAGFI" name="BABBAGFI"></a></p> +<div class="sect1"> +<h1>Generating entities from tables</h1> +<p><a id="sthref271" name="sthref271"></a><a id="sthref272" name="sthref272"></a>Use this procedure to generate Java persistent entities from database tables. You must create a JPA project and establish a database connection <span class="italic">before</span> generating persistent entities. See <a href="task_create_new_project.htm#CIHHEJCJ">"Creating a new JPA project"</a> for more information.<a id="sthref273" name="sthref273"></a><a id="sthref274" name="sthref274"></a></p> +<p>To use the <a href="reference014.htm#CIAGHCGA">Generate Tables from Entities wizard</a>:</p> <ol> <li> -<p>Right-click the JPA project in the <span class="gui-object-title">Project Explorer</span> and select <span class="gui-object-action">JPA Tools > Generate Tables from Entities</span>.</p> -<img src="img/generate_tables_from_entities.png" alt="JPA Tools > Generate Tables from Entities" title="JPA Tools > Generate Tables from Entities" /><br /></li> +<p>Right-click the JPA project in the <span class="gui-object-title">Project Explorer</span> and select <span class="gui-object-action">JPA Tools > Generate Entities from Tables</span>.</p> +<div class="figure"><a id="sthref275" name="sthref275"></a> +<p class="titleinfigure">Generating Entities from Tables</p> +<img src="img/generate_entities.png" alt="Using the JPA Tools > Generate Entities menu option." title="Using the JPA Tools > Generate Entities menu option." /><br /></div> +<!-- class="figure" --></li> +<li> +<p>On the <a href="ref_selectTables.htm#CIAHCGEE">Select Tables</a> page of the <a href="ref_create_custom_entities_wizard.htm#CIAGBFJE">Generate Entities from Tables wizard</a>, select your database connection and schema.</p> +<p>To create a new database connection, click <span class="bold">Add connection</span>.</p> +<p>If you are not currently connected to the database, the Database Connection page appears. Select your database connection and schema, and click <span class="bold">Reconnect</span>.</p> +<div class="figure"><a id="sthref276" name="sthref276"></a> +<p class="titleinfigure">Select Tables</p> +<img src="img/select_tables.png" alt="" title="" /><br /></div> +<!-- class="figure" --></li> +<li> +<p>After selecting a schema, select the tables from which to generate Java persistent entities and click <span class="bold">Next</span>.</p> +</li> +<li> +<p>On the <a href="ref_tableAssociations.htm#CIACDICB">Table Associations</a> page, select the associations to generate. You can specify to generate specific references for each association.</p> +<p>To create a new association, click <span class="bold">Add Association</span>. Use the <a href="ref_create_new_association_wizard.htm#CIAFGHIF">Create New Association wizard</a> wizard to define the association.</p> +<div class="figure"><a id="sthref277" name="sthref277"></a> +<p class="titleinfigure">Table Associations</p> +<img src="img/table_associations.png" alt="" title="" /><br /></div> +<!-- class="figure" --></li> +<li> +<p>After editing the table associations, click <span class="bold">Next</span>.</p> +</li> <li> -<p>On the <a href="reference011.htm#CACHAJEG">Schema Generation</a> page, select the generation output mode.</p> -<div class="figure"><a id="sthref272" name="sthref272"></a> -<p class="titleinfigure">Schema Generation</p> -<img src="img/generate_tables.png" alt="" title="" /><br /></div> +<p>On the <a href="ref_customizeDefaultEntityGeneration.htm#CIAEJDBE">Customize Default Entity Generation</a> page, customize the mapping and class information for each generated entity.</p> +<div class="figure"><a id="sthref278" name="sthref278"></a> +<p class="titleinfigure">Customize Default Entity Generation</p> +<img src="img/customize_default_entity_generation.png" alt="" title="" /><br /></div> <!-- class="figure" --></li> <li> -<p>Click <span class="bold">Finish</span>. Dali generates the selected DDL for the entities, as shown in <a href="#CIHJAHAC">Example: Sample Generated Output</a>.</p> +<p>After customizing the mappings, click <span class="bold">Next</span>.</p> </li> +<li> +<p>On the <a href="ref_customizIndividualEntities.htm#CIACIGEE">Customize Individual Entities</a> page, review the mapping and class information for each entity that will be generated, then click <span class="bold">Finish</span>.</p> +<div class="figure"><a id="sthref279" name="sthref279"></a> +<p class="titleinfigure">Customize Individual Entities</p> +<img src="img/customize_individual_entities.png" alt="" title="" /><br /></div> +<!-- class="figure" --></li> </ol> -<p>If you are not currently connected to the database, the Database Connection page appears. Select your database connection and schema, and click <span class="bold">Reconnect</span>.</p> -<div class="example"><a id="CIHJAHAC" name="CIHJAHAC"></a> -<p class="titleinexample">Sample Generated Output</p> -<pre xml:space="preserve" class="oac_no_warn"> -[EL Config]: metadata: The access type for the persistent class [class quickstart.demo.model.Address] is set to [FIELD]. -[EL Config]: metadata: The alias name for the entity class [class quickstart.demo.model.Address] is being defaulted to: Address. -[EL Config]: metadata: The table name for entity [class quickstart.demo.model.Address] is being defaulted to: ADDRESS. -[EL Config]: metadata: The column name for element [street] is being defaulted to: STREET. -[EL Config]: metadata: The column name for element [city] is being defaulted to: CITY. -[EL Config]: metadata: The column name for element [country] is being defaulted to: COUNTRY. -[EL Info]: EclipseLink, version: Eclipse Persistence Services - 2.4.0.vXXXX -[EL Fine]: connection: Detected database platform: org.eclipse.persistence.platform.database.JavaDBPlatform -[EL Config]: connection: Connection(7896086)--connecting(DatabaseLogin( - platform=>JavaDBPlatform - user name=> "" - datasource URL=> "jdbc:derby:C:\MyDB;create=true" -)) -[EL Config]: connection: Connection(28523022)--Connected: jdbc:derby:C:\MyDB - User: APP - Database: Apache Derby Version: 10.9.1.0 - (XXXX) - Driver: Apache Derby Embedded JDBC Driver Version: 10.9.1.0 - (XXXX) -[EL Config]: connection: Connection(27817788)--connecting(DatabaseLogin( - platform=>JavaDBPlatform - user name=> "" - datasource URL=> "jdbc:derby:C:\MyDB;create=true" -)) -[EL Config]: connection: Connection(11557581)--Connected: jdbc:derby:C:\MyDB - User: APP - Database: Apache Derby Version: 10.9.1.0 - (XXXX) - Driver: Apache Derby Embedded JDBC Driver Version: 10.9.1.0 - (XXXX) -[EL Info]: connection: file:/C:/workspace/runtime-EclipseApplication/QuickStart/build/classes/_QuickStart_url=jdbc:derby:C:\Documents and Settings\rsapir\MyDB;create=true login successful -[EL Fine]: sql: Connection(28523022)--DROP TABLE ADDRESS -[EL Fine]: sql: Connection(28523022)--CREATE TABLE ADDRESS (ADDRESS_ID BIGINT NOT NULL, CITY VARCHAR(255), COUNTRY VARCHAR(255), P_CODE VARCHAR(255), PROVINCE VARCHAR(255), STREET VARCHAR(255), PRIMARY KEY (ADDRESS_ID)) -[EL Config]: connection: Connection(28523022)--disconnect -[EL Info]: connection: file:/C://workspace/runtime-EclipseApplication/QuickStart/build/classes/_QuickStart_url=jdbc:derby:C:\MyDB;create=true logout successful -[EL Config]: connection: Connection(7896086)--disconnect -[EL Config]: connection: Connection(11557581)--disconnect - -</pre></div> -<!-- class="example" --> -<a id="sthref273" name="sthref273"></a> +<p>Eclipse creates a Java persistent entity for each database table. Each entity contains fields based on the table's columns. Eclipse will also generate entity relationships (such as one-to-one) based on the table constraints. <a href="#CIHJIJJC">Figure: Generating Entities from Tables</a> illustrates how Eclipse generates entities from tables.</p> +<div class="figure"><a id="CIHJIJJC" name="CIHJIJJC"></a> +<p class="titleinfigure">Generating Entities from Tables</p> +<img src="img/table_entity.png" alt="This figure shows the EMPLOYEE and ADDRESS entities generated from database tables." title="This figure shows the EMPLOYEE and ADDRESS entities generated from database tables." /><br /></div> +<!-- class="figure" --> +<a id="sthref280" name="sthref280"></a> <p class="subhead2">Related tasks</p> <ul> <li> -<p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> +<p><a href="task_create_new_project.htm#CIHHEJCJ">Creating a new JPA project</a></p> </li> </ul> -<a id="sthref274" name="sthref274"></a> +<a id="sthref281" name="sthref281"></a> <p class="subhead2">Related reference</p> <ul> <li> -<p><a href="ref_project_properties.htm#BABJHBCI">Project Properties page – JPA Options</a></p> +<p><a href="reference062.htm#CACDCIGD">Project Properties page – Entity Generation</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks023.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks023.htm index b103d84bdc..f58502483e 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks023.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks023.htm @@ -5,80 +5,107 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Generating dynamic entities from tables</title> +<title>Generating tables from entities</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Generating dynamic entities from tables" /> +<meta name="doctitle" content="Generating tables from entities" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIHHFGIG" name="CIHHFGIG"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIHJIGBE" name="CIHJIGBE"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1>Generating dynamic entities from tables</h1> -<p><a id="sthref275" name="sthref275"></a><a id="sthref276" name="sthref276"></a><a id="sthref277" name="sthref277"></a><a id="sthref278" name="sthref278"></a>When using EclipseLink JPA, you can create dynamic entities from your database tables. This dynamic persistence provides access to a relational database with all the benefits of JPA <span class="italic">without coding</span> or maintaining Java classes.</p> -<p>Dali dynamically creates the classes at runtime, as needed.</p> -<p>To generate dynamic entities:</p> +<h1>Generating tables from entities</h1> +<p><a id="sthref282" name="sthref282"></a><a id="sthref283" name="sthref283"></a><a id="sthref284" name="sthref284"></a>When using a vendor-specific platform, you can create a DDL script from your persistent entities.</p> +<div align="center"> +<div class="inftblnote"><br /> +<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> +<tbody> +<tr> +<td align="left"> +<p class="notep1">Note:</p> +<p>The DDL script will <code>DROP</code> existing tables on the database and <code>CREATE</code> new tables, based on the entities in your project.</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblnote" --></div> +<p>To generate a DDL script:</p> <ol> <li> -<p>Right-click the JPA project in the <span class="gui-object-title">Project Explorer</span> and select <span class="gui-object-action">JPA Tools > Generate Dynamic Entities from Tables</span>.</p> -<img src="img/generate_dynamic_entities.png" alt="JPA Tools > Generate Dynamic Entities from Tables" title="JPA Tools > Generate Dynamic Entities from Tables" /><br /> -<p>The Select Tables page of the <a href="reference002.htm#CACGDFDJ">Generate Dynamic Entities from Tables wizard</a> appears.</p> -<div class="figure"><a id="sthref279" name="sthref279"></a> -<p class="titleinfigure">Select Tables</p> -<img src="img/select_tables_dynamic.png" alt="" title="" /><br /></div> -<!-- class="figure" --></li> -<li> -<p>On the <a href="reference003.htm#CACFGHJF">Select Tables</a> page, select the tables from which to generate the entities and click <span class="bold">Next</span>.</p> -<p>The <a href="reference004.htm#CACBDJAC">Table Associations</a> page appears.</p> -<div class="figure"><a id="sthref280" name="sthref280"></a> -<p class="titleinfigure">Table Associations</p> -<img src="img/table_associations_dynamic.png" alt="" title="" /><br /></div> -<!-- class="figure" --></li> -<li> -<p>On the <a href="reference004.htm#CACBDJAC">Table Associations</a> page, specify which table associations should be generated. Use the <a href="ref_create_new_association_wizard.htm#CIAFGHIF">Create New Association wizard</a> to create additional relationships.</p> -<p>Click <span class="bold">Next</span>. The <a href="reference005.htm#CACHHEEH">Customize Default Entity Generation</a> page appears.</p> -<div class="figure"><a id="sthref281" name="sthref281"></a> -<p class="titleinfigure">Customize Defaults</p> -<img src="img/customize_default_entity_generation_dynamic.png" alt="" title="" /><br /></div> -<!-- class="figure" --></li> +<p>Right-click the JPA project in the <span class="gui-object-title">Project Explorer</span> and select <span class="gui-object-action">JPA Tools > Generate Tables from Entities</span>.</p> +<img src="img/generate_tables_from_entities.png" alt="JPA Tools > Generate Tables from Entities" title="JPA Tools > Generate Tables from Entities" /><br /></li> <li> -<p>On the <a href="reference005.htm#CACHHEEH">Customize Default Entity Generation</a> page, specify the default information to use when generating the entities, and click <span class="bold">Next</span>.</p> -<p>The <a href="reference006.htm#CACDGDIC">Customize Individual Entities</a> page appears.</p> -<div class="figure"><a id="sthref282" name="sthref282"></a> -<p class="titleinfigure">Customize Individual Entities</p> -<img src="img/customize_individual_entities_dynamic.png" alt="" title="" /><br /></div> +<p>On the <a href="reference015.htm#CACHAJEG">Schema Generation</a> page, select the generation output mode.</p> +<div class="figure"><a id="sthref285" name="sthref285"></a> +<p class="titleinfigure">Schema Generation</p> +<img src="img/generate_tables.png" alt="" title="" /><br /></div> <!-- class="figure" --></li> <li> -<p>Use the <a href="reference006.htm#CACDGDIC">Customize Individual Entities</a> page to customize specific generated entities.</p> -</li> -<li> -<p>Click <span class="bold">Finish</span> to complete the wizard and generate the entities.</p> +<p>Click <span class="bold">Finish</span>. Dali generates the selected DDL for the entities, as shown in <a href="#CIHJAHAC">Example: Sample Generated Output</a>.</p> </li> </ol> -<p>Dali generates the dynamic entities, using the <code>VIRTUAL</code> access type, as shown in <a href="#CIHIDHAB">Example: Sample eclipselink-orm.xml File with Dynamic Entities</a>.</p> -<div class="example"><a id="CIHIDHAB" name="CIHIDHAB"></a> -<p class="titleinexample"><a id="sthref283" name="sthref283"></a>Sample eclipselink-orm.xml File with Dynamic Entities</p> +<p>If you are not currently connected to the database, the Database Connection page appears. Select your database connection and schema, and click <span class="bold">Reconnect</span>.</p> +<div class="example"><a id="CIHJAHAC" name="CIHJAHAC"></a> +<p class="titleinexample">Sample Generated Output</p> <pre xml:space="preserve" class="oac_no_warn"> -<?xml version="1.0" encoding="UTF-8"?> -<entity-mappings version="2.4" xmlns="http://www.eclipse.org/eclipselink/xsds/persistence/orm" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.eclipse.org/eclipselink/xsds/persistence/orm http://www.eclipse.org/eclipselink/xsds/eclipselink_orm_2_4.xsd"> - <entity class="quickstart.demo.model.Inventory" <span class="bold">access="VIRTUAL"</span>> - <attributes> - <id name="itemSku" attribute-type="long"> +[EL Config]: metadata: The access type for the persistent class [class quickstart.demo.model.Address] is set to [FIELD]. +[EL Config]: metadata: The alias name for the entity class [class quickstart.demo.model.Address] is being defaulted to: Address. +[EL Config]: metadata: The table name for entity [class quickstart.demo.model.Address] is being defaulted to: ADDRESS. +[EL Config]: metadata: The column name for element [street] is being defaulted to: STREET. +[EL Config]: metadata: The column name for element [city] is being defaulted to: CITY. +[EL Config]: metadata: The column name for element [country] is being defaulted to: COUNTRY. +[EL Info]: EclipseLink, version: Eclipse Persistence Services - 2.4.0.vXXXX +[EL Fine]: connection: Detected database platform: org.eclipse.persistence.platform.database.JavaDBPlatform +[EL Config]: connection: Connection(7896086)--connecting(DatabaseLogin( + platform=>JavaDBPlatform + user name=> "" + datasource URL=> "jdbc:derby:C:\MyDB;create=true" +)) +[EL Config]: connection: Connection(28523022)--Connected: jdbc:derby:C:\MyDB + User: APP + Database: Apache Derby Version: 10.9.1.0 - (XXXX) + Driver: Apache Derby Embedded JDBC Driver Version: 10.9.1.0 - (XXXX) +[EL Config]: connection: Connection(27817788)--connecting(DatabaseLogin( + platform=>JavaDBPlatform + user name=> "" + datasource URL=> "jdbc:derby:C:\MyDB;create=true" +)) +[EL Config]: connection: Connection(11557581)--Connected: jdbc:derby:C:\MyDB + User: APP + Database: Apache Derby Version: 10.9.1.0 - (XXXX) + Driver: Apache Derby Embedded JDBC Driver Version: 10.9.1.0 - (XXXX) +[EL Info]: connection: file:/C:/workspace/runtime-EclipseApplication/QuickStart/build/classes/_QuickStart_url=jdbc:derby:C:\Documents and Settings\rsapir\MyDB;create=true login successful +[EL Fine]: sql: Connection(28523022)--DROP TABLE ADDRESS +[EL Fine]: sql: Connection(28523022)--CREATE TABLE ADDRESS (ADDRESS_ID BIGINT NOT NULL, CITY VARCHAR(255), COUNTRY VARCHAR(255), P_CODE VARCHAR(255), PROVINCE VARCHAR(255), STREET VARCHAR(255), PRIMARY KEY (ADDRESS_ID)) +[EL Config]: connection: Connection(28523022)--disconnect +[EL Info]: connection: file:/C://workspace/runtime-EclipseApplication/QuickStart/build/classes/_QuickStart_url=jdbc:derby:C:\MyDB;create=true logout successful +[EL Config]: connection: Connection(7896086)--disconnect +[EL Config]: connection: Connection(11557581)--disconnect - </id> - </attributes> - </entity> - <entity ..."> - </entity> -</entity-mappings> </pre></div> -<!-- class="example" --></div> +<!-- class="example" --> +<a id="sthref286" name="sthref286"></a> +<p class="subhead2">Related tasks</p> +<ul> +<li> +<p><a href="task_create_jpa_entity.htm#BABFBJBG">Creating a JPA entity</a></p> +</li> +</ul> +<a id="sthref287" name="sthref287"></a> +<p class="subhead2">Related reference</p> +<ul> +<li> +<p><a href="ref_project_properties.htm#BABJHBCI">Project Properties page – JPA Options</a></p> +</li> +</ul> +</div> <!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks024.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks024.htm index 2807c0cff3..0d37fafe14 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks024.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks024.htm @@ -5,67 +5,81 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Validating mappings and reporting problems</title> +<title>Generating dynamic entities from tables</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Validating mappings and reporting problems" /> +<meta name="doctitle" content="Generating dynamic entities from tables" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABFAIBA" name="BABFAIBA"></a></p> -<div class="sect1"> -<h1>Validating mappings and reporting problems</h1> -<p><a id="sthref284" name="sthref284"></a><a id="sthref285" name="sthref285"></a><a id="sthref286" name="sthref286"></a><a id="sthref287" name="sthref287"></a>Errors and warnings on persistent entities and mappings are indicated with a red error or yellow warning next to the resource with the error, as well as the parent containers up to the project.</p> -<div align="center"> -<div class="inftblnotealso"><br /> -<table class="NoteAlso oac_no_warn" summary="" cellpadding="3" cellspacing="0"> -<tbody> -<tr> -<td align="left"> -<p class="notep1">Tip:</p> -<p>Use the <a href="reference059.htm#CACEEJJB">Project Properties page – Errors/Warnings</a> and <a href="reference056.htm#CACFGIDG">Java Persistence Preferences page – Errors/Warnings</a> to specify which problems Dali will report.</p> -</td> -</tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblnotealso" --></div> -<div class="figure"><a id="sthref288" name="sthref288"></a> -<p class="titleinfigure">Sample Errors and Warnings</p> -<img src="img/error_sample.png" alt="This figure shows sample error and warning icons in the Explorer view." title="This figure shows sample error and warning icons in the Explorer view." /><br /></div> -<!-- class="figure" --> -<p>This section contains information on the following:</p> -<ul> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIHHFGIG" name="CIHHFGIG"></a></p> +<div class="sect1"><!-- infolevel="all" infotype="General" --> +<h1>Generating dynamic entities from tables</h1> +<p><a id="sthref288" name="sthref288"></a><a id="sthref289" name="sthref289"></a><a id="sthref290" name="sthref290"></a><a id="sthref291" name="sthref291"></a>When using EclipseLink JPA, you can create dynamic entities from your database tables. This dynamic persistence provides access to a relational database with all the benefits of JPA <span class="italic">without coding</span> or maintaining Java classes.</p> +<p>Dali dynamically creates the classes at runtime, as needed.</p> +<p>To generate dynamic entities:</p> +<ol> <li> -<p><a href="tasks025.htm#CIHFEDEI">Error messages</a></p> -</li> +<p>Right-click the JPA project in the <span class="gui-object-title">Project Explorer</span> and select <span class="gui-object-action">JPA Tools > Generate Dynamic Entities from Tables</span>.</p> +<img src="img/generate_dynamic_entities.png" alt="JPA Tools > Generate Dynamic Entities from Tables" title="JPA Tools > Generate Dynamic Entities from Tables" /><br /> +<p>The Select Tables page of the <a href="reference002.htm#CACGDFDJ">Generate Dynamic Entities from Tables wizard</a> appears.</p> +<div class="figure"><a id="sthref292" name="sthref292"></a> +<p class="titleinfigure">Select Tables</p> +<img src="img/select_tables_dynamic.png" alt="" title="" /><br /></div> +<!-- class="figure" --></li> <li> -<p><a href="tasks026.htm#CIHGEAIJ">Warning messages</a></p> -</li> -</ul> -<a id="sthref289" name="sthref289"></a> -<p class="subhead2">Related reference</p> -<ul> +<p>On the <a href="reference003.htm#CACFGHJF">Select Tables</a> page, select the tables from which to generate the entities and click <span class="bold">Next</span>.</p> +<p>The <a href="reference004.htm#CACBDJAC">Table Associations</a> page appears.</p> +<div class="figure"><a id="sthref293" name="sthref293"></a> +<p class="titleinfigure">Table Associations</p> +<img src="img/table_associations_dynamic.png" alt="" title="" /><br /></div> +<!-- class="figure" --></li> <li> -<p><a href="reference059.htm#CACEEJJB">Project Properties page – Errors/Warnings</a></p> -</li> +<p>On the <a href="reference004.htm#CACBDJAC">Table Associations</a> page, specify which table associations should be generated. Use the <a href="ref_create_new_association_wizard.htm#CIAFGHIF">Create New Association wizard</a> to create additional relationships.</p> +<p>Click <span class="bold">Next</span>. The <a href="reference005.htm#CACHHEEH">Customize Default Entity Generation</a> page appears.</p> +<div class="figure"><a id="sthref294" name="sthref294"></a> +<p class="titleinfigure">Customize Defaults</p> +<img src="img/customize_default_entity_generation_dynamic.png" alt="" title="" /><br /></div> +<!-- class="figure" --></li> +<li> +<p>On the <a href="reference005.htm#CACHHEEH">Customize Default Entity Generation</a> page, specify the default information to use when generating the entities, and click <span class="bold">Next</span>.</p> +<p>The <a href="reference006.htm#CACDGDIC">Customize Individual Entities</a> page appears.</p> +<div class="figure"><a id="sthref295" name="sthref295"></a> +<p class="titleinfigure">Customize Individual Entities</p> +<img src="img/customize_individual_entities_dynamic.png" alt="" title="" /><br /></div> +<!-- class="figure" --></li> <li> -<p><a href="reference056.htm#CACFGIDG">Java Persistence Preferences page – Errors/Warnings</a></p> +<p>Use the <a href="reference006.htm#CACDGDIC">Customize Individual Entities</a> page to customize specific generated entities.</p> </li> -</ul> -<a id="sthref290" name="sthref290"></a> -<p class="subhead2">Related concepts</p> -<ul> <li> -<p><a href="../org.eclipse.platform.doc.user/concepts/cprbview.htm">Problems view</a></p> +<p>Click <span class="bold">Finish</span> to complete the wizard and generate the entities.</p> </li> -</ul> +</ol> +<p>Dali generates the dynamic entities, using the <code>VIRTUAL</code> access type, as shown in <a href="#CIHIDHAB">Example: Sample eclipselink-orm.xml File with Dynamic Entities</a>.</p> +<div class="example"><a id="CIHIDHAB" name="CIHIDHAB"></a> +<p class="titleinexample"><a id="sthref296" name="sthref296"></a>Sample eclipselink-orm.xml File with Dynamic Entities</p> +<pre xml:space="preserve" class="oac_no_warn"> +<?xml version="1.0" encoding="UTF-8"?> +<entity-mappings version="2.4" xmlns="http://www.eclipse.org/eclipselink/xsds/persistence/orm" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.eclipse.org/eclipselink/xsds/persistence/orm http://www.eclipse.org/eclipselink/xsds/eclipselink_orm_2_4.xsd"> + <entity class="quickstart.demo.model.Inventory" <span class="bold">access="VIRTUAL"</span>> + <attributes> + <id name="itemSku" attribute-type="long"> + + </id> + </attributes> + </entity> + <entity ..."> + </entity> +</entity-mappings> +</pre></div> +<!-- class="example" --></div> +<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> @@ -77,6 +91,6 @@ </tr> </table> </div> -<!-- class="footer" --></div> +<!-- class="footer" --> </body> </html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks025.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks025.htm index f3de7752e3..eabfe3dfba 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks025.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks025.htm @@ -5,85 +5,67 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Error messages</title> +<title>Validating mappings and reporting problems</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Error messages" /> +<meta name="doctitle" content="Validating mappings and reporting problems" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIHFEDEI" name="CIHFEDEI"></a></p> -<div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Error messages<a id="sthref291" name="sthref291"></a></h1> -<p>This section contains information on error messages (including how to resolve the issue) you may encounter while working with Dali.</p> -<a id="sthref292" name="sthref292"></a> -<p class="subhead2">Attribute "<span class="italic"><ATTRIBUTE__NAME></span>" has invalid mapping type in this context</p> -<p>The mapped attribute is invalid. Either change the mapping type or change the entity type.</p> -<p>See <a href="task_mapping.htm#BABDGBIJ">"Mapping an entity"</a> for more information.</p> -<a id="sthref293" name="sthref293"></a> -<p class="subhead2">Attribute "<span class="italic"><ATTRIBUTE_NAME></span>" cannot be resolved.</p> -<p>Dali cannot map the attribute to a database table and column. Verify that you database connection information is correct.</p> -<p>See <a href="task_create_new_project.htm#CIHHEJCJ">"Creating a new JPA project"</a> for more information.</p> -<a id="sthref294" name="sthref294"></a> -<p class="subhead2">Class "<span class="italic"><CLASS_NAME></span>" is not annotated as a persistent class.</p> -<p>The class has not been identified as a persistent class. Configure the class as an Entity, Mapped Superclass, or Embeddable persistent entity.</p> -<p>See <a href="task_add_persistence.htm#BABHICAI">"Adding persistence to a class"</a>.</p> -<a id="sthref295" name="sthref295"></a> -<p class="subhead2">Column "<span class="italic"><COLUMN_NAME></span>" cannot be resolved.</p> -<p>You mapped an entity's field to an incorrect or invalid column in the database table. By default, Dali will attempt to map each field in the entity with an identically named row in the database table. If the field's name differs from the row's name, you must explicitly create the mapping.</p> -<p>Map the field to a valid row in the database table as shown in <a href="task_mapping.htm#BABDGBIJ">"Mapping an entity"</a>.</p> -<a id="sthref296" name="sthref296"></a> -<p class="subhead2">Duplicate class "<span class="italic"><CLASS_NAME></span>".</p> -<p>You created to persistence classes with the same name. Each Java class must have a unique name. See <a href="task_add_persistence.htm#BABHICAI">"Adding persistence to a class"</a> for more information.</p> -<a id="sthref297" name="sthref297"></a> -<p class="subhead2">Embeddable attribute "<span class="italic"><ATTRIBUTE_NAME></span>" mapped to unresolved column.</p> -<p><span class="italic">Complete information will be available in a future build.</span></p> -<a id="sthref298" name="sthref298"></a> -<p class="subhead2">Entity does not have an Id or Embedded Id.</p> -<p>You created a persistent entity without identifying its primary key. A persistent entity must have a primary key field designated with an <code>@Id</code> or <code>@EmbeddedId</code> annotation.</p> -<p>Add an ID mapping to the entity as shown in <a href="tasks014.htm#BABGCBHG">"ID mapping"</a> or <a href="tasks013.htm#CIHDIAEE">"Embedded ID mapping"</a>.</p> -<a id="sthref299" name="sthref299"></a> -<p class="subhead2">Multiple persistence.xml files in project.</p> -<p>You created a JPA project with more than one <code>persistence.xml</code> file. Each JPA project must contain a <span class="italic">single</span> <code>persistence.xml</code> file.</p> -<p>See <a href="task_manage_persistence.htm#CIHDAJID">"Managing the persistence.xml file"</a> for more information.</p> -<a id="sthref300" name="sthref300"></a> -<p class="subhead2">No persistence unit defined.</p> -<p>There is no persistence unit defined in the <code>persistence.xml</code> file. Use the <persistence-unit name="<span class="italic"><PERSISTENCE_UNIT_NAME></span>" tag to define the persistent unit.</p> -<p>See <a href="task_manage_orm.htm#CIHDGDCD">"Managing the orm.xml file"</a> for more information.</p> -<a id="sthref301" name="sthref301"></a> -<p class="subhead2">No persistence.xml file in project.</p> -<p>You created a JPA project without a <code>persistence.xml</code> file. Each JPA project must contain a <span class="italic">single</span> <code>persistence.xml</code> file.</p> -<p>See <a href="task_manage_persistence.htm#CIHDAJID">"Managing the persistence.xml file"</a> for more information.</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABFAIBA" name="BABFAIBA"></a></p> +<div class="sect1"> +<h1>Validating mappings and reporting problems</h1> +<p><a id="sthref297" name="sthref297"></a><a id="sthref298" name="sthref298"></a><a id="sthref299" name="sthref299"></a><a id="sthref300" name="sthref300"></a>Errors and warnings on persistent entities and mappings are indicated with a red error or yellow warning next to the resource with the error, as well as the parent containers up to the project.</p> +<div align="center"> +<div class="inftblnotealso"><br /> +<table class="NoteAlso oac_no_warn" summary="" cellpadding="3" cellspacing="0"> +<tbody> +<tr> +<td align="left"> +<p class="notep1">Tip:</p> +<p>Use the <a href="reference063.htm#CACEEJJB">Project Properties page – Errors/Warnings</a> and <a href="reference060.htm#CACFGIDG">Java Persistence Preferences page – Errors/Warnings</a> to specify which problems Dali will report.</p> +</td> +</tr> +</tbody> +</table> +<br /></div> +<!-- class="inftblnotealso" --></div> +<div class="figure"><a id="sthref301" name="sthref301"></a> +<p class="titleinfigure">Sample Errors and Warnings</p> +<img src="img/error_sample.png" alt="This figure shows sample error and warning icons in the Explorer view." title="This figure shows sample error and warning icons in the Explorer view." /><br /></div> +<!-- class="figure" --> +<p>This section contains information on the following:</p> +<ul> +<li> +<p><a href="tasks026.htm#CIHFEDEI">Error messages</a></p> +</li> +<li> +<p><a href="tasks027.htm#CIHGEAIJ">Warning messages</a></p> +</li> +</ul> <a id="sthref302" name="sthref302"></a> -<p class="subhead2">Referenced column "<span class="italic"><COLUMN_NAME></span>" in join column "<span class="italic"><COLUMN_NAME></span>" cannot be resolved.</p> -<p>The column that you selected to join a relationship mapping does not exist on the database table. Either select a different column on the <a href="reference039.htm#CACIJEGI">Joining Strategy</a> or create the necessary column on the database table.</p> -<p>See <a href="ref_persistence_map_view.htm#BABIFBAF">"JPA Details view (for attributes)"</a> for more information.</p> +<p class="subhead2">Related reference</p> +<ul> +<li> +<p><a href="reference063.htm#CACEEJJB">Project Properties page – Errors/Warnings</a></p> +</li> +<li> +<p><a href="reference060.htm#CACFGIDG">Java Persistence Preferences page – Errors/Warnings</a></p> +</li> +</ul> <a id="sthref303" name="sthref303"></a> -<p class="subhead2">Schema "<<span class="italic">SCHEMA_NAME</span>>" cannot be resolved for table/join table "<<span class="italic">TABLE_NAME</span>>".</p> -<p>Define the default database schema information in the persistence unit.</p> -<p>See <a href="task_manage_orm.htm#CIHDGDCD">"Managing the orm.xml file"</a> for more information.</p> -<a id="sthref304" name="sthref304"></a> -<p class="subhead2">Table "<span class="italic"><TABLE_NAME></span>" cannot be resolved.</p> -<p>You associated a persistent entity to an incorrect or invalid database table. By default, Dali will attempt to associate each persistent entity with an identically named database table. If the entity's name differs from the table's name, you must explicitly create the association.</p> -<p>Associate the entity with a valid database table as shown in <a href="task_add_persistence.htm#BABHICAI">"Adding persistence to a class"</a>.</p> -<a id="sthref305" name="sthref305"></a> -<p class="subhead2">Unresolved generator "<span class="italic"><GENERATOR_NAME></span>" is defined in persistence unit.</p> -<p>You created a persistence entity that uses sequencing or a table generator, but did not define the generator in the persistence unit. Either define the generator by using an annotation or including it in the XML mapping file.</p> -<a id="sthref306" name="sthref306"></a> <p class="subhead2">Related concepts</p> <ul> <li> <p><a href="../org.eclipse.platform.doc.user/concepts/cprbview.htm">Problems view</a></p> </li> </ul> -</div> -<!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> @@ -95,6 +77,6 @@ </tr> </table> </div> -<!-- class="footer" --> +<!-- class="footer" --></div> </body> </html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks026.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks026.htm index 2c414a9abf..211653c713 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks026.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks026.htm @@ -5,31 +5,77 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Warning messages</title> +<title>Error messages</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Warning messages" /> +<meta name="doctitle" content="Error messages" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIHGEAIJ" name="CIHGEAIJ"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIHFEDEI" name="CIHFEDEI"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Warning messages</h1> -<p>This section contains information on warning messages (including how to resolve the issue) you may encounter while working with Dali.</p> +<h1>Error messages<a id="sthref304" name="sthref304"></a></h1> +<p>This section contains information on error messages (including how to resolve the issue) you may encounter while working with Dali.</p> +<a id="sthref305" name="sthref305"></a> +<p class="subhead2">Attribute "<span class="italic"><ATTRIBUTE__NAME></span>" has invalid mapping type in this context</p> +<p>The mapped attribute is invalid. Either change the mapping type or change the entity type.</p> +<p>See <a href="task_mapping.htm#BABDGBIJ">"Mapping an entity"</a> for more information.</p> +<a id="sthref306" name="sthref306"></a> +<p class="subhead2">Attribute "<span class="italic"><ATTRIBUTE_NAME></span>" cannot be resolved.</p> +<p>Dali cannot map the attribute to a database table and column. Verify that you database connection information is correct.</p> +<p>See <a href="task_create_new_project.htm#CIHHEJCJ">"Creating a new JPA project"</a> for more information.</p> <a id="sthref307" name="sthref307"></a> -<p class="subhead2">Connection "<span class="italic"><CONNECTION_NAME></span>" is not active. No validation will be done against the data source.</p> -<p>The database connection you specified to use with the JPA project is not active. The JPA project requires an active connection.</p> +<p class="subhead2">Class "<span class="italic"><CLASS_NAME></span>" is not annotated as a persistent class.</p> +<p>The class has not been identified as a persistent class. Configure the class as an Entity, Mapped Superclass, or Embeddable persistent entity.</p> +<p>See <a href="task_add_persistence.htm#BABHICAI">"Adding persistence to a class"</a>.</p> <a id="sthref308" name="sthref308"></a> -<p class="subhead2">No connection specified for the project. No data-specific validation will be performed.</p> -<p>You created a JPA project without specifying a database connection. The JPA project requires an active connection.</p> -<p>See <a href="task_create_new_project.htm#CIHHEJCJ">"Creating a new JPA project"</a> or <a href="tasks027.htm#BABDBCBI">"Modifying persistent project properties"</a> for information on specifying a database connection.</p> +<p class="subhead2">Column "<span class="italic"><COLUMN_NAME></span>" cannot be resolved.</p> +<p>You mapped an entity's field to an incorrect or invalid column in the database table. By default, Dali will attempt to map each field in the entity with an identically named row in the database table. If the field's name differs from the row's name, you must explicitly create the mapping.</p> +<p>Map the field to a valid row in the database table as shown in <a href="task_mapping.htm#BABDGBIJ">"Mapping an entity"</a>.</p> <a id="sthref309" name="sthref309"></a> +<p class="subhead2">Duplicate class "<span class="italic"><CLASS_NAME></span>".</p> +<p>You created to persistence classes with the same name. Each Java class must have a unique name. See <a href="task_add_persistence.htm#BABHICAI">"Adding persistence to a class"</a> for more information.</p> +<a id="sthref310" name="sthref310"></a> +<p class="subhead2">Embeddable attribute "<span class="italic"><ATTRIBUTE_NAME></span>" mapped to unresolved column.</p> +<p><span class="italic">Complete information will be available in a future build.</span></p> +<a id="sthref311" name="sthref311"></a> +<p class="subhead2">Entity does not have an Id or Embedded Id.</p> +<p>You created a persistent entity without identifying its primary key. A persistent entity must have a primary key field designated with an <code>@Id</code> or <code>@EmbeddedId</code> annotation.</p> +<p>Add an ID mapping to the entity as shown in <a href="tasks015.htm#BABGCBHG">"ID mapping"</a> or <a href="tasks014.htm#CIHDIAEE">"Embedded ID mapping"</a>.</p> +<a id="sthref312" name="sthref312"></a> +<p class="subhead2">Multiple persistence.xml files in project.</p> +<p>You created a JPA project with more than one <code>persistence.xml</code> file. Each JPA project must contain a <span class="italic">single</span> <code>persistence.xml</code> file.</p> +<p>See <a href="task_manage_persistence.htm#CIHDAJID">"Managing the persistence.xml file"</a> for more information.</p> +<a id="sthref313" name="sthref313"></a> +<p class="subhead2">No persistence unit defined.</p> +<p>There is no persistence unit defined in the <code>persistence.xml</code> file. Use the <persistence-unit name="<span class="italic"><PERSISTENCE_UNIT_NAME></span>" tag to define the persistent unit.</p> +<p>See <a href="task_manage_orm.htm#CIHDGDCD">"Managing the orm.xml file"</a> for more information.</p> +<a id="sthref314" name="sthref314"></a> +<p class="subhead2">No persistence.xml file in project.</p> +<p>You created a JPA project without a <code>persistence.xml</code> file. Each JPA project must contain a <span class="italic">single</span> <code>persistence.xml</code> file.</p> +<p>See <a href="task_manage_persistence.htm#CIHDAJID">"Managing the persistence.xml file"</a> for more information.</p> +<a id="sthref315" name="sthref315"></a> +<p class="subhead2">Referenced column "<span class="italic"><COLUMN_NAME></span>" in join column "<span class="italic"><COLUMN_NAME></span>" cannot be resolved.</p> +<p>The column that you selected to join a relationship mapping does not exist on the database table. Either select a different column on the <a href="reference043.htm#CACIJEGI">Joining Strategy</a> or create the necessary column on the database table.</p> +<p>See <a href="ref_persistence_map_view.htm#BABIFBAF">"JPA Details view (for attributes)"</a> for more information.</p> +<a id="sthref316" name="sthref316"></a> +<p class="subhead2">Schema "<<span class="italic">SCHEMA_NAME</span>>" cannot be resolved for table/join table "<<span class="italic">TABLE_NAME</span>>".</p> +<p>Define the default database schema information in the persistence unit.</p> +<p>See <a href="task_manage_orm.htm#CIHDGDCD">"Managing the orm.xml file"</a> for more information.</p> +<a id="sthref317" name="sthref317"></a> +<p class="subhead2">Table "<span class="italic"><TABLE_NAME></span>" cannot be resolved.</p> +<p>You associated a persistent entity to an incorrect or invalid database table. By default, Dali will attempt to associate each persistent entity with an identically named database table. If the entity's name differs from the table's name, you must explicitly create the association.</p> +<p>Associate the entity with a valid database table as shown in <a href="task_add_persistence.htm#BABHICAI">"Adding persistence to a class"</a>.</p> +<a id="sthref318" name="sthref318"></a> +<p class="subhead2">Unresolved generator "<span class="italic"><GENERATOR_NAME></span>" is defined in persistence unit.</p> +<p>You created a persistence entity that uses sequencing or a table generator, but did not define the generator in the persistence unit. Either define the generator by using an annotation or including it in the XML mapping file.</p> +<a id="sthref319" name="sthref319"></a> <p class="subhead2">Related concepts</p> <ul> <li> @@ -38,7 +84,6 @@ </ul> </div> <!-- class="sect2" --> -<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks027.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks027.htm index 9413c452de..4f6ae109ca 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks027.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks027.htm @@ -5,60 +5,39 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Modifying persistent project properties</title> +<title>Warning messages</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Modifying persistent project properties" /> +<meta name="doctitle" content="Warning messages" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="BABDBCBI" name="BABDBCBI"></a></p> -<div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1>Modifying persistent project properties</h1> -<p><a id="sthref310" name="sthref310"></a><a id="sthref311" name="sthref311"></a>Each persistent project must be associated with a database connection. To create a new database connection, click <span class="gui-object-action">Database Connection</span> use the New Connection wizard.</p> -<p>Use this procedure to modify the vender-specific platform and database connection associated with your JPA project.</p> -<ol> -<li> -<p>Right-click the project in the <span class="gui-object-title">Explorer</span> view and select <span class="gui-object-action">Properties</span>. The Properties page appears.</p> -</li> -<li> -<p>Select <span class="bold">JPA</span>.</p> -<div class="figure"><a id="sthref312" name="sthref312"></a> -<p class="titleinfigure">The Properties Page</p> -<img src="img/project_properties_tasks.png" alt="The Persistence page." title="The Persistence page." /><br /></div> -<!-- class="figure" --></li> -<li> -<p>Complete each field on the <a href="ref_project_properties.htm#BABJHBCI">Project Properties page – JPA Options</a> click <span class="bold">OK</span>.</p> -</li> -</ol> -<a id="sthref313" name="sthref313"></a> -<p class="subhead2">Related tasks</p> -<ul> -<li> -<p><a href="task_create_new_project.htm#CIHHEJCJ">Creating a new JPA project</a></p> -</li> -</ul> -<a id="sthref314" name="sthref314"></a> -<p class="subhead2">Related reference</p> -<ul> -<li> -<p><a href="ref_project_properties.htm#BABJHBCI">Project Properties page – JPA Options</a></p> -</li> -</ul> -<a id="sthref315" name="sthref315"></a> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIHGEAIJ" name="CIHGEAIJ"></a></p> +<div class="sect2"><!-- infolevel="all" infotype="General" --> +<h1>Warning messages</h1> +<p>This section contains information on warning messages (including how to resolve the issue) you may encounter while working with Dali.</p> +<a id="sthref320" name="sthref320"></a> +<p class="subhead2">Connection "<span class="italic"><CONNECTION_NAME></span>" is not active. No validation will be done against the data source.</p> +<p>The database connection you specified to use with the JPA project is not active. The JPA project requires an active connection.</p> +<a id="sthref321" name="sthref321"></a> +<p class="subhead2">No connection specified for the project. No data-specific validation will be performed.</p> +<p>You created a JPA project without specifying a database connection. The JPA project requires an active connection.</p> +<p>See <a href="task_create_new_project.htm#CIHHEJCJ">"Creating a new JPA project"</a> or <a href="tasks028.htm#BABDBCBI">"Modifying persistent project properties"</a> for information on specifying a database connection.</p> +<a id="sthref322" name="sthref322"></a> <p class="subhead2">Related concepts</p> <ul> <li> -<p><a href="concept_persistence.htm#BABCAHIC">Understanding Java persistence</a></p> +<p><a href="../org.eclipse.platform.doc.user/concepts/cprbview.htm">Problems view</a></p> </li> </ul> </div> +<!-- class="sect2" --> <!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks028.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks028.htm index 1043348a3c..ca515e6c9b 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks028.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks028.htm @@ -5,38 +5,53 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Converting JPA metadata to XML</title> +<title>Modifying persistent project properties</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:40Z" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Converting JPA metadata to XML" /> +<meta name="doctitle" content="Modifying persistent project properties" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> -<p><a id="CIHEHCHB" name="CIHEHCHB"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="BABDBCBI" name="BABDBCBI"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> -<h1>Converting JPA metadata to XML</h1> -<p><a id="sthref316" name="sthref316"></a><a id="sthref317" name="sthref317"></a><a id="sthref318" name="sthref318"></a><a id="sthref319" name="sthref319"></a>Starting in Release 3.2, Dali can convert metadata (such as converters, queries, and generators) into an XML mapping file. This allows you to maintain the global metadata for a persistence unit (such as queries and generators) in an XML mapping file.</p> +<h1>Modifying persistent project properties</h1> +<p><a id="sthref323" name="sthref323"></a><a id="sthref324" name="sthref324"></a>Each persistent project must be associated with a database connection. To create a new database connection, click <span class="gui-object-action">Database Connection</span> use the New Connection wizard.</p> +<p>Use this procedure to modify the vender-specific platform and database connection associated with your JPA project.</p> <ol> <li> -<p>Right-click the project in the <span class="gui-object-title">Explorer</span> view and select <span class="gui-object-action">JPA Tools > Move to XML</span> > specific metadata (such as <span class="bold">Java Converters</span>, <span class="bold">Java Queries</span>, or <span class="bold">Java Generators</span>).</p> -<div class="figure"><a id="sthref320" name="sthref320"></a> -<p class="titleinfigure">Moving Metadata to XML</p> -<img src="img/move_to_xml.png" alt="Moving Metadata to XML" title="Moving Metadata to XML" /><br /></div> -<!-- class="figure" --> -<p>The <a href="reference064.htm#CACJBCGG">JPA Metadata Conversion dialog</a> page appears.</p> +<p>Right-click the project in the <span class="gui-object-title">Explorer</span> view and select <span class="gui-object-action">Properties</span>. The Properties page appears.</p> </li> <li> -<p>Enter the filename and location of the XML mapping file, and click <span class="bold">Finish</span>.</p> +<p>Select <span class="bold">JPA</span>.</p> +<div class="figure"><a id="sthref325" name="sthref325"></a> +<p class="titleinfigure">The Properties Page</p> +<img src="img/project_properties_tasks.png" alt="The Persistence page." title="The Persistence page." /><br /></div> +<!-- class="figure" --></li> +<li> +<p>Complete each field on the <a href="ref_project_properties.htm#BABJHBCI">Project Properties page – JPA Options</a> click <span class="bold">OK</span>.</p> </li> </ol> -<p>Dali generates the XML file.</p> -<a id="sthref321" name="sthref321"></a> +<a id="sthref326" name="sthref326"></a> +<p class="subhead2">Related tasks</p> +<ul> +<li> +<p><a href="task_create_new_project.htm#CIHHEJCJ">Creating a new JPA project</a></p> +</li> +</ul> +<a id="sthref327" name="sthref327"></a> +<p class="subhead2">Related reference</p> +<ul> +<li> +<p><a href="ref_project_properties.htm#BABJHBCI">Project Properties page – JPA Options</a></p> +</li> +</ul> +<a id="sthref328" name="sthref328"></a> <p class="subhead2">Related concepts</p> <ul> <li> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks029.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks029.htm new file mode 100644 index 0000000000..c2f1ca975a --- /dev/null +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks029.htm @@ -0,0 +1,61 @@ +<!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> +<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> +<meta http-equiv="Content-Style-Type" content="text/css" /> +<meta http-equiv="Content-Script-Type" content="text/javascript" /> +<title>Converting JPA metadata to XML</title> +<meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> +<meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> +<meta name="date" content="2012-09-19T13:27:58Z" /> +<meta name="robots" content="noarchive" /> +<meta name="doctitle" content="Converting JPA metadata to XML" /> +<meta name="relnum" content="Release 3.2" /> +<meta name="partnum" content="Release 3.2" /> +<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" /> +</head> +<body> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> +<p><a id="CIHEHCHB" name="CIHEHCHB"></a></p> +<div class="sect1"><!-- infolevel="all" infotype="General" --> +<h1>Converting JPA metadata to XML</h1> +<p><a id="sthref329" name="sthref329"></a><a id="sthref330" name="sthref330"></a><a id="sthref331" name="sthref331"></a><a id="sthref332" name="sthref332"></a>Starting in Release 3.2, Dali can convert metadata (such as converters, queries, and generators) into an XML mapping file. This allows you to maintain the global metadata for a persistence unit (such as queries and generators) in an XML mapping file.</p> +<ol> +<li> +<p>Right-click the project in the <span class="gui-object-title">Explorer</span> view and select <span class="gui-object-action">JPA Tools > Move to XML</span> > specific metadata (such as <span class="bold">Java Converters</span>, <span class="bold">Java Queries</span>, or <span class="bold">Java Generators</span>).</p> +<div class="figure"><a id="sthref333" name="sthref333"></a> +<p class="titleinfigure">Moving Metadata to XML</p> +<img src="img/move_to_xml.png" alt="Moving Metadata to XML" title="Moving Metadata to XML" /><br /></div> +<!-- class="figure" --> +<p>The <a href="reference070.htm#CACJBCGG">JPA Metadata Conversion dialog</a> page appears.</p> +</li> +<li> +<p>Enter the filename and location of the XML mapping file, and click <span class="bold">Finish</span>.</p> +</li> +</ol> +<p>Dali generates the XML file.</p> +<a id="sthref334" name="sthref334"></a> +<p class="subhead2">Related concepts</p> +<ul> +<li> +<p><a href="concept_persistence.htm#BABCAHIC">Understanding Java persistence</a></p> +</li> +</ul> +</div> +<!-- class="sect1" --> +<!-- Start Footer --> +<div class="footer"> +<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> +<col width="86%" /> +<col width="*" /> +<tr> +<td align="left"><span class="copyrightlogo">Copyright © 2011, 2012, Oracle and/or its affiliates. All rights reserved.</span><br /> +<a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Legal Notices</span></a></td> +</tr> +</table> +</div> +<!-- class="footer" --> +</body> +</html>
\ No newline at end of file diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tips_and_tricks.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tips_and_tricks.htm index 1600b582d6..811f4f3d03 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tips_and_tricks.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tips_and_tricks.htm @@ -8,7 +8,7 @@ <title>Tips and tricks</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:44Z" /> +<meta name="date" content="2012-09-19T13:28:2Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Tips and tricks" /> <meta name="relnum" content="Release 3.2" /> @@ -18,7 +18,7 @@ </head> <body> <p><a id="CHDHGHBF" name="CHDHGHBF"></a></p> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <h1>Tips and tricks</h1> <p>The following tips and tricks give some helpful ideas for increasing your productivity.</p> <div class="inftblhruleinformalwide"> @@ -31,7 +31,7 @@ <p><span class="bold">Database connections</span></p> </td> <td align="left"> -<p><a id="sthref644" name="sthref644"></a>When starting a new workbench session, be sure to <a href="../org.eclipse.datatools.connectivity.doc.user/doc/html/asc1229700343352.html">reconnect to your database</a> (if you are working online). This allows Dali to provide database-related mapping assistance and validation.</p> +<p><a id="sthref692" name="sthref692"></a>When starting a new workbench session, be sure to <a href="../org.eclipse.datatools.connectivity.doc.user/doc/html/asc1229700343352.html">reconnect to your database</a> (if you are working online). This allows Dali to provide database-related mapping assistance and validation.</p> </td> </tr> <tr align="left" valign="top"> @@ -39,7 +39,7 @@ <p><span class="bold">Schema-based persistence.xml file</span></p> </td> <td align="left" headers="r2c1-t2"> -<p><a id="sthref645" name="sthref645"></a><a id="sthref646" name="sthref646"></a>If you are behind a firewall, you may need to configure your Eclipse workspace proxy in the <a href="../org.eclipse.platform.doc.user/reference/ref-72.htm">Preferences dialog</a> (<span class="gui-object-action">Preferences > Internet > Proxy Settings</span>) to properly validate a schema-based <code>persistence.xml</code> file.</p> +<p><a id="sthref693" name="sthref693"></a><a id="sthref694" name="sthref694"></a>If you are behind a firewall, you may need to configure your Eclipse workspace proxy in the <a href="../org.eclipse.platform.doc.user/reference/ref-72.htm">Preferences dialog</a> (<span class="gui-object-action">Preferences > Internet > Proxy Settings</span>) to properly validate a schema-based <code>persistence.xml</code> file.</p> </td> </tr> <tr align="left" valign="top"> @@ -47,7 +47,7 @@ <p><span class="bold">@XmlPath content assist and validation</span></p> </td> <td align="left" headers="r3c1-t2"> -<p><a id="sthref647" name="sthref647"></a><a id="sthref648" name="sthref648"></a>Dali supports <code>@XmlPath</code> content assist and validation. You can now easily traverse deeply nested XML structures specifying <code>XmlPath</code> values.</p> +<p><a id="sthref695" name="sthref695"></a><a id="sthref696" name="sthref696"></a>Dali supports <code>@XmlPath</code> content assist and validation. You can now easily traverse deeply nested XML structures specifying <code>XmlPath</code> values.</p> <img src="img/xmlpath_validation.png" alt="" title="" /></td> </tr> <tr align="left" valign="top"> @@ -55,7 +55,7 @@ <p><span class="bold">Making persistent entities</span></p> </td> <td align="left" headers="r4c1-t2"> -<p>With the <a href="reference065.htm#CACIBDFB">Make Persistent dialog</a>, you can easily transform Java classes into persistent entities via Java annotation or entry in an XML mapping file. With multi-select, you can quickly create many entities at once.</p> +<p>With the <a href="reference071.htm#CACIBDFB">Make Persistent dialog</a>, you can easily transform Java classes into persistent entities via Java annotation or entry in an XML mapping file. With multi-select, you can quickly create many entities at once.</p> <img src="img/MakePersistentMenu.png" alt="" title="" /></td> </tr> </tbody> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/title.htm b/jpa/plugins/org.eclipse.jpt.doc.user/title.htm index ff3ee71ef1..e36c68232f 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/title.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/title.htm @@ -8,7 +8,7 @@ <title>Dali Java Persistence Tools User Guide</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:36Z" /> +<meta name="date" content="2012-09-19T13:27:53Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Dali Java Persistence Tools User Guide" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <h1>Dali Java Persistence Tools</h1> <p class="booktitle">User Guide</p> <p></p> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/toc.xml b/jpa/plugins/org.eclipse.jpt.doc.user/toc.xml index 4cb3779ada..047069a6b9 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/toc.xml +++ b/jpa/plugins/org.eclipse.jpt.doc.user/toc.xml @@ -18,46 +18,47 @@ </topic> <topic href="tasks.htm" label="Tasks"> <topic href="task_create_new_project.htm" label="Creating a new JPA project" /> - <topic href="tasks001.htm" label="Converting a Java project to a JPA project" /> + <topic href="tasks001.htm" label="Creating a new JAXB project" /> + <topic href="tasks002.htm" label="Converting a Java project to a JPA project" /> <topic href="task_create_jpa_entity.htm" label="Creating a JPA entity" /> <topic href="task_add_persistence.htm" label="Adding persistence to a class"> - <topic href="tasks002.htm" label="Entity" /> - <topic href="tasks003.htm" label="Embeddable" /> - <topic href="tasks004.htm" label="Mapped superclass" /> + <topic href="tasks003.htm" label="Entity" /> + <topic href="tasks004.htm" label="Embeddable" /> + <topic href="tasks005.htm" label="Mapped superclass" /> </topic> - <topic href="tasks005.htm" label="Adding virtual attributes" /> + <topic href="tasks006.htm" label="Adding virtual attributes" /> <topic href="task_manage_persistence.htm" label="Managing the persistence.xml file"> - <topic href="tasks006.htm" label="Synchronizing classes" /> + <topic href="tasks007.htm" label="Synchronizing classes" /> </topic> <topic href="task_manage_orm.htm" label="Managing the orm.xml file"> - <topic href="tasks007.htm" label="Creating an orm.xml file" /> - <topic href="tasks008.htm" label="Working with orm.xml file" /> + <topic href="tasks008.htm" label="Creating an orm.xml file" /> + <topic href="tasks009.htm" label="Working with orm.xml file" /> </topic> <topic href="task_additonal_tables.htm" label="Specifying additional tables" /> <topic href="task_inheritance.htm" label="Specifying entity inheritance" /> - <topic href="tasks009.htm" label="Creating queries" /> + <topic href="tasks010.htm" label="Creating queries" /> <topic href="task_mapping.htm" label="Mapping an entity"> - <topic href="tasks010.htm" label="Basic mapping" /> - <topic href="tasks011.htm" label="Element collection mapping" /> - <topic href="tasks012.htm" label="Embedded mapping" /> - <topic href="tasks013.htm" label="Embedded ID mapping" /> - <topic href="tasks014.htm" label="ID mapping" /> - <topic href="tasks015.htm" label="Many-to-many mapping" /> - <topic href="tasks016.htm" label="Many-to-one mapping" /> - <topic href="tasks017.htm" label="One-to-many mapping" /> - <topic href="tasks018.htm" label="One-to-one mapping" /> - <topic href="tasks019.htm" label="Transient mapping" /> - <topic href="tasks020.htm" label="Version mapping" /> + <topic href="tasks011.htm" label="Basic mapping" /> + <topic href="tasks012.htm" label="Element collection mapping" /> + <topic href="tasks013.htm" label="Embedded mapping" /> + <topic href="tasks014.htm" label="Embedded ID mapping" /> + <topic href="tasks015.htm" label="ID mapping" /> + <topic href="tasks016.htm" label="Many-to-many mapping" /> + <topic href="tasks017.htm" label="Many-to-one mapping" /> + <topic href="tasks018.htm" label="One-to-many mapping" /> + <topic href="tasks019.htm" label="One-to-one mapping" /> + <topic href="tasks020.htm" label="Transient mapping" /> + <topic href="tasks021.htm" label="Version mapping" /> </topic> - <topic href="tasks021.htm" label="Generating entities from tables" /> - <topic href="tasks022.htm" label="Generating tables from entities" /> - <topic href="tasks023.htm" label="Generating dynamic entities from tables" /> - <topic href="tasks024.htm" label="Validating mappings and reporting problems"> - <topic href="tasks025.htm" label="Error messages" /> - <topic href="tasks026.htm" label="Warning messages" /> + <topic href="tasks022.htm" label="Generating entities from tables" /> + <topic href="tasks023.htm" label="Generating tables from entities" /> + <topic href="tasks024.htm" label="Generating dynamic entities from tables" /> + <topic href="tasks025.htm" label="Validating mappings and reporting problems"> + <topic href="tasks026.htm" label="Error messages" /> + <topic href="tasks027.htm" label="Warning messages" /> </topic> - <topic href="tasks027.htm" label="Modifying persistent project properties" /> - <topic href="tasks028.htm" label="Converting JPA metadata to XML" /> + <topic href="tasks028.htm" label="Modifying persistent project properties" /> + <topic href="tasks029.htm" label="Converting JPA metadata to XML" /> </topic> <topic label="Reference"> <topic label="Wizards"> @@ -86,8 +87,13 @@ <topic href="ref_java_page.htm" label="Java Page" /> <topic href="ref_jpa_facet.htm" label="JPA Facet page" /> </topic> - <topic href="reference010.htm" label="Generate Tables from Entities wizard"> - <topic href="reference011.htm" label="Schema Generation" /> + <topic href="reference010.htm" label="Create New JAXB Project wizard"> + <topic href="reference011.htm" label="New JAXB Project page" /> + <topic href="reference012.htm" label="Java Page" /> + <topic href="reference013.htm" label="JAXB Facet page" /> + </topic> + <topic href="reference014.htm" label="Generate Tables from Entities wizard"> + <topic href="reference015.htm" label="Schema Generation" /> </topic> <topic href="ref_create_new_association_wizard.htm" label="Create New Association wizard"> <topic href="ref_association_table.htm" label="Association Tables" /> @@ -97,84 +103,88 @@ </topic> <topic label="Property pages"> <topic href="ref_persistence_prop_view.htm" label="JPA Details view (for entities)"> - <topic href="reference013.htm" label="Entity" /> - <topic href="reference014.htm" label="Embeddable" /> - <topic href="reference015.htm" label="Mapped Superclass" /> - <topic href="reference016.htm" label="Caching" /> - <topic href="reference017.htm" label="Queries" /> - <topic href="reference018.htm" label="Inheritance" /> - <topic href="reference019.htm" label="Attribute Overrides" /> - <topic href="reference020.htm" label="Multitenancy" /> - <topic href="reference021.htm" label="Primary Key Generation" /> - <topic href="reference022.htm" label="Secondary tables" /> - <topic href="reference023.htm" label="Converters" /> - <topic href="reference024.htm" label="Advanced" /> + <topic href="reference017.htm" label="Entity" /> + <topic href="reference018.htm" label="Embeddable" /> + <topic href="reference019.htm" label="Mapped Superclass" /> + <topic href="reference020.htm" label="Caching" /> + <topic href="reference021.htm" label="Queries" /> + <topic href="reference022.htm" label="Inheritance" /> + <topic href="reference023.htm" label="Attribute Overrides" /> + <topic href="reference024.htm" label="Multitenancy" /> + <topic href="reference025.htm" label="Primary Key Generation" /> + <topic href="reference026.htm" label="Secondary tables" /> + <topic href="reference027.htm" label="Converters" /> + <topic href="reference028.htm" label="Advanced" /> </topic> <topic href="ref_persistence_map_view.htm" label="JPA Details view (for attributes)"> - <topic href="reference025.htm" label="Basic Mapping" /> - <topic href="reference026.htm" label="Element Collection Mapping" /> - <topic href="reference027.htm" label="Embedded Mapping" /> - <topic href="reference028.htm" label="Embedded ID Mapping" /> - <topic href="reference029.htm" label="ID Mapping" /> - <topic href="reference030.htm" label="Many-to-Many Mapping" /> - <topic href="reference031.htm" label="Many-to-One Mapping" /> - <topic href="reference032.htm" label="One-to-Many Mapping" /> - <topic href="reference033.htm" label="One-to-One Mapping" /> - <topic href="reference034.htm" label="Version Mapping" /> - <topic href="reference035.htm" label="Type information" /> - <topic href="reference036.htm" label="Value" /> - <topic href="reference037.htm" label="Converters" /> - <topic href="reference038.htm" label="Ordering" /> - <topic href="reference039.htm" label="Joining Strategy" /> - <topic href="reference040.htm" label="Derived Identity" /> + <topic href="reference029.htm" label="Basic Mapping" /> + <topic href="reference030.htm" label="Element Collection Mapping" /> + <topic href="reference031.htm" label="Embedded Mapping" /> + <topic href="reference032.htm" label="Embedded ID Mapping" /> + <topic href="reference033.htm" label="ID Mapping" /> + <topic href="reference034.htm" label="Many-to-Many Mapping" /> + <topic href="reference035.htm" label="Many-to-One Mapping" /> + <topic href="reference036.htm" label="One-to-Many Mapping" /> + <topic href="reference037.htm" label="One-to-One Mapping" /> + <topic href="reference038.htm" label="Version Mapping" /> + <topic href="reference039.htm" label="Type information" /> + <topic href="reference040.htm" label="Value" /> + <topic href="reference041.htm" label="Converters" /> + <topic href="reference042.htm" label="Ordering" /> + <topic href="reference043.htm" label="Joining Strategy" /> + <topic href="reference044.htm" label="Derived Identity" /> <topic href="ref_primary_key.htm" label="Primary Key Generation information" /> </topic> <topic href="ref_details_orm.htm" label="JPA Details view (for orm.xml)"> - <topic href="reference041.htm" label="Entity Mappings" /> - <topic href="reference042.htm" label="Persistence Unit" /> - <topic href="reference043.htm" label="Generators" /> - <topic href="reference044.htm" label="Queries" /> - <topic href="reference045.htm" label="Converters" /> + <topic href="reference045.htm" label="Entity Mappings" /> + <topic href="reference046.htm" label="Persistence Unit" /> + <topic href="reference047.htm" label="Generators" /> + <topic href="reference048.htm" label="Queries" /> + <topic href="reference049.htm" label="Converters" /> </topic> <topic href="ref_persistence_outline.htm" label="JPA Structure view" /> <topic href="ref_persistence_xmll_editor.htm" label="persistence.xml Editor"> <topic href="ref_persistence_general.htm" label="General" /> - <topic href="reference046.htm" label="Connection" /> - <topic href="reference047.htm" label="Customization" /> - <topic href="reference048.htm" label="Caching" /> - <topic href="reference049.htm" label="Logging" /> - <topic href="reference050.htm" label="Options" /> - <topic href="reference051.htm" label="Schema Generation" /> - <topic href="reference052.htm" label="Properties" /> - <topic href="reference053.htm" label="Source" /> + <topic href="reference050.htm" label="Connection" /> + <topic href="reference051.htm" label="Customization" /> + <topic href="reference052.htm" label="Caching" /> + <topic href="reference053.htm" label="Logging" /> + <topic href="reference054.htm" label="Options" /> + <topic href="reference055.htm" label="Schema Generation" /> + <topic href="reference056.htm" label="Properties" /> + <topic href="reference057.htm" label="Source" /> </topic> </topic> <topic label="Preferences"> - <topic href="reference055.htm" label="Java Persistence Preferences page - JPA" /> - <topic href="reference056.htm" label="Java Persistence Preferences page - Errors/Warnings" /> + <topic href="reference059.htm" label="Java Persistence Preferences page - JPA" /> + <topic href="reference060.htm" label="Java Persistence Preferences page - Errors/Warnings" /> <topic href="ref_project_properties.htm" label="Project Properties page - JPA Options" /> - <topic href="reference057.htm" label="Project Properties page - EclipseLink" /> - <topic href="reference058.htm" label="Project Properties Page - Entity Generation" /> - <topic href="reference059.htm" label="Project Properties page - Errors/Warnings" /> + <topic href="reference061.htm" label="Project Properties page - EclipseLink" /> + <topic href="reference062.htm" label="Project Properties page - Entity Generation" /> + <topic href="reference063.htm" label="Project Properties page - Errors/Warnings" /> + <topic href="reference064.htm" label="Project Properties page - JAXB Options" /> + <topic href="reference065.htm" label="Project Properties page - Schemas" /> </topic> <topic label="Dialogs"> - <topic href="reference061.htm" label="Edit Join Columns Dialog" /> - <topic href="reference062.htm" label="Add Join Column dialog" /> + <topic href="reference067.htm" label="Edit Join Columns Dialog" /> + <topic href="reference068.htm" label="Add Join Column dialog" /> <topic href="ref_select_cascade_dialog.htm" label="Select Cascade dialog" /> <topic href="ref_eclipselink_mapping_file.htm" label="New EclipseLink Mapping File dialog" /> <topic href="ref_add_converter.htm" label="Add Converter dialog" /> - <topic href="reference063.htm" label="Mapping Type Selection dialog" /> - <topic href="reference064.htm" label="JPA Metadata Conversion dialog" /> - <topic href="reference065.htm" label="Make Persistent dialog" /> - <topic href="reference066.htm" label="Add Query dialog" /> - <topic href="reference067.htm" label="Add Primary Key Join Column dialog" /> + <topic href="reference069.htm" label="Mapping Type Selection dialog" /> + <topic href="reference070.htm" label="JPA Metadata Conversion dialog" /> + <topic href="reference071.htm" label="Make Persistent dialog" /> + <topic href="reference072.htm" label="Add Query dialog" /> + <topic href="reference073.htm" label="Add Primary Key Join Column dialog" /> + <topic href="reference074.htm" label="Add Schema Location dialog" /> + <topic href="reference075.htm" label="Select Schema Location dialog" /> </topic> <topic href="ref_persistence_perspective.htm" label="JPA Development perspective" /> <topic label="Icons and buttons"> - <topic href="reference069.htm" label="Icons" /> - <topic href="reference070.htm" label="Buttons" /> + <topic href="reference077.htm" label="Icons" /> + <topic href="reference078.htm" label="Buttons" /> </topic> - <topic href="reference071.htm" label="Dali Developer Documentation" /> + <topic href="reference079.htm" label="Dali Developer Documentation" /> </topic> <topic href="tips_and_tricks.htm" label="Tips and tricks" /> <topic href="whats_new.htm" label="What's new"> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new.htm b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new.htm index fc78f9fafa..9ebd9db898 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new.htm @@ -8,7 +8,7 @@ <title>What's new</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:44Z" /> +<meta name="date" content="2012-09-19T13:28:2Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="What's new" /> <meta name="relnum" content="Release 3.2" /> @@ -18,7 +18,7 @@ </head> <body> <p><a id="CEGIAIGD" name="CEGIAIGD"></a></p> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <h1>What's new</h1> <p>This section contains descriptions of the following new features and significant changes made to the Dali OR Mapping Tool for Release 3.2 (Web Tools Platform 3.4):</p> <ul> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new001.htm b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new001.htm index eb1ea33e5f..0a97f86d6f 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new001.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new001.htm @@ -8,7 +8,7 @@ <title>EclipseLink multitenancy support</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:44Z" /> +<meta name="date" content="2012-09-19T13:28:2Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="EclipseLink multitenancy support" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CEGCBCGH" name="CEGCBCGH"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1>EclipseLink multitenancy support</h1> @@ -37,7 +37,7 @@ <p>For more information, see:</p> <ul> <li> -<p><a href="reference020.htm#CACDIJEE">"Multitenancy"</a></p> +<p><a href="reference024.htm#CACDIJEE">"Multitenancy"</a></p> </li> <li> <p>"Multitenant" in the <span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new002.htm b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new002.htm index f5fe32f6d8..1eb1bb8e64 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new002.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new002.htm @@ -8,7 +8,7 @@ <title>EclipseLink static weaving support</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:44Z" /> +<meta name="date" content="2012-09-19T13:28:3Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="EclipseLink static weaving support" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CEGJBECH" name="CEGJBECH"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1>EclipseLink static weaving support</h1> @@ -26,7 +26,7 @@ <p>For more information, see:</p> <ul> <li> -<p><a href="reference057.htm#CACFJJGG">"Project Properties page – EclipseLink"</a></p> +<p><a href="reference061.htm#CACFJJGG">"Project Properties page – EclipseLink"</a></p> </li> <li> <p>"Static Weaving" in the EclipseLink documentation<br /> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new003.htm b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new003.htm index 56e4c27762..410c01a43a 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new003.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new003.htm @@ -8,7 +8,7 @@ <title>Generating EclipseLink dynamic entities from tables</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:45Z" /> +<meta name="date" content="2012-09-19T13:28:3Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Generating EclipseLink dynamic entities from tables" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CEGBGIJH" name="CEGBGIJH"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1>Generating EclipseLink dynamic entities from tables</h1> @@ -26,7 +26,7 @@ <p>For more information, see:</p> <ul> <li> -<p><a href="tasks023.htm#CIHHFGIG">"Generating dynamic entities from tables"</a></p> +<p><a href="tasks024.htm#CIHHFGIG">"Generating dynamic entities from tables"</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new004.htm b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new004.htm index 79cf0f100a..f89c565fae 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new004.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new004.htm @@ -8,7 +8,7 @@ <title>Converting JPA metadata to XML</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:45Z" /> +<meta name="date" content="2012-09-19T13:28:3Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Converting JPA metadata to XML" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CEGIJHCJ" name="CEGIJHCJ"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1>Converting JPA metadata to XML</h1> @@ -26,7 +26,7 @@ <p>For more information, see:</p> <ul> <li> -<p><a href="tasks028.htm#CIHEHCHB">"Converting JPA metadata to XML"</a></p> +<p><a href="tasks029.htm#CIHEHCHB">"Converting JPA metadata to XML"</a></p> </li> </ul> </div> diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new005.htm b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new005.htm index c3d47e7b57..87383e041c 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/whats_new005.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/whats_new005.htm @@ -8,7 +8,7 @@ <title>EclipseLink 2.4 support</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-13T10:27:45Z" /> +<meta name="date" content="2012-09-19T13:28:3Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="EclipseLink 2.4 support" /> <meta name="relnum" content="Release 3.2" /> @@ -17,7 +17,7 @@ <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-13</p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> <p><a id="CEGIJCIF" name="CEGIJCIF"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1>EclipseLink 2.4 support</h1> |
