Queue/Adapter/AdapterInterface.php
Zend Framework
LICENSE
This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to [email protected] so we can send you a copy immediately.
- Category
- Zend
- Copyright
- Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
- Package
- Zend_Queue
- Subpackage
- Adapter
- Version
- $Id: AdapterInterface.php 24593 2012-01-05 20:35:02Z matthew $
\Zend_Queue_Adapter_AdapterInterface
Interface for common queue operations
- Category
- Zend
- Copyright
- Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
Methods


__construct(array | \Zend_Config $options, \Zend_Queue $queue = null) : void
Constructor
Name | Type | Description |
---|---|---|
$options | array | \Zend_Config | |
$queue | \Zend_Queue |


count(\Zend_Queue | null $queue = null) : integer
Return the approximate number of messages in the queue
Name | Type | Description |
---|---|---|
$queue | \Zend_Queue | null |
Type | Description |
---|---|
integer |


create(string $name, integer $timeout = null) : boolean
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.
Name | Type | Description |
---|---|---|
$name | string | Queue name |
$timeout | integer | Default visibility timeout |
Type | Description |
---|---|
boolean |


delete(string $name) : boolean
Delete a queue and all of its messages
Return false if the queue is not found, true if the queue exists.
Name | Type | Description |
---|---|---|
$name | string | Queue name |
Type | Description |
---|---|
boolean |


deleteMessage(\Zend_Queue_Message $message) : boolean
Delete a message from the queue
Return true if the message is deleted, false if the deletion is unsuccessful.
Name | Type | Description |
---|---|---|
$message | \Zend_Queue_Message |
Type | Description |
---|---|
boolean |


getCapabilities() : array
Return a list of queue capabilities functions
$array['function name'] = true or false true is supported, false is not supported.
Type | Description |
---|---|
array |


getOptions() : array
Returns the configuration options in this adapter.
Type | Description |
---|---|
array |


getQueues() : array
Get an array of all available queues
Not all adapters support getQueues(); use isSupported('getQueues') to determine if the adapter supports this feature.
Type | Description |
---|---|
array |


isExists(string $name) : boolean
Does a queue already exist?
Use isSupported('isExists') to determine if an adapter can test for queue existance.
Name | Type | Description |
---|---|---|
$name | string | Queue name |
Type | Description |
---|---|
boolean |


isSupported(string $name) : boolean
Indicates if a function is supported or not.
Name | Type | Description |
---|---|---|
$name | string | Function name |
Type | Description |
---|---|
boolean |


receive(integer | null $maxMessages = null, integer | null $timeout = null, \Zend_Queue | null $queue = null) : \Zend_Queue_Message_Iterator
Get messages in the queue
Name | Type | Description |
---|---|---|
$maxMessages | integer | null | Maximum number of messages to return |
$timeout | integer | null | Visibility timeout for these messages |
$queue | \Zend_Queue | null |
Type | Description |
---|---|
\Zend_Queue_Message_Iterator |


send(mixed $message, \Zend_Queue | null $queue = null) : \Zend_Queue_Message
Send a message to the queue
Name | Type | Description |
---|---|---|
$message | mixed | Message to send to the active queue |
$queue | \Zend_Queue | null |
Type | Description |
---|---|
\Zend_Queue_Message |


setQueue(\Zend_Queue $queue) : \Zend_Queue_Adapter_AdapterInterface
Set queue instnace
Name | Type | Description |
---|---|---|
$queue | \Zend_Queue |
Type | Description |
---|---|
\Zend_Queue_Adapter_AdapterInterface |