org.apache.qpid.jms.provider.amqp.builders

Class AmqpProducerBuilder

java.lang.Object

org.apache.qpid.jms.provider.amqp.builders.AmqpResourceBuilder<AmqpProducer,AmqpSession,JmsProducerInfo,org.apache.qpid.proton.engine.Sender>

org.apache.qpid.jms.provider.amqp.builders.AmqpProducerBuilder

All Implemented Interfaces:

AmqpEventSink, AmqpExceptionBuilder

public class AmqpProducerBuilder
extends AmqpResourceBuilder<AmqpProducer,AmqpSession,JmsProducerInfo,org.apache.qpid.proton.engine.Sender>

Resource builder responsible for creating and opening an AmqpProducer instance.

Field Summary

Fields inherited from class org.apache.qpid.jms.provider.amqp.builders.AmqpResourceBuilder

endpoint, parent, request, requestTimeoutTask, resource, resourceInfo

Constructor Summary

Constructors

Constructor and Description
AmqpProducerBuilder(AmqpSession parent, JmsProducerInfo resourceInfo)

Method Summary

Modifier and Type	Method and Description
protected void	afterOpened() Called once an endpoint has been opened and validated to give the subclasses a place to perform any follow-on processing or setup steps before the operation is deemed to have been completed and success is signaled.
void	buildResource(AsyncResult request) Called to initiate the process of building the resource type that is managed by this builder.
protected org.apache.qpid.proton.engine.Sender	createEndpoint(JmsProducerInfo resourceInfo) Given the resource information provided create and configure the local endpoint whose open phase is managed by this builder.
protected AmqpProducer	createResource(AmqpSession parent, JmsProducerInfo resourceInfo, org.apache.qpid.proton.engine.Sender endpoint) Create the managed resource instance.
protected ProviderException	getDefaultOpenAbortException() When aborting the open operation, and there isn't an error condition, provided by the peer, the returned exception will be used instead.
protected boolean	isClosePending() If the resource was opened but its current state indicates a close is pending then we do no need to proceed further into the resource creation process.

Methods inherited from class org.apache.qpid.jms.provider.amqp.builders.AmqpResourceBuilder

afterClosed, createException, getEndpoint, getOpenAbortExceptionFromRemote, getParent, getRequest, getRequestTimeout, getResource, getResourceInfo, handleClosed, handleOpened, hasRemoteError, isOpenedEndpointValid, processDeliveryUpdates, processFlowUpdates, processRemoteClose, processRemoteDetach, processRemoteOpen

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AmqpProducerBuilder

public AmqpProducerBuilder(AmqpSession parent,
                           JmsProducerInfo resourceInfo)

Method Detail

buildResource

public void buildResource(AsyncResult request)

Description copied from class: AmqpResourceBuilder

Called to initiate the process of building the resource type that is managed by this builder. The resource is created and the open process occurs asynchronously. If the resource is successfully opened it will added to its parent resource for use.

Overrides:

buildResource in class AmqpResourceBuilder<AmqpProducer,AmqpSession,JmsProducerInfo,org.apache.qpid.proton.engine.Sender>

Parameters:

request - The request that initiated the resource creation.

createEndpoint

protected org.apache.qpid.proton.engine.Sender createEndpoint(JmsProducerInfo resourceInfo)

Description copied from class: AmqpResourceBuilder

Given the resource information provided create and configure the local endpoint whose open phase is managed by this builder.

Specified by:

createEndpoint in class AmqpResourceBuilder<AmqpProducer,AmqpSession,JmsProducerInfo,org.apache.qpid.proton.engine.Sender>

Returns:

a new endpoint to be managed.

createResource

protected AmqpProducer createResource(AmqpSession parent,
                                      JmsProducerInfo resourceInfo,
                                      org.apache.qpid.proton.engine.Sender endpoint)

Description copied from class: AmqpResourceBuilder

Create the managed resource instance.

Specified by:

createResource in class AmqpResourceBuilder<AmqpProducer,AmqpSession,JmsProducerInfo,org.apache.qpid.proton.engine.Sender>

Parameters:

parent - The parent of the newly created resource.

resourceInfo - The resource information used to configure the resource.

endpoint - The local endpoint for the managed resource to wrap.

Returns:

the resource instance who open life-cycle is managed by this builder.

afterOpened

protected void afterOpened()

Description copied from class: AmqpResourceBuilder

Called once an endpoint has been opened and validated to give the subclasses a place to perform any follow-on processing or setup steps before the operation is deemed to have been completed and success is signaled.

Overrides:

afterOpened in class AmqpResourceBuilder<AmqpProducer,AmqpSession,JmsProducerInfo,org.apache.qpid.proton.engine.Sender>

isClosePending

protected boolean isClosePending()

Description copied from class: AmqpResourceBuilder

If the resource was opened but its current state indicates a close is pending then we do no need to proceed further into the resource creation process. Each endpoint build must implement this and examine the opened endpoint to determine if a close frame will follow the open.

Specified by:

isClosePending in class AmqpResourceBuilder<AmqpProducer,AmqpSession,JmsProducerInfo,org.apache.qpid.proton.engine.Sender>

Returns:

true if the resource state indicates it will be immediately closed.

getDefaultOpenAbortException

protected ProviderException getDefaultOpenAbortException()

Description copied from class: AmqpResourceBuilder

When aborting the open operation, and there isn't an error condition, provided by the peer, the returned exception will be used instead. A subclass may override this method to provide alternative behavior.

Overrides:

getDefaultOpenAbortException in class AmqpResourceBuilder<AmqpProducer,AmqpSession,JmsProducerInfo,org.apache.qpid.proton.engine.Sender>

Returns:

an Exception to describes the open failure for this resource.