Apache Qpid - AMQP Messaging for Java JMS, C++, Python, Ruby, and .NET | Apache Qpid Documentation |
00001 #ifndef QPID_MESSAGING_RECEIVER_H 00002 #define QPID_MESSAGING_RECEIVER_H 00003 00004 /* 00005 * 00006 * Licensed to the Apache Software Foundation (ASF) under one 00007 * or more contributor license agreements. See the NOTICE file 00008 * distributed with this work for additional information 00009 * regarding copyright ownership. The ASF licenses this file 00010 * to you under the Apache License, Version 2.0 (the 00011 * "License"); you may not use this file except in compliance 00012 * with the License. You may obtain a copy of the License at 00013 * 00014 * http://www.apache.org/licenses/LICENSE-2.0 00015 * 00016 * Unless required by applicable law or agreed to in writing, 00017 * software distributed under the License is distributed on an 00018 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 00019 * KIND, either express or implied. See the License for the 00020 * specific language governing permissions and limitations 00021 * under the License. 00022 * 00023 */ 00024 #include "qpid/Exception.h" 00025 #include "qpid/client/ClientImportExport.h" 00026 #include "qpid/client/Handle.h" 00027 #include "qpid/sys/Time.h" 00028 00029 namespace qpid { 00030 namespace client { 00031 00032 template <class> class PrivateImplRef; 00033 00034 } 00035 00036 namespace messaging { 00037 00038 class Message; 00039 class MessageListener; 00040 class ReceiverImpl; 00041 00045 class Receiver : public qpid::client::Handle<ReceiverImpl> 00046 { 00047 public: 00048 struct NoMessageAvailable : qpid::Exception {}; 00049 00050 QPID_CLIENT_EXTERN Receiver(ReceiverImpl* impl = 0); 00051 QPID_CLIENT_EXTERN Receiver(const Receiver&); 00052 QPID_CLIENT_EXTERN ~Receiver(); 00053 QPID_CLIENT_EXTERN Receiver& operator=(const Receiver&); 00060 QPID_CLIENT_EXTERN bool get(Message& message, qpid::sys::Duration timeout=qpid::sys::TIME_INFINITE); 00067 QPID_CLIENT_EXTERN Message get(qpid::sys::Duration timeout=qpid::sys::TIME_INFINITE); 00075 QPID_CLIENT_EXTERN bool fetch(Message& message, qpid::sys::Duration timeout=qpid::sys::TIME_INFINITE); 00083 QPID_CLIENT_EXTERN Message fetch(qpid::sys::Duration timeout=qpid::sys::TIME_INFINITE); 00084 00088 QPID_CLIENT_EXTERN void start(); 00093 QPID_CLIENT_EXTERN void stop(); 00099 QPID_CLIENT_EXTERN void setCapacity(uint32_t); 00106 QPID_CLIENT_EXTERN uint32_t getCapacity(); 00111 QPID_CLIENT_EXTERN uint32_t available(); 00118 QPID_CLIENT_EXTERN uint32_t pendingAck(); 00119 00123 QPID_CLIENT_EXTERN void cancel(); 00124 00130 QPID_CLIENT_EXTERN void setListener(MessageListener* listener); 00131 private: 00132 friend class qpid::client::PrivateImplRef<Receiver>; 00133 }; 00134 }} // namespace qpid::messaging 00135 00136 #endif