summaryrefslogtreecommitdiff
path: root/cpp/include/Ice/DispatchInterceptor.h
blob: a2aec7a9450c9fb478804880f9900506f40994e2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
// **********************************************************************
//
// Copyright (c) 2003-2017 ZeroC, Inc. All rights reserved.
//
// This copy of Ice is licensed to you under the terms described in the
// ICE_LICENSE file included in this distribution.
//
// **********************************************************************

#ifndef ICE_DISPATCH_INTERCEPTOR_H
#define ICE_DISPATCH_INTERCEPTOR_H

#include <Ice/Object.h>

namespace Ice
{

/**
 * Base class for a dispatch interceptor, which is a servant that dispatches requests
 * to another servant. A subclass must implement the dispatch method. A dispatch interceptor
 * can be registered with an object adapter just like any other servant.
 * \headerfile Ice/Ice.h
 */
class ICE_API DispatchInterceptor : public virtual Object
{
public:

    /**
     * Called by the Ice run time when a new request needs to be dispatched. The implementation
     * must eventually call ice_dispatch on the delegate servant and pass the given request object.
     * @param req An opaque object representing the request to be dispatched.
     * @return True if the request was dispatched synchronously, or false if the request was
     * dispatched asynchronously.
     */
    virtual bool dispatch(Request& req) = 0;

    /// \cond INTERNAL
    virtual bool _iceDispatch(IceInternal::Incoming&, const Current&);
    /// \endcond
};

ICE_DEFINE_PTR(DispatchInterceptorPtr, DispatchInterceptor);

}

#endif