aboutsummaryrefslogtreecommitdiff
path: root/src/main/java/org/gnunet/util/GnunetMessage.java
blob: 35667f0d085b806ad32f854ac98a86d6ba5b4023 (plain) (blame)
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
81
/*
 This file is part of GNUnet.
 Copyright (C) 2011, 2012 Christian Grothoff (and other contributing authors)

 GNUnet is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published
 by the Free Software Foundation; either version 3, or (at your
 option) any later version.

 GNUnet is distributed in the hope that it will be useful, but
 WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with GNUnet; see the file COPYING.  If not, write to the
 Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 Boston, MA 02111-1307, USA.
 */

package org.gnunet.util;


import org.gnunet.construct.*;


/**
 * Every message used to communicate between gnunet components uses this format.
 * First, a header is sent, containing the size of the overall message (including the header), as
 * well as the type of the message. After that the message body is sent, whose format is specified
 * by the message type.
 *
 */
public final class GnunetMessage implements Message {
    public static final int MINIMAL_SIZE = Header.SIZE;


    /**
     * The header of every gnunet message.
     */
    public static final class Header implements Message {
        public static final int SIZE = 4;

        @FrameSize
        @UInt16
        public int messageSize;

        @UInt16
        public int messageType;
    }

    /**
     * The common interface for every message body.
     *
     */
    public static interface Body extends MessageUnion {
    }


    /**
     * Create a GnunetMessage from its body only. The header is added and filled with the relevant information
     * automatically.
     *
     * @param b the message body to convert
     * @return a complete and valid gnunet message
     */
    public static GnunetMessage fromBody(Body b) {
        GnunetMessage msg = new GnunetMessage();
        msg.header = new Header();
        msg.header.messageSize = Header.SIZE + Construct.getSize(b);
        msg.header.messageType = MessageLoader.getUnionTag(GnunetMessage.Body.class, b.getClass());
        msg.body = b;
        return msg;
    }

    @NestedMessage
    public Header header;

    @Union(tag = "header.messageType")
    public Body body;
}