#!/usr/bin/env python # # Copyright (c) 2014-2018 Apple Inc. All rights reserved. # Copyright (c) 2014 University of Washington. All rights reserved. # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions # are met: # 1. Redistributions of source code must retain the above copyright # notice, this list of conditions and the following disclaimer. # 2. 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. # # THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS 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 APPLE INC. OR ITS 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. import logging import string import re from string import Template from cpp_generator import CppGenerator from generator import Generator from models import PrimitiveType, EnumType, AliasedType, Frameworks from objc_generator import ObjCTypeCategory, ObjCGenerator, join_type_and_name from objc_generator_templates import ObjCGeneratorTemplates as ObjCTemplates log = logging.getLogger('global') class ObjCBackendDispatcherImplementationGenerator(ObjCGenerator): def __init__(self, *args, **kwargs): ObjCGenerator.__init__(self, *args, **kwargs) def output_filename(self): return '%sBackendDispatchers.mm' % self.protocol_name() def domains_to_generate(self): return filter(self.should_generate_commands_for_domain, Generator.domains_to_generate(self)) def generate_output(self): secondary_headers = [ '"%sInternal.h"' % self.protocol_name(), '"%sTypeConversions.h"' % self.protocol_name(), '', ] header_args = { 'primaryInclude': '"%sBackendDispatchers.h"' % self.protocol_name(), 'secondaryIncludes': '\n'.join(['#include %s' % header for header in secondary_headers]), } domains = self.domains_to_generate() sections = [] sections.append(self.generate_license()) sections.append(Template(ObjCTemplates.BackendDispatcherImplementationPrelude).substitute(None, **header_args)) sections.extend(map(self._generate_handler_implementation_for_domain, domains)) sections.append(Template(ObjCTemplates.BackendDispatcherImplementationPostlude).substitute(None, **header_args)) return '\n\n'.join(sections) def _generate_handler_implementation_for_domain(self, domain): commands = self.commands_for_domain(domain) if not commands: return '' command_declarations = [] for command in commands: command_declarations.append(self._generate_handler_implementation_for_command(domain, command)) return '\n'.join(command_declarations) def _generate_handler_implementation_for_command(self, domain, command): lines = [] parameters = ['long requestId'] for parameter in command.call_parameters: parameters.append('%s in_%s' % (CppGenerator.cpp_type_for_unchecked_formal_in_parameter(parameter), parameter.parameter_name)) command_args = { 'domainName': domain.domain_name, 'commandName': command.command_name, 'parameters': ', '.join(parameters), 'successCallback': self._generate_success_block_for_command(domain, command), 'conversions': self._generate_conversions_for_command(domain, command), 'invocation': self._generate_invocation_for_command(domain, command), } return self.wrap_with_guard_for_domain(domain, Template(ObjCTemplates.BackendDispatcherHeaderDomainHandlerImplementation).substitute(None, **command_args)) def _generate_success_block_for_command(self, domain, command): lines = [] if command.return_parameters: success_block_parameters = [] for parameter in command.return_parameters: objc_type = self.objc_type_for_param(domain, command.command_name, parameter) var_name = ObjCGenerator.identifier_to_objc_identifier(parameter.parameter_name) success_block_parameters.append(join_type_and_name(objc_type, var_name)) lines.append(' id successCallback = ^(%s) {' % ', '.join(success_block_parameters)) else: lines.append(' id successCallback = ^{') if command.return_parameters: lines.append(' Ref resultObject = JSON::Object::create();') required_pointer_parameters = filter(lambda parameter: not parameter.is_optional and ObjCGenerator.is_type_objc_pointer_type(parameter.type), command.return_parameters) for parameter in required_pointer_parameters: var_name = ObjCGenerator.identifier_to_objc_identifier(parameter.parameter_name) lines.append(' THROW_EXCEPTION_FOR_REQUIRED_PARAMETER(%s, @"%s");' % (var_name, var_name)) objc_array_class = self.objc_class_for_array_type(parameter.type) if objc_array_class and objc_array_class.startswith(self.objc_prefix()): lines.append(' THROW_EXCEPTION_FOR_BAD_TYPE_IN_ARRAY(%s, [%s class]);' % (var_name, objc_array_class)) optional_pointer_parameters = filter(lambda parameter: parameter.is_optional and ObjCGenerator.is_type_objc_pointer_type(parameter.type), command.return_parameters) for parameter in optional_pointer_parameters: var_name = ObjCGenerator.identifier_to_objc_identifier(parameter.parameter_name) lines.append(' THROW_EXCEPTION_FOR_BAD_OPTIONAL_PARAMETER(%s, @"%s");' % (var_name, var_name)) objc_array_class = self.objc_class_for_array_type(parameter.type) if objc_array_class and objc_array_class.startswith(self.objc_prefix()): lines.append(' THROW_EXCEPTION_FOR_BAD_TYPE_IN_OPTIONAL_ARRAY(%s, [%s class]);' % (var_name, objc_array_class)) for parameter in command.return_parameters: keyed_set_method = CppGenerator.cpp_setter_method_for_type(parameter.type) var_name = ObjCGenerator.identifier_to_objc_identifier(parameter.parameter_name) var_expression = '*%s' % var_name if parameter.is_optional else var_name export_expression = self.objc_protocol_export_expression_for_variable(parameter.type, var_expression) if not parameter.is_optional: lines.append(' resultObject->%s("%s"_s, %s);' % (keyed_set_method, parameter.parameter_name, export_expression)) else: lines.append(' if (%s)' % var_name) lines.append(' resultObject->%s("%s"_s, %s);' % (keyed_set_method, parameter.parameter_name, export_expression)) lines.append(' backendDispatcher()->sendResponse(requestId, WTFMove(resultObject), false);') else: lines.append(' backendDispatcher()->sendResponse(requestId, JSON::Object::create(), false);') lines.append(' };') return '\n'.join(lines) def _generate_conversions_for_command(self, domain, command): lines = [] if command.call_parameters: lines.append('') def in_param_expression(param_name, parameter): _type = parameter.type if isinstance(_type, AliasedType): _type = _type.aliased_type # Fall through to enum or primitive. if isinstance(_type, EnumType): _type = _type.primitive_type # Fall through to primitive. if isinstance(_type, PrimitiveType): if _type.raw_name() in ['array', 'any', 'object']: return '&%s' % param_name if not parameter.is_optional else param_name return '*%s' % param_name if parameter.is_optional else param_name return '&%s' % param_name if not parameter.is_optional else param_name for parameter in command.call_parameters: in_param_name = 'in_%s' % parameter.parameter_name objc_in_param_name = 'o_%s' % in_param_name objc_type = self.objc_type_for_param(domain, command.command_name, parameter, False) if isinstance(parameter.type, EnumType): objc_type = 'std::optional<%s>' % objc_type param_expression = in_param_expression(in_param_name, parameter) import_expression = self.objc_protocol_import_expression_for_parameter(param_expression, domain, command.command_name, parameter) if not parameter.is_optional: lines.append(' %s = %s;' % (join_type_and_name(objc_type, objc_in_param_name), import_expression)) if isinstance(parameter.type, EnumType): lines.append(' if (!%s) {' % objc_in_param_name) lines.append(' backendDispatcher()->reportProtocolError(BackendDispatcher::InvalidParams, "Parameter \'%s\' of method \'%s.%s\' cannot be processed"_s);' % (parameter.parameter_name, domain.domain_name, command.command_name)) lines.append(' return;') lines.append(' }') else: lines.append(' %s;' % join_type_and_name(objc_type, objc_in_param_name)) lines.append(' if (%s)' % in_param_name) lines.append(' %s = %s;' % (objc_in_param_name, import_expression)) if lines: lines.append('') return '\n'.join(lines) def _generate_invocation_for_command(self, domain, command): pairs = [] pairs.append('WithErrorCallback:errorCallback') pairs.append('successCallback:successCallback') for parameter in command.call_parameters: in_param_name = 'in_%s' % parameter.parameter_name objc_in_param_expression = 'o_%s' % in_param_name if not parameter.is_optional: # FIXME: we don't handle optional enum values in commands here because it isn't used anywhere yet. # We'd need to change the delegate's signature to take std::optional for optional enum values. if isinstance(parameter.type, EnumType): objc_in_param_expression = '%s.value()' % objc_in_param_expression pairs.append('%s:%s' % (parameter.parameter_name, objc_in_param_expression)) else: optional_expression = '(%s ? &%s : nil)' % (in_param_name, objc_in_param_expression) pairs.append('%s:%s' % (parameter.parameter_name, optional_expression)) return ' [m_delegate %s%s];' % (command.command_name, ' '.join(pairs))