blob: 83ce895767dcaa4fdb836c41a1cb6fe58be6456a [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (1.8.0) on Sun Aug 28 20:42:13 EST 2016 -->
<title>AvailabilityEvent (Apache River v3.0.0 API Documentation (internals))</title>
<meta name="date" content="2016-08-28">
<link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
<script type="text/javascript" src="../../../script.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="AvailabilityEvent (Apache River v3.0.0 API Documentation (internals))";
}
}
catch(err) {
}
//-->
var methods = {"i0":6,"i1":6,"i2":10,"i3":10,"i4":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/AvailabilityEvent.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../index-all.html">Index</a></li>
<li><a href="../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li>Prev&nbsp;Class</li>
<li><a href="../../../net/jini/space/InternalSpaceException.html" title="class in net.jini.space"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../index.html?net/jini/space/AvailabilityEvent.html" target="_top">Frames</a></li>
<li><a href="AvailabilityEvent.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li><a href="#field.summary">Field</a>&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li><a href="#field.detail">Field</a>&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">net.jini.space</div>
<h2 title="Class AvailabilityEvent" class="title">Class AvailabilityEvent</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="http://docs.oracle.com/javase/6/docs/api/java/util/EventObject.html?is-external=true" title="class or interface in java.util">java.util.EventObject</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../net/jini/core/event/RemoteEvent.html" title="class in net.jini.core.event">net.jini.core.event.RemoteEvent</a></li>
<li>
<ul class="inheritance">
<li>net.jini.space.AvailabilityEvent</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>All Implemented Interfaces:</dt>
<dd><a href="http://docs.oracle.com/javase/6/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</a></dd>
</dl>
<dl>
<dt>Direct Known Subclasses:</dt>
<dd><a href="../../../org/apache/river/outrigger/OutriggerAvailabilityEvent.html" title="class in org.apache.river.outrigger">OutriggerAvailabilityEvent</a></dd>
</dl>
<hr>
<br>
<pre>public abstract class <span class="typeNameLabel">AvailabilityEvent</span>
extends <a href="../../../net/jini/core/event/RemoteEvent.html" title="class in net.jini.core.event">RemoteEvent</a></pre>
<div class="block">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></div>
<dl>
<dt><span class="simpleTagLabel">Since:</span></dt>
<dd>2.1</dd>
<dt><span class="seeLabel">See Also:</span></dt>
<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></dd>
</dl>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- -->
</a>
<h3>Field Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation">
<caption><span>Fields</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>private static long</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/space/AvailabilityEvent.html#serialVersionUID">serialVersionUID</a></span></code>&nbsp;</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>private boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/space/AvailabilityEvent.html#visibilityTransition">visibilityTransition</a></span></code>
<div class="block"><code>true</code> if this event signals a
transition from invisible to visible as well
as unavailable to available.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.net.jini.core.event.RemoteEvent">
<!-- -->
</a>
<h3>Fields inherited from class&nbsp;net.jini.core.event.<a href="../../../net/jini/core/event/RemoteEvent.html" title="class in net.jini.core.event">RemoteEvent</a></h3>
<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></li>
</ul>
</li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- -->
</a>
<h3>Constructor Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Modifier</th>
<th class="colLast" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/space/AvailabilityEvent.html#AvailabilityEvent-net.jini.space.JavaSpace-long-long-java.rmi.MarshalledObject-boolean-">AvailabilityEvent</a></span>(<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://docs.oracle.com/javase/6/docs/api/java/rmi/MarshalledObject.html?is-external=true" title="class or interface in java.rmi">MarshalledObject</a>&nbsp;handback,
boolean&nbsp;visibilityTransition)</code>
<div class="block">Create a new <code>AvailabilityEvent</code> instance.</div>
</td>
</tr>
</table>
</li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code>abstract <a href="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/space/AvailabilityEvent.html#getEntry--">getEntry</a></span>()</code>
<div class="block">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.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
<td class="colFirst"><code>abstract <a href="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/space/AvailabilityEvent.html#getSnapshot--">getSnapshot</a></span>()</code>
<div class="block">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.</div>
</td>
</tr>
<tr id="i2" class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/space/AvailabilityEvent.html#isVisibilityTransition--">isVisibilityTransition</a></span>()</code>
<div class="block">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.</div>
</td>
</tr>
<tr id="i3" class="rowColor">
<td class="colFirst"><code>private void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/space/AvailabilityEvent.html#readObject-java.io.ObjectInputStream-">readObject</a></span>(<a href="http://docs.oracle.com/javase/6/docs/api/java/io/ObjectInputStream.html?is-external=true" title="class or interface in java.io">ObjectInputStream</a>&nbsp;in)</code>&nbsp;</td>
</tr>
<tr id="i4" class="altColor">
<td class="colFirst"><code>private void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/space/AvailabilityEvent.html#readObjectNoData--">readObjectNoData</a></span>()</code>&nbsp;</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.net.jini.core.event.RemoteEvent">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;net.jini.core.event.<a href="../../../net/jini/core/event/RemoteEvent.html" title="class in net.jini.core.event">RemoteEvent</a></h3>
<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>, <a href="../../../net/jini/core/event/RemoteEvent.html#getSource--">getSource</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.util.EventObject">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;java.util.<a href="http://docs.oracle.com/javase/6/docs/api/java/util/EventObject.html?is-external=true" title="class or interface in java.util">EventObject</a></h3>
<code><a href="http://docs.oracle.com/javase/6/docs/api/java/util/EventObject.html?is-external=true#toString--" title="class or interface in java.util">toString</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
<code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- -->
</a>
<h3>Field Detail</h3>
<a name="serialVersionUID">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>serialVersionUID</h4>
<pre>private static final&nbsp;long serialVersionUID</pre>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../constant-values.html#net.jini.space.AvailabilityEvent.serialVersionUID">Constant Field Values</a></dd>
</dl>
</li>
</ul>
<a name="visibilityTransition">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>visibilityTransition</h4>
<pre>private final&nbsp;boolean visibilityTransition</pre>
<div class="block"><code>true</code> if this event signals a
transition from invisible to visible as well
as unavailable to available.</div>
</li>
</ul>
</li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- -->
</a>
<h3>Constructor Detail</h3>
<a name="AvailabilityEvent-net.jini.space.JavaSpace-long-long-java.rmi.MarshalledObject-boolean-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>AvailabilityEvent</h4>
<pre>protected&nbsp;AvailabilityEvent(<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://docs.oracle.com/javase/6/docs/api/java/rmi/MarshalledObject.html?is-external=true" title="class or interface in java.rmi">MarshalledObject</a>&nbsp;handback,
boolean&nbsp;visibilityTransition)</pre>
<div class="block">Create a new <code>AvailabilityEvent</code> instance.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>source</code> - the event source</dd>
<dd><code>eventID</code> - the event identifier</dd>
<dd><code>seqNum</code> - the event sequence number</dd>
<dd><code>handback</code> - the handback object</dd>
<dd><code>visibilityTransition</code> - <code>true</code> if this event
must also signal a transition from
invisible to visible</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if <code>source</code> is
<code>null</code></dd>
</dl>
</li>
</ul>
</li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a name="readObject-java.io.ObjectInputStream-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>readObject</h4>
<pre>private&nbsp;void&nbsp;readObject(<a href="http://docs.oracle.com/javase/6/docs/api/java/io/ObjectInputStream.html?is-external=true" title="class or interface in java.io">ObjectInputStream</a>&nbsp;in)
throws <a href="http://docs.oracle.com/javase/6/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a>,
<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/ClassNotFoundException.html?is-external=true" title="class or interface in java.lang">ClassNotFoundException</a></pre>
<dl>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/io/InvalidObjectException.html?is-external=true" title="class or interface in java.io">InvalidObjectException</a></code> - if <a href="../../../net/jini/core/event/RemoteEvent.html#source"><code>RemoteEvent.source</code></a> is <code>null</code>
or is not a <a href="../../../net/jini/space/JavaSpace.html" title="interface in net.jini.space"><code>JavaSpace</code></a></dd>
<dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code></dd>
<dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/ClassNotFoundException.html?is-external=true" title="class or interface in java.lang">ClassNotFoundException</a></code></dd>
</dl>
</li>
</ul>
<a name="readObjectNoData--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>readObjectNoData</h4>
<pre>private&nbsp;void&nbsp;readObjectNoData()
throws <a href="http://docs.oracle.com/javase/6/docs/api/java/io/InvalidObjectException.html?is-external=true" title="class or interface in java.io">InvalidObjectException</a></pre>
<dl>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/io/InvalidObjectException.html?is-external=true" title="class or interface in java.io">InvalidObjectException</a></code> - if called</dd>
</dl>
</li>
</ul>
<a name="getEntry--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getEntry</h4>
<pre>public abstract&nbsp;<a href="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</a>&nbsp;getEntry()
throws <a href="../../../net/jini/core/entry/UnusableEntryException.html" title="class in net.jini.core.entry">UnusableEntryException</a></pre>
<div class="block">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>.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<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</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<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></dd>
</dl>
</li>
</ul>
<a name="getSnapshot--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getSnapshot</h4>
<pre>public abstract&nbsp;<a href="../../../net/jini/core/entry/Entry.html" title="interface in net.jini.core.entry">Entry</a>&nbsp;getSnapshot()</pre>
<div class="block">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></div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<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</dd>
</dl>
</li>
</ul>
<a name="isVisibilityTransition--">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>isVisibilityTransition</h4>
<pre>public&nbsp;boolean&nbsp;isVisibilityTransition()</pre>
<div class="block">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></div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<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</dd>
</dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar.bottom">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/AvailabilityEvent.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../index-all.html">Index</a></li>
<li><a href="../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li>Prev&nbsp;Class</li>
<li><a href="../../../net/jini/space/InternalSpaceException.html" title="class in net.jini.space"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../index.html?net/jini/space/AvailabilityEvent.html" target="_top">Frames</a></li>
<li><a href="AvailabilityEvent.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li><a href="#field.summary">Field</a>&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li><a href="#field.detail">Field</a>&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small>Copyright 2007-2013, 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.</small></p>
</body>
</html>