Index: lib/runtime/dart/_classes.js |
diff --git a/lib/runtime/dart/_classes.js b/lib/runtime/dart/_classes.js |
deleted file mode 100644 |
index 837a1da64d7b1d9c592a7fc0cade78760b64d93f..0000000000000000000000000000000000000000 |
--- a/lib/runtime/dart/_classes.js |
+++ /dev/null |
@@ -1,419 +0,0 @@ |
-// Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file |
-// for details. All rights reserved. Use of this source code is governed by a |
-// BSD-style license that can be found in the LICENSE file. |
- |
-/* This library defines the operations that define and manipulate Dart |
- * classes. Included in this are: |
- * - Generics |
- * - Class metadata |
- * - Extension methods |
- */ |
- |
-// TODO(leafp): Consider splitting some of this out. |
-dart_library.library('dart/_classes', null, /* Imports */[ |
-], /* Lazy Imports */[ |
- 'dart/_utils', |
- 'dart/core', |
- 'dart/_interceptors', |
- 'dart/_types', |
- 'dart/_rtti', |
-], function(exports, dart_utils, core, _interceptors, types, rtti) { |
- 'use strict'; |
- |
- const assert = dart_utils.assert; |
- const copyProperties = dart_utils.copyProperties; |
- const copyTheseProperties = dart_utils.copyTheseProperties; |
- const defineMemoizedGetter = dart_utils.defineMemoizedGetter; |
- const safeGetOwnProperty = dart_utils.safeGetOwnProperty; |
- const throwInternalError = dart_utils.throwInternalError; |
- |
- const defineProperty = Object.defineProperty; |
- const getOwnPropertyDescriptor = Object.getOwnPropertyDescriptor; |
- const getOwnPropertySymbols = Object.getOwnPropertySymbols; |
- |
- /** The Symbol for storing type arguments on a specialized generic type. */ |
- const _mixins = Symbol('mixins'); |
- const _implements = Symbol('implements'); |
- exports.implements = _implements; |
- const _metadata = Symbol('metadata'); |
- exports.metadata = _metadata; |
- |
- /** |
- * Returns a new type that mixes members from base and all mixins. |
- * |
- * Each mixin applies in sequence, with further to the right ones overriding |
- * previous entries. |
- * |
- * For each mixin, we only take its own properties, not anything from its |
- * superclass (prototype). |
- */ |
- function mixin(base, ...mixins) { |
- // Create an initializer for the mixin, so when derived constructor calls |
- // super, we can correctly initialize base and mixins. |
- |
- // Create a class that will hold all of the mixin methods. |
- class Mixin extends base { |
- // Initializer method: run mixin initializers, then the base. |
- [base.name](...args) { |
- // Run mixin initializers. They cannot have arguments. |
- // Run them backwards so most-derived mixin is initialized first. |
- for (let i = mixins.length - 1; i >= 0; i--) { |
- let mixin = mixins[i]; |
- let init = mixin.prototype[mixin.name]; |
- if (init) init.call(this); |
- } |
- // Run base initializer. |
- let init = base.prototype[base.name]; |
- if (init) init.apply(this, args); |
- } |
- } |
- // Copy each mixin's methods, with later ones overwriting earlier entries. |
- for (let m of mixins) { |
- copyProperties(Mixin.prototype, m.prototype); |
- } |
- |
- // Set the signature of the Mixin class to be the composition |
- // of the signatures of the mixins. |
- setSignature(Mixin, { |
- methods: () => { |
- let s = {}; |
- for (let m of mixins) { |
- copyProperties(s, m[_methodSig]); |
- } |
- return s; |
- } |
- }); |
- |
- // Save mixins for reflection |
- Mixin[_mixins] = mixins; |
- return Mixin; |
- } |
- exports.mixin = mixin; |
- |
- function getMixins (clazz) { |
- return clazz[_mixins]; |
- } |
- exports.getMixins = getMixins; |
- |
- function getImplements (clazz) { |
- return clazz[_implements]; |
- } |
- exports.getImplements = getImplements; |
- |
- /** The Symbol for storing type arguments on a specialized generic type. */ |
- let _typeArguments = Symbol('typeArguments'); |
- let _originalDeclaration = Symbol('originalDeclaration'); |
- |
- /** Memoize a generic type constructor function. */ |
- function generic(typeConstructor) { |
- let length = typeConstructor.length; |
- if (length < 1) { |
- throwInternalError('must have at least one generic type argument'); |
- } |
- let resultMap = new Map(); |
- function makeGenericType(...args) { |
- if (args.length != length && args.length != 0) { |
- throwInternalError('requires ' + length + ' or 0 type arguments'); |
- } |
- while (args.length < length) args.push(types.dynamic); |
- |
- let value = resultMap; |
- for (let i = 0; i < length; i++) { |
- let arg = args[i]; |
- if (arg == null) { |
- throwInternalError('type arguments should not be null: ' |
- + typeConstructor); |
- } |
- let map = value; |
- value = map.get(arg); |
- if (value === void 0) { |
- if (i + 1 == length) { |
- value = typeConstructor.apply(null, args); |
- // Save the type constructor and arguments for reflection. |
- if (value) { |
- value[_typeArguments] = args; |
- value[_originalDeclaration] = makeGenericType; |
- } |
- } else { |
- value = new Map(); |
- } |
- map.set(arg, value); |
- } |
- } |
- return value; |
- } |
- return makeGenericType; |
- } |
- exports.generic = generic; |
- |
- function getGenericClass(type) { |
- return safeGetOwnProperty(type, _originalDeclaration); |
- }; |
- exports.getGenericClass = getGenericClass; |
- |
- function getGenericArgs(type) { |
- return safeGetOwnProperty(type, _typeArguments); |
- }; |
- exports.getGenericArgs = getGenericArgs; |
- |
- let _constructorSig = Symbol('sigCtor'); |
- let _methodSig = Symbol("sig"); |
- let _staticSig = Symbol("sigStatic"); |
- |
- /// Get the type of a method using the stored signature |
- function _getMethodType(obj, name) { |
- if (obj === void 0) return void 0; |
- if (obj == null) return void 0; |
- let sigObj = obj.__proto__.constructor[_methodSig]; |
- if (sigObj === void 0) return void 0; |
- let parts = sigObj[name]; |
- if (parts === void 0) return void 0; |
- return types.definiteFunctionType.apply(null, parts); |
- } |
- |
- /// Get the type of a constructor from a class using the stored signature |
- /// If name is undefined, returns the type of the default constructor |
- /// Returns undefined if the constructor is not found. |
- function _getConstructorType(cls, name) { |
- if(!name) name = cls.name; |
- if (cls === void 0) return void 0; |
- if (cls == null) return void 0; |
- let sigCtor = cls[_constructorSig]; |
- if (sigCtor === void 0) return void 0; |
- let parts = sigCtor[name]; |
- if (parts === void 0) return void 0; |
- return types.definiteFunctionType.apply(null, parts); |
- } |
- exports.classGetConstructorType = _getConstructorType; |
- |
- /// Given an object and a method name, tear off the method. |
- /// Sets the runtime type of the torn off method appropriately, |
- /// and also binds the object. |
- /// |
- /// If the optional `f` argument is passed in, it will be used as the method. |
- /// This supports cases like `super.foo` where we need to tear off the method |
- /// from the superclass, not from the `obj` directly. |
- /// TODO(leafp): Consider caching the tearoff on the object? |
- function bind(obj, name, f) { |
- if (f === void 0) f = obj[name]; |
- f = f.bind(obj); |
- // TODO(jmesserly): track the function's signature on the function, instead |
- // of having to go back to the class? |
- let sig = _getMethodType(obj, name); |
- assert(sig); |
- rtti.tag(f, sig); |
- return f; |
- } |
- exports.bind = bind; |
- |
- // Set up the method signature field on the constructor |
- function _setMethodSignature(f, sigF) { |
- defineMemoizedGetter(f, _methodSig, () => { |
- let sigObj = sigF(); |
- sigObj.__proto__ = f.__proto__[_methodSig]; |
- return sigObj; |
- }); |
- } |
- |
- // Set up the constructor signature field on the constructor |
- function _setConstructorSignature(f, sigF) { |
- defineMemoizedGetter(f, _constructorSig, sigF); |
- } |
- |
- // Set up the static signature field on the constructor |
- function _setStaticSignature(f, sigF) { |
- defineMemoizedGetter(f, _staticSig, sigF); |
- } |
- |
- // Set the lazily computed runtime type field on static methods |
- function _setStaticTypes(f, names) { |
- for (let name of names) { |
- rtti.tagMemoized(f[name], function() { |
- let parts = f[_staticSig][name]; |
- return types.definiteFunctionType.apply(null, parts); |
- }) |
- } |
- } |
- |
- /// Set up the type signature of a class (constructor object) |
- /// f is a constructor object |
- /// signature is an object containing optional properties as follows: |
- /// methods: A function returning an object mapping method names |
- /// to method types. The function is evaluated lazily and cached. |
- /// statics: A function returning an object mapping static method |
- /// names to types. The function is evalutated lazily and cached. |
- /// names: An array of the names of the static methods. Used to |
- /// permit eagerly setting the runtimeType field on the methods |
- /// while still lazily computing the type descriptor object. |
- function setSignature(f, signature) { |
- let constructors = |
- ('constructors' in signature) ? signature.constructors : () => ({}); |
- let methods = |
- ('methods' in signature) ? signature.methods : () => ({}); |
- let statics = |
- ('statics' in signature) ? signature.statics : () => ({}); |
- let names = |
- ('names' in signature) ? signature.names : []; |
- _setConstructorSignature(f, constructors); |
- _setMethodSignature(f, methods); |
- _setStaticSignature(f, statics); |
- _setStaticTypes(f, names); |
- rtti.tagMemoized(f, () => core.Type); |
- } |
- exports.setSignature = setSignature; |
- |
- function hasMethod(obj, name) { |
- return _getMethodType(obj, name) !== void 0; |
- } |
- exports.hasMethod = hasMethod; |
- |
- exports.getMethodType = _getMethodType; |
- |
- /** |
- * This is called whenever a derived class needs to introduce a new field, |
- * shadowing a field or getter/setter pair on its parent. |
- * |
- * This is important because otherwise, trying to read or write the field |
- * would end up calling the getter or setter, and one of those might not even |
- * exist, resulting in a runtime error. Even if they did exist, that's the |
- * wrong behavior if a new field was declared. |
- */ |
- function virtualField(subclass, fieldName) { |
- // If the field is already overridden, do nothing. |
- let prop = getOwnPropertyDescriptor(subclass.prototype, fieldName); |
- if (prop) return; |
- |
- let symbol = Symbol(subclass.name + '.' + fieldName); |
- defineProperty(subclass.prototype, fieldName, { |
- get: function() { return this[symbol]; }, |
- set: function(x) { this[symbol] = x; } |
- }); |
- } |
- exports.virtualField = virtualField; |
- |
- /** |
- * Given a class and an initializer method name, creates a constructor |
- * function with the same name. For example `new SomeClass.name(args)`. |
- */ |
- function defineNamedConstructor(clazz, name) { |
- let proto = clazz.prototype; |
- let initMethod = proto[name]; |
- let ctor = function() { return initMethod.apply(this, arguments); }; |
- ctor.prototype = proto; |
- // Use defineProperty so we don't hit a property defined on Function, |
- // like `caller` and `arguments`. |
- defineProperty(clazz, name, { value: ctor, configurable: true }); |
- } |
- exports.defineNamedConstructor = defineNamedConstructor; |
- |
- let _extensionType = Symbol('extensionType'); |
- |
- let dartx = {}; |
- exports.dartx = dartx; |
- |
- function getExtensionSymbol(name) { |
- let sym = dartx[name]; |
- if (!sym) dartx[name] = sym = Symbol('dartx.' + name); |
- return sym; |
- } |
- |
- function defineExtensionNames(names) { |
- names.forEach(getExtensionSymbol); |
- } |
- exports.defineExtensionNames = defineExtensionNames; |
- |
- /** |
- * Copy symbols from the prototype of the source to destination. |
- * These are the only properties safe to copy onto an existing public |
- * JavaScript class. |
- */ |
- function registerExtension(jsType, dartExtType) { |
- let extProto = dartExtType.prototype; |
- let jsProto = jsType.prototype; |
- |
- // Mark the JS type's instances so we can easily check for extensions. |
- assert(jsProto[_extensionType] === void 0); |
- jsProto[_extensionType] = extProto; |
- |
- let dartObjProto = core.Object.prototype; |
- while (extProto !== dartObjProto && extProto !== jsProto) { |
- copyTheseProperties(jsProto, extProto, getOwnPropertySymbols(extProto)); |
- extProto = extProto.__proto__; |
- } |
- let originalSigFn = getOwnPropertyDescriptor(dartExtType, _methodSig).get; |
- assert(originalSigFn); |
- defineMemoizedGetter(jsType, _methodSig, originalSigFn); |
- } |
- exports.registerExtension = registerExtension; |
- |
- /** |
- * Mark a concrete type as implementing extension methods. |
- * For example: `class MyIter implements Iterable`. |
- * |
- * This takes a list of names, which are the extension methods implemented. |
- * It will add a forwarder, so the extension method name redirects to the |
- * normal Dart method name. For example: |
- * |
- * defineExtensionMembers(MyType, ['add', 'remove']); |
- * |
- * Results in: |
- * |
- * MyType.prototype[dartx.add] = MyType.prototype.add; |
- * MyType.prototype[dartx.remove] = MyType.prototype.remove; |
- */ |
- // TODO(jmesserly): essentially this gives two names to the same method. |
- // This benefit is roughly equivalent call performance either way, but the |
- // cost is we need to call defineExtensionMembers any time a subclass |
- // overrides one of these methods. |
- function defineExtensionMembers(type, methodNames) { |
- let proto = type.prototype; |
- for (let name of methodNames) { |
- let method = getOwnPropertyDescriptor(proto, name); |
- defineProperty(proto, getExtensionSymbol(name), method); |
- } |
- // Ensure the signature is available too. |
- // TODO(jmesserly): not sure if we can do this in a cleaner way. Essentially |
- // we need to copy the signature (and in the future, other data like |
- // annotations) any time we copy a method as part of our metaprogramming. |
- // It might be more friendly to JS metaprogramming if we include this info |
- // on the function. |
- let originalSigFn = getOwnPropertyDescriptor(type, _methodSig).get; |
- defineMemoizedGetter(type, _methodSig, function() { |
- let sig = originalSigFn(); |
- for (let name of methodNames) { |
- sig[getExtensionSymbol(name)] = sig[name]; |
- } |
- return sig; |
- }); |
- } |
- exports.defineExtensionMembers = defineExtensionMembers; |
- |
- function canonicalMember(obj, name) { |
- if (obj != null && obj[_extensionType]) return dartx[name]; |
- // Check for certain names that we can't use in JS |
- if (name == 'constructor' || name == 'prototype') { |
- name = '+' + name; |
- } |
- return name; |
- } |
- exports.canonicalMember = canonicalMember; |
- |
- /** Sets the type of `obj` to be `type` */ |
- function setType(obj, type) { |
- obj.__proto__ = type.prototype; |
- return obj; |
- } |
- |
- /** Sets the element type of a list literal. */ |
- function list(obj, elementType) { |
- return setType(obj, _interceptors.JSArray$(elementType)); |
- } |
- exports.list = list; |
- |
- function setBaseClass(derived, base) { |
- // Link the extension to the type it's extending as a base class. |
- derived.prototype.__proto__ = base.prototype; |
- } |
- exports.setBaseClass = setBaseClass; |
- |
-}); |