You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openjpa.apache.org by jr...@apache.org on 2009/07/09 19:13:44 UTC
svn commit: r792610 [3/3] - in /openjpa/trunk:
openjpa-persistence/src/main/resources/org/apache/openjpa/persistence/
openjpa-project/src/doc/manual/
Modified: openjpa/trunk/openjpa-project/src/doc/manual/jpa_overview_persistence.xml
URL: http://svn.apache.org/viewvc/openjpa/trunk/openjpa-project/src/doc/manual/jpa_overview_persistence.xml?rev=792610&r1=792609&r2=792610&view=diff
==============================================================================
--- openjpa/trunk/openjpa-project/src/doc/manual/jpa_overview_persistence.xml (original)
+++ openjpa/trunk/openjpa-project/src/doc/manual/jpa_overview_persistence.xml Thu Jul 9 17:13:43 2009
@@ -106,15 +106,15 @@
</para>
<programlisting>
<?xml version="1.0" encoding="UTF-8"?>
-<!-- persistence.xml schema -->
+ <!-- persistence.xml schema -->
<xsd:schema targetNamespace="http://java.sun.com/xml/ns/persistence"
- xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+ xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:persistence="http://java.sun.com/xml/ns/persistence"
elementFormDefault="qualified" attributeFormDefault="unqualified"
version="2.0">
<xsd:annotation>
<xsd:documentation>
- @(#)persistence_2_0.xsd 1.0 August 27 2008
+ @(#)persistence_2_0.xsd 1.0 May 8 2009
</xsd:documentation>
</xsd:annotation>
<xsd:annotation>
@@ -148,8 +148,8 @@
<xsd:complexType>
<xsd:sequence>
<!-- **************************************************** -->
- <xsd:element name="persistence-unit" minOccurs="1"
- maxOccurs="unbounded">
+ <xsd:element name="persistence-unit"
+ minOccurs="1" maxOccurs="unbounded">
<xsd:complexType>
<xsd:annotation>
<xsd:documentation>
@@ -162,8 +162,7 @@
type="xsd:string" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
- Description of this persistence
- unit.
+ Description of this persistence unit.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
@@ -172,8 +171,7 @@
type="xsd:string" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
- Provider class that supplies
- EntityManagers for this
+ Provider class that supplies EntityManagers for this
persistence unit.
</xsd:documentation>
</xsd:annotation>
@@ -183,8 +181,7 @@
type="xsd:string" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
- The container-specific name of
- the JTA datasource to use.
+ The container-specific name of the JTA datasource to use.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
@@ -193,8 +190,7 @@
type="xsd:string" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
- The container-specific name of a
- non-JTA datasource to use.
+ The container-specific name of a non-JTA datasource to use.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
@@ -204,10 +200,8 @@
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>
- File containing mapping
- information. Loaded as a
- resource by the persistence
- provider.
+ File containing mapping information. Loaded as a resource
+ by the persistence provider.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
@@ -217,9 +211,8 @@
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>
- Jar file that should be scanned
- for entities. Not applicable to
- Java SE persistence units.
+ Jar file that should be scanned for entities.
+ Not applicable to Java SE persistence units.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
@@ -228,10 +221,8 @@
minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>
- Class to scan for annotations.
- It should be annotated with
- either @Entity, @Embeddable or
- @MappedSuperclass.
+ Class to scan for annotations. It should be annotated
+ with either @Entity, @Embeddable or @MappedSuperclass.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
@@ -241,13 +232,39 @@
minOccurs="0">
<xsd:annotation>
<xsd:documentation>
- When set to true then only
- listed classes and jars will be
- scanned for persistent classes,
- otherwise the enclosing jar or
- directory will also be scanned.
- Not applicable to Java SE
- persistence units.
+ When set to true then only listed classes and jars will
+ be scanned for persistent classes, otherwise the enclosing
+ jar or directory will also be scanned. Not applicable to
+ Java SE persistence units.
+ </xsd:documentation>
+ </xsd:annotation>
+ </xsd:element>
+ <!-- **************************************************** -->
+ <xsd:element name="shared-cache-mode"
+ type="persistence:persistence-unit-caching-type"
+ minOccurs="0">
+ <xsd:annotation>
+ <xsd:documentation>
+ Defines whether caching is enabled for the
+ persistence unit if caching is supported by the
+ persistence provider. When set to ALL, all entities
+ will be cached. When set to NONE, no entities will
+ be cached. When set to ENABLE_SELECTIVE, only entities
+ specified as cacheable will be cached. When set to
+ DISABLE_SELECTIVE, entities specified as not cacheable
+ will not be cached. When not specified or when set to
+ UNSPECIFIED, provider defaults may apply.
+ </xsd:documentation>
+ </xsd:annotation>
+ </xsd:element>
+ <!-- **************************************************** -->
+ <xsd:element name="validation-mode"
+ type="persistence:persistence-unit-validation-mode-type"
+ minOccurs="0">
+ <xsd:annotation>
+ <xsd:documentation>
+ Specifies the validation mode to be used for the
+ persistence unit.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
@@ -256,15 +273,13 @@
minOccurs="0">
<xsd:annotation>
<xsd:documentation>
- A list of vendor-specific
- properties.
+ A list of vendor-specific properties.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element name="property"
- minOccurs="0"
- maxOccurs="unbounded">
+ minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>
A name-value pair.
@@ -272,12 +287,10 @@
</xsd:annotation>
<xsd:complexType>
<xsd:attribute
- name="name"
- type="xsd:string"
+ name="name" type="xsd:string"
use="required" />
<xsd:attribute
- name="value"
- type="xsd:string"
+ name="value" type="xsd:string"
use="required" />
</xsd:complexType>
</xsd:element>
@@ -290,8 +303,7 @@
use="required">
<xsd:annotation>
<xsd:documentation>
- Name used in code to reference this
- persistence unit.
+ Name used in code to reference this persistence unit.
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
@@ -300,9 +312,8 @@
type="persistence:persistence-unit-transaction-type">
<xsd:annotation>
<xsd:documentation>
- Type of transactions used by
- EntityManagers from this persistence
- unit.
+ Type of transactions used by EntityManagers from this
+ persistence unit.
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
@@ -325,6 +336,35 @@
<xsd:enumeration value="RESOURCE_LOCAL" />
</xsd:restriction>
</xsd:simpleType>
+ <!-- **************************************************** -->
+ <xsd:simpleType name="persistence-unit-caching-type">
+ <xsd:annotation>
+ <xsd:documentation>
+ public enum CachingType { ALL, NONE, ENABLE_SELECTIVE,
+ DISABLE_SELECTIVE, UNSPECIFIED};
+ </xsd:documentation>
+ </xsd:annotation>
+ <xsd:restriction base="xsd:token">
+ <xsd:enumeration value="ALL" />
+ <xsd:enumeration value="NONE" />
+ <xsd:enumeration value="ENABLE_SELECTIVE" />
+ <xsd:enumeration value="DISABLE_SELECTIVE" />
+ <xsd:enumeration value="UNSPECIFIED" />
+ </xsd:restriction>
+ </xsd:simpleType>
+ <!-- **************************************************** -->
+ <xsd:simpleType name="persistence-unit-validation-mode-type">
+ <xsd:annotation>
+ <xsd:documentation>
+ public enum ValidationMode { AUTO, CALLBACK, NONE};
+ </xsd:documentation>
+ </xsd:annotation>
+ <xsd:restriction base="xsd:token">
+ <xsd:enumeration value="AUTO" />
+ <xsd:enumeration value="CALLBACK" />
+ <xsd:enumeration value="NONE" />
+ </xsd:restriction>
+ </xsd:simpleType>
</xsd:schema>
</programlisting>
<para>