View Javadoc

1   /***
2    * Redistribution  and use  in source  and binary  forms, with  or without
3    * modification, are permitted provided  that the following conditions are
4    * met :
5    *
6    * . Redistributions  of  source  code  must  retain  the  above copyright
7    *   notice, this list of conditions and the following disclaimer.
8    *
9    * . Redistributions in  binary form  must reproduce  the above  copyright
10   *   notice, this list of conditions  and the following disclaimer in  the
11   *   documentation and/or other materials provided with the distribution.
12   *
13   * . The name of the author may not be used to endorse or promote products
14   *   derived from this software without specific prior written permission.
15   *
16   * THIS SOFTWARE IS  PROVIDED BY THE  AUTHOR ``AS IS''  AND ANY EXPRESS  OR
17   * IMPLIED  WARRANTIES,  INCLUDING,  BUT   NOT  LIMITED  TO,  THE   IMPLIED
18   * WARRANTIES OF MERCHANTABILITY AND  FITNESS FOR A PARTICULAR  PURPOSE ARE
19   * DISCLAIMED.  IN NO  EVENT SHALL  THE AUTHOR  BE LIABLE  FOR ANY  DIRECT,
20   * INDIRECT,  INCIDENTAL,  SPECIAL,  EXEMPLARY,  OR  CONSEQUENTIAL  DAMAGES
21   * (INCLUDING,  BUT  NOT LIMITED  TO,  PROCUREMENT OF  SUBSTITUTE  GOODS OR
22   * SERVICES;  LOSS  OF USE,  DATA,  OR PROFITS;  OR  BUSINESS INTERRUPTION)
23   * HOWEVER CAUSED  AND ON  ANY THEORY  OF LIABILITY,  WHETHER IN  CONTRACT,
24   * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
25   * ANY  WAY  OUT OF  THE  USE OF  THIS  SOFTWARE, EVEN  IF  ADVISED OF  THE
26   * POSSIBILITY OF SUCH DAMAGE.
27   *
28   * $Id$
29   */
30  
31  package palmed.edit.text;
32  
33  import java.io.IOException;
34  import java.io.OutputStream;
35  import java.util.Vector;
36  import palmed.edit.util.Coordinate;
37  
38  /***
39   * This class provides a means to write part of a text to a stream.
40   *
41   * @author Mathieu Champlon
42   * @version $Revision$ $Date$
43   */
44  public final class TextSerializer implements ITextExtractor
45  {
46      /***
47       * The stream to write to.
48       */
49      private final OutputStream stream_;
50      /***
51       * The exceptions raised during the operation.
52       */
53      private final Vector exceptions_;
54  
55      /***
56       * Create a text serializer.
57       *
58       * @param stream the stream to write to
59       * @param exceptions the io exceptions raised during the operation
60       */
61      public TextSerializer( final OutputStream stream, final Vector exceptions )
62      {
63          if( stream == null )
64              throw new IllegalArgumentException( "parameter 'stream' is null" );
65          if( exceptions == null )
66              throw new IllegalArgumentException( "parameter 'exceptions' is null" );
67          exceptions_ = exceptions;
68          stream_ = stream;
69      }
70  
71      /***
72       * {@inheritDoc}
73       */
74      public void select( final IText text, final Coordinate from, final Coordinate to )
75      {
76          try
77          {
78              text.write( stream_, from, to );
79          }
80          catch( IOException e )
81          {
82              exceptions_.addElement( e );
83          }
84      }
85  }