Autumn Framework

Autumn Framework is a micro service framework based on PECL/Swoole.

Autumn Framework是基于PECL/Swoole的微服务框架。

Getting Started

1.Import:

1.导入：

composer require autumn/autumn-framework

2.Add your own namespace to composer.json (eg: Market):

2.在composer.json中加入自定义的项目名称空间（如：Market）：

// ...
    "autoload": {
        "psr-4": {
            "Market\\": "src"
        }
    }
// ...

3.Create index.php:

3.编写index.php：

<?php

require __DIR__ . '/vendor/autoload.php';

exit(Autumn\Framework\Boot\AutumnApplication::run($argc, $argv));

4.Create model class (Plain Ordinary PHP Object, POPO):

4.创建模型类（简单的常规PHP类）：

namespace Market;

class Car
{
    public $id;
}

Notice: we use mintware-de/json-object-mapper as default JSON object mapper since 0.1.0, and json_encode() as fallback mapper.

注意：自0.1.0开始，我们使用mintware-de/json-object-mapper作为默认的JSON对象序列化及反序列化工具。无法使用该代码包时（例如版权问题），框架使用json_encode()函数作为备选。

5.Create controller class (POPO):

5.创建控制器类（POPO）：

namespace Market;

use \Autumn\Framework\Annotation\RestController;
use \Autumn\Framework\Annotation\RequestMapping;

/**
 * @RestController
 */
class CarController
{
    /**
     * @RequestMapping(value="/cars", method="GET")
     */
    public function list()
    {
        $cars = [];
        for ($i=1; $i<=10; ++$i) {
            $car = new Car();
            $car->id = $i;
            $cars[] = $car;
        }

        return $cars;
    }
}

Respond 10 cars when requesting "GET /cars".

接收"GET /cars"并响应10辆车的信息。

6.Launch service:

6.启动微服务：

php index.php

7.Enjoy:

curl -i http://localhost:3028/cars

Define a bean and inject it into a property (since 0.1.0)

1.Create configuration class and define beans:

1.创建Configuration类，定义Bean：

use \Autumn\Framework\Context\Annotation\Configuration;
use \Autumn\Framework\Context\Annotation\Bean;

/**
 * Main Configuration
 * 
 * @Configuration
 */
class DaTrieConfiguration
{
    /** @Bean */
    public function daTrieService()
    {
        // Implementation of interface DaTrieServer
        return new DaTrieServiceImpl();
    }
}

2.Inject the bean to a property:

2.注入到类属性上：

use \Autumn\Framework\Annotation\RestController;
use \Autumn\Framework\Annotation\RequestMapping;
use \Autumn\Framework\Context\Annotation\Autowired;

/**
 * @RestController
 */
class SearchInController
{
    /** @Autowired(value=DaTrieService::class) */
    private $daTrieService;
}

Use @Autowired annotation on methods (since 0.2.0):

use \Autumn\Framework\Annotation\RestController;
use \Autumn\Framework\Annotation\RequestMapping;
use \Autumn\Framework\Context\Annotation\Autowired;

/**
 * @RestController
 */
class SearchInController
{
    private $daTrieService;
    
    /**
     * @Autowired
     */
    public function setDaTrieService(DaTrieService $daTrieService)
    {
        $this->daTrieService = $daTrieService;
    }
}

Retrieve request body (since 0.2.0)

Add @RequestBody annotation to action method:

在动作方法上为某个参数定义@RequestBody注解：

namespace Market;

use \Autumn\Framework\Annotation\RestController;
use \Autumn\Framework\Annotation\RequestMapping;
use \Autumn\Framework\Web\Bind\Annotation\RequestBody;

/**
 * @RestController
 */
class CarController
{
    /**
     * @RequestMapping(value="/comments", method="POST")
     * @RequestBody(value="carId")
     */
    public function create(string $carId)
    {
        // ...
    }
}

Notice: string is the only supported type by @RequestBody annotation.

注意：目前仅支持string类型的变量。

Do something after all beans are loaded (since 0.2.0):

Create derivative of interface ContextRefreshedEventApplicationListener:

创建接口ContextRefreshedEventApplicationListener的派生类：

namespace Market;

use \Autumn\Framework\Context\Listener\ContextRefreshedEventApplicationListener;
use \Autumn\Framework\Context\Event\ContextRefreshedEvent;

class LoadCommentsApplicationListener implements ContextRefreshedEventApplicationListener
{
    public function onApplicationEvent(ContextRefreshedEvent $event)
    {
        // Load comments
    }
}

Connect to MySQL server in coroutine (since 0.2.0):

1.Define bean of MySqlOperations:

1.定义MySqlOperations接口的Bean：

use \Autumn\Framework\Context\Annotation\Configuration;
use \Autumn\Framework\Context\Annotation\Bean;
use \Autumn\Framework\Swoole\Coroutine\MySql\MySqlTemplate;

/**
 * Main Configuration
 * 
 * @Configuration
 */
class MainConfiguration
{
    /** @Bean */
    public function mySqlOperations()
    {
        return new MySqlTemplate([
            'host' => 'localhost',
            'port' => 3306,
            'user' => 'root',
            'password' => '',
            'database' => 'test',
        ]);
    }
}

2.Inject to a class and use it:

2.注入类并使用：

namespace Market;

use \Autumn\Framework\Swoole\Coroutine\MySql\MySqlOperations;

class CarService
{
    /** @Autowired(value=MySqlOperations::class) */
    private $mySqlOperations;
    
    const LIST_ALL_SQL = "SELECT * FROM `cars` WHERE `id`>?";
    
    public function listCars()
    {
        $generator = $this->mySqlOperations->queryAll(self::LIST_ALL_SQL, function($row) {
            $car = new Car();
            $car->id = $row['id'];
            return $car;
        }, 'id');
        
        $cars = [];
        foreach ($generator as $car) {
            // ...
            $cars[] = $car;
        }      
        
        return $cars;
    }
}

Notice: We strongly suggest to use this feature in actions of controllers.

注意：这项特性目前仅建议使用在控制器的动作方法中。

Additional changes

0.2.0

• Interface FactoryBean.
• Access log.
• Add placeholder {xxx} support to log messages.
• 日志中支持{xxx}占位符；
• Show trace info when exceptions were caught.
• 捕捉到异常时展示堆栈调用；
• DbalTemplate (require package Doctrine/DBAL).

Extra Dependencies

• PECL/Swoole

See

• Autumn Example
• Double-Array Trie Server
• Spring
• Spring in Action