cpp/src/qpid/ha/HaBroker.h

#ifndef QPID_HA_BROKER_H
#define QPID_HA_BROKER_H

/*
 *
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 *
 */

#include "BrokerInfo.h"
#include "Membership.h"
#include "types.h"
#include "Settings.h"
#include "qpid/Url.h"
#include "qpid/sys/Mutex.h"
#include "qmf/org/apache/qpid/ha/HaBroker.h"
#include "qpid/management/Manageable.h"
#include "qpid/types/Variant.h"
#include <set>
#include <boost/shared_ptr.hpp>

namespace qpid {

namespace types {
class Variant;
}

namespace broker {
class Broker;
class Queue;
}
namespace framing {
class FieldTable;
}

namespace ha {
class Backup;
class ConnectionObserver;
class Primary;
class Role;
/**
 * HA state and actions associated with a HA broker. Holds all the management info.
 *
 * THREAD SAFE: may be called in arbitrary broker IO or timer threads.

 * NOTE: HaBroker and Role subclasses follow this lock hierarchy:
 * - HaBroker MUST NOT hold its own lock across calls Role subclasses.
 * - Role subclasses MAY hold their locks accross calls to HaBroker.
 */
class HaBroker : public management::Manageable
{
  public:
    /** HaBroker is constructed during earlyInitialize */
    HaBroker(broker::Broker&, const Settings&);
    ~HaBroker();

    /** Called during plugin initialization */
    void initialize();

    // Implement Manageable.
    qpid::management::ManagementObject::shared_ptr GetManagementObject() const { return mgmtObject; }
    management::Manageable::status_t ManagementMethod (
        uint32_t methodId, management::Args& args, std::string& text);

    broker::Broker& getBroker() { return broker; }
    const Settings& getSettings() const { return settings; }

    /** Shut down the broker because of a critical error. */
    void shutdown(const std::string& message);

    BrokerStatus getStatus() const;
    boost::shared_ptr<ConnectionObserver> getObserver() { return observer; }

    BrokerInfo getBrokerInfo() const { return membership.getInfo(); }
    Membership& getMembership() { return membership; }
    types::Uuid getSystemId() const { return systemId; }

  private:

    void setPublicUrl(const Url&);
    void setBrokerUrl(const Url&);
    void updateClientUrl(sys::Mutex::ScopedLock&);

    std::vector<Url> getKnownBrokers() const;

    // Immutable members
    const types::Uuid systemId;
    const Settings settings;

    // Member variables protected by lock
    mutable sys::Mutex lock;
    Url publicUrl, brokerUrl;
    std::vector<Url> knownBrokers;

    // Independently thread-safe member variables
    broker::Broker& broker;
    qmf::org::apache::qpid::ha::HaBroker::shared_ptr mgmtObject;
    boost::shared_ptr<ConnectionObserver> observer; // Used by Backup and Primary
    boost::shared_ptr<Role> role;
    Membership membership;
};
}} // namespace qpid::ha

#endif  /*!QPID_HA_BROKER_H*/