cpp/lib/broker/Connection.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.
 *
 */
#ifndef _Connection_
#define _Connection_

#include <sstream>
#include <vector>

#include <boost/ptr_container/ptr_map.hpp>

#include <AMQFrame.h>
#include <AMQP_ServerOperations.h>
#include <AMQP_ClientProxy.h>
#include <sys/ConnectionOutputHandler.h>
#include <sys/ConnectionInputHandler.h>
#include <sys/TimeoutHandler.h>
#include "framing/ProtocolVersion.h"
#include "Broker.h"
#include "Exception.h"
#include "BrokerChannel.h"

namespace qpid {
namespace broker {

class Channel;

class Connection : public sys::ConnectionInputHandler, 
                   public ConnectionToken
{
  public:
    Connection(sys::ConnectionOutputHandler* out, Broker& broker);

    /** Get a channel. Create if it does not already exist */
    Channel& getChannel(framing::ChannelId channel);

    /** Close a channel */
    void closeChannel(framing::ChannelId channel);

    /** Close the connection */
    void close(framing::ReplyCode code, const string& text, framing::ClassId classId, framing::MethodId methodId);

    sys::ConnectionOutputHandler& getOutput() const { return *out; }
    framing::ProtocolVersion getVersion() const { return version; }

    uint32_t getFrameMax() const { return framemax; }
    uint16_t getHeartbeat() const { return heartbeat; }
    uint32_t getTimeout() const { return timeout; }
    uint64_t getStagingThreshold() const { return stagingThreshold; }

    void setFrameMax(uint32_t fm) { framemax = fm; }
    void setHeartbeat(uint16_t hb) { heartbeat = hb; }
    
    /**
     * Get named queue, never returns 0.
     * @return: named queue or default queue for channel if name=""
     * @exception: ChannelException if no queue of that name is found.
     * @exception: ConnectionException if name="" and channel has no default.
     */
    Queue::shared_ptr getQueue(const string& name, uint16_t channel);

    Broker& broker;
    std::vector<Queue::shared_ptr> exclusiveQueues;

    // ConnectionInputHandler methods
    void received(framing::AMQFrame* frame);
    void initiated(framing::ProtocolInitiation* header);
    void idleOut();
    void idleIn();
    void closed();

  private:
    typedef boost::ptr_map<framing::ChannelId, Channel> ChannelMap;

    typedef std::vector<Queue::shared_ptr>::iterator queue_iterator;
    Exchange::shared_ptr findExchange(const string& name);

    framing::ProtocolVersion version;
    ChannelMap channels;
    sys::ConnectionOutputHandler* out;
    uint32_t framemax;
    uint16_t heartbeat;
    framing::AMQP_ClientProxy::Connection* client;
    const uint32_t timeout; //timeout for auto-deleted queues (in ms)
    const uint64_t stagingThreshold;

};

}}

#endif