You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@river.apache.org by si...@apache.org on 2010/12/24 21:23:23 UTC
svn commit: r1052582 [2/4] - in
/incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust:
./ class-use/
Added: incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ProxyTrustInvocationHandler.html
URL: http://svn.apache.org/viewvc/incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ProxyTrustInvocationHandler.html?rev=1052582&view=auto
==============================================================================
--- incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ProxyTrustInvocationHandler.html (added)
+++ incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ProxyTrustInvocationHandler.html Fri Dec 24 20:23:22 2010
@@ -0,0 +1,490 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Mon Mar 08 17:46:25 EST 2010 -->
+<TITLE>
+ProxyTrustInvocationHandler (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.security.proxytrust.ProxyTrustInvocationHandler class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="ProxyTrustInvocationHandler (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/ProxyTrustInvocationHandler.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustExporter.html" title="class in net.jini.security.proxytrust"><B>PREV CLASS</B></A>
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html" title="interface in net.jini.security.proxytrust"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/security/proxytrust/ProxyTrustInvocationHandler.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ProxyTrustInvocationHandler.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.security.proxytrust</FONT>
+<BR>
+Class ProxyTrustInvocationHandler</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.security.proxytrust.ProxyTrustInvocationHandler</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="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>, <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>ProxyTrustInvocationHandler</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="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>, <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>
+Invocation handler for remote objects, supporting proxy trust verification
+ by clients using <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustVerifier.html" title="class in net.jini.security.proxytrust"><CODE>ProxyTrustVerifier</CODE></A>. This invocation handler
+ contains both an underlying main proxy and a bootstrap proxy; the main
+ proxy is not expected to be considered trusted directly by clients, but
+ the bootstrap proxy is. The main proxy must be an instance of both
+ <A HREF="../../../../net/jini/core/constraint/RemoteMethodControl.html" title="interface in net.jini.core.constraint"><CODE>RemoteMethodControl</CODE></A> and <A HREF="../../../../net/jini/security/proxytrust/TrustEquivalence.html" title="interface in net.jini.security.proxytrust"><CODE>TrustEquivalence</CODE></A>, and the bootstrap
+ proxy must be an instance of <A HREF="../../../../net/jini/security/proxytrust/ProxyTrust.html" title="interface in net.jini.security.proxytrust"><CODE>ProxyTrust</CODE></A>,
+ <code>RemoteMethodControl</code>, and <code>TrustEquivalence</code>. This
+ invocation handler handles most method invocations by delegating to the
+ main proxy. The bootstrap proxy is produced by the iterator returned by
+ the <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustInvocationHandler.html#getProxyTrustIterator()"><CODE>getProxyTrustIterator</CODE></A> method, as
+ required by <code>ProxyTrustVerifier</code>.
+<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.security.proxytrust.ProxyTrustInvocationHandler">Serialized Form</A></DL>
+<HR>
+
+<P>
+
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+
+<A NAME="constructor_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Constructor Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../net/jini/security/proxytrust/ProxyTrustInvocationHandler.html#ProxyTrustInvocationHandler(net.jini.core.constraint.RemoteMethodControl, net.jini.security.proxytrust.ProxyTrust)">ProxyTrustInvocationHandler</A></B>(<A HREF="../../../../net/jini/core/constraint/RemoteMethodControl.html" title="interface in net.jini.core.constraint">RemoteMethodControl</A> main,
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrust.html" title="interface in net.jini.security.proxytrust">ProxyTrust</A> boot)</CODE>
+
+<BR>
+ Creates an instance with the specified main proxy and bootstrap proxy.</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/security/proxytrust/ProxyTrustInvocationHandler.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 argument is an instance of this
+ class, and calling the <code>checkTrustEquivalence</code> method on
+ the main proxy of this invocation handler, passing the main proxy of
+ the argument, returns <code>true</code>, and calling the
+ <code>checkTrustEquivalence</code> method on the bootstrap proxy of
+ this invocation handler, passing the bootstrap proxy of the argument,
+ returns <code>true</code>, and 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/security/proxytrust/ProxyTrustInvocationHandler.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>
+ Returns <code>true</code> if the argument is an instance of this
+ class with the same main proxy and the same bootstrap proxy, and
+ <code>false</code> otherwise.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html" title="interface in net.jini.security.proxytrust">ProxyTrustIterator</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/security/proxytrust/ProxyTrustInvocationHandler.html#getProxyTrustIterator()">getProxyTrustIterator</A></B>()</CODE>
+
+<BR>
+ Returns an iterator that produces the bootstrap proxy as the only
+ element of the iteration.</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/security/proxytrust/ProxyTrustInvocationHandler.html#hashCode()">hashCode</A></B>()</CODE>
+
+<BR>
+ Returns a hash code value for this object.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/security/proxytrust/ProxyTrustInvocationHandler.html#invoke(java.lang.Object, java.lang.reflect.Method, java.lang.Object[])">invoke</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="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/reflect/Method.html" title="class or interface in java.lang.reflect">Method</A> method,
+ <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>[] args)</CODE>
+
+<BR>
+ Executes the specified method with the specified arguments on the
+ specified proxy, and returns the return value, if any.</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/security/proxytrust/ProxyTrustInvocationHandler.html#toString()">toString</A></B>()</CODE>
+
+<BR>
+ Returns a string representation of this object.</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="ProxyTrustInvocationHandler(net.jini.core.constraint.RemoteMethodControl, net.jini.security.proxytrust.ProxyTrust)"><!-- --></A><H3>
+ProxyTrustInvocationHandler</H3>
+<PRE>
+public <B>ProxyTrustInvocationHandler</B>(<A HREF="../../../../net/jini/core/constraint/RemoteMethodControl.html" title="interface in net.jini.core.constraint">RemoteMethodControl</A> main,
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrust.html" title="interface in net.jini.security.proxytrust">ProxyTrust</A> boot)</PRE>
+<DL>
+<DD>Creates an instance with the specified main proxy and bootstrap proxy.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>main</CODE> - the main proxy<DD><CODE>boot</CODE> - the bootstrap proxy
+<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 any argument is <code>null</code>
+<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 main proxy is not an instance
+ of <A HREF="../../../../net/jini/security/proxytrust/TrustEquivalence.html" title="interface in net.jini.security.proxytrust"><CODE>TrustEquivalence</CODE></A>, or the bootstrap proxy is not an instance
+ of <code>RemoteMethodControl</code> or <code>TrustEquivalence</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="invoke(java.lang.Object, java.lang.reflect.Method, java.lang.Object[])"><!-- --></A><H3>
+invoke</H3>
+<PRE>
+public <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>invoke</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="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/reflect/Method.html" title="class or interface in java.lang.reflect">Method</A> method,
+ <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>[] args)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A></PRE>
+<DL>
+<DD>Executes the specified method with the specified arguments on the
+ specified proxy, and returns the return value, if any.
+ <p>
+ If the specified method is <code>Object.equals</code>, returns
+ <code>true</code> if the argument (<code>args[0]</code>) 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>) that implements the same interfaces as the specified
+ proxy and this invocation handler is equal to the invocation handler
+ of that argument, and returns <code>false</code> otherwise.
+ <p>
+ If the specified method is <code>Object.toString</code>, returns
+ a string representation of the specified proxy object.
+ <p>
+ If the specified method is <code>Object.hashCode</code>, returns
+ a hash code for the specified proxy object.
+ <p>
+ If the specified method is <A HREF="../../../../net/jini/core/constraint/RemoteMethodControl.html#setConstraints(net.jini.core.constraint.MethodConstraints)"><CODE>RemoteMethodControl.setConstraints</CODE></A>, returns a new proxy (an instance
+ of the same class as the specified proxy) containing an instance of
+ this class with a new main proxy and the same bootstrap proxy from
+ this handler. The new main proxy is obtained by delegating to the
+ existing main proxy of this handler (as described below). An exception
+ is thrown if the specified proxy is not an instance of a dynamic
+ proxy class containing this invocation handler.
+ <p>
+ If the specified method is
+ <A HREF="../../../../net/jini/security/proxytrust/TrustEquivalence.html#checkTrustEquivalence(java.lang.Object)"><CODE>TrustEquivalence.checkTrustEquivalence</CODE></A>, returns <code>true</code> if
+ the argument (<code>args[0]</code>) is an instance of a dynamic proxy
+ class that implements the same interfaces as the specified proxy and
+ calling the <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustInvocationHandler.html#checkTrustEquivalence(java.lang.Object)"><CODE>checkTrustEquivalence</CODE></A> method
+ of this invocation handler with the invocation handler of that argument
+ returns <code>true</code>, and returns <code>false</code> otherwise.
+ <p>
+ For all other methods, returns the object obtained by delegating to
+ the main proxy: the specified method is reflectively invoked on the
+ main proxy with the specified arguments, unless the method's declaring
+ class is not public but the main proxy is an instance of that
+ declaring class and the main proxy's class is public, in which case
+ the corresponding method of the main proxy's class is reflectively
+ invoked instead.
+ <p>
+ The semantics of this method are unspecified if the arguments could
+ not have been produced by an instance of some valid dynamic proxy
+ class containing this invocation handler.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/reflect/InvocationHandler.html#invoke(java.lang.Object, java.lang.reflect.Method, java.lang.Object[])" title="class or interface in java.lang.reflect">invoke</A></CODE> in interface <CODE><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></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>proxy</CODE> - the proxy object<DD><CODE>method</CODE> - the method being invoked<DD><CODE>args</CODE> - the arguments to the specified method
+<DT><B>Returns:</B><DD>the value returned by executing the specified method on
+ the specified proxy with the specified arguments, or <code>null</code>
+ if the method has <code>void</code> return type
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A></CODE> - the exception thrown by executing the specified
+ method
+<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 declaring class of the
+ specified method is not public and either the main proxy is not an
+ instance of that declaring class or the main proxy's class is not
+ public</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 argument is an instance of this
+ class, and calling the <code>checkTrustEquivalence</code> method on
+ the main proxy of this invocation handler, passing the main proxy of
+ the argument, returns <code>true</code>, and calling the
+ <code>checkTrustEquivalence</code> method on the bootstrap proxy of
+ this invocation handler, passing the bootstrap proxy of the argument,
+ returns <code>true</code>, and returns <code>false</code> otherwise.
+<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="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>Returns <code>true</code> if the argument is an instance of this
+ class with the same main proxy and the same bootstrap proxy, and
+ <code>false</code> otherwise.
+<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>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="hashCode()"><!-- --></A><H3>
+hashCode</H3>
+<PRE>
+public int <B>hashCode</B>()</PRE>
+<DL>
+<DD>Returns a hash code value for this object.
+<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>
+</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 object.
+<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>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getProxyTrustIterator()"><!-- --></A><H3>
+getProxyTrustIterator</H3>
+<PRE>
+protected <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html" title="interface in net.jini.security.proxytrust">ProxyTrustIterator</A> <B>getProxyTrustIterator</B>()</PRE>
+<DL>
+<DD>Returns an iterator that produces the bootstrap proxy as the only
+ element of the iteration.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>an iterator that produces the bootstrap proxy as the only
+ element of the iteration</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/ProxyTrustInvocationHandler.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustExporter.html" title="class in net.jini.security.proxytrust"><B>PREV CLASS</B></A>
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html" title="interface in net.jini.security.proxytrust"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/security/proxytrust/ProxyTrustInvocationHandler.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ProxyTrustInvocationHandler.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: incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ProxyTrustIterator.html
URL: http://svn.apache.org/viewvc/incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ProxyTrustIterator.html?rev=1052582&view=auto
==============================================================================
--- incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ProxyTrustIterator.html (added)
+++ incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ProxyTrustIterator.html Fri Dec 24 20:23:22 2010
@@ -0,0 +1,298 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Mon Mar 08 17:46:25 EST 2010 -->
+<TITLE>
+ProxyTrustIterator (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.security.proxytrust.ProxyTrustIterator interface">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="ProxyTrustIterator (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/ProxyTrustIterator.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustInvocationHandler.html" title="class in net.jini.security.proxytrust"><B>PREV CLASS</B></A>
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustVerifier.html" title="class in net.jini.security.proxytrust"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/security/proxytrust/ProxyTrustIterator.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ProxyTrustIterator.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+net.jini.security.proxytrust</FONT>
+<BR>
+Interface ProxyTrustIterator</H2>
+<DL>
+<DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../../net/jini/security/proxytrust/SingletonProxyTrustIterator.html" title="class in net.jini.security.proxytrust">SingletonProxyTrustIterator</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public interface <B>ProxyTrustIterator</B></DL>
+</PRE>
+
+<P>
+Defines an iterator that produces objects from which a
+ <A HREF="../../../../net/jini/security/TrustVerifier.html" title="interface in net.jini.security"><CODE>TrustVerifier</CODE></A> might be obtained.
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustVerifier.html" title="class in net.jini.security.proxytrust"><CODE>ProxyTrustVerifier</CODE></A> obtains such iterators from instances of
+ classes that have a non-<code>static</code> member method with signature:
+ <pre>ProxyTrustIterator getProxyTrustIterator();</pre>
+ The expectation is that each element produced by the iterator either
+ implements <A HREF="../../../../net/jini/security/proxytrust/ProxyTrust.html" title="interface in net.jini.security.proxytrust"><CODE>ProxyTrust</CODE></A> or might have a
+ <code>getProxyTrustIterator</code> method that can be used recursively to
+ obtain further candidates.
+<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>
+
+<!-- ========== 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/security/proxytrust/ProxyTrustIterator.html#hasNext()">hasNext</A></B>()</CODE>
+
+<BR>
+ Returns <code>true</code> if the iteration has more elements, 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="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html#next()">next</A></B>()</CODE>
+
+<BR>
+ Returns the next element in the iteration.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html#setException(java.rmi.RemoteException)">setException</A></B>(<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> e)</CODE>
+
+<BR>
+ Provides the iteration with a <code>RemoteException</code> thrown from
+ a remote call made while attempting to obtain a
+ <A HREF="../../../../net/jini/security/TrustVerifier.html" title="interface in net.jini.security"><CODE>TrustVerifier</CODE></A> from the object
+ returned by the most recent call to <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html#next()"><CODE>next</CODE></A>.</TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="hasNext()"><!-- --></A><H3>
+hasNext</H3>
+<PRE>
+boolean <B>hasNext</B>()</PRE>
+<DL>
+<DD>Returns <code>true</code> if the iteration has more elements, and
+ <code>false</code> otherwise.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD><code>true</code> if the iteration has more elements, and
+ <code>false</code> otherwise</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="next()"><!-- --></A><H3>
+next</H3>
+<PRE>
+<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>next</B>()
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Returns the next element in the iteration. This method can throw
+ an exception (other than <code>NoSuchElementException</code>) without
+ terminating the iteration.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the next element in the iteration
+<DT><B>Throws:</B>
+<DD><CODE>NoSuchElementException</CODE> - if the iteration has no more elements
+<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
+ while producing the next element
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/RuntimeException.html" title="class or interface in java.lang">RuntimeException</A></CODE> - if a runtime exception occurs while producing
+ the next element</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="setException(java.rmi.RemoteException)"><!-- --></A><H3>
+setException</H3>
+<PRE>
+void <B>setException</B>(<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> e)</PRE>
+<DL>
+<DD>Provides the iteration with a <code>RemoteException</code> thrown from
+ a remote call made while attempting to obtain a
+ <A HREF="../../../../net/jini/security/TrustVerifier.html" title="interface in net.jini.security"><CODE>TrustVerifier</CODE></A> from the object
+ returned by the most recent call to <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html#next()"><CODE>next</CODE></A>. Setting an
+ exception may influence which (if any) elements are subsequently
+ produced by the iteration. (A <code>RemoteException</code> thrown
+ directly by <code>next</code> should not be passed to this method.)
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>e</CODE> - <code>RemoteException</code> thrown from a remote call
+<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 the argument is <code>null</code>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - if <code>next</code> has never been
+ called, or if this method has already been called since the most
+ recent call to <code>next</code>, or if <code>hasNext</code> has been
+ called since the most recent call to <code>next</code>, or if the most
+ recent call to <code>next</code> threw a <code>RemoteException</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/ProxyTrustIterator.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustInvocationHandler.html" title="class in net.jini.security.proxytrust"><B>PREV CLASS</B></A>
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustVerifier.html" title="class in net.jini.security.proxytrust"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/security/proxytrust/ProxyTrustIterator.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ProxyTrustIterator.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright 2007, multiple authors.<br>Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="child" >Apache License, Version 2.0</a>, see the <a href="../../../../doc-files/NOTICE" target="child" >NOTICE</a> file for attributions.
+</BODY>
+</HTML>
Added: incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ProxyTrustVerifier.html
URL: http://svn.apache.org/viewvc/incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ProxyTrustVerifier.html?rev=1052582&view=auto
==============================================================================
--- incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ProxyTrustVerifier.html (added)
+++ incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ProxyTrustVerifier.html Fri Dec 24 20:23:22 2010
@@ -0,0 +1,485 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Mon Mar 08 17:46:25 EST 2010 -->
+<TITLE>
+ProxyTrustVerifier (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.security.proxytrust.ProxyTrustVerifier class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="ProxyTrustVerifier (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/ProxyTrustVerifier.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html" title="interface in net.jini.security.proxytrust"><B>PREV CLASS</B></A>
+ <A HREF="../../../../net/jini/security/proxytrust/ServerProxyTrust.html" title="interface in net.jini.security.proxytrust"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/security/proxytrust/ProxyTrustVerifier.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ProxyTrustVerifier.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.security.proxytrust</FONT>
+<BR>
+Class ProxyTrustVerifier</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.security.proxytrust.ProxyTrustVerifier</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>ProxyTrustVerifier</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 service proxies that use dynamically downloaded code.
+ This verifier uses a recursive algorithm to obtain one or more bootstrap
+ proxies, which must be objects that are instances of both
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrust.html" title="interface in net.jini.security.proxytrust"><CODE>ProxyTrust</CODE></A> and <A HREF="../../../../net/jini/core/constraint/RemoteMethodControl.html" title="interface in net.jini.core.constraint"><CODE>RemoteMethodControl</CODE></A>. If a bootstrap proxy
+ (or a derivative of it) is known to be trusted, a remote call is made
+ through it to obtain a trust verifier for the original service proxy.
+ 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>
+<DT><B>Implementation Specifics:</B></DT>
+ <DD>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.security.trust</code> to log
+ information at the following levels:
+ <table summary="Describes what is logged by ProxyTrustVerifier to
+ the trust logger at various logging levels" border=1 cellpadding=5>
+ <tr>
+ <th>Level</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td><A HREF="../../../../com/sun/jini/logging/Levels.html#FAILED"><CODE>FAILED</CODE></A></td>
+ <td>no verifier is obtained from a <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html" title="interface in net.jini.security.proxytrust"><CODE>ProxyTrustIterator</CODE></A></td>
+ </tr>
+ <tr>
+ <td><A HREF="../../../../com/sun/jini/logging/Levels.html#HANDLED"><CODE>HANDLED</CODE></A></td>
+ <td><code>RemoteException</code> being passed to
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html#setException(java.rmi.RemoteException)"><CODE>ProxyTrustIterator.setException</CODE></A></td>
+ </tr>
+ <tr>
+ <td><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#FINE" title="class or interface in java.util.logging"><CODE>FINE</CODE></A></td>
+ <td><A HREF="../../../../net/jini/security/proxytrust/ProxyTrust.html#getProxyVerifier()"><CODE>ProxyTrust.getProxyVerifier</CODE></A> remote
+ call returns a trust verifier</td>
+ </tr>
+ <tr>
+ <td><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#FINER" title="class or interface in java.util.logging"><CODE>FINER</CODE></A></td>
+ <td>an object with a <code>getProxyTrustIterator</code> method is
+ encountered</td>
+ </tr>
+ <tr>
+ <td><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#FINER" title="class or interface in java.util.logging"><CODE>FINER</CODE></A></td>
+ <td>each object produced by a <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html" title="interface in net.jini.security.proxytrust"><CODE>ProxyTrustIterator</CODE></A> and each
+ derivative bootstrap proxy</td>
+ </tr>
+ </table></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/security/proxytrust/ProxyTrustVerifier.html#ProxyTrustVerifier()">ProxyTrustVerifier</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> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/security/proxytrust/ProxyTrustVerifier.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 known to be
+ trusted to correctly implement its contract; 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="ProxyTrustVerifier()"><!-- --></A><H3>
+ProxyTrustVerifier</H3>
+<PRE>
+public <B>ProxyTrustVerifier</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 known to be
+ trusted to correctly implement its contract; returns <code>false</code>
+ otherwise.
+ <p>
+ This method returns <code>false</code> if the caller context collection
+ of the specified trust verifier context does not contain a
+ <A HREF="../../../../net/jini/core/constraint/MethodConstraints.html" title="interface in net.jini.core.constraint"><CODE>MethodConstraints</CODE></A> instance with non-empty constraints for the
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrust.html#getProxyVerifier()"><CODE>ProxyTrust.getProxyVerifier</CODE></A>
+ method, or if a <code>TrustVerifier</code> cannot be obtained from the
+ specified object using the steps described below. Otherwise a
+ <code>TrustVerifier</code> is obtained, its
+ <A HREF="../../../../net/jini/security/TrustVerifier.html#isTrustedObject(java.lang.Object, net.jini.security.TrustVerifier.Context)"><CODE>isTrustedObject</CODE></A> method is called
+ with the same arguments passed to this method, and the result of that
+ call is returned by this method; any exception thrown by that call
+ is thrown by this method. If a verifier cannot be obtained but one or
+ more of the intermediate operations involved in attempting to obtain one
+ throws a <code>RemoteException</code>, the last such
+ <code>RemoteException</code> is thrown by this method (rather than this
+ method returning <code>false</code>). If any intermediate operation
+ throws a <code>SecurityException</code> exception, that exception is
+ immediately thrown by this method.
+ <p>
+ A verifier is obtained from a candidate object as follows.
+ <ul>
+ <li>
+ If either the candidate object's class has a non-<code>static</code>
+ member method with signature:
+ <pre>ProxyTrustIterator getProxyTrustIterator();</pre>
+ or the candidate object is an instance of a dynamically generated
+ <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> class and the contained invocation handler's class has
+ such a member method, then the <code>getProxyTrustIterator</code>
+ method is called (on the candidate object or its invocation handler).
+ For each object produced by the <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html#next()"><CODE>next</CODE></A>
+ method of the returned iterator, the following substeps are used, until
+ either a verifier is obtained or the iteration terminates. If no
+ verifier can be obtained from any object produced by the iterator,
+ then there is no verifier for the candidate object. For any given
+ object produced by the iterator, if a verifier cannot be obtained from
+ the object but an intermediate operation involved in attempting to
+ obtain a verifier throws a <code>RemoteException</code>, that
+ exception is passed to the <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html#setException(java.rmi.RemoteException)"><CODE>setException</CODE></A> method of the iterator, and the iteration continues.
+ <p>
+ The <code>getProxyTrustIterator</code> method and the
+ <code>ProxyTrustIterator</code> methods are all invoked in a
+ restricted security context. If the specified trust verifier
+ context contains an <A HREF="../../../../net/jini/security/proxytrust/UntrustedObjectSecurityContext.html" title="interface in net.jini.security.proxytrust"><CODE>UntrustedObjectSecurityContext</CODE></A> instance,
+ then the security context returned by its
+ <A HREF="../../../../net/jini/security/proxytrust/UntrustedObjectSecurityContext.html#getContext()"><CODE>getContext</CODE></A> method
+ is used. Otherwise, the security context used is equivalent to
+ the current security context (as returned by
+ <A HREF="../../../../net/jini/security/Security.html#getContext()"><CODE>Security.getContext</CODE></A>) with
+ an additional protection domain combined into the access control
+ context that contains an empty <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/CodeSource.html" title="class or interface in java.security"><CODE>CodeSource</CODE></A>
+ (<code>null</code> location and certificates),
+ <code>null</code> permissions, <code>null</code> class loader, and
+ <code>null</code> principals.
+ <ul>
+ <li>If the object is an instance of both <A HREF="../../../../net/jini/security/proxytrust/ProxyTrust.html" title="interface in net.jini.security.proxytrust"><CODE>ProxyTrust</CODE></A> and
+ <A HREF="../../../../net/jini/core/constraint/RemoteMethodControl.html" title="interface in net.jini.core.constraint"><CODE>RemoteMethodControl</CODE></A> (that is, if the object is a bootstrap
+ proxy), it is verified for trust by 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. If
+ <code>isTrustedObject</code> returns <code>true</code>, then the
+ object's <A HREF="../../../../net/jini/security/proxytrust/ProxyTrust.html#getProxyVerifier()"><CODE>getProxyVerifier</CODE></A> method is
+ called, using as the client constraints for the remote call the first
+ <code>MethodConstraints</code> instance obtained from the caller
+ context collection (of the specified trust verifier context) that has
+ non-empty constraints for that <code>getProxyVerifier</code> method.
+ The verifier returned by that remote call is the verifier for the
+ original top-level object, and the entire search stops. If
+ <code>isTrustedObject</code> returns <code>false</code>, but a
+ verifier can be obtained from a trusted derivative bootstrap proxy as
+ described below, then that verifier is the verifier for the original
+ top-level object, and the entire search stops. Otherwise, no verifier
+ can be obtained from the object, and the iteration continues.
+ <li>If the object is not a <code>ProxyTrust</code> instance, it is
+ in turn treated as a new candidate object, and the complete set of
+ steps for a candidate object are used recursively to obtain a verifier
+ from it. If a verifier can be obtained from it, that verifier is the
+ verifier for the original top-level object, and the entire search stops.
+ If a verifier cannot be obtained from it, the iteration continues.
+ </ul>
+ <li>If the candidate object is the original top-level object and it is
+ an instance of both <code>ProxyTrust</code> and
+ <code>RemoteMethodControl</code> (that is, if the original top-level
+ object is itself a bootstrap proxy), and a verifier can be obtained
+ from a trusted derivative bootstrap proxy as described below, that
+ verifier is the verifier for the original top-level object, and the
+ entire search stops.
+ </ul>
+ Given a bootstrap proxy, a verifier can be obtained from a trusted
+ derivative bootstrap proxy as follows. A derivative can be produced
+ from the bootstrap proxy if all of the following conditions are
+ satisfied: the bootstrap proxy was not itself produced (either from an
+ iteration or as a derivative) by the latest active invocation of
+ <code>ProxyTrustVerifier</code> (not including the current one) in this
+ thread; the bootstrap proxy is an instance of a dynamically generated
+ <code>Proxy</code> class; neither the proxy's class nor the invocation
+ handler's class has an appropriate <code>getProxyTrustIterator</code>
+ method; the class loader of the proxy's class is
+ the proper Java(TM) RMI class
+ loader (as defined below) for its parent class loader and the class's
+ codebase (as produced by <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/server/RMIClassLoader.html#getClassAnnotation(java.lang.Class)" title="class or interface in java.rmi.server"><CODE>RMIClassLoader.getClassAnnotation</CODE></A>); and both <code>ProxyTrust</code>
+ and <code>RemoteMethodControl</code> are loadable by the parent class
+ loader. The derivative that is produced is an instance of a dynamically
+ generated <code>Proxy</code> class defined by the parent class loader
+ that implements both <code>ProxyTrust</code> and
+ <code>RemoteMethodControl</code> and contains the same invocation
+ handler as the bootstrap proxy. The derivative is a trusted derivative
+ bootstrap proxy if calling the specified context's
+ <code>isTrustedObject</code> method with the derivative returns
+ <code>true</code>. If a trusted derivative bootstrap proxy can be
+ produced, its <A HREF="../../../../net/jini/security/proxytrust/ProxyTrust.html#getProxyVerifier()"><CODE>getProxyVerifier</CODE></A>
+ method is called, using as the client constraints for the remote call
+ the first <code>MethodConstraints</code> instance obtained from the
+ caller context collection (of the specified trust verifier context)
+ that has non-empty constraints for that <code>getProxyVerifier</code>
+ method. The returned verifier is used as is, if the class loader of the
+ returned verifier's class is equal to the class loader of the original
+ bootstrap proxy's class, or if, in generating a serialization of the
+ verifier, no class passed to <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/ObjectOutputStream.html#annotateClass(java.lang.Class)" title="class or interface in java.io"><CODE>ObjectOutputStream.annotateClass</CODE></A> or
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/ObjectOutputStream.html#annotateProxyClass(java.lang.Class)" title="class or interface in java.io"><CODE>ObjectOutputStream.annotateProxyClass</CODE></A> has a class loader not equal
+ to the class loader of the original bootstrap proxy's class but has
+ a codebase that is equal to the codebase of the original bootstrap
+ proxy's class. Otherwise, the verifier is remarshalled in a manner
+ equivalent to creating a <A HREF="../../../../net/jini/io/MarshalledInstance.html" title="class in net.jini.io"><CODE>MarshalledInstance</CODE></A> with
+ the verifier and then calling the
+ <A HREF="../../../../net/jini/io/MarshalledInstance.html#get(java.lang.ClassLoader, boolean, java.lang.ClassLoader, java.util.Collection)"><CODE>get</CODE></A>
+ method of that object with the class loader of the original bootstrap
+ proxy's class as the default loader, with no codebase integrity
+ verification and with an empty context collection, and the remarshalled
+ verifier is used instead. 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> or
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassNotFoundException.html" title="class or interface in java.lang"><CODE>ClassNotFoundException</CODE></A> is thrown by this remarshalling, the
+ exception is wrapped in 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> and the resulting
+ exception is treated as if it had been thrown by the remote call that
+ returned the verifier.
+ <p>
+ A class loader of a class is the proper Java RMI class loader for its
+ parent class loader and the class's codebase if the class loader is
+ not <code>null</code>, the codebase for the class is a non-empty
+ string, and calling
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/server/RMIClassLoader.html#getClassLoader(java.lang.String)" title="class or interface in java.rmi.server"><CODE>RMIClassLoader.getClassLoader</CODE></A>
+ with that codebase, with the thread's context class loader set to the
+ parent class loader, returns the class loader of the class.
+<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/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/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/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - if a communication-related exception occurs</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </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/ProxyTrustVerifier.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustIterator.html" title="interface in net.jini.security.proxytrust"><B>PREV CLASS</B></A>
+ <A HREF="../../../../net/jini/security/proxytrust/ServerProxyTrust.html" title="interface in net.jini.security.proxytrust"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/security/proxytrust/ProxyTrustVerifier.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ProxyTrustVerifier.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: incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ServerProxyTrust.html
URL: http://svn.apache.org/viewvc/incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ServerProxyTrust.html?rev=1052582&view=auto
==============================================================================
--- incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ServerProxyTrust.html (added)
+++ incubator/river/site/trunk/content/river/doc/api/net/jini/security/proxytrust/ServerProxyTrust.html Fri Dec 24 20:23:22 2010
@@ -0,0 +1,242 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Mon Mar 08 17:46:25 EST 2010 -->
+<TITLE>
+ServerProxyTrust (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.security.proxytrust.ServerProxyTrust interface">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="ServerProxyTrust (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/ServerProxyTrust.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustVerifier.html" title="class in net.jini.security.proxytrust"><B>PREV CLASS</B></A>
+ <A HREF="../../../../net/jini/security/proxytrust/SingletonProxyTrustIterator.html" title="class in net.jini.security.proxytrust"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/security/proxytrust/ServerProxyTrust.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ServerProxyTrust.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+net.jini.security.proxytrust</FONT>
+<BR>
+Interface ServerProxyTrust</H2>
+<DL>
+<DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../../com/sun/jini/phoenix/ActivationGroupImpl.html" title="class in com.sun.jini.phoenix">ActivationGroupImpl</A>, <A HREF="../../../../com/sun/jini/outrigger/OutriggerServerImpl.html" title="class in com.sun.jini.outrigger">OutriggerServerImpl</A>, <A HREF="../../../../com/sun/jini/start/SharedGroupImpl.html" title="class in com.sun.jini.start">SharedGroupImpl</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public interface <B>ServerProxyTrust</B></DL>
+</PRE>
+
+<P>
+Defines a local interface to obtain a proxy trust verifier. A service that
+ uses proxies that will not directly be considered trusted by clients
+ can export a remote object that is an instance of this
+ interface to allow clients to verify that the proxies can be trusted as
+ proxies for the service. The intention is that a remote call to the
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrust.html#getProxyVerifier()"><CODE>ProxyTrust.getProxyVerifier</CODE></A> method of
+ a trusted bootstrap proxy will be implemented (on the server side) by
+ delegating to the corresponding method of this local interface.
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustExporter.html" title="class in net.jini.security.proxytrust"><CODE>ProxyTrustExporter</CODE></A> is one example of this form of delegation.
+ <A HREF="../../../../net/jini/jeri/ProxyTrustILFactory.html" title="class in net.jini.jeri"><CODE>ProxyTrustILFactory</CODE></A> is another example.
+<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>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../../net/jini/security/TrustVerifier.html" title="interface in net.jini.security">TrustVerifier</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/security/proxytrust/ServerProxyTrust.html#getProxyVerifier()">getProxyVerifier</A></B>()</CODE>
+
+<BR>
+ Returns a <code>TrustVerifier</code> that can be used to verify that
+ a proxy can be trusted as a proxy for the service; that is, the
+ <A HREF="../../../../net/jini/security/TrustVerifier.html#isTrustedObject(java.lang.Object, net.jini.security.TrustVerifier.Context)"><CODE>isTrustedObject</CODE></A> method of the
+ returned verifier can be called with a candidate proxy.</TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="getProxyVerifier()"><!-- --></A><H3>
+getProxyVerifier</H3>
+<PRE>
+<A HREF="../../../../net/jini/security/TrustVerifier.html" title="interface in net.jini.security">TrustVerifier</A> <B>getProxyVerifier</B>()
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Returns a <code>TrustVerifier</code> that can be used to verify that
+ a proxy can be trusted as a proxy for the service; that is, the
+ <A HREF="../../../../net/jini/security/TrustVerifier.html#isTrustedObject(java.lang.Object, net.jini.security.TrustVerifier.Context)"><CODE>isTrustedObject</CODE></A> method of the
+ returned verifier can be called with a candidate proxy. The verifier
+ should be able to verify all proxies for the service, including
+ proxies for resources (such as leases and registrations).
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>a <code>TrustVerifier</code> that can be used to verify that
+ a proxy can be trusted as a proxy for the service
+<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/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if the server is not configured
+ for trust verification</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/ServerProxyTrust.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../net/jini/security/proxytrust/ProxyTrustVerifier.html" title="class in net.jini.security.proxytrust"><B>PREV CLASS</B></A>
+ <A HREF="../../../../net/jini/security/proxytrust/SingletonProxyTrustIterator.html" title="class in net.jini.security.proxytrust"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/security/proxytrust/ServerProxyTrust.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ServerProxyTrust.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright 2007, multiple authors.<br>Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="child" >Apache License, Version 2.0</a>, see the <a href="../../../../doc-files/NOTICE" target="child" >NOTICE</a> file for attributions.
+</BODY>
+</HTML>