Adding mapbox-gl branch
This commit is contained in:
Andreas Hocevar
@@ -0,0 +1,104 @@
|
||||
// Copyright 2008 The Closure Library Authors. All Rights Reserved.
|
||||
//
|
||||
// Licensed 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.
|
||||
|
||||
/**
|
||||
* @fileoverview Tool for caching the result of expensive deterministic
|
||||
* functions.
|
||||
*
|
||||
* @see http://en.wikipedia.org/wiki/Memoization
|
||||
*
|
||||
*/
|
||||
|
||||
goog.provide('goog.memoize');
|
||||
|
||||
|
||||
/**
|
||||
* Decorator around functions that caches the inner function's return values.
|
||||
*
|
||||
* To cache parameterless functions, see goog.functions.cacheReturnValue.
|
||||
*
|
||||
* @param {Function} f The function to wrap. Its return value may only depend
|
||||
* on its arguments and 'this' context. There may be further restrictions
|
||||
* on the arguments depending on the capabilities of the serializer used.
|
||||
* @param {function(number, Object): string=} opt_serializer A function to
|
||||
* serialize f's arguments. It must have the same signature as
|
||||
* goog.memoize.simpleSerializer. It defaults to that function.
|
||||
* @this {Object} The object whose function is being wrapped.
|
||||
* @return {!Function} The wrapped function.
|
||||
*/
|
||||
goog.memoize = function(f, opt_serializer) {
|
||||
var serializer = opt_serializer || goog.memoize.simpleSerializer;
|
||||
|
||||
return function() {
|
||||
if (goog.memoize.ENABLE_MEMOIZE) {
|
||||
// In the strict mode, when this function is called as a global function,
|
||||
// the value of 'this' is undefined instead of a global object. See:
|
||||
// https://developer.mozilla.org/en/JavaScript/Strict_mode
|
||||
var thisOrGlobal = this || goog.global;
|
||||
// Maps the serialized list of args to the corresponding return value.
|
||||
var cache = thisOrGlobal[goog.memoize.CACHE_PROPERTY_] ||
|
||||
(thisOrGlobal[goog.memoize.CACHE_PROPERTY_] = {});
|
||||
var key = serializer(goog.getUid(f), arguments);
|
||||
return cache.hasOwnProperty(key) ? cache[key] :
|
||||
(cache[key] = f.apply(this, arguments));
|
||||
} else {
|
||||
return f.apply(this, arguments);
|
||||
}
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* @define {boolean} Flag to disable memoization in unit tests.
|
||||
*/
|
||||
goog.define('goog.memoize.ENABLE_MEMOIZE', true);
|
||||
|
||||
|
||||
/**
|
||||
* Clears the memoization cache on the given object.
|
||||
* @param {Object} cacheOwner The owner of the cache. This is the {@code this}
|
||||
* context of the memoized function.
|
||||
*/
|
||||
goog.memoize.clearCache = function(cacheOwner) {
|
||||
cacheOwner[goog.memoize.CACHE_PROPERTY_] = {};
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Name of the property used by goog.memoize as cache.
|
||||
* @type {string}
|
||||
* @private
|
||||
*/
|
||||
goog.memoize.CACHE_PROPERTY_ = 'closure_memoize_cache_';
|
||||
|
||||
|
||||
/**
|
||||
* Simple and fast argument serializer function for goog.memoize.
|
||||
* Supports string, number, boolean, null and undefined arguments. Doesn't
|
||||
* support \x0B characters in the strings.
|
||||
* @param {number} functionUid Unique identifier of the function whose result
|
||||
* is cached.
|
||||
* @param {Object} args The arguments that the function to memoize is called
|
||||
* with. Note: it is an array-like object, because supports indexing and
|
||||
* has the length property.
|
||||
* @return {string} The list of arguments with type information concatenated
|
||||
* with the functionUid argument, serialized as \x0B-separated string.
|
||||
*/
|
||||
goog.memoize.simpleSerializer = function(functionUid, args) {
|
||||
var context = [functionUid];
|
||||
for (var i = args.length - 1; i >= 0; --i) {
|
||||
context.push(typeof args[i], args[i]);
|
||||
}
|
||||
return context.join('\x0B');
|
||||
};
|
||||
@@ -0,0 +1,22 @@
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<!--
|
||||
Copyright 2008 The Closure Library Authors. All Rights Reserved.
|
||||
|
||||
Use of this source code is governed by the Apache License, Version 2.0.
|
||||
See the COPYING file for details.
|
||||
-->
|
||||
<head>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
|
||||
<title>
|
||||
Closure Unit Tests - goog.memoize
|
||||
</title>
|
||||
<script src="../base.js">
|
||||
</script>
|
||||
<script>
|
||||
goog.require('goog.memoizeTest');
|
||||
</script>
|
||||
</head>
|
||||
<body>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,153 @@
|
||||
// Copyright 2008 The Closure Library Authors. All Rights Reserved.
|
||||
//
|
||||
// Licensed 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.
|
||||
|
||||
goog.provide('goog.memoizeTest');
|
||||
goog.setTestOnly('goog.memoizeTest');
|
||||
|
||||
goog.require('goog.memoize');
|
||||
goog.require('goog.testing.jsunit');
|
||||
|
||||
function testNoArgs() {
|
||||
var called = 0;
|
||||
var f = goog.memoize(function() {
|
||||
called++;
|
||||
return 10;
|
||||
});
|
||||
|
||||
assertEquals('f() 1st call', 10, f());
|
||||
assertEquals('f() 2nd call', 10, f());
|
||||
assertEquals('f() 3rd call', 10, f.call());
|
||||
assertEquals('f() called once', 1, called);
|
||||
}
|
||||
|
||||
function testOneOptionalArgSimple() {
|
||||
var called = 0;
|
||||
var f = goog.memoize(function(opt_x) {
|
||||
called++;
|
||||
return arguments.length == 0 ? 'no args' : opt_x;
|
||||
});
|
||||
|
||||
assertEquals('f() 1st call', 'no args', f());
|
||||
assertEquals('f() 2nd call', 'no args', f());
|
||||
assertEquals('f(0) 1st call', 0, f(0));
|
||||
assertEquals('f(0) 2nd call', 0, f(0));
|
||||
assertEquals('f("") 1st call', '', f(''));
|
||||
assertEquals('f("") 2nd call', '', f(''));
|
||||
assertEquals('f("0") 1st call', '0', f('0'));
|
||||
assertEquals('f("0") 1st call', '0', f('0'));
|
||||
assertEquals('f(null) 1st call', null, f(null));
|
||||
assertEquals('f(null) 2nd call', null, f(null));
|
||||
assertEquals('f(undefined) 1st call', undefined, f(undefined));
|
||||
assertEquals('f(undefined) 2nd call', undefined, f(undefined));
|
||||
|
||||
assertEquals('f(opt_x) called 6 times', 6, called);
|
||||
}
|
||||
|
||||
function testProtoFunctions() {
|
||||
var fcalled = 0;
|
||||
var gcalled = 0;
|
||||
var Class = function(x) {
|
||||
this.x = x;
|
||||
this.f = goog.memoize(function(y) {
|
||||
fcalled++;
|
||||
return this.x + y;
|
||||
});
|
||||
};
|
||||
Class.prototype.g = goog.memoize(function(z) {
|
||||
gcalled++;
|
||||
return this.x - z;
|
||||
});
|
||||
|
||||
var obj1 = new Class(10);
|
||||
var obj2 = new Class(20);
|
||||
|
||||
assertEquals('10+1', 11, obj1.f(1));
|
||||
assertEquals('10+2', 12, obj1.f(2));
|
||||
assertEquals('10+2 again', 12, obj1.f(2));
|
||||
assertEquals('f called twice', 2, fcalled);
|
||||
|
||||
assertEquals('10-1', 9, obj1.g(1));
|
||||
assertEquals('10-2', 8, obj1.g(2));
|
||||
assertEquals('10-2 again', 8, obj1.g(2));
|
||||
assertEquals('g called twice', 2, gcalled);
|
||||
|
||||
assertEquals('20+1', 21, obj2.f(1));
|
||||
assertEquals('20+2', 22, obj2.f(2));
|
||||
assertEquals('20+2 again', 22, obj2.f(2));
|
||||
assertEquals('f called 4 times', 4, fcalled);
|
||||
|
||||
assertEquals('20-1', 19, obj2.g(1));
|
||||
assertEquals('20-2', 18, obj2.g(2));
|
||||
assertEquals('20-2 again', 18, obj2.g(2));
|
||||
assertEquals('g called 4 times', 4, gcalled);
|
||||
}
|
||||
|
||||
function testCustomSerializer() {
|
||||
var called = 0;
|
||||
var serializer = function(this_context, args) {
|
||||
return String(args[0].getTime());
|
||||
};
|
||||
var getYear = goog.memoize(function(date) {
|
||||
called++;
|
||||
return date.getFullYear();
|
||||
}, serializer);
|
||||
|
||||
assertEquals('getYear(2008, 0, 1), 1st', 2008, getYear(new Date(2008, 0, 1)));
|
||||
assertEquals('getYear(2008, 0, 1), 2nd', 2008, getYear(new Date(2008, 0, 1)));
|
||||
assertEquals('getYear called once', 1, called);
|
||||
|
||||
assertEquals('getYear(2007, 0, 1)', 2007, getYear(new Date(2007, 0, 1)));
|
||||
assertEquals('getYear called twice', 2, called);
|
||||
}
|
||||
|
||||
function testClearCache() {
|
||||
var computed = 0;
|
||||
var identity = goog.memoize(function(x) {
|
||||
computed++;
|
||||
return x;
|
||||
});
|
||||
assertEquals('identity(1)==1', 1, identity(1));
|
||||
assertEquals('identity(1)==1', 1, identity(1));
|
||||
assertEquals('identity(1)==1', 1, identity(1));
|
||||
assertEquals('Expected memozation', 1, computed);
|
||||
|
||||
goog.memoize.clearCache(goog.global);
|
||||
assertEquals('identity(1)==1', 1, identity(1));
|
||||
assertEquals('identity(1)==1', 1, identity(1));
|
||||
assertEquals('Expected cleared memoization cache', 2, computed);
|
||||
}
|
||||
|
||||
function testDisableMemoize() {
|
||||
var computed = 0;
|
||||
var identity = goog.memoize(function(x) {
|
||||
computed++;
|
||||
return x;
|
||||
});
|
||||
|
||||
assertEquals('return value on first call', 1, identity(1));
|
||||
assertEquals('return value on second call (memoized)', 1, identity(1));
|
||||
assertEquals('computed once', 1, computed);
|
||||
|
||||
goog.memoize.ENABLE_MEMOIZE = false;
|
||||
|
||||
try {
|
||||
assertEquals('return value after disabled memoization', 1, identity(1));
|
||||
assertEquals('computed again', 2, computed);
|
||||
} finally {
|
||||
goog.memoize.ENABLE_MEMOIZE = true;
|
||||
}
|
||||
|
||||
assertEquals('return value after reenabled memoization', 1, identity(1));
|
||||
assertEquals('not computed again', 2, computed);
|
||||
}
|
||||
Reference in New Issue
Block a user