You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hc.apache.org by ol...@apache.org on 2009/01/24 18:09:03 UTC

svn commit: r737399 - in /httpcomponents/httpcore/trunk: module-main/src/main/java/org/apache/http/impl/ module-nio/src/main/java/org/apache/http/impl/nio/

Author: olegk
Date: Sat Jan 24 17:09:03 2009
New Revision: 737399

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

Added:
    httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/package.html
Modified:
    httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/AbstractHttpClientConnection.java
    httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/AbstractHttpServerConnection.java
    httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/SocketHttpClientConnection.java
    httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/SocketHttpServerConnection.java
    httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultClientIOEventDispatch.java
    httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultNHttpClientConnection.java
    httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultNHttpServerConnection.java
    httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultServerIOEventDispatch.java
    httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/SSLClientIOEventDispatch.java
    httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/SSLServerIOEventDispatch.java

Modified: httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/AbstractHttpClientConnection.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/AbstractHttpClientConnection.java?rev=737399&r1=737398&r2=737399&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/AbstractHttpClientConnection.java (original)
+++ httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/AbstractHttpClientConnection.java Sat Jan 24 17:09:03 2009
@@ -106,8 +106,8 @@
      * {@link LaxContentLengthStrategy} implementation to be used for 
      * de-serializing entities received over this connection. 
      * <p>
-     * This method can be overridden in super class in order to create instances 
-     * of {@link EntityDeserializer} using a custom 
+     * This method can be overridden in a super class in order to create 
+     * instances of {@link EntityDeserializer} using a custom 
      * {@link ContentLengthStrategy}.
      * 
      * @return HTTP entity deserializer
@@ -121,8 +121,9 @@
      * {@link StrictContentLengthStrategy} implementation to be used for
      * serializing HTTP entities sent over this connection. 
      * <p>
-     * This method can be overridden in super class in order to create instances 
-     * of {@link EntitySerializer} using a custom {@link ContentLengthStrategy}.
+     * This method can be overridden in a super class in order to create 
+     * instances of {@link EntitySerializer} using a custom 
+     * {@link ContentLengthStrategy}.
      * 
      * @return HTTP entity serialzier.
      */
@@ -135,7 +136,7 @@
      * for creating {@link HttpResponse} objects received by over this 
      * connection.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link HttpResponseFactory} interface. 
      * 
      * @return HTTP response factory.
@@ -148,7 +149,7 @@
      * Creates an instance of {@link HttpMessageParser} to be used for parsing
      * HTTP responses received over this connection.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link HttpMessageParser} interface or
      * to pass a different implementation of {@link LineParser} to the 
      * the default implementation {@link HttpResponseParser}. 
@@ -169,7 +170,7 @@
      * Creates an instance of {@link HttpMessageWriter} to be used for 
      * writing out HTTP requests sent over this connection.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link HttpMessageWriter} interface or
      * to pass a different implementation of {@link LineFormatter} to the 
      * the default implementation {@link HttpRequestWriter}. 

Modified: httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/AbstractHttpServerConnection.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/AbstractHttpServerConnection.java?rev=737399&r1=737398&r2=737399&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/AbstractHttpServerConnection.java (original)
+++ httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/AbstractHttpServerConnection.java Sat Jan 24 17:09:03 2009
@@ -106,8 +106,8 @@
      * {@link LaxContentLengthStrategy} implementation to be used for 
      * de-serializing entities received over this connection. 
      * <p>
-     * This method can be overridden in super class in order to create instances 
-     * of {@link EntityDeserializer} using a custom 
+     * This method can be overridden in a super class in order to create 
+     * instances of {@link EntityDeserializer} using a custom 
      * {@link ContentLengthStrategy}.
      * 
      * @return HTTP entity deserializer
@@ -121,8 +121,9 @@
      * {@link StrictContentLengthStrategy} implementation to be used for
      * serializing HTTP entities sent over this connection. 
      * <p>
-     * This method can be overridden in super class in order to create instances 
-     * of {@link EntitySerializer} using a custom {@link ContentLengthStrategy}.
+     * This method can be overridden in a super class in order to create 
+     * instances of {@link EntitySerializer} using a custom 
+     * {@link ContentLengthStrategy}.
      * 
      * @return HTTP entity serialzier.
      */
@@ -135,7 +136,7 @@
      * for creating {@link HttpRequest} objects received by over this 
      * connection.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link HttpRequestFactory} interface. 
      * 
      * @return HTTP request factory.
@@ -148,7 +149,7 @@
      * Creates an instance of {@link HttpMessageParser} to be used for parsing
      * HTTP requests received over this connection.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link HttpMessageParser} interface or
      * to pass a different implementation of {@link LineParser} to the 
      * the default implementation {@link HttpRequestParser}. 
@@ -169,7 +170,7 @@
      * Creates an instance of {@link HttpMessageWriter} to be used for 
      * writing out HTTP responses sent over this connection.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link HttpMessageWriter} interface or
      * to pass a different implementation of {@link LineFormatter} to the 
      * the default implementation {@link HttpResponseWriter}. 

Modified: httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/SocketHttpClientConnection.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/SocketHttpClientConnection.java?rev=737399&r1=737398&r2=737399&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/SocketHttpClientConnection.java (original)
+++ httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/SocketHttpClientConnection.java Sat Jan 24 17:09:03 2009
@@ -82,7 +82,7 @@
      * Creates an instance of {@link SocketInputBuffer} to be used for 
      * receiving data from the given {@link Socket}.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a custom implementation of {@link SessionInputBuffer} interface.
      * 
      * @see SocketInputBuffer#SocketInputBuffer(Socket, int, HttpParams)
@@ -104,7 +104,7 @@
      * Creates an instance of {@link SessionOutputBuffer} to be used for 
      * sending data to the given {@link Socket}.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a custom implementation of {@link SocketOutputBuffer} interface.
      * 
      * @see SocketOutputBuffer#SocketOutputBuffer(Socket, int, HttpParams)

Modified: httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/SocketHttpServerConnection.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/SocketHttpServerConnection.java?rev=737399&r1=737398&r2=737399&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/SocketHttpServerConnection.java (original)
+++ httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/SocketHttpServerConnection.java Sat Jan 24 17:09:03 2009
@@ -101,7 +101,7 @@
      * Creates an instance of {@link SocketInputBuffer} to be used for 
      * receiving data from the given {@link Socket}.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a custom implementation of {@link SessionInputBuffer} interface.
      * 
      * @see SocketInputBuffer#SocketInputBuffer(Socket, int, HttpParams)
@@ -123,7 +123,7 @@
      * Creates an instance of {@link SessionOutputBuffer} to be used for 
      * sending data to the given {@link Socket}.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a custom implementation of {@link SocketOutputBuffer} interface.
      * 
      * @see SocketOutputBuffer#SocketOutputBuffer(Socket, int, HttpParams)

Modified: httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultClientIOEventDispatch.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultClientIOEventDispatch.java?rev=737399&r1=737398&r2=737399&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultClientIOEventDispatch.java (original)
+++ httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultClientIOEventDispatch.java Sat Jan 24 17:09:03 2009
@@ -82,9 +82,9 @@
     
     /**
      * Creates an instance of {@link HeapByteBufferAllocator} to be used 
-     * by HTTP connections for allocating {@link ByteBuffer} objects.
+     * by HTTP connections for allocating {@link java.nio.ByteBuffer} objects.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link ByteBufferAllocator} interface. 
      * 
      * @return byte buffer allocator.
@@ -97,7 +97,7 @@
      * Creates an instance of {@link DefaultHttpResponseFactory} to be used 
      * by HTTP connections for creating {@link HttpResponse} objects.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link HttpResponseFactory} interface. 
      * 
      * @return HTTP response factory.
@@ -110,7 +110,7 @@
      * Creates an instance of {@link DefaultNHttpClientConnection} based on the
      * given {@link IOSession}.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link NHttpClientIOTarget} interface. 
      * 
      * @param session the underlying I/O session. 

Modified: httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultNHttpClientConnection.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultNHttpClientConnection.java?rev=737399&r1=737398&r2=737399&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultNHttpClientConnection.java (original)
+++ httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultNHttpClientConnection.java Sat Jan 24 17:09:03 2009
@@ -41,6 +41,7 @@
 import org.apache.http.HttpResponseFactory;
 import org.apache.http.impl.nio.codecs.HttpRequestWriter;
 import org.apache.http.impl.nio.codecs.HttpResponseParser;
+import org.apache.http.nio.NHttpClientConnection;
 import org.apache.http.nio.NHttpClientIOTarget;
 import org.apache.http.nio.NHttpClientHandler;
 import org.apache.http.nio.NHttpMessageParser;
@@ -50,14 +51,37 @@
 import org.apache.http.nio.reactor.SessionInputBuffer;
 import org.apache.http.nio.reactor.SessionOutputBuffer;
 import org.apache.http.nio.util.ByteBufferAllocator;
+import org.apache.http.params.CoreConnectionPNames;
 import org.apache.http.params.HttpParams;
 
+/**
+ * Default implementation of the {@link NHttpClientConnection} interface.
+ * 
+ * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
+ *
+ * @version $Revision$
+ */
 public class DefaultNHttpClientConnection 
     extends NHttpConnectionBase implements NHttpClientIOTarget {
 
     protected final NHttpMessageParser responseParser;
     protected final NHttpMessageWriter requestWriter;
     
+    /**
+     * Creates a new instance of this class given the underlying I/O session.
+     * <p>
+     * The following HTTP parameters affect configuration of this connection:
+     * <p>
+     * The {@link CoreConnectionPNames#SOCKET_BUFFER_SIZE}
+     * parameter determines the size of the internal socket buffer. If not 
+     * defined or set to <code>-1</code> the default value will be chosen
+     * automatically.
+     * 
+     * @param session the underlying I/O session.
+     * @param responseFactory HTTP response factory.
+     * @param allocator byte buffer allocator.
+     * @param params HTTP parameters.
+     */
     public DefaultNHttpClientConnection(
             final IOSession session,
             final HttpResponseFactory responseFactory,
@@ -74,6 +98,15 @@
         this.session.setBufferStatus(this);
     }
     
+    /**
+     * Creates an instance of {@link HttpResponseParser} to be used 
+     * by this connection for parsing incoming {@link HttpResponse} messages.
+     * <p>
+     * This method can be overridden in a super class in order to provide 
+     * a different implementation of the {@link NHttpMessageParser} interface. 
+     * 
+     * @return HTTP response parser.
+     */
     protected NHttpMessageParser createResponseParser(
             final SessionInputBuffer buffer,
             final HttpResponseFactory responseFactory,
@@ -82,6 +115,15 @@
         return new HttpResponseParser(buffer, null, responseFactory, params);
     }
 
+    /**
+     * Creates an instance of {@link HttpRequestWriter} to be used 
+     * by this connection for writing out outgoing {@link HttpRequest} messages.
+     * <p>
+     * This method can be overridden by a super class in order to provide 
+     * a different implementation of the {@link NHttpMessageWriter} interface. 
+     * 
+     * @return HTTP response parser.
+     */
     protected NHttpMessageWriter createRequestWriter(
             final SessionOutputBuffer buffer,
             final HttpParams params) {

Modified: httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultNHttpServerConnection.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultNHttpServerConnection.java?rev=737399&r1=737398&r2=737399&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultNHttpServerConnection.java (original)
+++ httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultNHttpServerConnection.java Sat Jan 24 17:09:03 2009
@@ -43,6 +43,7 @@
 import org.apache.http.impl.nio.codecs.HttpResponseWriter;
 import org.apache.http.nio.NHttpMessageParser;
 import org.apache.http.nio.NHttpMessageWriter;
+import org.apache.http.nio.NHttpServerConnection;
 import org.apache.http.nio.NHttpServerIOTarget;
 import org.apache.http.nio.NHttpServiceHandler;
 import org.apache.http.nio.reactor.EventMask;
@@ -50,14 +51,37 @@
 import org.apache.http.nio.reactor.SessionInputBuffer;
 import org.apache.http.nio.reactor.SessionOutputBuffer;
 import org.apache.http.nio.util.ByteBufferAllocator;
+import org.apache.http.params.CoreConnectionPNames;
 import org.apache.http.params.HttpParams;
 
+/**
+ * Default implementation of the {@link NHttpServerConnection} interface.
+ * 
+ * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
+ *
+ * @version $Revision$
+ */
 public class DefaultNHttpServerConnection 
     extends NHttpConnectionBase implements NHttpServerIOTarget {
 
     protected final NHttpMessageParser requestParser;
     protected final NHttpMessageWriter responseWriter;
     
+    /**
+     * Creates a new instance of this class given the underlying I/O session.
+     * <p>
+     * The following HTTP parameters affect configuration of this connection:
+     * <p>
+     * The {@link CoreConnectionPNames#SOCKET_BUFFER_SIZE}
+     * parameter determines the size of the internal socket buffer. If not 
+     * defined or set to <code>-1</code> the default value will be chosen
+     * automatically.
+     * 
+     * @param session the underlying I/O session.
+     * @param requestFactory HTTP request factory.
+     * @param allocator byte buffer allocator.
+     * @param params HTTP parameters.
+     */
     public DefaultNHttpServerConnection(
             final IOSession session,
             final HttpRequestFactory requestFactory,
@@ -71,6 +95,15 @@
         this.responseWriter = createResponseWriter(this.outbuf, params);
     }
 
+    /**
+     * Creates an instance of {@link HttpRequestParser} to be used 
+     * by this connection for parsing incoming {@link HttpRequest} messages.
+     * <p>
+     * This method can be overridden in a super class in order to provide 
+     * a different implementation of the {@link NHttpMessageParser} interface. 
+     * 
+     * @return HTTP response parser.
+     */
     protected NHttpMessageParser createRequestParser(
             final SessionInputBuffer buffer,
             final HttpRequestFactory requestFactory,
@@ -79,6 +112,16 @@
         return new HttpRequestParser(buffer, null, requestFactory, params);
     }
     
+    /**
+     * Creates an instance of {@link HttpResponseWriter} to be used 
+     * by this connection for writing out outgoing {@link HttpResponse} 
+     * messages.
+     * <p>
+     * This method can be overridden by a super class in order to provide 
+     * a different implementation of the {@link NHttpMessageWriter} interface. 
+     * 
+     * @return HTTP response parser.
+     */
     protected NHttpMessageWriter createResponseWriter(
             final SessionOutputBuffer buffer,
             final HttpParams params) {

Modified: httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultServerIOEventDispatch.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultServerIOEventDispatch.java?rev=737399&r1=737398&r2=737399&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultServerIOEventDispatch.java (original)
+++ httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/DefaultServerIOEventDispatch.java Sat Jan 24 17:09:03 2009
@@ -31,8 +31,6 @@
 
 package org.apache.http.impl.nio;
 
-import java.nio.ByteBuffer;
-
 import org.apache.http.HttpRequest;
 import org.apache.http.HttpRequestFactory;
 import org.apache.http.impl.DefaultHttpRequestFactory;
@@ -82,15 +80,15 @@
         this.params = params;
     }
     
-     /**
-      * Creates an instance of {@link HeapByteBufferAllocator} to be used 
-      * by HTTP connections for allocating {@link ByteBuffer} objects.
-      * <p>
-      * This method can be overridden in super class in order to provide 
-      * a different implementation of the {@link ByteBufferAllocator} interface. 
-      * 
-      * @return byte buffer allocator.
-      */
+   /**
+    * Creates an instance of {@link HeapByteBufferAllocator} to be used 
+    * by HTTP connections for allocating {@link java.nio.ByteBuffer} objects.
+    * <p>
+    * This method can be overridden in a super class in order to provide 
+    * a different implementation of the {@link ByteBufferAllocator} interface. 
+    * 
+    * @return byte buffer allocator.
+    */
     protected ByteBufferAllocator createByteBufferAllocator() {
         return new HeapByteBufferAllocator(); 
     }
@@ -99,7 +97,7 @@
      * Creates an instance of {@link DefaultHttpRequestFactory} to be used 
      * by HTTP connections for creating {@link HttpRequest} objects.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link HttpRequestFactory} interface. 
      * 
      * @return HTTP request factory.
@@ -112,7 +110,7 @@
      * Creates an instance of {@link DefaultNHttpServerConnection} based on the
      * given {@link IOSession}.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link NHttpServerIOTarget} interface. 
      * 
      * @param session the underlying I/O session. 

Modified: httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/SSLClientIOEventDispatch.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/SSLClientIOEventDispatch.java?rev=737399&r1=737398&r2=737399&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/SSLClientIOEventDispatch.java (original)
+++ httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/SSLClientIOEventDispatch.java Sat Jan 24 17:09:03 2009
@@ -119,9 +119,9 @@
     
     /**
      * Creates an instance of {@link HeapByteBufferAllocator} to be used 
-     * by HTTP connections for allocating {@link ByteBuffer} objects.
+     * by HTTP connections for allocating {@link java.nio.ByteBuffer} objects.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link ByteBufferAllocator} interface. 
      * 
      * @return byte buffer allocator.
@@ -134,7 +134,7 @@
      * Creates an instance of {@link DefaultHttpResponseFactory} to be used 
      * by HTTP connections for creating {@link HttpResponse} objects.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link HttpResponseFactory} interface. 
      * 
      * @return HTTP response factory.
@@ -147,7 +147,7 @@
      * Creates an instance of {@link DefaultNHttpClientConnection} based on the
      * given SSL {@link IOSession}.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link NHttpClientIOTarget} interface. 
      * 
      * @param session the underlying SSL I/O session. 
@@ -166,7 +166,7 @@
      * Creates an instance of {@link SSLIOSession} decorating the given
      * {@link IOSession}.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of SSL I/O session. 
      * 
      * @param session the underlying I/O session. 

Modified: httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/SSLServerIOEventDispatch.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/SSLServerIOEventDispatch.java?rev=737399&r1=737398&r2=737399&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/SSLServerIOEventDispatch.java (original)
+++ httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/SSLServerIOEventDispatch.java Sat Jan 24 17:09:03 2009
@@ -120,9 +120,9 @@
     
     /**
      * Creates an instance of {@link HeapByteBufferAllocator} to be used 
-     * by HTTP connections for allocating {@link ByteBuffer} objects.
+     * by HTTP connections for allocating {@link java.nio.ByteBuffer} objects.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link ByteBufferAllocator} interface. 
      * 
      * @return byte buffer allocator.
@@ -135,7 +135,7 @@
      * Creates an instance of {@link DefaultHttpRequestFactory} to be used 
      * by HTTP connections for creating {@link HttpRequest} objects.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link HttpRequestFactory} interface. 
      * 
      * @return HTTP request factory.
@@ -148,7 +148,7 @@
      * Creates an instance of {@link DefaultNHttpServerConnection} based on the
      * given {@link IOSession}.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of the {@link NHttpServerIOTarget} interface. 
      * 
      * @param session the underlying SSL I/O session. 
@@ -167,7 +167,7 @@
      * Creates an instance of {@link SSLIOSession} decorating the given
      * {@link IOSession}.
      * <p>
-     * This method can be overridden in super class in order to provide 
+     * This method can be overridden in a super class in order to provide 
      * a different implementation of SSL I/O session. 
      * 
      * @param session the underlying I/O session. 

Added: httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/package.html
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/package.html?rev=737399&view=auto
==============================================================================
--- httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/package.html (added)
+++ httpcomponents/httpcore/trunk/module-nio/src/main/java/org/apache/http/impl/nio/package.html Sat Jan 24 17:09:03 2009
@@ -0,0 +1,41 @@
+<html>
+<head>
+<!--
+/*
+ * $HeadURL: https://svn.apache.org/repos/asf/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/package.html $
+ * $Revision: 496072 $
+ * $Date: 2007-01-14 13:22:55 +0100 (Sun, 14 Jan 2007) $
+ *
+ * ====================================================================
+ * 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>
+Default implementations for interfaces in
+{@link org.apache.http org.apache.http.nio}.
+
+</body>
+</html>