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:32:24 UTC
svn commit: r781470 [6/11] -
/websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/
Added: websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/BasicJeriTrustVerifier.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/BasicJeriTrustVerifier.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/BasicJeriTrustVerifier.html Fri Dec 24 20:32:23 2010
@@ -0,0 +1,599 @@
+<!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:19 EST 2010 -->
+<TITLE>
+BasicJeriTrustVerifier (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.jeri.BasicJeriTrustVerifier class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="BasicJeriTrustVerifier (Apache River v2.1.2-SNAPSHOT API Documentation)";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/BasicJeriTrustVerifier.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../net/jini/jeri/BasicJeriExporter.html" title="class in net.jini.jeri"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html" title="class in net.jini.jeri"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/jeri/BasicJeriTrustVerifier.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="BasicJeriTrustVerifier.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+net.jini.jeri</FONT>
+<BR>
+Class BasicJeriTrustVerifier</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 "><B>net.jini.jeri.BasicJeriTrustVerifier</B>
+</PRE>
+<DL>
+<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../net/jini/security/TrustVerifier.html" title="interface in net.jini.security">TrustVerifier</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public class <B>BasicJeriTrustVerifier</B><DT>extends <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><DT>implements <A HREF="../../../net/jini/security/TrustVerifier.html" title="interface in net.jini.security">TrustVerifier</A></DL>
+</PRE>
+
+<P>
+Trust verifier for dynamic proxies and object endpoints used in Jini
+ extensible remote invocation (Jini ERI). This class is intended to be
+ specified in a resource to configure the operation of <A HREF="../../../net/jini/security/Security.html#verifyObjectTrust(java.lang.Object, java.lang.ClassLoader, java.util.Collection)"><CODE>Security.verifyObjectTrust</CODE></A>.
+<P>
+
+<P>
+<DL>
+<DT><B>Since:</B></DT>
+ <DD>2.0</DD>
+<DT><B>Author:</B></DT>
+ <DD>Sun Microsystems, Inc.</DD>
+</DL>
+<HR>
+
+<P>
+<!-- ======== NESTED CLASS SUMMARY ======== -->
+
+<A NAME="nested_class_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>Nested Class Summary</B></FONT></TH>
+</TR>
+</TABLE>
+ <A NAME="nested_classes_inherited_from_class_net.jini.security.TrustVerifier"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Nested classes/interfaces inherited from interface net.jini.security.<A HREF="../../../net/jini/security/TrustVerifier.html" title="interface in net.jini.security">TrustVerifier</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="../../../net/jini/security/TrustVerifier.Context.html" title="interface in net.jini.security">TrustVerifier.Context</A></CODE></TD>
+</TR>
+</TABLE>
+
+
+<!-- ======== 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/jeri/BasicJeriTrustVerifier.html#BasicJeriTrustVerifier()">BasicJeriTrustVerifier</A></B>()</CODE>
+
+<BR>
+ Creates an instance.</TD>
+</TR>
+</TABLE>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicJeriTrustVerifier.html#checkInvocationHandlerContent(net.jini.jeri.BasicInvocationHandler, net.jini.security.TrustVerifier.Context)">checkInvocationHandlerContent</A></B>(<A HREF="../../../net/jini/jeri/BasicInvocationHandler.html" title="class in net.jini.jeri">BasicInvocationHandler</A> handler,
+ <A HREF="../../../net/jini/security/TrustVerifier.Context.html" title="interface in net.jini.security">TrustVerifier.Context</A> ctx)</CODE>
+
+<BR>
+ Returns <code>true</code> if the specified invocation handler's
+ constraints and object endpoint are trusted; returns
+ <code>false</code> otherwise.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicJeriTrustVerifier.html#hasTrustedClassLoader(java.lang.Object, net.jini.security.TrustVerifier.Context)">hasTrustedClassLoader</A></B>(<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> proxy,
+ <A HREF="../../../net/jini/security/TrustVerifier.Context.html" title="interface in net.jini.security">TrustVerifier.Context</A> ctx)</CODE>
+
+<BR>
+ Returns <code>true</code> if the class loader of the specified dynamic
+ proxy's class is trusted by this verifier; returns <code>false</code>
+ otherwise.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicJeriTrustVerifier.html#hasTrustedProxyClass(java.lang.Object, net.jini.security.TrustVerifier.Context)">hasTrustedProxyClass</A></B>(<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> proxy,
+ <A HREF="../../../net/jini/security/TrustVerifier.Context.html" title="interface in net.jini.security">TrustVerifier.Context</A> ctx)</CODE>
+
+<BR>
+ Returns <code>true</code> if the specified dynamic proxy's class is
+ trusted by this verifier; returns <code>false</code> otherwise.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicJeriTrustVerifier.html#isTrustedInvocationHandler(java.lang.reflect.InvocationHandler, net.jini.security.TrustVerifier.Context)">isTrustedInvocationHandler</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/reflect/InvocationHandler.html" title="class or interface in java.lang.reflect">InvocationHandler</A> handler,
+ <A HREF="../../../net/jini/security/TrustVerifier.Context.html" title="interface in net.jini.security">TrustVerifier.Context</A> ctx)</CODE>
+
+<BR>
+ Returns <code>true</code> if the specified invocation
+ handler is trusted by this trust verifier; returns
+ <code>false</code> otherwise.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicJeriTrustVerifier.html#isTrustedObject(java.lang.Object, net.jini.security.TrustVerifier.Context)">isTrustedObject</A></B>(<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> obj,
+ <A HREF="../../../net/jini/security/TrustVerifier.Context.html" title="interface in net.jini.security">TrustVerifier.Context</A> ctx)</CODE>
+
+<BR>
+ Returns <code>true</code> if the specified object is a trusted
+ Jini ERI dynamic proxy or a trusted Jini ERI object endpoint;
+ returns <code>false</code> otherwise.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicJeriTrustVerifier.html#isTrustedProxyInterface(java.lang.Class, net.jini.security.TrustVerifier.Context)">isTrustedProxyInterface</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Class.html" title="class or interface in java.lang">Class</A> intf,
+ <A HREF="../../../net/jini/security/TrustVerifier.Context.html" title="interface in net.jini.security">TrustVerifier.Context</A> ctx)</CODE>
+
+<BR>
+ Returns <code>true</code> if the specified dynamic proxy interface is
+ trusted by this verifier; returns <code>false</code> otherwise.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://
java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+
+<A NAME="constructor_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Constructor Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="BasicJeriTrustVerifier()"><!-- --></A><H3>
+BasicJeriTrustVerifier</H3>
+<PRE>
+public <B>BasicJeriTrustVerifier</B>()</PRE>
+<DL>
+<DD>Creates an instance.
+<P>
+</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="isTrustedObject(java.lang.Object, net.jini.security.TrustVerifier.Context)"><!-- --></A><H3>
+isTrustedObject</H3>
+<PRE>
+public boolean <B>isTrustedObject</B>(<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> obj,
+ <A HREF="../../../net/jini/security/TrustVerifier.Context.html" title="interface in net.jini.security">TrustVerifier.Context</A> ctx)
+ 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>Returns <code>true</code> if the specified object is a trusted
+ Jini ERI dynamic proxy or a trusted Jini ERI object endpoint;
+ returns <code>false</code> otherwise.
+
+ <p>For the purposes of this verifier, the specified object is a trusted
+ Jini ERI dynamic proxy if all of the following are true:
+ <ul>
+ <li>The object is an instance of <A HREF="../../../net/jini/core/constraint/RemoteMethodControl.html" title="interface in net.jini.core.constraint"><CODE>RemoteMethodControl</CODE></A>.
+ <li>The object is an instance of a dynamic proxy class; that is, a
+ class generated by <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/reflect/Proxy.html" title="class or interface in java.lang.reflect"><CODE>Proxy</CODE></A>.
+ <li>Invoking the protected method <A HREF="../../../net/jini/jeri/BasicJeriTrustVerifier.html#hasTrustedProxyClass(java.lang.Object, net.jini.security.TrustVerifier.Context)"><CODE>hasTrustedProxyClass</CODE></A> with the specified object and the specified
+ trust verifier context returns <code>true</code>.
+ <li>Invoking the protected method <A HREF="../../../net/jini/jeri/BasicJeriTrustVerifier.html#isTrustedInvocationHandler(java.lang.reflect.InvocationHandler, net.jini.security.TrustVerifier.Context)"><CODE>isTrustedInvocationHandler</CODE></A> with the <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/reflect/InvocationHandler.html" title="class or interface in java.lang.reflect"><CODE>InvocationHandler</CODE></A> contained in the dynamic proxy and
+ the specified trust verifier context returns <code>true</code>.
+ </ul>
+
+ <p>For the purposes of this verifier, the specified object is a trusted
+ Jini ERI object endpoint if the object is an instance of
+ <A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html" title="class in net.jini.jeri"><CODE>BasicObjectEndpoint</CODE></A> and its transport endpoint is
+ trusted; that is, calling the specified context's
+ <code>isTrustedObject</code> method with the transport endpoint returns
+ <code>true</code>.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/security/TrustVerifier.html#isTrustedObject(java.lang.Object, net.jini.security.TrustVerifier.Context)">isTrustedObject</A></CODE> in interface <CODE><A HREF="../../../net/jini/security/TrustVerifier.html" title="interface in net.jini.security">TrustVerifier</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>obj</CODE> - the object in which to verify trust<DD><CODE>ctx</CODE> - the trust verifier context, to aid in verification of
+ the specified object and its components
+<DT><B>Returns:</B><DD><code>true</code> if the specified object is known to be
+ trusted to correctly implement its contract; <code>false</code>
+ otherwise
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if a security exception occurs
+<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 any argument is <code>null</code>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception occurs</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="hasTrustedProxyClass(java.lang.Object, net.jini.security.TrustVerifier.Context)"><!-- --></A><H3>
+hasTrustedProxyClass</H3>
+<PRE>
+protected boolean <B>hasTrustedProxyClass</B>(<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> proxy,
+ <A HREF="../../../net/jini/security/TrustVerifier.Context.html" title="interface in net.jini.security">TrustVerifier.Context</A> ctx)
+ 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>Returns <code>true</code> if the specified dynamic proxy's class is
+ trusted by this verifier; returns <code>false</code> otherwise. The
+ <code>isTrustedObject</code> method calls this method to verify that
+ the proxy's class is trusted.
+
+ <p><code>BasicJeriTrustVerifier</code> implements this method to
+ return <code>true</code> if all of the following are true:
+ <ul>
+ <li>The proxy is an instance of <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/Remote.html" title="class or interface in java.rmi"><CODE>Remote</CODE></A>.
+ <li>Invoking the protected method <A HREF="../../../net/jini/jeri/BasicJeriTrustVerifier.html#hasTrustedClassLoader(java.lang.Object, net.jini.security.TrustVerifier.Context)"><CODE>hasTrustedClassLoader</CODE></A> with the specified proxy and the specified
+ trust verifier context returns <code>true</code>.
+ <li>For each direct superinterface of the proxy's class, invoking
+ the protected method <A HREF="../../../net/jini/jeri/BasicJeriTrustVerifier.html#isTrustedProxyInterface(java.lang.Class, net.jini.security.TrustVerifier.Context)"><CODE>isTrustedProxyInterface</CODE></A> with the interface and the specified trust
+ verifier context returns <code>true</code>.
+ </ul>
+
+ <p>A subclass can override this method to augment the set of trusted
+ proxy classes for Jini ERI proxies.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>proxy</CODE> - the dynamic proxy<DD><CODE>ctx</CODE> - the trust verifier context, to aid in verification of
+ the specified proxy's class
+<DT><B>Returns:</B><DD><code>true</code> if the specified dynamic proxy's class is
+ trusted by this verifier; returns <code>false</code> otherwise
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception occurs
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if a security exception occurs
+<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 any argument is <code>null</code><DT><B>Since:</B></DT>
+ <DD>2.1</DD>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="hasTrustedClassLoader(java.lang.Object, net.jini.security.TrustVerifier.Context)"><!-- --></A><H3>
+hasTrustedClassLoader</H3>
+<PRE>
+protected boolean <B>hasTrustedClassLoader</B>(<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> proxy,
+ <A HREF="../../../net/jini/security/TrustVerifier.Context.html" title="interface in net.jini.security">TrustVerifier.Context</A> ctx)
+ 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>Returns <code>true</code> if the class loader of the specified dynamic
+ proxy's class is trusted by this verifier; returns <code>false</code>
+ otherwise. The default implementation of
+ <code>hasTrustedProxyClass</code> calls this method to verify
+ that the proxy's class loader is trusted.
+
+ <p><code>BasicJeriTrustVerifier</code> implements this method to
+ return <code>true</code> if the specified proxy is an instance of a
+ dynamic proxy class and the class loader of the specified proxy's
+ class is either equal to or an ancestor of the class loader returned
+ by the trust verifier context's <A HREF="../../../net/jini/security/TrustVerifier.Context.html#getClassLoader()"><CODE>getClassLoader</CODE></A> method (or the current context class loader, if that
+ method returns <code>null</code>).
+
+ <p>A subclass can override this method to augment the set of trusted
+ loaders for Jini ERI proxies.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>proxy</CODE> - the dynamic proxy<DD><CODE>ctx</CODE> - the trust verifier context, to aid in verification of
+ the class loader of the specified proxy's class
+<DT><B>Returns:</B><DD><code>true</code> if the class loader of the specified dynamic
+ proxy's class is trusted by this verifier; returns <code>false</code>
+ otherwise
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception occurs
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if a security exception 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 proxy is not an
+ instance of a dynamic proxy class
+<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 any argument is <code>null</code><DT><B>Since:</B></DT>
+ <DD>2.1</DD>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="isTrustedProxyInterface(java.lang.Class, net.jini.security.TrustVerifier.Context)"><!-- --></A><H3>
+isTrustedProxyInterface</H3>
+<PRE>
+protected boolean <B>isTrustedProxyInterface</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Class.html" title="class or interface in java.lang">Class</A> intf,
+ <A HREF="../../../net/jini/security/TrustVerifier.Context.html" title="interface in net.jini.security">TrustVerifier.Context</A> ctx)
+ 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>Returns <code>true</code> if the specified dynamic proxy interface is
+ trusted by this verifier; returns <code>false</code> otherwise. The
+ default implementation of <code>hasTrustedProxyClass</code> calls
+ this method to verify that the dynamic proxy's interfaces are trusted.
+
+ <p><code>BasicJeriTrustVerifier</code> implements this method to
+ return <code>true</code> if the specified class is
+ <A HREF="../../../net/jini/core/constraint/RemoteMethodControl.html" title="interface in net.jini.core.constraint"><CODE>RemoteMethodControl</CODE></A>, <A HREF="../../../net/jini/security/proxytrust/TrustEquivalence.html" title="interface in net.jini.security.proxytrust"><CODE>TrustEquivalence</CODE></A>, or a
+ well-formed remote interface (one that extends <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/Remote.html" title="class or interface in java.rmi"><CODE>Remote</CODE></A> and for
+ which all methods declare <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi"><CODE>RemoteException</CODE></A> or a superclass in
+ their <code>throws</code> clause).
+
+ <p>A subclass can override this method to augment the set of trusted
+ proxy interfaces for Jini ERI proxies.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>intf</CODE> - the dynamic proxy interface<DD><CODE>ctx</CODE> - the trust verifier context, to aid in verification of
+ the specified proxy interface
+<DT><B>Returns:</B><DD><code>true</code> if the specified dynamic proxy interface is
+ trusted by this verifier; returns <code>false</code> otherwise
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception occurs
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if a security exception occurs
+<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 any argument is <code>null</code><DT><B>Since:</B></DT>
+ <DD>2.1</DD>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="isTrustedInvocationHandler(java.lang.reflect.InvocationHandler, net.jini.security.TrustVerifier.Context)"><!-- --></A><H3>
+isTrustedInvocationHandler</H3>
+<PRE>
+protected boolean <B>isTrustedInvocationHandler</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/reflect/InvocationHandler.html" title="class or interface in java.lang.reflect">InvocationHandler</A> handler,
+ <A HREF="../../../net/jini/security/TrustVerifier.Context.html" title="interface in net.jini.security">TrustVerifier.Context</A> ctx)
+ 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>Returns <code>true</code> if the specified invocation
+ handler is trusted by this trust verifier; returns
+ <code>false</code> otherwise. The <code>isTrustedObject</code>
+ method calls this method to verify trust in the invocation handler.
+
+ <p><code>BasicJeriTrustVerifier</code> implements this method to
+ return <code>true</code> if all of the following are true:
+ <ul>
+ <li>The specified invocation handler's class is equal to
+ <code>BasicInvocationHandler</code>.
+ <li>Invoking the <A HREF="../../../net/jini/jeri/BasicJeriTrustVerifier.html#checkInvocationHandlerContent(net.jini.jeri.BasicInvocationHandler, net.jini.security.TrustVerifier.Context)"><CODE>checkInvocationHandlerContent</CODE></A> method with the specified handler
+ and the specified context returns <code>true</code>.
+ </ul>
+
+ <p>A subclass can override this method to verify that the invocation
+ handler's class is a trusted subclass of
+ <code>BasicInvocationHandler</code> and to verify the contents of
+ the invocation handler. A subclass implementation of this method
+ can invoke the <code>checkInvocationHandlerContent</code> static
+ utility method to verify that the invocation handler's constraints
+ and object endpoint are trusted.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>handler</CODE> - the invocation handler<DD><CODE>ctx</CODE> - the trust verifier context, to aid in verification of
+ the specified handler
+<DT><B>Returns:</B><DD><code>true</code> if the specified invocation
+ handler is trusted by this trust verifier; returns
+ <code>false</code> otherwise
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception occurs
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if a security exception occurs
+<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 any argument is <code>null</code><DT><B>Since:</B></DT>
+ <DD>2.1</DD>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="checkInvocationHandlerContent(net.jini.jeri.BasicInvocationHandler, net.jini.security.TrustVerifier.Context)"><!-- --></A><H3>
+checkInvocationHandlerContent</H3>
+<PRE>
+protected static boolean <B>checkInvocationHandlerContent</B>(<A HREF="../../../net/jini/jeri/BasicInvocationHandler.html" title="class in net.jini.jeri">BasicInvocationHandler</A> handler,
+ <A HREF="../../../net/jini/security/TrustVerifier.Context.html" title="interface in net.jini.security">TrustVerifier.Context</A> ctx)
+ 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>Returns <code>true</code> if the specified invocation handler's
+ constraints and object endpoint are trusted; returns
+ <code>false</code> otherwise. The
+ <code>isTrustedInvocationHandler</code> method calls this utility
+ method to check that the invocation handler's constraints and object
+ endpoint are trusted.
+
+ <p>The specified invocation handler's constraints and object
+ endpoint are trusted if all of the following are true:
+ <ul>
+ <li>The object endpoint in the specified invocation handler is
+ trusted; that is, calling the specified context's
+ <A HREF="../../../net/jini/security/TrustVerifier.Context.html#isTrustedObject(java.lang.Object)"><CODE>isTrustedObject</CODE></A> method with the object endpoint returns
+ <code>true</code>.
+ <li>The server constraints in the specified invocation handler are
+ trusted; that is, calling the specified context's
+ <code>isTrustedObject</code> method with the server constraints
+ returns <code>true</code>.
+ </ul>
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>handler</CODE> - the invocation handler<DD><CODE>ctx</CODE> - the trust verifier context, to aid in verification of
+ the specified handler
+<DT><B>Returns:</B><DD><code>true</code> if the specified invocation
+ handler's constraints and object endpoint are trusted by this method;
+ returns <code>false</code> otherwise
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception occurs
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if a security exception occurs
+<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 any argument is <code>null</code><DT><B>Since:</B></DT>
+ <DD>2.1</DD>
+</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/BasicJeriTrustVerifier.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../net/jini/jeri/BasicJeriExporter.html" title="class in net.jini.jeri"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html" title="class in net.jini.jeri"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/jeri/BasicJeriTrustVerifier.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="BasicJeriTrustVerifier.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright 2007, multiple authors.<br>Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="child" >Apache License, Version 2.0</a>, see the <a href="../../../doc-files/NOTICE" target="child" >NOTICE</a> file for attributions.
+</BODY>
+</HTML>
Added: websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/BasicObjectEndpoint.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/BasicObjectEndpoint.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/BasicObjectEndpoint.html Fri Dec 24 20:32:23 2010
@@ -0,0 +1,806 @@
+<!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:19 EST 2010 -->
+<TITLE>
+BasicObjectEndpoint (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.jeri.BasicObjectEndpoint class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="BasicObjectEndpoint (Apache River v2.1.2-SNAPSHOT API Documentation)";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/BasicObjectEndpoint.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../net/jini/jeri/BasicJeriTrustVerifier.html" title="class in net.jini.jeri"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/jeri/Endpoint.html" title="interface in net.jini.jeri"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/jeri/BasicObjectEndpoint.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="BasicObjectEndpoint.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+net.jini.jeri</FONT>
+<BR>
+Class BasicObjectEndpoint</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 "><B>net.jini.jeri.BasicObjectEndpoint</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>, <A HREF="../../../net/jini/jeri/ObjectEndpoint.html" title="interface in net.jini.jeri">ObjectEndpoint</A>, <A HREF="../../../net/jini/security/proxytrust/TrustEquivalence.html" title="interface in net.jini.security.proxytrust">TrustEquivalence</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public final class <B>BasicObjectEndpoint</B><DT>extends <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><DT>implements <A HREF="../../../net/jini/jeri/ObjectEndpoint.html" title="interface in net.jini.jeri">ObjectEndpoint</A>, <A HREF="../../../net/jini/security/proxytrust/TrustEquivalence.html" title="interface in net.jini.security.proxytrust">TrustEquivalence</A>, <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></DL>
+</PRE>
+
+<P>
+References a remote object with an <A HREF="../../../net/jini/jeri/Endpoint.html" title="interface in net.jini.jeri"><CODE>Endpoint</CODE></A> for
+ sending requests to the object and a <A HREF="../../../net/jini/id/Uuid.html" title="class in net.jini.id"><CODE>Uuid</CODE></A> to identify
+ the object at that <code>Endpoint</code>.
+
+ <p>In addition to the <code>Endpoint</code> and the
+ <code>Uuid</code>, <code>BasicObjectEndpoint</code> instances also
+ contain a flag indicating whether or not the instance participates
+ in distributed garbage collection (DGC).
+
+ <p>The <A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html#newCall(net.jini.core.constraint.InvocationConstraints)"><CODE>newCall</CODE></A> method can be used to send a
+ request to the remote object that this object references.
+
+ <h4>Distributed Garbage Collection</h4>
+
+ The <code>BasicObjectEndpoint</code> class acts as the <i>DGC
+ client</i> for all of its instances that participate in DGC (which
+ are called live remote references). That is, it tracks the
+ existence and reachability of live remote references and makes
+ <i>dirty calls</i> and <i>clean calls</i> to the associated
+ server-side DGC implementations, as described below.
+
+ <p>The server-side behavior of dirty and clean calls is specified
+ by <A HREF="../../../net/jini/jeri/BasicJeriExporter.html" title="class in net.jini.jeri"><CODE>BasicJeriExporter</CODE></A>. When the DGC client makes a dirty or
+ clean call to a given <code>Endpoint</code>, the behavior is
+ effectively that of using a <code>BasicObjectEndpoint</code>
+ containing that <code>Endpoint</code> and the object identifier
+ <code>d32cd1bc-273c-11b2-8841-080020c9e4a1</code> (and that doesn't
+ itself participate in DGC), wrapped in a <A HREF="../../../net/jini/jeri/BasicInvocationHandler.html" title="class in net.jini.jeri"><CODE>BasicInvocationHandler</CODE></A> with no client or server
+ constraints, wrapped in an instance of a dynamic proxy class that
+ implements an interface with the following remote methods:
+
+ <pre>
+ long dirty(Uuid clientID, long sequenceNum, Uuid[] ids)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi"><CODE>RemoteException</CODE></A>;
+
+ void clean(Uuid clientID, long sequenceNum, Uuid[] ids, boolean strong)
+ throws RemoteException;
+ </pre>
+
+ <code>clientID</code> is the DGC client's universally unique
+ identifier, which is generated using <A HREF="../../../net/jini/id/UuidFactory.html#generate()"><CODE>UuidFactory.generate</CODE></A>. <code>sequenceNum</code> identifies the
+ sequence number of the dirty or clean call with respect to all
+ other dirty and clean calls made by the same DGC client (regardless
+ of the <code>Endpoint</code> that the calls are made to). All
+ dirty and clean calls made by a DGC client must have a unique
+ sequence number that monotonically increases with the temporal
+ order of the states (of reachable live remote references) that the
+ calls assert. A dirty call asserts that live remote references
+ with the called <code>Endpoint</code> and each of the object
+ identifiers in <code>ids</code> exist for the identified DGC
+ client. A clean call asserts that there are no (longer) live
+ remote references with the called <code>Endpoint</code> and each of
+ the object identifiers in <code>ids</code> for the identified DGC
+ client.
+
+ <p>The tracked live remote references are categorized by their
+ <code>Endpoint</code> and further categorized by their object
+ identifier (with the <code>Endpoint</code> and object identifier
+ pair identifying a remote object). When a new live remote
+ reference is created, either by construction or deserialization, it
+ is remembered among the live remote references with the same
+ <code>Endpoint</code> and object identifier, and its reachability
+ is tracked with a phantom reference. If there is not already a
+ live remote reference with the same <code>Endpoint</code> and
+ object identifier, the DGC client makes a dirty call to the
+ server-side DGC implementation at that <code>Endpoint</code>, with
+ that object identifier in the <code>ids</code> argument. Dirty
+ calls for multiple newly created live remote references with the
+ same <code>Endpoint</code> may be batched as one dirty call (such
+ as for multiple live remote references deserialized from the same
+ stream).
+
+ <p>Each successful dirty call establishes or renews a lease for the
+ DGC client with the server-side DGC implementation at the
+ <code>Endpoint</code> that the dirty call was made to. The
+ duration of the lease granted by the server is conveyed as the
+ return value of the dirty call, in milliseconds starting from some
+ time during the processing of the dirty call. While there are live
+ remote references with a given <code>Endpoint</code>, the DGC
+ client attempts to maintain a valid lease with that
+ <code>Endpoint</code> by renewing its lease with successive dirty
+ calls. The DGC client should take into consideration network and
+ processing latencies of the previous dirty call and the next
+ required dirty call in choosing when to renew a lease. If the DGC
+ client has reason to assume that its lease with a given
+ <code>Endpoint</code> might have expired, then in subsequent dirty
+ calls to that <code>Endpoint</code>, it should include the object
+ identifiers of all currently reachable live remote references with
+ that <code>Endpoint</code>. If a dirty call returns a negative
+ lease duration or throws a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/NoSuchObjectException.html" title="class or interface in java.rmi"><CODE>NoSuchObjectException</CODE></A>, the DGC
+ client should refrain from making further dirty calls to the same
+ <code>Endpoint</code> until a new live remote reference with that
+ <code>Endpoint</code> is created.
+
+ <p>If a dirty call fails with a communication exception other than
+ a <code>NoSuchObjectException</code>, the DGC client implementation
+ should make a reasonable effort to retry the dirty call (in a
+ network-friendly manner). Also, after such a failed dirty call for
+ a given <code>Endpoint</code> and object identifier, any clean call
+ that is made for that same <code>Endpoint</code> and object
+ identifier within a reasonable amount of time should pass
+ <code>true</code> for the <code>strong</code> argument, in case the
+ failed dirty call does eventually get delivered to the server after
+ such a clean call has been processed.
+
+ <p>When the last remaining live remote reference with a given
+ <code>Endpoint</code> and object identifier is detected to be
+ phantom reachable, the DGC client makes a clean call to the
+ server-side DGC implementation at that <code>Endpoint</code>, with
+ that object identifier in the <code>ids</code> argument. Clean
+ calls for several object identifiers at the same
+ <code>Endpoint</code> may be batched as one clean call (such as
+ when multiple live remote references with the same
+ <code>Endpoint</code> and different object identifiers are detected
+ to be phantom reachable at the same time).
+
+ <p>If a clean call fails with a communication exception other than
+ a <code>NoSuchObjectException</code>, the DGC client implementation
+ should make a reasonable effort to retry the clean call, in a
+ network-friendly manner, especially while the DGC client's lease
+ for the <code>Endpoint</code> remains valid (or while dirty calls
+ for the same <code>Endpoint</code> succeed).
+<P>
+
+<P>
+<DL>
+<DT><B>Since:</B></DT>
+ <DD>2.0</DD>
+<DT><B>Author:</B></DT>
+ <DD>Sun Microsystems, Inc.</DD>
+<DT><B>See Also:</B><DD><A HREF="../../../serialized-form.html#net.jini.jeri.BasicObjectEndpoint">Serialized Form</A><DT><B>Implementation Specifics:</B></DT>
+ <DD><p>This implementation uses the <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Logger.html" title="class or interface in java.util.logging"><CODE>Logger</CODE></A> named
+ <code>net.jini.jeri.BasicObjectEndpoint</code> to log information
+ at the following levels:
+
+ <table summary="Describes what is logged by BasicObjectEndpoint at
+ various logging levels" border=1 cellpadding=5>
+
+ <tr> <th> Level <th> Description
+
+ <tr> <td> <A HREF="../../../com/sun/jini/logging/Levels.html#HANDLED"><CODE>HANDLED</CODE></A> <td> failure of DGC dirty
+ or clean call
+
+ <tr> <td> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#FINEST" title="class or interface in java.util.logging"><CODE>FINEST</CODE></A> <td> detailed implementation
+ activity
+
+ </table></DD>
+</DL>
+<HR>
+
+<P>
+
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+
+<A NAME="constructor_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Constructor Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html#BasicObjectEndpoint(net.jini.jeri.Endpoint, net.jini.id.Uuid, boolean)">BasicObjectEndpoint</A></B>(<A HREF="../../../net/jini/jeri/Endpoint.html" title="interface in net.jini.jeri">Endpoint</A> ep,
+ <A HREF="../../../net/jini/id/Uuid.html" title="class in net.jini.id">Uuid</A> id,
+ boolean enableDGC)</CODE>
+
+<BR>
+ Creates a new <code>BasicObjectEndpoint</code> to reference a
+ remote object at the specified <code>Endpoint</code> with the
+ specified <code>Uuid</code>.</TD>
+</TR>
+</TABLE>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html#checkTrustEquivalence(java.lang.Object)">checkTrustEquivalence</A></B>(<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> obj)</CODE>
+
+<BR>
+ Returns <code>true</code> if the specified object (which is not
+ yet known to be trusted) is equivalent in trust, content, and
+ function to this known trusted object, and <code>false</code>
+ otherwise.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html#equals(java.lang.Object)">equals</A></B>(<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> obj)</CODE>
+
+<BR>
+ Compares the specified object with this
+ <code>BasicObjectEndpoint</code> for equality.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html#executeCall(net.jini.jeri.OutboundRequest)">executeCall</A></B>(<A HREF="../../../net/jini/jeri/OutboundRequest.html" title="interface in net.jini.jeri">OutboundRequest</A> call)</CODE>
+
+<BR>
+ Synchronously executes a remote call in progress to the
+ identified remote object, so that the response can be read.
+
+ This method reads a byte from the response input stream of
+ <code>call</code>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html#getEnableDGC()">getEnableDGC</A></B>()</CODE>
+
+<BR>
+ Returns <code>true</code> if this
+ <code>BasicObjectEndpoint</code> participates in DGC and
+ <code>false</code> otherwise.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/jeri/Endpoint.html" title="interface in net.jini.jeri">Endpoint</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html#getEndpoint()">getEndpoint</A></B>()</CODE>
+
+<BR>
+ Returns the <code>Endpoint</code> for the referenced remote
+ object.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/id/Uuid.html" title="class in net.jini.id">Uuid</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html#getObjectIdentifier()">getObjectIdentifier</A></B>()</CODE>
+
+<BR>
+ Returns the object identifier for the referenced remote object.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> int</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html#hashCode()">hashCode</A></B>()</CODE>
+
+<BR>
+ Returns the hash code value for this
+ <code>BasicObjectEndpoint</code>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/jeri/OutboundRequestIterator.html" title="interface in net.jini.jeri">OutboundRequestIterator</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html#newCall(net.jini.core.constraint.InvocationConstraints)">newCall</A></B>(<A HREF="../../../net/jini/core/constraint/InvocationConstraints.html" title="class in net.jini.core.constraint">InvocationConstraints</A> constraints)</CODE>
+
+<BR>
+ Returns an <code>OutboundRequestIterator</code> to use to send
+ a new remote call to the referenced remote object using the
+ specified constraints.
+
+ This method first invokes <A HREF="../../../net/jini/jeri/Endpoint.html#newRequest(net.jini.core.constraint.InvocationConstraints)"><CODE>newRequest</CODE></A> on this <code>BasicObjectEndpoint</code>'s
+ contained <code>Endpoint</code> with the specified constraints
+ to obtain an <code>OutboundRequestIterator</code>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/jeri/BasicObjectEndpoint.html#toString()">toString</A></B>()</CODE>
+
+<BR>
+ Returns a string representation of this
+ <code>BasicObjectEndpoint</code>.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#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#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/
docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+
+<A NAME="constructor_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Constructor Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="BasicObjectEndpoint(net.jini.jeri.Endpoint, net.jini.id.Uuid, boolean)"><!-- --></A><H3>
+BasicObjectEndpoint</H3>
+<PRE>
+public <B>BasicObjectEndpoint</B>(<A HREF="../../../net/jini/jeri/Endpoint.html" title="interface in net.jini.jeri">Endpoint</A> ep,
+ <A HREF="../../../net/jini/id/Uuid.html" title="class in net.jini.id">Uuid</A> id,
+ boolean enableDGC)</PRE>
+<DL>
+<DD>Creates a new <code>BasicObjectEndpoint</code> to reference a
+ remote object at the specified <code>Endpoint</code> with the
+ specified <code>Uuid</code>.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>ep</CODE> - the endpoint to send remote call requests for the
+ remote object to<DD><CODE>id</CODE> - the object identifier for the remote object<DD><CODE>enableDGC</CODE> - flag indicating whether or not the
+ <code>BasicObjectEndpoint</code> participates in DGC
+<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>e</code> or
+ <code>id</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="newCall(net.jini.core.constraint.InvocationConstraints)"><!-- --></A><H3>
+newCall</H3>
+<PRE>
+public <A HREF="../../../net/jini/jeri/OutboundRequestIterator.html" title="interface in net.jini.jeri">OutboundRequestIterator</A> <B>newCall</B>(<A HREF="../../../net/jini/core/constraint/InvocationConstraints.html" title="class in net.jini.core.constraint">InvocationConstraints</A> constraints)</PRE>
+<DL>
+<DD>Returns an <code>OutboundRequestIterator</code> to use to send
+ a new remote call to the referenced remote object using the
+ specified constraints.
+
+ <p>The constraints must be the complete, absolute constraints
+ for the remote call, combining any client and server
+ constraints for the remote method being invoked, with no
+ relative time constraints.
+
+ <p>For each <A HREF="../../../net/jini/jeri/OutboundRequest.html" title="interface in net.jini.jeri"><CODE>OutboundRequest</CODE></A> produced by the returned
+ <code>OutboundRequestIterator</code>, after writing the request
+ data and before reading any response data, <A HREF="../../../net/jini/jeri/ObjectEndpoint.html#executeCall(net.jini.jeri.OutboundRequest)"><CODE>executeCall</CODE></A> must be invoked to execute the call.
+
+ <p>This method first invokes <A HREF="../../../net/jini/jeri/Endpoint.html#newRequest(net.jini.core.constraint.InvocationConstraints)"><CODE>newRequest</CODE></A> on this <code>BasicObjectEndpoint</code>'s
+ contained <code>Endpoint</code> with the specified constraints
+ to obtain an <code>OutboundRequestIterator</code>. It then
+ wraps the obtained iterator in another
+ <code>OutboundRequestIterator</code> and returns the wrapped
+ iterator.
+
+ <p>The methods of the returned
+ <code>OutboundRequestIterator</code> behave as follows:
+
+ <p><A HREF="../../../net/jini/jeri/OutboundRequestIterator.html#hasNext()"><CODE>boolean hasNext()</CODE></A>:
+
+ <blockquote>
+
+ <p>Returns <code>true</code> if this iterator supports making
+ at least one more attempt to communicate the remote call, and
+ <code>false</code> otherwise.
+
+ <p>This method invokes <code>hasNext</code> on the underlying
+ iterator and returns the result.
+
+ <p>The security context in which this method is invoked may be
+ used for subsequent verification of security permissions; see
+ the <A HREF="../../../net/jini/jeri/OutboundRequestIterator.html#next()"><CODE>next</CODE></A> method
+ specification for more details.
+
+ </blockquote>
+
+ <p><A HREF="../../../net/jini/jeri/OutboundRequestIterator.html#next()"><CODE>OutboundRequest next()</CODE></A>:
+
+ <blockquote>
+
+ <p>Initiates an attempt to communicate the remote call to the
+ referenced remote object.
+
+ <p>This method invokes <code>next</code> on the underlying
+ iterator to obtain an <code>OutboundRequest</code>. Then it
+ writes the object identifier of the
+ <code>BasicObjectEndpoint</code> that produced this iterator to
+ the request's output stream by invoking <A HREF="../../../net/jini/id/Uuid.html#write(java.io.OutputStream)"><CODE>Uuid.write(OutputStream)</CODE></A> with the
+ request output stream, and then it returns the request.
+
+ <p>Throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/NoSuchElementException.html" title="class or interface in java.util"><CODE>NoSuchElementException</CODE></A> if this iterator does
+ not support making another attempt to communicate the remote
+ call (that is, if <code>hasNext</code> would return
+ <code>false</code>).
+
+ <p>Throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html" title="class or interface in java.io"><CODE>IOException</CODE></A> if an <code>IOException</code> is
+ thrown by the invocation of <code>next</code> on the underlying
+ iterator or by the subsequent I/O operations.
+
+ <p>Throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang"><CODE>SecurityException</CODE></A> if a
+ <code>SecurityException</code> is thrown by the invocation of
+ <code>next</code> on the underlying iterator or by the
+ subsequent I/O operations.
+
+ </blockquote>
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/jeri/ObjectEndpoint.html#newCall(net.jini.core.constraint.InvocationConstraints)">newCall</A></CODE> in interface <CODE><A HREF="../../../net/jini/jeri/ObjectEndpoint.html" title="interface in net.jini.jeri">ObjectEndpoint</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>constraints</CODE> - the complete, absolute constraints
+<DT><B>Returns:</B><DD>an <code>OutboundRequestIterator</code> to use to send
+ a new remote call to the referenced remote object
+<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>constraints</code> is
+ <code>null</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="executeCall(net.jini.jeri.OutboundRequest)"><!-- --></A><H3>
+executeCall</H3>
+<PRE>
+public <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> <B>executeCall</B>(<A HREF="../../../net/jini/jeri/OutboundRequest.html" title="interface in net.jini.jeri">OutboundRequest</A> call)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></PRE>
+<DL>
+<DD>Synchronously executes a remote call in progress to the
+ identified remote object, so that the response can be read.
+
+ <p>This method should be passed an <code>OutboundRequest</code>
+ that was produced by an <code>OutboundRequestIterator</code>
+ returned from this object's <A HREF="../../../net/jini/jeri/ObjectEndpoint.html#newCall(net.jini.core.constraint.InvocationConstraints)"><CODE>newCall</CODE></A> method.
+ This method must be invoked after writing the request data to
+ and before reading any response data from the
+ <code>OutboundRequest</code>.
+
+ <p>If the remote call was successfully executed (such that the
+ response data may now be read) this method returns
+ <code>null</code>. This method returns a non-<code>null</code>
+ <code>RemoteException</code> to indicate a
+ <code>RemoteException</code> that the remote call should fail
+ with. For example, if the referenced object does not exist at
+ the remote endpoint, a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/NoSuchObjectException.html" title="class or interface in java.rmi"><CODE>NoSuchObjectException</CODE></A> will be
+ returned. This method throws an <code>IOException</code> for
+ other communication failures.
+
+ <p>This method reads a byte from the response input stream of
+ <code>call</code>. If an <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html" title="class or interface in java.io"><CODE>IOException</CODE></A> is thrown reading
+ the byte, that exception is thrown to the caller. If reading
+ the byte otherwise indicates EOF, an <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/EOFException.html" title="class or interface in java.io"><CODE>EOFException</CODE></A> is
+ thrown to the caller. If the byte is <code>0x00</code>, then
+ this method returns a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/NoSuchObjectException.html" title="class or interface in java.rmi"><CODE>NoSuchObjectException</CODE></A> indicating
+ that there is no remote object exported with the object
+ identifier at the remote endpoint. If the byte is
+ <code>0x01</code>, then this method returns <code>null</code>,
+ indicating that a remote object corresponding to the object
+ identifier and endpoint is exported, and thus the caller may
+ proceed to read the response of the remote call. If the byte
+ is any other value, this method returns an <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/UnmarshalException.html" title="class or interface in java.rmi"><CODE>UnmarshalException</CODE></A> indicating that a protocol error occurred.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/jeri/ObjectEndpoint.html#executeCall(net.jini.jeri.OutboundRequest)">executeCall</A></CODE> in interface <CODE><A HREF="../../../net/jini/jeri/ObjectEndpoint.html" title="interface in net.jini.jeri">ObjectEndpoint</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>call</CODE> - the remote call to execute, produced by an
+ <code>OutboundRequestIterator</code> that was returned from
+ <code>newCall</code>
+<DT><B>Returns:</B><DD><code>null</code> on success, or a
+ <code>RemoteException</code> if the remote call should fail
+ with that <code>RemoteException</code>
+<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>call</code> is
+ <code>null</code>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></CODE> - if an I/O exception occurs while performing
+ this operation</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getEndpoint()"><!-- --></A><H3>
+getEndpoint</H3>
+<PRE>
+public <A HREF="../../../net/jini/jeri/Endpoint.html" title="interface in net.jini.jeri">Endpoint</A> <B>getEndpoint</B>()</PRE>
+<DL>
+<DD>Returns the <code>Endpoint</code> for the referenced remote
+ object.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the <code>Endpoint</code> for the referenced remote
+ object</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getObjectIdentifier()"><!-- --></A><H3>
+getObjectIdentifier</H3>
+<PRE>
+public <A HREF="../../../net/jini/id/Uuid.html" title="class in net.jini.id">Uuid</A> <B>getObjectIdentifier</B>()</PRE>
+<DL>
+<DD>Returns the object identifier for the referenced remote object.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the object identifier for the referenced remote object</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getEnableDGC()"><!-- --></A><H3>
+getEnableDGC</H3>
+<PRE>
+public boolean <B>getEnableDGC</B>()</PRE>
+<DL>
+<DD>Returns <code>true</code> if this
+ <code>BasicObjectEndpoint</code> participates in DGC and
+ <code>false</code> otherwise.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD><code>true</code> if this
+ <code>BasicObjectEndpoint</code> participates in DGC and
+ <code>false</code> otherwise</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="hashCode()"><!-- --></A><H3>
+hashCode</H3>
+<PRE>
+public int <B>hashCode</B>()</PRE>
+<DL>
+<DD>Returns the hash code value for this
+ <code>BasicObjectEndpoint</code>.
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><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></CODE> in class <CODE><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></CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the hash code value for this
+ <code>BasicObjectEndpoint</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="equals(java.lang.Object)"><!-- --></A><H3>
+equals</H3>
+<PRE>
+public boolean <B>equals</B>(<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> obj)</PRE>
+<DL>
+<DD>Compares the specified object with this
+ <code>BasicObjectEndpoint</code> for equality.
+
+ <p>This method returns <code>true</code> if and only if
+
+ <ul>
+
+ <li>the specified object is also a
+ <code>BasicObjectEndpoint</code>,
+
+ <li>the object identifier and <code>enableDGC</code> flag in
+ the specified object are equal to the ones in this object, and
+
+ <li>the <code>Endpoint</code> in the specified object has
+ the same class and is equal to the one in this object.
+
+ </ul>
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><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></CODE> in class <CODE><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></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>obj</CODE> - the object to compare with
+<DT><B>Returns:</B><DD><code>true</code> if <code>obj</code> is equivalent to
+ this object; <code>false</code> otherwise</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="checkTrustEquivalence(java.lang.Object)"><!-- --></A><H3>
+checkTrustEquivalence</H3>
+<PRE>
+public boolean <B>checkTrustEquivalence</B>(<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> obj)</PRE>
+<DL>
+<DD>Returns <code>true</code> if the specified object (which is not
+ yet known to be trusted) is equivalent in trust, content, and
+ function to this known trusted object, and <code>false</code>
+ otherwise.
+
+ <p>This method returns <code>true</code> if and only if
+
+ <ul>
+
+ <li>the specified object is also a
+ <code>BasicObjectEndpoint</code>,
+
+ <li>the object identifier and <code>enableDGC</code> flag in
+ the specified object are equal to the ones in this object, and
+
+ <li>this object's <code>Endpoint</code> is an instance of
+ <A HREF="../../../net/jini/security/proxytrust/TrustEquivalence.html" title="interface in net.jini.security.proxytrust"><CODE>TrustEquivalence</CODE></A> and invoking its
+ <code>checkTrustEquivalence</code> method with the specified
+ object's <code>Endpoint</code> returns <code>true</code>.
+
+ </ul>
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/security/proxytrust/TrustEquivalence.html#checkTrustEquivalence(java.lang.Object)">checkTrustEquivalence</A></CODE> in interface <CODE><A HREF="../../../net/jini/security/proxytrust/TrustEquivalence.html" title="interface in net.jini.security.proxytrust">TrustEquivalence</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>obj</CODE> - object to check that is not yet known to be trusted
+<DT><B>Returns:</B><DD><code>true</code> if the specified object (that is not yet
+ known to be trusted) is equivalent in trust, content, and function to
+ this known trusted object, and returns <code>false</code> otherwise</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="toString()"><!-- --></A><H3>
+toString</H3>
+<PRE>
+public <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> <B>toString</B>()</PRE>
+<DL>
+<DD>Returns a string representation of this
+ <code>BasicObjectEndpoint</code>.
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A></CODE> in class <CODE><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></CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>a string representation of this
+ <code>BasicObjectEndpoint</code></DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/BasicObjectEndpoint.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../net/jini/jeri/BasicJeriTrustVerifier.html" title="class in net.jini.jeri"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/jeri/Endpoint.html" title="interface in net.jini.jeri"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/jeri/BasicObjectEndpoint.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="BasicObjectEndpoint.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright 2007, multiple authors.<br>Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="child" >Apache License, Version 2.0</a>, see the <a href="../../../doc-files/NOTICE" target="child" >NOTICE</a> file for attributions.
+</BODY>
+</HTML>