Apache Qpid - AMQP Messaging for Java JMS, C++, Python, Ruby, and .NET | Apache Qpid Documentation |
00001 #ifndef QPID_CLIENT_FAILOVERMANAGER_H 00002 #define QPID_CLIENT_FAILOVERMANAGER_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 00025 #include "qpid/Exception.h" 00026 #include "qpid/client/AsyncSession.h" 00027 #include "qpid/client/ClientImportExport.h" 00028 #include "qpid/client/Connection.h" 00029 #include "qpid/client/ConnectionSettings.h" 00030 #include "qpid/client/FailoverListener.h" 00031 #include "qpid/sys/Monitor.h" 00032 #include <vector> 00033 00034 namespace qpid { 00035 namespace client { 00036 00037 struct CannotConnectException : qpid::Exception 00038 { 00039 CannotConnectException(const std::string& m) : qpid::Exception(m) {} 00040 }; 00041 00045 class FailoverManager 00046 { 00047 public: 00052 struct Command 00053 { 00064 virtual void execute(AsyncSession& session, bool isRetry) = 0; 00065 virtual ~Command() {} 00066 }; 00067 00068 struct ReconnectionStrategy 00069 { 00077 virtual void editUrlList(std::vector<Url>& urls) = 0; 00078 virtual ~ReconnectionStrategy() {} 00079 }; 00080 00089 QPID_CLIENT_EXTERN FailoverManager(const ConnectionSettings& settings, ReconnectionStrategy* strategy = 0); 00100 QPID_CLIENT_EXTERN Connection& connect(std::vector<Url> brokers = std::vector<Url>()); 00104 QPID_CLIENT_EXTERN Connection& getConnection(); 00108 QPID_CLIENT_EXTERN void close(); 00121 QPID_CLIENT_EXTERN void execute(Command&); 00122 private: 00123 enum State {IDLE, CONNECTING, CANT_CONNECT}; 00124 00125 qpid::sys::Monitor lock; 00126 Connection connection; 00127 std::auto_ptr<FailoverListener> failoverListener; 00128 ConnectionSettings settings; 00129 ReconnectionStrategy* strategy; 00130 State state; 00131 00132 void attempt(Connection&, ConnectionSettings settings, std::vector<Url> urls); 00133 void attempt(Connection&, ConnectionSettings settings); 00134 }; 00135 }} // namespace qpid::client 00136 00137 #endif