View Javadoc

1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one or more
3    * contributor license agreements.  See the NOTICE file distributed with
4    * this work for additional information regarding copyright ownership.
5    * The ASF licenses this file to You under the Apache License, Version 2.0
6    * (the "License"); you may not use this file except in compliance with
7    * the License.  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  package org.apache.commons.io.output;
18  
19  import java.io.IOException;
20  import java.io.OutputStream;
21  
22  /**
23   * Classic splitter of OutputStream. Named after the unix 'tee' 
24   * command. It allows a stream to be branched off so there 
25   * are now two streams.
26   *
27   * @version $Id: TeeOutputStream.java 471628 2006-11-06 04:06:45Z bayard $
28   */
29  public class TeeOutputStream extends ProxyOutputStream {
30  
31      /** the second OutputStream to write to */
32      protected OutputStream branch;
33  
34      /**
35       * Constructs a TeeOutputStream.
36       * @param out the main OutputStream
37       * @param branch the second OutputStream
38       */
39      public TeeOutputStream( OutputStream out, OutputStream branch ) {
40          super(out);
41          this.branch = branch;
42      }
43  
44      /** @see java.io.OutputStream#write(byte[]) */
45      public synchronized void write(byte[] b) throws IOException {
46          super.write(b);
47          this.branch.write(b);
48      }
49  
50      /** @see java.io.OutputStream#write(byte[], int, int) */
51      public synchronized void write(byte[] b, int off, int len) throws IOException {
52          super.write(b, off, len);
53          this.branch.write(b, off, len);
54      }
55  
56      /** @see java.io.OutputStream#write(int) */
57      public synchronized void write(int b) throws IOException {
58          super.write(b);
59          this.branch.write(b);
60      }
61  
62      /**
63       * Flushes both streams.
64       *
65       * @see java.io.OutputStream#flush()
66       */
67      public void flush() throws IOException {
68          super.flush();
69          this.branch.flush();
70      }
71  
72      /**
73       * Closes both streams. 
74       *
75       * @see java.io.OutputStream#close() 
76       */
77      public void close() throws IOException {
78          super.close();
79          this.branch.close();
80      }
81  
82  }