summaryrefslogtreecommitdiff
path: root/cpp/lib/common/framing/MethodContext.h
blob: 3493924bf66fef22ed17978ef95efc8f38bbb1fb (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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
#ifndef _framing_MethodContext_h
#define _framing_MethodContext_h

/*
 *
 * Copyright (c) 2006 The Apache Software Foundation
 *
 * Licensed 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 <boost/shared_ptr.hpp>

#include "OutputHandler.h"
#include "ProtocolVersion.h"

namespace qpid {
namespace framing {

class BodyHandler;
class AMQMethodBody;
class ChannelAdapter;

/**
 * Invocation context for an AMQP method.
 * 
 * It provides the method being processed and the channel on which
 * it arrived.
 *
 * All Handler functions take a MethodContext as the last parameter.
 */
struct MethodContext
{
    typedef boost::shared_ptr<AMQMethodBody> BodyPtr;

    MethodContext(ChannelAdapter* ch=0, BodyPtr method=BodyPtr())
        : channel(ch), methodBody(method) {}

    /**
     * Channel on which the method being processed arrived.
     * 0 if the method was constructed by the caller
     * rather than received from a channel.
     */
    ChannelAdapter* channel;

    /**
     * Body of the method being processed.
     * It's useful for passing around instead of unpacking all its parameters.
     * It's also provides the request ID  when constructing a response.
     */
    BodyPtr methodBody;

    /**
     * Return methodBody's request ID.
     * It is an error to call this if methodBody is not a request.
     */
    RequestId getRequestId() const;
};

// FIXME aconway 2007-02-01: Method context only required on Handler
// functions, not on Proxy functions. If we add set/getChannel(ChannelAdapter*)
// on AMQBody and set it during decodeing then we could get rid of the context.



}} // namespace qpid::framing



#endif  /*!_framing_MethodContext_h*/