Файл: concrete5.7.5.6/concrete/vendor/zendframework/zend-queue/library/ZendQueue/Adapter.php
Строк: 178
<?php
/**
* Zend Framework (http://framework.zend.com/)
*
* @link http://github.com/zendframework/zf2 for the canonical source repository
* @copyright Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @package Zend_Queue
*/
namespace ZendQueue;
/**
* Interface for common queue operations
*
* @category Zend
* @package Zend_Queue
* @subpackage Adapter
*/
interface Adapter
{
/**
* Constructor
*
* @param array|Traversable $options
* @param ZendQueueQueue $queue
* @return void
*/
public function __construct($options, Queue $queue = null);
/**
* Retrieve queue instance
*
* @return ZendQueueQueue
*/
public function getQueue();
/**
* Set queue instnace
*
* @param ZendQueueQueue $queue
* @return ZendQueueAdapter
*/
public function setQueue(Queue $queue);
/**
* Does a queue already exist?
*
* Use isSupported('isExists') to determine if an adapter can test for
* queue existance.
*
* @param string $name Queue name
* @return boolean
*/
public function isExists($name);
/**
* Create a new queue
*
* Visibility timeout is how long a message is left in the queue
* "invisible" to other readers. If the message is acknowleged (deleted)
* before the timeout, then the message is deleted. However, if the
* timeout expires then the message will be made available to other queue
* readers.
*
* @param string $name Queue name
* @param integer $timeout Default visibility timeout
* @return boolean
*/
public function create($name, $timeout=null);
/**
* Delete a queue and all of its messages
*
* Return false if the queue is not found, true if the queue exists.
*
* @param string $name Queue name
* @return boolean
*/
public function delete($name);
/**
* Get an array of all available queues
*
* Not all adapters support getQueues(); use isSupported('getQueues')
* to determine if the adapter supports this feature.
*
* @return array
*/
public function getQueues();
/**
* Return the approximate number of messages in the queue
*
* @param ZendQueueQueue|null $queue
* @return integer
*/
public function count(Queue $queue = null);
/********************************************************************
* Messsage management functions
*********************************************************************/
/**
* Send a message to the queue
*
* @param mixed $message Message to send to the active queue
* @param ZendQueueQueue|null $queue
* @return ZendQueueMessage
*/
public function send($message, Queue $queue = null);
/**
* Get messages in the queue
*
* @param integer|null $maxMessages Maximum number of messages to return
* @param integer|null $timeout Visibility timeout for these messages
* @param ZendQueueQueue|null $queue
* @return ZendQueueMessageMessageIterator
*/
public function receive($maxMessages = null, $timeout = null, Queue $queue = null);
/**
* Delete a message from the queue
*
* Return true if the message is deleted, false if the deletion is
* unsuccessful.
*
* @param ZendQueueMessage $message
* @return boolean
*/
public function deleteMessage(Message $message);
/********************************************************************
* Supporting functions
*********************************************************************/
/**
* Returns the configuration options in this adapter.
*
* @return array
*/
public function getOptions();
/**
* Return a list of queue capabilities functions
*
* $array['function name'] = true or false
* true is supported, false is not supported.
*
* @return array
*/
public function getCapabilities();
/**
* Indicates if a function is supported or not.
*
* @param string $name Function name
* @return boolean
*/
public function isSupported($name);
}