Oracle SQL Developer. User s Guide Release 3.1 E

Transcription

1 Oracle SQL Developer User s Guide Release 3.1 E January 2012 Provides conceptual and usage information about Oracle SQL Developer, a graphical tool that enables you to browse, create, edit, and delete (drop) database objects; run SQL statements and scripts; edit and debug PL/SQL code; manipulate and export data; migrate third-party databases to Oracle; view metadata and data in third-party databases; and view and create reports.

2 Oracle SQL Developer User's Guide, Release 3.1 E Copyright 2006, 2012, Oracle and/or its affiliates. All rights reserved. Primary Author: Chuck Murray 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 , Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

3 Contents Preface... xvii Audience... Documentation Accessibility... Product Accessibility... Related Documents... Conventions... Third-Party License Information... xvii xvii xvii xvii xviii xviii 1 SQL Developer Concepts and Usage 1.1 Installing and Getting Started with SQL Developer SQL Developer User Interface Menus for SQL Developer Restoring the Original "Look and Feel" Database Objects Applications (Application Express and Later) Cache Groups (Oracle TimesTen In-Memory Database) Chains Credentials Database Destinations Database Links (Public and Private) Destination Groups Directories Editions File Watchers Functions Indexes Java Sources Jobs Job Classes Materialized Views Materialized View Logs Packages Procedures Programs Queues iii

4 iv Queue Tables Recycle Bin Replication Schemes (Oracle TimesTen In-Memory Database) Schedules Sequences Synonyms (Public and Private) Tables Flashback Table Support Triggers Types Users (Other Users) Views XML DB Repository XML Schemas Captured and Converted Database Objects (for Migration) Database Connections Using Folders to Group Connections Sharing of Connections Advanced Security for JDBC Connection to the Database Connections with Operating System (OS) Authentication Connections with Proxy Authentication Entering and Modifying Data Running and Debugging Functions and Procedures Using Bookmarks When Editing Functions and Procedures Remote Debugging Displaying SQL Trace (.trc) Files Using the PL/SQL Hierarchical Profiler Setting Expression Watches Using the SQL Worksheet SQL*Plus Statements Supported and Not Supported in SQL Worksheet Script Runner Execution Plan Autotrace Pane DBMS Output Pane OWA Output Pane SQL History Query Builder Command-Line Interface for SQL Formatting Gauges: In the SQL Worksheet and User-Defined Reports Using Snippets to Insert Code Fragments User-Defined Snippets Finding Database Objects Using Versioning About Subversion and SQL Developer About CVS and SQL Developer Pending Changes (CVS) Using DBA Features in SQL Developer

5 Container Database Database Configuration Database Status Data Pump RMAN Backup/Recovery Using Action Jobs Resource Manager Scheduler Security Storage SQL Translation Profiles Scheduling Jobs Using SQL Developer Scheduler Design Editor Deploying Objects Using the SQL Developer Cart Spatial Support in SQL Developer Context Menu Operations on Spatial Data and Metadata Map Visualization of Spatial Data Visualizing Geometries by Creating and Executing a Query Visualizing Geometries from the Table Data Grid Change Manager Support in SQL Developer Change Plan Administrators and Developers User Interface for Change Manager Support Developing Change Plans with SQL Developer Creating a Repository Connection Creating and Deleting Change Plans Adding and Updating Change Items Using Change Plans to Capture Change in SQL Developer Change Manager Actions to Perform with Enterprise Manager Creating Change Plans from Change Manager Schema Comparisons Deploying Change Plans SQL Developer Reports About Your Database reports All Objects reports Application Express reports ASH and AWR reports Charts reports Database Administration reports Data Dictionary reports Scheduler reports PL/SQL reports Security reports Streams reports Table reports XML reports Data Modeler reports User Defined reports User-Defined Report Example: Chart v

6 vi User-Defined Report Example: Dynamic HTML SQL Developer Preferences Environment Change Management Parameters Code Editor Compare and Merge Database Debugger Extensions External Editor File Types Global Ignore List Migration Mouseover Popups Shortcut Keys (Accelerator Keys) Unit Test Parameters Versioning Web Browser and Proxy XML Schemas Location of User-Related Information Data Modeler in SQL Developer Oracle TimesTen In-Memory Database Support Using the Help Tip of the Day SQL History Shortcuts Unshared Worksheets SQL Worksheet Bookmarks Oracle Data Miner Formatted Display of SQL Trace (.trc) Files Keyboard Navigation: Alt + Page Down/Up to Move Among Tabs Folders for Organizing Connections Third-Party Databases and SQL Developer Debugger Ports and Firewalls Viewing Multiple Tables Customizing SQL Developer Appearance Maximizing Tab Panes Default Path for Running Scripts Shutting Down and Restarting the Database Feature Requests Discussion Forums Help Text Font Size Procedure and Function Signatures Type-Ahead in Navigators Extended Paste Closing Tabbed Windows Using the Mouse Wheel Go to Last Edit Location Closing Tabbed Windows Using the Context Menu

7 List of All Open Windows Go to Subprogram Implementation from Package Window Select Multiple Table or Column Names in Completion Insight Startup Time and Automatic Check for Updates For More Information SQL Developer: Migrating Third-Party Databases 2.1 Migration: Basic Options and Steps Migrating Using the Migration Wizard Copying Selected Tables to Oracle Migration: Background Information and Guidelines Overview of Migration How Migration Works Migration Implemented as SQL Developer Extensions Preparing a Migration Plan Task 1: Determining the Requirements of the Migration Project Task 2: Estimating Workload Task 3: Analyzing Operational Requirements Task 4: Analyzing the Application Task 5: Planning the Migration Project Before You Start Migrating: General Information Creating a Database User for the Migration Repository Requirements for Creating the Destination Oracle Objects Before You Start Migrating: Source-Specific Information Before Migrating From IBM DB Before Migrating From Microsoft SQL Server or Sybase Adaptive Server Before Migrating From Microsoft Access Before Migrating From MySQL Before Migrating From Teradata Capturing the Source Database Offline Capture Creating and Customizing the Converted Model Correcting Errors in the Converted Model Generating the DDL for the Oracle Schema Objects Migrating the Data Transferring the Data Offline Making Queries Case Insensitive Testing the Oracle Database Testing Methodology Testing the Oracle Database Deploying the Oracle Database Choosing a Rollout Strategy Deploying the Destination Database SQL Developer User Interface for Migration Migration Submenu Other Menus: Migration Items Migration Preferences vii

8 2.3.4 Migration Log Panes Using the Translation Scratch Editor Command-Line Interface for Migration SQL Developer: Unit Testing 3.1 Overview of Unit Testing SQL Developer User Interface for Unit Testing Unit Test Submenu Other Menus: Unit Test Items Unit Test Preferences Unit Test Repository Managing Repository Users and Administrators Editing and Running a Unit Test Using a Dynamic Value Query to Create a Unit Test Using Lookups to Simplify Unit Test Creation Providing Values for Input Fields Automatically Creating Implementations Using Variable Substitution in Validation Actions Unit Test Library Unit Test Reports Exporting and Importing Unit Test Objects Command-Line Interface for Unit Testing Example of Unit Testing (Tutorial) Create the EMPLOYEES Table Create the AWARD_BONUS Procedure Create the Unit Testing Repository Create a Unit Test Run the Unit Test Create and Run an Exception Unit Test Create a Unit Test Suite Run the Unit Test Suite SQL Developer Tutorial: Creating Objects for a Small Database 4.1 Create a Table (BOOKS) Create a Table (PATRONS) Create a Table (TRANSACTIONS) Create a Sequence Insert Data into the Tables Create a View Create a PL/SQL Procedure Debug a PL/SQL Procedure Use the SQL Worksheet for Queries Script for Creating and Using the Library Tutorial Objects SQL Developer Dialog Boxes and Wizards 5.1 Add Extension viii

9 5.2 Add Schema Error Analyze Database Migration Application Migration Change Type Check for Updates Check Out from CVS Choose Directory Component Palette Component Palette: Configure Component Palette Component Palette: Create Palette Page Component Palette: New/Edit Code Snippet Component Palette: New Section / Rename Section Confirm Drop Application Confirm Running SQL Connection Has Uncommitted Changes Create New Object Create Chain Create/Edit Credential Create/Edit CVS Connection Create/Edit/Select Database Connection Rename Model (Migration) Delete Confirmation Delete Confirmation (Migration) Rename Database Item (Migration) Select Connection Connection Information No Connection Found Connection Rename Error New Folder (Connections) Continue After Pause Select Library Create Library Data Import Wizard (Load Data) Export/Import Connection Descriptors Create Database Destination Create Destination Group (Database or External) Create/Edit Database Link Create/Edit Index Create Filter Create/Edit Job Create/Edit Job Class Create/Edit Materialized View Log Create PL/SQL Package Create PL/SQL Subprogram (Function or Procedure) Create Program Create/Edit Role Create/Edit Schedule ix

10 x 5.49 Create/Edit Sequence Create SQL File Create/Edit Synonym Create Table (quick creation) Create/Edit Table (with advanced options) Storage Options Create/Edit Tablespace Create Trigger Create Type (User-Defined) Create/Edit User Create/Edit User Defined Report Create/Edit User Defined Report Folder Create/Edit View Create XML Schema Color Palette and Custom Colors Configure Extension Configure File Type Associations Copy Columns Custom Filters Data Pump Export Data Pump Import Database Copy Database Differences Database Export (Unload Database Objects and Data) DDL Panel for Creating or Editing an Object Debugger - Attach to JPDA Deploy or Import Application Deploy Objects Describe Object Window Edit/View Value (Data or Table Column) Enter Bind Values Erase from Disk Error Writing to Export File Export Error Export Data External Locator Configuration External Tools Create/Edit External Tool Choose Offline Options Edit Font Location Edit Header or Footer (PDF Formatting) Edit Join Feature Missing Feature Required File Processing Filter Filter Object Types

11 5.96 Filter Schemas Filter Error Find/Highlight Insert Macro Externally Modified Files Find/Replace Text Find Result Format Properties Generate Patch Go to Bookmark Go to Line Number Go to Line Number: Error History Import to CVS Invalid Database Version Load Keyboard Scheme Log In to CVS Maintain Spatial Metadata Manage Columns Modify Value Data Move Details New Procedure (Refactoring) No Lock No Object Found No Object Selected Object Preferences Offline Generation Error - Destination Directory Open File Oracle-Only Report Oracle Proxy Authentication Paste Privilege Warning for Migration Recent Files Create Repository Delete or Truncate Repository Capture Microsoft Access Exporter XML Rename Local Variable Rename Tab Rename Procedure Select Current Repository Cannot Capture Table Report Panel Reset Expired Password (Enter New Password) Revision Lister Run/Debug/Profile PL/SQL Create/Edit Breakpoint Save/Save As, or Select File xi

12 xii Save Files Unable to Save Files Save Style Settings Schema Differences Source or Destination Error Script Execution Failed Script Generation Complete Set Data Mapping Add/Edit Rule Set Encoding Set Pause Continue Shared Wizard Pages Types Specify Objects Data Summary Sign In (checking for updates) Single Record View Save Snippet (User-Defined) Edit Snippets (User-Defined) Show SQL Start Date, End Date, Repeat Interval, Comments (Scheduler) Subversion: Add Property Subversion: Add to Source Control Subversion: Apply Patch Subversion: Branch/Tag Subversion: Check Out from Subversion Subversion: Commit Resources Subversion: Commit Working Copy Subversion: Confirm Checkout Subversion: Create Remote Directory Subversion: Create Subversion Repository Subversion: Create/Edit Subversion Connection Subversion: Delete Resources Subversion: Edit Configuration File Subversion: Export Files Subversion: Export Subversion Connections Subversion: Ignore Subversion: Import Subversion Connections Subversion: Import to Subversion Subversion: Lock Resources Subversion: Merge Subversion: Pending Changes Subversion: Properties Subversion: Remove from Subversion Subversion: Repository Browser Subversion: Revert Local Changes Subversion: Switch

13 5.186 Subversion: Unlock Resources Subversion: Update Resources Subversion: Update Working Copy Subversion: Versioning Properties Third-Party Database Objects Unable to Connect Unable to Open File Unit Testing: Action Required Unit Testing: Add Category Unit Testing: Add Data Type Unit Testing: Add Item to Library Unit Testing: Add Test Implementation Unit Testing: Add Test Suite Unit Testing: Add Tests or Suites to a Suite Unit Testing: Copy or Rename Unit Test Unit Testing: Create Unit Test Unit Testing: Manage Users Unit Testing: Rename Test Implementation Unit Testing: Result of Operation Unit Testing: Synchronize Unit Test Unsupported Database Version Validate Geometry View Whole Value Windows XMLType Column Properties SQL Developer Accessibility Information 6.1 About Oracle SQL Developer Accessibility Using a Screen Reader and Java Access Bridge with Oracle SQL Developer Oracle SQL Developer Features that Support Accessibility Keyboard Access Screen Reader Readability Flexibility in Font and Color Choices No Audio-only Feedback No Dependency on Blinking Cursor and Animation Screen Magnifier Usability How to Change the Editor or Tabbed View of a File How to Read Text in a Multi-line Edit Field How to Read the Line Number in the Source Editor How to Access Exception Stack HTML Links and Generated Javadoc Links in the Log Window Recommendations for Customizing Oracle SQL Developer How to Customize the Accelerators Keys How to Pass a Conflicting Accelerator Key to Oracle SQL Developer How to Change the Look and Feel of SQL Developer How to Customize the Fonts in Code Editors How to Customize Syntax Highlighting xiii

14 xiv How to Display Line Numbers in Code Editors How to Change the Timing for Completion Insight How to Specify the Columns in the Debugger Highly Visual Features of Oracle SQL Developer

15 List of Figures 1 1 SQL Developer Main Window SQL Developer Migration Architecture V-model with a Database Migration Main Window for a Database Migration Unit Test Navigator xv

16 List of Tables 1 1 Default Locations for User-Related Information Complex and Simple Scenarios xvi

17 Preface This guide provides conceptual and usage information about Oracle SQL Developer, a graphical tool that enables you to browse, create, edit, and delete (drop) database objects; run SQL statements and scripts; edit and debug PL/SQL code; manipulate and export data; and view and create reports. Audience This guide is intended for those using the Oracle SQL Developer tool. Documentation Accessibility For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at Access to Oracle Support Oracle customers have access to electronic support through My Oracle Support. For information, visit or visit if you are hearing impaired. Product Accessibility Related Documents If you are using a screen reader (such as JAWS), SQL Developer must be running on the same system as the screen reader. For more information about using a screen reader and Java Access Bridge with SQL Developer, see Chapter 6, "SQL Developer Accessibility Information" and Oracle SQL Developer Installation Guide. For information about installing Oracle SQL Developer, see the Oracle SQL Developer Installation Guide. Oracle error message documentation is only available in HTML. If you only have access to the Oracle Documentation CD, you can browse the error messages by range. Once you find the specific range, use your browser's "find in page" feature to locate the xvii

18 specific message. When connected to the Internet, you can search for a specific error message using the error message search feature of the Oracle online documentation. To download free release notes, installation documentation, white papers, or other collateral, go to the Oracle Technology Network (OTN) at The documentation section of the OTN site is at Conventions The following text conventions are used in this document: Convention boldface italic monospace Meaning Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary. Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values. Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter. Third-Party License Information Oracle SQL Developer contains third-party code. Oracle is required to provide the following notices. Note, however, that the Oracle program license that accompanied this product determines your right to use the Oracle program, including the third-party software, and the terms contained in the following notices do not change those rights. Antlr This program contains Antlr 3.1.3, which has the following associated attribution text: ANTLR 3 License [The BSD License] Copyright (c) , Terence Parr All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the author nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN xviii

19 ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Batik Version 1.7 This program contains Batik version 1.7, which has the following associated attribution text: This product includes software developed by The Apache Software Foundation ( This software contains code from the World Wide Web Consortium (W3C) for the Document Object Model API (DOM API) and SVG Document Type Definition (DTD). This software contains code from the International Organisation for Standardization for the definition of character entities used in the software's documentation. 2. Must include Apache License, Version 2.0 with any distribution of Apache Batik 1.7: Apache License Version 2.0, January TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly xix

20 perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: a. You must give any other recipients of the Work or Derivative Works a copy of this License; and b. You must cause any modified files to carry prominent notices stating that You changed the files; and c. You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and d. If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent xx

21 acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS Appendix: How to Apply Apache License to Your Work To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. Bouncy Castle Crypto API 1.45 This program includes Bouncy Castle Crypto API 1.45, which has the following associated attribution text: Copyright (c) The Legion Of The Bouncy Castle ( 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. JGoodies Looks This program includes JGoodies Looks 1.3.1, which has the following associated attribution text: The BSD License for the JGoodies Looks xxi

22 Copyright 2003 JGoodies Karsten Lentzsch. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of JGoodies Karsten Lentzsch nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. JXLayer 4.0 This program includes JXLayer 4.0, which has the following associated attribution text: Copyright (c) , Alexander Potochkin All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of the JXLayer project nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Log4j This program contains Log4j 1.2.9, which has the following associated attribution text: xxii

23 The Apache Software License, Version 1.1 * * Copyright (c) 2000 The Apache Software Foundation. All rights * reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * * 3. The end-user documentation included with the redistribution, * if any, must include the following acknowledgment: * "This product includes software developed by the * Apache Software Foundation (Link1 /)." * Alternately, this acknowledgment may appear in the software itself, * if and wherever such third-party acknowledgments normally appear. * * 4. The names "Apache" and "Apache Software Foundation" must * not be used to endorse or promote products derived from this * software without prior written permission. For written * permission, please contact apache@apache.org. * * 5. Products derived from this software may not be called "Apache", * nor may "Apache" appear in their name, without prior written * permission of the Apache Software Foundation. * * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. * =============================================================== ===== * * This software consists of voluntary contributions made by many * individuals on behalf of the Apache Software Foundation. For more * information on the Apache Software Foundation, please see * <Link2 />. * * Portions of this software are based upon public domain software * originally written at the National Center for Supercomputing Applications, * University of Illinois, Urbana-Champaign. */ POI This program contains POI 2.5.1, which has the following associated attribution text: The following applies to all products licensed under the Apache 2.0 License: You may not use the identified files except in compliance with the Apache License, Version 2.0 (the "License.") You may obtain a copy of the License at A copy of the license is also reproduced below. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. Apache License Version 2.0, January 2004 Link2 / TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) xxiii

24 ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those xxiv