2006-12-01 Jim Meyering <meyering@redhat.com>

This delta imposes two major changes on the C++ hierarchy:
  - adds autoconf, automake, libtool support
  - makes the hierarchy flatter and renames a few files (e.g., Queue.h,
  Queue.cpp) that appeared twice, once under client/ and again under broker/.

In the process, I've changed many #include directives, mostly
to remove a qpid/ or qpid/framing/ prefix from the file name argument.
Although most changes were to .cpp and .h files under qpid/cpp/, there
were also several to template files under qpid/gentools, and even one
to CppGenerator.java.

Nearly all files are moved to a new position in the hierarchy.
The new hierarchy looks like this:

  src               # this is the new home of qpidd.cpp
  tests             # all tests are here.  See Makefile.am.
  gen               # As before, all generated files go here.
  lib               # This is just a container for the 3 lib dirs:
  lib/client
  lib/broker
  lib/common
  lib/common/framing
  lib/common/sys
  lib/common/sys/posix
  lib/common/sys/apr
  build-aux
  m4


git-svn-id: https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid@481159 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 135 insertions, 0 deletions

diff --git a/cpp/lib/broker/BrokerQueue.h b/cpp/lib/broker/BrokerQueue.h
new file mode 100644
index 0000000000..13f4bf2de0
--- /dev/null
+++ b/cpp/lib/broker/BrokerQueue.h
@@ -0,0 +1,135 @@
+/*
+ *
+ * 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 _Queue_
+#define _Queue_
+
+#include <vector>
+#include <queue>
+#include <boost/shared_ptr.hpp>
+#include <amqp_types.h>
+#include <Binding.h>
+#include <ConnectionToken.h>
+#include <Consumer.h>
+#include <BrokerMessage.h>
+#include <sys/Monitor.h>
+
+namespace qpid {
+    namespace broker {
+        class MessageStore;
+
+        /**
+         * Thrown when exclusive access would be violated.
+         */
+        struct ExclusiveAccessException{};
+
+        using std::string;
+        /**
+         * The brokers representation of an amqp queue. Messages are
+         * delivered to a queue from where they can be dispatched to
+         * registered consumers or be stored until dequeued or until one
+         * or more consumers registers.
+         */
+        class Queue{
+            const string name;
+            const u_int32_t autodelete;
+            MessageStore* const store;
+            const ConnectionToken* const owner;
+            std::vector<Consumer*> consumers;
+            std::queue<Binding*> bindings;
+            std::queue<Message::shared_ptr> messages;
+            bool queueing;
+            bool dispatching;
+            int next;
+            mutable qpid::sys::Mutex lock;
+            int64_t lastUsed;
+            Consumer* exclusive;
+            mutable u_int64_t persistenceId;
+
+            bool startDispatching();
+            bool dispatch(Message::shared_ptr& msg);
+
+        public:
+            
+            typedef boost::shared_ptr<Queue> shared_ptr;
+
+            typedef std::vector<shared_ptr> vector;
+	    
+            Queue(const string& name, u_int32_t autodelete = 0, 
+                  MessageStore* const store = 0, 
+                  const ConnectionToken* const owner = 0);
+            ~Queue();
+
+            void create();
+            void destroy();
+            /**
+             * Informs the queue of a binding that should be cancelled on
+             * destruction of the queue.
+             */
+            void bound(Binding* b);
+            /**
+             * Delivers a message to the queue. Will record it as
+             * enqueued if persistent then process it.
+             */
+            void deliver(Message::shared_ptr& msg);
+            /**
+             * Dispatches the messages immediately to a consumer if
+             * one is available or stores it for later if not.
+             */
+            void process(Message::shared_ptr& msg);
+            /**
+             * Used during recovery to add stored messages back to the queue
+             */
+            void recover(Message::shared_ptr& msg);
+            /**
+             * Dispatch any queued messages providing there are
+             * consumers for them. Only one thread can be dispatching
+             * at any time, but this method (rather than the caller)
+             * is responsible for ensuring that.
+             */
+            void dispatch();
+            void consume(Consumer* c, bool exclusive = false);
+            void cancel(Consumer* c);
+            u_int32_t purge();
+            u_int32_t getMessageCount() const;
+            u_int32_t getConsumerCount() const;
+            inline const string& getName() const { return name; }
+            inline const bool isExclusiveOwner(const ConnectionToken* const o) const { return o == owner; }
+            inline bool hasExclusiveConsumer() const { return exclusive; }
+            inline u_int64_t getPersistenceId() const { return persistenceId; }
+            inline void setPersistenceId(u_int64_t _persistenceId) const { persistenceId = _persistenceId; }
+
+            bool canAutoDelete() const;
+
+            void enqueue(TransactionContext* ctxt, Message::shared_ptr& msg, const string * const xid);
+            /**
+             * dequeue from store (only done once messages is acknowledged)
+             */
+            void dequeue(TransactionContext* ctxt, Message::shared_ptr& msg, const string * const xid);
+            /**
+             * dequeues from memory only
+             */
+            Message::shared_ptr dequeue();
+        };
+    }
+}
+
+
+#endif