libjava/gnu/java/net/SocketOutputStream.java

   1 /* SocketOutputStream.java -- OutputStream for PlainSocketImpl
   2    Copyright (C) 1998,2000 Free Software Foundation, Inc.
   3
   4 This file is part of GNU Classpath.
   5
   6 GNU Classpath is free software; you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation; either version 2, or (at your option)
   9 any later version.
  10
  11 GNU Classpath is distributed in the hope that it will be useful, but
  12 WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with GNU Classpath; see the file COPYING.  If not, write to the
  18 Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  19 02111-1307 USA.
  20
  21 Linking this library statically or dynamically with other modules is
  22 making a combined work based on this library.  Thus, the terms and
  23 conditions of the GNU General Public License cover the whole
  24 combination.
  25
  26 As a special exception, the copyright holders of this library give you
  27 permission to link this library with independent modules to produce an
  28 executable, regardless of the license terms of these independent
  29 modules, and to copy and distribute the resulting executable under
  30 terms of your choice, provided that you also meet, for each linked
  31 independent module, the terms and conditions of the license of that
  32 module.  An independent module is a module which is not derived from
  33 or based on this library.  If you modify this library, you may extend
  34 this exception to your version of the library, but you are not
  35 obligated to do so.  If you do not wish to do so, delete this
  36 exception statement from your version. */
  37
  38
  39 package gnu.java.net;
  40
  41 import java.io.OutputStream;
  42 import java.io.IOException;
  43
  44 /**
  45   * This class is used internally by <code>PlainSocketImpl</code> to be the
  46   * <code>OutputStream</code> subclass returned by its
  47   * <code>getOutputStream method</code>.  It expects only to  be used in that
  48   * context.
  49   *
  50   * @author Aaron M. Renn (arenn@urbanophile.com)
  51   */
  52 class SocketOutputStream extends OutputStream
  53 {
  54
  55 /*************************************************************************/
  56
  57 /*
  58  * Instance Variables
  59  */
  60
  61 /**
  62   * The PlainSocketImpl object this stream is associated with
  63   */
  64 private PlainSocketImpl impl;
  65
  66 /*************************************************************************/
  67
  68 /*
  69  * Constructors
  70  */
  71
  72 /**
  73   * Build an instance of this class from a PlainSocketImpl object
  74   */
  75 protected
  76 SocketOutputStream(PlainSocketImpl impl)
  77 {
  78   this.impl = impl;
  79 }
  80
  81 /*************************************************************************/
  82
  83 /*
  84  * Instance Methods
  85  */
  86
  87 /**
  88   * This method closes the stream and the underlying socket connection.  This
  89   * action also effectively closes any other InputStream or OutputStream
  90   * object associated with the connection.
  91   *
  92   * @exception IOException If an error occurs
  93   */
  94 public void
  95 close() throws IOException
  96 {
  97   impl.close();
  98 }
  99
 100 /*************************************************************************/
 101
 102 /**
 103   * Hmmm, we don't seem to have a flush() method in Socket impl, so just
 104   * return for now, but this might need to be looked at later.
 105   *
 106   * @exception IOException Can't happen
 107   */
 108 public void
 109 flush() throws IOException
 110 {
 111   return;
 112 }
 113
 114 /*************************************************************************/
 115
 116 /**
 117   * Writes a byte (passed in as an int) to the given output stream
 118   *
 119   * @param b The byte to write
 120   *
 121   * @exception IOException If an error occurs
 122   */
 123 public void
 124 write(int b) throws IOException
 125 {
 126   byte buf[] = new byte[1];
 127
 128   Integer i = new Integer(b);
 129   buf[0] = i.byteValue();
 130
 131   write(buf, 0, buf.length);
 132 }
 133
 134 /*************************************************************************/
 135
 136 /**
 137   * Write an array of bytes to the output stream
 138   *
 139   * @param buf The array of bytes to write
 140   *
 141   * @exception IOException If an error occurs
 142   */
 143 public void
 144 write(byte[] buf) throws IOException
 145 {
 146   write(buf, 0, buf.length);
 147 }
 148
 149 /*************************************************************************/
 150
 151 /**
 152   * Writes len number of bytes from the array buf to the stream starting
 153   * at offset bytes into the buffer.
 154   *
 155   * @param buf The buffer
 156   * @param offset Offset into the buffer to start writing from
 157   * @param len The number of bytes to write
 158   */
 159 public void
 160 write(byte[] buf, int offset, int len) throws IOException
 161 {
 162   impl.write(buf, offset, len);
 163 }
 164
 165 } // class SocketOutputStream
 166