Difference between revisions of "EclipseLink/DesignDocs/389090"

From Eclipsepedia

Jump to: navigation, search
(Requirements)
(Design Specification: JPA 2.1 Criteria Query framework Bulk Update/Delete support)
Line 1: Line 1:
 
<div style="margin:5px;float:right;border:1px solid #000000;padding:5px">__TOC__</div>
 
<div style="margin:5px;float:right;border:1px solid #000000;padding:5px">__TOC__</div>
= Design Specification: JPA 2.1 Criteria Query framework Bulk Update/Delete support =
+
= Design Specification: JPA 2.1 Formalized DDL generation support =
  
[http://bugs.eclipse.org/374818 ER 374818]
+
[http://bugs.eclipse.org/389090 ER 389090]
  
 
== Document History ==
 
== Document History ==

Revision as of 15:45, 7 September 2012

Design Specification: JPA 2.1 Formalized DDL generation support

ER 389090

Document History

Date Author Version Description & Notes
05 September 2012 Gordon Yorke Initial Doc creation

Project overview

In previous versions DDL generation was present in the specification but was not standardized and was not required. The next iteration of the Java Persistence API specification has added standardized provider DDL generation and made DDL generation a requirement.

Concepts

DDL Generation is the scripting or direct database execution of database object creation SQL (Create Table, Create Index, ...) from metadata or user supplied scripts. The specification defines many mapping artifacts (OneToOneMapping, JoinColumn, etc) that contribute metadata to allow the provider to generate the DDL to define the structure of the database objects.

Requirements

To implement the requirements of DDL generation and execution as defined in the specification. This includes but may not be limited to the Database objects:

  • Columns for all mapping types
  • Sequence Generators
  • Constraints
  • Indexes
  • Entity tables
  • Relationship tables
  • Schema

Support reading and executing user packaged DDL scripts and the generation of DDL scripts. Support processing configured target database information Support for a DDL Generation connection to be provided by the application or the container.

Design Constraints

Design / Functionality

Testing

Existing tests should be verified to ensure they include tests for creation of those database objects listed in the requirements list and any others included as part of the specification. Any untested areas should have additional tests added. Tests to execute and generate DDL scripts Tests for identifying target databases correctly.

API

New properties and new API are present in the specification to support DDL generation. These should behave as specified in the specification.

GUI

Config files

Documentation

Open Issues

This section lists the open issues that are still pending that must be decided prior to fully implementing this project's requirements.

Issue # Owner Description / Notes

Decisions

This section lists decisions made. These are intended to document the resolution of open issues or constraints added to the project that are important.

Issue # Description / Notes Decision

Future Considerations

During the research for this project the following items were identified as out of scope but are captured here as potential future enhancements. If agreed upon during the review process these should be logged in the bug system.