You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@river.apache.org by si...@apache.org on 2010/12/24 21:35:19 UTC
svn commit: r1052599 [2/3] - in
/incubator/river/site/trunk/content/river/doc/api/net/jini/space: ./
class-use/
Added: incubator/river/site/trunk/content/river/doc/api/net/jini/space/JavaSpace05.html
URL: http://svn.apache.org/viewvc/incubator/river/site/trunk/content/river/doc/api/net/jini/space/JavaSpace05.html?rev=1052599&view=auto
==============================================================================
--- incubator/river/site/trunk/content/river/doc/api/net/jini/space/JavaSpace05.html (added)
+++ incubator/river/site/trunk/content/river/doc/api/net/jini/space/JavaSpace05.html Fri Dec 24 20:35:19 2010
@@ -0,0 +1,778 @@
+<!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:25 EST 2010 -->
+<TITLE>
+JavaSpace05 (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.space.JavaSpace05 interface">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="JavaSpace05 (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/JavaSpace05.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/space/JavaSpace.html" title="interface in net.jini.space"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/space/MatchSet.html" title="interface in net.jini.space"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/space/JavaSpace05.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="JavaSpace05.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 | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | 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.space</FONT>
+<BR>
+Interface JavaSpace05</H2>
+<DL>
+<DT><B>All Superinterfaces:</B> <DD><A HREF="../../../net/jini/space/JavaSpace.html" title="interface in net.jini.space">JavaSpace</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public interface <B>JavaSpace05</B><DT>extends <A HREF="../../../net/jini/space/JavaSpace.html" title="interface in net.jini.space">JavaSpace</A></DL>
+</PRE>
+
+<P>
+The <code>JavaSpace05</code> interface extends the <A HREF="../../../net/jini/space/JavaSpace.html" title="interface in net.jini.space"><CODE>JavaSpace</CODE></A> interface to provide methods that allow clients to
+ perform batch operations on the space (which are generally more
+ efficient than performing an equivalent set of singleton
+ operations) and to more easily develop applications where a
+ given <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> needs to be read by multiple clients.
+ Implementations of the <code>JavaSpace</code> interface are not
+ required to implement this interface.<p>
+
+ Unless otherwise noted, the effects of any invocation of a
+ method defined by this interface must be visible to any
+ operation on the space that is started after the invocation
+ returns normally. Note, the effects of a method invocation that
+ throws a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi"><CODE>RemoteException</CODE></A> are not necessarily visible
+ when the exception is thrown. <p>
+
+ All of the methods of this interface take one or more <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util"><CODE>Collection</CODE></A>s as arguments. Each such <code>Collection</code>
+ must be treated as immutable by implementations and must not be
+ changed by the client during the course of any method
+ invocation to which they have been passed.<p>
+
+ This interface is not a remote interface. Each implementation of
+ this interface exports a proxy object that implements this
+ interface local to the client. Each method of the interface
+ takes as one of its arguments a <code>Collection</code> of
+ <code>Entry</code> instances. The entries themselves must be
+ serialized in accordance with the <a
+ href=http://www.jini.org/standards/index.html>Jini Entry
+ Specification</a> and will not be altered by the
+ call. Typically, the <code>Collection</code> holding the entries
+ will not be serialized at all. If one of these entries can't be
+ serialized, a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalException.html" title="class or interface in java.rmi"><CODE>MarshalException</CODE></A> will be thrown. Aside
+ from the handling of these <code>Collection</code> of
+ <code>Entry</code> parameters, all methods defined by this
+ interface otherwise obey normal Java(TM) Remote Method
+ Invocation remote interface semantics.
+<P>
+
+<P>
+<DL>
+<DT><B>Since:</B></DT>
+ <DD>2.1</DD>
+<DT><B>See Also:</B><DD><a href=http://www.jini.org/standards/index.html>
+ JavaSpaces Service Specification</a>,
+<a href=http://www.jini.org/standards/index.html>
+ Jini Entry Specification</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>
+</TABLE>
+ <A NAME="fields_inherited_from_class_net.jini.space.JavaSpace"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Fields inherited from interface net.jini.space.<A HREF="../../../net/jini/space/JavaSpace.html" title="interface in net.jini.space">JavaSpace</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="../../../net/jini/space/JavaSpace.html#NO_WAIT">NO_WAIT</A></CODE></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="../../../net/jini/space/MatchSet.html" title="interface in net.jini.space">MatchSet</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/space/JavaSpace05.html#contents(java.util.Collection, net.jini.core.transaction.Transaction, long, long)">contents</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A> tmpls,
+ <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A> txn,
+ long leaseDuration,
+ long maxEntries)</CODE>
+
+<BR>
+ Creates a <A HREF="../../../net/jini/space/MatchSet.html" title="interface in net.jini.space">match set</A> that can be used to
+ exhaustively read through all of the matching entries in
+ the space that are visible to the passed <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction"><CODE>Transaction</CODE></A> and remain visible for the lifetime of the
+ match 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/space/JavaSpace05.html#registerForAvailabilityEvent(java.util.Collection, net.jini.core.transaction.Transaction, boolean, net.jini.core.event.RemoteEventListener, long, java.rmi.MarshalledObject)">registerForAvailabilityEvent</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A> tmpls,
+ <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A> txn,
+ boolean visibilityOnly,
+ <A HREF="../../../net/jini/core/event/RemoteEventListener.html" title="interface in net.jini.core.event">RemoteEventListener</A> listener,
+ long leaseDuration,
+ <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 events triggered when a matching <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A>
+ transitions from unavailable to available.</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/util/Collection.html" title="class or interface in java.util">Collection</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/space/JavaSpace05.html#take(java.util.Collection, net.jini.core.transaction.Transaction, long, long)">take</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A> tmpls,
+ <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A> txn,
+ long timeout,
+ long maxEntries)</CODE>
+
+<BR>
+ This method provides an overload of the <A HREF="../../../net/jini/space/JavaSpace.html#take(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>JavaSpace.take</CODE></A> method that attempts to
+ remove, optionally under a <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction"><CODE>Transaction</CODE></A>, and return
+ one or more entries from the space.</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/util/List.html" title="class or interface in java.util">List</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/space/JavaSpace05.html#write(java.util.List, net.jini.core.transaction.Transaction, java.util.List)">write</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/List.html" title="class or interface in java.util">List</A> entries,
+ <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A> txn,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/List.html" title="class or interface in java.util">List</A> leaseDurations)</CODE>
+
+<BR>
+ This method provides an overload of the <A HREF="../../../net/jini/space/JavaSpace.html#write(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>JavaSpace.write</CODE></A> method that allows new
+ copies of multiple <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> instances to be stored in
+ the space using a single call.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_net.jini.space.JavaSpace"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from interface net.jini.space.<A HREF="../../../net/jini/space/JavaSpace.html" title="interface in net.jini.space">JavaSpace</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="../../../net/jini/space/JavaSpace.html#notify(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, net.jini.core.event.RemoteEventListener, long, java.rmi.MarshalledObject)">notify</A>, <A HREF="../../../net/jini/space/JavaSpace.html#read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)">read</A>, <A HREF="../../../net/jini/space/JavaSpace.html#readIfExists(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)">readIfExists</A>, <A HREF="../../../net/jini/space/JavaSpace.html#snapshot(net.jini.core.entry.Entry)">snapshot</A>, <A HREF="../../../net/jini/space/JavaSpace.html#take(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)">take</A>, <A HREF="../../../net/jini/space/JavaSpace.html#takeIfExists(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)">takeIfExists</A>, <A HREF="../../../net/jini/space/JavaSpace.html#write(net.jini.core.entry.Entry, net.jini.core.t
ransaction.Transaction, long)">write</A></CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ 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="write(java.util.List, net.jini.core.transaction.Transaction, java.util.List)"><!-- --></A><H3>
+write</H3>
+<PRE>
+<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/List.html" title="class or interface in java.util">List</A> <B>write</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/List.html" title="class or interface in java.util">List</A> entries,
+ <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A> txn,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/List.html" title="class or interface in java.util">List</A> leaseDurations)
+ throws <A HREF="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction">TransactionException</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>This method provides an overload of the <A HREF="../../../net/jini/space/JavaSpace.html#write(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>JavaSpace.write</CODE></A> method that allows new
+ copies of multiple <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> instances to be stored in
+ the space using a single call. The client may specify a
+ <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction"><CODE>Transaction</CODE></A> for the operation to be performed
+ under. Each <code>Entry</code> to be stored in the space
+ has a separate requested initial lease duration. <p>
+
+ The effect on the space of an invocation of this method
+ successfully storing an <code>Entry</code> is the same as if
+ the <code>Entry</code> had been successfully stored by a
+ call to the singleton form of <code>write</code> under
+ <code>txn</code> with the given requested initial lease
+ duration. This method returns the proxies to the leases for
+ each newly stored <code>Entry</code> by returning a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/List.html" title="class or interface in java.util"><CODE>List</CODE></A> of <A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease"><CODE>Lease</CODE></A> instances. The <em>i</em> th element
+ of the returned <code>List</code> will be a proxy for the
+ lease on the <code>Entry</code> created from the <em>i</em>
+ th element of <code>entries</code>. <p>
+
+ If an invocation of this method returns normally, then a new
+ copy of each element of <code>entries</code> must have been
+ stored in the space. A new copy of each element will be
+ stored even if there are duplicates (either in terms of
+ object identity or of entry equivalence) in
+ <code>entries</code>. <p>
+
+ The order in which the entries stored by an invocation of
+ this method will become visible in the space is unspecified,
+ and different observers may see the entries become visible
+ in different orders.<p>
+
+ If a <A HREF="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction"><CODE>TransactionException</CODE></A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang"><CODE>SecurityException</CODE></A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang"><CODE>IllegalArgumentException</CODE></A>, or
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang"><CODE>NullPointerException</CODE></A> is thrown, no entries will
+ have been added to the space by this operation. If a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi"><CODE>RemoteException</CODE></A> is thrown, either new copies of all of the
+ elements of <code>entries</code> will have been stored or
+ no entries will have been stored; that is, in the case of a
+ <code>RemoteException</code>, the storing of new entries in
+ the space will either fail or succeed as a unit. <p>
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>entries</CODE> - a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/List.html" title="class or interface in java.util"><CODE>List</CODE></A> of <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> instances to
+ be written to the space<DD><CODE>txn</CODE> - the <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction"><CODE>Transaction</CODE></A> this operation should be
+ performed under, may be <code>null</code><DD><CODE>leaseDurations</CODE> - a <code>List</code> of
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Long.html" title="class or interface in java.lang"><CODE>Long</CODE></A>s representing the
+ requested initial lease durations
+<DT><B>Returns:</B><DD>a <code>List</code> of <A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease"><CODE>Lease</CODE></A> instances, one
+ for each element of <code>entries</code>, may be
+ immutable. The space will not keep a reference to
+ the result
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction">TransactionException</A></CODE> - if <code>txn</code> is
+ non-<code>null</code> and is not usable by the
+ space
+<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 error occurs
+<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>entries</code> and
+ <code>leaseDurations</code> are not the same length
+ or are empty, if any element of <code>entries</code>
+ is not an instance of <code>Entry</code>, if any
+ element of <code>leaseDurations</code> is not an
+ instance of <code>Long</code>, or if any element of
+ <code>leaseDurations</code> is a negative value
+ other than <A HREF="../../../net/jini/core/lease/Lease.html#ANY"><CODE>Lease.ANY</CODE></A>
+<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 either <code>entries</code>
+ or <code>leaseDurations</code> is <code>null</code>
+ or contains a <code>null</code> value</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="take(java.util.Collection, net.jini.core.transaction.Transaction, long, long)"><!-- --></A><H3>
+take</H3>
+<PRE>
+<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A> <B>take</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A> tmpls,
+ <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A> txn,
+ long timeout,
+ long maxEntries)
+ throws <A HREF="../../../net/jini/entry/UnusableEntriesException.html" title="class in net.jini.entry">UnusableEntriesException</A>,
+ <A HREF="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction">TransactionException</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>This method provides an overload of the <A HREF="../../../net/jini/space/JavaSpace.html#take(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>JavaSpace.take</CODE></A> method that attempts to
+ remove, optionally under a <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction"><CODE>Transaction</CODE></A>, and return
+ one or more entries from the space. Each <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A>
+ taken will match one or more elements of the passed <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util"><CODE>Collection</CODE></A> of templates, and all of the taken entries will
+ be visible to the passed <code>Transaction</code>. If there
+ are initially no matches in the space that are visible to
+ the passed <code>Transaction</code>, an invocation of this
+ method will block for up to a specified timeout for one or
+ more matches to appear. <p>
+
+ The effect on the space of an invocation of this method
+ successfully taking an <code>Entry</code> will be the same
+ as if the <code>Entry</code> had been taken using the
+ singleton version of this method and passing
+ <code>txn</code> as the <code>Transaction</code>. <p>
+
+ The <code>tmpls</code> parameter must be a
+ <code>Collection</code> of <code>Entry</code> instances to
+ be used as templates. All of the entries taken must match
+ one or more of these templates. The <code>tmpls</code>
+ parameter may contain <code>null</code> values and may
+ contain duplicates. An <code>Entry</code> is said to be
+ <em>available</em> to an invocation of this method if the
+ <code>Entry</code> could have been returned by an
+ invocation of the singleton <code>take</code> method using
+ <code>txn</code>. <p>
+
+ If the method succeeds, a non-<code>null</code>
+ <code>Collection</code> will be returned. The
+ <code>Collection</code> will contain a copy of each
+ <code>Entry</code> that was taken. If no entries were taken,
+ the <code>Collection</code> will be empty. Each
+ <code>Entry</code> taken will be represented by a distinct
+ <code>Entry</code> instance in the returned
+ <code>Collection</code>, even if some of the entries are
+ equivalent to others taken by the operation. There will be
+ no <code>null</code> elements in the returned
+ <code>Collection</code>.<p>
+
+ If one or more of the entries taken cannot be unmarshalled
+ in the client, an <A HREF="../../../net/jini/entry/UnusableEntriesException.html" title="class in net.jini.entry"><CODE>UnusableEntriesException</CODE></A> is
+ thrown. The exception's <A HREF="../../../net/jini/entry/UnusableEntriesException.html#getEntries()"><CODE>UnusableEntriesException.getEntries</CODE></A> method will return a
+ <code>Collection</code> with a copy of each
+ <code>Entry</code> that could be unmarshalled. The <A HREF="../../../net/jini/entry/UnusableEntriesException.html#getUnusableEntryExceptions()"><CODE>UnusableEntriesException.getUnusableEntryExceptions</CODE></A> method
+ will return a <code>Collection</code> with an <A HREF="../../../net/jini/core/entry/UnusableEntryException.html" title="class in net.jini.core.entry"><CODE>UnusableEntryException</CODE></A> for each <code>Entry</code> that
+ could not be unmarshalled. Every <code>Entry</code> taken
+ by the invocation will either be represented in the
+ <code>Collection</code> returned by <code>getEntries</code>
+ or in the <code>Collection</code> returned by
+ <code>getUnusableEntryExceptions</code>. <p>
+
+ If there is at least one matching <code>Entry</code>
+ available in the space, an invocation of this method must
+ take at least one <code>Entry</code>. If more than one
+ matching <code>Entry</code> is available, the invocation may
+ take additional entries. It must not take more than
+ <code>maxEntries</code>, but an implementation may chose to
+ take fewer entries from the space than the maximum available or
+ the maximum allowed by <code>maxEntries</code>. If for
+ whatever reason, an invocation of this method takes fewer
+ entries than the maximum number of available matching
+ entries, how an implementation selects which entries should be
+ taken by the invocation and which are left in the space is
+ unspecified. How consumption of entries is arbitrated
+ between conflicting queries is also unspecified. <p>
+
+ If there are initially no matching entries in the space, an
+ invocation of this method should block for up to
+ <code>timeout</code> milliseconds for a match to appear. If
+ one or more matches become available before
+ <code>timeout</code> expires, one or more of the newly
+ available entries should be taken and the method should
+ return without further blocking. If for some reason the
+ invocation can't block for the full timeout and no entries
+ have been taken, the invocation must fail with a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi"><CODE>RemoteException</CODE></A> or <A HREF="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction"><CODE>TransactionException</CODE></A> as
+ appropriate. <p>
+
+ If an invocation of this method removes (or locks) more than
+ one <code>Entry</code>, the order in which the removal (or
+ locking) occurs is undefined, and different observers may see
+ the removal or locking of the entries in different
+ orders. <p>
+
+ If a <code>TransactionException</code>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang"><CODE>SecurityException</CODE></A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang"><CODE>IllegalArgumentException</CODE></A>, or
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang"><CODE>NullPointerException</CODE></A> is thrown, no entries will
+ have been taken. If a <code>RemoteException</code> is
+ thrown, up to <code>maxEntries</code> may have been taken
+ by this operation. <p>
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>tmpls</CODE> - a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util"><CODE>Collection</CODE></A> of <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A>
+ instances, each representing a template. All
+ of the entries taken by an invocation of this
+ method will match one or more elements of
+ <code>tmpls</code><DD><CODE>txn</CODE> - the <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction"><CODE>Transaction</CODE></A> this operation should be
+ performed under, may be <code>null</code><DD><CODE>timeout</CODE> - if there are initially no available
+ matches in the space, the maximum number of
+ milliseconds to block waiting for a match to
+ become available<DD><CODE>maxEntries</CODE> - the maximum number of entries that may be
+ taken by this method
+<DT><B>Returns:</B><DD>a <code>Collection</code> that contains a copy of each
+ <code>Entry</code> taken from the space by this
+ method. The space will not keep a reference to
+ this <code>Collection</code>. May be immutable
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../net/jini/entry/UnusableEntriesException.html" title="class in net.jini.entry">UnusableEntriesException</A></CODE> - if one or more of the
+ entries taken can't be unmarshalled in the client
+<DD><CODE><A HREF="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction">TransactionException</A></CODE> - if <code>txn</code> is
+ non-<code>null</code> and is not usable by the
+ space.
+<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 error occurs
+<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 any non-<code>null</code>
+ element of <code>tmpls</code> is not an instance of
+ <code>Entry</code>, if <code>tmpls</code> is empty,
+ if <code>timeout</code> is negative, or if
+ <code>maxEntries</code> is non-positive
+<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>tmpls</code> is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="contents(java.util.Collection, net.jini.core.transaction.Transaction, long, long)"><!-- --></A><H3>
+contents</H3>
+<PRE>
+<A HREF="../../../net/jini/space/MatchSet.html" title="interface in net.jini.space">MatchSet</A> <B>contents</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A> tmpls,
+ <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A> txn,
+ long leaseDuration,
+ long maxEntries)
+ throws <A HREF="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction">TransactionException</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>Creates a <A HREF="../../../net/jini/space/MatchSet.html" title="interface in net.jini.space">match set</A> that can be used to
+ exhaustively read through all of the matching entries in
+ the space that are visible to the passed <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction"><CODE>Transaction</CODE></A> and remain visible for the lifetime of the
+ match set. May also yield additional entries that match but
+ are only visible for part of the lifetime of the match
+ set. <p>
+
+ The <code>tmpls</code> parameter must be a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util"><CODE>Collection</CODE></A> of <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> instances to be used as
+ templates. All of the entries placed in the match set will
+ match one or more of these templates. <code>tmpls</code> may
+ contain <code>null</code> values and may contain
+ duplicates. An <code>Entry</code> is said to be
+ <em>visible</em> to an invocation of this method if the
+ <code>Entry</code> could have been returned by a singleton
+ <A HREF="../../../net/jini/space/JavaSpace.html#read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>JavaSpace.read</CODE></A> using the same
+ transaction. <p>
+
+ The resulting match set must initially contain all of the
+ visible matching entries in the space. During the lifetime
+ of the match set an <code>Entry</code> may be, but is not
+ required to be, added to the match set if it becomes
+ visible. If the match set becomes empty, no more entries can
+ be added and the match set enters the <A HREF="../../../net/jini/space/MatchSet.html" title="interface in net.jini.space">exhausted</A> state.<p>
+
+ Normally there are three conditions under which an
+ <code>Entry</code> might be removed from the match set:
+
+ <ul>
+
+ <li> Any <code>Entry</code> yielded by an invocation of the
+ <A HREF="../../../net/jini/space/MatchSet.html#next()"><CODE>MatchSet.next</CODE></A> method on the match
+ set (either as the return value of a successful call or
+ embedded in an <A HREF="../../../net/jini/core/entry/UnusableEntryException.html" title="class in net.jini.core.entry"><CODE>UnusableEntryException</CODE></A>) must be
+ removed from the match set.
+
+ <li> Any <code>Entry</code> that remains in the match set
+ after <code>maxEntries</code> entries are yielded by
+ <code>next</code> invocations must be removed from the
+ match set. In such a case, the criteria used to select which
+ entries are yielded by <code>next</code> calls and which
+ get removed from the set at the end is unspecified.
+
+ <li> Any <code>Entry</code> that during the lifetime of the
+ match set becomes invisible may at the discretion of the
+ implementation be removed from the match set.
+
+ </ul>
+ <p>
+
+ An implementation may decide to remove an <code>Entry</code>
+ from the set for other reasons. If it does so, however, it
+ must <A HREF="../../../net/jini/space/MatchSet.html" title="interface in net.jini.space">invalidate</A> the set.<p>
+
+ If <code>txn</code> is non-<code>null</code> and still
+ active, any <code>Entry</code> removed from the match set by
+ a <code>next</code> call must be locked as if it had been
+ returned by a read operation using <code>txn</code>. An
+ implementation may establish the read lock on the
+ <code>Entry</code> any time between when the
+ <code>Entry</code> is added to the match set and when the
+ <code>Entry</code> is removed from the match set by an
+ invocation of <code>next</code>. These read locks are not
+ released when the match set reaches either the exhausted
+ state or the invalidated state. If from the space's
+ perspective the <code>txn</code> leaves the active state,
+ the space must remove from the match set any entries in the
+ match set that have not yet been read locked. This may
+ require the match set to be invalidated. <p>
+
+ If the match set is leased and <code>leaseDuration</code>
+ is positive, the initial duration of the lease must be less
+ than or equal to <code>leaseDuration</code>. If
+ <code>leaseDuration</code> is <A HREF="../../../net/jini/core/lease/Lease.html#ANY"><CODE>Lease.ANY</CODE></A>,
+ the initial duration of the lease can be any positive value
+ desired by the implementation. <p>
+
+ If there are <A HREF="../../../net/jini/core/constraint/package-summary.html">remote
+ method constraints</A> associated with an invocation of this
+ method, any remote communications performed by or on behalf
+ of the match set's <code>next</code> method will be
+ performed in compliance with these constraints, not with the
+ constraints (if any) associated with <code>next</code>. <p>
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>tmpls</CODE> - a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util"><CODE>Collection</CODE></A> of <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A>
+ instances, each representing a template. All
+ the entries added to the resulting match set will
+ match one or more elements of <code>tmpls</code><DD><CODE>txn</CODE> - the <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction"><CODE>Transaction</CODE></A> this operation should be
+ performed under, may be <code>null</code><DD><CODE>leaseDuration</CODE> - the requested initial lease time on
+ the resulting match set<DD><CODE>maxEntries</CODE> - the maximum number of entries to remove
+ from the set via <A HREF="../../../net/jini/space/MatchSet.html#next()"><CODE>MatchSet.next</CODE></A>
+ calls
+<DT><B>Returns:</B><DD>A proxy to the newly created <A HREF="../../../net/jini/space/MatchSet.html" title="interface in net.jini.space">match set</A>
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction">TransactionException</A></CODE> - if <code>txn</code> is
+ non-<code>null</code> and is not usable by the
+ space
+<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 error occurs
+<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 any non-<code>null</code>
+ element of <code>tmpls</code> is not an instance of
+ <code>Entry</code>, if <code>tmpls</code> is empty,
+ if <code>leaseDuration</code> is neither positive
+ nor <A HREF="../../../net/jini/core/lease/Lease.html#ANY"><CODE>Lease.ANY</CODE></A>, or if
+ <code>maxEntries</code> is non-positive
+<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>tmpls</code> is
+ <code>null</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="registerForAvailabilityEvent(java.util.Collection, net.jini.core.transaction.Transaction, boolean, net.jini.core.event.RemoteEventListener, long, java.rmi.MarshalledObject)"><!-- --></A><H3>
+registerForAvailabilityEvent</H3>
+<PRE>
+<A HREF="../../../net/jini/core/event/EventRegistration.html" title="class in net.jini.core.event">EventRegistration</A> <B>registerForAvailabilityEvent</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A> tmpls,
+ <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A> txn,
+ boolean visibilityOnly,
+ <A HREF="../../../net/jini/core/event/RemoteEventListener.html" title="interface in net.jini.core.event">RemoteEventListener</A> listener,
+ long leaseDuration,
+ <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="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction">TransactionException</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>Register for events triggered when a matching <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A>
+ transitions from unavailable to available. The resulting
+ events will be instances of the <A HREF="../../../net/jini/space/AvailabilityEvent.html" title="class in net.jini.space"><CODE>AvailabilityEvent</CODE></A>
+ class and the <A HREF="../../../net/jini/space/AvailabilityEvent.html#getEntry()"><CODE>AvailabilityEvent.getEntry</CODE></A> method will return a copy of
+ the <code>Entry</code> whose transition triggered the
+ event.<p>
+
+ An <code>Entry</code> makes a transition from
+ <em>unavailable to available</em> when it goes from being in
+ a state where it could not be returned by a <A HREF="../../../net/jini/space/JavaSpace.html#take(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>JavaSpace.take</CODE></A> using <code>txn</code> to a
+ state where it could be returned. An <code>Entry</code>
+ makes a transition from <em>invisible to visible</em> when
+ it goes from being in a state where it could not be returned
+ by a <A HREF="../../../net/jini/space/JavaSpace.html#read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>JavaSpace.read</CODE></A> using
+ <code>txn</code> to a state where it could be
+ returned. Note, any transition from invisible to visible is
+ also a transition from unavailable to available, but an
+ already visible entry can be unavailable and then make a
+ transition from unavailable to available. Because the entry
+ was already visible, this transition would not be a
+ transition from invisible to visible.<p>
+
+ The <code>tmpls</code> parameter must be a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util"><CODE>Collection</CODE></A> of <code>Entry</code> instances to be used as
+ templates. Events will be generated when an
+ <code>Entry</code> that matches one or more of these
+ templates makes an appropriate transition. A single
+ transition will generate only one event per registration, in
+ particular the transition of an <code>Entry</code> that
+ matches multiple elements of <code>tmpls</code> must still
+ generate exactly one event for this registration. If a given
+ <code>Entry</code> undergoes multiple applicable transitions
+ while the registration is active, each must generate a
+ separate event.<p>
+
+ Events are not generated directly by the transition of
+ matching entries, but instead by an abstract observer set up
+ in the space for each registration. The observer may see the
+ transitions out of order and as a result the order of the
+ events generated for this registration (as determined by the
+ sequence numbers assigned to the events) may be different
+ from the order of the transitions themselves. Additionally,
+ each registration will have its own abstract observer and
+ different observers may see the same sequence of transitions
+ in different orders. As a result, given a set of transitions
+ that trigger events for two different registrations, the
+ order of the events generated for one registration may
+ differ from the order of the events generated for the
+ other. <p>
+
+ A non-<code>null</code> <A HREF="../../../net/jini/core/event/EventRegistration.html" title="class in net.jini.core.event"><CODE>EventRegistration</CODE></A> object
+ will be returned. Each registration will be assigned an
+ event ID. The event ID will be unique at least with respect
+ to all other active event registrations for
+ <code>AvailabilityEvent</code>s on this space with a
+ non-equivalent set of templates, a different transaction,
+ and/or a different value for the
+ <code>visibilityOnly</code> flag. The event ID can be
+ obtained by calling the <A HREF="../../../net/jini/core/event/EventRegistration.html#getID()"><CODE>EventRegistration.getID</CODE></A> method on the returned
+ <code>EventRegistration</code>. The returned
+ <code>EventRegistration</code> object's <A HREF="../../../net/jini/core/event/EventRegistration.html#getSource()"><CODE>EventRegistration.getSource</CODE></A>
+ method will return a reference to the space.<p>
+
+ Registrations are leased. <code>leaseDurations</code>
+ represents the client's desired initial lease duration. If
+ <code>leaseDuration</code> is positive, the initial lease
+ duration will be a positive value less than or equal to
+ <code>leaseDuration</code>. If <code>leaseDuration</code> is
+ <A HREF="../../../net/jini/core/lease/Lease.html#ANY"><CODE>Lease.ANY</CODE></A>, the space is free to pick any
+ positive initial lease duration it desires. A proxy for the
+ lease associated with the registration can be obtained by
+ calling the returned <code>EventRegistration</code>'s <A HREF="../../../net/jini/core/event/EventRegistration.html#getLease()"><CODE>EventRegistration.getLease</CODE></A>
+ method.<p>
+
+ A registration made with a non-<code>null</code> value for
+ <code>txn</code> is implicitly dropped when the space
+ observes <code>txn</code> has left the active state.<p>
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>tmpls</CODE> - a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util"><CODE>Collection</CODE></A> of <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A>
+ instances, each representing a
+ template. Events for this registration will be
+ generated by the transitions of entries
+ matching one or more elements of
+ <code>tmpls</code><DD><CODE>txn</CODE> - the <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction"><CODE>Transaction</CODE></A> this operation should be
+ performed under, may be <code>null</code><DD><CODE>visibilityOnly</CODE> - if <code>true</code>, events will
+ be generated for this registration only when a
+ matching <code>Entry</code> transitions from
+ invisible to visible, otherwise events will be
+ generated when a matching <code>Entry</code>
+ makes any transition from unavailable to
+ available<DD><CODE>listener</CODE> - the object to which events generated for
+ this registration should be delivered<DD><CODE>leaseDuration</CODE> - the requested initial lease time on
+ the resulting event registration<DD><CODE>handback</CODE> - the <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi"><CODE>MarshalledObject</CODE></A> to be
+ returned by the <A HREF="../../../net/jini/core/event/RemoteEvent.html#getRegistrationObject()"><CODE>RemoteEvent.getRegistrationObject</CODE></A> method of
+ the events generated for this registration
+<DT><B>Returns:</B><DD>an <A HREF="../../../net/jini/core/event/EventRegistration.html" title="class in net.jini.core.event"><CODE>EventRegistration</CODE></A> object with
+ information on this registration
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction">TransactionException</A></CODE> - if <code>txn</code> is
+ non-<code>null</code> and is not usable by the
+ space
+<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 error occurs
+<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 any non-<code>null</code>
+ element of <code>tmpls</code> is not an instance of
+ <code>Entry</code>, if <code>tmpls</code> is empty,
+ or if <code>leaseDuration</code> is neither
+ positive nor <A HREF="../../../net/jini/core/lease/Lease.html#ANY"><CODE>Lease.ANY</CODE></A>
+<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>tmpls</code> or
+ <code>listener</code> is <code>null</code></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/JavaSpace05.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/space/JavaSpace.html" title="interface in net.jini.space"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/space/MatchSet.html" title="interface in net.jini.space"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/space/JavaSpace05.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="JavaSpace05.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 | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | 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: incubator/river/site/trunk/content/river/doc/api/net/jini/space/MatchSet.html
URL: http://svn.apache.org/viewvc/incubator/river/site/trunk/content/river/doc/api/net/jini/space/MatchSet.html?rev=1052599&view=auto
==============================================================================
--- incubator/river/site/trunk/content/river/doc/api/net/jini/space/MatchSet.html (added)
+++ incubator/river/site/trunk/content/river/doc/api/net/jini/space/MatchSet.html Fri Dec 24 20:35:19 2010
@@ -0,0 +1,396 @@
+<!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:25 EST 2010 -->
+<TITLE>
+MatchSet (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.space.MatchSet interface">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="MatchSet (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/MatchSet.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/space/JavaSpace05.html" title="interface in net.jini.space"><B>PREV CLASS</B></A>
+ NEXT CLASS</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/space/MatchSet.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="MatchSet.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 | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | 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.space</FONT>
+<BR>
+Interface MatchSet</H2>
+<HR>
+<DL>
+<DT><PRE>public interface <B>MatchSet</B></DL>
+</PRE>
+
+<P>
+A collection of <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> instances to be incrementally
+ returned from a JavaSpaces service. Some operations on a
+ space must return more entries than can be conveniently
+ returned by a single call, generally because returning all the
+ entries in one result would consume too many resources in the
+ client or introduce too much latency before the first entry
+ could be processed. In these cases, match sets are returned to
+ incrementally return the necessary entries. A
+ <code>MatchSet</code> instance is a proxy object that can be
+ used to access a match set created by a space.<p>
+
+ Typically match sets are created by some factory method on the
+ space (for example, <A HREF="../../../net/jini/space/JavaSpace05.html#contents(java.util.Collection, net.jini.core.transaction.Transaction, long, long)"><CODE>JavaSpace05.contents</CODE></A>) which returns a <code>MatchSet</code>
+ instance that will serve as a proxy to the match set. The match
+ set will initially contain some population of entries specified
+ by the operation that created it. These entries can be
+ retrieved by calling <A HREF="../../../net/jini/space/MatchSet.html#next()"><CODE>next</CODE></A>. A successful call to
+ <code>next</code> will remove the returned <code>Entry</code>
+ from the match set. Match sets can end up in one of two
+ terminal states, <em>exhausted</em> or <em>invalidated</em>.
+ Under what conditions a match set enters one of these states is
+ specified by the operation that created it. An exhausted match
+ set is empty and will have no more entries added. Calling
+ <code>next</code> on an exhausted match set must always return
+ <code>null</code>. Calling <code>next</code> on an invalidated
+ match set may return a non-<code>null</code> value, or it may
+ throw one of the allowed exceptions. In particular it may
+ throw <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/NoSuchObjectException.html" title="class or interface in java.rmi"><CODE>NoSuchObjectException</CODE></A> to indicate that the match
+ set has been invalidated. Once <code>next</code> throws a
+ <code>NoSuchObjectException</code>, all future
+ <code>next</code> calls on that instance must also throw
+ <code>NoSuchObjectException</code>. Calling <code>next</code>
+ on an invalidated match set must never return
+ <code>null</code>. Implementations must not add entries to an
+ invalidated match set. <p>
+
+ Between the time a match set is created and the time it reaches a
+ terminal state, entries may be added by the space. However, an
+ <code>Entry</code> that is removed by a <code>next</code> call
+ must not be added back to a match set (though if there is a
+ distinct but equivalent entry in the space it may be
+ added). The space may also remove entries independent of
+ <code>next</code> calls. The conditions under which entries
+ will be removed independent of <code>next</code> calls or added
+ after the initial creation of the match set are specified by
+ the operation that created the match set. <p>
+
+ If there is a possibility that a match set may become
+ invalidated, it must be leased and an appropriate proxy must be
+ returned by the <A HREF="../../../net/jini/space/MatchSet.html#getLease()"><CODE>getLease</CODE></A> method. If there is
+ no possibility that the match set will become invalidated,
+ implementations should not lease the match set. If a match set
+ is not leased, then <code>getLease</code> must return
+ <code>null</code>. <p>
+
+ An active lease on a match set serves as a hint to the space
+ that the client is still interested in the match set, and as a
+ hint to the client that the match set is still functioning.
+ However, implementations are allowed to invalidate match sets
+ associated with active leases and to unilaterally cancel leases
+ associated with functioning match sets. If a match set is
+ leased and the lease is active, implementations should, to the
+ best of their ability, maintain the match set and not invalidate
+ it. There are cases, however, where this may not be possible in
+ particular, it is not expected that implementations will
+ maintain match sets across crashes. If the lease expires or is
+ canceled, an implementation should invalidate the match
+ set. An implementation must unilaterally cancel a match set's
+ lease if the match set is invalidated. An implementation may
+ unilaterally cancel the lease at other times without necessarily
+ invalidating the match set. Clients should <em>not</em> assume
+ that the resources associated with a leased match set will be
+ freed if the match set reaches the exhausted state, and should
+ instead cancel the lease.
+
+ This interface is not a remote interface; though in general a
+ <code>MatchSet</code> is a proxy for some remote match set,
+ only the <code>next</code> method is considered to be a remote
+ method, and as outlined in its <A HREF="../../../net/jini/space/MatchSet.html#next()">description</A>
+ it deviates in a number of ways from normal Java(TM) Remote
+ Method Invocation remote method semantics.
+<P>
+
+<P>
+<DL>
+<DT><B>Since:</B></DT>
+ <DD>2.1</DD>
+</DL>
+<HR>
+
+<P>
+
+<!-- ========== 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="../../../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/space/MatchSet.html#getLease()">getLease</A></B>()</CODE>
+
+<BR>
+ Returns a proxy to the <A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease"><CODE>Lease</CODE></A> associated with this
+ match set, or <code>null</code> if this match set is not
+ leased.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/space/MatchSet.html#getSnapshot()">getSnapshot</A></B>()</CODE>
+
+<BR>
+ Returns a <em>snapshot</em> of the <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> removed by
+ the last call to <A HREF="../../../net/jini/space/MatchSet.html#next()"><CODE>next</CODE></A>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/space/MatchSet.html#next()">next</A></B>()</CODE>
+
+<BR>
+ Removes one <code>Entry</code> from the match set and
+ returns a copy to the caller.</TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ 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="next()"><!-- --></A><H3>
+next</H3>
+<PRE>
+<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A> <B>next</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>,
+ <A HREF="../../../net/jini/core/entry/UnusableEntryException.html" title="class in net.jini.core.entry">UnusableEntryException</A></PRE>
+<DL>
+<DD>Removes one <code>Entry</code> from the match set and
+ returns a copy to the caller. Returns <code>null</code> if
+ the match set is empty. The returned <code>Entry</code>
+ must be unmarshalled in accordance with the <a
+ href=http://www.jini.org/standards/index.html>Jini Entry
+ Specification</a>.<p>
+
+ A given invocation of this method may perform remote
+ communications, but generally the <code>next</code> method
+ is not expected to have <A HREF="../../../net/jini/core/constraint/package-summary.html">remote method constraints</A> that
+ can vary from invocation to invocation. Instead the set of
+ constraints associated with the <code>next</code> method
+ will be fixed at the time the match set was created, even
+ if this object implements an interface like <A HREF="../../../net/jini/core/constraint/RemoteMethodControl.html" title="interface in net.jini.core.constraint"><CODE>RemoteMethodControl</CODE></A> that would otherwise allow the set of
+ constraints associated with the <code>next</code> method to
+ be altered.<p>
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>an <code>Entry</code> from the match set, or
+ <code>null</code> if the match set is empty
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../net/jini/core/entry/UnusableEntryException.html" title="class in net.jini.core.entry">UnusableEntryException</A></CODE> - if the entry removed from
+ the match set could not be unmarshalled
+<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 error occurs. If a
+ <code>RemoteException</code> is thrown, no
+ <code>Entry</code> was removed from the match set
+ because of this call</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getLease()"><!-- --></A><H3>
+getLease</H3>
+<PRE>
+<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A> <B>getLease</B>()</PRE>
+<DL>
+<DD>Returns a proxy to the <A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease"><CODE>Lease</CODE></A> associated with this
+ match set, or <code>null</code> if this match set is not
+ leased.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>a proxy for the match set's lease, or
+ <code>null</code> if there is no lease associated with this
+ match set</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getSnapshot()"><!-- --></A><H3>
+getSnapshot</H3>
+<PRE>
+<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A> <B>getSnapshot</B>()</PRE>
+<DL>
+<DD>Returns a <em>snapshot</em> of the <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> removed by
+ the last call to <A HREF="../../../net/jini/space/MatchSet.html#next()"><CODE>next</CODE></A>. Snapshots are defined
+ in section JS.2.6 of the <a
+ href=http://www.jini.org/standards/index.html>
+ JavaSpaces Service Specification</a> and are an
+ alternative representation of a given <code>Entry</code>
+ produced by a particular space for use with that same
+ space. Passing a snapshot to a space is generally more
+ efficient than passing the original representation.<p>
+
+ Any snapshot returned by this method will meet the same
+ contract as the object returned by passing the result of
+ the last <code>next</code> invocation to <A HREF="../../../net/jini/space/JavaSpace.html#snapshot(net.jini.core.entry.Entry)"><CODE>JavaSpace.snapshot</CODE></A>.<p>
+
+ Generally there is a cost associated with calling the
+ <code>JavaSpace.snapshot</code> method. Thus creating a
+ snapshot using that method is usually only worthwhile if
+ the resulting snapshot is used more than once. The cost of
+ invoking this method should be low and should be worthwhile
+ even if the resulting snapshot is used only once. <p>
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>a <em>snapshot</em> of the <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> removed
+ from the match set by the last call to <A HREF="../../../net/jini/space/MatchSet.html#next()"><CODE>next</CODE></A>
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - if the last call to
+ <code>next</code> did not remove an
+ <code>Entry</code> from the match set, or no call
+ to <code>next</code> has been made</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/MatchSet.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/space/JavaSpace05.html" title="interface in net.jini.space"><B>PREV CLASS</B></A>
+ NEXT CLASS</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/space/MatchSet.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="MatchSet.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 | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | 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: incubator/river/site/trunk/content/river/doc/api/net/jini/space/package-frame.html
URL: http://svn.apache.org/viewvc/incubator/river/site/trunk/content/river/doc/api/net/jini/space/package-frame.html?rev=1052599&view=auto
==============================================================================
--- incubator/river/site/trunk/content/river/doc/api/net/jini/space/package-frame.html (added)
+++ incubator/river/site/trunk/content/river/doc/api/net/jini/space/package-frame.html Fri Dec 24 20:35:19 2010
@@ -0,0 +1,58 @@
+<!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:30 EST 2010 -->
+<TITLE>
+net.jini.space (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.space package">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+
+</HEAD>
+
+<BODY BGCOLOR="white">
+<FONT size="+1" CLASS="FrameTitleFont">
+<A HREF="../../../net/jini/space/package-summary.html" target="classFrame">net.jini.space</A></FONT>
+<TABLE BORDER="0" WIDTH="100%" SUMMARY="">
+<TR>
+<TD NOWRAP><FONT size="+1" CLASS="FrameHeadingFont">
+Interfaces</FONT>
+<FONT CLASS="FrameItemFont">
+<BR>
+<A HREF="JavaSpace.html" title="interface in net.jini.space" target="classFrame"><I>JavaSpace</I></A>
+<BR>
+<A HREF="JavaSpace05.html" title="interface in net.jini.space" target="classFrame"><I>JavaSpace05</I></A>
+<BR>
+<A HREF="MatchSet.html" title="interface in net.jini.space" target="classFrame"><I>MatchSet</I></A></FONT></TD>
+</TR>
+</TABLE>
+
+
+<TABLE BORDER="0" WIDTH="100%" SUMMARY="">
+<TR>
+<TD NOWRAP><FONT size="+1" CLASS="FrameHeadingFont">
+Classes</FONT>
+<FONT CLASS="FrameItemFont">
+<BR>
+<A HREF="AvailabilityEvent.html" title="class in net.jini.space" target="classFrame">AvailabilityEvent</A></FONT></TD>
+</TR>
+</TABLE>
+
+
+<TABLE BORDER="0" WIDTH="100%" SUMMARY="">
+<TR>
+<TD NOWRAP><FONT size="+1" CLASS="FrameHeadingFont">
+Exceptions</FONT>
+<FONT CLASS="FrameItemFont">
+<BR>
+<A HREF="InternalSpaceException.html" title="class in net.jini.space" target="classFrame">InternalSpaceException</A></FONT></TD>
+</TR>
+</TABLE>
+
+
+</BODY>
+</HTML>
Added: incubator/river/site/trunk/content/river/doc/api/net/jini/space/package-summary.html
URL: http://svn.apache.org/viewvc/incubator/river/site/trunk/content/river/doc/api/net/jini/space/package-summary.html?rev=1052599&view=auto
==============================================================================
--- incubator/river/site/trunk/content/river/doc/api/net/jini/space/package-summary.html (added)
+++ incubator/river/site/trunk/content/river/doc/api/net/jini/space/package-summary.html Fri Dec 24 20:35:19 2010
@@ -0,0 +1,240 @@
+<!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:30 EST 2010 -->
+<TITLE>
+net.jini.space (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.space package">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="net.jini.space (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="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-use.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/security/proxytrust/package-summary.html"><B>PREV PACKAGE</B></A>
+ <A HREF="../../../net/jini/url/file/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/space/package-summary.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="package-summary.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>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<H2>
+Package net.jini.space
+</H2>
+JavaSpaces servers provide a place on the network, a <em>space</em>,
+for clients to store and exchange objects.
+<P>
+<B>See:</B>
+<BR>
+ <A HREF="#package_description"><B>Description</B></A>
+<P>
+
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Interface Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD WIDTH="15%"><B><A HREF="../../../net/jini/space/JavaSpace.html" title="interface in net.jini.space">JavaSpace</A></B></TD>
+<TD>This interface is implemented by servers that export a
+ JavaSpaces technology service.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD WIDTH="15%"><B><A HREF="../../../net/jini/space/JavaSpace05.html" title="interface in net.jini.space">JavaSpace05</A></B></TD>
+<TD>The <code>JavaSpace05</code> interface extends the <A HREF="../../../net/jini/space/JavaSpace.html" title="interface in net.jini.space"><CODE>JavaSpace</CODE></A> interface to provide methods that allow clients to
+ perform batch operations on the space (which are generally more
+ efficient than performing an equivalent set of singleton
+ operations) and to more easily develop applications where a
+ given <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> needs to be read by multiple clients.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD WIDTH="15%"><B><A HREF="../../../net/jini/space/MatchSet.html" title="interface in net.jini.space">MatchSet</A></B></TD>
+<TD>A collection of <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> instances to be incrementally
+ returned from a JavaSpaces service.</TD>
+</TR>
+</TABLE>
+
+
+<P>
+
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Class Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD WIDTH="15%"><B><A HREF="../../../net/jini/space/AvailabilityEvent.html" title="class in net.jini.space">AvailabilityEvent</A></B></TD>
+<TD>A <code>RemoteEvent</code> marking the transition of an
+ <code>Entry</code> from <A HREF="../../../net/jini/space/JavaSpace05.html#registerForAvailabilityEvent(java.util.Collection, net.jini.core.transaction.Transaction, boolean, net.jini.core.event.RemoteEventListener, long, java.rmi.MarshalledObject)"><CODE><em>unavailable</em> to
+ <em>available</em></CODE></A>.</TD>
+</TR>
+</TABLE>
+
+
+<P>
+
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Exception Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD WIDTH="15%"><B><A HREF="../../../net/jini/space/InternalSpaceException.html" title="class in net.jini.space">InternalSpaceException</A></B></TD>
+<TD>This exception denotes a problem with the local implementation of the
+ <code>JavaSpace</code> interface.</TD>
+</TR>
+</TABLE>
+
+
+<P>
+<A NAME="package_description"><!-- --></A><H2>
+Package net.jini.space Description
+</H2>
+
+<P>
+JavaSpaces servers provide a place on the network, a <em>space</em>,
+for clients to store and exchange objects. Sets of processes in a
+distributed system can coordinate their actions by flowing objects in and
+out of the space. Because these processes interact via the space they can
+be decoupled from each other. The basic <A HREF="../../../net/jini/space/JavaSpace.html" title="interface in net.jini.space"><CODE>JavaSpace</CODE></A>
+interface allows objects, called <A HREF="../../../net/jini/core/entry/package-summary.html"><em>entries</em></A> to be copied into, removed from, and/or non-destructively
+copied out of the space - optionally using <A HREF="../../../net/jini/core/transaction/package-summary.html">Jini technology-based transactions</A>. <p>
+
+The basic <code>JavaSpace</code> interface is specified in the <a
+href=http://www.jini.org/standards/index.html> JavaSpaces Service
+Specification</a>.<p>
+
+The <A HREF="../../../net/jini/space/JavaSpace05.html" title="interface in net.jini.space"><CODE>JavaSpace05</CODE></A> interface extends the
+<code>JavaSpace</code> interface to provide methods that allow clients to
+perform batch operations on the space (which are generally more efficient
+than performing an equivalent set of singleton operations) and to more
+easily develop applications where a given <code>Entry</code> needs to be
+read by multiple clients. Implementations of the <code>JavaSpace</code>
+interface are not required to implement this interface.<p>
+<P>
+
+<P>
+<DL>
+<DT><B>Since:</B></DT>
+ <DD>1.0</DD>
+<DT><B>See Also:</B><DD><a href=http://www.jini.org/standards/index.html>
+ JavaSpaces Service Specification</a>,
+<a href=http://www.jini.org/standards/index.html>
+ Jini Transaction Specification</a>,
+<a href=http://www.jini.org/standards/index.html>
+ Jini Entry Specification</a></DL>
+<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="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-use.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/security/proxytrust/package-summary.html"><B>PREV PACKAGE</B></A>
+ <A HREF="../../../net/jini/url/file/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/space/package-summary.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="package-summary.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>
+</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>