home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1996 May / PCW596.iso / wtest / clico / sunsoft / java / solaris.taz / solaris / hotjava / classsrc / net / TelnetOutputStream.java < prev    next >
Encoding:
Java Source  |  1995-05-15  |  3.9 KB  |  115 lines
  1. /*
  2.  * @(#)TelnetOutputStream.java    1.8 95/05/10 Jonathan Payne
  3.  *
  4.  * Copyright (c) 1994 Sun Microsystems, Inc. All Rights Reserved.
  5.  *
  6.  * Permission to use, copy, modify, and distribute this software
  7.  * and its documentation for NON-COMMERCIAL purposes and without
  8.  * fee is hereby granted provided that this copyright notice
  9.  * appears in all copies. Please refer to the file "copyright.html"
  10.  * for further important copyright and licensing information.
  11.  *
  12.  * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
  13.  * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  14.  * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  15.  * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
  16.  * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
  17.  * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
  18.  */
  19.  
  20. package net;
  21.  
  22. import java.io.*;
  23.  
  24. /**
  25.  * This class provides input and output streams for telnet clients.
  26.  * This class overrides write to do CRLF processing as specified in
  27.  * RFC 854. The class assumes it is running on a system where lines
  28.  * are terminated with a single newline <LF> character.
  29.  *
  30.  * This is the relevant section of RFC 824 regarding CRLF processing:
  31.  *
  32.  * <pre>
  33.  * The sequence "CR LF", as defined, will cause the NVT to be
  34.  * positioned at the left margin of the next print line (as would,
  35.  * for example, the sequence "LF CR").  However, many systems and
  36.  * terminals do not treat CR and LF independently, and will have to
  37.  * go to some effort to simulate their effect.  (For example, some
  38.  * terminals do not have a CR independent of the LF, but on such
  39.  * terminals it may be possible to simulate a CR by backspacing.)
  40.  * Therefore, the sequence "CR LF" must be treated as a single "new
  41.  * line" character and used whenever their combined action is
  42.  * intended; the sequence "CR NUL" must be used where a carriage
  43.  * return alone is actually desired; and the CR character must be
  44.  * avoided in other contexts.  This rule gives assurance to systems
  45.  * which must decide whether to perform a "new line" function or a
  46.  * multiple-backspace that the TELNET stream contains a character
  47.  * following a CR that will allow a rational decision.
  48.  *
  49.  *    Note that "CR LF" or "CR NUL" is required in both directions
  50.  *    (in the default ASCII mode), to preserve the symmetry of the
  51.  *    NVT model.  Even though it may be known in some situations
  52.  *    (e.g., with remote echo and suppress go ahead options in
  53.  *    effect) that characters are not being sent to an actual
  54.  *    printer, nonetheless, for the sake of consistency, the protocol
  55.  *    requires that a NUL be inserted following a CR not followed by
  56.  *    a LF in the data stream.  The converse of this is that a NUL
  57.  *    received in the data stream after a CR (in the absence of
  58.  *    options negotiations which explicitly specify otherwise) should
  59.  *    be stripped out prior to applying the NVT to local character
  60.  *    set mapping.
  61.  * </pre>
  62.  *
  63.  * @version    1.8, 10 May 1995
  64.  * @author    Jonathan Payne
  65.  */
  66.  
  67. public class TelnetOutputStream extends BufferedOutputStream {
  68.     boolean        stickyCRLF = false;
  69.     boolean        seenCR = false;
  70.  
  71.     public boolean  binaryMode = false;
  72.  
  73.     public TelnetOutputStream(FileOutputStream fd, boolean binary) {
  74.     super(fd);
  75.     binaryMode = binary;
  76.     }
  77.  
  78.     /**
  79.      * Writes the int to the stream and does CR LF processing if necessary.
  80.      */
  81.     public void write(int c) {
  82.     if (binaryMode)
  83.         super.write(c);
  84.     else {
  85.         if (seenCR) {
  86.         if (c != '\n')
  87.             super.write(0);        
  88.         } else if (c == '\r') {
  89.         if (stickyCRLF)
  90.             seenCR = true;
  91.         else {
  92.             super.write('\r');
  93.             c = 0;
  94.         }
  95.         }
  96.         super.write(c);
  97.     }
  98.     }
  99.  
  100.     /**
  101.      * Write the bytes at offset <i>off</i> in buffer <i>bytes</i> for
  102.      * <i>length</i> bytes.
  103.      */
  104.     public void write(byte bytes[], int off, int length) {
  105.     if (binaryMode) {
  106.         super.write(bytes, off, length);
  107.         return;
  108.     }
  109.  
  110.     while (--length >= 0) {
  111.         write(bytes[off++]);
  112.     }
  113.     }
  114. }
  115.