KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > caucho > vfs > ByteToChar


1 /*
2  * Copyright (c) 1998-2006 Caucho Technology -- all rights reserved
3  *
4  * This file is part of Resin(R) Open Source
5  *
6  * Each copy or derived work must preserve the copyright notice and this
7  * notice unmodified.
8  *
9  * Resin Open Source is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation; either version 2 of the License, or
12  * (at your option) any later version.
13  *
14  * Resin Open Source is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, or any warranty
17  * of NON-INFRINGEMENT. See the GNU General Public License for more
18  * details.
19  *
20  * You should have received a copy of the GNU General Public License
21  * along with Resin Open Source; if not, write to the
22  * Free SoftwareFoundation, Inc.
23  * 59 Temple Place, Suite 330
24  * Boston, MA 02111-1307 USA
25  *
26  * @author Scott Ferguson
27  */
28
29 package com.caucho.vfs;
30
31 import com.caucho.util.CharBuffer;
32
33 import java.io.IOException JavaDoc;
34
35 /**
36  * Utility class for converting a byte stream to a character stream.
37  *
38  * <pre>
39  * ByteToChar converter = new ByteToChar();
40  * converter.setEncoding("utf-8");
41  * converter.clear();
42  *
43  * converter.addChar('H');
44  * converter.addByte(0xc0);
45  * converter.addByte(0xb8);
46  *
47  * String value = converter.getConvertedString();
48  * </pre>
49  */
50 public class ByteToChar extends AbstractByteToChar {
51   private CharBuffer _charBuffer;
52
53   /**
54    * Creates an uninitialized converter. Use <code>init</code> to initialize.
55    */
56   ByteToChar()
57   {
58     _charBuffer = new CharBuffer();
59   }
60
61   public static ByteToChar create()
62   {
63     return new ByteToChar();
64   }
65
66   /**
67    * Clears the converted
68    */
69   public void clear()
70   {
71     super.clear();
72     
73     _charBuffer.clear();
74   }
75
76   /**
77    * Gets the converted string.
78    */
79   public String JavaDoc getConvertedString()
80     throws IOException JavaDoc
81   {
82     flush();
83     
84     return _charBuffer.toString();
85   }
86
87   protected void outputChar(int ch)
88   {
89     _charBuffer.append((char) ch);
90   }
91
92   /**
93    * Prints the object.
94    */
95   public String JavaDoc toString()
96   {
97     try {
98       return getConvertedString();
99     } catch (IOException JavaDoc e) {
100       throw new RuntimeException JavaDoc(String.valueOf(e));
101     }
102   }
103 }
104
Popular Tags