pgadmin4/web/pgadmin/static/js/sqleditor_utils.js

//////////////////////////////////////////////////////////////////////////
//
// pgAdmin 4 - PostgreSQL Tools
//
// Copyright (C) 2013 - 2019, The pgAdmin Development Team
// This software is released under the PostgreSQL Licence
//
//////////////////////////////////////////////////////////////////////////
// This file contains common utilities functions used in sqleditor modules

define(['jquery', 'sources/gettext', 'sources/url_for'],
  function ($, gettext, url_for) {
    var sqlEditorUtils = {
      /* Reference link http://stackoverflow.com/questions/105034/create-guid-uuid-in-javascript
       * Modified as per requirement.
       */
      epicRandomString: function(length) {
        var s = [];
        var hexDigits = '0123456789abcdef';
        for (var i = 0; i < 36; i++) {
          s[i] = hexDigits.substr(
                    Math.floor(Math.random() * 0x10), 1
                  );
        }
        // bits 12-15 of the time_hi_and_version field to 0010
        s[14] = '4';
        // bits 6-7 of the clock_seq_hi_and_reserved to 01
        s[19] = hexDigits.substr((s[19] & 0x3) | 0x8, 1);
        s[8] = s[13] = s[18] = s[23] = '-';

        var uuid = s.join('');
        return uuid.replace(/-/g, '').substr(0, length);
      },

      // Returns a unique hash for input string
      getHash: function(input) {
        var hash = 0, len = input.length;
        for (var i = 0; i < len; i++) {
          hash  = ((hash << 5) - hash) + input.charCodeAt(i);
          hash |= 0; // to 32bit integer
        }
        return hash;
      },
      calculateColumnWidth: function (text) {
        // Calculate column header width based on column name or type
        // Create a temporary element with given label, append to body
        // calculate its width and remove the element.
        $('body').append(
            '<span id="pg_text" style="visibility: hidden;">'+ text + '</span>'
        );
        var width = $('#pg_text').width() + 23;
        $('#pg_text').remove(); // remove element

        return width;
      },
      capitalizeFirstLetter: function (string) {
        return string.charAt(0).toUpperCase() + string.slice(1);
      },

      // Status flag
      previousStatus: null,

      // This function will fetch the connection status via ajax
      fetchConnectionStatus: function(target, $el, $status_el) {
        // If user has switch the browser Tab or Minimized window or
        // if wcDocker panel is not in focus then don't fire AJAX
        var url = url_for('sqleditor.connection_status', {
          'trans_id': target.transId,
        });

        if (document.visibilityState !== 'visible' ||
              $el.data('panel-visible') !== 'visible' ) {
          return;
        }

        let sqleditor_obj = target;

        // Start polling..
        $.ajax({
          url: url,
          method: 'GET',
        })
        .done(function (res) {
          if(res && res.data) {
            var status = res.data.status,
              msg = res.data.message,
              is_status_changed = false;

            // Raise notify messages comes from database server.
            sqleditor_obj.update_notifications(res.data.notifies);

            // Inject CSS as required
            switch(status) {
                // Busy
            case 1:
                    // if received busy status more than once then only
              if(status == sqlEditorUtils.previousStatus &&
                        !$status_el.hasClass('fa-hourglass-half')) {
                $status_el.removeClass()
                                .addClass('fa fa-hourglass-half');
                is_status_changed = true;
              }
              break;
                // Idle in transaction
            case 2:
              if(sqlEditorUtils.previousStatus != status &&
                        !$status_el.hasClass('fa-clock-o')) {
                $status_el.removeClass()
                                .addClass('fa fa-clock-o');
                is_status_changed = true;
              }
              break;
                // Failed in transaction
            case 3:
              if(sqlEditorUtils.previousStatus != status &&
                        !$status_el.hasClass('fa-exclamation-circle')) {
                $status_el.removeClass()
                                .addClass('fa fa-exclamation-circle');
                is_status_changed = true;
              }
              break;
                // Failed in transaction with unknown server side error
            case 4:
              if(sqlEditorUtils.previousStatus != status &&
                        !$status_el.hasClass('fa-exclamation-triangle')) {
                $status_el.removeClass()
                                .addClass('fa fa-exclamation-triangle');
                is_status_changed = true;
              }
              break;
            default:
              if(sqlEditorUtils.previousStatus != status &&
                        !$status_el.hasClass('fa-query_tool_connected')) {
                $status_el.removeClass()
                                .addClass('fa-custom fa-query-tool-connected');
                is_status_changed = true;
              }
            }

            sqlEditorUtils.previousStatus = status;
            // Set bootstrap popover message
            if(is_status_changed) {
              $el.popover('hide');
              $el.attr('data-content', msg);
            }
          } else {
            // We come here means we did not receive expected response
            // from server, we need to error out
            sqlEditorUtils.previousStatus = -99;
            msg = gettext('An unexpected error occurred - ' +
                          'ensure you are logged into the application.');
            $el.attr('data-content', msg);
            if(!$status_el.hasClass('fa-query-tool-disconnected')) {
              $el.popover('hide');
              $status_el.removeClass()
                        .addClass('fa-custom fa-query-tool-disconnected');
            }
          }
        })
        .fail(function (e) {
          sqlEditorUtils.previousStatus = -1;
          var msg = gettext('Transaction status check failed.');
          if (e.readyState == 0) {
            msg = gettext('Not connected to the server or the connection to ' +
                          'the server has been closed.');
          } else if (e.responseJSON && e.responseJSON.errormsg) {
            msg = e.responseJSON.errormsg;
          }

          // Set bootstrap popover
          $el.attr('data-content', msg);
          // Add error class
          if(!$status_el.hasClass('fa-query-tool-disconnected')) {
            $el.popover('hide');
            $status_el.removeClass()
                      .addClass('fa-custom fa-query-tool-disconnected');
          }
        });
      },

      // Updates the flag for connection status poll
      updateConnectionStatusFlag: function(status) {
        var $el = $('.connection_status');
        if ($el.data('panel-visible') != status) {
          $el.data('panel-visible', status);
        }
      },

      calcFontSize: function(fontSize) {
        if(fontSize) {
          let rounded = Number((Math.round(fontSize + 'e+2') + 'e-2'));
          if(rounded > 0) {
            return rounded + 'em';
          }
        }
        return '1em';
      },
    };
    return sqlEditorUtils;
  });