You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@river.apache.org by bu...@apache.org on 2010/12/24 22:02:49 UTC
svn commit: r781505 [1/3] - in
/websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/http: ./
HttpEndpoint.html HttpServerEndpoint.html package-frame.html
package-summary.html package-tree.html package-use.html
Author: buildbot
Date: Fri Dec 24 21:02:49 2010
New Revision: 781505
Log:
Staging update by buildbot
Added:
websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/http/
websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/http/HttpEndpoint.html
websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/http/HttpServerEndpoint.html
websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/http/package-frame.html
websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/http/package-summary.html
websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/http/package-tree.html
websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/http/package-use.html
Added: websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/http/HttpEndpoint.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/http/HttpEndpoint.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/net/jini/jeri/http/HttpEndpoint.html Fri Dec 24 21:02:49 2010
@@ -0,0 +1,697 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Mon Mar 08 17:46:19 EST 2010 -->
+<TITLE>
+HttpEndpoint (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.jeri.http.HttpEndpoint class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="HttpEndpoint (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/HttpEndpoint.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/http/HttpServerEndpoint.html" title="class in net.jini.jeri.http"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/jeri/http/HttpEndpoint.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="HttpEndpoint.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.http</FONT>
+<BR>
+Class HttpEndpoint</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.http.HttpEndpoint</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>HttpEndpoint</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="../../../../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>
+An implementation of the <A HREF="../../../../net/jini/jeri/Endpoint.html" title="interface in net.jini.jeri"><CODE>Endpoint</CODE></A> abstraction that uses HTTP
+ messages sent over TCP sockets (instances of <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>) for the
+ underlying communication mechanism.
+
+ <p><code>HttpEndpoint</code> instances contain a host name and a
+ TCP port number, as well as an optional <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
+ customizing the type of <code>Socket</code> to use. The host name
+ and port number are used as the remote address to connect to when
+ making socket connections. Note that constructing an
+ <code>HttpEndpoint</code> with a <code>SocketFactory</code>
+ instance that produces SSL sockets does not result in an endpoint
+ that is fully HTTPS capable.
+
+ <p><code>HttpEndpoint</code> instances map outgoing requests to HTTP
+ request/response messages; when possible, underlying TCP connections are
+ reused for multiple non-overlapping outgoing requests. Outbound request
+ data is sent as the <code>entity-body</code> of an HTTP POST request;
+ inbound response data is received as the <code>entity-body</code> of the
+ corresponding HTTP response message. For information on HTTP, refer to <a
+ href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>.
+
+ <p><code>HttpEndpoint</code> can be configured via system properties to send
+ HTTP messages through an intermediary HTTP proxy server. It also supports
+ basic and digest HTTP authentication, specified in <a
+ href="http://www.ietf.org/rfc/rfc2617.txt">RFC 2617</a>. The mechanisms
+ involved in configuring each of these features are the same as those used by
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/HttpURLConnection.html" title="class or interface in java.net"><CODE>HttpURLConnection</CODE></A>; for details, see the
+ <A HREF="../../../../net/jini/jeri/http/package-summary.html"><CODE>net.jini.jeri.http</CODE></A> package documentation.
+
+ <p>A <code>SocketFactory</code> used with an
+ <code>HttpEndpoint</code> 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>
+
+<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/http/HttpServerEndpoint.html" title="class in net.jini.jeri.http"><CODE>HttpServerEndpoint</CODE></A>,
+<A HREF="../../../../serialized-form.html#net.jini.jeri.http.HttpEndpoint">Serialized Form</A></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/http/HttpEndpoint.html#checkTrustEquivalence(java.lang.Object)">checkTrustEquivalence</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> obj)</CODE>
+
+<BR>
+ Returns <code>true</code> if the specified object (which is not
+ yet known to be trusted) is equivalent in trust, content, and
+ function to this known trusted object, and <code>false</code>
+ otherwise.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/jeri/http/HttpEndpoint.html#equals(java.lang.Object)">equals</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> obj)</CODE>
+
+<BR>
+ Compares the specified object with this
+ <code>HttpEndpoint</code> for equality.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/jeri/http/HttpEndpoint.html#getHost()">getHost</A></B>()</CODE>
+
+<BR>
+ Returns the host that this <code>HttpEndpoint</code> 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/http/HttpEndpoint.html" title="class in net.jini.jeri.http">HttpEndpoint</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/jeri/http/HttpEndpoint.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> host,
+ int port)</CODE>
+
+<BR>
+ Returns an <code>HttpEndpoint</code> instance for the given host name
+ and TCP port number.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../net/jini/jeri/http/HttpEndpoint.html" title="class in net.jini.jeri.http">HttpEndpoint</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/jeri/http/HttpEndpoint.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> host,
+ 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> sf)</CODE>
+
+<BR>
+ Returns an <code>HttpEndpoint</code> instance for the given
+ host name and TCP port number that contains the given <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>.</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/http/HttpEndpoint.html#getPort()">getPort</A></B>()</CODE>
+
+<BR>
+ Returns the TCP port that this <code>HttpEndpoint</code> 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/http/HttpEndpoint.html#getSocketFactory()">getSocketFactory</A></B>()</CODE>
+
+<BR>
+ Returns the <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> 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> objects.</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/http/HttpEndpoint.html#hashCode()">hashCode</A></B>()</CODE>
+
+<BR>
+ Returns the hash code value for this <code>HttpEndpoint</code>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../../net/jini/jeri/OutboundRequestIterator.html" title="interface in net.jini.jeri">OutboundRequestIterator</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/jeri/http/HttpEndpoint.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/http/HttpEndpoint.html#toString()">toString</A></B>()</CODE>
+
+<BR>
+ Returns a string representation of this
+ <code>HttpEndpoint</code>.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/
docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ 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/http/HttpEndpoint.html" title="class in net.jini.jeri.http">HttpEndpoint</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> host,
+ int port)</PRE>
+<DL>
+<DD>Returns an <code>HttpEndpoint</code> instance for the given host name
+ and TCP port number. Note that if HTTP proxying is in effect, then an
+ explicit host name or IP address (i.e., not "localhost") must be
+ provided, or else the returned <code>HttpEndpoint</code> will be unable
+ to properly send requests through the proxy.
+
+ <p>The <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> contained in the returned
+ <code>HttpEndpoint</code> will be <code>null</code>, indicating
+ that this endpoint will 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> objects directly.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>host</CODE> - the host for the endpoint to connect to<DD><CODE>port</CODE> - the TCP port on the given host for the endpoint to
+ connect to
+<DT><B>Returns:</B><DD>an <code>HttpEndpoint</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 the port number is out of
+ the range <code>1</code> to <code>65535</code> (inclusive)
+<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>host</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/http/HttpEndpoint.html" title="class in net.jini.jeri.http">HttpEndpoint</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> host,
+ 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> sf)</PRE>
+<DL>
+<DD>Returns an <code>HttpEndpoint</code> instance for the given
+ host name and TCP port number that contains the given <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>. Note that if HTTP proxying is in effect, then
+ an explicit host name or IP address (i.e., not "localhost")
+ must be provided, or else the returned
+ <code>HttpEndpoint</code> will be unable to properly send
+ requests through the proxy.
+
+ <p>If the socket factory argument is <code>null</code>, then
+ this endpoint will 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> objects directly.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>host</CODE> - the host for the endpoint to connect to<DD><CODE>port</CODE> - the TCP port on the given host for the endpoint to
+ connect to<DD><CODE>sf</CODE> - the <code>SocketFactory</code> to use for this
+ <code>HttpEndpoint</code>, or <code>null</code>
+<DT><B>Returns:</B><DD>an <code>HttpEndpoint</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 the port number is out of
+ the range <code>1</code> to <code>65535</code> (inclusive)
+<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>host</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 host that this <code>HttpEndpoint</code> connects to.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the 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 <code>HttpEndpoint</code> 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 <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> 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> objects.
+<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 this endpoint creates sockets
+ directly</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>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>HttpEndpoint</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>HttpEndpoint</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>HttpEndpoint</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>HttpEndpoint</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>HttpEndpoint</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.
+
+ <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.
+
+ </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="hashCode()"><!-- --></A><H3>
+hashCode</H3>
+<PRE>
+public int <B>hashCode</B>()</PRE>
+<DL>
+<DD>Returns the hash code value for this <code>HttpEndpoint</code>.
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the hash code value for this <code>HttpEndpoint</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="equals(java.lang.Object)"><!-- --></A><H3>
+equals</H3>
+<PRE>
+public boolean <B>equals</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> obj)</PRE>
+<DL>
+<DD>Compares the specified object with this
+ <code>HttpEndpoint</code> for equality.
+
+ <p>This method returns <code>true</code> if and only if
+
+ <ul>
+
+ <li>the specified object is also an <code>HttpEndpoint</code>,
+
+ <li>the host and port in the specified object are equal to the
+ host and port in this object, and
+
+ <li>either this object and the specified object both have no
+ <code>SocketFactory</code> or the <code>SocketFactory</code> in
+ the specified object has the same class and is equal to the one
+ in this object.
+
+ </ul>
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>obj</CODE> - the object to compare with
+<DT><B>Returns:</B><DD><code>true</code> if <code>obj</code> is equivalent to
+ this object; <code>false</code> otherwise</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="checkTrustEquivalence(java.lang.Object)"><!-- --></A><H3>
+checkTrustEquivalence</H3>
+<PRE>
+public boolean <B>checkTrustEquivalence</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> obj)</PRE>
+<DL>
+<DD>Returns <code>true</code> if the specified object (which is not
+ yet known to be trusted) is equivalent in trust, content, and
+ function to this known trusted object, and <code>false</code>
+ otherwise.
+
+ <p>This method returns <code>true</code> if and only if
+
+ <ul>
+
+ <li>the specified object is also an <code>HttpEndpoint</code>,
+
+ <li>the host and port in the specified object are equal to the
+ host and port in this object, and
+
+ <li>either this object and the specified object both have no
+ <code>SocketFactory</code> or the <code>SocketFactory</code> in
+ the specified object has the same class and is equal to the one
+ in this object.
+
+ </ul>
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jini/security/proxytrust/TrustEquivalence.html#checkTrustEquivalence(java.lang.Object)">checkTrustEquivalence</A></CODE> in interface <CODE><A HREF="../../../../net/jini/security/proxytrust/TrustEquivalence.html" title="interface in net.jini.security.proxytrust">TrustEquivalence</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>obj</CODE> - object to check that is not yet known to be trusted
+<DT><B>Returns:</B><DD><code>true</code> if the specified object (that is not yet
+ known to be trusted) is equivalent in trust, content, and function to
+ this known trusted object, and returns <code>false</code> otherwise</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="toString()"><!-- --></A><H3>
+toString</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>toString</B>()</PRE>
+<DL>
+<DD>Returns a string representation of this
+ <code>HttpEndpoint</code>.
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>a string representation of this
+ <code>HttpEndpoint</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/HttpEndpoint.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/http/HttpServerEndpoint.html" title="class in net.jini.jeri.http"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/jeri/http/HttpEndpoint.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="HttpEndpoint.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>