File: DKMessage.h

package info (click to toggle)
dbuskit 0.1.1-14
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 3,956 kB
  • sloc: objc: 10,543; sh: 9,463; ansic: 200; makefile: 32
file content (81 lines) | stat: -rw-r--r-- 2,239 bytes parent folder | download | duplicates (4)
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
/** Interface for the DKMessage class wrapping D-Bus messages

   Copyright (C) 2010 Free Software Foundation, Inc.

   Written by:  Niels Grewe <niels.grewe@halbordnung.de>
   Created: June 2010

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

   This library 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
   Library General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with this library; if not, write to the Free
   Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02111 USA.
   */

#import <Foundation/NSObject.h>

#include <dbus/dbus.h>
#include <stdint.h>
@class DKEndpoint;

/**
 * DKMessage is a superclass for specific types of D-Bus messages that can be
 * sent via D-Bus. Usually, you do not allocate instances of this class but use
 * the provided subclasses.
 */
@interface DKMessage: NSObject
{
  /**
   * The D-Bus message wrapped by this object.
   */
  DBusMessage *msg;

  /**
   * The endpoint via which the message will be sent.
   */
  DKEndpoint *endpoint;

  /**
   * D-Bus resources preallocated for sending the message.
   */
  DBusPreallocatedSend *res;

  /**
   * The serial number assigned to the message when it is sent.
   */
  uint32_t serial;
}

/**
 * Initializes the object so that the specified D-Bus message can be sent via
 * the endpoint specified. The caller can request the resources for sending the
 * message to be preallocated.
 */
- (id) initWithDBusMessage: (DBusMessage*)aMsg
               forEndpoint: (DKEndpoint*)anEndpoint
      preallocateResources: (BOOL)preallocate;

/**
 * Returns the D-Bus message represented by this object.
 */
- (DBusMessage*) DBusMessage;

/**
 * Sends the message via the endpoint.
 */
- (void) send;

/**
 * Returns the serial number assigned to the message upon sending it.
 */
- (NSUInteger)serial;
@end;