commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject svn commit: r1076421 - in /commons/proper/net/trunk/src: changes/changes.xml main/java/org/apache/commons/net/telnet/TelnetClient.java
Date Wed, 02 Mar 2011 21:55:35 GMT
Author: sebb
Date: Wed Mar  2 21:55:35 2011
New Revision: 1076421

URL: http://svn.apache.org/viewvc?rev=1076421&view=rev
Log:
NET-343 Telnet client: Support Client-initiated Subnegotiation Messages

Modified:
    commons/proper/net/trunk/src/changes/changes.xml
    commons/proper/net/trunk/src/main/java/org/apache/commons/net/telnet/TelnetClient.java

Modified: commons/proper/net/trunk/src/changes/changes.xml
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/changes/changes.xml?rev=1076421&r1=1076420&r2=1076421&view=diff
==============================================================================
--- commons/proper/net/trunk/src/changes/changes.xml (original)
+++ commons/proper/net/trunk/src/changes/changes.xml Wed Mar  2 21:55:35 2011
@@ -54,6 +54,9 @@ The <action> type attribute can be add,u
 
     <body>
         <release version="3.0" date="TBA" description="TBA">
+            <action issue="NET-343" dev="sebb" type="add">
+            Telnet client: Support Client-initiated Subnegotiation Messages.
+            </action>
             <action issue="NET-270" dev="sebb" type="fix">
             Incorrect error handling in method initiateListParsing of FTPClient.
             </action>

Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/telnet/TelnetClient.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/telnet/TelnetClient.java?rev=1076421&r1=1076420&r2=1076421&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/telnet/TelnetClient.java
(original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/telnet/TelnetClient.java
Wed Mar  2 21:55:35 2011
@@ -207,6 +207,30 @@ public class TelnetClient extends Telnet
     }
     /* Code Section added for supporting AYT (start)*/
 
+    /***
+     * Sends a protocol-specific subnegotiation message to the remote peer.
+     * {@link TelnetClient} will add the IAC SB &amp; IAC SE framing bytes;
+     * the first byte in {@code message} should be the appropriate telnet
+     * option code.
+     *
+     * <p>
+     * This method does not wait for any response. Subnegotiation messages
+     * sent by the remote end can be handled by registering an approrpriate
+     * {@link TelnetOptionHandler}.
+     * </p>
+     *
+     * @param message option code followed by subnegotiation payload
+     * @throws IllegalArgumentException if {@code message} has length zero
+     * @throws IOException if an I/O error occurs while writing the message
+     ***/
+    public void sendSubnegotiation(int[] message)
+    throws IOException, IllegalArgumentException
+    {
+        if (message.length < 1)
+            throw new IllegalArgumentException("zero length message");
+        _sendSubnegotiation(message);
+    }
+
     /* open TelnetOptionHandler functionality (start)*/
 
     /***



Mime
View raw message