Repo restructuring

1 files changed, 251 insertions, 0 deletions

diff --git a/TAO/tao/Invocation_Base.h b/TAO/tao/Invocation_Base.h
new file mode 100644
index 00000000000..328127e9dc0
--- /dev/null
+++ b/TAO/tao/Invocation_Base.h
@@ -0,0 +1,251 @@
+// -*- C++ -*-
+
+//=============================================================================
+/**
+ *  @file    Invocation_Base.h
+ *
+ *  $Id$
+ *
+ *
+ *  @author Balachandran Natarajan <bala@dre.vanderbilt.edu>
+ */
+//=============================================================================
+
+#ifndef TAO_INVOCATION_BASE_H
+#define TAO_INVOCATION_BASE_H
+
+#include /**/ "ace/pre.h"
+
+#include "tao/Object.h"
+
+#if !defined (ACE_LACKS_PRAGMA_ONCE)
+# pragma once
+#endif /* ACE_LACKS_PRAGMA_ONCE */
+
+#include "tao/Invocation_Utils.h"
+
+#if TAO_HAS_INTERCEPTORS == 1
+#include "tao/PI_ForwardC.h"
+#include "tao/ClientRequestInterceptor_Adapter.h"
+#endif  /* TAO_HAS_INTERCEPTORS == 1 */
+
+TAO_BEGIN_VERSIONED_NAMESPACE_DECL
+
+class TAO_Service_Context;
+class TAO_Operation_Details;
+class TAO_Stub;
+
+namespace TAO
+{
+  class Invocation_Adapter;
+
+  /**
+   * @class Invocation_Base
+   *
+   * @brief The base class for the invocation object
+   *
+   * This class is the base of the invocation object hiererachy. This
+   * hierarchy is classified  based on the type of invocation and the
+   * mode of invocation. One of the objects from the hierarchy is
+   * created on the stack for every invocation.
+   *
+   * In addition this class encapsulates the essential details that
+   * are required for PortableInterceptors to function
+   * correctly. Further this class also provides some helper and
+   * accessor methods that are used by clients.
+   *
+   */
+  class TAO_Export Invocation_Base
+  {
+  public:
+    virtual ~Invocation_Base (void);
+
+    /// Accessor and mutator methods
+    //@{
+    TAO_ORB_Core *orb_core (void) const;
+
+    TAO_Stub *stub (void) const;
+
+    /// Accessor and mutator methods for forwarded object
+    /// locations.
+    /**
+     * These access methods have to be public so that the
+     * PortableInterceptor can use them
+     */
+    CORBA::Object_ptr forwarded_reference (void);
+    void forwarded_reference (CORBA::Object_ptr o);
+
+    /// Accessors for the service context list.
+    /**
+     * The service context lists are actually cached
+     * elsewhere. Providing this accessor helps the PI to access this
+     * list in both remote and collocated mode.
+     */
+    TAO_Service_Context &request_service_context (void);
+    TAO_Service_Context &reply_service_context (void);
+
+    /// Return the forwarded object location by loosing ownership.
+    CORBA::Object_ptr steal_forwarded_reference (void);
+
+    /// Did the invocation got forwarded to a new location?
+    bool is_forwarded (void) const;
+
+    /// Mutator to set the reply status of the invocation.
+    void reply_received (Invocation_Status s);
+
+    /// Return the effective target of the invocation.
+    /**
+     * Please see the PortableInterceptor specification in the CORBA
+     * spec to understand what effective target means.
+     */
+    CORBA::Object_ptr effective_target (void) const;
+
+    /// Return the target object
+    CORBA::Object_ptr target (void) const;
+
+    /// Does this invocation return a response?
+    CORBA::Boolean response_expected (void) const;
+
+    /// The operaton details of the invocation
+    TAO_Operation_Details &operation_details (void);
+    //@}
+
+  protected:
+    /**
+     * @param otarget The original target on which this invocation
+     * was started.
+     *
+     * @param target the target on which this invocation is flowing
+     * ie. the effective target
+     *
+     * @param op operation details of the invocation on @a target
+     *
+     * @param response_expected flag to indicate whether the
+     * operation encapsulated by @a op returns a response or not.
+     */
+    Invocation_Base (CORBA::Object_ptr otarget,
+                     CORBA::Object_ptr target,
+                     TAO_Stub *stub,
+                     TAO_Operation_Details &op,
+                     bool response_expected,
+                     bool request_is_remote);
+
+  protected:
+    /// The operation details on which we are operating on.
+    TAO_Operation_Details &details_;
+
+    /// Forwarded object reference.
+    CORBA::Object_var forwarded_to_;
+
+    /// Is response expected?
+    bool response_expected_;
+
+  private:
+
+    Invocation_Base (const Invocation_Base&);
+    Invocation_Base & operator= (const Invocation_Base &);
+
+  private:
+    //@{
+    /**
+     * The following object reference pointers are *not*
+     * duplicated. They are cached for portable interceptors, and they
+     * just live for the lifetime of the request. Hence there is no
+     * point in duplicating the pointers.
+     */
+    /// The original target on which the invocation was started.
+    CORBA::Object_ptr otarget_;
+
+    /// The effective target on which the invocation is on.
+    CORBA::Object_ptr target_;
+
+    /// Cache the ORB_Core
+    TAO_ORB_Core *orb_core_;
+
+    TAO_Stub *stub_;
+    //@}
+
+    /// Operations invoked by the
+    /// PortableInterceptor::ClientRequestInfo object to get details
+    /// about the operation and related stuff.
+    //@{
+#if TAO_HAS_INTERCEPTORS == 1
+  public:
+    /// Return a reference to the number of interceptors pushed on to
+    /// the current interceptor flow stack.
+    /**
+     * @note It is a reference since the Portable Interceptor flow stack
+     *       code must be able to modify this value and use that value
+     *       at a later time without being forced to use TSS.
+     */
+    size_t &stack_size (void);
+
+    CORBA::Exception *caught_exception (void);
+
+    /// Change the exception status.
+    void exception (CORBA::Exception *exception);
+
+    /// Invoke status
+    TAO::Invocation_Status invoke_status (void) const;
+
+    PortableInterceptor::ReplyStatus reply_status (void) const;
+
+    /// Accessor used to determine if the current invocation is part
+    /// of a remote request, and if not, it will be considered to be
+    /// part of a collocated request.
+    bool is_remote_request() const;
+
+  protected:
+    /// Helper method to invoke send_request interception call to all
+    /// the registered interceptors.
+    Invocation_Status send_request_interception (ACE_ENV_SINGLE_ARG_DECL)
+      ACE_THROW_SPEC ((CORBA::SystemException));
+
+    /// Helper method to invoke receive_reply interception call to all
+    /// the registered interceptors.
+    Invocation_Status receive_reply_interception (ACE_ENV_SINGLE_ARG_DECL)
+      ACE_THROW_SPEC ((CORBA::SystemException));
+
+    /// Helper method to invoke receive_other interception call to all
+    /// the registered interceptors.
+    Invocation_Status receive_other_interception (ACE_ENV_SINGLE_ARG_DECL)
+      ACE_THROW_SPEC ((CORBA::SystemException));
+
+    /// Helper methods to handle interception calls when exceptions
+    /// are thrown by the PortableInterceptor.
+    PortableInterceptor::ReplyStatus
+        handle_any_exception (CORBA::Exception *e
+                              ACE_ENV_ARG_DECL);
+
+    PortableInterceptor::ReplyStatus
+        handle_all_exception (ACE_ENV_SINGLE_ARG_DECL);
+
+  protected:
+    /// The client requestor adapter
+    ClientRequestInterceptor_Adapter *adapter_;
+
+    size_t stack_size_;
+
+    TAO::Invocation_Status invoke_status_;
+
+  private:
+    /// Pointer to the caught exception.
+    CORBA::Exception *caught_exception_;
+
+    /// Flag used to distinguish a remote invocation versus a collocated
+    /// (thru-poa) invocation.
+    bool is_remote_request_;
+#endif /*TAO_HAS_INTERCEPTORS*/
+    //@}
+  };
+}
+
+TAO_END_VERSIONED_NAMESPACE_DECL
+
+#if defined (__ACE_INLINE__)
+# include "tao/Invocation_Base.inl"
+#endif /* __ACE_INLINE__ */
+
+#include /**/ "ace/post.h"
+
+#endif /*TAO_INVOCATION_BASE_H*/