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:35:29 UTC

svn commit: r781474 [1/3] - /websites/staging/river/trunk/content/river/doc/api/net/jini/space/

Author: buildbot
Date: Fri Dec 24 20:35:29 2010
New Revision: 781474

Log:
Staging update by buildbot

Added:
    websites/staging/river/trunk/content/river/doc/api/net/jini/space/
    websites/staging/river/trunk/content/river/doc/api/net/jini/space/AvailabilityEvent.html
    websites/staging/river/trunk/content/river/doc/api/net/jini/space/InternalSpaceException.html
    websites/staging/river/trunk/content/river/doc/api/net/jini/space/JavaSpace.html
    websites/staging/river/trunk/content/river/doc/api/net/jini/space/JavaSpace05.html
    websites/staging/river/trunk/content/river/doc/api/net/jini/space/MatchSet.html
    websites/staging/river/trunk/content/river/doc/api/net/jini/space/package-frame.html
    websites/staging/river/trunk/content/river/doc/api/net/jini/space/package-summary.html
    websites/staging/river/trunk/content/river/doc/api/net/jini/space/package-tree.html
    websites/staging/river/trunk/content/river/doc/api/net/jini/space/package-use.html

Added: websites/staging/river/trunk/content/river/doc/api/net/jini/space/AvailabilityEvent.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/net/jini/space/AvailabilityEvent.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/net/jini/space/AvailabilityEvent.html Fri Dec 24 20:35:29 2010
@@ -0,0 +1,414 @@
+<!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>
+AvailabilityEvent (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.space.AvailabilityEvent class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+    parent.document.title="AvailabilityEvent (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>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/AvailabilityEvent.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
+  </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+&nbsp;PREV CLASS&nbsp;
+&nbsp;<A HREF="../../../net/jini/space/InternalSpaceException.html" title="class 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/AvailabilityEvent.html" target="_top"><B>FRAMES</B></A>  &nbsp;
+&nbsp;<A HREF="AvailabilityEvent.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
+&nbsp;<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:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#fields_inherited_from_class_net.jini.core.event.RemoteEvent">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<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>
+Class AvailabilityEvent</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/util/EventObject.html" title="class or interface in java.util">java.util.EventObject</A>
+      <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../net/jini/core/event/RemoteEvent.html" title="class in net.jini.core.event">net.jini.core.event.RemoteEvent</A>
+          <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>net.jini.space.AvailabilityEvent</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 abstract class <B>AvailabilityEvent</B><DT>extends <A HREF="../../../net/jini/core/event/RemoteEvent.html" title="class in net.jini.core.event">RemoteEvent</A></DL>
+</PRE>
+
+<P>
+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>.<p>
+ 
+ Note, by the time the event is delivered, the
+ <code>Entry</code> whose transition triggered this event may
+ have transitioned to a state where it is no longer visible
+ and/or available.<p>
+<P>
+
+<P>
+<DL>
+<DT><B>Since:</B></DT>
+  <DD>2.1</DD>
+<DT><B>See Also:</B><DD><A HREF="../../../net/jini/space/JavaSpace05.html" title="interface in net.jini.space"><CODE>JavaSpace05</CODE></A>, 
+<A HREF="../../../serialized-form.html#net.jini.space.AvailabilityEvent">Serialized Form</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>
+&nbsp;<A NAME="fields_inherited_from_class_net.jini.core.event.RemoteEvent"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Fields inherited from class net.jini.core.event.<A HREF="../../../net/jini/core/event/RemoteEvent.html" title="class in net.jini.core.event">RemoteEvent</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="../../../net/jini/core/event/RemoteEvent.html#eventID">eventID</A>, <A HREF="../../../net/jini/core/event/RemoteEvent.html#handback">handback</A>, <A HREF="../../../net/jini/core/event/RemoteEvent.html#seqNum">seqNum</A>, <A HREF="../../../net/jini/core/event/RemoteEvent.html#source">source</A></CODE></TD>
+</TR>
+</TABLE>
+&nbsp;
+<!-- ======== 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 ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected </CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/space/AvailabilityEvent.html#AvailabilityEvent(net.jini.space.JavaSpace, long, long, java.rmi.MarshalledObject, boolean)">AvailabilityEvent</A></B>(<A HREF="../../../net/jini/space/JavaSpace.html" title="interface in net.jini.space">JavaSpace</A>&nbsp;source,
+                  long&nbsp;eventID,
+                  long&nbsp;seqNum,
+                  <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>&nbsp;handback,
+                  boolean&nbsp;visibilityTransition)</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new <code>AvailabilityEvent</code> instance.</TD>
+</TR>
+</TABLE>
+&nbsp;
+<!-- ========== 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>abstract &nbsp;<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/AvailabilityEvent.html#getEntry()">getEntry</A></B>()</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a copy of the <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> whose transition
+ triggered this event.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>abstract &nbsp;<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/AvailabilityEvent.html#getSnapshot()">getSnapshot</A></B>()</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;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> whose
+ transition triggered this event.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>&nbsp;boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/space/AvailabilityEvent.html#isVisibilityTransition()">isVisibilityTransition</A></B>()</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns <code>true</code> if the transition that triggered
+ this event was a transition 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)"><em>invisible to
+ visible</em></A> as well as a transition from unavailable to
+ available, and <code>false</code> otherwise.</TD>
+</TR>
+</TABLE>
+&nbsp;<A NAME="methods_inherited_from_class_net.jini.core.event.RemoteEvent"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class net.jini.core.event.<A HREF="../../../net/jini/core/event/RemoteEvent.html" title="class in net.jini.core.event">RemoteEvent</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="../../../net/jini/core/event/RemoteEvent.html#getID()">getID</A>, <A HREF="../../../net/jini/core/event/RemoteEvent.html#getRegistrationObject()">getRegistrationObject</A>, <A HREF="../../../net/jini/core/event/RemoteEvent.html#getSequenceNumber()">getSequenceNumber</A></CODE></TD>
+</TR>
+</TABLE>
+&nbsp;<A NAME="methods_inherited_from_class_java.util.EventObject"><!-- --></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.util.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/EventObject.html" title="class or interface in java.util">EventObject</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/EventObject.html#getSource()" title="class or interface in java.util">getSource</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/EventObject.html#toString()" title="class or interface in java.util">toString</A></CODE></TD>
+</TR>
+</TABLE>
+&nbsp;<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>
+&nbsp;
+<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="AvailabilityEvent(net.jini.space.JavaSpace, long, long, java.rmi.MarshalledObject, boolean)"><!-- --></A><H3>
+AvailabilityEvent</H3>
+<PRE>
+protected <B>AvailabilityEvent</B>(<A HREF="../../../net/jini/space/JavaSpace.html" title="interface in net.jini.space">JavaSpace</A>&nbsp;source,
+                            long&nbsp;eventID,
+                            long&nbsp;seqNum,
+                            <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>&nbsp;handback,
+                            boolean&nbsp;visibilityTransition)</PRE>
+<DL>
+<DD>Create a new <code>AvailabilityEvent</code> instance.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>source</CODE> - the event source<DD><CODE>eventID</CODE> - the event identifier<DD><CODE>seqNum</CODE> - the event sequence number<DD><CODE>handback</CODE> - the handback object<DD><CODE>visibilityTransition</CODE> - <code>true</code> if this event
+                  must also signal a transition from
+                  invisible to visible
+<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>source</code> is
+        <code>null</code></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="getEntry()"><!-- --></A><H3>
+getEntry</H3>
+<PRE>
+public abstract <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A> <B>getEntry</B>()
+                        throws <A HREF="../../../net/jini/core/entry/UnusableEntryException.html" title="class in net.jini.core.entry">UnusableEntryException</A></PRE>
+<DL>
+<DD>Returns a copy of the <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> whose transition
+ triggered this event. 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>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>a copy of the <A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</CODE></A> whose transition
+         triggered this event
+<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 <code>Entry</code>
+         can't be unmarshalled in the client. The next call
+         must re-attempt unmarshalling the
+         <code>Entry</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getSnapshot()"><!-- --></A><H3>
+getSnapshot</H3>
+<PRE>
+public abstract <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> whose
+ transition triggered this event. 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 <code>Entry</code>.<p>
+ 
+ Any snapshot returned by this method will meet the same
+ contract as the object returned by passing the result of
+ <A HREF="../../../net/jini/space/AvailabilityEvent.html#getEntry()"><CODE>getEntry</CODE></A> 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 and 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> whose
+         transition triggered this event</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="isVisibilityTransition()"><!-- --></A><H3>
+isVisibilityTransition</H3>
+<PRE>
+public boolean <B>isVisibilityTransition</B>()</PRE>
+<DL>
+<DD>Returns <code>true</code> if the transition that triggered
+ this event was a transition 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)"><em>invisible to
+ visible</em></A> as well as a transition from unavailable to
+ available, and <code>false</code> otherwise. <p>
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD><code>true</code> if the transition that triggered
+ this event was a transition from invisible to visible as
+ well as a transition from unavailable to available, and
+ <code>false</code> otherwise</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>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/AvailabilityEvent.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
+  </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+&nbsp;PREV CLASS&nbsp;
+&nbsp;<A HREF="../../../net/jini/space/InternalSpaceException.html" title="class 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/AvailabilityEvent.html" target="_top"><B>FRAMES</B></A>  &nbsp;
+&nbsp;<A HREF="AvailabilityEvent.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
+&nbsp;<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:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#fields_inherited_from_class_net.jini.core.event.RemoteEvent">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<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/space/InternalSpaceException.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/net/jini/space/InternalSpaceException.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/net/jini/space/InternalSpaceException.html Fri Dec 24 20:35:29 2010
@@ -0,0 +1,400 @@
+<!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>
+InternalSpaceException (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.space.InternalSpaceException class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+    parent.document.title="InternalSpaceException (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>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/InternalSpaceException.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
+  </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+&nbsp;<A HREF="../../../net/jini/space/AvailabilityEvent.html" title="class in net.jini.space"><B>PREV CLASS</B></A>&nbsp;
+&nbsp;<A HREF="../../../net/jini/space/JavaSpace.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/InternalSpaceException.html" target="_top"><B>FRAMES</B></A>  &nbsp;
+&nbsp;<A HREF="InternalSpaceException.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
+&nbsp;<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:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<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>
+Class InternalSpaceException</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 "><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/RuntimeException.html" title="class or interface in java.lang">java.lang.RuntimeException</A>
+              <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>net.jini.space.InternalSpaceException</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>InternalSpaceException</B><DT>extends <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/RuntimeException.html" title="class or interface in java.lang">RuntimeException</A></DL>
+</PRE>
+
+<P>
+This exception denotes a problem with the local implementation of the
+ <code>JavaSpace</code> interface.  The <code>detail</code> field
+ will give a description that can be reported to the space developer
+ (and may be documented in that space's external documentation).
+<P>
+
+<P>
+<DL>
+<DT><B>Author:</B></DT>
+  <DD>Sun Microsystems, Inc.</DD>
+<DT><B>See Also:</B><DD><A HREF="../../../net/jini/space/JavaSpace.html" title="interface in net.jini.space"><CODE>JavaSpace</CODE></A>, 
+<A HREF="../../../serialized-form.html#net.jini.space.InternalSpaceException">Serialized Form</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>&nbsp;<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/space/InternalSpaceException.html#nestedException">nestedException</A></B></CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The exception (if any) that triggered the internal exception.</TD>
+</TR>
+</TABLE>
+&nbsp;
+<!-- ======== 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/space/InternalSpaceException.html#InternalSpaceException(java.lang.String)">InternalSpaceException</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>&nbsp;str)</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create an exception, forwarding a string to the superclass constructor.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../net/jini/space/InternalSpaceException.html#InternalSpaceException(java.lang.String, java.lang.Throwable)">InternalSpaceException</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>&nbsp;str,
+                       <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>&nbsp;ex)</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create an exception, forwarding a string and exception to the
+ superclass constructor.</TD>
+</TR>
+</TABLE>
+&nbsp;
+<!-- ========== 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>&nbsp;void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/space/InternalSpaceException.html#printStackTrace()">printStackTrace</A></B>()</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print the stack trace of this exception, plus that of the nested
+ exception, if any.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>&nbsp;void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/space/InternalSpaceException.html#printStackTrace(java.io.PrintStream)">printStackTrace</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/PrintStream.html" title="class or interface in java.io">PrintStream</A>&nbsp;out)</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print the stack trace of this exception, plus that of the nested
+ exception, if any.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>&nbsp;void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/space/InternalSpaceException.html#printStackTrace(java.io.PrintWriter)">printStackTrace</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/PrintWriter.html" title="class or interface in java.io">PrintWriter</A>&nbsp;out)</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print the stack trace of this exception, plus that of the nested
+ exception, if any.</TD>
+</TR>
+</TABLE>
+&nbsp;<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#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>
+&nbsp;<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>
+&nbsp;
+<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="nestedException"><!-- --></A><H3>
+nestedException</H3>
+<PRE>
+public final <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>nestedException</B></PRE>
+<DL>
+<DD>The exception (if any) that triggered the internal exception.  This
+ may be <code>null</code>.
+<P>
+<DL>
+</DL>
+</DL>
+
+<!-- ========= 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="InternalSpaceException(java.lang.String)"><!-- --></A><H3>
+InternalSpaceException</H3>
+<PRE>
+public <B>InternalSpaceException</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>&nbsp;str)</PRE>
+<DL>
+<DD>Create an exception, forwarding a string to the superclass constructor.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>str</CODE> - a detail message</DL>
+</DL>
+<HR>
+
+<A NAME="InternalSpaceException(java.lang.String, java.lang.Throwable)"><!-- --></A><H3>
+InternalSpaceException</H3>
+<PRE>
+public <B>InternalSpaceException</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>&nbsp;str,
+                              <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>&nbsp;ex)</PRE>
+<DL>
+<DD>Create an exception, forwarding a string and exception to the
+ superclass constructor.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>str</CODE> - a detail message<DD><CODE>ex</CODE> - a nested exception</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="printStackTrace()"><!-- --></A><H3>
+printStackTrace</H3>
+<PRE>
+public void <B>printStackTrace</B>()</PRE>
+<DL>
+<DD>Print the stack trace of this exception, plus that of the nested
+ exception, if any.
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#printStackTrace()" title="class or interface in java.lang">printStackTrace</A></CODE> in class <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></DL>
+</DD>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="printStackTrace(java.io.PrintStream)"><!-- --></A><H3>
+printStackTrace</H3>
+<PRE>
+public void <B>printStackTrace</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/PrintStream.html" title="class or interface in java.io">PrintStream</A>&nbsp;out)</PRE>
+<DL>
+<DD>Print the stack trace of this exception, plus that of the nested
+ exception, if any.
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><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></CODE> in class <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></DL>
+</DD>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="printStackTrace(java.io.PrintWriter)"><!-- --></A><H3>
+printStackTrace</H3>
+<PRE>
+public void <B>printStackTrace</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/PrintWriter.html" title="class or interface in java.io">PrintWriter</A>&nbsp;out)</PRE>
+<DL>
+<DD>Print the stack trace of this exception, plus that of the nested
+ exception, if any.
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><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></CODE> in class <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></DL>
+</DD>
+<DD><DL>
+</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>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/InternalSpaceException.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
+  </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+&nbsp;<A HREF="../../../net/jini/space/AvailabilityEvent.html" title="class in net.jini.space"><B>PREV CLASS</B></A>&nbsp;
+&nbsp;<A HREF="../../../net/jini/space/JavaSpace.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/InternalSpaceException.html" target="_top"><B>FRAMES</B></A>  &nbsp;
+&nbsp;<A HREF="InternalSpaceException.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
+&nbsp;<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:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<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/space/JavaSpace.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/net/jini/space/JavaSpace.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/net/jini/space/JavaSpace.html Fri Dec 24 20:35:29 2010
@@ -0,0 +1,577 @@
+<!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>
+JavaSpace (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.space.JavaSpace interface">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+    parent.document.title="JavaSpace (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>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/JavaSpace.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
+  </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+&nbsp;<A HREF="../../../net/jini/space/InternalSpaceException.html" title="class in net.jini.space"><B>PREV CLASS</B></A>&nbsp;
+&nbsp;<A HREF="../../../net/jini/space/JavaSpace05.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/JavaSpace.html" target="_top"><B>FRAMES</B></A>  &nbsp;
+&nbsp;<A HREF="JavaSpace.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
+&nbsp;<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:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<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 JavaSpace</H2>
+<DL>
+<DT><B>All Known Subinterfaces:</B> <DD><A HREF="../../../net/jini/space/JavaSpace05.html" title="interface in net.jini.space">JavaSpace05</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public interface <B>JavaSpace</B></DL>
+</PRE>
+
+<P>
+This interface is implemented by servers that export a
+ JavaSpaces technology service.  The operations in this interface
+ are the public methods that all such spaces support.
+<P>
+
+<P>
+<DL>
+<DT><B>Author:</B></DT>
+  <DD>Sun Microsystems, Inc.</DD>
+<DT><B>See Also:</B><DD><A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry"><CODE>Entry</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&nbsp;long</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/space/JavaSpace.html#NO_WAIT">NO_WAIT</A></B></CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Wait for no time at all.</TD>
+</TR>
+</TABLE>
+&nbsp;
+<!-- ========== 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>&nbsp;<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/JavaSpace.html#notify(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, net.jini.core.event.RemoteEventListener, long, java.rmi.MarshalledObject)">notify</A></B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;tmpl,
+       <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A>&nbsp;txn,
+       <A HREF="../../../net/jini/core/event/RemoteEventListener.html" title="interface in net.jini.core.event">RemoteEventListener</A>&nbsp;listener,
+       long&nbsp;lease,
+       <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>&nbsp;handback)</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;When entries are written that match this template notify the
+ given <code>listener</code> with a <code>RemoteEvent</code> that
+ includes the <code>handback</code> object.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>&nbsp;<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/JavaSpace.html#read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)">read</A></B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;tmpl,
+     <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A>&nbsp;txn,
+     long&nbsp;timeout)</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Read any matching entry from the space, blocking until one exists.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>&nbsp;<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/JavaSpace.html#readIfExists(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)">readIfExists</A></B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;tmpl,
+             <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A>&nbsp;txn,
+             long&nbsp;timeout)</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Read any matching entry from the space, returning
+ <code>null</code> if there is currently is none.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>&nbsp;<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/JavaSpace.html#snapshot(net.jini.core.entry.Entry)">snapshot</A></B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;e)</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The process of serializing an entry for transmission to a JavaSpaces
+ service will be identical if the same entry is used twice.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>&nbsp;<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/JavaSpace.html#take(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)">take</A></B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;tmpl,
+     <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A>&nbsp;txn,
+     long&nbsp;timeout)</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Take a matching entry from the space, waiting until one exists.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>&nbsp;<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/JavaSpace.html#takeIfExists(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)">takeIfExists</A></B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;tmpl,
+             <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A>&nbsp;txn,
+             long&nbsp;timeout)</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Take a matching entry from the space, returning
+ <code>null</code> if there is currently is none.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>&nbsp;<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/JavaSpace.html#write(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)">write</A></B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;entry,
+      <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A>&nbsp;txn,
+      long&nbsp;lease)</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Write a new entry into the space.</TD>
+</TR>
+</TABLE>
+&nbsp;
+<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="NO_WAIT"><!-- --></A><H3>
+NO_WAIT</H3>
+<PRE>
+static final long <B>NO_WAIT</B></PRE>
+<DL>
+<DD>Wait for no time at all.  This is used as a timeout value in
+ various read and take calls.
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../net/jini/space/JavaSpace.html#read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)</CODE></A>, 
+<A HREF="../../../net/jini/space/JavaSpace.html#readIfExists(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>readIfExists(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)</CODE></A>, 
+<A HREF="../../../net/jini/space/JavaSpace.html#take(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>take(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)</CODE></A>, 
+<A HREF="../../../net/jini/space/JavaSpace.html#takeIfExists(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>takeIfExists(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)</CODE></A>, 
+<A HREF="../../../constant-values.html#net.jini.space.JavaSpace.NO_WAIT">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="write(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><!-- --></A><H3>
+write</H3>
+<PRE>
+<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A> <B>write</B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;entry,
+            <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A>&nbsp;txn,
+            long&nbsp;lease)
+            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>Write a new entry into the space.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>entry</CODE> - the entry to write<DD><CODE>txn</CODE> - the transaction object, if any, under which to 
+            perform the write<DD><CODE>lease</CODE> - the requested lease time, in milliseconds
+<DT><B>Returns:</B><DD>a lease for the entry that was written to the space
+<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 a transaction error occurs
+<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</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><!-- --></A><H3>
+read</H3>
+<PRE>
+<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A> <B>read</B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;tmpl,
+           <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A>&nbsp;txn,
+           long&nbsp;timeout)
+           throws <A HREF="../../../net/jini/core/entry/UnusableEntryException.html" title="class in net.jini.core.entry">UnusableEntryException</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/lang/InterruptedException.html" title="class or interface in java.lang">InterruptedException</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>Read any matching entry from the space, blocking until one exists.
+ Return <code>null</code> if the timeout expires.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>tmpl</CODE> - The template used for matching.  Matching is
+                        done against <code>tmpl</code> with <code>null</code>
+                        fields being wildcards ("match anything") other
+                        fields being values ("match exactly on the
+                        serialized form").<DD><CODE>txn</CODE> - The transaction (if any) under which to work.<DD><CODE>timeout</CODE> - How long the client is willing to wait for a
+                        transactionally proper matching entry.  A
+                        timeout of <code>NO_WAIT</code> means to wait
+                        no time at all; this is equivalent to a wait
+                        of zero.
+<DT><B>Returns:</B><DD>a copy of the entry read from the space
+<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 any serialized field of the entry 
+         being read cannot be deserialized for any reason
+<DD><CODE><A HREF="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction">TransactionException</A></CODE> - if a transaction error occurs
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/InterruptedException.html" title="class or interface in java.lang">InterruptedException</A></CODE> - if the thread in which the read
+         occurs is interrupted
+<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 a negative timeout value is used</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="readIfExists(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><!-- --></A><H3>
+readIfExists</H3>
+<PRE>
+<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A> <B>readIfExists</B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;tmpl,
+                   <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A>&nbsp;txn,
+                   long&nbsp;timeout)
+                   throws <A HREF="../../../net/jini/core/entry/UnusableEntryException.html" title="class in net.jini.core.entry">UnusableEntryException</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/lang/InterruptedException.html" title="class or interface in java.lang">InterruptedException</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>Read any matching entry from the space, returning
+ <code>null</code> if there is currently is none.  Matching and
+ timeouts are done as in <code>read</code>, except that blocking
+ in this call is done only if necessary to wait for transactional
+ state to settle.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>tmpl</CODE> - The template used for matching.  Matching is
+                        done against <code>tmpl</code> with <code>null</code>
+                        fields being wildcards ("match anything") other
+                        fields being values ("match exactly on the
+                        serialized form").<DD><CODE>txn</CODE> - The transaction (if any) under which to work.<DD><CODE>timeout</CODE> - How long the client is willing to wait for a
+                        transactionally proper matching entry.  A
+                        timeout of <code>NO_WAIT</code> means to wait
+                        no time at all; this is equivalent to a wait
+                        of zero.
+<DT><B>Returns:</B><DD>a copy of the entry read from the space
+<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 any serialized field of the entry 
+         being read cannot be deserialized for any reason
+<DD><CODE><A HREF="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction">TransactionException</A></CODE> - if a transaction error occurs
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/InterruptedException.html" title="class or interface in java.lang">InterruptedException</A></CODE> - if the thread in which the read
+         occurs is interrupted
+<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 a negative timeout value is used<DT><B>See Also:</B><DD><A HREF="../../../net/jini/space/JavaSpace.html#read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="take(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><!-- --></A><H3>
+take</H3>
+<PRE>
+<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A> <B>take</B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;tmpl,
+           <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A>&nbsp;txn,
+           long&nbsp;timeout)
+           throws <A HREF="../../../net/jini/core/entry/UnusableEntryException.html" title="class in net.jini.core.entry">UnusableEntryException</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/lang/InterruptedException.html" title="class or interface in java.lang">InterruptedException</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>Take a matching entry from the space, waiting until one exists.
+ Matching is and timeout done as for <code>read</code>.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>tmpl</CODE> - The template used for matching.  Matching is
+                        done against <code>tmpl</code> with <code>null</code>
+                        fields being wildcards ("match anything") other
+                        fields being values ("match exactly on the
+                        serialized form").<DD><CODE>txn</CODE> - The transaction (if any) under which to work.<DD><CODE>timeout</CODE> - How long the client is willing to wait for a
+                        transactionally proper matching entry.  A
+                        timeout of <code>NO_WAIT</code> means to wait
+                        no time at all; this is equivalent to a wait
+                        of zero.
+<DT><B>Returns:</B><DD>the entry taken from the space
+<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 any serialized field of the entry 
+         being read cannot be deserialized for any reason
+<DD><CODE><A HREF="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction">TransactionException</A></CODE> - if a transaction error occurs
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/InterruptedException.html" title="class or interface in java.lang">InterruptedException</A></CODE> - if the thread in which the take
+         occurs is interrupted
+<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 a negative timeout value is used<DT><B>See Also:</B><DD><A HREF="../../../net/jini/space/JavaSpace.html#read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="takeIfExists(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><!-- --></A><H3>
+takeIfExists</H3>
+<PRE>
+<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A> <B>takeIfExists</B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;tmpl,
+                   <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A>&nbsp;txn,
+                   long&nbsp;timeout)
+                   throws <A HREF="../../../net/jini/core/entry/UnusableEntryException.html" title="class in net.jini.core.entry">UnusableEntryException</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/lang/InterruptedException.html" title="class or interface in java.lang">InterruptedException</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>Take a matching entry from the space, returning
+ <code>null</code> if there is currently is none.  Matching is
+ and timeout done as for <code>read</code>, except that blocking
+ in this call is done only if necessary to wait for transactional
+ state to settle.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>tmpl</CODE> - The template used for matching.  Matching is
+                        done against <code>tmpl</code> with <code>null</code>
+                        fields being wildcards ("match anything") other
+                        fields being values ("match exactly on the
+                        serialized form").<DD><CODE>txn</CODE> - The transaction (if any) under which to work.<DD><CODE>timeout</CODE> - How long the client is willing to wait for a
+                        transactionally proper matching entry.  A
+                        timeout of <code>NO_WAIT</code> means to wait
+                        no time at all; this is equivalent to a wait
+                        of zero.
+<DT><B>Returns:</B><DD>the entry taken from the space
+<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 any serialized field of the entry 
+         being read cannot be deserialized for any reason
+<DD><CODE><A HREF="../../../net/jini/core/transaction/TransactionException.html" title="class in net.jini.core.transaction">TransactionException</A></CODE> - if a transaction error occurs
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/InterruptedException.html" title="class or interface in java.lang">InterruptedException</A></CODE> - if the thread in which the take
+         occurs is interrupted
+<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 a negative timeout value is used<DT><B>See Also:</B><DD><A HREF="../../../net/jini/space/JavaSpace.html#read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="notify(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, net.jini.core.event.RemoteEventListener, long, java.rmi.MarshalledObject)"><!-- --></A><H3>
+notify</H3>
+<PRE>
+<A HREF="../../../net/jini/core/event/EventRegistration.html" title="class in net.jini.core.event">EventRegistration</A> <B>notify</B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;tmpl,
+                         <A HREF="../../../net/jini/core/transaction/Transaction.html" title="interface in net.jini.core.transaction">Transaction</A>&nbsp;txn,
+                         <A HREF="../../../net/jini/core/event/RemoteEventListener.html" title="interface in net.jini.core.event">RemoteEventListener</A>&nbsp;listener,
+                         long&nbsp;lease,
+                         <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>&nbsp;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>When entries are written that match this template notify the
+ given <code>listener</code> with a <code>RemoteEvent</code> that
+ includes the <code>handback</code> object.  Matching is done as
+ for <code>read</code>.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>tmpl</CODE> - The template used for matching.  Matching is
+                        done against <code>tmpl</code> with <code>null</code>
+                        fields being wildcards ("match anything") other
+                        fields being values ("match exactly on the
+                        serialized form").<DD><CODE>txn</CODE> - The transaction (if any) under which to work.<DD><CODE>listener</CODE> - The remote event listener to notify.<DD><CODE>lease</CODE> - the requested lease time, in milliseconds<DD><CODE>handback</CODE> - An object to send to the listener as part of the 
+                  event notification.
+<DT><B>Returns:</B><DD>the event registration to the the registrant
+<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 a transaction error occurs
+<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 the lease time requested 
+         is not Lease.ANY and is negative<DT><B>See Also:</B><DD><A HREF="../../../net/jini/space/JavaSpace.html#read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)"><CODE>read(net.jini.core.entry.Entry, net.jini.core.transaction.Transaction, long)</CODE></A>, 
+<A HREF="../../../net/jini/core/event/EventRegistration.html" title="class in net.jini.core.event"><CODE>EventRegistration</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="snapshot(net.jini.core.entry.Entry)"><!-- --></A><H3>
+snapshot</H3>
+<PRE>
+<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A> <B>snapshot</B>(<A HREF="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</A>&nbsp;e)
+               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>The process of serializing an entry for transmission to a JavaSpaces
+ service will be identical if the same entry is used twice. This is most
+ likely to be an issue with templates that are used repeatedly to search
+ for entries with <code>read</code> or <code>take</code>. The client-side 
+ implementations of <code>read</code> and <code>take</code> cannot
+ reasonably avoid this duplicated effort, since they have no efficient
+ way of checking whether the same template is being used without
+ intervening modification.
+
+ The <code>snapshot</code> method gives the JavaSpaces service implementor
+ a way to reduce the impact of repeated use of the same entry. Invoking
+ <code>snapshot</code> with an <code>Entry</code> will return another
+ <code>Entry</code> object that contains a <i>snapshot</i> of the
+ original entry. Using the returned snapshot entry is equivalent to
+ using the unmodified original entry in all operations on the same
+ JavaSpaces service. Modifications to the original entry will not
+ affect the snapshot. You can <code>snapshot</code> a <code>null</code>
+ template; <code>snapshot</code> may or may not return null given a
+ <code>null</code> template.
+
+ The entry returned from <code>snapshot</code> will be guaranteed
+ equivalent to the original unmodified object only when used with
+ the space. Using the snapshot with any other JavaSpaces service
+ will generate an <code>IllegalArgumentException</code> unless the
+ other space can use it because of knowledge about the JavaSpaces
+ service that generated the snapshot. The snapshot will be a different
+ object from the original, may or may not have the same hash code,
+ and <code>equals</code> may or may not return <code>true</code>
+ when invoked with the original object, even if the original
+ object is unmodified.
+
+ A snapshot is guaranteed to work only within the virtual machine
+ in which it was generated. If a snapshot is passed to another 
+ virtual machine (for example, in a parameter of an RMI call),
+ using it--even with the same JavaSpaces service--may generate
+ an <code>IllegalArgumentException</code>.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>e</CODE> - the entry to take a snapshot of.
+<DT><B>Returns:</B><DD>a snapshot of the entry.
+<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 error occurs</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>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/JavaSpace.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
+  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
+  </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+&nbsp;<A HREF="../../../net/jini/space/InternalSpaceException.html" title="class in net.jini.space"><B>PREV CLASS</B></A>&nbsp;
+&nbsp;<A HREF="../../../net/jini/space/JavaSpace05.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/JavaSpace.html" target="_top"><B>FRAMES</B></A>  &nbsp;
+&nbsp;<A HREF="JavaSpace.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
+&nbsp;<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:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<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>