You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@river.apache.org by bu...@apache.org on 2010/12/24 21:24:29 UTC
svn commit: r781461 [3/4] -
/websites/staging/river/trunk/content/river/doc/api/net/jini/lease/
Added: websites/staging/river/trunk/content/river/doc/api/net/jini/lease/LeaseRenewalSet.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/net/jini/lease/LeaseRenewalSet.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/net/jini/lease/LeaseRenewalSet.html Fri Dec 24 20:24:29 2010
@@ -0,0 +1,825 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Mon Mar 08 17:46:21 EST 2010 -->
+<TITLE>
+LeaseRenewalSet (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.lease.LeaseRenewalSet interface">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="LeaseRenewalSet (Apache River v2.1.2-SNAPSHOT API Documentation)";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/LeaseRenewalSet.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../net/jini/lease/LeaseRenewalService.html" title="interface in net.jini.lease"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/lease/LeaseUnmarshalException.html" title="class in net.jini.lease"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/lease/LeaseRenewalSet.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LeaseRenewalSet.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+net.jini.lease</FONT>
+<BR>
+Interface LeaseRenewalSet</H2>
+<HR>
+<DL>
+<DT><PRE>public interface <B>LeaseRenewalSet</B></DL>
+</PRE>
+
+<P>
+A collection of leases being managed by a lease renewal service.
+ <p>
+ Clients of the renewal service organize the leases they wish to
+ have renewed into <em>lease renewal sets</em> (or <em>sets</em>,
+ for short). These sets are represented by objects implementing this
+ interface. The
+ <code>LeaseRenewalService.createLeaseRenewalSet</code> method is
+ provided to create sets. Sets are populated by methods on the sets
+ themselves. Two leases in the same set need not be granted by the
+ same service or have the same expiration time; in addition, they
+ can be added or removed from the set independently.
+ <p>
+ This interface is not a remote interface; each implementation of the
+ renewal service exports proxy objects that implement the
+ <code>LeaseRenewalSet</code> interface that use an
+ implementation-specific protocol to communicate with the actual
+ remote server. All of the proxy methods obey normal RMI remote
+ interface semantics except where explicitly noted. Two proxy objects
+ are equal if they are proxies for the same set created by the same
+ renewal service. Every method invocation (on both a
+ <code>LeaseRenewalService</code> and all the
+ <code>LeaseRenewalSet</code> instances created by that server) is
+ atomic with respect to other invocations.
+ <p>
+ A number of the methods in this class throw
+ <code>RemoteException</code>, each of these may throw the
+ <code>java.rmi.NoSuchObjectException</code> subclass. If a client
+ receives a <code>NoSuchObjectException</code> when calling a method
+ on a renewal set, the client can infer that the set has been
+ destroyed; however, it should not infer that the renewal service
+ has been destroyed.
+ <p>
+ The term <em>client lease</em> is used to refer to a lease that has
+ been placed into a renewal set. Client leases are distinct from the
+ leases that the renewal service grants on renewal sets it has
+ created.
+ <p>
+ Each client lease has two expiration related times associated with
+ it: the <em>desired expiration</em> time for the lease, and the
+ <em>actual expiration</em> time granted when the lease was created
+ or last renewed. The desired expiration represents when the client
+ would like the lease to expire. The actual expiration represents
+ when the lease is going to expire if it is not renewed. Both time
+ values are absolute times, not relative time durations. When a
+ client lease's desired expiration arrives, the lease will be
+ removed from the set without further client intervention.
+ <p>
+ Each client lease also has two other associated attributes: a
+ desired <em>renewal duration</em> and a <em>remaining desired
+ duration</em>. The desired renewal duration is specified by the
+ client (directly or indirectly) when the lease is added to the
+ set. This duration must normally be a positive number, however, it
+ may be <code>Lease.ANY</code> if the lease's desired expiration is
+ <code>Lease.FOREVER</code>. The remaining desired duration is
+ always the desired expiration less the current time.
+ <p>
+ Each time a client lease is renewed, the renewal service will ask
+ for an extension equal to the lease's renewal duration if the
+ renewal duration is:
+ <ul>
+ <li> Lease.ANY, or
+ <li> less than the remaining desired duration,
+ </ul>
+
+ otherwise, it will ask for an extension equal to the lease's
+ remaining desired duration.
+ <p>
+ If a client lease's actual expiration is later than its desired
+ expiration, the renewal service will not renew the lease; the lease
+ will remain in the set until its desired expiration is reached, the
+ set is destroyed, or it is removed by the client.
+ <p>
+ Each set is leased from the renewal service. If the lease on a set
+ expires or is cancelled, the renewal service will destroy the set
+ and take no further action with regard to the client leases in the
+ set. Each lease renewal set has associated with it an expiration
+ warning event that occurs at a client-specified time before the
+ lease on the set expires. Clients can register for warning events
+ using methods provided by the set. A registration for warning
+ events does not have its own lease, but instead is covered by the
+ same lease under which the set was granted.
+ <p>
+ The term <em>definite exception</em> is used to refer to an
+ exception that could be thrown by an operation on a client lease
+ (such as a remote method call) that would be indicative of a
+ permanent failure of the client lease. For purposes of this
+ document, all bad object exceptions, bad invocation exceptions, and
+ <code>LeaseException</code>s are considered to be definite
+ exceptions.
+ <p>
+ Each lease renewal set has associated with it a renewal failure
+ event that will occur in either of two cases: if any client lease
+ in the set reaches its actual expiration before its desired
+ expiration is reached, or if the renewal service attempts to renew
+ a client lease and gets a definite exception. Clients can register
+ for failure events using methods provided by the set. A
+ registration for failure event does not have its own lease, but
+ instead is covered by the same lease under which the set was
+ granted.
+ <p>
+ Once placed in a set, a client lease will stay there until one or
+ more of the following occurs:
+ <ul>
+ <li> The lease on the set itself expires or is cancelled,
+ causing destruction of the set
+ <li> The client lease is removed by the client
+ <li> The client lease's actual or desired expiration is reached
+ <li> A renewal attempt on the client lease results in a
+ definite exception
+ </ul>
+ <p>
+ Each client lease in a set will be renewed as long as it is in the
+ set. If a renewal call throws an indefinite exception, the renewal
+ service should retry the lease renewal until the lease would
+ otherwise be removed from the set. The renewal service will never
+ cancel a client lease. The preferred method of cancelling a client
+ lease is for the client to first remove the lease from the set and
+ then call cancel on it. It is also permissible for the client to
+ cancel the lease without first removing the lease from the set,
+ although this is likely to result in additional network traffic.
+ <p>
+ Client leases get returned to clients in a number of ways (via
+ <code>remove</code> and <code>getLeases</code> calls, as components
+ of events, etc.). In general, they should have their serial format
+ set to <code>Lease.DURATION</code> before being transferred to the
+ client's virtual machine. In some exceptional circumstances, this
+ may not be possible (for example, the client lease was recovered
+ from persistent storage and could not be deserialized in the
+ server's virtual machine). In these cases, it is acceptable to
+ transfer the lease to the client using the
+ <code>Lease.ABSOLUTE</code> serial format.
+ <p>
+ Whenever a client lease gets returned to a client, its actual
+ expiration should reflect either:
+ <ul>
+ <li> The result of the last successful renewal call that the
+ renewal service made or
+ <li> The expiration time the lease originally had when it was
+ added to the set, if the renewal service has not yet
+ successfully renewed the lease
+ </ul>
+<P>
+
+<P>
+<DL>
+<DT><B>Author:</B></DT>
+ <DD>Sun Microsystems, Inc.</DD>
+<DT><B>See Also:</B><DD><A HREF="../../../net/jini/lease/LeaseRenewalService.html" title="interface in net.jini.lease"><CODE>LeaseRenewalService</CODE></A></DL>
+<HR>
+
+<P>
+<!-- =========== FIELD SUMMARY =========== -->
+
+<A NAME="field_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Field Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static long</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseRenewalSet.html#EXPIRATION_WARNING_EVENT_ID">EXPIRATION_WARNING_EVENT_ID</A></B></CODE>
+
+<BR>
+ The event id for all <code>ExpirationWarningEvent</code> objects.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static long</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseRenewalSet.html#RENEWAL_FAILURE_EVENT_ID">RENEWAL_FAILURE_EVENT_ID</A></B></CODE>
+
+<BR>
+ The event id for all <code>RenewalFailureEvent</code> objects.</TD>
+</TR>
+</TABLE>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseRenewalSet.html#clearExpirationWarningListener()">clearExpirationWarningListener</A></B>()</CODE>
+
+<BR>
+ Remove the listener currently registered for expiration warning
+ events.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseRenewalSet.html#clearRenewalFailureListener()">clearRenewalFailureListener</A></B>()</CODE>
+
+<BR>
+ Remove the listener currently registered for renewal failure
+ events.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseRenewalSet.html#getLeases()">getLeases</A></B>()</CODE>
+
+<BR>
+ Returns all the leases currently in the set.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseRenewalSet.html#getRenewalSetLease()">getRenewalSetLease</A></B>()</CODE>
+
+<BR>
+ Returns the lease that controls the lifetime of this set.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseRenewalSet.html#remove(net.jini.core.lease.Lease)">remove</A></B>(<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A> leaseToRemove)</CODE>
+
+<BR>
+ Removes the specified lease from set.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseRenewalSet.html#renewFor(net.jini.core.lease.Lease, long)">renewFor</A></B>(<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A> leaseToRenew,
+ long desiredDuration)</CODE>
+
+<BR>
+ Include a client lease in the set for a specified duration.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseRenewalSet.html#renewFor(net.jini.core.lease.Lease, long, long)">renewFor</A></B>(<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A> leaseToRenew,
+ long desiredDuration,
+ long renewDuration)</CODE>
+
+<BR>
+ Include a client lease in the set for a specified duration and
+ with a specified renewal duration.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/event/EventRegistration.html" title="class in net.jini.core.event">EventRegistration</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseRenewalSet.html#setExpirationWarningListener(net.jini.core.event.RemoteEventListener, long, java.rmi.MarshalledObject)">setExpirationWarningListener</A></B>(<A HREF="../../../net/jini/core/event/RemoteEventListener.html" title="interface in net.jini.core.event">RemoteEventListener</A> listener,
+ long minWarning,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A> handback)</CODE>
+
+<BR>
+ Register for the expiration warning event associated with this
+ set.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/event/EventRegistration.html" title="class in net.jini.core.event">EventRegistration</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseRenewalSet.html#setRenewalFailureListener(net.jini.core.event.RemoteEventListener, java.rmi.MarshalledObject)">setRenewalFailureListener</A></B>(<A HREF="../../../net/jini/core/event/RemoteEventListener.html" title="interface in net.jini.core.event">RemoteEventListener</A> listener,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A> handback)</CODE>
+
+<BR>
+ Register for the renewal failure event associated with this set.</TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ FIELD DETAIL =========== -->
+
+<A NAME="field_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Field Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="RENEWAL_FAILURE_EVENT_ID"><!-- --></A><H3>
+RENEWAL_FAILURE_EVENT_ID</H3>
+<PRE>
+static final long <B>RENEWAL_FAILURE_EVENT_ID</B></PRE>
+<DL>
+<DD>The event id for all <code>RenewalFailureEvent</code> objects.
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../net/jini/lease/RenewalFailureEvent.html" title="class in net.jini.lease"><CODE>RenewalFailureEvent</CODE></A>,
+<A HREF="../../../constant-values.html#net.jini.lease.LeaseRenewalSet.RENEWAL_FAILURE_EVENT_ID">Constant Field Values</A></DL>
+</DL>
+<HR>
+
+<A NAME="EXPIRATION_WARNING_EVENT_ID"><!-- --></A><H3>
+EXPIRATION_WARNING_EVENT_ID</H3>
+<PRE>
+static final long <B>EXPIRATION_WARNING_EVENT_ID</B></PRE>
+<DL>
+<DD>The event id for all <code>ExpirationWarningEvent</code> objects.
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../net/jini/lease/ExpirationWarningEvent.html" title="class in net.jini.lease"><CODE>ExpirationWarningEvent</CODE></A>,
+<A HREF="../../../constant-values.html#net.jini.lease.LeaseRenewalSet.EXPIRATION_WARNING_EVENT_ID">Constant Field Values</A></DL>
+</DL>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="renewFor(net.jini.core.lease.Lease, long, long)"><!-- --></A><H3>
+renewFor</H3>
+<PRE>
+void <B>renewFor</B>(<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A> leaseToRenew,
+ long desiredDuration,
+ long renewDuration)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Include a client lease in the set for a specified duration and
+ with a specified renewal duration.
+ <p>
+ The <code>leaseToRenew</code> argument specifies the lease to be
+ added to the set. An <code>IllegalArgumentException</code> must
+ be thrown if the lease was granted by the renewal service
+ itself. If <code>leaseToRenew</code> is <code>null</code>, a
+ <code>NullPointerException</code> must be thrown.
+ <p>
+ The <code>desiredDuration</code> argument is the number of
+ milliseconds the client would like the lease to remain in the
+ set. It is used to calculate the lease's initial desired
+ expiration by adding <code>desiredDuration</code> to the current
+ time (as viewed by the service). If this causes an overflow, a
+ desired expiration of <code>Long.MAX_VALUE</code> will be
+ used. Unlike a lease duration, the desired duration is
+ unilaterally specified by the client, not negotiated between the
+ client and the service. Note, a negative value for
+ <code>desiredDuration</code> (including <code>Lease.ANY</code>)
+ will result in a desired expiration that is in the past, causing
+ <code>leaseToRenew</code> to be dropped from the set; this action
+ will neither result in an exception or an event.
+ <p>
+ If the actual expiration time of <code>leaseToRenew</code> is
+ less than the current time (as viewed by the renewal service) and
+ the current time is less than the desired expiration time for
+ <code>leaseToRenew</code>, the method will return
+ normally. However, <code>leaseToRenew</code> will be dropped from
+ the set and a renewal failure event will be generated.
+ <p>
+ The <code>renewDuration</code> is the initial renewal duration to
+ associate with <code>leaseToRenew</code> (in milliseconds). If
+ <code>desiredDuration</code> is exactly
+ <code>Long.MAX_VALUE</code>, the <code>renewDuration</code> may
+ be any positive number or <code>Lease.ANY</code>; otherwise it
+ must be a positive number. If these requirements are not met, the
+ renewal service must throw an
+ <code>IllegalArgumentException</code>.
+ <p>
+ Calling this method with a lease that is equivalent to a client
+ lease already in the set will associate the existing client lease
+ in the set with the new desired duration and renew duration. The
+ client lease is not replaced because it is more likely that the
+ renewal service, rather than the client, has an up-to-date lease
+ expiration. The service is more likely to have an up-to-date
+ expiration because the client should not be renewing a lease that
+ it has passed to a lease renewal service unless the lease is
+ removed first. These semantics also allow <code>renewFor</code>
+ to be used in an idempotent fashion.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>leaseToRenew</CODE> - the lease to be added to the renewal set<DD><CODE>desiredDuration</CODE> - the maximum length of time in milliseconds
+ the <code>leaseToRenew</code> should remain in the set, or
+ <code>Lease.FOREVER</code> which implies there is no
+ pre-specified time when the lease should be removed from
+ the set<DD><CODE>renewDuration</CODE> - the lease duration to request when renewing
+ the lease, unless <code>renewDuration</code> is greater
+ than the remainder of the <code>desiredDuration</code>
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if <code>desiredDuration</code>
+ is <code>Lease.FOREVER</code>, <code>renewDuration</code>
+ is not a positive value, <code>Lease.FOREVER</code>, or
+ <code>Lease.ANY</code>. If <code>desiredDuration</code>
+ is not <code>Lease.FOREVER</code>,
+ <code>IllegalArgumentException</code> will be thrown if
+ <code>renewDuration</code> is not a positive value or
+ <code>Lease.ANY</code>. <code>IllegalArgumentException</code>
+ will also be thrown if <code>leaseToRenew</code>
+ was granted by this renewal service.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - if <code>leaseToRenew</code> is
+ <code>null</code>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception
+ occurs</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="renewFor(net.jini.core.lease.Lease, long)"><!-- --></A><H3>
+renewFor</H3>
+<PRE>
+void <B>renewFor</B>(<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A> leaseToRenew,
+ long desiredDuration)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Include a client lease in the set for a specified duration.
+ <p>
+ Calling this method is equivalent to making the following call
+ on this set:
+
+ <pre>
+ renewFor(leaseToRenew, desiredDuration, Lease.FOREVER)
+ </pre>
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>leaseToRenew</CODE> - the lease to be added to the renewal set<DD><CODE>desiredDuration</CODE> - the maximum length of time in milliseconds
+ the <code>leaseToRenew</code> should remain in the set, or
+ <code>Lease.FOREVER</code> which implies there is no
+ pre-specified time when the lease should be removed from
+ the set
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if <code>leaseToRenew</code>
+ was granted by this renewal service
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - if <code>leaseToRenew</code> is
+ <code>null</code>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception
+ occurs</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="remove(net.jini.core.lease.Lease)"><!-- --></A><H3>
+remove</H3>
+<PRE>
+<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A> <B>remove</B>(<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A> leaseToRemove)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Removes the specified lease from set. If the lease is currently
+ in the set it will be returned, otherwise <code>null</code> will
+ be returned. <code>leaseToRemove</code> will not be
+ canceled by this call.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>leaseToRemove</CODE> - lease to be removed from the set
+<DT><B>Returns:</B><DD>the removed lease if it was in the set or
+ <code>null</code> if it was not
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - if <code>leaseToRemove</code> is
+ <code>null</code>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception
+ occurs</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getLeases()"><!-- --></A><H3>
+getLeases</H3>
+<PRE>
+<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A>[] <B>getLeases</B>()
+ throws <A HREF="../../../net/jini/lease/LeaseUnmarshalException.html" title="class in net.jini.lease">LeaseUnmarshalException</A>,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Returns all the leases currently in the set.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the leases in the set. Return a zero length array if
+ there are not leases currently in the set.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../net/jini/lease/LeaseUnmarshalException.html" title="class in net.jini.lease">LeaseUnmarshalException</A></CODE> - if one or more of the leases can
+ not be unmarshalled. The throwing of a
+ <code>LeaseUnmarshalException</code> represents a,
+ possibly transient, failure in the ability to unmarshal
+ one or more client leases in the set, it does not
+ necessarily imply anything about the state of the renewal
+ service or the set themselves.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception
+ occurs</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="setExpirationWarningListener(net.jini.core.event.RemoteEventListener, long, java.rmi.MarshalledObject)"><!-- --></A><H3>
+setExpirationWarningListener</H3>
+<PRE>
+<A HREF="../../../net/jini/core/event/EventRegistration.html" title="class in net.jini.core.event">EventRegistration</A> <B>setExpirationWarningListener</B>(<A HREF="../../../net/jini/core/event/RemoteEventListener.html" title="interface in net.jini.core.event">RemoteEventListener</A> listener,
+ long minWarning,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A> handback)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Register for the expiration warning event associated with this
+ set.
+ <p>
+ This method allows the client to register for notification of
+ the approaching expiration of the set's lease. The
+ <code>listener</code> argument specifies what listener should
+ be notified when the lease is about to expire. The
+ <code>minWarning</code> argument specifies a minimum number of
+ milliseconds before lease expiration that the first event
+ delivery attempt should be made by the service. The service may
+ also make subsequent delivery attempts if the first and any
+ subsequent attempts have been indeterminate. The
+ <code>minWarning</code> argument must be zero or a positive
+ number; if it is not, an <code>IllegalArgumentException</code>
+ must be thrown. If the current expiration of the set's lease is
+ less than <code>minWarning</code> milliseconds away, the event
+ will occur immediately (though it will take time to propagate
+ to the listener).
+ <p>
+ The <code>handback</code> argument to this method specifies an
+ object that will be part of the expiration warning event
+ notification. This mechanism is detailed in the Jini
+ Distributed Event Specification.
+ <p>
+ This method returns the event registration for this event. The
+ <code>Lease</code> object associated with the registration will
+ be equivalent (in the sense of <code>equals</code>) to the
+ <code>Lease</code> on the renewal set. Because the event
+ registration shares a lease with the set, clients that want to
+ just remove their expiration warning registration without
+ destroying the set should use the
+ <code>clearExpirationWarningListener</code> method instead of
+ cancelling the registration's lease. The registration's event
+ ID will be
+ <code>LeaseRenewalSet.EXPIRATION_WARNING_EVENT_ID</code>. The
+ source of the registration will be the set. The method must
+ throw a <code>NullPointerException</code> if the
+ <code>listener</code> argument is <code>null</code>. If an
+ event handler has already been specified for this event the
+ current registration is replaced with the new one. Because both
+ registrations are for the same kind of event, the events sent
+ to the new registration must be in the same sequence as the
+ events sent to the old registration.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>listener</CODE> - the listener to be notified when this event
+ occurs<DD><CODE>minWarning</CODE> - how long before the lease on the set expires
+ should the event be sent<DD><CODE>handback</CODE> - an object to be handed back to the listener when
+ the warning event occurs
+<DT><B>Returns:</B><DD>an <code>EventRegistration</code> describing the event
+ registration
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if <code>minWarning</code> is
+ negative
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - if <code>listener</code> is
+ <code>null</code>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception
+ occurs</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="clearExpirationWarningListener()"><!-- --></A><H3>
+clearExpirationWarningListener</H3>
+<PRE>
+void <B>clearExpirationWarningListener</B>()
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Remove the listener currently registered for expiration warning
+ events. It is safe to call this method even if no listener is
+ currently registered.
+<P>
+<DD><DL>
+
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception
+ occurs</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="setRenewalFailureListener(net.jini.core.event.RemoteEventListener, java.rmi.MarshalledObject)"><!-- --></A><H3>
+setRenewalFailureListener</H3>
+<PRE>
+<A HREF="../../../net/jini/core/event/EventRegistration.html" title="class in net.jini.core.event">EventRegistration</A> <B>setRenewalFailureListener</B>(<A HREF="../../../net/jini/core/event/RemoteEventListener.html" title="interface in net.jini.core.event">RemoteEventListener</A> listener,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A> handback)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Register for the renewal failure event associated with this set.
+ <p>
+ This method allows the client to register for the event
+ associated with the failure to renew a client lease in the
+ set. These events are generated when a client lease expires
+ while it is still in the set, or when the service attempts to
+ renew a client lease and gets a definite exception. The
+ listener argument specifies the listener to be notified if a
+ client lease could not be renewed.
+ <p>
+ The <code>handback</code> argument specifies an object that
+ will be part of the renewal failure event notification. This
+ mechanism is detailed in the Jini Distributed Event
+ Specification.
+ <p>
+ This method returns the event registration for this event. The
+ <code>Lease</code> object associated with the registration will
+ be equivalent (in the sense of <code>equals</code>) to the
+ <code>Lease</code> on the renewal set. Because the event
+ registration shares a lease with the set, clients that want to
+ just remove their expiration warning registration without
+ destroying the set should use the
+ <code>clearRenewalFailureListener</code> method, instead of
+ cancelling the registration's lease. The registration's event
+ ID will be
+ <code>LeaseRenewalSet.RENEWAL_FAILURE_EVENT_ID</code>. The
+ source of the registration will be the set. The method must
+ throw <code>NullPointerException</code> if the
+ <code>listener</code> argument is <code>null</code>. If an
+ event handler has already been specified for this event the
+ current registration is replaced with the new one. The returned
+ event registration must have the same event ID as the replaced
+ registration. Because both registrations are for the same kind
+ of event, the events sent to the new registration must be in
+ the same sequence as the events sent to the old registration.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>listener</CODE> - the listener to be notified when this event
+ occurs<DD><CODE>handback</CODE> - an object to be handed back to the listener when
+ the warning event occurs
+<DT><B>Returns:</B><DD>an <code>EventRegistration</code> describing the event
+ registration
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - if <code>listener</code> is
+ <code>null</code>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception
+ occurs</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="clearRenewalFailureListener()"><!-- --></A><H3>
+clearRenewalFailureListener</H3>
+<PRE>
+void <B>clearRenewalFailureListener</B>()
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Remove the listener currently registered for renewal failure
+ events. It is safe to call this method even if no listener is
+ currently registered.
+<P>
+<DD><DL>
+
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception
+ occurs</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getRenewalSetLease()"><!-- --></A><H3>
+getRenewalSetLease</H3>
+<PRE>
+<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A> <B>getRenewalSetLease</B>()</PRE>
+<DL>
+<DD>Returns the lease that controls the lifetime of this set. Can
+ be used to extend or end the sets lifetime. Note that this method
+ does not make a remote call.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the lease that controls the lifetime of this set</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/LeaseRenewalSet.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../net/jini/lease/LeaseRenewalService.html" title="interface in net.jini.lease"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/lease/LeaseUnmarshalException.html" title="class in net.jini.lease"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/lease/LeaseRenewalSet.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LeaseRenewalSet.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright 2007, multiple authors.<br>Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="child" >Apache License, Version 2.0</a>, see the <a href="../../../doc-files/NOTICE" target="child" >NOTICE</a> file for attributions.
+</BODY>
+</HTML>
Added: websites/staging/river/trunk/content/river/doc/api/net/jini/lease/LeaseUnmarshalException.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/net/jini/lease/LeaseUnmarshalException.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/net/jini/lease/LeaseUnmarshalException.html Fri Dec 24 20:24:29 2010
@@ -0,0 +1,473 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Mon Mar 08 17:46:21 EST 2010 -->
+<TITLE>
+LeaseUnmarshalException (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.lease.LeaseUnmarshalException class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="LeaseUnmarshalException (Apache River v2.1.2-SNAPSHOT API Documentation)";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/LeaseUnmarshalException.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../net/jini/lease/LeaseRenewalSet.html" title="interface in net.jini.lease"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/lease/RenewalFailureEvent.html" title="class in net.jini.lease"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/lease/LeaseUnmarshalException.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LeaseUnmarshalException.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+net.jini.lease</FONT>
+<BR>
+Class LeaseUnmarshalException</H2>
+<PRE>
+<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">java.lang.Object</A>
+ <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">java.lang.Throwable</A>
+ <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Exception.html" title="class or interface in java.lang">java.lang.Exception</A>
+ <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>net.jini.lease.LeaseUnmarshalException</B>
+</PRE>
+<DL>
+<DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/Serializable.html" title="class or interface in java.io">Serializable</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public class <B>LeaseUnmarshalException</B><DT>extends <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></DL>
+</PRE>
+
+<P>
+Exception thrown when a lease renewal set can't unmarshal one or more
+ leases being returned by a <code>getLeases</code> call.
+ <p>
+ When unmarshalling an instance of <code>MarshalledObject</code>, one
+ of the following checked exceptions is possible: an
+ <code>IOException</code> can occur while deserializing the object
+ from its internal representation; and a
+ <code>ClassNotFoundException</code> can occur if, while deserializing
+ the object from its internal representation, either the class file of
+ the object cannot be found, or the class file of either an interface
+ or a class referenced by the object being deserialized cannot be
+ found. Typically, a <code>ClassNotFoundException</code> occurs when
+ the codebase from which to retrieve the needed class file is not
+ currently available.
+ <p>
+ This class provides a mechanism that clients of the lease renewal
+ service may use for efficient handling of the exceptions that may
+ occur when unmarshalling elements of a set of marshalled
+ <code>Lease</code> objects. When elements in such a set are
+ unmarshalled, the <code>LeaseUnmarshalException</code> class may be
+ used to collect and report pertinent information generated when
+ failure occurs while unmarshalling the elements of the set.
+ <p>
+ The information that may be of interest to entities that receive this
+ exception class is contained in the following fields: a set of
+ <code>Lease</code> objects in which each element is the result of a
+ successful unmarshalling attempt, a set of marshalled
+ <code>Lease</code> objects in which each element could not be
+ successfully unmarshalled, and a set of exceptions
+ (<code>IOException</code>, <code>ClassNotFoundException</code>, or
+ some unchecked exception) in which each element corresponds to one of
+ the unmarshalling failures.
+ <p>
+ Thus, when exceptional conditions occur while unmarshalling a set of
+ marshalled <code>Lease</code> objects, this class can be used not
+ only to indicate that an exceptional condition has occurred, but also
+ to provide information that can be used to perform error handling
+ activities such as: determining if it is feasible to continue with
+ processing, reporting errors, attempting recovery, and debugging.
+ <p>
+ Note that this exception class should be used only to report
+ exceptional conditions occurring when unmarshalling a set of
+ marshalled <code>Lease</code> objects.
+<P>
+
+<P>
+<DL>
+<DT><B>Author:</B></DT>
+ <DD>Sun Microsystems, Inc.</DD>
+<DT><B>See Also:</B><DD><A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease"><CODE>Lease</CODE></A>,
+<A HREF="../../../serialized-form.html#net.jini.lease.LeaseUnmarshalException">Serialized Form</A></DL>
+<HR>
+
+<P>
+
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+
+<A NAME="constructor_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Constructor Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseUnmarshalException.html#LeaseUnmarshalException(net.jini.core.lease.Lease[], java.rmi.MarshalledObject[], java.lang.Throwable[])">LeaseUnmarshalException</A></B>(<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A>[] leases,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A>[] marshalledLeases,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A>[] exceptions)</CODE>
+
+<BR>
+ Constructs a new instance of <code>LeaseUnmarshalException</code>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseUnmarshalException.html#LeaseUnmarshalException(java.lang.String, net.jini.core.lease.Lease[], java.rmi.MarshalledObject[], java.lang.Throwable[])">LeaseUnmarshalException</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> message,
+ <A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A>[] leases,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A>[] marshalledLeases,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A>[] exceptions)</CODE>
+
+<BR>
+ Constructs a new instance of <code>LeaseUnmarshalException</code>
+ with a specified message.</TD>
+</TR>
+</TABLE>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseUnmarshalException.html#getExceptions()">getExceptions</A></B>()</CODE>
+
+<BR>
+ Accessor method that returns an array consisting of instances of
+ <code>Throwable</code>, where each element of the array
+ corresponds to one of the exceptions that occurred during the
+ unmarshalling process.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseUnmarshalException.html#getLeases()">getLeases</A></B>()</CODE>
+
+<BR>
+ Accessor method that returns an array consisting of instances of
+ <code>Lease</code>, where each element of the array corresponds
+ to a successfully unmarshalled object.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/lease/LeaseUnmarshalException.html#getMarshalledLeases()">getMarshalledLeases</A></B>()</CODE>
+
+<BR>
+ Accessor method that returns an array consisting of instances of
+ <code>MarshalledObject</code>, where each element of the array is
+ a marshalled instance of the <code>Lease</code> interface, and
+ corresponds to an object that could not be successfully
+ unmarshalled.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Throwable"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#fillInStackTrace()" title="class or interface in java.lang">fillInStackTrace</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#getCause()" title="class or interface in java.lang">getCause</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#getLocalizedMessage()" title="class or interface in java.lang">getLocalizedMessage</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#getMessage()" title="class or interface in java.lang">getMessage</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#getStackTrace()" title="class or interface in java.lang">getStackTrace</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#initCause(java.lang.Throwable)" title="class or interface in java.lang">initCause</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwab
le.html#printStackTrace()" title="class or interface in java.lang">printStackTrace</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#printStackTrace(java.io.PrintStream)" title="class or interface in java.lang">printStackTrace</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#printStackTrace(java.io.PrintWriter)" title="class or interface in java.lang">printStackTrace</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#setStackTrace(java.lang.StackTraceElement[])" title="class or interface in java.lang">setStackTrace</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#toString()" title="class or interface in java.lang">toString</A></CODE></TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://
java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+
+<A NAME="constructor_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Constructor Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="LeaseUnmarshalException(java.lang.String, net.jini.core.lease.Lease[], java.rmi.MarshalledObject[], java.lang.Throwable[])"><!-- --></A><H3>
+LeaseUnmarshalException</H3>
+<PRE>
+public <B>LeaseUnmarshalException</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> message,
+ <A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A>[] leases,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A>[] marshalledLeases,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A>[] exceptions)</PRE>
+<DL>
+<DD>Constructs a new instance of <code>LeaseUnmarshalException</code>
+ with a specified message.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>leases</CODE> - array containing the set of instances of
+ <code>Lease</code> that were successfully unmarshalled<DD><CODE>marshalledLeases</CODE> - array containing the set of marshalled
+ <code>Lease</code> instances that could not be
+ unmarshalled<DD><CODE>exceptions</CODE> - array containing the set of exceptions that
+ occurred during the unmarshalling process. Each element in
+ this set should be an instance of
+ <code>IOException</code>,
+ <code>ClassNotFoundException</code>, or some unchecked
+ exception. Furthermore, there should be a one-to-one
+ correspondence between each element in this set and each
+ element in the <code>marshalledLeases</code> argument.
+ <p>
+ That is, the element of this set corresponding to index i
+ should be an instance of the exception that occurred while
+ attempting to unmarshal the element at index i of the
+ <code>marshalledLeases</code> argument.<DD><CODE>message</CODE> - the detail message
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - when the number of elements in
+ the <code>exceptions</code> argument is not equal to the
+ number of elements in the <code>marshalledLeases</code>
+ argument</DL>
+</DL>
+<HR>
+
+<A NAME="LeaseUnmarshalException(net.jini.core.lease.Lease[], java.rmi.MarshalledObject[], java.lang.Throwable[])"><!-- --></A><H3>
+LeaseUnmarshalException</H3>
+<PRE>
+public <B>LeaseUnmarshalException</B>(<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A>[] leases,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A>[] marshalledLeases,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A>[] exceptions)</PRE>
+<DL>
+<DD>Constructs a new instance of <code>LeaseUnmarshalException</code>.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>leases</CODE> - array containing the set of instances of
+ <code>Lease</code> that were successfully unmarshalled<DD><CODE>marshalledLeases</CODE> - array containing the set of marshalled
+ <code>Lease</code> instances that could not be
+ unmarshalled<DD><CODE>exceptions</CODE> - array containing the set of exceptions that
+ occurred during the unmarshalling process. Each element in
+ this set should be an instance of
+ <code>IOException</code>,
+ <code>ClassNotFoundException</code>, or some unchecked
+ exception. Furthermore, there should be a one-to-one
+ correspondence between each element in this set and each
+ element in the <code>marshalledLeases</code> argument.
+ <p>
+ That is, the element of this set corresponding to index i
+ should be an instance of the exception that occurred while
+ attempting to unmarshal the element at index i of the
+ <code>marshalledLeases</code> argument.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - when the number of elements in
+ the <code>exceptions</code> argument is not equal to the
+ number of elements in the <code>marshalledLeases</code>
+ argument</DL>
+</DL>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="getLeases()"><!-- --></A><H3>
+getLeases</H3>
+<PRE>
+public <A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A>[] <B>getLeases</B>()</PRE>
+<DL>
+<DD>Accessor method that returns an array consisting of instances of
+ <code>Lease</code>, where each element of the array corresponds
+ to a successfully unmarshalled object. Note that the same array
+ is returned on each invocation of this method; that is, a copy is
+ not made.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>array of instances of <code>Lease</code>, where each
+ element corresponds to a successfully unmarshalled object</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getMarshalledLeases()"><!-- --></A><H3>
+getMarshalledLeases</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A>[] <B>getMarshalledLeases</B>()</PRE>
+<DL>
+<DD>Accessor method that returns an array consisting of instances of
+ <code>MarshalledObject</code>, where each element of the array is
+ a marshalled instance of the <code>Lease</code> interface, and
+ corresponds to an object that could not be successfully
+ unmarshalled. Note that the same array is returned on each
+ invocation of this method; that is, a copy is not made.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>array of marshalled instances of <code>Lease</code>,
+ where each element corresponds to an object in which
+ failure occurred while attempting to unmarshal the object</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getExceptions()"><!-- --></A><H3>
+getExceptions</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A>[] <B>getExceptions</B>()</PRE>
+<DL>
+<DD>Accessor method that returns an array consisting of instances of
+ <code>Throwable</code>, where each element of the array
+ corresponds to one of the exceptions that occurred during the
+ unmarshalling process. Note that the same array is returned on
+ each invocation of this method; that is, a copy is not made.
+ <p>
+ Each element in the return set should be an instance of
+ <code>IOException</code>, <code>ClassNotFoundException</code>, or
+ some unchecked exception. Additionally, there should be a
+ one-to-one correspondence between each element in the array
+ returned by this method and the array returned by the
+ <code>getMarshalledLeases</code> method. That is, the i-th
+ element of the set returned by this method should be an instance
+ of the exception that occurred while attempting to unmarshal the
+ i-th element of the set returned by the
+ <code>getMarshalledLeases</code> method.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>array of instances of <code>Throwable</code>, where each
+ element corresponds to one of the exceptions that
+ occurred during the unmarshalling process</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/LeaseUnmarshalException.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../net/jini/lease/LeaseRenewalSet.html" title="interface in net.jini.lease"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/lease/RenewalFailureEvent.html" title="class in net.jini.lease"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/lease/LeaseUnmarshalException.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LeaseUnmarshalException.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright 2007, multiple authors.<br>Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="child" >Apache License, Version 2.0</a>, see the <a href="../../../doc-files/NOTICE" target="child" >NOTICE</a> file for attributions.
+</BODY>
+</HTML>