<?php

namespace Thrift\Server;

use Thrift\Exception\TTransportException;
use Thrift\Transport\TTransport;

/**
 * Generic class for Server agent.
 *
 * @package thrift.transport
 */
abstract class TServerTransport
{
    /**
     * List for new clients
     *
     * @abstract
     * @return void
     */
    abstract public function listen();

    /**
     * Close the server
     *
     * @abstract
     * @return void
     */
    abstract public function close();

    /**
     * Subclasses should use this to implement
     * accept.
     *
     * @abstract
     * @return TTransport
     */
    abstract protected function acceptImpl();

    /**
     * Uses the accept implemtation. If null is returned, an
     * exception is thrown.
     *
     * @throws TTransportException
     * @return TTransport
     */
    public function accept()
    {
        $transport = $this->acceptImpl();

        if ($transport == null) {
            throw new TTransportException("accept() may not return NULL");
        }

        return $transport;
    }
}
