pip-services3-commons-nodex/obj/src/validate/ObjectComparator.js

Portable abstractions and patterns for Pip.Services in Node.js / ES2017

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.ObjectComparator = void 0;
/** @module validate */
const DoubleConverter_1 = require("../convert/DoubleConverter");
const StringConverter_1 = require("../convert/StringConverter");
/**
 * Helper class to perform comparison operations over arbitrary values.
 *
 * ### Example ###
 *
 *     ObjectComparator.compare(2, "GT", 1);        // Result: true
 *     ObjectComparator.areEqual("A", "B");         // Result: false
 */
class ObjectComparator {
    /**
     * Perform comparison operation over two arguments.
     * The operation can be performed over values of any type.
     *
     * @param value1        the first argument to compare
     * @param operation     the comparison operation: "==" ("=", "EQ"), "!= " ("<>", "NE"); "<"/">" ("LT"/"GT"), "<="/">=" ("LE"/"GE"); "LIKE".
     * @param value2        the second argument to compare
     * @returns result of the comparison operation
     */
    static compare(value1, operation, value2) {
        operation = operation.toUpperCase();
        if (operation == "=" || operation == "==" || operation == "EQ")
            return ObjectComparator.areEqual(value1, value2);
        if (operation == "!=" || operation == "<>" || operation == "NE")
            return ObjectComparator.areNotEqual(value1, value2);
        if (operation == "<" || operation == "LT")
            return ObjectComparator.isLess(value1, value2);
        if (operation == "<=" || operation == "LE" || operation == "LTE")
            return ObjectComparator.areEqual(value1, value2) || ObjectComparator.isLess(value1, value2);
        if (operation == ">" || operation == "GT")
            return ObjectComparator.isGreater(value1, value2);
        if (operation == ">=" || operation == "GE" || operation == "GTE")
            return ObjectComparator.areEqual(value1, value2) || ObjectComparator.isGreater(value1, value2);
        if (operation == "LIKE")
            return ObjectComparator.match(value1, value2);
        return false;
    }
    /**
     * Checks if two values are equal.
     * The operation can be performed over values of any type.
     *
     * @param value1    the first value to compare
     * @param value2    the second value to compare
     * @returns true if values are equal and false otherwise
     */
    static areEqual(value1, value2) {
        if (value1 == null && value2 == null) {
            return true;
        }
        if (value1 == null || value2 == null) {
            return false;
        }
        if (typeof value1.equals === "function") {
            return value1.equals(value2);
        }
        let number1 = DoubleConverter_1.DoubleConverter.toNullableDouble(value1);
        let number2 = DoubleConverter_1.DoubleConverter.toNullableDouble(value2);
        if (number1 != null && number2 != null) {
            return number1 == number2;
        }
        let str1 = StringConverter_1.StringConverter.toNullableString(value1);
        let str2 = StringConverter_1.StringConverter.toNullableString(value1);
        if (str1 == null && str2 == null) {
            return str1 == str2;
        }
        return value1 == value2;
    }
    /**
     * Checks if two values are NOT equal
     * The operation can be performed over values of any type.
     *
     * @param value1    the first value to compare
     * @param value2    the second value to compare
     * @returns true if values are NOT equal and false otherwise
     */
    static areNotEqual(value1, value2) {
        return !ObjectComparator.areEqual(value1, value2);
    }
    /**
     * Checks if first value is less than the second one.
     * The operation can be performed over numbers or strings.
     *
     * @param value1    the first value to compare
     * @param value2    the second value to compare
     * @returns true if the first value is less than second and false otherwise.
     */
    static isLess(value1, value2) {
        let number1 = DoubleConverter_1.DoubleConverter.toNullableDouble(value1);
        let number2 = DoubleConverter_1.DoubleConverter.toNullableDouble(value2);
        if (number1 == null || number2 == null) {
            return false;
        }
        return number1 < number2;
    }
    /**
     * Checks if first value is greater than the second one.
     * The operation can be performed over numbers or strings.
     *
     * @param value1    the first value to compare
     * @param value2    the second value to compare
     * @returns true if the first value is greater than second and false otherwise.
     */
    static isGreater(value1, value2) {
        let number1 = DoubleConverter_1.DoubleConverter.toNullableDouble(value1);
        let number2 = DoubleConverter_1.DoubleConverter.toNullableDouble(value2);
        if (number1 == null || number2 == null) {
            return false;
        }
        return number1 > number2;
    }
    /**
     * Checks if string matches a regular expression
     *
     * @param value     a string value to match
     * @param regexp    a regular expression string
     * @returns true if the value matches regular expression and false otherwise.
     */
    static match(value, regexp) {
        if (value == null && regexp == null) {
            return true;
        }
        if (value == null || regexp == null) {
            return false;
        }
        let str1 = StringConverter_1.StringConverter.toString(value);
        let str2 = StringConverter_1.StringConverter.toString(regexp);
        return !!str1.match(str2);
    }
}
exports.ObjectComparator = ObjectComparator;
//# sourceMappingURL=ObjectComparator.js.map