You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hc.apache.org by ro...@apache.org on 2007/02/19 21:00:39 UTC
svn commit: r509322 - in
/jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn:
BasicManagedEntity.java package.html
Author: rolandw
Date: Mon Feb 19 12:00:39 2007
New Revision: 509322
URL: http://svn.apache.org/viewvc?view=rev&rev=509322
Log:
HttpConn package JavaDoc. Desperately needed.
Added:
jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn/package.html (with props)
Modified:
jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn/BasicManagedEntity.java
Modified: jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn/BasicManagedEntity.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn/BasicManagedEntity.java?view=diff&rev=509322&r1=509321&r2=509322
==============================================================================
--- jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn/BasicManagedEntity.java (original)
+++ jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn/BasicManagedEntity.java Mon Feb 19 12:00:39 2007
@@ -39,6 +39,9 @@
/**
* An entity that releases a {@link ManagedClientConnection connection}.
+ * A {@link ManagedClientConnection ManagedClientConnection} will
+ * typically <i>not</i> return a managed entity, but you can replace
+ * the unmanaged entity in the response with a managed one.
*
* @author <a href="mailto:rolandw at apache.org">Roland Weber</a>
*
Added: jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn/package.html
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn/package.html?view=auto&rev=509322
==============================================================================
--- jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn/package.html (added)
+++ jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn/package.html Mon Feb 19 12:00:39 2007
@@ -0,0 +1,105 @@
+<html>
+<head>
+<!--
+/*
+ * $HeadURL$
+ * $Revision$
+ * $Date$
+ *
+ * ====================================================================
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ * ====================================================================
+ *
+ * This software consists of voluntary contributions made by many
+ * individuals on behalf of the Apache Software Foundation. For more
+ * information on the Apache Software Foundation, please see
+ * <http://www.apache.org/>.
+ *
+ */
+-->
+</head>
+<body>
+The client-side connection management and handling API
+at the heart of what is referred to as <i>HttpConn</i>.
+This component provides interfaces and implementations for
+opening and managing connections as well as for handling
+routes from the client machine to a target HTTP server.
+
+<p>
+The lowest layer of connection handling is comprised of
+{@link org.apache.http.conn.OperatedClientConnection OperatedClientConnection}
+and
+{@link org.apache.http.conn.ClientConnectionOperator ClientConnectionOperator}.
+The connection interface extends the core
+{@link org.apache.http.HttpClientConnection HttpClientConnection}
+by operations to set and update a socket.
+An operator encapsulates the logic to open and layer sockets,
+typically using a {@link org.apache.http.conn.SocketFactory SocketFactory}.
+The socket factory for a protocol
+{@link org.apache.http.conn.Scheme Scheme}
+such as "http" or "https" can be looked up in a
+{@link org.apache.http.conn.SchemeRegistry SchemeRegistry}.
+Applications without a need for sophisticated connection management
+can use this layer directly.
+</p>
+
+<p>
+On top of that lies the connection management layer. A
+{@link org.apache.http.conn.ClientConnectionManager ClientConnectionManager}
+internally manages operated connections, but hands out instances of
+{@link org.apache.http.conn.ManagedClientConnection ManagedClientConnection}.
+This interface abstracts from the underlying socket operations and
+provides convenient methods for opening and updating sockets in order
+to establish a {@link org.apache.http.conn.HttpRoute route}.
+The operator is encapsulated by the connection manager and called
+automatically.
+
+<br/>
+
+Connections obtained from a manager have to be returned after use.
+This can be {@link org.apache.http.conn.ConnectionReleaseTrigger triggered}
+on various levels, either by releasing the
+{@link org.apache.http.conn.ManagedClientConnection
+ connection}
+directly, or by calling a method on an
+{@link org.apache.http.conn.BasicManagedEntity entity}
+received from the connection, or by closing the
+{@link org.apache.http.conn.EofSensorInputStream stream}
+from which that entity is being read.
+
+Connection managers will try to keep returned connections alive in
+order to re-use them for subsequent requests along the same route.
+The managed connection interface and all triggers for connection release
+provide methods to enable or disable this behavior.
+</p>
+
+<p>
+An {@link org.apache.http.conn.HttpRoute HttpRoute}
+is the path along which a request has to be sent to the server.
+The route starts at a local network address and may pass
+through a proxy before reaching the target. Routes through a
+proxy can be tunnelled, and a secure protocol (TLS/SSL)
+might be put on top of the tunnel.
+The {@link org.apache.http.conn.RouteTracker RouteTracker}
+helps in tracking the steps for establishing a route, while a
+{@link org.apache.http.conn.RouteDirector RouteDirector}
+determines the next step to take.
+</p>
+
+</body>
+</html>
Propchange: jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn/package.html
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn/package.html
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Propchange: jakarta/httpcomponents/httpclient/trunk/src/java/org/apache/http/conn/package.html
------------------------------------------------------------------------------
svn:mime-type = text/html