hc-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ol...@apache.org
Subject svn commit: r651813 - in /httpcomponents/httpclient/trunk: ./ module-client/src/main/java/org/apache/http/client/ module-client/src/main/java/org/apache/http/conn/ module-client/src/main/java/org/apache/http/conn/params/ module-client/src/main/java/org...
Date Sat, 26 Apr 2008 10:43:49 GMT
Author: olegk
Date: Sat Apr 26 03:43:34 2008
New Revision: 651813

URL: http://svn.apache.org/viewvc?rev=651813&view=rev
Log:
Javadoc fixes

Modified:
    httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/client/ClientRequestDirector.java
    httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/ClientConnectionRequest.java
    httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/package.html
    httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/params/ConnPerRoute.java
    httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/params/HttpConnectionManagerParams.java
    httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/DefaultClientConnection.java
    httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/AbstractConnPool.java
    httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/ConnPoolByRoute.java
    httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/PoolEntryRequest.java
    httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/package.html
    httpcomponents/httpclient/trunk/pom.xml

Modified: httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/client/ClientRequestDirector.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/client/ClientRequestDirector.java?rev=651813&r1=651812&r2=651813&view=diff
==============================================================================
--- httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/client/ClientRequestDirector.java
(original)
+++ httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/client/ClientRequestDirector.java
Sat Apr 26 03:43:34 2008
@@ -51,8 +51,6 @@
  * allocate connections, and return responses that depend on those
  * connections for reading the response entity. Such connections
  * MUST be released, but that is out of the scope of a request director.
- * The {@link #getConnection getConnection} provides access to the
- * connection that must be released when the response is handled.
  *
  * <p>
  * This interface and it's implementations replace the

Modified: httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/ClientConnectionRequest.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/ClientConnectionRequest.java?rev=651813&r1=651812&r2=651813&view=diff
==============================================================================
--- httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/ClientConnectionRequest.java
(original)
+++ httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/ClientConnectionRequest.java
Sat Apr 26 03:43:34 2008
@@ -2,8 +2,6 @@
 
 import java.util.concurrent.TimeUnit;
 
-import org.apache.http.conn.routing.HttpRoute;
-
 /**
  * Encapsulates a request for a {@link ManagedClientConnection}.
  */
@@ -13,7 +11,7 @@
      * Obtains a connection within a given time.
      * This method will block until a connection becomes available,
      * the timeout expires, or the connection manager is
-     * {@link #shutdown shut down}.
+     * {@link ClientConnectionManager#shutdown() shut down}.
      * Timeouts are handled with millisecond precision.
      * 
      * If {@link #abortRequest()} is called while this is blocking or
@@ -32,11 +30,11 @@
      * @throws InterruptedException
      *         if the calling thread is interrupted while waiting
      */
-    ManagedClientConnection getConnection(long timeout, TimeUnit unit) 
+    ManagedClientConnection getConnection(long timeout, TimeUnit tunit) 
         throws InterruptedException, ConnectionPoolTimeoutException;
     
     /**
-     * Aborts the call to {@link #getConnection(HttpRoute, long, TimeUnit)},
+     * Aborts the call to {@link #getConnection(long, TimeUnit)},
      * causing it to throw an {@link InterruptedException}.
      */
     void abortRequest();

Modified: httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/package.html
URL: http://svn.apache.org/viewvc/httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/package.html?rev=651813&r1=651812&r2=651813&view=diff
==============================================================================
--- httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/package.html
(original)
+++ httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/package.html
Sat Apr 26 03:43:34 2008
@@ -48,11 +48,11 @@
 {@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}.
+typically using a {@link org.apache.http.conn.scheme.SocketFactory SocketFactory}.
 The socket factory for a protocol
-{@link org.apache.http.conn.Scheme Scheme}
+{@link org.apache.http.conn.scheme.Scheme Scheme}
 such as "http" or "https" can be looked up in a
-{@link org.apache.http.conn.SchemeRegistry SchemeRegistry}.
+{@link org.apache.http.conn.scheme.SchemeRegistry SchemeRegistry}.
 Applications without a need for sophisticated connection management
 can use this layer directly.
 </p>

Modified: httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/params/ConnPerRoute.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/params/ConnPerRoute.java?rev=651813&r1=651812&r2=651813&view=diff
==============================================================================
--- httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/params/ConnPerRoute.java
(original)
+++ httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/params/ConnPerRoute.java
Sat Apr 26 03:43:34 2008
@@ -1,7 +1,7 @@
 /*
- * $HeadURL:$
- * $Revision:$
- * $Date:$
+ * $HeadURL$
+ * $Revision$
+ * $Date$
  *
  * ====================================================================
  *
@@ -33,14 +33,14 @@
 import org.apache.http.conn.routing.HttpRoute;
 
 /**
- * This interface interface is intended to lookup maximum number of connections 
+ * This interface is intended for looking up maximum number of connections 
  * allowed for for a given route. This class can be used by pooling 
  * {@link org.apache.http.conn.ClientConnectionManager connection managers} for 
  * a fine-grained control of connections on a per route basis. 
  * 
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  * 
- * @version $Revision:$
+ * @version $Revision$
  * 
  * @since 4.0
  */

Modified: httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/params/HttpConnectionManagerParams.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/params/HttpConnectionManagerParams.java?rev=651813&r1=651812&r2=651813&view=diff
==============================================================================
--- httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/params/HttpConnectionManagerParams.java
(original)
+++ httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/conn/params/HttpConnectionManagerParams.java
Sat Apr 26 03:43:34 2008
@@ -62,11 +62,13 @@
     };
     
     /**
-     * Sets maximum number of connections allowed per route lookup interface.
+     * Sets lookup interface for maximum number of connections allowed per route.
      *
-     * @param max The default maximum.
+     * @param params HTTP parameters
+     * @param connPerRoute lookup interface for maximum number of connections allowed 
+     *        per route
      * 
-     * @see ConnManagerPNames#MAX_HOST_CONNECTIONS
+     * @see ConnManagerPNames#MAX_CONNECTIONS_PER_ROUTE
      */
     public static void setMaxConnectionsPerRoute(final HttpParams params,
                                                 final ConnPerRoute connPerRoute) {
@@ -78,13 +80,13 @@
     }
 
     /**
-     * Returns maximum number of connections allowed per route lookup interface.
-     * 
-     * @param route     the route for which to get the maximum connections
+     * Returns lookup interface for maximum number of connections allowed per route.
      *
-     * @return The maximum number of connections allowed for the given route.
+     * @param params HTTP parameters
+     * 
+     * @return lookup interface for maximum number of connections allowed per route.
      * 
-     * @see ConnManagerPNames#MAX_HOST_CONNECTIONS
+     * @see ConnManagerPNames#MAX_CONNECTIONS_PER_ROUTE
      */
     public static ConnPerRoute getMaxConnectionsPerRoute(final HttpParams params) {
         if (params == null) {
@@ -102,6 +104,7 @@
     /**
      * Sets the maximum number of connections allowed.
      *
+     * @param params HTTP parameters
      * @param maxTotalConnections The maximum number of connections allowed.
      * 
      * @see ConnManagerPNames#MAX_TOTAL_CONNECTIONS
@@ -118,6 +121,8 @@
 
     /**
      * Gets the maximum number of connections allowed.
+     *
+     * @param params HTTP parameters
      *
      * @return The maximum number of connections allowed.
      * 

Modified: httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/DefaultClientConnection.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/DefaultClientConnection.java?rev=651813&r1=651812&r2=651813&view=diff
==============================================================================
--- httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/DefaultClientConnection.java
(original)
+++ httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/DefaultClientConnection.java
Sat Apr 26 03:43:34 2008
@@ -121,9 +121,12 @@
 
     /**
      * Force-closes this connection.
-     * If it is not yet {@link #open open} but {@link #announce announced},
-     * the associated socket is closed. That will interrupt a thread that
-     * is blocked on connecting the socket.
+     * If the connection is still in the process of being open (the method 
+     * {@link #opening opening} was already called but 
+     * {@link #openCompleted openCompleted} was not), the associated 
+     * socket that is being connected to a remote address will be closed. 
+     * That will interrupt a thread that is blocked on connecting 
+     * the socket.
      *
      * @throws IOException      in case of a problem
      */

Modified: httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/AbstractConnPool.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/AbstractConnPool.java?rev=651813&r1=651812&r2=651813&view=diff
==============================================================================
--- httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/AbstractConnPool.java
(original)
+++ httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/AbstractConnPool.java
Sat Apr 26 03:43:34 2008
@@ -151,8 +151,6 @@
      * @param timeout   the timeout, 0 or negative for no timeout
      * @param tunit     the unit for the <code>timeout</code>,
      *                  may be <code>null</code> only if there is no timeout
-     * @param operator  the connection operator, in case
-     *                  a connection has to be created
      *
      * @return  pool entry holding a connection for the route
      *

Modified: httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/ConnPoolByRoute.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/ConnPoolByRoute.java?rev=651813&r1=651812&r2=651813&view=diff
==============================================================================
--- httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/ConnPoolByRoute.java
(original)
+++ httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/ConnPoolByRoute.java
Sat Apr 26 03:43:34 2008
@@ -93,8 +93,6 @@
     
     /**
      * Creates a new connection pool, managed by route.
-     *
-     * @param mgr   the connection manager
      */
     public ConnPoolByRoute(final ClientConnectionOperator operator, final HttpParams params)
{
         super();

Modified: httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/PoolEntryRequest.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/PoolEntryRequest.java?rev=651813&r1=651812&r2=651813&view=diff
==============================================================================
--- httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/PoolEntryRequest.java
(original)
+++ httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/PoolEntryRequest.java
Sat Apr 26 03:43:34 2008
@@ -32,9 +32,7 @@
 
 import java.util.concurrent.TimeUnit;
 
-import org.apache.http.conn.ClientConnectionOperator;
 import org.apache.http.conn.ConnectionPoolTimeoutException;
-import org.apache.http.conn.routing.HttpRoute;
 
 /**
  * Encapsulates a request for a {@link BasicPoolEntry}.
@@ -59,11 +57,11 @@
      */
     BasicPoolEntry getPoolEntry(
             long timeout, 
-            TimeUnit unit) throws InterruptedException, ConnectionPoolTimeoutException;
+            TimeUnit tunit) throws InterruptedException, ConnectionPoolTimeoutException;
 
     /**
      * Aborts the active or next call to
-     * {@link #getPoolEntry(HttpRoute, long, TimeUnit, ClientConnectionOperator)}.
+     * {@link #getPoolEntry(long, TimeUnit)}.
      */
     void abortRequest();
     

Modified: httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/package.html
URL: http://svn.apache.org/viewvc/httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/package.html?rev=651813&r1=651812&r2=651813&view=diff
==============================================================================
--- httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/package.html
(original)
+++ httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/impl/conn/tsccm/package.html
Sat Apr 26 03:43:34 2008
@@ -138,7 +138,7 @@
 Most other classes in this package also belong to the Pool area.
 <br/>
 In the Operations area, you will find only the interfaces for
-operated connections as defined in {@link org.apache.http.conn}.
+operated connections as defined in the org.apache.http.conn package.
 The connection manager will work with all correct implementations
 of these interfaces. This package therefore does not define anything
 specific to the Operations area.

Modified: httpcomponents/httpclient/trunk/pom.xml
URL: http://svn.apache.org/viewvc/httpcomponents/httpclient/trunk/pom.xml?rev=651813&r1=651812&r2=651813&view=diff
==============================================================================
--- httpcomponents/httpclient/trunk/pom.xml (original)
+++ httpcomponents/httpclient/trunk/pom.xml Sat Apr 26 03:43:34 2008
@@ -99,7 +99,6 @@
       </plugin>
       <plugin>
         <artifactId>maven-assembly-plugin</artifactId>
-        <version>2.2-beta-1</version>
         <configuration>
           <descriptors>
             <descriptor>src/main/assembly/bin-unix.xml</descriptor>



Mime
View raw message