/* This file is part of ethereum.js. ethereum.js is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. ethereum.js is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with ethereum.js. If not, see . */ /** * @file property.js * @author Fabian Vogelsteller * @author Marek Kotewicz * @date 2015 */ var utils = require('../utils/utils'); var Property = function (options) { this.name = options.name; this.getter = options.getter; this.setter = options.setter; this.outputFormatter = options.outputFormatter; this.inputFormatter = options.inputFormatter; }; /** * Should be called to format input args of method * * @method formatInput * @param {Array} * @return {Array} */ Property.prototype.formatInput = function (arg) { return this.inputFormatter ? this.inputFormatter(arg) : arg; }; /** * Should be called to format output(result) of method * * @method formatOutput * @param {Object} * @return {Object} */ Property.prototype.formatOutput = function (result) { return this.outputFormatter && result !== null ? this.outputFormatter(result) : result; }; /** * Should be used to extract callback from array of arguments. Modifies input param * * @method extractCallback * @param {Array} arguments * @return {Function|Null} callback, if exists */ Property.prototype.extractCallback = function (args) { if (utils.isFunction(args[args.length - 1])) { return args.pop(); // modify the args array! } }; Property.prototype.attachToObject = function (obj) { var proto = { get: this.buildGet() }; var names = this.name.split('.'); var name = names[0]; if (names.length > 1) { obj[names[0]] = obj[names[0]] || {}; obj = obj[names[0]]; name = names[1]; } Object.defineProperty(obj, name, proto); obj[asyncGetterName(name)] = this.buildAsyncGet(); }; var asyncGetterName = function (name) { return 'get' + name.charAt(0).toUpperCase() + name.slice(1); }; Property.prototype.buildGet = function () { var property = this; return function get() { return property.formatOutput(this.web3._requestManager.send({ method: property.getter })); }; }; Property.prototype.buildAsyncGet = function () { var property = this; return function get(callback) { this.web3._requestManager.sendAsync({ method: property.getter }, function (err, result) { callback(err, property.formatOutput(result)); }); }; }; /** * Should attach function to method * * @method attachToObject * @param {Object} * @param {Function} */ //Property.prototype.attachToObject = function (obj) { //var proto = { //get: this.get.bind(this), //}; //var names = this.name.split('.'); //var name = names[0]; //if (names.length > 1) { //obj[names[0]] = obj[names[0]] || {}; //obj = obj[names[0]]; //name = names[1]; //} //Object.defineProperty(obj, name, proto); //var toAsyncName = function (prefix, name) { //return prefix + name.charAt(0).toUpperCase() + name.slice(1); //}; //var func = this.getAsync.bind(this); //func.request = this.request.bind(this); //obj[toAsyncName('get', name)] = func; //}; /** * Should be used to get value of the property * * @method get * @return {Object} value of the property */ //Property.prototype.get = function () { //return this.formatOutput(RequestManager.getInstance().send({ //method: this.getter //})); //}; /** * Should be used to asynchrounously get value of property * * @method getAsync * @param {Function} */ //Property.prototype.getAsync = function (callback) { //var self = this; //RequestManager.getInstance().sendAsync({ //method: this.getter //}, function (err, result) { //if (err) { //return callback(err); //} //callback(err, self.formatOutput(result)); //}); //}; /** * Should be called to create pure JSONRPC request which can be used in batch request * * @method request * @param {...} params * @return {Object} jsonrpc request */ //Property.prototype.request = function () { //var payload = { //method: this.getter, //params: [], //callback: this.extractCallback(Array.prototype.slice.call(arguments)) //}; //payload.format = this.formatOutput.bind(this); //return payload; //}; module.exports = Property;