All Downloads are FREE. Search and download functionalities are using the official Maven repository.

vertx-pg-client-js.pg_connection.js Maven / Gradle / Ivy

/*
 * Copyright 2014 Red Hat, Inc.
 *
 * Red Hat licenses this file to you under the Apache License, version 2.0
 * (the "License"); you may not use this file except in compliance with the
 * License.  You may obtain a copy of the License at:
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
 * License for the specific language governing permissions and limitations
 * under the License.
 */

/** @module vertx-pg-client-js/pg_connection */
var utils = require('vertx-js/util/utils');
var PgClient = require('vertx-pg-client-js/pg_client');
var Tuple = require('vertx-pg-client-js/tuple');
var PgTransaction = require('vertx-pg-client-js/pg_transaction');
var Row = require('vertx-pg-client-js/row');
var PgPreparedQuery = require('vertx-pg-client-js/pg_prepared_query');
var PgResult = require('vertx-pg-client-js/pg_result');

var io = Packages.io;
var JsonObject = io.vertx.core.json.JsonObject;
var JPgConnection = Java.type('com.julienviet.pgclient.PgConnection');
var PgNotification = Java.type('com.julienviet.pgclient.PgNotification');

/**
 A connection to Postgres.

 @class
*/
var PgConnection = function(j_val) {

  var j_pgConnection = j_val;
  var that = this;
  PgClient.call(this, j_val);

  /**
   Create a prepared query.

   @public
   @param sql {string} the sql 
   @param handler {function} the handler notified with the prepared query asynchronously 
   @return {PgConnection}
   */
  this.prepare = function(sql, handler) {
    var __args = arguments;
    if (__args.length === 2 && typeof __args[0] === 'string' && typeof __args[1] === 'function') {
      j_pgConnection["prepare(java.lang.String,io.vertx.core.Handler)"](sql, function(ar) {
      if (ar.succeeded()) {
        handler(utils.convReturnVertxGen(PgPreparedQuery, ar.result()), null);
      } else {
        handler(null, ar.cause());
      }
    });
      return that;
    } else throw new TypeError('function invoked with invalid arguments');
  };

  /**
   Set an handler called with connection errors.

   @public
   @param handler {function} the handler 
   @return {PgConnection} a reference to this, so the API can be used fluently
   */
  this.exceptionHandler = function(handler) {
    var __args = arguments;
    if (__args.length === 1 && typeof __args[0] === 'function') {
      j_pgConnection["exceptionHandler(io.vertx.core.Handler)"](function(jVal) {
      handler(utils.convReturnThrowable(jVal));
    });
      return that;
    } else throw new TypeError('function invoked with invalid arguments');
  };

  /**
   Set an handler called when the connection is closed.

   @public
   @param handler {function} the handler 
   @return {PgConnection} a reference to this, so the API can be used fluently
   */
  this.closeHandler = function(handler) {
    var __args = arguments;
    if (__args.length === 1 && typeof __args[0] === 'function') {
      j_pgConnection["closeHandler(io.vertx.core.Handler)"](handler);
      return that;
    } else throw new TypeError('function invoked with invalid arguments');
  };

  /**
   Begin a transaction and returns a {@link PgTransaction} for controlling and tracking
   this transaction.
   

When the connection is explicitely closed, any inflight transaction is rollbacked. @public @return {PgTransaction} the transaction instance */ this.begin = function() { var __args = arguments; if (__args.length === 0) { return utils.convReturnVertxGen(PgTransaction, j_pgConnection["begin()"]()); } else throw new TypeError('function invoked with invalid arguments'); }; /** Set an handler called when the connection receives notification on a channel.

The handler is called with the PgNotification and has access to the channel name and the notification payload. @public @param handler {function} the handler @return {PgConnection} the transaction instance */ this.notificationHandler = function(handler) { var __args = arguments; if (__args.length === 1 && typeof __args[0] === 'function') { j_pgConnection["notificationHandler(io.vertx.core.Handler)"](function(jVal) { handler(utils.convReturnDataObject(jVal)); }); return that; } else throw new TypeError('function invoked with invalid arguments'); }; /** @public @return {boolean} whether the connection uses SSL */ this.isSSL = function() { var __args = arguments; if (__args.length === 0) { return j_pgConnection["isSSL()"](); } else throw new TypeError('function invoked with invalid arguments'); }; /** Close the current connection after all the pending commands have been processed. @public */ this.close = function() { var __args = arguments; if (__args.length === 0) { j_pgConnection["close()"](); } else throw new TypeError('function invoked with invalid arguments'); }; /** @public @param sql {string} @param arguments {Tuple} @param handler {function} @return {PgConnection} */ this.preparedQuery = function() { var __args = arguments; if (__args.length === 2 && typeof __args[0] === 'string' && typeof __args[1] === 'function') { j_pgConnection["preparedQuery(java.lang.String,io.vertx.core.Handler)"](__args[0], function(ar) { if (ar.succeeded()) { __args[1](utils.convReturnVertxGen(PgResult, ar.result(), Row._jtype), null); } else { __args[1](null, ar.cause()); } }); return that; } else if (__args.length === 3 && typeof __args[0] === 'string' && typeof __args[1] === 'object' && __args[1]._jdel && typeof __args[2] === 'function') { j_pgConnection["preparedQuery(java.lang.String,com.julienviet.pgclient.Tuple,io.vertx.core.Handler)"](__args[0], __args[1]._jdel, function(ar) { if (ar.succeeded()) { __args[2](utils.convReturnVertxGen(PgResult, ar.result(), Row._jtype), null); } else { __args[2](null, ar.cause()); } }); return that; } else throw new TypeError('function invoked with invalid arguments'); }; /** @public @param sql {string} @param handler {function} @return {PgConnection} */ this.query = function(sql, handler) { var __args = arguments; if (__args.length === 2 && typeof __args[0] === 'string' && typeof __args[1] === 'function') { j_pgConnection["query(java.lang.String,io.vertx.core.Handler)"](sql, function(ar) { if (ar.succeeded()) { handler(utils.convReturnVertxGen(PgResult, ar.result(), Row._jtype), null); } else { handler(null, ar.cause()); } }); return that; } else throw new TypeError('function invoked with invalid arguments'); }; /** @public @param sql {string} @param batch {Array.} @param handler {function} @return {PgConnection} */ this.preparedBatch = function(sql, batch, handler) { var __args = arguments; if (__args.length === 3 && typeof __args[0] === 'string' && typeof __args[1] === 'object' && __args[1] instanceof Array && typeof __args[2] === 'function') { j_pgConnection["preparedBatch(java.lang.String,java.util.List,io.vertx.core.Handler)"](sql, utils.convParamListVertxGen(batch), function(ar) { if (ar.succeeded()) { handler(utils.convReturnVertxGen(PgResult, ar.result(), Row._jtype), null); } else { handler(null, ar.cause()); } }); return that; } else throw new TypeError('function invoked with invalid arguments'); }; // A reference to the underlying Java delegate // NOTE! This is an internal API and must not be used in user code. // If you rely on this property your code is likely to break if we change it / remove it without warning. this._jdel = j_pgConnection; }; PgConnection._jclass = utils.getJavaClass("com.julienviet.pgclient.PgConnection"); PgConnection._jtype = { accept: function(obj) { return PgConnection._jclass.isInstance(obj._jdel); }, wrap: function(jdel) { var obj = Object.create(PgConnection.prototype, {}); PgConnection.apply(obj, arguments); return obj; }, unwrap: function(obj) { return obj._jdel; } }; PgConnection._create = function(jdel) { var obj = Object.create(PgConnection.prototype, {}); PgConnection.apply(obj, arguments); return obj; } module.exports = PgConnection;





© 2015 - 2024 Weber Informatics LLC | Privacy Policy