001: /*
002:
003: ============================================================================
004: The Apache Software License, Version 1.1
005: ============================================================================
006:
007: Copyright (C) 1999-2003 The Apache Software Foundation. All rights reserved.
008:
009: Redistribution and use in source and binary forms, with or without modifica-
010: tion, are permitted provided that the following conditions are met:
011:
012: 1. Redistributions of source code must retain the above copyright notice,
013: this list of conditions and the following disclaimer.
014:
015: 2. Redistributions in binary form must reproduce the above copyright notice,
016: this list of conditions and the following disclaimer in the documentation
017: and/or other materials provided with the distribution.
018:
019: 3. The end-user documentation included with the redistribution, if any, must
020: include the following acknowledgment: "This product includes software
021: developed by the Apache Software Foundation (http://www.apache.org/)."
022: Alternately, this acknowledgment may appear in the software itself, if
023: and wherever such third-party acknowledgments normally appear.
024:
025: 4. The names "Batik" and "Apache Software Foundation" must not be
026: used to endorse or promote products derived from this software without
027: prior written permission. For written permission, please contact
028: apache@apache.org.
029:
030: 5. Products derived from this software may not be called "Apache", nor may
031: "Apache" appear in their name, without prior written permission of the
032: Apache Software Foundation.
033:
034: THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
035: INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
036: FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
037: APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
038: INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU-
039: DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
040: OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
041: ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
042: (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
043: THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
044:
045: This software consists of voluntary contributions made by many individuals
046: on behalf of the Apache Software Foundation. For more information on the
047: Apache Software Foundation, please see <http://www.apache.org/>.
048:
049: */
050:
051: package org.apache.batik.util.io;
052:
053: import java.io.IOException;
054: import java.io.InputStream;
055:
056: /**
057: * This class is the superclass of all the char decoders.
058: *
059: * @author <a href="mailto:stephane@hillion.org">Stephane Hillion</a>
060: * @version $Id$
061: */
062: public abstract class AbstractCharDecoder implements CharDecoder {
063:
064: /**
065: * The buffer size.
066: */
067: protected final static int BUFFER_SIZE = 8192;
068:
069: /**
070: * The input stream to read.
071: */
072: protected InputStream inputStream;
073:
074: /**
075: * The input buffer.
076: */
077: protected byte[] buffer = new byte[BUFFER_SIZE];
078:
079: /**
080: * The current position in the buffer.
081: */
082: protected int position;
083:
084: /**
085: * The byte count in the buffer.
086: */
087: protected int count;
088:
089: /**
090: * Creates a new CharDecoder object.
091: * @param is The stream to read.
092: */
093: protected AbstractCharDecoder(InputStream is) {
094: inputStream = is;
095: }
096:
097: /**
098: * Disposes the associated resources.
099: */
100: public void dispose() throws IOException {
101: inputStream.close();
102: inputStream = null;
103: }
104:
105: /**
106: * Fills the input buffer.
107: */
108: protected void fillBuffer() throws IOException {
109: count = inputStream.read(buffer, 0, BUFFER_SIZE);
110: position = 0;
111: }
112:
113: /**
114: * To throws an exception when the input stream contains an
115: * invalid character.
116: * @param encoding The encoding name.
117: */
118: protected void charError(String encoding) throws IOException {
119: throw new IOException(Messages.formatMessage("invalid.char",
120: new Object[] { encoding }));
121: }
122:
123: /**
124: * To throws an exception when the end of stream was unexpected.
125: * @param encoding The encoding name.
126: */
127: protected void endOfStreamError(String encoding) throws IOException {
128: throw new IOException(Messages.formatMessage("end.of.stream",
129: new Object[] { encoding }));
130: }
131: }
|