Source: main/webapp/modules/DataURIReader.js

  1. /*
  2.  * Licensed to the Apache Software Foundation (ASF) under one
  3.  * or more contributor license agreements.  See the NOTICE file
  4.  * distributed with this work for additional information
  5.  * regarding copyright ownership.  The ASF licenses this file
  6.  * to you under the Apache License, Version 2.0 (the
  7.  * "License"); you may not use this file except in compliance
  8.  * with the License.  You may obtain a copy of the License at
  9.  *
  10.  *   http://www.apache.org/licenses/LICENSE-2.0
  11.  *
  12.  * Unless required by applicable law or agreed to in writing,
  13.  * software distributed under the License is distributed on an
  14.  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
  15.  * KIND, either express or implied.  See the License for the
  16.  * specific language governing permissions and limitations
  17.  * under the License.
  18.  */
  20. var Guacamole = Guacamole || {};
  22. /**
  23.  * A reader which automatically handles the given input stream, returning
  24.  * received blobs as a single data URI built over the course of the stream.
  25.  * Note that this object will overwrite any installed event handlers on the
  26.  * given Guacamole.InputStream.
  27.  * 
  28.  * @constructor
  29.  * @param {!Guacamole.InputStream} stream
  30.  *     The stream that data will be read from.
  31.  *
  32.  * @param {!string} mimetype
  33.  *     The mimetype of the data being received.
  34.  */
  35. Guacamole.DataURIReader = function(stream, mimetype) {
  37.     /**
  38.      * Reference to this Guacamole.DataURIReader.
  39.      *
  40.      * @private
  41.      * @type {!Guacamole.DataURIReader}
  42.      */
  43.     var guac_reader = this;
  45.     /**
  46.      * Current data URI.
  47.      *
  48.      * @private
  49.      * @type {!string}
  50.      */
  51.     var uri = 'data:' + mimetype + ';base64,';
  53.     // Receive blobs as array buffers
  54.     stream.onblob = function dataURIReaderBlob(data) {
  56.         // Currently assuming data will ALWAYS be safe to simply append. This
  57.         // will not be true if the received base64 data encodes a number of
  58.         // bytes that isn't a multiple of three (as base64 expands in a ratio
  59.         // of exactly 3:4).
  60.         uri += data;
  62.     };
  64.     // Simply call onend when end received
  65.     stream.onend = function dataURIReaderEnd() {
  66.         if (guac_reader.onend)
  67.             guac_reader.onend();
  68.     };
  70.     /**
  71.      * Returns the data URI of all data received through the underlying stream
  72.      * thus far.
  73.      *
  74.      * @returns {!string}
  75.      *     The data URI of all data received through the underlying stream thus
  76.      *     far.
  77.      */
  78.     this.getURI = function getURI() {
  79.         return uri;
  80.     };
  82.     /**
  83.      * Fired once this stream is finished and no further data will be written.
  84.      *
  85.      * @event
  86.      */
  87.     this.onend = null;
  89. };