Введение

Внимание

Это расширение является ЭКСПЕРИМЕНТАЛЬНЫМ. Поведение этого расширения, включая имена его функций и любую другую относящуюся к нему документацию, может измениться в последующих версиях PHP без уведомления. Используйте это расширение на свой страх и риск.

SCA для PHP предназначено для облегчения создания переиспользуемых компонентов, обладающих унифицированным интерфейсом и различными моделями использования. В данный момент компоненты общаться либо локально, либо через веб-сервисы, но в будущем планируется расширить список способов доступа. В целом это расширение создавалось для облегчения жизни разработчика.

Компоненты SCA используют аннотации phpDocumentor (см. Http://www.phpdoc.org/) для инъекции зависимостей от других компонентов SCA или от веб-сервисов. Во время исполнения SCA самостоятельно разрешает эти зависимости, что позволяет разработчику сфокусироваться на бизнес-логике и не заниматься самостоятельным отслеживанием зависимостей.

В будущем SCA может быть дополнена поддержкой REST, Atompub и т.д. Но в настоящее время единственным поддерживаемым методом коммуникаций являются веб-сервисы (точнее, WSDL, SOAP / HTTP-сервисы).

Также компоненты используют аннотации для определения интерфейса предоставляемого ими сервиса. Во время исполнения из этих аннотаций SCA автоматически генерирует WSDL. Для разработчиков знакомых с phpDocumentor работа с аннотациями не доставит каких либо проблем. Развертывание веб-сервиса никогда небыло настолько простым - достаточно просто разместить компонент в корене документов веб-сервера.

Также компоненты используют аннотации для определения структур данных (определенных с помощью сложных типов схемы XML), обарбатываемых с использованием Сервисных Объектов Данных (Service Data Objects или SDO).

PHP-скрипт, который не является компонентом SCA и не содержит аннотаций, может использовать службы компонента SCA. PHP-скрипт или компонент могут выполнять вызовы сторонних веб-сервисов, использующих ту же систему но использует ту же систему вызовов или аннотаций для получения ссылки.

Для начала мы покажем простой компонент SCA с именем ConvertedStockQuote, который продемонстрирует различные возможности SCA. Он содержит один метод getQuote(), который будет по заданному названию искать котировки и конвертировать их в заданную валюту. Мы будем использовать этот пример в дальнейшем в описании функций для объяснения работы SCA.

Пример #1 Простой компонент SCA

<?php

include "SCA/SCA.php";

/**
 * Вычисляем стоимость указанных акций в заданной валюте.
 *
 * @service
 * @binding.soap
 */
class ConvertedStockQuote {

    
/**
     * Сервис получения курсов конвертации валют.
     *
     * @reference
     * @binding.php ../ExchangeRate/ExchangeRate.php
     */
    
public $exchange_rate;

    
/**
     * Сервис получения котировок.
     *
     * @reference
     * @binding.soap ../StockQuote/StockQuote.wsdl
     */
    
public $stock_quote;

    
/**
     * Получение стоимости акции в заданной валюте.
     *
     * @param string $ticker Название акции.
     * @param string $currency В какой валюте возвращать результат.
     * @return float Стоимость акции в заданной валюте.
     */
    
function getQuote($ticker$currency)
    {
        
$quote  $this->stock_quote->getQuote($ticker);
        
$rate   $this->exchange_rate->getRate($currency);
        return  
$rate $quote;
    }
}
?>

В этом примере показано, что компонент SCA реализован с помощью скрипта, в котором содержится описание класса и в который подключен скрипт SCA.php. Класс содержит смесь бизнес-логики и отсылок к другим компонентам и веб-сервисам. В методе getQuote() содержится только бизнес-логика, но она завязана на переменные класса $stock_quote и $exchange_rate. Тут наличествуют ссылки на два других компонента, которые будут проинициализированы SCA во время исполнения и проксированы на два конкретных сервиса, в независимости от того, где запускается этот компонент. Аннотации этих сервисов показывают, что один из них локальный - он будет запускаться в том же сеансе, что и наш PHP-скрипт, а второй удаленный и будет вызван с помощью SOAP-запроса. Также в этот компонент предастявляет метгод getQuote() в качестве сервиса, который может быть вызван как локально, так и удаленно.

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top