Repository: mina
Updated Branches:
  refs/heads/2.0 e5d1758cd -> cf5579e9a


Fixed teh last missing Javadoc in mina-core

Project: http://git-wip-us.apache.org/repos/asf/mina/repo
Commit: http://git-wip-us.apache.org/repos/asf/mina/commit/cf5579e9
Tree: http://git-wip-us.apache.org/repos/asf/mina/tree/cf5579e9
Diff: http://git-wip-us.apache.org/repos/asf/mina/diff/cf5579e9

Branch: refs/heads/2.0
Commit: cf5579e9a3c62f34d3c4413fd2587c15e1306450
Parents: e5d1758
Author: Emmanuel Lécharny <elecha...@symas.com>
Authored: Fri Dec 9 15:50:00 2016 +0100
Committer: Emmanuel Lécharny <elecha...@symas.com>
Committed: Fri Dec 9 15:50:00 2016 +0100

----------------------------------------------------------------------
 .../handlers/http/AbstractAuthLogicHandler.java |   2 +-
 .../handlers/http/AbstractHttpLogicHandler.java |  15 ++-
 .../http/HttpAuthenticationMethods.java         |  13 +-
 .../proxy/handlers/http/HttpProxyConstants.java |  26 ++--
 .../proxy/handlers/http/HttpProxyRequest.java   |   8 +-
 .../handlers/http/HttpSmartProxyHandler.java    |  10 +-
 .../http/basic/HttpBasicAuthLogicHandler.java   |   2 +-
 .../http/basic/HttpNoAuthLogicHandler.java      |   2 +-
 .../http/digest/HttpDigestAuthLogicHandler.java |   2 +-
 .../http/ntlm/HttpNTLMAuthLogicHandler.java     |   2 +-
 .../proxy/handlers/http/ntlm/NTLMResponses.java |   3 +
 .../handlers/socks/Socks4LogicHandler.java      |   4 +-
 .../handlers/socks/Socks5LogicHandler.java      |  13 +-
 .../handlers/socks/SocksProxyConstants.java     | 119 ++++++++++++-------
 .../CompositeByteArrayRelativeWriter.java       |  34 +++++-
 15 files changed, 175 insertions(+), 80 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractAuthLogicHandler.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractAuthLogicHandler.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractAuthLogicHandler.java
index 5cded04..57ac6b4 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractAuthLogicHandler.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractAuthLogicHandler.java
@@ -38,7 +38,7 @@ import org.slf4j.LoggerFactory;
  * @since MINA 2.0.0-M3
  */
 public abstract class AbstractAuthLogicHandler {
-    private final static Logger logger = 
LoggerFactory.getLogger(AbstractAuthLogicHandler.class);
+    private static final Logger logger = 
LoggerFactory.getLogger(AbstractAuthLogicHandler.class);
 
     /**
      * The request to be handled by the proxy.

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractHttpLogicHandler.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractHttpLogicHandler.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractHttpLogicHandler.java
index 61785c0..a314519 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractHttpLogicHandler.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractHttpLogicHandler.java
@@ -46,13 +46,13 @@ import org.slf4j.LoggerFactory;
  * @since MINA 2.0.0-M3
  */
 public abstract class AbstractHttpLogicHandler extends 
AbstractProxyLogicHandler {
-    private final static Logger LOGGER = 
LoggerFactory.getLogger(AbstractHttpLogicHandler.class);
+    private static final Logger LOGGER = 
LoggerFactory.getLogger(AbstractHttpLogicHandler.class);
 
-    private final static String DECODER = 
AbstractHttpLogicHandler.class.getName() + ".Decoder";
+    private static final String DECODER = 
AbstractHttpLogicHandler.class.getName() + ".Decoder";
 
-    private final static byte[] HTTP_DELIMITER = new byte[] { '\r', '\n', 
'\r', '\n' };
+    private static final byte[] HTTP_DELIMITER = new byte[] { '\r', '\n', 
'\r', '\n' };
 
-    private final static byte[] CRLF_DELIMITER = new byte[] { '\r', '\n' };
+    private static final byte[] CRLF_DELIMITER = new byte[] { '\r', '\n' };
 
     // Parsing vars
 
@@ -114,6 +114,7 @@ public abstract class AbstractHttpLogicHandler extends 
AbstractProxyLogicHandler
      * @param nextFilter the next filter
      * @param buf the buffer holding received data
      */
+    @Override
     public synchronized void messageReceived(final NextFilter nextFilter, 
final IoBuffer buf) throws ProxyAuthException {
         LOGGER.debug(" messageReceived()");
 
@@ -268,7 +269,7 @@ public abstract class AbstractHttpLogicHandler extends 
AbstractProxyLogicHandler
             }
         } catch (Exception ex) {
             if (ex instanceof ProxyAuthException) {
-                throw ((ProxyAuthException) ex);
+                throw (ProxyAuthException) ex;
             }
 
             throw new ProxyAuthException("Handshake failed", ex);
@@ -334,12 +335,14 @@ public abstract class AbstractHttpLogicHandler extends 
AbstractProxyLogicHandler
 
         // Fires reconnection
         proxyIoSession.getConnector().connect(new 
IoSessionInitializer<ConnectFuture>() {
+            @Override
             public void initializeSession(final IoSession session, 
ConnectFuture future) {
                 LOGGER.debug("Initializing new session: {}", session);
                 session.setAttribute(ProxyIoSession.PROXY_SESSION, 
proxyIoSession);
                 proxyIoSession.setSession(session);
                 LOGGER.debug("  setting up proxyIoSession: {}", 
proxyIoSession);
                 future.addListener(new IoFutureListener<ConnectFuture>() {
+                    @Override
                     public void operationComplete(ConnectFuture future) {
                         // Reconnection is done so we send the
                         // request to the proxy
@@ -378,7 +381,7 @@ public abstract class AbstractHttpLogicHandler extends 
AbstractProxyLogicHandler
             throw new Exception("Invalid response code (" + statusLine[1] + 
"). Response: " + response);
         }
 
-        Map<String, List<String>> headers = new HashMap<String, 
List<String>>();
+        Map<String, List<String>> headers = new HashMap<>();
 
         for (int i = 1; i < responseLines.length; i++) {
             String[] args = responseLines[i].split(":\\s?", 2);

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpAuthenticationMethods.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpAuthenticationMethods.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpAuthenticationMethods.java
index 5f89490..924601c 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpAuthenticationMethods.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpAuthenticationMethods.java
@@ -33,8 +33,17 @@ import org.apache.mina.proxy.session.ProxyIoSession;
  * @since MINA 2.0.0-M3
  */
 public enum HttpAuthenticationMethods {
-
-    NO_AUTH(1), BASIC(2), NTLM(3), DIGEST(4);
+    /** No authentication */
+    NO_AUTH(1), 
+    
+    /** Basic authentication */
+    BASIC(2), 
+    
+    /** NTLM (Microsoft) authentication */
+    NTLM(3), 
+    
+    /** Digest authentication */
+    DIGEST(4);
 
     private final int id;
 

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpProxyConstants.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpProxyConstants.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpProxyConstants.java
index 7e07b96..fec0965 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpProxyConstants.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpProxyConstants.java
@@ -26,62 +26,64 @@ package org.apache.mina.proxy.handlers.http;
  * @since MINA 2.0.0-M3
  */
 public class HttpProxyConstants {
-
     /**
      * The HTTP CONNECT verb.
      */
-    public final static String CONNECT = "CONNECT";
+    public static final String CONNECT = "CONNECT";
 
     /**
      * The HTTP GET verb.
      */
-    public final static String GET = "GET";
+    public static final String GET = "GET";
 
     /**
      * The HTTP PUT verb.
      */
-    public final static String PUT = "PUT";
+    public static final String PUT = "PUT";
 
     /**
      * The HTTP 1.0 protocol version string.
      */
-    public final static String HTTP_1_0 = "HTTP/1.0";
+    public static final String HTTP_1_0 = "HTTP/1.0";
 
     /**
      * The HTTP 1.1 protocol version string.
      */
-    public final static String HTTP_1_1 = "HTTP/1.1";
+    public static final String HTTP_1_1 = "HTTP/1.1";
 
     /**
      * The CRLF character sequence used in HTTP protocol to end each line.
      */
-    public final static String CRLF = "\r\n";
+    public static final String CRLF = "\r\n";
 
     /**
      * The default keep-alive timeout we set to make proxy
      * connection persistent. Set to 300 ms.
      */
-    public final static String DEFAULT_KEEP_ALIVE_TIME = "300";
+    public static final String DEFAULT_KEEP_ALIVE_TIME = "300";
 
     // ProxyRequest properties
 
     /**
      * The username property. Used in auth mechs.
      */
-    public final static String USER_PROPERTY = "USER";
+    public static final String USER_PROPERTY = "USER";
 
     /**
      * The password property. Used in auth mechs.
      */
-    public final static String PWD_PROPERTY = "PWD";
+    public static final String PWD_PROPERTY = "PWD";
 
     /**
      * The domain name property. Used in auth mechs.
      */
-    public final static String DOMAIN_PROPERTY = "DOMAIN";
+    public static final String DOMAIN_PROPERTY = "DOMAIN";
 
     /**
      * The workstation name property. Used in auth mechs.
      */
-    public final static String WORKSTATION_PROPERTY = "WORKSTATION";
+    public static final String WORKSTATION_PROPERTY = "WORKSTATION";
+
+    private HttpProxyConstants() {
+    }
 }
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpProxyRequest.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpProxyRequest.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpProxyRequest.java
index ce2b1fa..69cf7f1 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpProxyRequest.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpProxyRequest.java
@@ -37,7 +37,7 @@ import org.slf4j.LoggerFactory;
  * @since MINA 2.0.0-M3
  */
 public class HttpProxyRequest extends ProxyRequest {
-    private final static Logger logger = 
LoggerFactory.getLogger(HttpProxyRequest.class);
+    private static final Logger logger = 
LoggerFactory.getLogger(HttpProxyRequest.class);
 
     /**
      * The HTTP verb.
@@ -68,7 +68,7 @@ public class HttpProxyRequest extends ProxyRequest {
      * The additionnal properties supplied to use with the proxy for 
      * authentication for example. 
      */
-    private transient Map<String, String> properties;
+    private Map<String, String> properties;
 
     /**
      * Constructor which creates a HTTP/1.0 CONNECT request to the specified 
@@ -189,7 +189,7 @@ public class HttpProxyRequest extends ProxyRequest {
     /**
      * @return the host to which we are connecting.
      */
-    public synchronized final String getHost() {
+    public final synchronized  String getHost() {
         if (host == null) {
             if (getEndpointAddress() != null && 
!getEndpointAddress().isUnresolved()) {
                 host = getEndpointAddress().getHostName();
@@ -280,7 +280,7 @@ public class HttpProxyRequest extends ProxyRequest {
         if (getHeaders() != null) {
             for (Map.Entry<String, List<String>> header : 
getHeaders().entrySet()) {
                 if (!hostHeaderFound) {
-                    hostHeaderFound = header.getKey().equalsIgnoreCase("host");
+                    hostHeaderFound = "host".equalsIgnoreCase(header.getKey());
                 }
 
                 for (String value : header.getValue()) {

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpSmartProxyHandler.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpSmartProxyHandler.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpSmartProxyHandler.java
index 17b5a56..b6895c9 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpSmartProxyHandler.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/HttpSmartProxyHandler.java
@@ -38,7 +38,7 @@ import org.slf4j.LoggerFactory;
  * @since MINA 2.0.0-M3
  */
 public class HttpSmartProxyHandler extends AbstractHttpLogicHandler {
-    private final static Logger logger = 
LoggerFactory.getLogger(HttpSmartProxyHandler.class);
+    private static final Logger logger = 
LoggerFactory.getLogger(HttpSmartProxyHandler.class);
 
     /**
      * Has the HTTP proxy request been sent ?
@@ -50,6 +50,11 @@ public class HttpSmartProxyHandler extends 
AbstractHttpLogicHandler {
      */
     private AbstractAuthLogicHandler authHandler;
 
+    /**
+     * Creates a new HttpSmartProxyHandler instance
+     * 
+     * @param proxyIoSession The Prowxy IoSession
+     */
     public HttpSmartProxyHandler(final ProxyIoSession proxyIoSession) {
         super(proxyIoSession);
     }
@@ -59,6 +64,7 @@ public class HttpSmartProxyHandler extends 
AbstractHttpLogicHandler {
      * 
      * @param nextFilter the next filter
      */
+    @Override
     public void doHandshake(final NextFilter nextFilter) throws 
ProxyAuthException {
         logger.debug(" doHandshake()");
 
@@ -98,7 +104,7 @@ public class HttpSmartProxyHandler extends 
AbstractHttpLogicHandler {
         List<String> values = response.getHeaders().get("Proxy-Authenticate");
         ProxyIoSession proxyIoSession = getProxyIoSession();
 
-        if (values == null || values.size() == 0) {
+        if (values == null || values.isEmpty()) {
             authHandler = 
HttpAuthenticationMethods.NO_AUTH.getNewHandler(proxyIoSession);
 
         } else if (getProxyIoSession().getPreferedOrder() == null) {

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpBasicAuthLogicHandler.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpBasicAuthLogicHandler.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpBasicAuthLogicHandler.java
index de15bc0..d2184c0 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpBasicAuthLogicHandler.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpBasicAuthLogicHandler.java
@@ -42,7 +42,7 @@ import org.slf4j.LoggerFactory;
  * @since MINA 2.0.0-M3
  */
 public class HttpBasicAuthLogicHandler extends AbstractAuthLogicHandler {
-    private final static Logger logger = 
LoggerFactory.getLogger(HttpBasicAuthLogicHandler.class);
+    private static final Logger logger = 
LoggerFactory.getLogger(HttpBasicAuthLogicHandler.class);
 
     /**
      * Build an HttpBasicAuthLogicHandler

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpNoAuthLogicHandler.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpNoAuthLogicHandler.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpNoAuthLogicHandler.java
index d2c8843..3085cf9 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpNoAuthLogicHandler.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpNoAuthLogicHandler.java
@@ -35,7 +35,7 @@ import org.slf4j.LoggerFactory;
  * @since MINA 2.0.0-M3
  */
 public class HttpNoAuthLogicHandler extends AbstractAuthLogicHandler {
-    private final static Logger logger = 
LoggerFactory.getLogger(HttpNoAuthLogicHandler.class);
+    private static final Logger logger = 
LoggerFactory.getLogger(HttpNoAuthLogicHandler.class);
 
     /**
      * Build an HttpNoAuthLogicHandler

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/digest/HttpDigestAuthLogicHandler.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/digest/HttpDigestAuthLogicHandler.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/digest/HttpDigestAuthLogicHandler.java
index 478f80c..7831436 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/digest/HttpDigestAuthLogicHandler.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/digest/HttpDigestAuthLogicHandler.java
@@ -48,7 +48,7 @@ import org.slf4j.LoggerFactory;
  */
 public class HttpDigestAuthLogicHandler extends AbstractAuthLogicHandler {
 
-    private final static Logger logger = 
LoggerFactory.getLogger(HttpDigestAuthLogicHandler.class);
+    private static final Logger logger = 
LoggerFactory.getLogger(HttpDigestAuthLogicHandler.class);
 
     /**
      * The challenge directives provided by the server.

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/HttpNTLMAuthLogicHandler.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/HttpNTLMAuthLogicHandler.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/HttpNTLMAuthLogicHandler.java
index 6c73988..a6e168d 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/HttpNTLMAuthLogicHandler.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/HttpNTLMAuthLogicHandler.java
@@ -44,7 +44,7 @@ import org.slf4j.LoggerFactory;
  */
 public class HttpNTLMAuthLogicHandler extends AbstractAuthLogicHandler {
 
-    private final static Logger LOGGER = 
LoggerFactory.getLogger(HttpNTLMAuthLogicHandler.class);
+    private static final Logger LOGGER = 
LoggerFactory.getLogger(HttpNTLMAuthLogicHandler.class);
 
     /**
      * The challenge provided by the server.

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/NTLMResponses.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/NTLMResponses.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/NTLMResponses.java
index b003998..93f3b95 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/NTLMResponses.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/NTLMResponses.java
@@ -45,6 +45,9 @@ public class NTLMResponses {
     public static final byte[] LM_HASH_MAGIC_CONSTANT =
             new byte[]{ 'K', 'G', 'S', '!', '@', '#', '$', '%' };
 
+    private NTLMResponses() {
+    }
+    
     /**
      * Calculates the LM Response for the given challenge, using the specified
      * password.

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks4LogicHandler.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks4LogicHandler.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks4LogicHandler.java
index 7fc1d64..75e89d6 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks4LogicHandler.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks4LogicHandler.java
@@ -36,7 +36,7 @@ import org.slf4j.LoggerFactory;
  */
 public class Socks4LogicHandler extends AbstractSocksLogicHandler {
 
-    private final static Logger logger = 
LoggerFactory.getLogger(Socks4LogicHandler.class);
+    private static final Logger logger = 
LoggerFactory.getLogger(Socks4LogicHandler.class);
 
     /**
      * @see AbstractSocksLogicHandler#AbstractSocksLogicHandler(ProxyIoSession)
@@ -52,6 +52,7 @@ public class Socks4LogicHandler extends 
AbstractSocksLogicHandler {
      * 
      * @param nextFilter the next filter
      */
+    @Override
     public void doHandshake(final NextFilter nextFilter) {
         logger.debug(" doHandshake()");
 
@@ -112,6 +113,7 @@ public class Socks4LogicHandler extends 
AbstractSocksLogicHandler {
      * @param nextFilter the next filter
      * @param buf the server response data buffer
      */
+    @Override
     public void messageReceived(final NextFilter nextFilter, final IoBuffer 
buf) {
         try {
             if (buf.remaining() >= SocksProxyConstants.SOCKS_4_RESPONSE_SIZE) {

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks5LogicHandler.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks5LogicHandler.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks5LogicHandler.java
index 3b00cdb..89df353 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks5LogicHandler.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks5LogicHandler.java
@@ -44,27 +44,27 @@ import org.slf4j.LoggerFactory;
  */
 public class Socks5LogicHandler extends AbstractSocksLogicHandler {
 
-    private final static Logger LOGGER = 
LoggerFactory.getLogger(Socks5LogicHandler.class);
+    private static final Logger LOGGER = 
LoggerFactory.getLogger(Socks5LogicHandler.class);
 
     /**
      * The selected authentication method attribute key.
      */
-    private final static String SELECTED_AUTH_METHOD = 
Socks5LogicHandler.class.getName() + ".SelectedAuthMethod";
+    private static final String SELECTED_AUTH_METHOD = 
Socks5LogicHandler.class.getName() + ".SelectedAuthMethod";
 
     /**
      * The current step in the handshake attribute key.
      */
-    private final static String HANDSHAKE_STEP = 
Socks5LogicHandler.class.getName() + ".HandshakeStep";
+    private static final String HANDSHAKE_STEP = 
Socks5LogicHandler.class.getName() + ".HandshakeStep";
 
     /**
      * The Java GSS-API context attribute key.
      */
-    private final static String GSS_CONTEXT = 
Socks5LogicHandler.class.getName() + ".GSSContext";
+    private static final String GSS_CONTEXT = 
Socks5LogicHandler.class.getName() + ".GSSContext";
 
     /**
      * Last GSS token received attribute key.
      */
-    private final static String GSS_TOKEN = Socks5LogicHandler.class.getName() 
+ ".GSSToken";
+    private static final String GSS_TOKEN = Socks5LogicHandler.class.getName() 
+ ".GSSToken";
 
     /**
      * @see AbstractSocksLogicHandler#AbstractSocksLogicHandler(ProxyIoSession)
@@ -81,6 +81,7 @@ public class Socks5LogicHandler extends 
AbstractSocksLogicHandler {
      * 
      * @param nextFilter the next filter
      */
+    @Override
     public synchronized void doHandshake(final NextFilter nextFilter) {
         LOGGER.debug(" doHandshake()");
 
@@ -282,6 +283,7 @@ public class Socks5LogicHandler extends 
AbstractSocksLogicHandler {
             } else if (step == SocksProxyConstants.SOCKS5_AUTH_STEP) {
                 // This step can happen multiple times like in GSSAPI auth for 
instance
                 buf = encodeAuthenticationPacket(request);
+                
                 // If buf is null then go to the next step
                 if (buf == null) {
                     step = SocksProxyConstants.SOCKS5_REQUEST_STEP;
@@ -307,6 +309,7 @@ public class Socks5LogicHandler extends 
AbstractSocksLogicHandler {
      * @param nextFilter the next filter
      * @param buf the buffered data received 
      */
+    @Override
     public synchronized void messageReceived(final NextFilter nextFilter, 
final IoBuffer buf) {
         try {
             int step = ((Integer) 
getSession().getAttribute(HANDSHAKE_STEP)).intValue();

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/SocksProxyConstants.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/SocksProxyConstants.java
 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/SocksProxyConstants.java
index e5b465f..0517d54 100644
--- 
a/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/SocksProxyConstants.java
+++ 
b/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/SocksProxyConstants.java
@@ -29,120 +29,155 @@ public class SocksProxyConstants {
     /**
      * SOCKS versions field values.
      */
-    public final static byte SOCKS_VERSION_4 = 0x04;
+    /** Socks V4 */
+    public static final byte SOCKS_VERSION_4 = 0x04;
 
-    public final static byte SOCKS_VERSION_5 = 0x05;
+    /** Socks V5 */
+    public static final byte SOCKS_VERSION_5 = 0x05;
 
-    public final static byte TERMINATOR = 0x00;
+    /** terminator */
+    public static final byte TERMINATOR = 0x00;
 
     /**
      * The size of a server to client response in a SOCKS4/4a negotiation.
      */
-    public final static int SOCKS_4_RESPONSE_SIZE = 8;
+    public static final int SOCKS_4_RESPONSE_SIZE = 8;
 
     /**
      * Invalid IP used in SOCKS 4a protocol to specify that the
      * client can't resolve the destination host's domain name.
      */
-    public final static byte[] FAKE_IP = new byte[] { 0, 0, 0, 10 };
+    public static final byte[] FAKE_IP = new byte[] { 0, 0, 0, 10 };
 
     /**
      * Command codes. 
      */
-    public final static byte ESTABLISH_TCPIP_STREAM = 0x01;
+    /** TCPIP stream */
+    public static final byte ESTABLISH_TCPIP_STREAM = 0x01;
 
-    public final static byte ESTABLISH_TCPIP_BIND = 0x02;
+    /** TCPIP bind */
+    public static final byte ESTABLISH_TCPIP_BIND = 0x02;
 
-    public final static byte ESTABLISH_UDP_ASSOCIATE = 0x03;
+    /** UDP associate */
+    public static final byte ESTABLISH_UDP_ASSOCIATE = 0x03;
 
     /**
      * SOCKS v4/v4a server reply codes.
      */
-    public final static byte V4_REPLY_REQUEST_GRANTED = 0x5a;
+    /** Request granted */
+    public static final byte V4_REPLY_REQUEST_GRANTED = 0x5a;
 
-    public final static byte V4_REPLY_REQUEST_REJECTED_OR_FAILED = 0x5b;
+    /** Request rejected or failed */
+    public static final byte V4_REPLY_REQUEST_REJECTED_OR_FAILED = 0x5b;
 
-    public final static byte V4_REPLY_REQUEST_FAILED_NO_IDENTD = 0x5c;
+    /** Request failed not identified */
+    public static final byte V4_REPLY_REQUEST_FAILED_NO_IDENTD = 0x5c;
 
-    public final static byte V4_REPLY_REQUEST_FAILED_ID_NOT_CONFIRMED = 0x5d;
+    /** Request failed identity not confirmed */
+    public static final byte V4_REPLY_REQUEST_FAILED_ID_NOT_CONFIRMED = 0x5d;
 
     /**
      * SOCKS v5 server reply codes.
      */
-    public final static byte V5_REPLY_SUCCEEDED = 0x00;
+    /** Success */
+    public static final byte V5_REPLY_SUCCEEDED = 0x00;
 
-    public final static byte V5_REPLY_GENERAL_FAILURE = 0x01;
+    /** General failure */
+    public static final byte V5_REPLY_GENERAL_FAILURE = 0x01;
 
-    public final static byte V5_REPLY_NOT_ALLOWED = 0x02;
+    /** Not allowed */
+    public static final byte V5_REPLY_NOT_ALLOWED = 0x02;
 
-    public final static byte V5_REPLY_NETWORK_UNREACHABLE = 0x03;
+    /** Network unreachable */
+    public static final byte V5_REPLY_NETWORK_UNREACHABLE = 0x03;
 
-    public final static byte V5_REPLY_HOST_UNREACHABLE = 0x04;
+    /** Host unreachable */
+    public static final byte V5_REPLY_HOST_UNREACHABLE = 0x04;
 
-    public final static byte V5_REPLY_CONNECTION_REFUSED = 0x05;
+    /** Connection refused */
+    public static final byte V5_REPLY_CONNECTION_REFUSED = 0x05;
 
-    public final static byte V5_REPLY_TTL_EXPIRED = 0x06;
+    /** TTL expired */
+    public static final byte V5_REPLY_TTL_EXPIRED = 0x06;
 
-    public final static byte V5_REPLY_COMMAND_NOT_SUPPORTED = 0x07;
+    /** Command not supported */
+    public static final byte V5_REPLY_COMMAND_NOT_SUPPORTED = 0x07;
 
-    public final static byte V5_REPLY_ADDRESS_TYPE_NOT_SUPPORTED = 0x08;
+    /** Address type not supported */
+    public static final byte V5_REPLY_ADDRESS_TYPE_NOT_SUPPORTED = 0x08;
 
-    /**
-     * SOCKS v5 address types.
-     */
-    public final static byte IPV4_ADDRESS_TYPE = 0x01;
+    /** IPV4 address types */
+    public static final byte IPV4_ADDRESS_TYPE = 0x01;
 
-    public final static byte DOMAIN_NAME_ADDRESS_TYPE = 0x03;
+    /** Domain name address type */
+    public static final byte DOMAIN_NAME_ADDRESS_TYPE = 0x03;
 
-    public final static byte IPV6_ADDRESS_TYPE = 0x04;
+    /** IPV6 address type */
+    public static final byte IPV6_ADDRESS_TYPE = 0x04;
 
     /**
      * SOCKS v5 handshake steps.
      */
-    public final static int SOCKS5_GREETING_STEP = 0;
+    /** Greeting step */
+    public static final int SOCKS5_GREETING_STEP = 0;
 
-    public final static int SOCKS5_AUTH_STEP = 1;
+    /** Authentication step */
+    public static final int SOCKS5_AUTH_STEP = 1;
 
-    public final static int SOCKS5_REQUEST_STEP = 2;
+    /** Request step */
+    public static final int SOCKS5_REQUEST_STEP = 2;
 
     /**
      * SOCKS v5 authentication methods.
      */
-    public final static byte NO_AUTH = 0x00;
+    /** No authentication */
+    public static final byte NO_AUTH = 0x00;
 
-    public final static byte GSSAPI_AUTH = 0x01;
+    /** GSSAPI authentication */
+    public static final byte GSSAPI_AUTH = 0x01;
 
-    public final static byte BASIC_AUTH = 0x02;
+    /** Basic authentication */
+    public static final byte BASIC_AUTH = 0x02;
 
-    public final static byte NO_ACCEPTABLE_AUTH_METHOD = (byte) 0xFF;
+    /** Non acceptable method authentication */
+    public static final byte NO_ACCEPTABLE_AUTH_METHOD = (byte) 0xFF;
 
-    public final static byte[] SUPPORTED_AUTH_METHODS = new byte[] { NO_AUTH, 
GSSAPI_AUTH, BASIC_AUTH };
+    /** Supported authentication methods */
+    public static final byte[] SUPPORTED_AUTH_METHODS = new byte[] { NO_AUTH, 
GSSAPI_AUTH, BASIC_AUTH };
 
-    public final static byte BASIC_AUTH_SUBNEGOTIATION_VERSION = 0x01;
+    /** Basic authentication subnegociation version */
+    public static final byte BASIC_AUTH_SUBNEGOTIATION_VERSION = 0x01;
 
-    public final static byte GSSAPI_AUTH_SUBNEGOTIATION_VERSION = 0x01;
+    /** GSSAPI authentication subnegociation version */
+    public static final byte GSSAPI_AUTH_SUBNEGOTIATION_VERSION = 0x01;
 
-    public final static byte GSSAPI_MSG_TYPE = 0x01;
+    /** GSSAPI message type */
+    public static final byte GSSAPI_MSG_TYPE = 0x01;
 
     /**
      * Kerberos providers OID's.
      */
-    public final static String KERBEROS_V5_OID = "1.2.840.113554.1.2.2";
+    /** Kerberos V5 OID */
+    public static final String KERBEROS_V5_OID = "1.2.840.113554.1.2.2";
 
-    public final static String MS_KERBEROS_V5_OID = "1.2.840.48018.1.2.2";
+    /** Microsoft Kerberos V5 OID */
+    public static final String MS_KERBEROS_V5_OID = "1.2.840.48018.1.2.2";
 
     /**
      * Microsoft NTLM security support provider.
      */
-    public final static String NTLMSSP_OID = "1.3.6.1.4.1.311.2.2.10";
+    public static final String NTLMSSP_OID = "1.3.6.1.4.1.311.2.2.10";
 
+    private SocksProxyConstants() {
+    }
+    
     /**
      * Return the string associated with the specified reply code.
      * 
      * @param code the reply code
      * @return the reply string
      */
-    public final static String getReplyCodeAsString(byte code) {
+    public static final String getReplyCodeAsString(byte code) {
         switch (code) {
         // v4 & v4a codes
         case V4_REPLY_REQUEST_GRANTED:

http://git-wip-us.apache.org/repos/asf/mina/blob/cf5579e9/mina-core/src/main/java/org/apache/mina/util/byteaccess/CompositeByteArrayRelativeWriter.java
----------------------------------------------------------------------
diff --git 
a/mina-core/src/main/java/org/apache/mina/util/byteaccess/CompositeByteArrayRelativeWriter.java
 
b/mina-core/src/main/java/org/apache/mina/util/byteaccess/CompositeByteArrayRelativeWriter.java
index e24c678..3969831 100644
--- 
a/mina-core/src/main/java/org/apache/mina/util/byteaccess/CompositeByteArrayRelativeWriter.java
+++ 
b/mina-core/src/main/java/org/apache/mina/util/byteaccess/CompositeByteArrayRelativeWriter.java
@@ -44,6 +44,11 @@ public class CompositeByteArrayRelativeWriter extends 
CompositeByteArrayRelative
      * An object that knows how to expand a <code>CompositeByteArray</code>.
      */
     public interface Expander {
+        /**
+         * Expand a ByteBuffer by minSize bytes
+         * @param cba The ByteBuffer to expand
+         * @param minSize The new added size
+         */
         void expand(CompositeByteArray cba, int minSize);
     }
 
@@ -52,6 +57,10 @@ public class CompositeByteArrayRelativeWriter extends 
CompositeByteArrayRelative
      * 
      */
     public static class NopExpander implements Expander {
+        /**
+         * {@inheritDoc}
+         */
+        @Override
         public void expand(CompositeByteArray cba, int minSize) {
             // Do nothing.
         }
@@ -68,11 +77,21 @@ public class CompositeByteArrayRelativeWriter extends 
CompositeByteArrayRelative
 
         private final int newComponentSize;
 
+        /**
+         * Creates a new ChunkedExpander instance
+         * 
+         * @param baf The byte array factory
+         * @param newComponentSize The new size
+         */
         public ChunkedExpander(ByteArrayFactory baf, int newComponentSize) {
             this.baf = baf;
             this.newComponentSize = newComponentSize;
         }
 
+        /**
+         * {@inheritDoc}
+         */
+        @Override
         public void expand(CompositeByteArray cba, int minSize) {
             int remaining = minSize;
             while (remaining > 0) {
@@ -88,7 +107,11 @@ public class CompositeByteArrayRelativeWriter extends 
CompositeByteArrayRelative
      * An object that knows how to flush a <code>ByteArray</code>.
      */
     public interface Flusher {
-        // document free() behaviour
+        /**
+         * Flush a byte array
+         * 
+         * @param ba The byte array to flush
+         */
         void flush(ByteArray ba);
     }
 
@@ -156,6 +179,7 @@ public class CompositeByteArrayRelativeWriter extends 
CompositeByteArrayRelative
     /**
      * {@inheritDoc}
      */
+    @Override
     public void skip(int length) {
         cursor.skip(length);
     }
@@ -170,6 +194,7 @@ public class CompositeByteArrayRelativeWriter extends 
CompositeByteArrayRelative
     /**
      * {@inheritDoc}
      */
+    @Override
     public void put(byte b) {
         prepareForAccess(1);
         cursor.put(b);
@@ -178,6 +203,7 @@ public class CompositeByteArrayRelativeWriter extends 
CompositeByteArrayRelative
     /**
      * {@inheritDoc}
      */
+    @Override
     public void put(IoBuffer bb) {
         prepareForAccess(bb.remaining());
         cursor.put(bb);
@@ -186,6 +212,7 @@ public class CompositeByteArrayRelativeWriter extends 
CompositeByteArrayRelative
     /**
      * {@inheritDoc}
      */
+    @Override
     public void putShort(short s) {
         prepareForAccess(2);
         cursor.putShort(s);
@@ -194,6 +221,7 @@ public class CompositeByteArrayRelativeWriter extends 
CompositeByteArrayRelative
     /**
      * {@inheritDoc}
      */
+    @Override
     public void putInt(int i) {
         prepareForAccess(4);
         cursor.putInt(i);
@@ -202,6 +230,7 @@ public class CompositeByteArrayRelativeWriter extends 
CompositeByteArrayRelative
     /**
      * {@inheritDoc}
      */
+    @Override
     public void putLong(long l) {
         prepareForAccess(8);
         cursor.putLong(l);
@@ -210,6 +239,7 @@ public class CompositeByteArrayRelativeWriter extends 
CompositeByteArrayRelative
     /**
      * {@inheritDoc}
      */
+    @Override
     public void putFloat(float f) {
         prepareForAccess(4);
         cursor.putFloat(f);
@@ -218,6 +248,7 @@ public class CompositeByteArrayRelativeWriter extends 
CompositeByteArrayRelative
     /**
      * {@inheritDoc}
      */
+    @Override
     public void putDouble(double d) {
         prepareForAccess(8);
         cursor.putDouble(d);
@@ -226,6 +257,7 @@ public class CompositeByteArrayRelativeWriter extends 
CompositeByteArrayRelative
     /**
      * {@inheritDoc}
      */
+    @Override
     public void putChar(char c) {
         prepareForAccess(2);
         cursor.putChar(c);

Reply via email to