[jboss-cvs] JBossAS SVN: r78062 - projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Fri Sep 5 01:46:25 EDT 2008
Author: irooskov at redhat.com
Date: 2008-09-05 01:46:25 -0400 (Fri, 05 Sep 2008)
New Revision: 78062
Added:
projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Hibernate_Annotations_Reference_Guide_CP03.ent
projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Hibernate_Annotations_Reference_Guide_CP03.xml
Removed:
projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Annotations_Reference_Guide.ent
projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Annotations_Reference_Guide.xml
Modified:
projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Book_Info.xml
projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Entity.xml
projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Lucene.xml
projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Setup.xml
projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Validator.xml
projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Xml-Overriding.xml
Log:
updated for new build system
Deleted: projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Annotations_Reference_Guide.ent
===================================================================
--- projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Annotations_Reference_Guide.ent 2008-09-05 05:43:42 UTC (rev 78061)
+++ projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Annotations_Reference_Guide.ent 2008-09-05 05:46:25 UTC (rev 78062)
@@ -1,2 +0,0 @@
-<!ENTITY HOLDER "Red Hat, Inc">
-<!ENTITY YEAR "2008">
Deleted: projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Annotations_Reference_Guide.xml
===================================================================
--- projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Annotations_Reference_Guide.xml 2008-09-05 05:43:42 UTC (rev 78061)
+++ projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Annotations_Reference_Guide.xml 2008-09-05 05:46:25 UTC (rev 78062)
@@ -1,37 +0,0 @@
-<?xml version='1.0'?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-<!ENTITY % RH_ENTITIES SYSTEM "Common_Content/Entities.ent">
-%RH_ENTITIES;
-<!ENTITY % RH_TRANS_ENTITIES SYSTEM "Common_Content/Translatable-Entities.ent">
-%RH_TRANS_ENTITIES;
-]>
-
-<book>
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Book_Info.xml"/>
- <xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <preface id="Preface" revision="1"><title>Preface</title>
- <para>
- Hibernate, like all other object/relational mapping tools, requires metadata that governs the transformation of data from one representation to the other (and vice versa). In Hibernate 2.x, mapping metadata is most of the time declared in XML text files. Another option is XDoclet, utilizing Javadoc source code annotations and a preprocessor at compile time. The same kind of annotation support is now available in the standard JDK, although more powerful and better supported by tools. IntelliJ IDEA, and Eclipse for example, support auto-completion and syntax highlighting of JDK 5.0 annotations. Annotations are compiled into the bytecode and read at runtime (in Hibernate's case on startup) using reflection, so no external XML files are needed.
- </para>
- <para>
- The EJB3 specification recognizes the interest and the success of the transparent object/relational mapping paradigm. The EJB3 specification standardizes the basic APIs and the metadata needed for any object/relational persistence mechanism. <emphasis>Hibernate EntityManager</emphasis> implements the programming interfaces and lifecycle rules as defined by the EJB3 persistence specification. Together with <emphasis>Hibernate Annotations</emphasis>, this wrapper implements a complete (and standalone) EJB3 persistence solution on top of the mature Hibernate core. You may use a combination of all three together, annotations without EJB3 programming interfaces and lifecycle, or even pure native Hibernate, depending on the business and technical needs of your project. You can at all times fall back to Hibernate native APIs, or if required, even to native JDBC and SQL.
- </para>
- <para>
- This release is based on the final release of the EJB 3.0 / JPA specification (aka JSP-220) and support all the specification features (including the optional ones). Most of the Hibernate features and extensions are also available through Hibernate specific annotations compared to the specification documentation. While the Hibernate feature coverage is now very high, some are still missing. The eventual goal is to cover all of them. See the JIRA road map section for more informations.
- </para>
- <para>
- If you are moving from previous Hibernate Annotations versions, please have a look at <uri>http://www.hibernate.org/371.html</uri> for a migration guide.
- </para>
- </preface><xi:include href="Setup.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-
- <xi:include href="Entity.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-
- <xi:include href="Xml-Overriding.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-
- <xi:include href="Validator.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-
- <xi:include href="Lucene.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Revision_History.xml"/>
-
-</book>
-
Modified: projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Book_Info.xml
===================================================================
--- projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Book_Info.xml 2008-09-05 05:43:42 UTC (rev 78061)
+++ projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Book_Info.xml 2008-09-05 05:46:25 UTC (rev 78062)
@@ -3,12 +3,12 @@
]>
<bookinfo id="Hibernate_Annotations_Reference_Guide">
- <title>Annotations Reference Guide</title>
- <subtitle>for Use with JBoss Enterprise Application Platform</subtitle>
+ <title>Hibernate Annotations Reference Guide CP03</title>
+ <subtitle>for Use with JBoss Enterprise Application Platform 4.3 CP03</subtitle>
<edition>2.0</edition>
- <pubsnumber>4</pubsnumber>
- <productname>Hibernate</productname>
- <productnumber>4.3.3</productnumber>
+ <pubsnumber>1</pubsnumber>
+ <productname>JBoss Enterprise Application Platform</productname>
+ <productnumber>4.3</productnumber>
<pubdate>Sep, 2007</pubdate>
<isbn>N/A</isbn>
<abstract><para>The JBoss Enterprise Application Platform Edition of the Hibernate Annotations Reference Guide 3.2</para>
Modified: projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Entity.xml
===================================================================
--- projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Entity.xml 2008-09-05 05:43:42 UTC (rev 78061)
+++ projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Entity.xml 2008-09-05 05:46:25 UTC (rev 78062)
@@ -1,10 +1,5 @@
<?xml version='1.0'?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-<!ENTITY % RH_ENTITIES SYSTEM "Common_Content/Entities.ent">
-%RH_ENTITIES;
-<!ENTITY % RH_TRANS_ENTITIES SYSTEM "Common_Content/Translatable-Entities.ent">
-%RH_TRANS_ENTITIES;
-]>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
<chapter id="Entity_Beans">
<title>Entity Beans</title>
@@ -371,7 +366,7 @@
</para>
</listitem>
</itemizedlist>
- </sect3></sect2><sect2 id="Mapping_with_EJB3JPA_Annotations-Mapping_identifier_properties" label="" xreflabel="Mapping identifier properties"><title>Mapping identifier properties</title>
+</sect3></sect2><sect2 id="Mapping_with_EJB3JPA_Annotations-Mapping_identifier_properties" label="Mapping identifier properties"><title>Mapping identifier properties</title>
<para>
The <literal>@Id</literal> annotation lets you define which property is the identifier of your entity bean. This property can be set by the application itself or be generated by Hibernate (preferred). You can define the identifier generation strategy thanks to the <literal>@GeneratedValue</literal> annotation:
</para>
@@ -901,8 +896,6 @@
<para>
Hibernate has several notions of collections.
</para>
- <para>
- </para>
<table id="Overview-Collections_semantics">
<title>Collections semantics</title>
<tgroup cols="3">
@@ -1436,8 +1429,6 @@
<para>
The availabe Hibernate hints are
</para>
- <para>
- </para>
<table id="Mapping_JPAQLHQL_queries-Query_hints">
<title>Query hints</title>
<tgroup cols="2">
@@ -1711,7 +1702,7 @@
<para>
An other query hint specific to native queries has been introduced: <literal>org.hibernate.callable</literal> which can be true or false depending on whether the query is a stored procedure or not.
</para>
- </sect2></sect1><sect1 id="Entity_Beans-Hibernate_Annotation_Extensions" xreflabel="Hibernate Annotation Extensions"><title>Hibernate Annotation Extensions</title>
+ </sect2></sect1><sect1 id="Entity_Beans-Hibernate_Annotation_Extensions"><title>Hibernate Annotation Extensions</title>
<para>
Hibernate 3.1 offers a variety of additional annotations that you can mix/match with your EJB 3 entities. They have been designed as a natural extension of EJB3 annotations.
</para>
@@ -2060,8 +2051,6 @@
return owner;
}
</programlisting>
- <para>
- </para>
</sect3></sect2><sect2 id="Hibernate_Annotation_Extensions-Inheritance" revision="1"><title>Inheritance</title>
<para>
SINGLE_TABLE is a very powerful strategy but sometimes, and especially for legacy systems, you cannot add an additional discriminator column. For that purpose Hibernate has introduced the notion of discriminator formula: <literal>@DiscriminatorFormula</literal> is a replacement of <literal>@DiscriminatorColumn</literal> and use a SQL fragment as a formula for discriminator resolution (no need to have a dedicated column).
@@ -2298,8 +2287,6 @@
@MapKeyManyToMany(<emphasis role="bold">targetEntity = LuggageImpl.class</emphasis>)
private Map<Luggage, Size> sizePerLuggage = new HashMap<Luggage, Size>();
</programlisting>
- <para>
- </para>
</sect4><sect4 id="Extra_collection_types-Bidirectional_association_with_indexed_collections"><title>Bidirectional association with indexed collections</title>
<para>
A bidirectional association where one end is represented as a <literal>@IndexColumn</literal> or <literal>@org.hibernate.annotations.MapKey[ManyToMany]</literal> requires special consideration. If there is a property of the child class which maps to the index column, no problem, we can continue using <literal>mappedBy</literal> on the collection mapping:
@@ -2495,8 +2482,6 @@
return tickets;
}
</programlisting>
- <para>
- </para>
<programlistingco>
<areaspec>
<area coords="2 55" id="plhm1" />
@@ -2678,4 +2663,4 @@
The parameters order is important and is defined by the order Hibernate handle properties. You can see the expected order by enabling debug logging for the <literal>org.hibernate.persister.entity</literal> level. With this level enabled Hibernate will print out the static SQL that is used to create, update, delete etc. entities. (To see the expected sequence, remember to not include your custom SQL through annotations as that will override the Hibernate generated static sql.)
</para>
</sect2></sect1>
-</chapter>
\ No newline at end of file
+</chapter>
Added: projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Hibernate_Annotations_Reference_Guide_CP03.ent
===================================================================
--- projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Hibernate_Annotations_Reference_Guide_CP03.ent (rev 0)
+++ projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Hibernate_Annotations_Reference_Guide_CP03.ent 2008-09-05 05:46:25 UTC (rev 78062)
@@ -0,0 +1,2 @@
+<!ENTITY HOLDER "Red Hat, Inc">
+<!ENTITY YEAR "2008">
Added: projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Hibernate_Annotations_Reference_Guide_CP03.xml
===================================================================
--- projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Hibernate_Annotations_Reference_Guide_CP03.xml (rev 0)
+++ projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Hibernate_Annotations_Reference_Guide_CP03.xml 2008-09-05 05:46:25 UTC (rev 78062)
@@ -0,0 +1,32 @@
+<?xml version='1.0'?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
+
+<book>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Book_Info.xml"/>
+ <xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <preface id="Preface" revision="1"><title>Preface</title>
+ <para>
+ Hibernate, like all other object/relational mapping tools, requires metadata that governs the transformation of data from one representation to the other (and vice versa). In Hibernate 2.x, mapping metadata is most of the time declared in XML text files. Another option is XDoclet, utilizing Javadoc source code annotations and a preprocessor at compile time. The same kind of annotation support is now available in the standard JDK, although more powerful and better supported by tools. IntelliJ IDEA, and Eclipse for example, support auto-completion and syntax highlighting of JDK 5.0 annotations. Annotations are compiled into the bytecode and read at runtime (in Hibernate's case on startup) using reflection, so no external XML files are needed.
+ </para>
+ <para>
+ The EJB3 specification recognizes the interest and the success of the transparent object/relational mapping paradigm. The EJB3 specification standardizes the basic APIs and the metadata needed for any object/relational persistence mechanism. <emphasis>Hibernate EntityManager</emphasis> implements the programming interfaces and lifecycle rules as defined by the EJB3 persistence specification. Together with <emphasis>Hibernate Annotations</emphasis>, this wrapper implements a complete (and standalone) EJB3 persistence solution on top of the mature Hibernate core. You may use a combination of all three together, annotations without EJB3 programming interfaces and lifecycle, or even pure native Hibernate, depending on the business and technical needs of your project. You can at all times fall back to Hibernate native APIs, or if required, even to native JDBC and SQL.
+ </para>
+ <para>
+ This release is based on the final release of the EJB 3.0 / JPA specification (aka JSP-220) and support all the specification features (including the optional ones). Most of the Hibernate features and extensions are also available through Hibernate specific annotations compared to the specification documentation. While the Hibernate feature coverage is now very high, some are still missing. The eventual goal is to cover all of them. See the JIRA road map section for more informations.
+ </para>
+ <para>
+ If you are moving from previous Hibernate Annotations versions, please have a look at <uri>http://www.hibernate.org/371.html</uri> for a migration guide.
+ </para>
+ </preface><xi:include href="Setup.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Entity.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Xml-Overriding.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Validator.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Lucene.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Revision_History.xml"/>
+
+</book>
+
Modified: projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Lucene.xml
===================================================================
--- projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Lucene.xml 2008-09-05 05:43:42 UTC (rev 78061)
+++ projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Lucene.xml 2008-09-05 05:46:25 UTC (rev 78062)
@@ -1,10 +1,5 @@
<?xml version='1.0'?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-<!ENTITY % RH_ENTITIES SYSTEM "Common_Content/Entities.ent">
-%RH_ENTITIES;
-<!ENTITY % RH_TRANS_ENTITIES SYSTEM "Common_Content/Translatable-Entities.ent">
-%RH_TRANS_ENTITIES;
-]>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
<chapter id="Hibernate_Search_Apache_Lucene_Integration" revision="2">
<title>Hibernate Search: Apache <trademark>Lucene</trademark> Integration</title>
Modified: projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Setup.xml
===================================================================
--- projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Setup.xml 2008-09-05 05:43:42 UTC (rev 78061)
+++ projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Setup.xml 2008-09-05 05:46:25 UTC (rev 78062)
@@ -1,10 +1,5 @@
<?xml version='1.0'?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-<!ENTITY % RH_ENTITIES SYSTEM "Common_Content/Entities.ent">
-%RH_ENTITIES;
-<!ENTITY % RH_TRANS_ENTITIES SYSTEM "Common_Content/Translatable-Entities.ent">
-%RH_TRANS_ENTITIES;
-]>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
<chapter id="Setting_up_an_annotations_project">
<title revision="1">Setting up an annotations project</title>
Modified: projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Validator.xml
===================================================================
--- projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Validator.xml 2008-09-05 05:43:42 UTC (rev 78061)
+++ projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Validator.xml 2008-09-05 05:46:25 UTC (rev 78062)
@@ -1,10 +1,5 @@
<?xml version='1.0'?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-<!ENTITY % RH_ENTITIES SYSTEM "Common_Content/Entities.ent">
-%RH_ENTITIES;
-<!ENTITY % RH_TRANS_ENTITIES SYSTEM "Common_Content/Translatable-Entities.ent">
-%RH_TRANS_ENTITIES;
-]>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
<chapter id="Hibernate_Validator">
<title>Hibernate Validator</title>
@@ -249,7 +244,7 @@
</tbody>
</tgroup>
</table>
- </sect2><sect2 id="Constraints-Error_messages" xreflabel="Error messages"><title>Error messages</title>
+ </sect2><sect2 id="Constraints-Error_messages"><title>Error messages</title>
<para>
Hibernate Validator comes with a default set of error messages translated in about ten languages (if yours is not part of it, please sent us a patch). You can override those messages by creating a <filename>ValidatorMessages.properties</filename> or (<filename>ValidatorMessages_loc.properties</filename>) and override the needed keys. You can even add your own additional set of messages while writing your validator annotations. If Hibernate Validator cannot resolve a key from your resourceBundle nor from ValidatorMessage, it falls back to the default built-in values.
</para>
Modified: projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Xml-Overriding.xml
===================================================================
--- projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Xml-Overriding.xml 2008-09-05 05:43:42 UTC (rev 78061)
+++ projects/docs/enterprise/4.3.3/Hibernate/Annotations_Reference_Guide/en-US/Xml-Overriding.xml 2008-09-05 05:46:25 UTC (rev 78062)
@@ -1,10 +1,5 @@
<?xml version='1.0'?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-<!ENTITY % RH_ENTITIES SYSTEM "Common_Content/Entities.ent">
-%RH_ENTITIES;
-<!ENTITY % RH_TRANS_ENTITIES SYSTEM "Common_Content/Translatable-Entities.ent">
-%RH_TRANS_ENTITIES;
-]>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
<chapter id="Overriding_metadata_through_XML" label="Overriding metadata through XML">
<title>Overriding metadata through XML</title>
More information about the jboss-cvs-commits
mailing list