je/docs/collections/tutorial/index.html

598 lines
19 KiB
HTML
Raw Permalink Normal View History

2021-06-06 17:46:45 +00:00
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Berkeley DB Java Edition Collections Tutorial</title>
<link rel="stylesheet" href="gettingStarted.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
<link rel="start" href="index.html" title="Berkeley DB Java Edition Collections Tutorial" />
<link rel="next" href="preface.html" title="Preface" />
</head>
<body>
<div xmlns="" class="navheader">
<div class="libver">
<p>Library Version 12.2.7.5</p>
</div>
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">Berkeley DB Java Edition Collections Tutorial</th>
</tr>
<tr>
<td width="20%" align="left"> </td>
<th width="60%" align="center"> </th>
<td width="20%" align="right"> <a accesskey="n" href="preface.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="book" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h1 class="title"><a id="idm892288"></a>Berkeley DB Java Edition Collections Tutorial</h1>
</div>
<div>
<div class="legalnotice">
<a id="idp233488"></a>
<p class="legalnotice-title">
<b>Legal Notice</b>
</p>
<p>
Copyright © 2002 - 2017 Oracle and/or its affiliates. All rights
reserved.
</p>
<p>
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.
</p>
<p>
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.
</p>
<p>
Berkeley DB,
<span>Berkeley DB Java Edition</span>
and
Sleepycat are trademarks or registered trademarks of
Oracle. All rights to these marks are reserved.
No third-party use is permitted without the
express prior written consent of Oracle.
</p>
<p>
Other names may be trademarks of their respective owners.
</p>
<p>
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:
</p>
<p>
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.
Government end users are "commercial computer software"
pursuant to the applicable Federal Acquisition Regulation and
agency-specific supplemental regulations. As such, use,
duplication, disclosure, modification, and adaptation of the
programs, including any operating system, integrated software,
any programs installed on the hardware, and/or documentation,
shall be subject to license terms and license restrictions
applicable to the programs. No other rights are granted to the
U.S. Government.
</p>
<p>
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.
</p>
<p>
Oracle and Java are registered trademarks of Oracle and/or its
affiliates. Other names may be trademarks of their respective
owners.
</p>
<p>
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.
</p>
<p>
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.
</p>
</div>
</div>
<div>
<p class="pubdate">31-Oct-2017</p>
</div>
</div>
<hr />
</div>
<div class="toc">
<p>
<b>Table of Contents</b>
</p>
<dl>
<dt>
<span class="preface">
<a href="preface.html">Preface</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect1">
<a href="preface.html#conventions">Conventions Used in this Book</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="moreinfo.html">For More Information</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect2">
<a href="moreinfo.html#contact_us">Contact Us</a>
</span>
</dt>
</dl>
</dd>
</dl>
</dd>
<dt>
<span class="chapter">
<a href="intro.html">1.
Introduction
</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect1">
<a href="intro.html#features">Features</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="developing.html">Developing a JE Collections Application</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="tutorialintroduction.html">Tutorial Introduction</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="chapter">
<a href="BasicProgram.html">2.
The Basic Program
</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect1">
<a href="BasicProgram.html#keyandvalueclasses">
Defining Serialized Key and Value Classes
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="opendbenvironment.html">
Opening and Closing the Database Environment
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="openclasscatalog.html">
Opening and Closing the Class Catalog
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="opendatabases.html">
Opening and Closing Databases
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="createbindingscollections.html">
Creating Bindings and Collections
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="implementingmain.html">
Implementing the Main Program
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="usingtransactions.html">
Using Transactions
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="addingdatabaseitems.html">
Adding Database Items
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="retrievingdatabaseitems.html">
Retrieving Database Items
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="handlingexceptions.html">
Handling Exceptions
</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="chapter">
<a href="UsingSecondaries.html">3.
Using Secondary Indices<span> and Foreign keys</span>
</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect1">
<a href="UsingSecondaries.html#opensecondaryindices">
Opening Secondary Key Indices
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="openingforeignkeys.html">
<span>Opening Foreign Key Indices</span>
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="indexedcollections.html">
Creating Indexed Collections
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="retrievingbyindexkey.html">
Retrieving Items by Index Key
</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="chapter">
<a href="Entity.html">4.
Using Entity Classes
</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect1">
<a href="Entity.html#definingentityclasses">
Defining Entity Classes
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="creatingentitybindings.html">
Creating Entity Bindings
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="collectionswithentities.html">
Creating Collections with Entity Bindings
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="entitieswithcollections.html">
Using Entities with Collections
</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="chapter">
<a href="Tuple.html">5.
Using Tuples
</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect1">
<a href="Tuple.html#tupleformat">
Using the Tuple Format
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="tupleswithkeycreators.html">
Using Tuples with Key Creators
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="tuplekeybindings.html">
Creating Tuple Key Bindings
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="tuple-serialentitybindings.html">
Creating Tuple-Serial Entity Bindings
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="sortedcollections.html">
Using Sorted Collections
</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="chapter">
<a href="SerializableEntity.html">6.
Using Serializable Entities
</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect1">
<a href="SerializableEntity.html#transientfieldsinclass">
Using Transient Fields in an Entity Class
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="transientfieldsinbinding.html">
Using Transient Fields in an Entity Binding
</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="removingredundantvalueclasses.html">
Removing the Redundant Value Classes
</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="chapter">
<a href="Summary.html">7.
Summary
</a>
</span>
</dt>
<dt>
<span class="appendix">
<a href="collectionOverview.html">A.
API Notes and Details
</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect1">
<a href="collectionOverview.html#UsingDataBindings">
Using Data Bindings
</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect2">
<a href="collectionOverview.html#SelectingBindingFormats">
Selecting Binding Formats
</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="collectionOverview.html#SelectingDataBindings">
Selecting Data Bindings
</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="collectionOverview.html#ImplementingBindings">
Implementing Bindings
</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="collectionOverview.html#UsingBindings">
Using Bindings
</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="collectionOverview.html#SecondaryKeyCreators">
Secondary Key Creators
</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="sect1">
<a href="UsingCollectionsAPI.html">
Using the JE JE Collections API
</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect2">
<a href="UsingCollectionsAPI.html#UsingTransactions">
Using Transactions
</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="UsingCollectionsAPI.html#TransactionRollback">
Transaction Rollback
</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="UsingCollectionsAPI.html#AccessMethodRestrictions">
Access Method Restrictions
</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="sect1">
<a href="UsingStoredCollections.html">
Using Stored Collections
</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect2">
<a href="UsingStoredCollections.html#StoredCollectionAccessMethods">
Stored Collection and Access Methods
</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="UsingStoredCollections.html#StoredVersusStandardCollections">
Stored Collections Versus Standard Java Collections
</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="UsingStoredCollections.html#StoredCollectionCharacteristics">
Other Stored Collection Characteristics
</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="UsingStoredCollections.html#WhyJavaCollections">
Why Java Collections for Berkeley DB Java Edition
</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="sect1">
<a href="SerializedObjectStorage.html">
Serialized Object Storage
</a>
</span>
</dt>
</dl>
</dd>
</dl>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"> </td>
<td width="20%" align="center"> </td>
<td width="40%" align="right"> <a accesskey="n" href="preface.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top"> </td>
<td width="20%" align="center"> </td>
<td width="40%" align="right" valign="top"> Preface</td>
</tr>
</table>
</div>
</body>
</html>