README

Symfony扩展包，允许您轻松地从不同类型的对象中创建JSON/XML API响应。

入门指南

Composer

通过Composer安装ResponseBuilderBundle是最佳方式。

将itr/responsebuilder-bundle添加到项目的composer.json文件中作为依赖项

{
    "require": {
        "itr/responsebuilder-bundle": "dev-master"
    }
}

安装依赖项

$ php composer.phar update itr/responsebuilder-bundle

启用扩展包

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Itr\ResponseBuilderBundle\ItrResponseBuilderBundle(),
    );
}

配置

您可以在config.yml文件中指定默认构建器格式

itr_response_builder:
    default_format: json
    # default_format: json

基本用法

ResponseBuilder

您可以直接获取ResponseBuilderFactory类

<?php
    // creates factory object
    $responseBuilderFactory = new ResponseBuilderFactory('json');
    // gets default builder (here default format is json)
    $responseBuilder = $responseBuilderFactory->getDefault();
    // gets builder by specified format
    $responseBuilder = $responseBuilder->getBuilderForFormat('yml');

或从服务容器中获取，例如从symfony控制器中获取

<?php
    $responseBuilderFactory = $this->get('response_builder_factory');
    // gets default builder (default format could be specified in the configurations file like described above)
    $responseBuilder = $responseBuilderFactory->getDefault();

参数包

简单示例

<?php
    $pb = new ParameterBag();
    $pb->{'level.second.third'} = 'hi';
    $array = $pb->toArray();
    // array('level' => array('second' => array('third' => 'hi'));

    $responseBuilderFactory = $this->get('response_builder_factory');
    $responseBuilder = $responseBuilderFactory->getDefault();
    // return Response object with parameter bag processed into specified format (json or xml)
    $response = $responseBuilder->build($pb);

简单的Doctrine实体示例

假设我们有一个这样的账户实体

<?php
    class Account
    {
        private $id;

        private $username;

        private $email;

        // getters and setters below
        ...
    }

现在您可以这样处理它

<?php
    $account = new Account();
    $account->setUsername('noname');
    $account->setEmail('test@example.com');
    $account->setPassword('123456');

    $pb = new ParameterBag();
    $pb->{'account'} = $account;
    $array = $pb->toArray();

    /*
        Account entity processed as array:

        array('account' => array(
                'username' => 'noname',
                'email' => 'test@example.com',
                'password' => '123456',
        );
    */

    // then you can change any value by accessing it directly by its path:
    $pb->{'account.username'} = 'some new username';

    $responseBuilderFactory = $this->get('response_builder_factory');
    $responseBuilder = $responseBuilderFactory->getDefault();
    $response = $responseBuilder->build($pb);

复杂的Doctrine实体示例

假设账户还引用了一个profile对象

<?php
    class Account
    {
        private $id;

        private $username;

        private $email;

        // Profile
        private $profile;

        // getters and setters below
        ...
    }

Profile实体

<?php
    class Profile
    {
        private $id;

        private $fullname;

        private $age;

        // getters and setters below
        ...
    }

处理包含子实体的实体

<?php
    $profile = new Profile();
    $profile->setFullname('Jack Jonson');
    $profile->setAge(37);

    $account = new Account();
    $account->setUsername('noname');
    $account->setEmail('test@example.com');
    $account->setPassword('123456');
    $account->setProfile($profile);

    $pb = new ParameterBag();
    $pb->{'account'} = $account;
    $array = $pb->toArray();

    /*
        Entity with sub entity will be processed like this:

        array('account' => array(
                'username' => 'noname',
                'email' => 'test@example.com',
                'password' => '123456',
                'profile' => array(
                    'fullname' => 'Jack Jonson',
                    'age' => 37,
                )
        );
    */

待办事项

参数包代码重构。

itr / responsebuilder-bundle

维护者

详细信息