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 22:03:59 UTC
svn commit: r1052636 [1/5] - in
/incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl: ./
class-use/
Author: sijskes
Date: Fri Dec 24 21:03:59 2010
New Revision: 1052636
URL: http://svn.apache.org/viewvc?rev=1052636&view=rev
Log:
doc integration
Added:
incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/ConfidentialityStrength.html
incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/HttpsEndpoint.html
incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/HttpsServerEndpoint.html
incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/SslEndpoint.html
incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/SslServerEndpoint.html
incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/SslTrustVerifier.html
incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/class-use/
incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/package-frame.html
incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/package-summary.html
incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/package-tree.html
incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/package-use.html
Added: incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/ConfidentialityStrength.html
URL: http://svn.apache.org/viewvc/incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/ConfidentialityStrength.html?rev=1052636&view=auto
==============================================================================
--- incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/ConfidentialityStrength.html (added)
+++ incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/ConfidentialityStrength.html Fri Dec 24 21:03:59 2010
@@ -0,0 +1,334 @@
+<!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:20 EST 2010 -->
+<TITLE>
+ConfidentialityStrength (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.jeri.ssl.ConfidentialityStrength class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="ConfidentialityStrength (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/ConfidentialityStrength.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">
+ PREV CLASS
+ <A HREF="../../../../net/jini/jeri/ssl/HttpsEndpoint.html" title="class in net.jini.jeri.ssl"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/jeri/ssl/ConfidentialityStrength.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ConfidentialityStrength.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 | <A HREF="#field_summary">FIELD</A> | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | 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.jeri.ssl</FONT>
+<BR>
+Class ConfidentialityStrength</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.ssl.ConfidentialityStrength</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/core/constraint/InvocationConstraint.html" title="interface in net.jini.core.constraint">InvocationConstraint</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public final class <B>ConfidentialityStrength</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/core/constraint/InvocationConstraint.html" title="interface in net.jini.core.constraint">InvocationConstraint</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>
+Represents a constraint that, if confidentiality of message contents is
+ ensured, the specified strength of confidentiality be used. <p>
+
+ The use of an instance of this constraint does not directly imply a <A HREF="../../../../net/jini/core/constraint/Confidentiality.html#YES"><CODE>Confidentiality.YES</CODE></A> constraint; that must be specified separately to ensure
+ that confidentiality is actually ensured. <p>
+
+ Serialization for this class is guaranteed to produce instances that are
+ comparable with <code>==</code>. <p>
+
+ This constraint is supported by the endpoints defined in this package. <p>
+
+ The <A HREF="../../../../net/jini/jeri/ssl/SslTrustVerifier.html" title="class in net.jini.jeri.ssl"><CODE>SslTrustVerifier</CODE></A> trust verifier may be used for establishing
+ trust in remote proxies that use instances of this class.
+<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="../../../../net/jini/jeri/ssl/SslEndpoint.html" title="class in net.jini.jeri.ssl"><CODE>SslEndpoint</CODE></A>,
+<A HREF="../../../../net/jini/jeri/ssl/SslServerEndpoint.html" title="class in net.jini.jeri.ssl"><CODE>SslServerEndpoint</CODE></A>,
+<A HREF="../../../../net/jini/jeri/ssl/HttpsEndpoint.html" title="class in net.jini.jeri.ssl"><CODE>HttpsEndpoint</CODE></A>,
+<A HREF="../../../../net/jini/jeri/ssl/HttpsServerEndpoint.html" title="class in net.jini.jeri.ssl"><CODE>HttpsServerEndpoint</CODE></A>,
+<A HREF="../../../../net/jini/jeri/ssl/SslTrustVerifier.html" title="class in net.jini.jeri.ssl"><CODE>SslTrustVerifier</CODE></A>,
+<A HREF="../../../../serialized-form.html#net.jini.jeri.ssl.ConfidentialityStrength">Serialized Form</A></DL>
+<HR>
+
+<P>
+<!-- =========== FIELD SUMMARY =========== -->
+
+<A NAME="field_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Field Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../net/jini/jeri/ssl/ConfidentialityStrength.html" title="class in net.jini.jeri.ssl">ConfidentialityStrength</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/jeri/ssl/ConfidentialityStrength.html#STRONG">STRONG</A></B></CODE>
+
+<BR>
+ If confidentiality of message contents is ensured, then use strong
+ confidentiality for message contents.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../net/jini/jeri/ssl/ConfidentialityStrength.html" title="class in net.jini.jeri.ssl">ConfidentialityStrength</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/jeri/ssl/ConfidentialityStrength.html#WEAK">WEAK</A></B></CODE>
+
+<BR>
+ If confidentiality of message contents is ensured, then use weak
+ confidentiality for message contents.</TD>
+</TR>
+</TABLE>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="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/ssl/ConfidentialityStrength.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#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://
java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ FIELD DETAIL =========== -->
+
+<A NAME="field_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Field Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="STRONG"><!-- --></A><H3>
+STRONG</H3>
+<PRE>
+public static final <A HREF="../../../../net/jini/jeri/ssl/ConfidentialityStrength.html" title="class in net.jini.jeri.ssl">ConfidentialityStrength</A> <B>STRONG</B></PRE>
+<DL>
+<DD>If confidentiality of message contents is ensured, then use strong
+ confidentiality for message contents. <p>
+
+ For the endpoints in this package, this constraint is supported by
+ cipher suites with the following cipher algorithms:
+
+ <ul>
+ <li> 3DES_EDE_CBC
+ <li> AES_128_CBC
+ <li> AES_256_CBC
+ <li> IDEA_CBC
+ <li> RC4_128
+ </ul>
+<P>
+<DL>
+</DL>
+</DL>
+<HR>
+
+<A NAME="WEAK"><!-- --></A><H3>
+WEAK</H3>
+<PRE>
+public static final <A HREF="../../../../net/jini/jeri/ssl/ConfidentialityStrength.html" title="class in net.jini.jeri.ssl">ConfidentialityStrength</A> <B>WEAK</B></PRE>
+<DL>
+<DD>If confidentiality of message contents is ensured, then use weak
+ confidentiality for message contents. <p>
+
+ For the endpoints in this package, this constraint is supported by
+ cipher suites with the following cipher algorithms:
+
+ <ul>
+ <li> DES40_CBC
+ <li> DES_CBC
+ <li> RC2_CBC_40
+ <li> RC4_40
+ </ul>
+<P>
+<DL>
+</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="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>
+<!-- ========= 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/ConfidentialityStrength.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">
+ PREV CLASS
+ <A HREF="../../../../net/jini/jeri/ssl/HttpsEndpoint.html" title="class in net.jini.jeri.ssl"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/jeri/ssl/ConfidentialityStrength.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ConfidentialityStrength.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 | <A HREF="#field_summary">FIELD</A> | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | 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/jeri/ssl/HttpsEndpoint.html
URL: http://svn.apache.org/viewvc/incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/HttpsEndpoint.html?rev=1052636&view=auto
==============================================================================
--- incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/HttpsEndpoint.html (added)
+++ incubator/river/site/trunk/content/river/doc/api/net/jini/jeri/ssl/HttpsEndpoint.html Fri Dec 24 21:03:59 2010
@@ -0,0 +1,843 @@
+<!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:20 EST 2010 -->
+<TITLE>
+HttpsEndpoint (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.jeri.ssl.HttpsEndpoint class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="HttpsEndpoint (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/HttpsEndpoint.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/ssl/ConfidentialityStrength.html" title="class in net.jini.jeri.ssl"><B>PREV CLASS</B></A>
+ <A HREF="../../../../net/jini/jeri/ssl/HttpsServerEndpoint.html" title="class in net.jini.jeri.ssl"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/jeri/ssl/HttpsEndpoint.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="HttpsEndpoint.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.jeri.ssl</FONT>
+<BR>
+Class HttpsEndpoint</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.ssl.HttpsEndpoint</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/Endpoint.html" title="interface in net.jini.jeri">Endpoint</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>HttpsEndpoint</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/Endpoint.html" title="interface in net.jini.jeri">Endpoint</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>, <A HREF="../../../../net/jini/security/proxytrust/TrustEquivalence.html" title="interface in net.jini.security.proxytrust">TrustEquivalence</A></DL>
+</PRE>
+
+<P>
+An implementation of <A HREF="../../../../net/jini/jeri/Endpoint.html" title="interface in net.jini.jeri"><CODE>Endpoint</CODE></A> that uses HTTPS (HTTP over TLS/SSL) to
+ support invocation constraints for communication through firewalls. <p>
+
+ Instances of this class are intended to be created by the <A HREF="../../../../net/jini/jeri/BasicJeriExporter.html" title="class in net.jini.jeri"><CODE>BasicJeriExporter</CODE></A> class when it calls <A HREF="../../../../net/jini/jeri/ServerEndpoint.html#enumerateListenEndpoints(net.jini.jeri.ServerEndpoint.ListenContext)"><CODE>enumerateListenEndpoints</CODE></A> on
+ instances of <A HREF="../../../../net/jini/jeri/ssl/HttpsServerEndpoint.html" title="class in net.jini.jeri.ssl"><CODE>HttpsServerEndpoint</CODE></A>. <p>
+
+ The <A HREF="../../../../net/jini/jeri/ssl/SslTrustVerifier.html" title="class in net.jini.jeri.ssl"><CODE>SslTrustVerifier</CODE></A> trust verifier may be used for establishing
+ trust in remote proxies that use instances of this class. <p>
+
+ This class supports at least the following constraints, possibly limited by
+ the available cipher suites: <p>
+
+ <ul>
+ <li> <A HREF="../../../../net/jini/core/constraint/ClientAuthentication.html" title="class in net.jini.core.constraint"><CODE>ClientAuthentication</CODE></A>
+ <li> <A HREF="../../../../net/jini/core/constraint/ClientMaxPrincipal.html" title="class in net.jini.core.constraint"><CODE>ClientMaxPrincipal</CODE></A>, when it contains an <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/security/auth/x500/X500Principal.html" title="class or interface in javax.security.auth.x500"><CODE>X500Principal</CODE></A>
+ <li> <A HREF="../../../../net/jini/core/constraint/ClientMaxPrincipalType.html" title="class in net.jini.core.constraint"><CODE>ClientMaxPrincipalType</CODE></A>, when it contains
+ <code>X500Principal</code>
+ <li> <A HREF="../../../../net/jini/core/constraint/ClientMinPrincipal.html" title="class in net.jini.core.constraint"><CODE>ClientMinPrincipal</CODE></A>, when it contains a single
+ <code>X500Principal</code> only
+ <li> <A HREF="../../../../net/jini/core/constraint/ClientMinPrincipalType.html" title="class in net.jini.core.constraint"><CODE>ClientMinPrincipalType</CODE></A>, when it contains
+ <code>X500Principal</code> only
+ <li> <A HREF="../../../../net/jini/core/constraint/Confidentiality.html" title="class in net.jini.core.constraint"><CODE>Confidentiality</CODE></A>
+ <li> <A HREF="../../../../net/jini/jeri/ssl/ConfidentialityStrength.html" title="class in net.jini.jeri.ssl"><CODE>ConfidentialityStrength</CODE></A>, a provider-specific constraint for
+ specifying weak or strong confidentiality
+ <li> <A HREF="../../../../net/jini/core/constraint/ConnectionAbsoluteTime.html" title="class in net.jini.core.constraint"><CODE>ConnectionAbsoluteTime</CODE></A>
+ <li> <A HREF="../../../../net/jini/core/constraint/ConstraintAlternatives.html" title="class in net.jini.core.constraint"><CODE>ConstraintAlternatives</CODE></A>, if the elements all have the same
+ actual class and at least one element is supported
+ <li> <A HREF="../../../../net/jini/core/constraint/Delegation.html#NO"><CODE>Delegation.NO</CODE></A>
+ <li> <A HREF="../../../../net/jini/core/constraint/Delegation.html#YES"><CODE>Delegation.YES</CODE></A>, trivially, for anonymous clients
+ <li> <A HREF="../../../../net/jini/core/constraint/DelegationAbsoluteTime.html" title="class in net.jini.core.constraint"><CODE>DelegationAbsoluteTime</CODE></A>, trivially, when delegation is not
+ supported
+ <li> <A HREF="../../../../net/jini/core/constraint/Integrity.html#YES"><CODE>Integrity.YES</CODE></A>
+ <li> <A HREF="../../../../net/jini/core/constraint/ServerAuthentication.html" title="class in net.jini.core.constraint"><CODE>ServerAuthentication</CODE></A>
+ <li> <A HREF="../../../../net/jini/core/constraint/ServerMinPrincipal.html" title="class in net.jini.core.constraint"><CODE>ServerMinPrincipal</CODE></A>, when it contains a single
+ <code>X500Principal</code> only
+ </ul> <p>
+
+ Note that <A HREF="../../../../net/jini/core/constraint/ConnectionRelativeTime.html" title="class in net.jini.core.constraint"><CODE>ConnectionRelativeTime</CODE></A> and <A HREF="../../../../net/jini/core/constraint/DelegationRelativeTime.html" title="class in net.jini.core.constraint"><CODE>DelegationRelativeTime</CODE></A>
+ constraints may be used at higher levels, but should be converted to the
+ associated absolute time constraints for use by this class. <p>
+
+ This class authenticates as a single <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/Principal.html" title="class or interface in java.security"><CODE>Principal</CODE></A> if the following
+ items are present in the current <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/security/auth/Subject.html" title="class or interface in javax.security.auth"><CODE>Subject</CODE></A>: <p>
+
+ <ul>
+ <li> One or more principals of type <code>X500Principal</code>
+ <li> For each principal, one or more certificate chains, stored as public
+ credentials, and represented by instances of <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/cert/CertPath.html" title="class or interface in java.security.cert"><CODE>CertPath</CODE></A>, whose
+ <code>getType</code> method returns "X.509", and for which calling
+ <code>getSubjectDN</code> on the certificate chain's first element
+ returns that principal's name
+ <li> For each certificate chain, an instance of <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/security/auth/x500/X500PrivateCredential.html" title="class or interface in javax.security.auth.x500"><CODE>X500PrivateCredential</CODE></A>, stored as a private credential, whose
+ <code>getCertificate</code> method returns a value equal to the first
+ element of the certificate chain, and whose <code>getPrivateKey</code>
+ method returns the associated private key
+ </ul> <p>
+
+ In addition, this class's <A HREF="../../../../net/jini/jeri/ssl/HttpsEndpoint.html#newRequest(net.jini.core.constraint.InvocationConstraints)"><CODE>newRequest</CODE></A> method will only
+ authenticate as a given principal if the caller has been granted <A HREF="../../../../net/jini/security/AuthenticationPermission.html" title="class in net.jini.security"><CODE>AuthenticationPermission</CODE></A> with that principal as the local principal, the
+ principal representing the authenticated identity of the server as the peer
+ principal, and the <code>connect</code> action. <p>
+
+ This class supports remote connections between authenticated servers and
+ authenticated or anonymous clients, and between anonymous servers and
+ anonymous clients. Connections between anonymous servers and authenticated
+ clients are not supported. Because of the suites available in the TLS/SSL
+ protocol, support for <A HREF="../../../../net/jini/core/constraint/Confidentiality.html#NO"><CODE>Confidentiality.NO</CODE></A> requires the server to
+ authenticate with an RSA public key. <p>
+
+ This class permits specifying a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/net/SocketFactory.html" title="class or interface in javax.net"><CODE>SocketFactory</CODE></A> for creating the
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/Socket.html" title="class or interface in java.net"><CODE>Socket</CODE></A> instances that it uses to make remote connections. These
+ socket factories should not be instances of <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/net/ssl/SSLSocketFactory.html" title="class or interface in javax.net.ssl"><CODE>SSLSocketFactory</CODE></A> or
+ return instances <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/net/ssl/SSLSocket.html" title="class or interface in javax.net.ssl"><CODE>SSLSocket</CODE></A>; it is the responsibility of the
+ implementation to establish a TLS/SSL connection over the socket it obtains
+ from the socket factory. <p>
+
+ A <code>SocketFactory</code> used with instances of this class should be
+ serializable, and must implement <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"><CODE>Object.equals</CODE></A> to
+ obey the guidelines that are specified for <code>equals</code> methods of
+ <A HREF="../../../../net/jini/jeri/Endpoint.html" title="interface in net.jini.jeri"><CODE>Endpoint</CODE></A> instances. <p>
+
+ This class recognizes the following system properties: <p>
+
+ <ul>
+ <li> https.proxyHost - The host name for the secure proxy server. The
+ default is to use no proxy server.
+ <li> https.proxyPort - The port for the secure proxy server. The default is
+ 443.
+ <li> http.nonProxyHosts - The names of hosts for which direct connections
+ should be made rather than using the proxy server. Each host name may
+ contain '<code>*</code>' wildcard characters in any position to match
+ zero or more of any characters within the name. Multiple host names may
+ be specified by separating the names with '<code>|</code>'
+ characters. The default is for all connections to use the proxy server
+ if one is specified.
+ </ul>
+<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="../../../../net/jini/jeri/ssl/HttpsServerEndpoint.html" title="class in net.jini.jeri.ssl"><CODE>HttpsServerEndpoint</CODE></A>,
+<A HREF="../../../../net/jini/jeri/ssl/ConfidentialityStrength.html" title="class in net.jini.jeri.ssl"><CODE>ConfidentialityStrength</CODE></A>,
+<A HREF="../../../../net/jini/jeri/ssl/SslTrustVerifier.html" title="class in net.jini.jeri.ssl"><CODE>SslTrustVerifier</CODE></A>,
+<A HREF="../../../../serialized-form.html#net.jini.jeri.ssl.HttpsEndpoint">Serialized Form</A><DT><B>Implementation Specifics:</B></DT>
+ <DD><!-- Implementation Specifics -->
+
+ This implementation uses the <a
+ href="http://java.sun.com/j2se/1.4/docs/guide/security/jsse/JSSERefGuide.html"
+ target="_top">Java(TM) Secure Socket Extension (JSSE)</a>. <p>
+
+ This implementation uses the <A HREF="../../../../net/jini/jeri/connection/ConnectionManager.html" title="class in net.jini.jeri.connection"><CODE>ConnectionManager</CODE></A> class to manage
+ connections. <p>
+
+ This implementation uses the following <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> instances in the
+ <code>net.jini.jeri.ssl</code> namespace: <p>
+
+ <ul>
+ <li> <a href="#init_logger">init</a> - problems during initialization
+ <li> <a href="#client_logger">client</a> - information about
+ client-side connections
+ </ul> <p>
+
+ <a name="init_logger"></a>
+ <table border="1" cellpadding="5" summary="Describes logging to the init
+ logger performed by the HttpsEndpoint class at different logging
+ levels">
+
+ <caption halign="center" valign="top"><b><code>
+ net.jini.jeri.ssl.init</code></b></caption>
+
+ <tr> <th scope="col"> Level <th scope="col"> Description
+
+ <tr> <td> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#WARNING" title="class or interface in java.util.logging"><CODE>WARNING</CODE></A> <td> problems with initializing JSSE
+
+ </table> <p>
+
+ <a name="client_logger"></a>
+ <table border="1" cellpadding="5" summary="Describes logging to the client
+ logger performed by the HttpsEndpoint class at different logging
+ levels">
+
+ <caption halign="center" valign="top"><b><code>
+ net.jini.jeri.ssl.client</code></b></caption>
+
+ <tr> <th scope="col"> Level <th scope="col"> Description
+
+ <tr> <td> <A HREF="../../../../com/sun/jini/logging/Levels.html#FAILED"><CODE>FAILED</CODE></A> <td> problems with outbound requests
+
+ <tr> <td> <A HREF="../../../../com/sun/jini/logging/Levels.html#HANDLED"><CODE>HANDLED</CODE></A> <td> exceptions caught involving
+ authentication
+
+ <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> authentication decisions; creating,
+ choosing, expiring, or closing connections; or handling outbound requests
+
+ <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> low level operation tracing
+
+ </table> <p>
+
+ This implementation uses the following security providers: <p>
+
+ <ul>
+ <li> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/net/ssl/SSLContext.html" title="class or interface in javax.net.ssl"><CODE>SSLContext</CODE></A>, with the protocol specified by the
+ <code>com.sun.jini.jeri.ssl.sslProtocol</code> system property, or
+ <code>"TLS"</code> if that property is not defined, to provide the
+ TLS/SSL implementation. The <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/net/ssl/SSLContext.html#init(javax.net.ssl.KeyManager[], javax.net.ssl.TrustManager[], java.security.SecureRandom)" title="class or interface in javax.net.ssl"><CODE>SSLContext.init</CODE></A>
+ method is called with <code>null</code> for the <code>random</code>
+ parameter to use the default <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/SecureRandom.html" title="class or interface in java.security"><CODE>SecureRandom</CODE></A> implementation.
+ <li> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/cert/CertificateFactory.html" title="class or interface in java.security.cert"><CODE>CertificateFactory</CODE></A>, with type <code>"X.509"</code>, to generate
+ <code>CertPath</code> instances from X.509 certificate chains
+ <li> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/net/ssl/TrustManagerFactory.html" title="class or interface in javax.net.ssl"><CODE>TrustManagerFactory</CODE></A>, with the algorithm specified by the
+ <code>com.sun.jini.jeri.ssl.trustManagerFactoryAlgorithm</code> system
+ property, or the default algorithm if that property is not defined, to
+ implement trust management for the TLS/SSL implementation. The factory
+ must return trust managers that implement <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/net/ssl/X509TrustManager.html" title="class or interface in javax.net.ssl"><CODE>X509TrustManager</CODE></A>.
+ </ul> <p>
+
+ See the documentation on <a
+ href="http://java.sun.com/j2se/1.4/docs/guide/security/CryptoSpec.html#ProviderInstalling"
+ target="_top">installing security providers</a> and <a
+ href="http://java.sun.com/j2se/1.4/docs/guide/security/jsse/JSSERefGuide.html#ProviderCust"
+ target="_top">configuring JSSE</a> for information on configuring these
+ providers. <p>
+
+ The <a
+ href="http://java.sun.com/j2se/1.4/docs/guide/security/jsse/JSSERefGuide.html#Customization"
+ target="_top">JSSE documentation</a> also describes the system properties
+ for configuring the location, type, and password of the truststore that this
+ implementation uses, through JSSE, to make decisions about what certificate
+ chains should be trusted. <p>
+
+ This implementation recognizes the following system properties: <p>
+
+ <ul>
+ <li> <code>com.sun.jini.jeri.ssl.maxClientSessionDuration</code> - The
+ maximum number of milliseconds a client-side TLS/SSL session should be
+ used. The default is 23.5 hours. The value should be smaller than the
+ maximum server session duration to allow the client to negotiate a new
+ session before the server timeout occurs.
+ <li> <code>com.sun.jini.jeri.ssl.sslProtocol</code> - The secure socket
+ protocol used when obtaining <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/net/ssl/SSLContext.html" title="class or interface in javax.net.ssl"><CODE>SSLContext</CODE></A> instances. The default
+ is <code>"TLS"</code>.
+ <li> <code>com.sun.jini.jeri.ssl.trustManagerFactoryAlgorithm</code> - The
+ algorithm used when obtaining <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/net/ssl/TrustManagerFactory.html" title="class or interface in javax.net.ssl"><CODE>TrustManagerFactory</CODE></A>
+ instances. The default is the value returned by <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/net/ssl/TrustManagerFactory.html#getDefaultAlgorithm()" title="class or interface in javax.net.ssl"><CODE>TrustManagerFactory.getDefaultAlgorithm</CODE></A>.
+ <li> <code>com.sun.jini.jeri.ssl.cipherSuites</code> - The TLS/SSL cipher
+ suites that should be used for communication. The default is the list
+ of suites supported by the JSSE implementation. The value should
+ specify the suite names, separated by commas. The value will be ignored
+ if it contains no suites or specifies suites that are not supported by
+ the JSSE implementation. Suites appearing earlier in the list will be
+ preferred to ones appearing later for suites that support the same
+ requirements and preferences.
+ <li> <code>com.sun.jini.jeri.https.idleConnectionTimeout</code> - The number
+ of milliseconds to retain idle client-side HTTPS connections before
+ closing them. The default is <code>15000</code>.
+ <li> <code>com.sun.jini.jeri.https.responseAckTimeout</code> - The number of
+ milliseconds to keep track of acknowledgments that have not yet been
+ sent for <A HREF="../../../../net/jini/io/context/AcknowledgmentSource.html" title="interface in net.jini.io.context"><CODE>AcknowledgmentSource</CODE></A> instances. The default is
+ <code>15000</code>.
+ <li> <code>com.sun.jini.jeri.https.pingProxyConnections</code> - If
+ the value is case-insensitive equal to <code>true</code>, then if an
+ HTTP proxy is being used, ping the server endpoint to verify whether
+ it is alive and reachable. The ping occurs before the first request
+ and before each subsequent request which follows the expiration of
+ the ping proxy timeout period (below) following the previous ping.
+ When using an HTTP proxy it is often impossible to distinguish
+ between inability to reach the server endpoint (such as because the
+ server process refused a connection by the HTTP proxy) and the lack
+ of response from a delivered request (which might result in an
+ UnmarshalException). The ping increases the likelihood that the
+ inability to reach the server endpoint can be explicitly identified.
+ The default value is <code>false</code>, and no pings are done.
+ <li> <code>com.sun.jini.jeri.https.pingProxyConnectionTimeout</code> - The
+ number of milliseconds from the time a server endpoint was last
+ pinged before a ping will precede the next request. The default is
+ <code>Long.MAX_VALUE</code> (essentially meaning, ping only before
+ the first request).
+ </ul></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/jeri/ssl/HttpsEndpoint.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
+ <code>HttpsEndpoint</code> with the same values for server host and
+ port; and either both this instance and the argument have
+ <code>null</code> socket factories, or the factories have the same
+ actual class and are equal; 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/jeri/ssl/HttpsEndpoint.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> object)</CODE>
+
+<BR>
+ Two instances of this class are equal if they have the same values for
+ server host and port; and have socket factories that are either both
+ <code>null</code>, or have the same actual class and are equal.</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/ssl/HttpsEndpoint.html#getHost()">getHost</A></B>()</CODE>
+
+<BR>
+ Returns the server host that this endpoint connects to.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../net/jini/jeri/ssl/HttpsEndpoint.html" title="class in net.jini.jeri.ssl">HttpsEndpoint</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/jeri/ssl/HttpsEndpoint.html#getInstance(java.lang.String, int)">getInstance</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> serverHost,
+ int port)</CODE>
+
+<BR>
+ Returns an HTTPS endpoint for the specified server host and port.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../net/jini/jeri/ssl/HttpsEndpoint.html" title="class in net.jini.jeri.ssl">HttpsEndpoint</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/jeri/ssl/HttpsEndpoint.html#getInstance(java.lang.String, int, javax.net.SocketFactory)">getInstance</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> serverHost,
+ int port,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/net/SocketFactory.html" title="class or interface in javax.net">SocketFactory</A> socketFactory)</CODE>
+
+<BR>
+ Returns an HTTPS endpoint for the specified server host, port, and
+ socket factory.</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/ssl/HttpsEndpoint.html#getPort()">getPort</A></B>()</CODE>
+
+<BR>
+ Returns the TCP port that this endpoint connects to.</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/javax/net/SocketFactory.html" title="class or interface in javax.net">SocketFactory</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/jeri/ssl/HttpsEndpoint.html#getSocketFactory()">getSocketFactory</A></B>()</CODE>
+
+<BR>
+ Returns the socket factory that this endpoint uses to create <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/Socket.html" title="class or interface in java.net"><CODE>Socket</CODE></A> instances, or <code>null</code> if it uses default sockets.</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/ssl/HttpsEndpoint.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="../../../../net/jini/jeri/OutboundRequestIterator.html" title="interface in net.jini.jeri">OutboundRequestIterator</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/jeri/ssl/HttpsEndpoint.html#newRequest(net.jini.core.constraint.InvocationConstraints)">newRequest</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 request to this remote endpoint using the specified
+ constraints.
+
+ The returned <code>OutboundRequestIterator</code>'s <A HREF="../../../../net/jini/jeri/OutboundRequestIterator.html#next()"><CODE>next</CODE></A> method behaves as follows:
+
+
+
+ Initiates an attempt to communicate the request to this remote
+ endpoint.</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/ssl/HttpsEndpoint.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>
+
+<!-- ============ 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="getInstance(java.lang.String, int)"><!-- --></A><H3>
+getInstance</H3>
+<PRE>
+public static <A HREF="../../../../net/jini/jeri/ssl/HttpsEndpoint.html" title="class in net.jini.jeri.ssl">HttpsEndpoint</A> <B>getInstance</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> serverHost,
+ int port)</PRE>
+<DL>
+<DD>Returns an HTTPS endpoint for the specified server host and port. Uses a
+ <code>null</code> socket factory to create default sockets.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>serverHost</CODE> - the name of the server host<DD><CODE>port</CODE> - the server port
+<DT><B>Returns:</B><DD>an <code>HttpsEndpoint</code> instance
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if <code>port</code> is less than or
+ equal to <code>0</code>, or greater than <code>65535</code>
+<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>serverHost</code> is
+ <code>null</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getInstance(java.lang.String, int, javax.net.SocketFactory)"><!-- --></A><H3>
+getInstance</H3>
+<PRE>
+public static <A HREF="../../../../net/jini/jeri/ssl/HttpsEndpoint.html" title="class in net.jini.jeri.ssl">HttpsEndpoint</A> <B>getInstance</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> serverHost,
+ int port,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/net/SocketFactory.html" title="class or interface in javax.net">SocketFactory</A> socketFactory)</PRE>
+<DL>
+<DD>Returns an HTTPS endpoint for the specified server host, port, and
+ socket factory. A <code>socketFactory</code> of <code>null</code> uses
+ default sockets.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>serverHost</CODE> - the name of the server host<DD><CODE>port</CODE> - the server port<DD><CODE>socketFactory</CODE> - the socket factory, or <code>null</code>
+<DT><B>Returns:</B><DD>an <code>HttpsEndpoint</code> instance
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if <code>port</code> is less than or
+ equal to <code>0</code>, or greater than <code>65535</code>
+<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>serverHost</code> is
+ <code>null</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getHost()"><!-- --></A><H3>
+getHost</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>getHost</B>()</PRE>
+<DL>
+<DD>Returns the server host that this endpoint connects to.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the server host that this endpoint connects to</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getPort()"><!-- --></A><H3>
+getPort</H3>
+<PRE>
+public int <B>getPort</B>()</PRE>
+<DL>
+<DD>Returns the TCP port that this endpoint connects to.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the TCP port that this endpoint connects to</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getSocketFactory()"><!-- --></A><H3>
+getSocketFactory</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/net/SocketFactory.html" title="class or interface in javax.net">SocketFactory</A> <B>getSocketFactory</B>()</PRE>
+<DL>
+<DD>Returns the socket factory that this endpoint uses to create <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/Socket.html" title="class or interface in java.net"><CODE>Socket</CODE></A> instances, or <code>null</code> if it uses default sockets.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the socket factory that this endpoint uses to create sockets, or
+ <code>null</code> if it uses default sockets</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="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="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> object)</PRE>
+<DL>
+<DD>Two instances of this class are equal if they have the same values for
+ server host and port; and have socket factories that are either both
+ <code>null</code>, or have the same actual class and are equal.
+<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="newRequest(net.jini.core.constraint.InvocationConstraints)"><!-- --></A><H3>
+newRequest</H3>
+<PRE>
+public <A HREF="../../../../net/jini/jeri/OutboundRequestIterator.html" title="interface in net.jini.jeri">OutboundRequestIterator</A> <B>newRequest</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 request to this remote endpoint using the specified
+ constraints.
+
+ <p>The constraints must be the complete, absolute constraints
+ for the request. <p>
+
+ <p>The returned <code>OutboundRequestIterator</code>'s <A HREF="../../../../net/jini/jeri/OutboundRequestIterator.html#next()"><CODE>next</CODE></A> method behaves as follows:
+
+ <blockquote>
+
+ Initiates an attempt to communicate the request to this remote
+ endpoint.
+
+ <p>When the implementation of this method needs to create a new
+ <code>Socket</code>, it will do so by invoking one of the
+ <code>createSocket</code> methods on the
+ <code>SocketFactory</code> of this <code>HttpsEndpoint</code>
+ (which produced this iterator) if non-<code>null</code>, or it
+ will create a <code>Socket</code> directly otherwise.
+
+ <p>When the implementation needs to connect a
+ <code>Socket</code>, if the host name to connect to (if an HTTP
+ proxy is to be used for the communication, the proxy's host
+ name; otherwise, this <code>HttpsEndpoint</code>'s host name)
+ resolves to multiple addresses (according to <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/InetAddress.html#getAllByName(java.lang.String)" title="class or interface in java.net"><CODE>InetAddress.getAllByName</CODE></A>), it
+ attempts to connect to the first resolved address; if that
+ attempt fails with an <code>IOException</code> or (as is
+ possible in the case that an HTTP proxy is not to be used) a
+ <code>SecurityException</code>, it then attempts to connect to
+ the next address; and this iteration continues as long as there
+ is another resolved address and the attempt to connect to the
+ previous address fails with an <code>IOException</code> or a
+ <code>SecurityException</code>. If the host name resolves to
+ just one address, the implementation makes one attempt to
+ connect to that address. If the host name does not resolve to
+ any addresses (<code>InetAddress.getAllByName</code> would
+ throw an <code>UnknownHostException</code>), the implementation
+ still makes an attempt to connect the <code>Socket</code> to
+ that host name, which could result in an
+ <code>UnknownHostException</code>. If the final connection
+ attempt fails with an <code>IOException</code> or a
+ <code>SecurityException</code>, then if any connection attempt
+ failed with an <code>IOException</code>, this method throws an
+ <code>IOException</code>, and otherwise (if all connection
+ attempts failed with a <code>SecurityException</code>), this
+ method throws a <code>SecurityException</code>.
+
+ <p>If there is a security manager and an HTTP proxy is to be
+ used for the communication, the security manager's <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityManager.html#checkConnect(java.lang.String, int)" title="class or interface in java.lang"><CODE>checkConnect</CODE></A> method
+ is invoked with this <code>HttpsEndpoint</code>'s host and port;
+ if this results in a <code>SecurityException</code>, this
+ method throws that exception.
+
+ <p>If there is a security manager and an HTTP proxy is not to
+ be used for the communication:
+
+ <ul>
+
+ <li>If a new connection is to be created, the security
+ manager's <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityManager.html#checkConnect(java.lang.String, int)" title="class or interface in java.lang"><CODE>checkConnect</CODE></A> method is invoked with this
+ <code>HttpsEndpoint</code>'s host and <code>-1</code> for the
+ port; if this results in a <code>SecurityException</code>, this
+ method throws that exception. <code>checkConnect</code> is
+ also invoked for each connection attempt, with the remote IP
+ address (or the host name, if it could not be resolved) and
+ port to connect to; this could result in a
+ <code>SecurityException</code> for that attempt. (Note that
+ the implementation may carry out these security checks
+ indirectly, such as through invocations of
+ <code>InetAddress.getAllByName</code> or <code>Socket</code>'s
+ constructors or <code>connect</code> method.)
+
+ <li><p>In order to reuse an existing connection for the
+ communication, the current security context must have all of
+ the permissions that would be necessary if the connection were
+ being created. Specifically, it must be possible to invoke
+ <code>checkConnect</code> in the current security context with
+ this <code>HttpsEndpoint</code>'s host and <code>-1</code> for
+ the port without resulting in a <code>SecurityException</code>,
+ and it also must be possible to invoke
+ <code>checkConnect</code> with the remote IP address and port
+ of the <code>Socket</code> without resulting in a
+ <code>SecurityException</code> (if the remote socket address is
+ unresolved, its host name is used instead). If no existing
+ connection satisfies these requirements, then this method must
+ behave as if there are no existing connections.
+
+ </ul>
+
+ <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 request
+ (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 I/O exception occurs while
+ performing this operation, such as if a connection attempt
+ timed out or was refused or there are unsupported or conflicting
+ constraints.
+
+ <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 there is a security
+ manager and an invocation of its <code>checkConnect</code>
+ method fails, or if the caller does not have the appropriate
+ <code>AuthenticationPermission</code>.
+
+ </blockquote>
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jini/jeri/Endpoint.html#newRequest(net.jini.core.constraint.InvocationConstraints)">newRequest</A></CODE> in interface <CODE><A HREF="../../../../net/jini/jeri/Endpoint.html" title="interface in net.jini.jeri">Endpoint</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 request to this remote endpoint
+<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="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
+ <code>HttpsEndpoint</code> with the same values for server host and
+ port; and either both this instance and the argument have
+ <code>null</code> socket factories, or the factories have the same
+ actual class and are equal; 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>
+<!-- ========= 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/HttpsEndpoint.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/ssl/ConfidentialityStrength.html" title="class in net.jini.jeri.ssl"><B>PREV CLASS</B></A>
+ <A HREF="../../../../net/jini/jeri/ssl/HttpsServerEndpoint.html" title="class in net.jini.jeri.ssl"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/jeri/ssl/HttpsEndpoint.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="HttpsEndpoint.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>