1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<!--NewPage--> 3<HTML> 4<HEAD> 5<!-- Generated by javadoc (build 1.6.0_03) on Mon Apr 12 16:25:49 EDT 2010 --> 6<TITLE> 7StoredMap (Oracle - Berkeley DB Java API) 8</TITLE> 9 10<META NAME="date" CONTENT="2010-04-12"> 11 12<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../style.css" TITLE="Style"> 13 14<SCRIPT type="text/javascript"> 15function windowTitle() 16{ 17 if (location.href.indexOf('is-external=true') == -1) { 18 parent.document.title="StoredMap (Oracle - Berkeley DB Java API)"; 19 } 20} 21</SCRIPT> 22<NOSCRIPT> 23</NOSCRIPT> 24 25</HEAD> 26 27<BODY BGCOLOR="white" onload="windowTitle();"> 28<HR> 29 30 31<!-- ========= START OF TOP NAVBAR ======= --> 32<A NAME="navbar_top"><!-- --></A> 33<A HREF="#skip-navbar_top" title="Skip navigation links"></A> 34<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 35<TR> 36<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 37<A NAME="navbar_top_firstrow"><!-- --></A> 38<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 39 <TR ALIGN="center" VALIGN="top"> 40 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 41 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> 42 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> 43 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/StoredMap.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 44 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 45 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 46 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 47 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 48 </TR> 49</TABLE> 50</TD> 51<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 52<b>Berkeley DB</b><br><font size="-1"> version 4.8.30</font></EM> 53</TD> 54</TR> 55 56<TR> 57<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 58 <A HREF="../../../com/sleepycat/collections/StoredList.html" title="class in com.sleepycat.collections"><B>PREV CLASS</B></A> 59 <A HREF="../../../com/sleepycat/collections/StoredSortedEntrySet.html" title="class in com.sleepycat.collections"><B>NEXT CLASS</B></A></FONT></TD> 60<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 61 <A HREF="../../../index.html?com/sleepycat/collections/StoredMap.html" target="_top"><B>FRAMES</B></A> 62 <A HREF="StoredMap.html" target="_top"><B>NO FRAMES</B></A> 63 <SCRIPT type="text/javascript"> 64 <!-- 65 if(window==top) { 66 document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); 67 } 68 //--> 69</SCRIPT> 70<NOSCRIPT> 71 <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A> 72</NOSCRIPT> 73 74 75</FONT></TD> 76</TR> 77<TR> 78<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 79 SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> 80<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 81DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> 82</TR> 83</TABLE> 84<A NAME="skip-navbar_top"></A> 85<!-- ========= END OF TOP NAVBAR ========= --> 86 87<HR> 88<!-- ======== START OF CLASS DATA ======== --> 89<H2> 90<FONT SIZE="-1"> 91com.sleepycat.collections</FONT> 92<BR> 93Class StoredMap<K,V></H2> 94<PRE> 95<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</A> 96 <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../com/sleepycat/collections/StoredContainer.html" title="class in com.sleepycat.collections">com.sleepycat.collections.StoredContainer</A> 97 <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>com.sleepycat.collections.StoredMap<K,V></B> 98</PRE> 99<DL> 100<DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Cloneable.html?is-external=true" title="class or interface in java.lang">Cloneable</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true" title="class or interface in java.util.concurrent">ConcurrentMap</A><K,V>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><K,V></DD> 101</DL> 102<DL> 103<DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../com/sleepycat/collections/StoredSortedMap.html" title="class in com.sleepycat.collections">StoredSortedMap</A></DD> 104</DL> 105<HR> 106<DL> 107<DT><PRE>public class <B>StoredMap<K,V></B><DT>extends <A HREF="../../../com/sleepycat/collections/StoredContainer.html" title="class in com.sleepycat.collections">StoredContainer</A><DT>implements <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true" title="class or interface in java.util.concurrent">ConcurrentMap</A><K,V></DL> 108</PRE> 109 110<P> 111A Map view of a <A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><CODE>Database</CODE></A>. 112 113 <p>In addition to the standard Map methods, this class provides the 114 following methods for stored maps only. Note that the use of these methods 115 is not compatible with the standard Java collections interface.</p> 116 <ul> 117 <li><A HREF="../../../com/sleepycat/collections/StoredMap.html#duplicates(K)"><CODE>duplicates(K)</CODE></A></li> 118 <li><A HREF="../../../com/sleepycat/collections/StoredMap.html#duplicatesMap(K, com.sleepycat.bind.EntryBinding)"><CODE>duplicatesMap(K, com.sleepycat.bind.EntryBinding)</CODE></A></li> 119 <li><A HREF="../../../com/sleepycat/collections/StoredMap.html#append(V)"><CODE>append(V)</CODE></A></li> 120 </ul> 121<P> 122 123<P> 124<HR> 125 126<P> 127<!-- ======== NESTED CLASS SUMMARY ======== --> 128 129<A NAME="nested_class_summary"><!-- --></A> 130<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 131<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 132<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 133<B>Nested Class Summary</B></FONT></TH> 134</TR> 135</TABLE> 136 <A NAME="nested_classes_inherited_from_class_java.util.Map"><!-- --></A> 137<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 138<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> 139<TH ALIGN="left"><B>Nested classes/interfaces inherited from interface java.util.<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A></B></TH> 140</TR> 141<TR BGCOLOR="white" CLASS="TableRowColor"> 142<TD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.Entry.html?is-external=true" title="class or interface in java.util">Map.Entry</A><<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.Entry.html?is-external=true" title="class or interface in java.util">K</A>,<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.Entry.html?is-external=true" title="class or interface in java.util">V</A>></CODE></TD> 143</TR> 144</TABLE> 145 146 147<!-- ======== CONSTRUCTOR SUMMARY ======== --> 148 149<A NAME="constructor_summary"><!-- --></A> 150<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 151<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 152<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 153<B>Constructor Summary</B></FONT></TH> 154</TR> 155<TR BGCOLOR="white" CLASS="TableRowColor"> 156<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#StoredMap(com.sleepycat.db.Database, com.sleepycat.bind.EntryBinding, com.sleepycat.bind.EntityBinding, boolean)">StoredMap</A></B>(<A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db">Database</A> database, 157 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>> keyBinding, 158 <A HREF="../../../com/sleepycat/bind/EntityBinding.html" title="interface in com.sleepycat.bind">EntityBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>> valueEntityBinding, 159 boolean writeAllowed)</CODE> 160 161<BR> 162 Creates a map entity view of a <A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><CODE>Database</CODE></A>.</TD> 163</TR> 164<TR BGCOLOR="white" CLASS="TableRowColor"> 165<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#StoredMap(com.sleepycat.db.Database, com.sleepycat.bind.EntryBinding, com.sleepycat.bind.EntityBinding, com.sleepycat.collections.PrimaryKeyAssigner)">StoredMap</A></B>(<A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db">Database</A> database, 166 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>> keyBinding, 167 <A HREF="../../../com/sleepycat/bind/EntityBinding.html" title="interface in com.sleepycat.bind">EntityBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>> valueEntityBinding, 168 <A HREF="../../../com/sleepycat/collections/PrimaryKeyAssigner.html" title="interface in com.sleepycat.collections">PrimaryKeyAssigner</A> keyAssigner)</CODE> 169 170<BR> 171 Creates a map entity view of a <A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><CODE>Database</CODE></A> with a <A HREF="../../../com/sleepycat/collections/PrimaryKeyAssigner.html" title="interface in com.sleepycat.collections"><CODE>PrimaryKeyAssigner</CODE></A>.</TD> 172</TR> 173<TR BGCOLOR="white" CLASS="TableRowColor"> 174<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#StoredMap(com.sleepycat.db.Database, com.sleepycat.bind.EntryBinding, com.sleepycat.bind.EntryBinding, boolean)">StoredMap</A></B>(<A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db">Database</A> database, 175 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>> keyBinding, 176 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>> valueBinding, 177 boolean writeAllowed)</CODE> 178 179<BR> 180 Creates a map view of a <A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><CODE>Database</CODE></A>.</TD> 181</TR> 182<TR BGCOLOR="white" CLASS="TableRowColor"> 183<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#StoredMap(com.sleepycat.db.Database, com.sleepycat.bind.EntryBinding, com.sleepycat.bind.EntryBinding, com.sleepycat.collections.PrimaryKeyAssigner)">StoredMap</A></B>(<A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db">Database</A> database, 184 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>> keyBinding, 185 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>> valueBinding, 186 <A HREF="../../../com/sleepycat/collections/PrimaryKeyAssigner.html" title="interface in com.sleepycat.collections">PrimaryKeyAssigner</A> keyAssigner)</CODE> 187 188<BR> 189 Creates a map view of a <A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><CODE>Database</CODE></A> with a <A HREF="../../../com/sleepycat/collections/PrimaryKeyAssigner.html" title="interface in com.sleepycat.collections"><CODE>PrimaryKeyAssigner</CODE></A>.</TD> 190</TR> 191</TABLE> 192 193<!-- ========== METHOD SUMMARY =========== --> 194 195<A NAME="method_summary"><!-- --></A> 196<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 197<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 198<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 199<B>Method Summary</B></FONT></TH> 200</TR> 201<TR BGCOLOR="white" CLASS="TableRowColor"> 202<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 203<CODE> <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A></CODE></FONT></TD> 204<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#append(V)">append</A></B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> value)</CODE> 205 206<BR> 207 Appends a given value returning the newly assigned key.</TD> 208</TR> 209<TR BGCOLOR="white" CLASS="TableRowColor"> 210<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 211<CODE> boolean</CODE></FONT></TD> 212<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#containsKey(java.lang.Object)">containsKey</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> key)</CODE> 213 214<BR> 215 Returns true if this map contains the specified key.</TD> 216</TR> 217<TR BGCOLOR="white" CLASS="TableRowColor"> 218<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 219<CODE> boolean</CODE></FONT></TD> 220<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#containsValue(java.lang.Object)">containsValue</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> value)</CODE> 221 222<BR> 223 Returns true if this map contains the specified value.</TD> 224</TR> 225<TR BGCOLOR="white" CLASS="TableRowColor"> 226<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 227<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></FONT></TD> 228<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#duplicates(K)">duplicates</A></B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A> key)</CODE> 229 230<BR> 231 Returns a new collection containing the values mapped to the given key 232 in this map.</TD> 233</TR> 234<TR BGCOLOR="white" CLASS="TableRowColor"> 235<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 236<CODE> 237<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY=""> 238<TR ALIGN="right" VALIGN=""> 239<TD NOWRAP><FONT SIZE="-1"> 240<CODE><PK> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><PK,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></FONT></TD> 241</TR> 242</TABLE> 243</CODE></FONT></TD> 244<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#duplicatesMap(K, com.sleepycat.bind.EntryBinding)">duplicatesMap</A></B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A> secondaryKey, 245 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A> primaryKeyBinding)</CODE> 246 247<BR> 248 Returns a new map from primary key to value for the subset of records 249 having a given secondary key (duplicates).</TD> 250</TR> 251<TR BGCOLOR="white" CLASS="TableRowColor"> 252<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 253<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</A><<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.Entry.html?is-external=true" title="class or interface in java.util">Map.Entry</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>>></CODE></FONT></TD> 254<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#entrySet()">entrySet</A></B>()</CODE> 255 256<BR> 257 Returns a set view of the mappings contained in this map.</TD> 258</TR> 259<TR BGCOLOR="white" CLASS="TableRowColor"> 260<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 261<CODE> boolean</CODE></FONT></TD> 262<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#equals(java.lang.Object)">equals</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> other)</CODE> 263 264<BR> 265 Compares the specified object with this map for equality.</TD> 266</TR> 267<TR BGCOLOR="white" CLASS="TableRowColor"> 268<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 269<CODE> <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A></CODE></FONT></TD> 270<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#get(java.lang.Object)">get</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> key)</CODE> 271 272<BR> 273 Returns the value to which this map maps the specified key.</TD> 274</TR> 275<TR BGCOLOR="white" CLASS="TableRowColor"> 276<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 277<CODE> int</CODE></FONT></TD> 278<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#hashCode()">hashCode</A></B>()</CODE> 279 280<BR> 281 </TD> 282</TR> 283<TR BGCOLOR="white" CLASS="TableRowColor"> 284<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 285<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>></CODE></FONT></TD> 286<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#keySet()">keySet</A></B>()</CODE> 287 288<BR> 289 Returns a set view of the keys contained in this map.</TD> 290</TR> 291<TR BGCOLOR="white" CLASS="TableRowColor"> 292<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 293<CODE> <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A></CODE></FONT></TD> 294<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#put(K, V)">put</A></B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A> key, 295 <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> value)</CODE> 296 297<BR> 298 Associates the specified value with the specified key in this map 299 (optional operation).</TD> 300</TR> 301<TR BGCOLOR="white" CLASS="TableRowColor"> 302<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 303<CODE> void</CODE></FONT></TD> 304<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#putAll(java.util.Map)">putAll</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><? extends <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,? extends <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>> map)</CODE> 305 306<BR> 307 Copies all of the mappings from the specified map to this map (optional 308 operation).</TD> 309</TR> 310<TR BGCOLOR="white" CLASS="TableRowColor"> 311<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 312<CODE> <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A></CODE></FONT></TD> 313<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#putIfAbsent(K, V)">putIfAbsent</A></B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A> key, 314 <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> value)</CODE> 315 316<BR> 317 If the specified key is not already associated with a value, associate 318 it with the given value.</TD> 319</TR> 320<TR BGCOLOR="white" CLASS="TableRowColor"> 321<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 322<CODE> <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A></CODE></FONT></TD> 323<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#remove(java.lang.Object)">remove</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> key)</CODE> 324 325<BR> 326 Removes the mapping for this key from this map if present (optional 327 operation).</TD> 328</TR> 329<TR BGCOLOR="white" CLASS="TableRowColor"> 330<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 331<CODE> boolean</CODE></FONT></TD> 332<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#remove(java.lang.Object, java.lang.Object)">remove</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> key, 333 <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> value)</CODE> 334 335<BR> 336 Remove entry for key only if currently mapped to given value.</TD> 337</TR> 338<TR BGCOLOR="white" CLASS="TableRowColor"> 339<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 340<CODE> <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A></CODE></FONT></TD> 341<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#replace(K, V)">replace</A></B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A> key, 342 <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> value)</CODE> 343 344<BR> 345 Replace entry for key only if currently mapped to some value.</TD> 346</TR> 347<TR BGCOLOR="white" CLASS="TableRowColor"> 348<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 349<CODE> boolean</CODE></FONT></TD> 350<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#replace(K, V, V)">replace</A></B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A> key, 351 <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> oldValue, 352 <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> newValue)</CODE> 353 354<BR> 355 Replace entry for key only if currently mapped to given value.</TD> 356</TR> 357<TR BGCOLOR="white" CLASS="TableRowColor"> 358<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 359<CODE> int</CODE></FONT></TD> 360<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#size()">size</A></B>()</CODE> 361 362<BR> 363 Returns a non-transactional count of the records in the collection or 364 map.</TD> 365</TR> 366<TR BGCOLOR="white" CLASS="TableRowColor"> 367<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 368<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD> 369<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#toString()">toString</A></B>()</CODE> 370 371<BR> 372 Converts the map to a string representation for debugging.</TD> 373</TR> 374<TR BGCOLOR="white" CLASS="TableRowColor"> 375<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 376<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></FONT></TD> 377<TD><CODE><B><A HREF="../../../com/sleepycat/collections/StoredMap.html#values()">values</A></B>()</CODE> 378 379<BR> 380 Returns a collection view of the values contained in this map.</TD> 381</TR> 382</TABLE> 383 <A NAME="methods_inherited_from_class_com.sleepycat.collections.StoredContainer"><!-- --></A> 384<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 385<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> 386<TH ALIGN="left"><B>Methods inherited from class com.sleepycat.collections.<A HREF="../../../com/sleepycat/collections/StoredContainer.html" title="class in com.sleepycat.collections">StoredContainer</A></B></TH> 387</TR> 388<TR BGCOLOR="white" CLASS="TableRowColor"> 389<TD><CODE><A HREF="../../../com/sleepycat/collections/StoredContainer.html#areDuplicatesAllowed()">areDuplicatesAllowed</A>, <A HREF="../../../com/sleepycat/collections/StoredContainer.html#areDuplicatesOrdered()">areDuplicatesOrdered</A>, <A HREF="../../../com/sleepycat/collections/StoredContainer.html#areKeyRangesAllowed()">areKeyRangesAllowed</A>, <A HREF="../../../com/sleepycat/collections/StoredContainer.html#areKeysRenumbered()">areKeysRenumbered</A>, <A HREF="../../../com/sleepycat/collections/StoredContainer.html#clear()">clear</A>, <A HREF="../../../com/sleepycat/collections/StoredContainer.html#getCursorConfig()">getCursorConfig</A>, <A HREF="../../../com/sleepycat/collections/StoredContainer.html#isEmpty()">isEmpty</A>, <A HREF="../../../com/sleepycat/collections/StoredContainer.html#isOrdered()">isOrdered</A>, <A HREF="../../../com/sleepycat/collections/StoredContainer.html#isSecondary()">isSecondary</A>, <A HREF="../../../com/sleepycat/collections/StoredContainer.html#isTransactional()">isTransactional</A>, <A HREF="../../../com/sleepycat/collections/StoredContainer.html#isWriteAllowed()">isWriteAllowed</A></CODE></TD> 390</TR> 391</TABLE> 392 <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A> 393<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 394<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> 395<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></B></TH> 396</TR> 397<TR BGCOLOR="white" CLASS="TableRowColor"> 398<TD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD> 399</TR> 400</TABLE> 401 <A NAME="methods_inherited_from_class_java.util.Map"><!-- --></A> 402<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 403<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> 404<TH ALIGN="left"><B>Methods inherited from interface java.util.<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A></B></TH> 405</TR> 406<TR BGCOLOR="white" CLASS="TableRowColor"> 407<TD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#clear()" title="class or interface in java.util">clear</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#isEmpty()" title="class or interface in java.util">isEmpty</A></CODE></TD> 408</TR> 409</TABLE> 410 411<P> 412 413<!-- ========= CONSTRUCTOR DETAIL ======== --> 414 415<A NAME="constructor_detail"><!-- --></A> 416<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 417<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 418<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 419<B>Constructor Detail</B></FONT></TH> 420</TR> 421</TABLE> 422 423<A NAME="StoredMap(com.sleepycat.db.Database, com.sleepycat.bind.EntryBinding, com.sleepycat.bind.EntryBinding, boolean)"><!-- --></A><H3> 424StoredMap</H3> 425<PRE> 426public <B>StoredMap</B>(<A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db">Database</A> database, 427 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>> keyBinding, 428 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>> valueBinding, 429 boolean writeAllowed)</PRE> 430<DL> 431<DD>Creates a map view of a <A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><CODE>Database</CODE></A>. 432<P> 433<DL> 434<DT><B>Parameters:</B><DD><CODE>database</CODE> - is the Database underlying the new collection.<DD><CODE>keyBinding</CODE> - is the binding used to translate between key buffers 435 and key objects.<DD><CODE>valueBinding</CODE> - is the binding used to translate between value 436 buffers and value objects.<DD><CODE>writeAllowed</CODE> - is true to create a read-write collection or false 437 to create a read-only collection. 438<DT><B>Throws:</B> 439<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if formats are not consistently 440 defined or a parameter is invalid. 441<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 442</DL> 443<HR> 444 445<A NAME="StoredMap(com.sleepycat.db.Database, com.sleepycat.bind.EntryBinding, com.sleepycat.bind.EntryBinding, com.sleepycat.collections.PrimaryKeyAssigner)"><!-- --></A><H3> 446StoredMap</H3> 447<PRE> 448public <B>StoredMap</B>(<A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db">Database</A> database, 449 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>> keyBinding, 450 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>> valueBinding, 451 <A HREF="../../../com/sleepycat/collections/PrimaryKeyAssigner.html" title="interface in com.sleepycat.collections">PrimaryKeyAssigner</A> keyAssigner)</PRE> 452<DL> 453<DD>Creates a map view of a <A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><CODE>Database</CODE></A> with a <A HREF="../../../com/sleepycat/collections/PrimaryKeyAssigner.html" title="interface in com.sleepycat.collections"><CODE>PrimaryKeyAssigner</CODE></A>. Writing is allowed for the created map. 454<P> 455<DL> 456<DT><B>Parameters:</B><DD><CODE>database</CODE> - is the Database underlying the new collection.<DD><CODE>keyBinding</CODE> - is the binding used to translate between key buffers 457 and key objects.<DD><CODE>valueBinding</CODE> - is the binding used to translate between value 458 buffers and value objects.<DD><CODE>keyAssigner</CODE> - is used by the <A HREF="../../../com/sleepycat/collections/StoredMap.html#append(V)"><CODE>append(V)</CODE></A> method to assign 459 primary keys. 460<DT><B>Throws:</B> 461<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if formats are not consistently 462 defined or a parameter is invalid. 463<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 464</DL> 465<HR> 466 467<A NAME="StoredMap(com.sleepycat.db.Database, com.sleepycat.bind.EntryBinding, com.sleepycat.bind.EntityBinding, boolean)"><!-- --></A><H3> 468StoredMap</H3> 469<PRE> 470public <B>StoredMap</B>(<A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db">Database</A> database, 471 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>> keyBinding, 472 <A HREF="../../../com/sleepycat/bind/EntityBinding.html" title="interface in com.sleepycat.bind">EntityBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>> valueEntityBinding, 473 boolean writeAllowed)</PRE> 474<DL> 475<DD>Creates a map entity view of a <A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><CODE>Database</CODE></A>. 476<P> 477<DL> 478<DT><B>Parameters:</B><DD><CODE>database</CODE> - is the Database underlying the new collection.<DD><CODE>keyBinding</CODE> - is the binding used to translate between key buffers 479 and key objects.<DD><CODE>valueEntityBinding</CODE> - is the binding used to translate between 480 key/value buffers and entity value objects.<DD><CODE>writeAllowed</CODE> - is true to create a read-write collection or false 481 to create a read-only collection. 482<DT><B>Throws:</B> 483<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if formats are not consistently 484 defined or a parameter is invalid. 485<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 486</DL> 487<HR> 488 489<A NAME="StoredMap(com.sleepycat.db.Database, com.sleepycat.bind.EntryBinding, com.sleepycat.bind.EntityBinding, com.sleepycat.collections.PrimaryKeyAssigner)"><!-- --></A><H3> 490StoredMap</H3> 491<PRE> 492public <B>StoredMap</B>(<A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db">Database</A> database, 493 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>> keyBinding, 494 <A HREF="../../../com/sleepycat/bind/EntityBinding.html" title="interface in com.sleepycat.bind">EntityBinding</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>> valueEntityBinding, 495 <A HREF="../../../com/sleepycat/collections/PrimaryKeyAssigner.html" title="interface in com.sleepycat.collections">PrimaryKeyAssigner</A> keyAssigner)</PRE> 496<DL> 497<DD>Creates a map entity view of a <A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><CODE>Database</CODE></A> with a <A HREF="../../../com/sleepycat/collections/PrimaryKeyAssigner.html" title="interface in com.sleepycat.collections"><CODE>PrimaryKeyAssigner</CODE></A>. Writing is allowed for the created map. 498<P> 499<DL> 500<DT><B>Parameters:</B><DD><CODE>database</CODE> - is the Database underlying the new collection.<DD><CODE>keyBinding</CODE> - is the binding used to translate between key buffers 501 and key objects.<DD><CODE>valueEntityBinding</CODE> - is the binding used to translate between 502 key/value buffers and entity value objects.<DD><CODE>keyAssigner</CODE> - is used by the <A HREF="../../../com/sleepycat/collections/StoredMap.html#append(V)"><CODE>append(V)</CODE></A> method to assign 503 primary keys. 504<DT><B>Throws:</B> 505<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if formats are not consistently 506 defined or a parameter is invalid. 507<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 508</DL> 509 510<!-- ============ METHOD DETAIL ========== --> 511 512<A NAME="method_detail"><!-- --></A> 513<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 514<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 515<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 516<B>Method Detail</B></FONT></TH> 517</TR> 518</TABLE> 519 520<A NAME="get(java.lang.Object)"><!-- --></A><H3> 521get</H3> 522<PRE> 523public <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> <B>get</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> key)</PRE> 524<DL> 525<DD>Returns the value to which this map maps the specified key. If 526 duplicates are allowed, this method returns the first duplicate, in the 527 order in which duplicates are configured, that maps to the specified 528 key. 529 530 This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#get(java.lang.Object)" title="class or interface in java.util"><CODE>Map.get(java.lang.Object)</CODE></A> interface. 531<P> 532<DD><DL> 533<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#get(java.lang.Object)" title="class or interface in java.util">get</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></DL> 534</DD> 535<DD><DL> 536 537<DT><B>Throws:</B> 538<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 539</DD> 540</DL> 541<HR> 542 543<A NAME="put(java.lang.Object,java.lang.Object)"><!-- --></A><A NAME="put(K, V)"><!-- --></A><H3> 544put</H3> 545<PRE> 546public <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> <B>put</B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A> key, 547 <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> value)</PRE> 548<DL> 549<DD>Associates the specified value with the specified key in this map 550 (optional operation). If duplicates are allowed and the specified key 551 is already mapped to a value, this method appends the new duplicate 552 after the existing duplicates. This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#put(K, V)" title="class or interface in java.util"><CODE>Map.put(K, V)</CODE></A> interface. 553 554 <p>The key parameter may be null if an entity binding is used and the 555 key will be derived from the value (entity) parameter. If an entity 556 binding is used and the key parameter is non-null, then the key 557 parameter must be equal to the key derived from the value parameter.</p> 558<P> 559<DD><DL> 560<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#put(K, V)" title="class or interface in java.util">put</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></DL> 561</DD> 562<DD><DL> 563 564<DT><B>Returns:</B><DD>the previous value associated with specified key, or null if 565 there was no mapping for the key or if duplicates are allowed. 566<DT><B>Throws:</B> 567<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/UnsupportedOperationException.html?is-external=true" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if the collection is indexed, or 568 if the collection is read-only. 569<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if an entity value binding is used and 570 the primary key of the value given is different than the existing stored 571 primary key. 572<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 573</DD> 574</DL> 575<HR> 576 577<A NAME="append(java.lang.Object)"><!-- --></A><A NAME="append(V)"><!-- --></A><H3> 578append</H3> 579<PRE> 580public <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A> <B>append</B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> value)</PRE> 581<DL> 582<DD>Appends a given value returning the newly assigned key. If a <A HREF="../../../com/sleepycat/collections/PrimaryKeyAssigner.html" title="interface in com.sleepycat.collections"><CODE>PrimaryKeyAssigner</CODE></A> is associated with Store for this map, it will be 583 used to assigned the returned key. Otherwise the Store must be a QUEUE 584 or RECNO database and the next available record number is assigned as 585 the key. This method does not exist in the standard <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><CODE>Map</CODE></A> 586 interface. 587 588 <p>Note that for the JE product, QUEUE and RECNO databases are not 589 supported, and therefore a PrimaryKeyAssigner must be associated with 590 the map in order to call this method.</p> 591<P> 592<DD><DL> 593</DL> 594</DD> 595<DD><DL> 596<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be appended. 597<DT><B>Returns:</B><DD>the assigned key. 598<DT><B>Throws:</B> 599<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/UnsupportedOperationException.html?is-external=true" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if the collection is indexed, or 600 if the collection is read-only, or if the Store has no <A HREF="../../../com/sleepycat/collections/PrimaryKeyAssigner.html" title="interface in com.sleepycat.collections"><CODE>PrimaryKeyAssigner</CODE></A> and is not a QUEUE or RECNO database. 601<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 602</DD> 603</DL> 604<HR> 605 606<A NAME="remove(java.lang.Object)"><!-- --></A><H3> 607remove</H3> 608<PRE> 609public <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> <B>remove</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> key)</PRE> 610<DL> 611<DD>Removes the mapping for this key from this map if present (optional 612 operation). If duplicates are allowed, this method removes all 613 duplicates for the given key. This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#remove(java.lang.Object)" title="class or interface in java.util"><CODE>Map.remove(java.lang.Object)</CODE></A> interface. 614<P> 615<DD><DL> 616<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#remove(java.lang.Object)" title="class or interface in java.util">remove</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></DL> 617</DD> 618<DD><DL> 619 620<DT><B>Throws:</B> 621<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/UnsupportedOperationException.html?is-external=true" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if the collection is read-only. 622<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 623</DD> 624</DL> 625<HR> 626 627<A NAME="putIfAbsent(java.lang.Object,java.lang.Object)"><!-- --></A><A NAME="putIfAbsent(K, V)"><!-- --></A><H3> 628putIfAbsent</H3> 629<PRE> 630public <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> <B>putIfAbsent</B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A> key, 631 <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> value)</PRE> 632<DL> 633<DD>If the specified key is not already associated with a value, associate 634 it with the given value. This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true#putIfAbsent(K, V)" title="class or interface in java.util.concurrent"><CODE>ConcurrentMap.putIfAbsent(K, V)</CODE></A> interface. 635<P> 636<DD><DL> 637<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true#putIfAbsent(K, V)" title="class or interface in java.util.concurrent">putIfAbsent</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true" title="class or interface in java.util.concurrent">ConcurrentMap</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></DL> 638</DD> 639<DD><DL> 640 641<DT><B>Throws:</B> 642<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 643</DD> 644</DL> 645<HR> 646 647<A NAME="remove(java.lang.Object, java.lang.Object)"><!-- --></A><H3> 648remove</H3> 649<PRE> 650public boolean <B>remove</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> key, 651 <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> value)</PRE> 652<DL> 653<DD>Remove entry for key only if currently mapped to given value. This 654 method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true#remove(java.lang.Object, java.lang.Object)" title="class or interface in java.util.concurrent"><CODE>ConcurrentMap.remove(Object,Object)</CODE></A> 655 interface. 656<P> 657<DD><DL> 658<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true#remove(java.lang.Object, java.lang.Object)" title="class or interface in java.util.concurrent">remove</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true" title="class or interface in java.util.concurrent">ConcurrentMap</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></DL> 659</DD> 660<DD><DL> 661 662<DT><B>Throws:</B> 663<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 664</DD> 665</DL> 666<HR> 667 668<A NAME="replace(java.lang.Object,java.lang.Object)"><!-- --></A><A NAME="replace(K, V)"><!-- --></A><H3> 669replace</H3> 670<PRE> 671public <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> <B>replace</B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A> key, 672 <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> value)</PRE> 673<DL> 674<DD>Replace entry for key only if currently mapped to some value. This 675 method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true#replace(K, V)" title="class or interface in java.util.concurrent"><CODE>ConcurrentMap.replace(Object,Object)</CODE></A> 676 interface. 677<P> 678<DD><DL> 679<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true#replace(K, V)" title="class or interface in java.util.concurrent">replace</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true" title="class or interface in java.util.concurrent">ConcurrentMap</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></DL> 680</DD> 681<DD><DL> 682 683<DT><B>Throws:</B> 684<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 685</DD> 686</DL> 687<HR> 688 689<A NAME="replace(java.lang.Object,java.lang.Object,java.lang.Object)"><!-- --></A><A NAME="replace(K, V, V)"><!-- --></A><H3> 690replace</H3> 691<PRE> 692public boolean <B>replace</B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A> key, 693 <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> oldValue, 694 <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A> newValue)</PRE> 695<DL> 696<DD>Replace entry for key only if currently mapped to given value. This 697 method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true#replace(K, V, V)" title="class or interface in java.util.concurrent"><CODE>ConcurrentMap.replace(Object,Object,Object)</CODE></A> interface. 698<P> 699<DD><DL> 700<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true#replace(K, V, V)" title="class or interface in java.util.concurrent">replace</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true" title="class or interface in java.util.concurrent">ConcurrentMap</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></DL> 701</DD> 702<DD><DL> 703 704<DT><B>Throws:</B> 705<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 706</DD> 707</DL> 708<HR> 709 710<A NAME="containsKey(java.lang.Object)"><!-- --></A><H3> 711containsKey</H3> 712<PRE> 713public boolean <B>containsKey</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> key)</PRE> 714<DL> 715<DD>Returns true if this map contains the specified key. This method 716 conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#containsKey(java.lang.Object)" title="class or interface in java.util"><CODE>Map.containsKey(java.lang.Object)</CODE></A> interface. 717<P> 718<DD><DL> 719<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#containsKey(java.lang.Object)" title="class or interface in java.util">containsKey</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></DL> 720</DD> 721<DD><DL> 722 723<DT><B>Throws:</B> 724<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 725</DD> 726</DL> 727<HR> 728 729<A NAME="containsValue(java.lang.Object)"><!-- --></A><H3> 730containsValue</H3> 731<PRE> 732public boolean <B>containsValue</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> value)</PRE> 733<DL> 734<DD>Returns true if this map contains the specified value. When an entity 735 binding is used, this method returns whether the map contains the 736 primary key and value mapping of the entity. This method conforms to 737 the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#containsValue(java.lang.Object)" title="class or interface in java.util"><CODE>Map.containsValue(java.lang.Object)</CODE></A> interface. 738<P> 739<DD><DL> 740<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#containsValue(java.lang.Object)" title="class or interface in java.util">containsValue</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></DL> 741</DD> 742<DD><DL> 743 744<DT><B>Throws:</B> 745<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 746</DD> 747</DL> 748<HR> 749 750<A NAME="putAll(java.util.Map)"><!-- --></A><H3> 751putAll</H3> 752<PRE> 753public void <B>putAll</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><? extends <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,? extends <A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>> map)</PRE> 754<DL> 755<DD>Copies all of the mappings from the specified map to this map (optional 756 operation). When duplicates are allowed, the mappings in the specified 757 map are effectively appended to the existing mappings in this map, that 758 is no previously existing mappings in this map are replaced. This 759 method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#putAll(java.util.Map)" title="class or interface in java.util"><CODE>Map.putAll(java.util.Map<? extends K, ? extends V>)</CODE></A> interface. 760<P> 761<DD><DL> 762<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#putAll(java.util.Map)" title="class or interface in java.util">putAll</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></DL> 763</DD> 764<DD><DL> 765 766<DT><B>Throws:</B> 767<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/UnsupportedOperationException.html?is-external=true" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if the collection is read-only, or 768 if the collection is indexed. 769<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 770</DD> 771</DL> 772<HR> 773 774<A NAME="keySet()"><!-- --></A><H3> 775keySet</H3> 776<PRE> 777public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>> <B>keySet</B>()</PRE> 778<DL> 779<DD>Returns a set view of the keys contained in this map. A <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/SortedSet.html?is-external=true" title="class or interface in java.util"><CODE>SortedSet</CODE></A> is returned if the map supports key ranges. The 780 returned collection will be read-only if the map is read-only. This 781 method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#keySet()" title="class or interface in java.util"><CODE>Map.keySet()</CODE></A> interface. 782 783 <p>Note that the return value is a StoredCollection and must be treated 784 as such; for example, its iterators must be explicitly closed.</p> 785<P> 786<DD><DL> 787<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#keySet()" title="class or interface in java.util">keySet</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></DL> 788</DD> 789<DD><DL> 790 791<DT><B>Returns:</B><DD>a <A HREF="../../../com/sleepycat/collections/StoredKeySet.html" title="class in com.sleepycat.collections"><CODE>StoredKeySet</CODE></A> or a <A HREF="../../../com/sleepycat/collections/StoredSortedKeySet.html" title="class in com.sleepycat.collections"><CODE>StoredSortedKeySet</CODE></A> for this 792 map. 793<DT><B>Throws:</B> 794<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.<DT><B>See Also:</B><DD><A HREF="../../../com/sleepycat/collections/StoredContainer.html#areKeyRangesAllowed()"><CODE>StoredContainer.areKeyRangesAllowed()</CODE></A>, 795<A HREF="../../../com/sleepycat/collections/StoredContainer.html#isWriteAllowed()"><CODE>StoredContainer.isWriteAllowed()</CODE></A></DL> 796</DD> 797</DL> 798<HR> 799 800<A NAME="entrySet()"><!-- --></A><H3> 801entrySet</H3> 802<PRE> 803public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</A><<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.Entry.html?is-external=true" title="class or interface in java.util">Map.Entry</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>>> <B>entrySet</B>()</PRE> 804<DL> 805<DD>Returns a set view of the mappings contained in this map. A <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/SortedSet.html?is-external=true" title="class or interface in java.util"><CODE>SortedSet</CODE></A> is returned if the map supports key ranges. The 806 returned collection will be read-only if the map is read-only. This 807 method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#entrySet()" title="class or interface in java.util"><CODE>Map.entrySet()</CODE></A> interface. 808 809 <p>Note that the return value is a StoredCollection and must be treated 810 as such; for example, its iterators must be explicitly closed.</p> 811<P> 812<DD><DL> 813<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#entrySet()" title="class or interface in java.util">entrySet</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></DL> 814</DD> 815<DD><DL> 816 817<DT><B>Returns:</B><DD>a <A HREF="../../../com/sleepycat/collections/StoredEntrySet.html" title="class in com.sleepycat.collections"><CODE>StoredEntrySet</CODE></A> or a <A HREF="../../../com/sleepycat/collections/StoredSortedEntrySet.html" title="class in com.sleepycat.collections"><CODE>StoredSortedEntrySet</CODE></A> for 818 this map. 819<DT><B>Throws:</B> 820<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.<DT><B>See Also:</B><DD><A HREF="../../../com/sleepycat/collections/StoredContainer.html#areKeyRangesAllowed()"><CODE>StoredContainer.areKeyRangesAllowed()</CODE></A>, 821<A HREF="../../../com/sleepycat/collections/StoredContainer.html#isWriteAllowed()"><CODE>StoredContainer.isWriteAllowed()</CODE></A></DL> 822</DD> 823</DL> 824<HR> 825 826<A NAME="values()"><!-- --></A><H3> 827values</H3> 828<PRE> 829public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>> <B>values</B>()</PRE> 830<DL> 831<DD>Returns a collection view of the values contained in this map. A <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/SortedSet.html?is-external=true" title="class or interface in java.util"><CODE>SortedSet</CODE></A> is returned if the map supports key ranges and the 832 value/entity binding can be used to derive the map's key from its 833 value/entity object. The returned collection will be read-only if the 834 map is read-only. This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#values()" title="class or interface in java.util"><CODE>Map.values()</CODE></A> 835 interface. 836 837 <p>Note that the return value is a StoredCollection and must be treated 838 as such; for example, its iterators must be explicitly closed.</p> 839<P> 840<DD><DL> 841<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#values()" title="class or interface in java.util">values</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE></DL> 842</DD> 843<DD><DL> 844 845<DT><B>Returns:</B><DD>a <A HREF="../../../com/sleepycat/collections/StoredValueSet.html" title="class in com.sleepycat.collections"><CODE>StoredValueSet</CODE></A> or a <A HREF="../../../com/sleepycat/collections/StoredSortedValueSet.html" title="class in com.sleepycat.collections"><CODE>StoredSortedValueSet</CODE></A> for 846 this map. 847<DT><B>Throws:</B> 848<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.<DT><B>See Also:</B><DD><A HREF="../../../com/sleepycat/collections/StoredContainer.html#areKeyRangesAllowed()"><CODE>StoredContainer.areKeyRangesAllowed()</CODE></A>, 849<A HREF="../../../com/sleepycat/collections/StoredContainer.html#isWriteAllowed()"><CODE>StoredContainer.isWriteAllowed()</CODE></A></DL> 850</DD> 851</DL> 852<HR> 853 854<A NAME="duplicates(java.lang.Object)"><!-- --></A><A NAME="duplicates(K)"><!-- --></A><H3> 855duplicates</H3> 856<PRE> 857public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>> <B>duplicates</B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A> key)</PRE> 858<DL> 859<DD>Returns a new collection containing the values mapped to the given key 860 in this map. This collection's iterator() method is particularly useful 861 for iterating over the duplicates for a given key, since this is not 862 supported by the standard Map interface. This method does not exist in 863 the standard <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><CODE>Map</CODE></A> interface. 864 865 <p>If no mapping for the given key is present, an empty collection is 866 returned. If duplicates are not allowed, at most a single value will be 867 in the collection returned. If duplicates are allowed, the returned 868 collection's add() method may be used to add values for the given 869 key.</p> 870<P> 871<DD><DL> 872</DL> 873</DD> 874<DD><DL> 875<DT><B>Parameters:</B><DD><CODE>key</CODE> - is the key for which values are to be returned. 876<DT><B>Throws:</B> 877<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 878</DD> 879</DL> 880<HR> 881 882<A NAME="duplicatesMap(java.lang.Object,com.sleepycat.bind.EntryBinding)"><!-- --></A><A NAME="duplicatesMap(K, com.sleepycat.bind.EntryBinding)"><!-- --></A><H3> 883duplicatesMap</H3> 884<PRE> 885public <PK> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><PK,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>> <B>duplicatesMap</B>(<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A> secondaryKey, 886 <A HREF="../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A> primaryKeyBinding)</PRE> 887<DL> 888<DD>Returns a new map from primary key to value for the subset of records 889 having a given secondary key (duplicates). This method does not exist 890 in the standard <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><CODE>Map</CODE></A> interface. 891 892 <p>If no mapping for the given key is present, an empty collection is 893 returned. If duplicates are not allowed, at most a single value will be 894 in the collection returned. If duplicates are allowed, the returned 895 collection's add() method may be used to add values for the given 896 key.</p> 897<P> 898<DD><DL> 899</DL> 900</DD> 901<DD><DL> 902<DT><B>Parameters:</B><DD><CODE>secondaryKey</CODE> - is the secondary key for which duplicates values 903 will be represented by the returned map.<DD><CODE>primaryKeyBinding</CODE> - is the binding used for keys in the returned 904 map. 905<DT><B>Throws:</B> 906<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 907</DD> 908</DL> 909<HR> 910 911<A NAME="equals(java.lang.Object)"><!-- --></A><H3> 912equals</H3> 913<PRE> 914public boolean <B>equals</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> other)</PRE> 915<DL> 916<DD>Compares the specified object with this map for equality. A value 917 comparison is performed by this method and the stored values are 918 compared rather than calling the equals() method of each element. This 919 method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.util"><CODE>Map.equals(java.lang.Object)</CODE></A> interface. 920<P> 921<DD><DL> 922<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.util">equals</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE><DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></CODE></DL> 923</DD> 924<DD><DL> 925 926<DT><B>Throws:</B> 927<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 928</DD> 929</DL> 930<HR> 931 932<A NAME="hashCode()"><!-- --></A><H3> 933hashCode</H3> 934<PRE> 935public int <B>hashCode</B>()</PRE> 936<DL> 937<DD><DL> 938<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#hashCode()" title="class or interface in java.util">hashCode</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE><DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></CODE></DL> 939</DD> 940<DD><DL> 941</DL> 942</DD> 943</DL> 944<HR> 945 946<A NAME="size()"><!-- --></A><H3> 947size</H3> 948<PRE> 949public int <B>size</B>()</PRE> 950<DL> 951<DD><B>Description copied from class: <CODE><A HREF="../../../com/sleepycat/collections/StoredContainer.html#size()">StoredContainer</A></CODE></B></DD> 952<DD>Returns a non-transactional count of the records in the collection or 953 map. This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Collection.html?is-external=true#size()" title="class or interface in java.util"><CODE>Collection.size()</CODE></A> and 954 <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#size()" title="class or interface in java.util"><CODE>Map.size()</CODE></A> interfaces. 955<P> 956<DD><DL> 957<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true#size()" title="class or interface in java.util">size</A></CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</A><<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">K</A>,<A HREF="../../../com/sleepycat/collections/StoredMap.html" title="type parameter in StoredMap">V</A>></CODE><DT><B>Specified by:</B><DD><CODE><A HREF="../../../com/sleepycat/collections/StoredContainer.html#size()">size</A></CODE> in class <CODE><A HREF="../../../com/sleepycat/collections/StoredContainer.html" title="class in com.sleepycat.collections">StoredContainer</A></CODE></DL> 958</DD> 959<DD><DL> 960</DL> 961</DD> 962</DL> 963<HR> 964 965<A NAME="toString()"><!-- --></A><H3> 966toString</H3> 967<PRE> 968public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>toString</B>()</PRE> 969<DL> 970<DD>Converts the map to a string representation for debugging. WARNING: All 971 mappings will be converted to strings and returned and therefore the 972 returned string may be very large. 973<P> 974<DD><DL> 975<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></CODE></DL> 976</DD> 977<DD><DL> 978 979<DT><B>Returns:</B><DD>the string representation. 980<DT><B>Throws:</B> 981<DD><CODE>RuntimeExceptionWrapper</CODE> - if a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 982</DD> 983</DL> 984<!-- ========= END OF CLASS DATA ========= --> 985<HR> 986 987 988<!-- ======= START OF BOTTOM NAVBAR ====== --> 989<A NAME="navbar_bottom"><!-- --></A> 990<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> 991<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 992<TR> 993<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 994<A NAME="navbar_bottom_firstrow"><!-- --></A> 995<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 996 <TR ALIGN="center" VALIGN="top"> 997 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 998 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> 999 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> 1000 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/StoredMap.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 1001 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 1002 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 1003 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 1004 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 1005 </TR> 1006</TABLE> 1007</TD> 1008<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 1009<b>Berkeley DB</b><br><font size="-1"> version 4.8.30</font></EM> 1010</TD> 1011</TR> 1012 1013<TR> 1014<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 1015 <A HREF="../../../com/sleepycat/collections/StoredList.html" title="class in com.sleepycat.collections"><B>PREV CLASS</B></A> 1016 <A HREF="../../../com/sleepycat/collections/StoredSortedEntrySet.html" title="class in com.sleepycat.collections"><B>NEXT CLASS</B></A></FONT></TD> 1017<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 1018 <A HREF="../../../index.html?com/sleepycat/collections/StoredMap.html" target="_top"><B>FRAMES</B></A> 1019 <A HREF="StoredMap.html" target="_top"><B>NO FRAMES</B></A> 1020 <SCRIPT type="text/javascript"> 1021 <!-- 1022 if(window==top) { 1023 document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); 1024 } 1025 //--> 1026</SCRIPT> 1027<NOSCRIPT> 1028 <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A> 1029</NOSCRIPT> 1030 1031 1032</FONT></TD> 1033</TR> 1034<TR> 1035<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 1036 SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> 1037<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 1038DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> 1039</TR> 1040</TABLE> 1041<A NAME="skip-navbar_bottom"></A> 1042<!-- ======== END OF BOTTOM NAVBAR ======= --> 1043 1044<HR> 1045<font size=1>Copyright (c) 1996-2009 Oracle. All rights reserved.</font> 1046</BODY> 1047</HTML> 1048
