PSE Pro for Java Release Notes. Release 7.1

Transcription

1 PSE Pro for Java Release Notes Release 7.1

2 Copyright PSE Pro for Java Release Notes PSE Pro for Java Release 7.1 for all platforms, August Progress Software Corporation. All rights reserved. Progress software products are copyrighted and all rights are reserved by Progress Software Corporation. This manual is also copyrighted and all rights are reserved. This manual may not, in whole or in part, be copied, photocopied, translated, or reduced to any electronic medium or machine-readable form without prior consent, in writing, from Progress Software Corporation. The information in this manual is subject to change without notice, and Progress Software Corporation assumes no responsibility for any errors that may appear in this document. The references in this manual to specific platforms supported are subject to change. A (and design), Actional, Actional (and design), Allegrix, Allegrix (and design), Apama, Apama (and Design), Business Empowerment, DataDirect (and design), DataDirect Connect, DataDirect Connect64, DataDirect Technologies, DataDirect XQuery, DataXtend, Dynamic Routing Architecture, EasyAsk, EdgeXtend, Empowerment Center, Fathom, IntelliStream, Mindreef, Neon, Neon New Era of Networks, O (and design), ObjectStore, OpenEdge, PeerDirect, Persistence, POSSENET, Powered by Progress, PowerTier, Progress, Progress DataXtend, Progress Dynamics, Progress Business Empowerment, Progress Empowerment Center, Progress Empowerment Program, Progress OpenEdge, Progress Profiles, Progress Results, Progress Software Developers Network, Progress Sonic, ProVision, PS Select, SequeLink, Shadow, ShadowDirect, Shadow Interface, Shadow Web Interface, SOAPscope, SOAPStation, Sonic, Sonic ESB, SonicMQ, Sonic Orchestration Server, Sonic Software (and design), SonicSynergy, SpeedScript, Stylus Studio, Technical Empowerment, WebSpeed, and Your Software, Our Technology Experience the Connection are registered trademarks of Progress Software Corporation or one of its subsidiaries or affiliates in the U.S. and/or other countries. AccelEvent, Apama Dashboard Studio, Apama Event Manager, Apama Event Modeler, Apama Event Store, AppsAlive, AppServer, ASPen, ASP-in-a-Box, BusinessEdge, Cache-Forward, DataDirect Spy, DataDirect SupportLink, DataDirect XML Converters, Future Proof, Ghost Agents, GVAC, Looking Glass, ObjectCache, ObjectStore Inspector, ObjectStore Performance Expert, Pantero, POSSE, ProDataSet, Progress ESP Event Manager, Progress ESP Event Modeler, Progress Event Engine, Progress RFID, PSE Pro, SectorAlliance, SmartBrowser, SmartComponent, SmartDataBrowser, SmartDataObjects, SmartDataView, SmartDialog, SmartFolder, SmartFrame, SmartObjects, SmartPanel, SmartQuery, SmartViewer, SmartWindow, Sonic Business Integration Suite, Sonic Process Manager, Sonic Collaboration Server, Sonic Continuous Availability Architecture, Sonic Database Service, Sonic Workbench, Sonic XML Server, The Brains Behind BAM, WebClient, Who Makes Progress, and Your World. Your SOA. are trademarks or service marks of Progress Software Corporation or one of its subsidiaries or affiliates in the U.S. and other countries. Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Any other trademarks or trade names contained herein are the property of their respective owners. ObjectStore includes software developed by the Apache Software Foundation ( Copyright? The Apache Software Foundation. All rights reserved. The names Ant, Xerces, and Apache Software Foundation must not be used to endorse or promote products derived from the Products without prior written permission. Any product derived from the Products may not be called Apache, nor may Apache appear in their name, without prior written permission. For written permission, please contact apache@apache.org. ObjectStore includes the RSA Data Security, Inc. MD5 Message-Digest Algorithm. Copyright , RSA Data Security, Inc. Created All rights reserved. ObjectStore includes Yahoo! User Interface Library - V Copyright 2006 Yahoo! Inc. All rights reserved. The name Yahoo! Inc. nor the names of its contributors may be used to endorse or promote products derived from this Software and products derived from this software without specific prior written permission of Yahoo! Inc. Copyright Updated: June 2008

3 Contents Preface Release Notes Windows 2008 Support Known Problems and Restrictions Threads Are Not Being Automatically Joined to Nonglobal Sessions Transaction.checkpoint() and RETAIN_READONLY Session.of() Method Might Cause Deadlock Requirements for Using This Release Additions to CLASSPATH Variable Addition to PATH Variable Using the Postprocessor Compatibility Between ObjectStore and PSE Pro API Compatibility Database Compatibility Handling of Retained Objects at Start of New Transaction Browsing and Searching HTML Documentation Using the HTML Documentation Set Using the PDF Documentation Set New and Changed Features in Release License File Now Required Support for JDK PSE Pro Compiled with JDK PSE Pro API Additions and Changes Change in PSE Pro Database Format Release 7.1 3

4 Contents 4 4 PSE Pro for Java Release Notes

5 Preface Purpose Audience Scope PSE Pro for Java Release Notes provides information about new features, known problems, requirements for running PSE Pro, compatibility with other ObjectStore Java products, obtaining support, and obtaining third-party persistence-capable classes. This book is for experienced Java programmers who are writing applications that use PSE Pro for Java. This book supports Release 7.1 of PSE Pro for Java. For last minute information, see the README.htm file in the directory in which you installed ObjectStore. Notation Conventions This document uses the following notation conventions Convention Courier Bold Courier Italic Courier Sans serif Meaning Progress Software on the World Wide Web Courier font indicates code, syntax, file names, API names, system output, and the like. Bold Courier font is used to emphasize particular code. Italic Courier font indicates the name of an argument or variable for which you must supply a value. Sans serif typeface indicates the names of user interface elements such as dialog boxes, buttons, and fields. Italic serif In text, italic serif typeface indicates the first use of an important term. [ ] Brackets enclose optional arguments. { a b c } Braces enclose two or more items. You can specify only one of the enclosed items. Vertical bars represent OR separators. For example, you can specify a or b or c.... Three consecutive periods indicate that you can repeat the immediately previous item. In examples, they also indicate omissions. Release 7.1 5

6 Preface The Progress Software Web site ( provides a variety of useful information about products, news and events, special programs, support, and training opportunities. Technical Support To obtain information about purchasing technical support, contact your local sales office listed at or in North America call When you purchase technical support, the following services are available to you: You can send questions to ostore-support@progress.com. Remember to include your serial number in the subject of the electronic mail message. You can call the Technical Support organization to get help resolving problems. If you are in North America, call If you are outside North America, refer to the Technical Support Web site at Education Services You can file a report or question with Technical Support by going to You can access the Technical Support Web site, which includes - A template for submitting a support request. This helps you provide the necessary details, which speeds response time. - Solution Knowledge Base that you can browse and query. - Online documentation for all products. - White papers and short articles about using Progress products. - The latest versions of products, service packs, and publicly available patches that you can download. - Access to a support matrix that lists platform configurations supported by this release. - Support policies. - Local phone numbers and hours when support personnel can be reached. To learn about standard course offerings and custom workshops, use the Progress education services site ( To register for classes, call x4452. For information on current course offerings or pricing, send to classes@progress.com. Searchable Documents In addition to the online documentation that is included with your software distribution, the full set of product documentation is available on the Progress Software Developers Network (PSDN) Web site at The site provides documentation for the most recent release and the previous supported release. Service Pack README files are also included to provide historical context for specific issues. Be sure to check this site for new information or documentation clarifications posted between releases. Your Comments 6 PSE Pro for Java Release Notes

7 Preface Progress product development welcomes your comments about its documentation. Send any product feedback to To expedite your documentation feedback, begin the subject with Technical Support Issue; Doc:. For example: Subject: Technical Support Issue; Doc: Incorrect message on page 76 of reference manual Third-Party Acknowledgments This software makes use of the following third party products: Ant v1.6, Mortbay Jetty v6.1 and JXPath v 1.2. See the Apache License v2.0 in the installation directory in the docs/thirdpartylicenses folder for license information. Expat v Copyright 1998, 1999, 2000 Thai Open Source Software Center Ltd and Clark Cooper. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. The Java SE Runtime Environment (JRE) Version 6, developed by and copyright Sun Microsystems. See the Sun Microsystems, Inc. Binary Code License for the Java SE Runtime Environment (JRE) Version 6 and THIRDPARTYLICENSEREADME.txt in the installation directory in the docs/thirdpartylicenses folder for license information. Jchart2d v The contents of these files are subject to the GNU Lesser General Public License v.2.1 (the ìlicenseî). You may not use these files except in compliance with the license. You may obtain a copy of the license in the installation directory in the docs/thirdpartylicenses folder and a copy of the license and source code of these files can be obtained through by following the instructions set forth therein. JSON. Copyright 2002 JSON.org. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above Release 7.1 7

8 Preface copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. The Software shall be used for Good, not Evil. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. OpenDMK v 1.0-b2 and Restlet v 1.1m2. The contents of these files are subject to the Common Development and Distribution License (CDDL) Version 1.0 (the "License"). You may not use these files except in compliance with the License. You may obtain a copy of the License in the installation directory in the docs/thirdpartylicenses folder and a copy of the license and source code of these files can be obtained through by following the instructions set forth therein. RSA Data Security, Inc. MD5 Copyright RSA Data Security, Inc. Created All rights reserved. License to copy and use this software is granted provided that it is identified as the "RSA Data Security, Inc. MD5 Message-Digest Algorithm" in all material mentioning or referencing this software or this function. License is also granted to make and use derivative works provided that such works are identified as "derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm" in all material mentioning or referencing the derived work. RSA Data Security, Inc. makes no representations concerning either the merchantability of this software or the suitability of this software for any particular purpose. It is provided "as is" without express or implied warranty of any kind. These notices must be retained in any copies of any part of this documentation and/or software. Sun RPC v3.9 - Sun RPC is a product of Sun Microsystems, Inc. and is provided for unrestricted use provided that this legend is included on all tape media and as a part of the software program in whole or part. Users may copy or modify Sun RPC without charge, but are not authorized to license or distribute it to anyone else except as part of a product or program developed by the user. SUN RPC IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE. Sun RPC is provided with no support and without any obligation on the part of Sun Microsystems, Inc. to assist in its use, correction, modification or enhancement. SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY SUN RPC OR ANY PART THEREOF. In no event will Sun Microsystems, Inc. be liable for any lost revenue or profits or other special, indirect and consequential damages, even if Sun has been advised of the possibility of such damages. Sun Microsystems, Inc., 2550 Garcia Avenue, Mountain View, California PSE Pro for Java Release Notes

9 Preface Tanuki Software Java Service Wrapper. See the Tanuki Software, Inc. Development Software License Agreement, Version 1.0 in the installation directory in the docs/thirdpartylicenses folder for license information. This product includes software and documentation components developed in part by Silver Egg Technology, Inc.("SET") prior to All SET components were released under the following license. Copyright 2001 Silver Egg Technology. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sub- license, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Yahoo! User Interface Library - V Copyright 2006 Yahoo! Inc. All rights reserved. The name Yahoo! Inc. nor the names of its contributors may be used to endorse or promote products derived from this Software and products derived from this software without specific prior written permission of Yahoo! Inc. See the Yahoo! User Interface Library license V in the installation directory in the docs/thirdpartylicenses folder for license information. Release 7.1 9

10 Preface 10 PSE Pro for Java Release Notes

11 Release Notes PSE Pro for Java Release Notes provides information about the following topics: Windows 2008 Support11 Known Problems and Restrictions 11 Requirements for Using This Release 13 Compatibility Between ObjectStore and PSE Pro 15 Browsing and Searching HTML Documentation 16 New and Changed Features in Release This document covers Release 7.1. PSE Pro for Java Release 7.1 is targeted for JDK 1.5 and above; it is incompatible with JDK 1.4 and earlier. For information about supported platforms and any last-minute changes, see the README.htm file in the top-level directory where you installed PSE Pro. Windows 2008 Support PSE Pro 7.1 now supports the Windows 2008 operating system. Known Problems and Restrictions This section describes issues to consider concerning restrictions and known problems. See the following: Threads Are Not Being Automatically Joined to Nonglobal Sessions Transaction.checkpoint() and RETAIN_READONLY Session.of() Method Might Cause Deadlock Threads Are Not Being Automatically Joined to Nonglobal Sessions Threads that do not belong to a session are not automatically joined to a nonglobal session when they should be. Until this problem is resolved, applications cannot rely on session absorption to make a thread that accesses persistent objects join the appropriate session. As a work around, applications can explicitly join each thread to a session by calling Session.join() or using a global session. Release

12 Known Problems and Restrictions More specifically, API methods whose only session-implying arguments are persistent objects require that the calling thread already belong to the same session as the persistent objects. This applies to nonglobal sessions. This restriction will be lifted in a future release. The methods affected by this restriction include the following: ObjectStore.deepFetch() ObjectStore.destroy() ObjectStore.dirty() ObjectStore.evict() ObjectStore.export() ObjectStore.fetch() ObjectStore.isDestroyed() ObjectStore.isExported() ObjectStore.migrate() Persistent.deepFetch() Persistent.destroy() Persistent.dirty() Persistent.evict() Persistent.fetch() Persistent.isDestroyed() Transaction.checkpoint() and RETAIN_READONLY The Transaction.checkpoint() method releases and then obtains the database lock again during the course of the checkpoint. Therefore, if you checkpoint a transaction using the RETAIN_READONLY argument, the contents of retained objects will not reflect changes made to the database by concurrent sessions that obtained the lock during the checkpoint. This problem will be fixed in a future release. Session.of() Method Might Cause Deadlock Users of PSE Pro should be aware that the Session.of() method tries to obtain a lock on all active sessions when the argument is an array or a Java wrapper object. This might cause a deadlock under certain circumstances. This problem does not occur if the argument is an instance of com.odi.ipersistent. 12 PSE Pro for Java Release Notes

13 Release Notes Requirements for Using This Release This section contains topics describing the following requirements: Additions to CLASSPATH Variable Addition to PATH Variable Using the Postprocessor Additions to CLASSPATH Variable To use PSE Pro, you must set your CLASSPATH environment variable to contain The PSE Pro Release 7 pro.jar file. This allows the Java VM to locate PSE Pro. The PSE Pro Release 7 tools.jar file, which contains the.class files for the Class File Postprocessor and other development tools. Examples For example, under Solaris, you might set your CLASSPATH variable to something like the following: CLASSPATH=/opt/ODI/PSEProJ/lib/pro.jar:/opt/ODI/PSEProJ/libtools.jar Under Windows, you might set your CLASSPATH variable to something like the following: Developing Applications CLASSPATH=c:\odi\PSEProJ\lib\pro.jar;c:\odi\PSEProJ\lib\tools.jar To develop PSE Pro applications, you should add entries to the CLASSPATH variable that allow PSE Pro to find your Annotated (postprocessed).class files Original unpostprocessed.class files The order of these entries is important. You want PSE Pro to find the postprocessed.class files before it finds the unpostprocessed.class files. This ensures that when you run the program, the Java system finds the annotated class definitions rather than the unannotated definitions. Detailed instructions for doing this are in Chapter 8, Generating Persistence-Capable Classes Automatically, of the PSE Pro for Java User Guide. Running Demos To run the demos, you must add two other entries to the CLASSPATH variable. Instructions for doing this can be found in the README.htm file that is in the directory for each demo. Addition to PATH Variable Set your PATH environment variable to contain the bin directory that is in the release distribution. For example, on Solaris, this might be PATH=/usr/ucb:/usr/bin:/opt/SUNWspro/bin:/opt/ODI/bin:/opt/ODI/PSEProJ/bin On Windows, it might be PATH=c:\odi\bin;c:\odi\PSEProJ\bin;c:\winnt\system32;c:\winnt Release

14 Known Problems and Restrictions Using the Postprocessor The class file postprocessor is a tool for making classes persistence capable. For simple applications, it is best to postprocess all classes together. For more complex applications, you can postprocess your classes in correctly grouped batches. For the rules for grouping classes in batches, see the section Postprocessing a Batch of Files Is Important in Chapter 8, Generating Persistence-Capable Classes Automatically in the PSE Pro for Java User Guide. Failure to postprocess the correct classes together can result in problem situations that appear when you try to run the application and that are hard to diagnose. There are postprocessor options that allow you to determine the classes that are made persistence capable. 14 PSE Pro for Java Release Notes

15 Release Notes Compatibility Between ObjectStore and PSE Pro API Compatibility Database Compatibility You can start development of an application in PSE Pro and at a later time upgrade it to ObjectStore. This section provides information to help you plan for this transition. See the following: API Compatibility Database Compatibility Handling of Retained Objects at Start of New Transaction Is Now the Same The API to PSE Pro is a subset of the API to the ObjectStore Java interface (OSJI). Databases that you create with PSE Pro cannot be accessed by ObjectStore. Databases that you create with ObjectStore cannot be accessed by PSE Pro. Handling of Retained Objects at Start of New Transaction In previous releases, PSE Pro handled retained objects at the start of a new transaction differently as compared to the ObjectStore Java Interface (OSJI). PSE Pro has been modified so it now behaves the same way as OSJI. Now, PSE Pro hollows retained objects at the start of the next transaction, when you commit a transaction using ObjectStore.RETAIN_READONLY or ObjectStore.RETAIN_UPDATE, just like OSJI. This means that between transactions, you have access to the contents of only those persistent objects whose contents were read or modified in the immediately previous transaction. In previous releases, PSE Pro did not hollow the retained objects at the start of the next transaction. This meant that between transactions, you had access to the contents of all persistent objects whose contents were read or modified in the session, if you committed a transactions using ObjectStore.RETAIN_READONLY or ObjectStore.RETAIN_UPDATE. Release

16 Known Problems and Restrictions Browsing and Searching HTML Documentation The documentation for PSE Pro is available in HTML and PDF formats. Each format is described in the following topics: Using the HTML Documentation Set Using the PDF Documentation Set The HTML version of the documentation set contains a full text search feature. Using the HTML Documentation Set To open the PSE Pro documentation set on Windows platforms, select the Start Programs ObjectStore PSE Pro for Java PSE Pro Bookshelf menu item. To open the PSE Pro documentation set on UNIX platforms, open the doc/index.htm file in a browser. The full pathname for this file is typically /opt/odi/pseproj/doc/index.htm. To use the HTML version of the PSE Pro for Java documentation set, you need to have JavaScript enabled. The HTML version of the PSE Pro documentation set is tested on Internet Explorer 6.0.x, Netscape 7.0.x, and Mozilla Firefox 1.x. The documentation set cannot be displayed properly using Netscape 6.0. Using the PDF Documentation Set If you want to view the documentation set in PDF format or if you want print a hard copy of the documentation, open the PDF versions of the books that are located in the doc/pdf directory. You can also select PDF versions of the documentation by opening the doc/index.htm file in a browser. The API reference information is generated with the javadoc tool; therefore, PDF version of that information is not available. To view PDF files in Acrobat Reader, you must use Acrobat Reader 5.0 or a subsequent release. 16 PSE Pro for Java Release Notes

17 Release Notes New and Changed Features in Release 7.0 PSE Pro 7.0 contains the following new and changed features: License File Now Required Support for JDK 5 PSE Pro Compiled with JDK 5 PSE Pro API Additions and Changes Change in PSE Pro Database Format License File Now Required Support for JDK 5 To install and use PSE Pro 7.0, you must have a valid license file. You receive the license file when you purchase PSE Pro 7.0. During installation, the installation script prompts you for the location of the license file. Installation cannot procede without a valid license file. When PSE Pro tries to start, the process checks for a valid license file and does not start unless it finds one. You can now develop PSE Pro applications with JDK 5. The JDK 5 features you can use in a PSE Pro aplication include the following: Generics Enhanced for loop Autoboxing/unboxing Enum types Varargs Static import construct Annotations There are no new APIs as a result of PSE Pro support for JDK 1.5. However, to support generics, some existing APIs were changed in the com.odi.util collections classes. For example, the signature for the OSVector class was previously: public class OSVector; With PSE Pro 7.0, its signature is now as follows: public class OSVector<E>; As far as the compiler is concerned, nothing has changed. An application written for the previous API will run without any changes with the changed API. Information about how PSE Pro uses JDK 5 generics and enums has been added to the PSE Pro user guide, at the end of the section about storing objects. Release

18 Known Problems and Restrictions PSE Pro Compiled with JDK 5 PSE Pro itself is now compiled with JDK 5, including JDO. If you use JDO, and you want to use PSE Pro 7, you must move your application to JDK 5. If you cannot move your JDO application to JDK 5, then you must remain on a pre-7.0 release of PSE Pro. PSE Pro API Additions and Changes PSE Pro 7.0 includes the following API additions and changes. New Overloading for ObjectStore.destroy() Changed Signature for IPersistentHooks.preDestroyPersistent() Method Support for New Currency Type New Overloading for ObjectStore.destroy() The ObjectStore.destroy() method, which deletes persistent objects, has a new overloading that takes an enum as the second argument: public static void destroy(object object, DestroyOptions option) The value of the DestroyOptions enum can be one of the following: ASSERT_NO_DANGLING_REFERENCES When PSE Pro destroys the object, it does not leave a tombstone at the location occupied by the destroyed object. CAUTION: Specify this option only if the application is certain that there are no references to the object being destroyed. Database corruption can occur if you specify this option when there are references to the destroyed object in the database. DETECT_DANGLING_REFERENCES When PSE Pro destroys the object, it leaves a tombstone at the location of the destroyed object. If there is a reference to the destroyed object and the application tries to navigate through that reference, PSE Pro signals an exception. When the com.odi.forcetombstones property is set to true, the destroy() method always leaves a tombstone even if you specify ASSERT_NO_DANGLING_REFERENCES when you call the destroy() method. Changed Signature for IPersistentHooks.preDestroyPersistent() Method The predestroypersistent() method now requires one argument: void predestroypersistent(destroyoptions option) If you call the ObjectStore.destroy() method and you specify a DestroyOptions option, the predestroypersistent() method uses that value for its option argument. If you call the ObjectStore.destroy() method and you do not specify the DestroyOptions option, the predestroypersistent() method uses DETECT_ DANGLING_REFERENCES as the default value. If you are upgrading to 7 and your source code contains classes that implement the IPersistentHooks interface, you must modify your source code to use the new version of the predestroypersistent() method. 18 PSE Pro for Java Release Notes

19 Release Notes Support for New Currency Type You can now store java.util.currency objects in PSE Pro databases. Change in PSE Pro Database Format Changes in PSE Pro needed to support JDK 5 result in databases that are incompatible with earlier PSE Pro releases. You must upgrade each database that you want to use from PSE Pro 7 clients. PSE Pro includes the osjup70 utility for upgrading your database. Information about using this utility is in the PSE Pro user guide. Release

20 Known Problems and Restrictions 20 PSE Pro for Java Release Notes