| <?xml version="1.0" encoding="UTF-8"?> |
| <!-- persistence.xml schema --> |
| <xsd:schema targetNamespace="http://java.sun.com/xml/ns/persistence" |
| 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 October 1 2009 |
| </xsd:documentation> |
| </xsd:annotation> |
| |
| <xsd:annotation> |
| <xsd:documentation> |
| |
| DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. |
| |
| Copyright 2005-2009 Sun Microsystems, Inc. All rights reserved. |
| |
| The contents of this file are subject to the terms of either the |
| GNU General Public License Version 2 only ("GPL") or the Common |
| Development and Distribution License("CDDL") (collectively, the |
| "License"). You may not use this file except in compliance with |
| the License. You can obtain a copy of the License at |
| https://glassfish.dev.java.net/public/CDDL+GPL.html or |
| glassfish/bootstrap/legal/LICENSE.txt. See the License for the |
| specific language governing permissions and limitations under the |
| License. |
| |
| When distributing the software, include this License Header |
| Notice in each file and include the License file at |
| glassfish/bootstrap/legal/LICENSE.txt. Sun designates this |
| particular file as subject to the "Classpath" exception as |
| provided by Sun in the GPL Version 2 section of the License file |
| that accompanied this code. If applicable, add the following |
| below the License Header, with the fields enclosed by brackets [] |
| replaced by your own identifying information: |
| "Portions Copyrighted [year] [name of copyright owner]" |
| |
| Contributor(s): |
| |
| If you wish your version of this file to be governed by only the |
| CDDL or only the GPL Version 2, indicate your decision by adding |
| "[Contributor] elects to include this software in this |
| distribution under the [CDDL or GPL Version 2] license." If you |
| don't indicate a single choice of license, a recipient has the |
| option to distribute your version of this file under either the |
| CDDL, the GPL Version 2 or to extend the choice of license to its |
| licensees as provided above. However, if you add GPL Version 2 |
| code and therefore, elected the GPL Version 2 license, then the |
| option applies only if the new code is made subject to such |
| option by the copyright holder. |
| |
| </xsd:documentation> |
| </xsd:annotation> |
| |
| <xsd:annotation> |
| <xsd:documentation><![CDATA[ |
| This is the XML Schema for the persistence configuration file. |
| The file must be named "META-INF/persistence.xml" in the |
| persistence archive. |
| Persistence configuration files must indicate |
| the persistence schema by using the persistence namespace: |
| http://java.sun.com/xml/ns/persistence |
| and indicate the version of the schema by |
| using the version element as shown below: |
| <persistence xmlns="http://java.sun.com/xml/ns/persistence" |
| xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
| xsi:schemaLocation="http://java.sun.com/xml/ns/persistence |
| http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd" |
| version="2.0"> |
| ... |
| </persistence> |
| ]]></xsd:documentation> |
| </xsd:annotation> |
| |
| <xsd:simpleType name="versionType"> |
| <xsd:restriction base="xsd:token"> |
| <xsd:pattern value="[0-9]+(\.[0-9]+)*" /> |
| </xsd:restriction> |
| </xsd:simpleType> |
| <!-- **************************************************** --> |
| <xsd:element name="persistence"> |
| <xsd:complexType> |
| <xsd:sequence> |
| <!-- **************************************************** --> |
| <xsd:element name="persistence-unit" |
| minOccurs="1" maxOccurs="unbounded"> |
| <xsd:complexType> |
| <xsd:annotation> |
| <xsd:documentation> |
| Configuration of a persistence unit. |
| </xsd:documentation> |
| </xsd:annotation> |
| <xsd:sequence> |
| <!-- **************************************************** --> |
| <xsd:element name="description" |
| type="xsd:string" minOccurs="0"> |
| <xsd:annotation> |
| <xsd:documentation> |
| Description of this persistence unit. |
| </xsd:documentation> |
| </xsd:annotation> |
| </xsd:element> |
| <!-- **************************************************** --> |
| <xsd:element name="provider" |
| type="xsd:string" minOccurs="0"> |
| <xsd:annotation> |
| <xsd:documentation> |
| Provider class that supplies EntityManagers for this |
| persistence unit. |
| </xsd:documentation> |
| </xsd:annotation> |
| </xsd:element> |
| <!-- **************************************************** --> |
| <xsd:element name="jta-data-source" |
| type="xsd:string" minOccurs="0"> |
| <xsd:annotation> |
| <xsd:documentation> |
| The container-specific name of the JTA datasource to use. |
| </xsd:documentation> |
| </xsd:annotation> |
| </xsd:element> |
| <!-- **************************************************** --> |
| <xsd:element name="non-jta-data-source" |
| type="xsd:string" minOccurs="0"> |
| <xsd:annotation> |
| <xsd:documentation> |
| The container-specific name of a non-JTA datasource to use. |
| </xsd:documentation> |
| </xsd:annotation> |
| </xsd:element> |
| <!-- **************************************************** --> |
| <xsd:element name="mapping-file" |
| type="xsd:string" minOccurs="0" |
| maxOccurs="unbounded"> |
| <xsd:annotation> |
| <xsd:documentation> |
| File containing mapping information. Loaded as a resource |
| by the persistence provider. |
| </xsd:documentation> |
| </xsd:annotation> |
| </xsd:element> |
| <!-- **************************************************** --> |
| <xsd:element name="jar-file" |
| type="xsd:string" minOccurs="0" |
| maxOccurs="unbounded"> |
| <xsd:annotation> |
| <xsd:documentation> |
| Jar file that is to be scanned for managed classes. |
| </xsd:documentation> |
| </xsd:annotation> |
| </xsd:element> |
| <!-- **************************************************** --> |
| <xsd:element name="class" type="xsd:string" |
| minOccurs="0" maxOccurs="unbounded"> |
| <xsd:annotation> |
| <xsd:documentation> |
| Managed class to be included in the persistence unit and |
| to scan for annotations. It should be annotated |
| with either @Entity, @Embeddable or @MappedSuperclass. |
| </xsd:documentation> |
| </xsd:annotation> |
| </xsd:element> |
| <!-- **************************************************** --> |
| <xsd:element name="exclude-unlisted-classes" |
| type="xsd:boolean" default="true" |
| 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. |
| </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> |
| The validation mode to be used for the persistence unit. |
| </xsd:documentation> |
| </xsd:annotation> |
| </xsd:element> |
| <!-- **************************************************** --> |
| <xsd:element name="properties" |
| minOccurs="0"> |
| <xsd:annotation> |
| <xsd:documentation> |
| A list of standard and vendor-specific properties |
| and hints. |
| </xsd:documentation> |
| </xsd:annotation> |
| <xsd:complexType> |
| <xsd:sequence> |
| <xsd:element name="property" |
| minOccurs="0" maxOccurs="unbounded"> |
| <xsd:annotation> |
| <xsd:documentation> |
| A name-value pair. |
| </xsd:documentation> |
| </xsd:annotation> |
| <xsd:complexType> |
| <xsd:attribute |
| name="name" type="xsd:string" |
| use="required" /> |
| <xsd:attribute |
| name="value" type="xsd:string" |
| use="required" /> |
| </xsd:complexType> |
| </xsd:element> |
| </xsd:sequence> |
| </xsd:complexType> |
| </xsd:element> |
| </xsd:sequence> |
| <!-- **************************************************** --> |
| <xsd:attribute name="name" type="xsd:string" |
| use="required"> |
| <xsd:annotation> |
| <xsd:documentation> |
| Name used in code to reference this persistence unit. |
| </xsd:documentation> |
| </xsd:annotation> |
| </xsd:attribute> |
| <!-- **************************************************** --> |
| <xsd:attribute name="transaction-type" |
| type="persistence:persistence-unit-transaction-type"> |
| <xsd:annotation> |
| <xsd:documentation> |
| Type of transactions used by EntityManagers from this |
| persistence unit. |
| </xsd:documentation> |
| </xsd:annotation> |
| </xsd:attribute> |
| </xsd:complexType> |
| </xsd:element> |
| </xsd:sequence> |
| <xsd:attribute name="version" type="persistence:versionType" |
| fixed="2.0" use="required" /> |
| </xsd:complexType> |
| </xsd:element> |
| <!-- **************************************************** --> |
| <xsd:simpleType name="persistence-unit-transaction-type"> |
| <xsd:annotation> |
| <xsd:documentation> |
| public enum PersistenceUnitTransactionType {JTA, RESOURCE_LOCAL}; |
| </xsd:documentation> |
| </xsd:annotation> |
| <xsd:restriction base="xsd:token"> |
| <xsd:enumeration value="JTA" /> |
| <xsd:enumeration value="RESOURCE_LOCAL" /> |
| </xsd:restriction> |
| </xsd:simpleType> |
| <!-- **************************************************** --> |
| <xsd:simpleType name="persistence-unit-caching-type"> |
| <xsd:annotation> |
| <xsd:documentation> |
| public enum SharedCacheMode { 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> |