src/share/jaxws_classes/com/sun/xml/internal/org/jvnet/mimepull/QPDecoderStream.java

Tue, 09 Apr 2013 14:51:13 +0100

author
alanb
date
Tue, 09 Apr 2013 14:51:13 +0100
changeset 368
0989ad8c0860
parent 0
373ffda63c9a
permissions
-rw-r--r--

8010393: Update JAX-WS RI to 2.2.9-b12941
Reviewed-by: alanb, erikj
Contributed-by: miroslav.kos@oracle.com, martin.grebac@oracle.com

     1 /*
     2  * Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     8  * particular file as subject to the "Classpath" exception as provided
     9  * by Oracle in the LICENSE file that accompanied this code.
    10  *
    11  * This code is distributed in the hope that it will be useful, but WITHOUT
    12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
    14  * version 2 for more details (a copy is included in the LICENSE file that
    15  * accompanied this code).
    16  *
    17  * You should have received a copy of the GNU General Public License version
    18  * 2 along with this work; if not, write to the Free Software Foundation,
    19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
    20  *
    21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
    22  * or visit www.oracle.com if you need additional information or have any
    23  * questions.
    24  */
    26 /* FROM mail.jar */
    27 package com.sun.xml.internal.org.jvnet.mimepull;
    29 import java.io.*;
    31 /**
    32  * This class implements a QP Decoder. It is implemented as
    33  * a FilterInputStream, so one can just wrap this class around
    34  * any input stream and read bytes from this filter. The decoding
    35  * is done as the bytes are read out.
    36  *
    37  * @author John Mani
    38  */
    40 final class QPDecoderStream extends FilterInputStream {
    41     private byte[] ba = new byte[2];
    42     private int spaces = 0;
    44     /**
    45      * Create a Quoted Printable decoder that decodes the specified
    46      * input stream.
    47      * @param in        the input stream
    48      */
    49     public QPDecoderStream(InputStream in) {
    50         super(new PushbackInputStream(in, 2)); // pushback of size=2
    51     }
    53     /**
    54      * Read the next decoded byte from this input stream. The byte
    55      * is returned as an <code>int</code> in the range <code>0</code>
    56      * to <code>255</code>. If no byte is available because the end of
    57      * the stream has been reached, the value <code>-1</code> is returned.
    58      * This method blocks until input data is available, the end of the
    59      * stream is detected, or an exception is thrown.
    60      *
    61      * @return     the next byte of data, or <code>-1</code> if the end of the
    62      *             stream is reached.
    63      * @exception  IOException  if an I/O error occurs.
    64      */
    65     @Override
    66     public int read() throws IOException {
    67         if (spaces > 0) {
    68             // We have cached space characters, return one
    69             spaces--;
    70             return ' ';
    71         }
    73         int c = in.read();
    75         if (c == ' ') {
    76             // Got space, keep reading till we get a non-space char
    77             while ((c = in.read()) == ' ') {
    78                 spaces++;
    79             }
    81             if (c == '\r' || c == '\n' || c == -1) {
    82                 spaces = 0;
    83             } else {
    84                 // The non-space char is NOT CR/LF, the spaces are valid.
    85                 ((PushbackInputStream)in).unread(c);
    86                 c = ' ';
    87             }
    88             return c; // return either <SPACE> or <CR/LF>
    89         }
    90         else if (c == '=') {
    91             // QP Encoded atom. Decode the next two bytes
    92             int a = in.read();
    94             if (a == '\n') {
    95                 /* Hmm ... not really confirming QP encoding, but lets
    96                  * allow this as a LF terminated encoded line .. and
    97                  * consider this a soft linebreak and recurse to fetch
    98                  * the next char.
    99                  */
   100                 return read();
   101             } else if (a == '\r') {
   102                 // Expecting LF. This forms a soft linebreak to be ignored.
   103                 int b = in.read();
   104                 if (b != '\n') {
   105                     ((PushbackInputStream)in).unread(b);
   106                 }
   107                 return read();
   108             } else if (a == -1) {
   109                 // Not valid QP encoding, but we be nice and tolerant here !
   110                 return -1;
   111             } else {
   112                 ba[0] = (byte)a;
   113                 ba[1] = (byte)in.read();
   114                 try {
   115                     return ASCIIUtility.parseInt(ba, 0, 2, 16);
   116                 } catch (NumberFormatException nex) {
   117                     /*
   118                     System.err.println(
   119                         "Illegal characters in QP encoded stream: " +
   120                         ASCIIUtility.toString(ba, 0, 2)
   121                     );
   122                     */
   124                     ((PushbackInputStream)in).unread(ba);
   125                     return c;
   126                 }
   127             }
   128         }
   129         return c;
   130     }
   132     /**
   133      * Reads up to <code>len</code> decoded bytes of data from this input stream
   134      * into an array of bytes. This method blocks until some input is
   135      * available.
   136      * <p>
   137      *
   138      * @param      buf   the buffer into which the data is read.
   139      * @param      off   the start offset of the data.
   140      * @param      len   the maximum number of bytes read.
   141      * @return     the total number of bytes read into the buffer, or
   142      *             <code>-1</code> if there is no more data because the end of
   143      *             the stream has been reached.
   144      * @exception  IOException  if an I/O error occurs.
   145      */
   146     @Override
   147     public int read(byte[] buf, int off, int len) throws IOException {
   148         int i, c;
   149         for (i = 0; i < len; i++) {
   150             if ((c = read()) == -1) {
   151                 if (i == 0) {
   152                     i = -1; // return -1 , NOT 0.
   153                 }
   154                 break;
   155             }
   156             buf[off+i] = (byte)c;
   157         }
   158         return i;
   159     }
   161     /**
   162      * Skips over and discards n bytes of data from this stream.
   163      */
   164     @Override
   165     public long skip(long n) throws IOException {
   166         long skipped = 0;
   167         while (n-- > 0 && read() >= 0) {
   168             skipped++;
   169         }
   170         return skipped;
   171     }
   173     /**
   174      * Tests if this input stream supports marks. Currently this class
   175      * does not support marks
   176      */
   177     @Override
   178     public boolean markSupported() {
   179         return false;
   180     }
   182     /**
   183      * Returns the number of bytes that can be read from this input
   184      * stream without blocking. The QP algorithm does not permit
   185      * a priori knowledge of the number of bytes after decoding, so
   186      * this method just invokes the <code>available</code> method
   187      * of the original input stream.
   188      */
   189     @Override
   190     public int available() throws IOException {
   191         // This is bogus ! We don't really know how much
   192         // bytes are available *after* decoding
   193         return in.available();
   194     }
   196     /**** begin TEST program
   197     public static void main(String argv[]) throws Exception {
   198         FileInputStream infile = new FileInputStream(argv[0]);
   199         QPDecoderStream decoder = new QPDecoderStream(infile);
   200         int c;
   202         while ((c = decoder.read()) != -1)
   203             System.out.print((char)c);
   204         System.out.println();
   205     }
   206     *** end TEST program ****/
   207 }

mercurial