mirror of
https://github.com/flutter/flutter.git
synced 2026-02-20 02:29:02 +08:00
6bcc09dbd0
Remove all code relating to shadow trees, insertion points, shadow boundaries, traversing composed trees, distribution, template documents, custom elements, registering elements, element registries, element factories, shadow roots, etc. Remove the following features from the IDLs and from the binding generators: CustomElementCallbacks, Reflect*, EventHandler. Remove the CSS custom pseudo-element concept, since we no longer have a UA style sheet worth talking about, no longer have shadow trees or custom elements, no longer use pseudo-elements, and generally therefore don't use this code at all.
294 lines
12 KiB
Python
294 lines
12 KiB
Python
# Copyright (C) 2013 Google Inc. All rights reserved.
|
|
#
|
|
# Redistribution and use in source and binary forms, with or without
|
|
# modification, are permitted provided that the following conditions are
|
|
# met:
|
|
#
|
|
# * Redistributions of source code must retain the above copyright
|
|
# notice, this list of conditions and the following disclaimer.
|
|
# * Redistributions in binary form must reproduce the above
|
|
# copyright notice, this list of conditions and the following disclaimer
|
|
# in the documentation and/or other materials provided with the
|
|
# distribution.
|
|
# * Neither the name of Google Inc. nor the names of its
|
|
# contributors may be used to endorse or promote products derived from
|
|
# this software without specific prior written permission.
|
|
#
|
|
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
"""Generate template values for attributes.
|
|
|
|
Extends IdlType with property |constructor_type_name|.
|
|
|
|
Design doc: http://www.chromium.org/developers/design-documents/idl-compiler
|
|
"""
|
|
|
|
import idl_types
|
|
from idl_types import inherits_interface
|
|
from v8_globals import includes, interfaces
|
|
import v8_types
|
|
import v8_utilities
|
|
from v8_utilities import (capitalize, cpp_name, has_extended_attribute,
|
|
has_extended_attribute_value, scoped_name, strip_suffix,
|
|
uncapitalize, extended_attribute_value_as_list)
|
|
|
|
|
|
def attribute_context(interface, attribute):
|
|
idl_type = attribute.idl_type
|
|
base_idl_type = idl_type.base_type
|
|
extended_attributes = attribute.extended_attributes
|
|
|
|
idl_type.add_includes_for_type()
|
|
|
|
# [TypeChecking]
|
|
has_type_checking_unrestricted = (
|
|
(has_extended_attribute_value(interface, 'TypeChecking', 'Unrestricted') or
|
|
has_extended_attribute_value(attribute, 'TypeChecking', 'Unrestricted')) and
|
|
idl_type.name in ('Float', 'Double'))
|
|
|
|
context = {
|
|
'argument_cpp_type': idl_type.cpp_type_args(used_as_rvalue_type=True),
|
|
'cached_attribute_validation_method': extended_attributes.get('CachedAttribute'),
|
|
'constructor_type': idl_type.constructor_type_name
|
|
if is_constructor_attribute(attribute) else None,
|
|
'cpp_name': cpp_name(attribute),
|
|
'cpp_type': idl_type.cpp_type,
|
|
'cpp_type_initializer': idl_type.cpp_type_initializer,
|
|
'enum_validation_expression': idl_type.enum_validation_expression,
|
|
'exposed_test': v8_utilities.exposed(attribute, interface), # [Exposed]
|
|
'has_custom_getter': has_custom_getter(attribute),
|
|
'has_custom_setter': has_custom_setter(attribute),
|
|
'has_type_checking_unrestricted': has_type_checking_unrestricted,
|
|
'idl_type': str(idl_type), # need trailing [] on array for Dictionary::ConversionContext::setConversionType
|
|
'is_call_with_execution_context': v8_utilities.has_extended_attribute_value(attribute, 'CallWith', 'ExecutionContext'),
|
|
'is_call_with_script_state': v8_utilities.has_extended_attribute_value(attribute, 'CallWith', 'ScriptState'),
|
|
'is_getter_raises_exception': # [RaisesException]
|
|
'RaisesException' in extended_attributes and
|
|
extended_attributes['RaisesException'] in (None, 'Getter'),
|
|
'is_initialized_by_event_constructor':
|
|
'InitializedByEventConstructor' in extended_attributes,
|
|
'is_keep_alive_for_gc': is_keep_alive_for_gc(interface, attribute),
|
|
'is_nullable': idl_type.is_nullable,
|
|
'is_explicit_nullable': idl_type.is_explicit_nullable,
|
|
'is_partial_interface_member':
|
|
'PartialInterfaceImplementedAs' in extended_attributes,
|
|
'is_read_only': attribute.is_read_only,
|
|
'is_replaceable': 'Replaceable' in attribute.extended_attributes,
|
|
'is_static': attribute.is_static,
|
|
'is_url': 'URL' in extended_attributes,
|
|
'name': attribute.name,
|
|
'put_forwards': 'PutForwards' in extended_attributes,
|
|
'setter_callback': setter_callback_name(interface, attribute),
|
|
}
|
|
|
|
if is_constructor_attribute(attribute):
|
|
constructor_getter_context(interface, attribute, context)
|
|
return context
|
|
if not has_custom_getter(attribute):
|
|
getter_context(interface, attribute, context)
|
|
if (not has_custom_setter(attribute) and
|
|
(not attribute.is_read_only or 'PutForwards' in extended_attributes)):
|
|
setter_context(interface, attribute, context)
|
|
|
|
return context
|
|
|
|
|
|
################################################################################
|
|
# Getter
|
|
################################################################################
|
|
|
|
def getter_context(interface, attribute, context):
|
|
cpp_value = getter_expression(interface, attribute, context)
|
|
|
|
context.update({
|
|
'cpp_value': cpp_value,
|
|
})
|
|
|
|
|
|
def getter_expression(interface, attribute, context):
|
|
arguments = []
|
|
this_getter_base_name = getter_base_name(interface, attribute, arguments)
|
|
getter_name = scoped_name(interface, attribute, this_getter_base_name)
|
|
|
|
arguments.extend(v8_utilities.call_with_arguments(
|
|
attribute.extended_attributes.get('CallWith')))
|
|
# Members of IDL partial interface definitions are implemented in C++ as
|
|
# static member functions, which for instance members (non-static members)
|
|
# take *impl as their first argument
|
|
if ('PartialInterfaceImplementedAs' in attribute.extended_attributes and
|
|
not attribute.is_static):
|
|
arguments.append('*impl')
|
|
if attribute.idl_type.is_explicit_nullable:
|
|
arguments.append('isNull')
|
|
if context['is_getter_raises_exception']:
|
|
arguments.append('exceptionState')
|
|
return '%s(%s)' % (getter_name, ', '.join(arguments))
|
|
|
|
|
|
CONTENT_ATTRIBUTE_GETTER_NAMES = {
|
|
'boolean': 'hasAttribute',
|
|
'long': 'getIntegralAttribute',
|
|
'unsigned long': 'getUnsignedIntegralAttribute',
|
|
}
|
|
|
|
|
|
def getter_base_name(interface, attribute, arguments):
|
|
extended_attributes = attribute.extended_attributes
|
|
|
|
return uncapitalize(cpp_name(attribute))
|
|
|
|
content_attribute_name = attribute.name.lower()
|
|
if content_attribute_name in ['class', 'id']:
|
|
# Special-case for performance optimization.
|
|
return 'get%sAttribute' % content_attribute_name.capitalize()
|
|
|
|
arguments.append(scoped_content_attribute_name(interface, attribute))
|
|
|
|
base_idl_type = attribute.idl_type.base_type
|
|
if base_idl_type in CONTENT_ATTRIBUTE_GETTER_NAMES:
|
|
return CONTENT_ATTRIBUTE_GETTER_NAMES[base_idl_type]
|
|
if 'URL' in attribute.extended_attributes:
|
|
return 'getURLAttribute'
|
|
return 'getAttribute'
|
|
|
|
|
|
def is_keep_alive_for_gc(interface, attribute):
|
|
idl_type = attribute.idl_type
|
|
base_idl_type = idl_type.base_type
|
|
extended_attributes = attribute.extended_attributes
|
|
return (
|
|
# For readonly attributes, for performance reasons we keep the attribute
|
|
# wrapper alive while the owner wrapper is alive, because the attribute
|
|
# never changes.
|
|
(attribute.is_read_only and
|
|
idl_type.is_wrapper_type and
|
|
# There are some exceptions, however:
|
|
not(
|
|
# Node lifetime is managed by object grouping.
|
|
inherits_interface(interface.name, 'Node') or
|
|
inherits_interface(base_idl_type, 'Node') or
|
|
# A self-reference is unnecessary.
|
|
attribute.name == 'self' or
|
|
# FIXME: Remove these hard-coded hacks.
|
|
base_idl_type in ['EventTarget', 'Window'] or
|
|
base_idl_type.startswith('HTML'))))
|
|
|
|
|
|
################################################################################
|
|
# Setter
|
|
################################################################################
|
|
|
|
def setter_context(interface, attribute, context):
|
|
if 'PutForwards' in attribute.extended_attributes:
|
|
# Use target interface and attribute in place of original interface and
|
|
# attribute from this point onwards.
|
|
target_interface_name = attribute.idl_type.base_type
|
|
target_attribute_name = attribute.extended_attributes['PutForwards']
|
|
interface = interfaces[target_interface_name]
|
|
try:
|
|
attribute = next(candidate
|
|
for candidate in interface.attributes
|
|
if candidate.name == target_attribute_name)
|
|
except StopIteration:
|
|
raise Exception('[PutForward] target not found:\n'
|
|
'Attribute "%s" is not present in interface "%s"' %
|
|
(target_attribute_name, target_interface_name))
|
|
|
|
extended_attributes = attribute.extended_attributes
|
|
idl_type = attribute.idl_type
|
|
|
|
# [RaisesException], [RaisesException=Setter]
|
|
is_setter_raises_exception = (
|
|
'RaisesException' in extended_attributes and
|
|
extended_attributes['RaisesException'] in [None, 'Setter'])
|
|
# [TypeChecking=Interface]
|
|
has_type_checking_interface = (
|
|
(has_extended_attribute_value(interface, 'TypeChecking', 'Interface') or
|
|
has_extended_attribute_value(attribute, 'TypeChecking', 'Interface')) and
|
|
idl_type.is_wrapper_type)
|
|
|
|
context.update({
|
|
'has_setter_exception_state':
|
|
is_setter_raises_exception or has_type_checking_interface or
|
|
context['has_type_checking_unrestricted'] or
|
|
idl_type.may_raise_exception_on_conversion,
|
|
'has_type_checking_interface': has_type_checking_interface,
|
|
'is_setter_call_with_execution_context': v8_utilities.has_extended_attribute_value(
|
|
attribute, 'SetterCallWith', 'ExecutionContext'),
|
|
'is_setter_raises_exception': is_setter_raises_exception,
|
|
})
|
|
|
|
|
|
CONTENT_ATTRIBUTE_SETTER_NAMES = {
|
|
'boolean': 'setBooleanAttribute',
|
|
'long': 'setIntegralAttribute',
|
|
'unsigned long': 'setUnsignedIntegralAttribute',
|
|
}
|
|
|
|
|
|
def setter_base_name(interface, attribute, arguments):
|
|
return 'set%s' % capitalize(cpp_name(attribute))
|
|
|
|
|
|
def scoped_content_attribute_name(interface, attribute):
|
|
content_attribute_name = attribute.name.lower()
|
|
namespace = 'HTMLNames'
|
|
includes.add('gen/sky/core/%s.h' % namespace)
|
|
return '%s::%sAttr' % (namespace, content_attribute_name)
|
|
|
|
|
|
################################################################################
|
|
# Attribute configuration
|
|
################################################################################
|
|
|
|
# [Replaceable]
|
|
def setter_callback_name(interface, attribute):
|
|
cpp_class_name = cpp_name(interface)
|
|
extended_attributes = attribute.extended_attributes
|
|
if (('Replaceable' in extended_attributes and
|
|
'PutForwards' not in extended_attributes) or
|
|
is_constructor_attribute(attribute)):
|
|
return '{0}V8Internal::{0}ForceSetAttributeOnThisCallback'.format(cpp_class_name)
|
|
if attribute.is_read_only and 'PutForwards' not in extended_attributes:
|
|
return '0'
|
|
return '%sV8Internal::%sAttributeSetterCallback' % (cpp_class_name, attribute.name)
|
|
|
|
|
|
# [Custom], [Custom=Getter]
|
|
def has_custom_getter(attribute):
|
|
extended_attributes = attribute.extended_attributes
|
|
return ('Custom' in extended_attributes and
|
|
extended_attributes['Custom'] in [None, 'Getter'])
|
|
|
|
|
|
# [Custom], [Custom=Setter]
|
|
def has_custom_setter(attribute):
|
|
extended_attributes = attribute.extended_attributes
|
|
return (not attribute.is_read_only and
|
|
'Custom' in extended_attributes and
|
|
extended_attributes['Custom'] in [None, 'Setter'])
|
|
|
|
|
|
################################################################################
|
|
# Constructors
|
|
################################################################################
|
|
|
|
idl_types.IdlType.constructor_type_name = property(
|
|
# FIXME: replace this with a [ConstructorAttribute] extended attribute
|
|
lambda self: strip_suffix(self.base_type, 'Constructor'))
|
|
|
|
|
|
def is_constructor_attribute(attribute):
|
|
# FIXME: replace this with [ConstructorAttribute] extended attribute
|
|
return attribute.idl_type.name.endswith('Constructor')
|