/*
* 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-stomp-js/destination */
var utils = require('vertx-js/util/utils');
var Vertx = require('vertx-js/vertx');
var StompServerConnection = require('vertx-stomp-js/stomp_server_connection');
var io = Packages.io;
var JsonObject = io.vertx.core.json.JsonObject;
var JDestination = io.vertx.ext.stomp.Destination;
var BridgeOptions = io.vertx.ext.stomp.BridgeOptions;
var Frame = io.vertx.ext.stomp.Frame;
/**
Represents a STOMP destination.
Depending on the implementation, the message delivery is different. Queue are sending message to only one
subscribers, while topics are broadcasting the message to all subscribers.
<p/>
Implementations <strong>must</strong> be thread-safe.
@class
*/
var Destination = function(j_val) {
var j_destination = j_val;
var that = this;
/**
@return the destination address.
@public
@return {string}
*/
this.destination = function() {
var __args = arguments;
if (__args.length === 0) {
return j_destination["destination()"]();
} else throw new TypeError('function invoked with invalid arguments');
};
/**
Dispatches the given frame.
@public
@param connection {StompServerConnection} the connection
@param frame {Object} the frame
@return {Destination} the current instance of {@link Destination}
*/
this.dispatch = function(connection, frame) {
var __args = arguments;
if (__args.length === 2 && typeof __args[0] === 'object' && __args[0]._jdel && (typeof __args[1] === 'object' && __args[1] != null)) {
j_destination["dispatch(io.vertx.ext.stomp.StompServerConnection,io.vertx.ext.stomp.Frame)"](connection._jdel, frame != null ? new Frame(new JsonObject(JSON.stringify(frame))) : null);
return that;
} else throw new TypeError('function invoked with invalid arguments');
};
/**
Handles a subscription request to the current {@link Destination}.
@public
@param connection {StompServerConnection} the connection
@param frame {Object} the <code>SUBSCRIBE</code> frame
@return {Destination} the current instance of {@link Destination}
*/
this.subscribe = function(connection, frame) {
var __args = arguments;
if (__args.length === 2 && typeof __args[0] === 'object' && __args[0]._jdel && (typeof __args[1] === 'object' && __args[1] != null)) {
j_destination["subscribe(io.vertx.ext.stomp.StompServerConnection,io.vertx.ext.stomp.Frame)"](connection._jdel, frame != null ? new Frame(new JsonObject(JSON.stringify(frame))) : null);
return that;
} else throw new TypeError('function invoked with invalid arguments');
};
/**
Handles a un-subscription request to the current {@link Destination}.
@public
@param connection {StompServerConnection} the connection
@param frame {Object} the <code>UNSUBSCRIBE</code> frame
@return {boolean} <code>true</code> if the un-subscription has been handled, <code>false</code> otherwise.
*/
this.unsubscribe = function(connection, frame) {
var __args = arguments;
if (__args.length === 2 && typeof __args[0] === 'object' && __args[0]._jdel && (typeof __args[1] === 'object' && __args[1] != null)) {
return j_destination["unsubscribe(io.vertx.ext.stomp.StompServerConnection,io.vertx.ext.stomp.Frame)"](connection._jdel, frame != null ? new Frame(new JsonObject(JSON.stringify(frame))) : null);
} else throw new TypeError('function invoked with invalid arguments');
};
/**
Removes all subscriptions of the given connection
@public
@param connection {StompServerConnection} the connection
@return {Destination} the current instance of {@link Destination}
*/
this.unsubscribeConnection = function(connection) {
var __args = arguments;
if (__args.length === 1 && typeof __args[0] === 'object' && __args[0]._jdel) {
j_destination["unsubscribeConnection(io.vertx.ext.stomp.StompServerConnection)"](connection._jdel);
return that;
} else throw new TypeError('function invoked with invalid arguments');
};
/**
Handles a <code>ACK</code> frame.
@public
@param connection {StompServerConnection} the connection
@param frame {Object} the <code>ACK</code> frame
@return {boolean} <code>true</code> if the destination has handled the frame (meaning it has sent the message with id)
*/
this.ack = function(connection, frame) {
var __args = arguments;
if (__args.length === 2 && typeof __args[0] === 'object' && __args[0]._jdel && (typeof __args[1] === 'object' && __args[1] != null)) {
return j_destination["ack(io.vertx.ext.stomp.StompServerConnection,io.vertx.ext.stomp.Frame)"](connection._jdel, frame != null ? new Frame(new JsonObject(JSON.stringify(frame))) : null);
} else throw new TypeError('function invoked with invalid arguments');
};
/**
Handles a <code>NACK</code> frame.
@public
@param connection {StompServerConnection} the connection
@param frame {Object} the <code>NACK</code> frame
@return {boolean} <code>true</code> if the destination has handled the frame (meaning it has sent the message with id)
*/
this.nack = function(connection, frame) {
var __args = arguments;
if (__args.length === 2 && typeof __args[0] === 'object' && __args[0]._jdel && (typeof __args[1] === 'object' && __args[1] != null)) {
return j_destination["nack(io.vertx.ext.stomp.StompServerConnection,io.vertx.ext.stomp.Frame)"](connection._jdel, frame != null ? new Frame(new JsonObject(JSON.stringify(frame))) : null);
} else throw new TypeError('function invoked with invalid arguments');
};
/**
Gets all subscription ids for the given destination hold by the given client
@public
@param connection {StompServerConnection} the connection (client)
@return {Array.<string>} the list of subscription id, empty if none
*/
this.getSubscriptions = function(connection) {
var __args = arguments;
if (__args.length === 1 && typeof __args[0] === 'object' && __args[0]._jdel) {
return j_destination["getSubscriptions(io.vertx.ext.stomp.StompServerConnection)"](connection._jdel);
} else throw new TypeError('function invoked with invalid arguments');
};
/**
Gets the number of subscriptions attached to the current {@link Destination}.
@public
@return {number} the number of subscriptions.
*/
this.numberOfSubscriptions = function() {
var __args = arguments;
if (__args.length === 0) {
return j_destination["numberOfSubscriptions()"]();
} else throw new TypeError('function invoked with invalid arguments');
};
/**
Checks whether or not the given address matches with the current destination.
@public
@param address {string} the address
@return {boolean} <code>true</code> if it matches, <code>false</code> otherwise.
*/
this.matches = function(address) {
var __args = arguments;
if (__args.length === 1 && typeof __args[0] === 'string') {
return j_destination["matches(java.lang.String)"](address);
} 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_destination;
};
/**
@memberof module:vertx-stomp-js/destination
@param vertx {Vertx}
@param destination {string}
@return {Destination}
*/
Destination.topic = function(vertx, destination) {
var __args = arguments;
if (__args.length === 2 && typeof __args[0] === 'object' && __args[0]._jdel && typeof __args[1] === 'string') {
return utils.convReturnVertxGen(JDestination["topic(io.vertx.core.Vertx,java.lang.String)"](vertx._jdel, destination), Destination);
} else throw new TypeError('function invoked with invalid arguments');
};
/**
@memberof module:vertx-stomp-js/destination
@param vertx {Vertx}
@param destination {string}
@return {Destination}
*/
Destination.queue = function(vertx, destination) {
var __args = arguments;
if (__args.length === 2 && typeof __args[0] === 'object' && __args[0]._jdel && typeof __args[1] === 'string') {
return utils.convReturnVertxGen(JDestination["queue(io.vertx.core.Vertx,java.lang.String)"](vertx._jdel, destination), Destination);
} else throw new TypeError('function invoked with invalid arguments');
};
/**
@memberof module:vertx-stomp-js/destination
@param vertx {Vertx}
@param options {Object}
@return {Destination}
*/
Destination.bridge = function(vertx, options) {
var __args = arguments;
if (__args.length === 2 && typeof __args[0] === 'object' && __args[0]._jdel && (typeof __args[1] === 'object' && __args[1] != null)) {
return utils.convReturnVertxGen(JDestination["bridge(io.vertx.core.Vertx,io.vertx.ext.stomp.BridgeOptions)"](vertx._jdel, options != null ? new BridgeOptions(new JsonObject(JSON.stringify(options))) : null), Destination);
} else throw new TypeError('function invoked with invalid arguments');
};
// We export the Constructor function
module.exports = Destination;