Java Persistence

Total Page:16

File Type:pdf, Size:1020Kb

Java Persistence Java Persistence Wikibooks.org March 18, 2013 On the 28th of April 2012 the contents of the English as well as German Wikibooks and Wikipedia projects were licensed under Creative Commons Attribution-ShareAlike 3.0 Unported license. An URI to this license is given in the list of figures on page 283. If this document is a derived work from the contents of one of these projects and the content was still licensed by the project under this license at the time of derivation this document has to be licensed under the same, a similar or a compatible license, as stated in section 4b of the license. The list of contributors is included in chapter Contributors on page 281. The licenses GPL, LGPL and GFDL are included in chapter Licenses on page 287, since this book and/or parts of it may or may not be licensed under one or more of these licenses, and thus require inclusion of these licenses. The licenses of the figures are given in the list of figures on page 283. This PDF was generated by the LATEX typesetting software. The LATEX source code is included as an attachment (source.7z.txt) in this PDF file. To extract the source from the PDF file, we recommend the use of http://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/ utility or clicking the paper clip attachment symbol on the lower left of your PDF Viewer, selecting Save Attachment. After extracting it from the PDF file you have to rename it to source.7z. To uncompress the resulting archive we recommend the use of http://www.7-zip.org/. The LATEX source itself was generated by a program written by Dirk Hünniger, which is freely available under an open source license from http://de.wikibooks.org/wiki/Benutzer:Dirk_Huenniger/wb2pdf. This distribution also contains a configured version of the pdflatex compiler with all necessary packages and fonts needed to compile the LATEX source included in this PDF file. Contents 1 Preface 3 2 What is Java persistence? 5 3 What is Java? 7 3.1 Google Trends . 7 3.2 See also . 7 4 What is a database? 9 5 What is JPA? 11 6 What is new in JPA 2.0? 13 7 Other Persistence Specs 15 8 Why use JPA or ORM? 17 9 Persistence Products 19 9.1 Existing Persistence Products . 19 10 EclipseLink 23 11 TopLink 25 12 Hibernate 27 13 TopLink Essentials 29 14 Kodo 31 15 Open JPA 33 16 Ebean 35 16.1 Index . 35 17 Mapping 37 18 Mapping 39 18.1 Access Type . 42 18.2 Common Problems . 43 19 Tables 45 III Contents 20 Advanced 47 20.1 Multiple tables . 47 20.2 Multiple tables with foreign keys . 49 20.3 Multiple table joins . 50 20.4 Multiple table outer joins . 51 20.5 Tables with special characters and mixed case . 52 20.6 Table qualifiers, schemas, or creators . 52 21 Identity 55 22 Sequencing 57 22.1 Sequence Strategies . 57 23 Advanced 65 23.1 Composite Primary Keys . 65 23.2 Primary Keys through OneToOne and ManyToOne Relationships . 69 23.3 Advanced Sequencing . 73 23.4 Primary Keys through Triggers . 74 23.5 Primary Keys through Events . 75 23.6 No Primary Key . 75 23.7 Single Table Inheritance . 77 23.8 Joined, Multiple Table Inheritance . 79 24 Advanced 83 24.1 Table Per Class Inheritance . 83 24.2 Mapped Superclasses . 84 25 Embeddables 89 26 Advanced 93 26.1 Sharing . 93 26.2 Embedded Ids . 94 26.3 Nulls . 94 26.4 Nesting . 95 26.5 Inheritance . 96 26.6 Relationships . 96 26.7 Collections . 97 26.8 Querying . 98 27 Locking 99 27.1 Optimistic Locking . 99 27.2 Advanced . 104 28 Basics 111 28.1 Common Problems . 113 29 Advanced 115 29.1 Temporal, Dates, Times, Timestamps and Calendars . 115 29.2 Enums . 117 IV Contents 29.3 LOBs, BLOBs, CLOBs and Serialization . 118 29.4 Lazy Fetching . 119 29.5 Optional . 119 29.6 Column Definition and Schema Generation . 120 29.7 Insertable, Updatable / Read Only Fields / Returning . 121 29.8 Conversion . 122 29.9 Custom Types . 122 30 Relationships 125 30.1 Lazy Fetching . 126 30.2 Cascading . 129 30.3 Orphan Removal (JPA 2.0) . 130 30.4 Target Entity . 131 30.5 Collections . 132 30.6 Common Problems . 135 31 Advanced 139 31.1 Advanced Relationships . 139 31.2 Maps . 140 31.3 Join Fetching . 145 31.4 Batch Fetching . 147 31.5 Filtering, Complex Joins . 148 31.6 Variable and Heterogeneous Relationships . 148 31.7 Nested Collections, Maps and Matrices . 149 32 OneToOne 151 32.1 Inverse Relationships, Target Foreign Keys and Mapped By . 154 32.2 See Also . 155 32.3 Common Problems . 155 33 Advanced 157 33.1 Target Foreign Keys, Primary Key Join Columns, Cascade Primary Keys 157 33.2 Mapping a OneToOne Using a Join Table . 161 34 ManyToOne 165 34.1 See Also . 167 34.2 Common Problems . 167 35 Advanced 169 35.1 Target Foreign Keys, Primary Key Join Columns, Cascade Primary Keys 169 36 OneToMany 171 36.1 Join Table . 174 36.2 See Also . 176 36.3 Common Problems . 176 37 Advanced 177 37.1 Undirectional OneToMany, No Inverse ManyToOne, No Join Table (JPA 2.0 ONLY) ................................... 177 V Contents 38 ManyToMany 179 38.1 Bi-directional Many to Many . 180 38.2 See Also . 181 38.3 Common Problems . 182 39 Advanced 183 39.1 Mapping a Join Table with Additional Columns . 183 40 ElementCollection 187 40.1 Embedded Collections . 188 40.2 Basic Collections . 189 40.3 See Also . 191 40.4 Common Problems . 191 41 Advanced Topics 193 41.1 Events . 193 41.2 Views . 196 41.3 Interfaces . 197 41.4 Stored Procedures . 198 41.5 Structured Object-Relational Data Types . 199 41.6 XML Data Types . 200 41.7 Filters . 201 41.8 History . 202 41.9 Logical Deletes . 203 41.10 Auditing . 203 41.11 Replication . 203 41.12 Partitioning . 204 41.13 Data Integration . 204 41.14 NoSQL (and EIS, legacy, XML, and non-relational data) . 204 41.15 Multi-Tenancy . 205 41.16 Dynamic Data . 205 42 Runtime 207 43 Entity Manager 209 43.1 Java Standard Edition . ..
Recommended publications
  • Oracle Application Server 10G R3 (10.1.3.1) New Features Overview
    Oracle Application Server 10g R3 (10.1.3.1) New Features Overview An Oracle White Paper October 2006 Oracle Application Server 10gR3 New Features Overview 1.0 Introduction................................................................................................. 4 2.0 Standards Support: J2EE Infrastructure ................................................. 5 2.1 Presentation Tier – Java Server Pages and JavaServer Faces........... 6 2.2 Business Tier – Enterprise Java Beans................................................ 7 2.3 Persistence - TopLink............................................................................ 8 2.3.1 Oracle TopLink............................................................................... 8 2.3.2 EJB 3.0 Persistence......................................................................... 9 2.3.3 Object-XML.................................................................................... 9 2.4 Data Sources and Transactions ............................................................ 9 2.4.1 Data Sources.................................................................................... 9 2.4.2 Transactions................................................................................... 10 2.5 Java 2 Connector Architecture ........................................................... 10 2.6 Security................................................................................................... 11 2.6.1 Core Container.............................................................................
    [Show full text]
  • Oracle® Toplink Release Notes Release 12C (12.1.2)
    Oracle® TopLink Release Notes Release 12c (12.1.2) E40213-01 June 2013 This chapter describes issues associated with Oracle TopLink. It includes the following topics: ■ Section 1, "TopLink Object-Relational Issues" ■ Section 2, "Oracle Database Extensions with TopLink" ■ Section 3, "Allowing Zero Value Primary Keys" ■ Section 4, "Managed Servers on Sybase with JCA Oracle Database Service" ■ Section 5, "Logging Configuration with EclipseLink Using Container Managed JPA" ■ Section 6, "Documentation Accessibility" 1 TopLink Object-Relational Issues This section contains information on the following issues: ■ Section 1.1, "Cannot set EclipseLink log level in WLS System MBean Browser" ■ Section 1.2, "UnitOfWork.release() not Supported with External Transaction Control" ■ Section 1.3, "Returning Policy for UPDATE with Optimistic Locking" ■ Section 1.4, "JDBC Drivers returning Timestamps as Strings" ■ Section 1.5, "Unit of Work does not add Deleted Objects to Change Set" 1.1 Cannot set EclipseLink log level in WLS System MBean Browser Use Oracle Enterprise Manager to set the EclipseLink log level; do not use the WLS System MBean Browser to complete this action. 1.2 UnitOfWork.release() not Supported with External Transaction Control A unit of work synchronized with a Java Transaction API (JTA) will throw an exception if it is released. If the current transaction requires its changes to not be persisted, the JTA transaction must be rolled back. When in a container-demarcated transaction, call setRollbackOnly() on the EJB/session context: @Stateless public class MySessionBean { @Resource SessionContext sc; public void someMethod() { ... 1 sc.setRollbackOnly(); } } When in a bean-demarcated transaction then you call rollback() on the UserTransaction obtained from the EJB/session context: @Stateless @TransactionManagement(TransactionManagementType.BEAN) public class MySessionBean implements SomeInterface { @Resource SessionContext sc; public void someMethod() { sc.getUserTransaction().begin(); ..
    [Show full text]
  • 1 Shounak Roychowdhury, Ph.D
    Shounak Roychowdhury, Ph.D. 10213 Prism Dr., Austin, TX, 78726 || 650-504-8365 || email: [email protected] Profile • Software development and research experience at Oracle and LG Electronics. • Deep understanding of data science methods: machine learning; probability and statistics. • 5 US patents and 40+ peer reviewed publications in international conferences and top refereed journals Research Interests • Published research papers on computational intelligence, neural networks and fuzzy theory, numerical optimization, and natural language processing, and information theory. Education • Ph.D. (Computer Engineering), University of Texas at Austin, Austin, TX, (Dec. 2013) o Dissertation: A Mixed Approach to Spectrum-based Fault Localization Using Information Theoretic Foundations. (Machine Learning in Software Engineering) • M.S. (Computer Science), University of Tulsa, Tulsa, OK, (May 1997) o Thesis: Encoding and Decoding of Fuzzy Rules Patents • Chaos washing systems and a method of washing thereof (US Patent #5,560,230) • System and method for generating fuzzy decision trees (US Patent #7,197,504) • Method for extracting association rules from transactions in a database (U.S. Patent # 7,370,033) • Expediting K-means cluster analysis data mining using subsample elimination preprocessing (U.S. Patent # 8,229,876) • Bayes-like classifier with fuzzy likelihood (U.S. Patent # 8,229,875) Computer Languages • Python, Java, C/C++, MATLAB, R, SQL, PL/SQL, Perl, Ruby, Tcl/Tk Teaching Experience Adjunct Faculty Texas State University 2017- Present Professional Experience Hewlett Packard Enterprise, Austin, TX (Oct 2018 - present) Expert Technologist • Executed software development processes for composable rack team of HPE’s OneView cloud management system. • Developed a Python-based system to test the scalability of OneView connections across multiple layers of Plexxi switches.
    [Show full text]
  • Oracle Glassfish Server Application Development Guide Release 3.1.2 E24930-01
    Oracle GlassFish Server Application Development Guide Release 3.1.2 E24930-01 February 2012 This Application Development Guide describes how to create and run Java Platform, Enterprise Edition (Java EE platform) applications that follow the open Java standards model for Java EE components and APIs in the Oracle GlassFish Server environment. Topics include developer tools, security, and debugging. This book is intended for use by software developers who create, assemble, and deploy Java EE applications using Oracle servers and software. Oracle GlassFish Server Application Development Guide, Release 3.1.2 E24930-01 Copyright © 2012, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.
    [Show full text]
  • Oracle® Fusion Middleware Solutions Guide for Oracle Toplink 12C (12.1.2) E28610-02
    Oracle® Fusion Middleware Solutions Guide for Oracle TopLink 12c (12.1.2) E28610-02 August 2013 This document describes a number of scenarios, or use cases, that illustrate TopLink features and typical TopLink development processes. Oracle Fusion Middleware Solutions Guide for Oracle TopLink, 12c (12.1.2) E28610-02 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).
    [Show full text]
  • Oracle Application Server Toplink Getting Started Guide, 10G Release 2 (10.1.2) Part No
    Oracle® Application Server TopLink Getting Started Guide 10g Release 2 (10.1.2) Part No. B15902-01 April 2005 Oracle Application Server TopLink Getting Started Guide, 10g Release 2 (10.1.2) Part No. B15902-01 Copyright © 2000, 2005 Oracle. All rights reserved. Primary Author: Jacques-Antoine Dubé Contributing Authors: Rick Sapir, Arun Kuzhimattathil, Janelle Simmons, Madhubala Mahabaleshwar, Preeti Shukla The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose. If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.
    [Show full text]
  • [1 ] Oracle Glassfish Server
    Oracle[1] GlassFish Server Release Notes Release 3.1.2 and 3.1.2.2 E24939-10 April 2015 These Release Notes provide late-breaking information about GlassFish Server 3.1.2 and 3.1.2.2 software and documentation. These Release Notes include summaries of supported hardware, operating environments, and JDK and JDBC/RDBMS requirements. Also included are a summary of new product features in the 3.1.2 and 3.1.2.2 releases, and descriptions and workarounds for known issues and limitations. Oracle GlassFish Server Release Notes, Release 3.1.2 and 3.1.2.2 E24939-10 Copyright © 2015, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable: U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S.
    [Show full text]
  • Oracle9ias Toplink Getting Started Guide
    b10061.book Page i Wednesday, September 4, 2002 1:20 PM Oracle9iAS TopLink Getting Started Release 2 (9.0.3) August 2002 Part No. B10061-01 b10061.book Page ii Wednesday, September 4, 2002 1:20 PM Oracle9iAS TopLink Getting Started, Release 2 (9.0.3) Part No. B10061-01 Copyright © 2002, Oracle Corporation. All rights reserved. The Programs (which include both the software and documentation) contain proprietary information of Oracle Corporation; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent and other intellectual and industrial property laws. Reverse engineering, disassembly or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this document is error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation. If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on behalf of the U.S. Government, the following notice is applicable: Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial computer software" and use, duplication, and disclosure of the Programs, including documentation, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement.
    [Show full text]
  • Oracle® Fusion Middleware Solution Guide for Oracle Toplink 11G Release 1 (11.1.1) E25034-02
    Oracle® Fusion Middleware Solution Guide for Oracle TopLink 11g Release 1 (11.1.1) E25034-02 March 2012 This document describes a number of scenarios, or use cases, that illustrate TopLink features and typical TopLink development processes. Oracle Fusion Middleware Solution Guide for Oracle TopLink, 11g Release 1 (11.1.1) E25034-02 Copyright © 1997, 2012 Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).
    [Show full text]
  • Using Maven with Oracle Toplink
    Using Maven with Oracle TopLink An Oracle White Paper July 2013 Using Maven with Oracle TopLink 12.1.2 Using Maven with Oracle TopLink Introduction ....................................................................................... 1 Installation ......................................................................................... 2 Install oracle-maven-sync .............................................................. 2 Using Maven ..................................................................................... 3 TopLink JAXB and JSON .............................................................. 4 TopLink JPA .................................................................................. 4 TopLink Data Services................................................................... 5 TopLink and Coherence ................................................................ 6 Using Maven with Oracle TopLink Introduction Maven is one of the most popular build management systems and with the 12.1.2 release TopLink includes POM files for all jars as well as a utility to install them into your Maven repository. This document describes how to install TopLink into your Maven repository, the Maven coordinates for all TopLink jars, and which dependencies are required for different usage scenarios including Java SE, Java EE in WebLogic, and using TopLink with Oracle Coherence. 1 Using Maven with Oracle TopLink Installation Like other Oracle Fusion Middleware components, TopLink 12.1.2 provides support for developing with Maven by providing
    [Show full text]
  • Oracle Weblogic Server
    ORACLE DATA SHEET ORACLE WEBLOGIC SERVER KEY FEATURES AND BENEFITS Oracle WebLogic Server is the #1 application server for developing and deploying applications across cloud environments, engineered systems, and ORACLE WEBLOGIC SERVER STANDARD EDITION conventional systems. Oracle WebLogic Server offers application developers • Java EE 6 full platform support modern development tooling and advanced APIs for application innovation. It plus selected Java EE 7 APIs • Java SE 6 and 7 certification provides a mission critical cloud platform for applications requiring high • Oracle Java SE Support • ZIP distribution for performance, scalability and reliability. Powerful, integrated management tools development • Oracle TopLink simplify operations and reduce management costs. Finally, Oracle WebLogic • Choice of IDEs: Oracle Enterprise Pack for Eclipse, Server provides the foundation for the Oracle Fusion Middleware portfolio of Oracle JDeveloper, Oracle NetBeans IDE products. Oracle WebLogic Server is available in three editions with • Maven plug-ins, POMs, and archetypes increasing functionality. • Support for rich client applications – REST, JSON, WebSocket, Server-Sent Oracle WebLogic Server Standard Edition includes Oracle TopLink, Oracle Events and TopLink Data Services Application Development Framework, Oracle Web Tier and the core Oracle • Classloader Analysis Tool to detect/resolve class conflicts WebLogic Server. Full Java Enterprise Edition support is included along with • Oracle Application Development Framework development features
    [Show full text]
  • Oracle Glassfish Server Upgrade Guide Release 3.1.2 E24942-01
    Oracle GlassFish Server Upgrade Guide Release 3.1.2 E24942-01 February 2012 This guide explains how to upgrade to Oracle GlassFish Server 3.1.2 from previous GlassFish Server and Sun GlassFish Enterprise Server product releases. Also included in this guide are instructions for upgrading configuration data and Java EE applications from binary-compatible earlier versions of this software to work with Oracle GlassFish Server 3.1.2. Finally, this guide describes compatibility issues that affect data and applications that are to be migrated. Oracle GlassFish Server Upgrade Guide, Release 3.1.2 E24942-01 Copyright © 2012, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S.
    [Show full text]