• Home
  • History
  • Annotate
  • Line#
  • Navigate
  • Raw
  • Download
  • only in /asuswrt-rt-n18u-9.0.0.4.380.2695/release/src/router/db-4.8.30/docs/java/com/sleepycat/bind/serial/
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:48 EDT 2010 -->
6<TITLE>
7SerialBinding (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="SerialBinding (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>&nbsp;</TD>
41  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
42  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
43  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/SerialBinding.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
44  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
45  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
46  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
47  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</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&nbsp;<A HREF="../../../../com/sleepycat/bind/serial/SerialBase.html" title="class in com.sleepycat.bind.serial"><B>PREV CLASS</B></A>&nbsp;
59&nbsp;<A HREF="../../../../com/sleepycat/bind/serial/SerialInput.html" title="class in com.sleepycat.bind.serial"><B>NEXT CLASS</B></A></FONT></TD>
60<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
61  <A HREF="../../../../index.html?com/sleepycat/bind/serial/SerialBinding.html" target="_top"><B>FRAMES</B></A>  &nbsp;
62&nbsp;<A HREF="SerialBinding.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
63&nbsp;<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:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
80<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
81DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<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.bind.serial</FONT>
92<BR>
93Class SerialBinding&lt;E&gt;</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/bind/serial/SerialBase.html" title="class in com.sleepycat.bind.serial">com.sleepycat.bind.serial.SerialBase</A>
97      <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>com.sleepycat.bind.serial.SerialBinding&lt;E&gt;</B>
98</PRE>
99<DL>
100<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A>&lt;E&gt;</DD>
101</DL>
102<HR>
103<DL>
104<DT><PRE>public class <B>SerialBinding&lt;E&gt;</B><DT>extends <A HREF="../../../../com/sleepycat/bind/serial/SerialBase.html" title="class in com.sleepycat.bind.serial">SerialBase</A><DT>implements <A HREF="../../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A>&lt;E&gt;</DL>
105</PRE>
106
107<P>
108A concrete <code>EntryBinding</code> that treats a key or data entry as
109 a serialized object.
110
111 <p>This binding stores objects in serialized object format.  The
112 deserialized objects are returned by the binding, and their
113 <code>Class</code> must implement the <code>Serializable</code>
114 interface.</p>
115
116 <p>For key bindings, a tuple binding is usually a better choice than a
117 serial binding.  A tuple binding gives a reasonable sort order, and works
118 with comparators in all cases -- see below.</p>
119
120 <p><em>WARNING:</em> SerialBinding should not be used with Berkeley DB Java
121 Edition for key bindings, when a custom comparator is used.  In JE,
122 comparators are instantiated and called internally at times when databases
123 are not accessible.  Because serial bindings depend on the class catalog
124 database, a serial binding cannot be used during these times.  An attempt
125 to use a serial binding with a custom comparator will result in a
126 NullPointerException during environment open or close.</p>
127
128 <p><a name="evolution"><strong>Class Evolution</strong></a></p>
129
130 <p><code>SerialBinding</code> and other classes in this package use standard Java
131 serialization and all rules of Java serialization apply.  This includes the
132 rules for class evolution.  Once an instance of a class is stored, the class
133 must maintain its <code>serialVersionUID</code> and follow the rules defined in
134 the Java specification.  To use a new incompatible version of a class, a
135 different <A HREF="../../../../com/sleepycat/bind/serial/ClassCatalog.html" title="interface in com.sleepycat.bind.serial"><CODE>ClassCatalog</CODE></A> must be used or the class catalog database
136 must be truncated.</p>
137
138 <p>If more advanced class evolution features are required, consider using
139 the <A HREF="../../../../com/sleepycat/persist/evolve/package-summary.html"><CODE>Direct Persistence Layer</CODE></A>.</p>
140<P>
141
142<P>
143<HR>
144
145<P>
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/bind/serial/SerialBinding.html#SerialBinding(com.sleepycat.bind.serial.ClassCatalog, java.lang.Class)">SerialBinding</A></B>(<A HREF="../../../../com/sleepycat/bind/serial/ClassCatalog.html" title="interface in com.sleepycat.bind.serial">ClassCatalog</A>&nbsp;classCatalog,
157              <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</A>&lt;<A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html" title="type parameter in SerialBinding">E</A>&gt;&nbsp;baseClass)</CODE>
158
159<BR>
160&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a serial binding.</TD>
161</TR>
162</TABLE>
163&nbsp;
164<!-- ========== METHOD SUMMARY =========== -->
165
166<A NAME="method_summary"><!-- --></A>
167<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
168<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
169<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
170<B>Method Summary</B></FONT></TH>
171</TR>
172<TR BGCOLOR="white" CLASS="TableRowColor">
173<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
174<CODE>&nbsp;<A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html" title="type parameter in SerialBinding">E</A></CODE></FONT></TD>
175<TD><CODE><B><A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html#entryToObject(com.sleepycat.db.DatabaseEntry)">entryToObject</A></B>(<A HREF="../../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A>&nbsp;entry)</CODE>
176
177<BR>
178&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Deserialize an object from an entry buffer.</TD>
179</TR>
180<TR BGCOLOR="white" CLASS="TableRowColor">
181<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
182<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</A>&lt;<A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html" title="type parameter in SerialBinding">E</A>&gt;</CODE></FONT></TD>
183<TD><CODE><B><A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html#getBaseClass()">getBaseClass</A></B>()</CODE>
184
185<BR>
186&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the base class for this binding.</TD>
187</TR>
188<TR BGCOLOR="white" CLASS="TableRowColor">
189<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
190<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/ClassLoader.html?is-external=true" title="class or interface in java.lang">ClassLoader</A></CODE></FONT></TD>
191<TD><CODE><B><A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html#getClassLoader()">getClassLoader</A></B>()</CODE>
192
193<BR>
194&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the class loader to be used during deserialization, or null if
195 a default class loader should be used.</TD>
196</TR>
197<TR BGCOLOR="white" CLASS="TableRowColor">
198<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
199<CODE>&nbsp;void</CODE></FONT></TD>
200<TD><CODE><B><A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html#objectToEntry(E, com.sleepycat.db.DatabaseEntry)">objectToEntry</A></B>(<A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html" title="type parameter in SerialBinding">E</A>&nbsp;object,
201              <A HREF="../../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A>&nbsp;entry)</CODE>
202
203<BR>
204&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Serialize an object into an entry buffer.</TD>
205</TR>
206</TABLE>
207&nbsp;<A NAME="methods_inherited_from_class_com.sleepycat.bind.serial.SerialBase"><!-- --></A>
208<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
209<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
210<TH ALIGN="left"><B>Methods inherited from class com.sleepycat.bind.serial.<A HREF="../../../../com/sleepycat/bind/serial/SerialBase.html" title="class in com.sleepycat.bind.serial">SerialBase</A></B></TH>
211</TR>
212<TR BGCOLOR="white" CLASS="TableRowColor">
213<TD><CODE><A HREF="../../../../com/sleepycat/bind/serial/SerialBase.html#getSerialBufferSize()">getSerialBufferSize</A>, <A HREF="../../../../com/sleepycat/bind/serial/SerialBase.html#getSerialOutput(java.lang.Object)">getSerialOutput</A>, <A HREF="../../../../com/sleepycat/bind/serial/SerialBase.html#setSerialBufferSize(int)">setSerialBufferSize</A></CODE></TD>
214</TR>
215</TABLE>
216&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
217<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
218<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
219<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>
220</TR>
221<TR BGCOLOR="white" CLASS="TableRowColor">
222<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#equals(java.lang.Object)" title="class or interface in java.lang">equals</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#hashCode()" title="class or interface in java.lang">hashCode</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#toString()" title="class or interface in java.lang">toString</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>
223</TR>
224</TABLE>
225&nbsp;
226<P>
227
228<!-- ========= CONSTRUCTOR DETAIL ======== -->
229
230<A NAME="constructor_detail"><!-- --></A>
231<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
232<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
233<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
234<B>Constructor Detail</B></FONT></TH>
235</TR>
236</TABLE>
237
238<A NAME="SerialBinding(com.sleepycat.bind.serial.ClassCatalog, java.lang.Class)"><!-- --></A><H3>
239SerialBinding</H3>
240<PRE>
241public <B>SerialBinding</B>(<A HREF="../../../../com/sleepycat/bind/serial/ClassCatalog.html" title="interface in com.sleepycat.bind.serial">ClassCatalog</A>&nbsp;classCatalog,
242                     <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</A>&lt;<A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html" title="type parameter in SerialBinding">E</A>&gt;&nbsp;baseClass)</PRE>
243<DL>
244<DD>Creates a serial binding.
245<P>
246<DL>
247<DT><B>Parameters:</B><DD><CODE>classCatalog</CODE> - is the catalog to hold shared class information and
248 for a database should be a <A HREF="../../../../com/sleepycat/bind/serial/StoredClassCatalog.html" title="class in com.sleepycat.bind.serial"><CODE>StoredClassCatalog</CODE></A>.<DD><CODE>baseClass</CODE> - is the base class for serialized objects stored using
249 this binding -- all objects using this binding must be an instance of
250 this class.</DL>
251</DL>
252
253<!-- ============ METHOD DETAIL ========== -->
254
255<A NAME="method_detail"><!-- --></A>
256<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
257<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
258<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
259<B>Method Detail</B></FONT></TH>
260</TR>
261</TABLE>
262
263<A NAME="getBaseClass()"><!-- --></A><H3>
264getBaseClass</H3>
265<PRE>
266public final <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</A>&lt;<A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html" title="type parameter in SerialBinding">E</A>&gt; <B>getBaseClass</B>()</PRE>
267<DL>
268<DD>Returns the base class for this binding.
269<P>
270<DD><DL>
271</DL>
272</DD>
273<DD><DL>
274
275<DT><B>Returns:</B><DD>the base class for this binding.</DL>
276</DD>
277</DL>
278<HR>
279
280<A NAME="getClassLoader()"><!-- --></A><H3>
281getClassLoader</H3>
282<PRE>
283public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/ClassLoader.html?is-external=true" title="class or interface in java.lang">ClassLoader</A> <B>getClassLoader</B>()</PRE>
284<DL>
285<DD>Returns the class loader to be used during deserialization, or null if
286 a default class loader should be used.  The default implementation of
287 this method returns
288 <code>Thread.currentThread().getContextClassLoader()</code> to use the
289 context class loader for the current thread.
290
291 <p>This method may be overridden to return a dynamically determined class
292 loader.  For example, <code>getBaseClass().getClassLoader()</code> could
293 be called to use the class loader for the base class, assuming that a
294 base class has been specified.</p>
295
296 <p>If this method returns null, a default class loader will be used as
297 determined by the <code>java.io.ObjectInputStream.resolveClass</code>
298 method.</p>
299<P>
300<DD><DL>
301</DL>
302</DD>
303<DD><DL>
304</DL>
305</DD>
306</DL>
307<HR>
308
309<A NAME="entryToObject(com.sleepycat.db.DatabaseEntry)"><!-- --></A><H3>
310entryToObject</H3>
311<PRE>
312public <A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html" title="type parameter in SerialBinding">E</A> <B>entryToObject</B>(<A HREF="../../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A>&nbsp;entry)</PRE>
313<DL>
314<DD>Deserialize an object from an entry buffer.  May only be called for data
315 that was serialized using <A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html#objectToEntry(E, com.sleepycat.db.DatabaseEntry)"><CODE>objectToEntry(E, com.sleepycat.db.DatabaseEntry)</CODE></A>, since the fixed
316 serialization header is assumed to not be included in the input data.
317 <A HREF="../../../../com/sleepycat/bind/serial/SerialInput.html" title="class in com.sleepycat.bind.serial"><CODE>SerialInput</CODE></A> is used to deserialize the object.
318<P>
319<DD><DL>
320<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../com/sleepycat/bind/EntryBinding.html#entryToObject(com.sleepycat.db.DatabaseEntry)">entryToObject</A></CODE> in interface <CODE><A HREF="../../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A>&lt;<A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html" title="type parameter in SerialBinding">E</A>&gt;</CODE></DL>
321</DD>
322<DD><DL>
323<DT><B>Parameters:</B><DD><CODE>entry</CODE> - is the input serialized entry.
324<DT><B>Returns:</B><DD>the output deserialized object.</DL>
325</DD>
326</DL>
327<HR>
328
329<A NAME="objectToEntry(java.lang.Object,com.sleepycat.db.DatabaseEntry)"><!-- --></A><A NAME="objectToEntry(E, com.sleepycat.db.DatabaseEntry)"><!-- --></A><H3>
330objectToEntry</H3>
331<PRE>
332public void <B>objectToEntry</B>(<A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html" title="type parameter in SerialBinding">E</A>&nbsp;object,
333                          <A HREF="../../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A>&nbsp;entry)</PRE>
334<DL>
335<DD>Serialize an object into an entry buffer.  The fixed serialization
336 header is not included in the output data to save space, and therefore
337 to deserialize the data the complementary <A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html#entryToObject(com.sleepycat.db.DatabaseEntry)"><CODE>entryToObject(com.sleepycat.db.DatabaseEntry)</CODE></A> method
338 must be used.  <A HREF="../../../../com/sleepycat/bind/serial/SerialOutput.html" title="class in com.sleepycat.bind.serial"><CODE>SerialOutput</CODE></A> is used to serialize the object.
339
340 <p>Note that this method sets the DatabaseEntry offset property to a
341 non-zero value and the size property to a value less than the length of
342 the byte array.</p>
343<P>
344<DD><DL>
345<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../com/sleepycat/bind/EntryBinding.html#objectToEntry(E, com.sleepycat.db.DatabaseEntry)">objectToEntry</A></CODE> in interface <CODE><A HREF="../../../../com/sleepycat/bind/EntryBinding.html" title="interface in com.sleepycat.bind">EntryBinding</A>&lt;<A HREF="../../../../com/sleepycat/bind/serial/SerialBinding.html" title="type parameter in SerialBinding">E</A>&gt;</CODE></DL>
346</DD>
347<DD><DL>
348<DT><B>Parameters:</B><DD><CODE>object</CODE> - is the input deserialized object.<DD><CODE>entry</CODE> - is the output serialized entry.
349<DT><B>Throws:</B>
350<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 the object is not an instance of the
351 base class for this binding.</DL>
352</DD>
353</DL>
354<!-- ========= END OF CLASS DATA ========= -->
355<HR>
356
357
358<!-- ======= START OF BOTTOM NAVBAR ====== -->
359<A NAME="navbar_bottom"><!-- --></A>
360<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
361<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
362<TR>
363<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
364<A NAME="navbar_bottom_firstrow"><!-- --></A>
365<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
366  <TR ALIGN="center" VALIGN="top">
367  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
368  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
369  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
370  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/SerialBinding.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
371  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
372  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
373  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
374  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
375  </TR>
376</TABLE>
377</TD>
378<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
379<b>Berkeley DB</b><br><font size="-1"> version 4.8.30</font></EM>
380</TD>
381</TR>
382
383<TR>
384<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
385&nbsp;<A HREF="../../../../com/sleepycat/bind/serial/SerialBase.html" title="class in com.sleepycat.bind.serial"><B>PREV CLASS</B></A>&nbsp;
386&nbsp;<A HREF="../../../../com/sleepycat/bind/serial/SerialInput.html" title="class in com.sleepycat.bind.serial"><B>NEXT CLASS</B></A></FONT></TD>
387<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
388  <A HREF="../../../../index.html?com/sleepycat/bind/serial/SerialBinding.html" target="_top"><B>FRAMES</B></A>  &nbsp;
389&nbsp;<A HREF="SerialBinding.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
390&nbsp;<SCRIPT type="text/javascript">
391  <!--
392  if(window==top) {
393    document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
394  }
395  //-->
396</SCRIPT>
397<NOSCRIPT>
398  <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
399</NOSCRIPT>
400
401
402</FONT></TD>
403</TR>
404<TR>
405<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
406  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
407<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
408DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
409</TR>
410</TABLE>
411<A NAME="skip-navbar_bottom"></A>
412<!-- ======== END OF BOTTOM NAVBAR ======= -->
413
414<HR>
415<font size=1>Copyright (c) 1996-2009 Oracle.  All rights reserved.</font>
416</BODY>
417</HTML>
418