View Javadoc

1   /**
2    *
3    * Copyright 2003-2006 The Apache Software Foundation
4    *
5    *  Licensed under the Apache License, Version 2.0 (the "License");
6    *  you may not use this file except in compliance with the License.
7    *  You may obtain a copy of the License at
8    *
9    *     http://www.apache.org/licenses/LICENSE-2.0
10   *
11   *  Unless required by applicable law or agreed to in writing, software
12   *  distributed under the License is distributed on an "AS IS" BASIS,
13   *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14   *  See the License for the specific language governing permissions and
15   *  limitations under the License.
16   */
17  
18  package org.apache.geronimo.mail.util;
19  
20  import java.io.IOException;
21  import java.io.OutputStream;
22  
23  /**
24   * An implementation of an OutputStream that writes the data directly
25   * out to a StringBuffer object.  Useful for applications where an
26   * intermediate ByteArrayOutputStream is required to append generated
27   * characters to a StringBuffer;
28   */
29  public class StringBufferOutputStream extends OutputStream {
30  
31      // the target buffer
32      protected StringBuffer buffer;
33  
34      /**
35       * Create an output stream that writes to the target StringBuffer
36       *
37       * @param out    The wrapped output stream.
38       */
39      public StringBufferOutputStream(StringBuffer out) {
40          buffer = out;
41      }
42  
43  
44      // in order for this to work, we only need override the single character form, as the others
45      // funnel through this one by default.
46      public void write(int ch) throws IOException {
47          // just append the character
48          buffer.append((char)ch);
49      }
50  }
51  
52  
53