MAINHACK

Viewing / Editing File: MultiRegionClient.php

<?php
namespace Aws;

use Aws\Endpoint\PartitionEndpointProvider;
use Aws\Endpoint\PartitionInterface;
use Aws\EndpointV2\EndpointProviderV2;
use Aws\EndpointV2\EndpointDefinitionProvider;

class MultiRegionClient implements AwsClientInterface
{
    use AwsClientTrait;

/** @var AwsClientInterface[] A pool of clients keyed by region. */
    private $clientPool = [];
    /** @var callable */
    private $factory;
    /** @var PartitionInterface */
    private $partition;
    /** @var array */
    private $args;
    /** @var array */
    private $config;
    /** @var HandlerList */
    private $handlerList;
    /** @var array */
    private $aliases;
    /** @var callable */
    private $customHandler;

public static function getArguments()
    {
        $args = array_intersect_key(
            ClientResolver::getDefaultArguments(),
            ['service' => true, 'region' => true]
        );
        $args['region']['required'] = false;
        unset($args['region']['fn']);
        unset($args['region']['default']);

return $args + [
                'client_factory' => [
                    'type' => 'config',
                    'valid' => ['callable'],
                    'doc' => 'A callable that takes an array of client'
                        . ' configuration arguments and returns a regionalized'
                        . ' client.',
                    'required' => true,
                    'internal' => true,
                    'default' => function (array $args) {
                        $namespace = manifest($args['service'])['namespace'];
                        $klass = "Aws\\{$namespace}\\{$namespace}Client";
                        $region = isset($args['region']) ? $args['region'] : null;

return function (array $args) use ($klass, $region) {
                            if ($region && empty($args['region'])) {
                                $args['region'] = $region;
                            }

return new $klass($args);
                        };
                    },
                ],
                'partition' => [
                    'type'    => 'config',
                    'valid'   => ['string', PartitionInterface::class],
                    'doc'     => 'AWS partition to connect to. Valid partitions'
                        . ' include "aws," "aws-cn," and "aws-us-gov." Used to'
                        . ' restrict the scope of the mapRegions method.',
                    'default' => function (array $args) {
                        $region = isset($args['region']) ? $args['region'] : '';
                        return PartitionEndpointProvider::defaultProvider()
                            ->getPartition($region, $args['service']);
                    },
                    'fn'      => function ($value, array &$args) {
                        if (is_string($value)) {
                            $value = PartitionEndpointProvider::defaultProvider()
                                ->getPartitionByName($value);
                        }

if (!$value instanceof PartitionInterface) {
                            throw new \InvalidArgumentException('No valid partition'
                                . ' was provided. Provide a concrete partition or'
                                . ' the name of a partition (e.g., "aws," "aws-cn,"'
                                . ' or "aws-us-gov").'
                            );
                        }
                        $ruleset = EndpointDefinitionProvider::getEndpointRuleset(
                            $args['service'],
                            isset($args['version']) ? $args['version'] : 'latest'
                        );
                        $partitions = EndpointDefinitionProvider::getPartitions();
                        $args['endpoint_provider'] = new EndpointProviderV2($ruleset, $partitions);
                    }
                ],
            ];
    }

/**
     * The multi-region client constructor accepts the following options:
     *
     * - client_factory: (callable) An optional callable that takes an array of
     *   client configuration arguments and returns a regionalized client.
     * - partition: (Aws\Endpoint\Partition|string) AWS partition to connect to.
     *   Valid partitions include "aws," "aws-cn," and "aws-us-gov." Used to
     *   restrict the scope of the mapRegions method.
     * - region: (string) Region to connect to when no override is provided.
     *   Used to create the default client factory and determine the appropriate
     *   AWS partition when present.
     *
     * @param array $args Client configuration arguments.
     */
    public function __construct(array $args = [])
    {
        if (!isset($args['service'])) {
            $args['service'] = $this->parseClass();
        }

$this->handlerList = new HandlerList(function (
            CommandInterface $command
        ) {
            list($region, $args) = $this->getRegionFromArgs($command->toArray());
            $command = $this->getClientFromPool($region)
                ->getCommand($command->getName(), $args);

if ($this->isUseCustomHandler()) {
                $command->getHandlerList()->setHandler($this->customHandler);
            }

return $this->executeAsync($command);
        });

$argDefinitions = static::getArguments();
        $resolver = new ClientResolver($argDefinitions);
        $args = $resolver->resolve($args, $this->handlerList);
        $this->config = $args['config'];
        $this->factory = $args['client_factory'];
        $this->partition = $args['partition'];
        $this->args = array_diff_key($args, $args['config']);
    }

/**
     * Get the region to which the client is configured to send requests by
     * default.
     *
     * @return string
     */
    public function getRegion()
    {
        return $this->getClientFromPool()->getRegion();
    }

/**
     * Create a command for an operation name.
     *
     * Special keys may be set on the command to control how it behaves,
     * including:
     *
     * - @http: Associative array of transfer specific options to apply to the
     *   request that is serialized for this command. Available keys include
     *   "proxy", "verify", "timeout", "connect_timeout", "debug", "delay", and
     *   "headers".
     * - @region: The region to which the command should be sent.
     *
     * @param string $name Name of the operation to use in the command
     * @param array  $args Arguments to pass to the command
     *
     * @return CommandInterface
     * @throws \InvalidArgumentException if no command can be found by name
     */
    public function getCommand($name, array $args = [])
    {
        return new Command($name, $args, clone $this->getHandlerList());
    }

public function getConfig($option = null)
    {
        if (null === $option) {
            return $this->config;
        }

if (isset($this->config[$option])) {
            return $this->config[$option];
        }

return $this->getClientFromPool()->getConfig($option);
    }

public function getCredentials()
    {
        return $this->getClientFromPool()->getCredentials();
    }

public function getHandlerList()
    {
        return $this->handlerList;
    }

public function getApi()
    {
        return $this->getClientFromPool()->getApi();
    }

public function getEndpoint()
    {
        return $this->getClientFromPool()->getEndpoint();
    }

public function useCustomHandler(callable $handler)
    {
        $this->customHandler = $handler;
    }

private function isUseCustomHandler()
    {
        return isset($this->customHandler);
    }

/**
     * @param string $region    Omit this argument or pass in an empty string to
     *                          allow the configured client factory to apply the
     *                          region.
     *
     * @return AwsClientInterface
     */
    protected function getClientFromPool($region = '')
    {
        if (empty($this->clientPool[$region])) {
            $factory = $this->factory;
            $this->clientPool[$region] = $factory(
                array_replace($this->args, array_filter(['region' => $region]))
            );
        }

return $this->clientPool[$region];
    }

/**
     * Parse the class name and return the "service" name of the client.
     *
     * @return string
     */
    private function parseClass()
    {
        $klass = get_class($this);

if ($klass === __CLASS__) {
            return '';
        }

return strtolower(substr($klass, strrpos($klass, '\\') + 1, -17));
    }

private function getRegionFromArgs(array $args)
    {
        $region = isset($args['@region'])
            ? $args['@region']
            : $this->getRegion();
        unset($args['@region']);

return [$region, $args];
    }
}

Cancel / Back

[ MAINHACK ]

Viewing / Editing File: MultiRegionClient.php

Server Info

System Features

User Info