com.rabbitmq.client.GetResponse Maven / Gradle / Ivy
// The contents of this file are subject to the Mozilla Public License
// Version 1.1 (the "License"); you may not use this file except in
// compliance with the License. You may obtain a copy of the License
// at http://www.mozilla.org/MPL/
//
// Software distributed under the License is distributed on an "AS IS"
// basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
// the License for the specific language governing rights and
// limitations under the License.
//
// The Original Code is RabbitMQ.
//
// The Initial Developer of the Original Code is GoPivotal, Inc.
// Copyright (c) 2007-2014 GoPivotal, Inc. All rights reserved.
//
package com.rabbitmq.client;
import com.rabbitmq.client.AMQP.BasicProperties;
/**
* Encapsulates the response from a {@link Channel#basicGet} message-retrieval method call
* - essentially a static bean "holder" with message response data.
*/
public class GetResponse {
private final Envelope envelope;
private final BasicProperties props;
private final byte[] body;
private final int messageCount;
/**
* Construct a {@link GetResponse} with the specified construction parameters
* @param envelope the {@link Envelope}
* @param props message properties
* @param body the message body
* @param messageCount the server's most recent estimate of the number of messages remaining on the queue
*/
public GetResponse(Envelope envelope, BasicProperties props, byte[] body, int messageCount)
{
this.envelope = envelope;
this.props = props;
this.body = body;
this.messageCount = messageCount;
}
/**
* Get the {@link Envelope} included in this response
* @return the envelope
*/
public Envelope getEnvelope() {
return envelope;
}
/**
* Get the {@link BasicProperties} included in this response
* @return the properties
*/
public BasicProperties getProps() {
return props;
}
/**
* Get the message body included in this response
* @return the message body
*/
public byte[] getBody() {
return body;
}
/**
* Get the server's most recent estimate of the number of messages
* remaining on the queue. This number can only ever be a rough
* estimate, because of concurrent activity at the server and the
* delay between the server sending its estimate and the client
* receiving and processing the message containing the estimate.
*
* According to the AMQP specification, this figure does not
* include the message being delivered. For example, this field
* will be zero in the simplest case of a single reader issuing a
* Basic.Get on a private queue holding a single message (the
* message being delivered in this GetResponse).
*
* @return an estimate of the number of messages remaining to be
* read from the queue
*/
public int getMessageCount() {
return messageCount;
}
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append("GetResponse(envelope=").append(envelope);
sb.append(", props=").append(props);
sb.append(", messageCount=").append(messageCount);
sb.append(", body=(elided, ").append(body.length).append(" bytes long)");
sb.append(")");
return sb.toString();
}
}