Package org.gnome.gio

Class DBusMessage

java.lang.Object

io.github.jwharm.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gio.DBusMessage

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
public class DBusMessage
extends GObject

A type for representing D-Bus messages that can be sent or received on a DBusConnection.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DBusMessage.Builder<B extends DBusMessage.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Constructor Summary

Constructors

Constructor	Description
DBusMessage()	Creates a new empty GDBusMessage.
DBusMessage(MemorySegment address)	Create a DBusMessage proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
protected DBusMessage	asParent()	Returns this instance as if it were its parent type.
static DBusMessage.Builder<? extends DBusMessage.Builder>	builder()	A DBusMessage.Builder object constructs a DBusMessage with the specified properties.
static long	bytesNeeded(byte[] blob)	Utility function to calculate how many bytes are needed to completely deserialize the D-Bus message stored at blob.
DBusMessage	copy()	Copies this DBusMessage.
static DBusMessage	fromBlob(byte[] blob, Set<DBusCapabilityFlags> capabilities)	Creates a new GDBusMessage from the data stored at blob.
static DBusMessage	fromBlob(byte[] blob, DBusCapabilityFlags... capabilities)	Creates a new GDBusMessage from the data stored at blob.
String	getArg0()	Convenience to get the first item in the body of this DBusMessage.
String	getArg0Path()	Convenience to get the first item in the body of this DBusMessage.
Variant	getBody()	Gets the body of a message.
DBusMessageByteOrder	getByteOrder()	Gets the byte order of this DBusMessage.
String	getDestination()	Convenience getter for the DBusMessageHeaderField.DESTINATION header field.
String	getErrorName()	Convenience getter for the DBusMessageHeaderField.ERROR_NAME header field.
Set<DBusMessageFlags>	getFlags()	Gets the flags for this DBusMessage.
Variant	getHeader(DBusMessageHeaderField headerField)	Gets a header field on this DBusMessage.
byte[]	getHeaderFields()	Gets an array of all header fields on this DBusMessage that are set.
String	getInterface()	Convenience getter for the DBusMessageHeaderField.INTERFACE header field.
boolean	getLocked()	Checks whether this DBusMessage is locked.
String	getMember()	Convenience getter for the DBusMessageHeaderField.MEMBER header field.
DBusMessageType	getMessageType()	Gets the type of this DBusMessage.
int	getNumUnixFds()	Convenience getter for the DBusMessageHeaderField.NUM_UNIX_FDS header field.
String	getPath()	Convenience getter for the DBusMessageHeaderField.PATH header field.
int	getReplySerial()	Convenience getter for the DBusMessageHeaderField.REPLY_SERIAL header field.
String	getSender()	Convenience getter for the DBusMessageHeaderField.SENDER header field.
int	getSerial()	Gets the serial for this DBusMessage.
String	getSignature()	Convenience getter for the DBusMessageHeaderField.SIGNATURE header field.
static Type	getType()	Get the GType of the DBusMessage class
UnixFDList	getUnixFdList()	Gets the UNIX file descriptors associated with this DBusMessage, if any.
void	lock()	If this DBusMessage is locked, does nothing.
static DBusMessage	methodCall(@Nullable String name, String path, @Nullable String interface_, String method)	Creates a new GDBusMessage for a method call.
DBusMessage	newMethodError(String errorName, String errorMessageFormat, Object... varargs)	Creates a new GDBusMessage that is an error reply to this DBusMessage.
DBusMessage	newMethodErrorLiteral(String errorName, String errorMessage)	Creates a new GDBusMessage that is an error reply to this DBusMessage.
DBusMessage	newMethodReply()	Creates a new GDBusMessage that is a reply to this DBusMessage.
String	print(int indent)	Produces a human-readable multi-line description of this DBusMessage.
void	setBody(Variant body)	Sets the body this DBusMessage.
void	setByteOrder(DBusMessageByteOrder byteOrder)	Sets the byte order of this DBusMessage.
void	setDestination(@Nullable String value)	Convenience setter for the DBusMessageHeaderField.DESTINATION header field.
void	setErrorName(String value)	Convenience setter for the DBusMessageHeaderField.ERROR_NAME header field.
void	setFlags(Set<DBusMessageFlags> flags)	Sets the flags to set on this DBusMessage.
void	setFlags(DBusMessageFlags... flags)	Sets the flags to set on this DBusMessage.
void	setHeader(DBusMessageHeaderField headerField, @Nullable Variant value)	Sets a header field on this DBusMessage.
void	setInterface(@Nullable String value)	Convenience setter for the DBusMessageHeaderField.INTERFACE header field.
void	setMember(@Nullable String value)	Convenience setter for the DBusMessageHeaderField.MEMBER header field.
void	setMessageType(DBusMessageType type)	Sets this DBusMessage to be of type.
void	setNumUnixFds(int value)	Convenience setter for the DBusMessageHeaderField.NUM_UNIX_FDS header field.
void	setPath(@Nullable String value)	Convenience setter for the DBusMessageHeaderField.PATH header field.
void	setReplySerial(int value)	Convenience setter for the DBusMessageHeaderField.REPLY_SERIAL header field.
void	setSender(@Nullable String value)	Convenience setter for the DBusMessageHeaderField.SENDER header field.
void	setSerial(int serial)	Sets the serial for this DBusMessage.
void	setSignature(@Nullable String value)	Convenience setter for the DBusMessageHeaderField.SIGNATURE header field.
void	setUnixFdList(@Nullable UnixFDList fdList)	Sets the UNIX file descriptors associated with this DBusMessage.
static DBusMessage	signal(String path, String interface_, String signal)	Creates a new GDBusMessage for a signal emission.
byte[]	toBlob(Set<DBusCapabilityFlags> capabilities)	Serializes this DBusMessage to a blob.
byte[]	toBlob(DBusCapabilityFlags... capabilities)	Serializes this DBusMessage to a blob.
boolean	toGerror()	If this DBusMessage is not of type DBusMessageType.ERROR does nothing and returns false.

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getMemoryLayout, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, getPrivate, readGClass, writeGClass

Methods inherited from class io.github.jwharm.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DBusMessage

public DBusMessage(MemorySegment address)

Create a DBusMessage proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

DBusMessage

public DBusMessage()

Creates a new empty GDBusMessage.

Method Details

getType

public static Type getType()

Get the GType of the DBusMessage class

Returns:

the GType

asParent

protected DBusMessage asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class GObject

fromBlob

public static DBusMessage fromBlob(byte[] blob,
 Set<DBusCapabilityFlags> capabilities)
                            throws GErrorException

Creates a new GDBusMessage from the data stored at blob. The byte order that the message was in can be retrieved using g_dbus_message_get_byte_order().

If the blob cannot be parsed, contains invalid fields, or contains invalid headers, IOErrorEnum.INVALID_ARGUMENT will be returned.

Parameters:

blob - A blob representing a binary D-Bus message.

capabilities - A GDBusCapabilityFlags describing what protocol features are supported.

Returns:

A new GDBusMessage or null if error is set. Free with g_object_unref().

Throws:

GErrorException - see GError

fromBlob

public static DBusMessage fromBlob(byte[] blob,
 DBusCapabilityFlags... capabilities)
                            throws GErrorException

Creates a new GDBusMessage from the data stored at blob. The byte order that the message was in can be retrieved using g_dbus_message_get_byte_order().

If the blob cannot be parsed, contains invalid fields, or contains invalid headers, IOErrorEnum.INVALID_ARGUMENT will be returned.

Parameters:

blob - A blob representing a binary D-Bus message.

capabilities - A GDBusCapabilityFlags describing what protocol features are supported.

Returns:

A new GDBusMessage or null if error is set. Free with g_object_unref().

Throws:

GErrorException - see GError

methodCall

public static DBusMessage methodCall(@Nullable
 @Nullable String name,
 String path,
 @Nullable
 @Nullable String interface_,
 String method)

Creates a new GDBusMessage for a method call.

Parameters:

name - A valid D-Bus name or null.

path - A valid object path.

interface_ - A valid D-Bus interface name or null.

method - A valid method name.

Returns:

A GDBusMessage. Free with g_object_unref().

signal

public static DBusMessage signal(String path,
 String interface_,
 String signal)

Creates a new GDBusMessage for a signal emission.

Parameters:

path - A valid object path.

interface_ - A valid D-Bus interface name.

signal - A valid signal name.

Returns:

A GDBusMessage. Free with g_object_unref().

bytesNeeded

public static long bytesNeeded(byte[] blob)
                        throws GErrorException

Utility function to calculate how many bytes are needed to completely deserialize the D-Bus message stored at blob.

Parameters:

blob - A blob representing a binary D-Bus message.

Returns:

Number of bytes needed or -1 if error is set (e.g. if blob contains invalid data or not enough data is available to determine the size).

Throws:

GErrorException - see GError

copy

public DBusMessage copy()
                 throws GErrorException

Copies this DBusMessage. The copy is a deep copy and the returned GDBusMessage is completely identical except that it is guaranteed to not be locked.

This operation can fail if e.g. this DBusMessage contains file descriptors and the per-process or system-wide open files limit is reached.

Returns:

A new GDBusMessage or null if error is set. Free with g_object_unref().

Throws:

GErrorException - see GError

getArg0

public String getArg0()

Convenience to get the first item in the body of this DBusMessage.

See getArg0Path() for returning object-path-typed arg0 values.

Returns:

The string item or null if the first item in the body of this DBusMessage is not a string.

getArg0Path

public String getArg0Path()

Convenience to get the first item in the body of this DBusMessage.

See getArg0() for returning string-typed arg0 values.

Returns:

The object path item or NULL if the first item in the body of this DBusMessage is not an object path.

getBody

public Variant getBody()

Gets the body of a message.

Returns:

A GVariant or null if the body is empty. Do not free, it is owned by this DBusMessage.

getByteOrder

public DBusMessageByteOrder getByteOrder()

Gets the byte order of this DBusMessage.

Returns:

The byte order.

getDestination

public String getDestination()

Convenience getter for the DBusMessageHeaderField.DESTINATION header field.

Returns:

The value.

getErrorName

public String getErrorName()

Convenience getter for the DBusMessageHeaderField.ERROR_NAME header field.

Returns:

The value.

getFlags

public Set<DBusMessageFlags> getFlags()

Gets the flags for this DBusMessage.

Returns:

Flags that are set (typically values from the GDBusMessageFlags enumeration bitwise ORed together).

getHeader

public Variant getHeader(DBusMessageHeaderField headerField)

Gets a header field on this DBusMessage.

The caller is responsible for checking the type of the returned GVariant matches what is expected.

Parameters:

headerField - A 8-bit unsigned integer (typically a value from the GDBusMessageHeaderField enumeration)

Returns:

A GVariant with the value if the header was found, null otherwise. Do not free, it is owned by this DBusMessage.

getHeaderFields

public byte[] getHeaderFields()

Gets an array of all header fields on this DBusMessage that are set.

Returns:

An array of header fields terminated by DBusMessageHeaderField.INVALID. Each element is a guchar. Free with g_free().

getInterface

public String getInterface()

Convenience getter for the DBusMessageHeaderField.INTERFACE header field.

Returns:

The value.

getLocked

public boolean getLocked()

Checks whether this DBusMessage is locked. To monitor changes to this value, conncet to the GObject::notify signal to listen for changes on the GDBusMessage:locked property.

Returns:

true if this DBusMessage is locked, false otherwise.

getMember

public String getMember()

Convenience getter for the DBusMessageHeaderField.MEMBER header field.

Returns:

The value.

getMessageType

public DBusMessageType getMessageType()

Gets the type of this DBusMessage.

Returns:

A 8-bit unsigned integer (typically a value from the GDBusMessageType enumeration).

getNumUnixFds

public int getNumUnixFds()

Convenience getter for the DBusMessageHeaderField.NUM_UNIX_FDS header field.

Returns:

The value.

getPath

public String getPath()

Convenience getter for the DBusMessageHeaderField.PATH header field.

Returns:

The value.

getReplySerial

public int getReplySerial()

Convenience getter for the DBusMessageHeaderField.REPLY_SERIAL header field.

Returns:

The value.

getSender

public String getSender()

Convenience getter for the DBusMessageHeaderField.SENDER header field.

Returns:

The value.

getSerial

public int getSerial()

Gets the serial for this DBusMessage.

Returns:

A guint32.

getSignature

public String getSignature()

Convenience getter for the DBusMessageHeaderField.SIGNATURE header field.

This will always be non-null, but may be an empty string.

Returns:

The value.

getUnixFdList

public UnixFDList getUnixFdList()

Gets the UNIX file descriptors associated with this DBusMessage, if any.

This method is only available on UNIX.

The file descriptors normally correspond to G_VARIANT_TYPE_HANDLE values in the body of the message. For example, if g_variant_get_handle() returns 5, that is intended to be a reference to the file descriptor that can be accessed by g_unix_fd_list_get (list, 5, ...).

Returns:

A GUnixFDList or null if no file descriptors are associated. Do not free, this object is owned by this DBusMessage.

lock

public void lock()

If this DBusMessage is locked, does nothing. Otherwise locks the message.

newMethodError

public DBusMessage newMethodError(String errorName,
 String errorMessageFormat,
 Object... varargs)

Creates a new GDBusMessage that is an error reply to this DBusMessage.

Parameters:

errorName - A valid D-Bus error name.

errorMessageFormat - The D-Bus error message in a printf() format.

varargs - Arguments for errorMessageFormat.

Returns:

A GDBusMessage. Free with g_object_unref().

newMethodErrorLiteral

public DBusMessage newMethodErrorLiteral(String errorName,
 String errorMessage)

Creates a new GDBusMessage that is an error reply to this DBusMessage.

Parameters:

errorName - A valid D-Bus error name.

errorMessage - The D-Bus error message.

Returns:

A GDBusMessage. Free with g_object_unref().

newMethodReply

public DBusMessage newMethodReply()

Creates a new GDBusMessage that is a reply to this DBusMessage.

Returns:

GDBusMessage. Free with g_object_unref().

print

public String print(int indent)

Produces a human-readable multi-line description of this DBusMessage.

The contents of the description has no ABI guarantees, the contents and formatting is subject to change at any time. Typical output looks something like this:

 Flags:   none
 Version: 0
 Serial:  4
 Headers:
   path -> objectpath '/org/gtk/GDBus/TestObject'
   interface -> 'org.gtk.GDBus.TestInterface'
   member -> 'GimmeStdout'
   destination -> ':1.146'
 Body: ()
 UNIX File Descriptors:
   (none)
 

or

 Flags:   no-reply-expected
 Version: 0
 Serial:  477
 Headers:
   reply-serial -> uint32 4
   destination -> ':1.159'
   sender -> ':1.146'
   num-unix-fds -> uint32 1
 Body: ()
 UNIX File Descriptors:
   fd 12: dev=0:10,mode=020620,ino=5,uid=500,gid=5,rdev=136:2,size=0,atime=1273085037,mtime=1273085851,ctime=1272982635
 

Parameters:

indent - Indentation level.

Returns:

A string that should be freed with GLib.free(java.lang.foreign.MemorySegment).

setBody

public void setBody(Variant body)

Sets the body this DBusMessage. As a side-effect the DBusMessageHeaderField.SIGNATURE header field is set to the type string of body (or cleared if body is null).

If body is floating, this DBusMessage assumes ownership of body.

Parameters:

body - Either null or a GVariant that is a tuple.

setByteOrder

public void setByteOrder(DBusMessageByteOrder byteOrder)

Sets the byte order of this DBusMessage.

Parameters:

byteOrder - The byte order.

setDestination

public void setDestination(@Nullable
 @Nullable String value)

Convenience setter for the DBusMessageHeaderField.DESTINATION header field.

Parameters:

value - The value to set.

setErrorName

public void setErrorName(String value)

Convenience setter for the DBusMessageHeaderField.ERROR_NAME header field.

Parameters:

value - The value to set.

setFlags

public void setFlags(Set<DBusMessageFlags> flags)

Sets the flags to set on this DBusMessage.

Parameters:

flags - Flags for this DBusMessage that are set (typically values from the GDBusMessageFlags enumeration bitwise ORed together).

setFlags

public void setFlags(DBusMessageFlags... flags)

Sets the flags to set on this DBusMessage.

Parameters:

flags - Flags for this DBusMessage that are set (typically values from the GDBusMessageFlags enumeration bitwise ORed together).

setHeader

public void setHeader(DBusMessageHeaderField headerField,
 @Nullable
 @Nullable Variant value)

Sets a header field on this DBusMessage.

If value is floating, this DBusMessage assumes ownership of value.

Parameters:

headerField - A 8-bit unsigned integer (typically a value from the GDBusMessageHeaderField enumeration)

value - A GVariant to set the header field or null to clear the header field.

setInterface

public void setInterface(@Nullable
 @Nullable String value)

Convenience setter for the DBusMessageHeaderField.INTERFACE header field.

Parameters:

value - The value to set.

setMember

public void setMember(@Nullable
 @Nullable String value)

Convenience setter for the DBusMessageHeaderField.MEMBER header field.

Parameters:

value - The value to set.

setMessageType

public void setMessageType(DBusMessageType type)

Sets this DBusMessage to be of type.

Parameters:

type - A 8-bit unsigned integer (typically a value from the GDBusMessageType enumeration).

setNumUnixFds

public void setNumUnixFds(int value)

Convenience setter for the DBusMessageHeaderField.NUM_UNIX_FDS header field.

Parameters:

value - The value to set.

setPath

public void setPath(@Nullable
 @Nullable String value)

Convenience setter for the DBusMessageHeaderField.PATH header field.

Parameters:

value - The value to set.

setReplySerial

public void setReplySerial(int value)

Convenience setter for the DBusMessageHeaderField.REPLY_SERIAL header field.

Parameters:

value - The value to set.

setSender

public void setSender(@Nullable
 @Nullable String value)

Convenience setter for the DBusMessageHeaderField.SENDER header field.

Parameters:

value - The value to set.

setSerial

public void setSerial(int serial)

Sets the serial for this DBusMessage.

Parameters:

serial - A guint32.

setSignature

public void setSignature(@Nullable
 @Nullable String value)

Convenience setter for the DBusMessageHeaderField.SIGNATURE header field.

Parameters:

value - The value to set.

setUnixFdList

public void setUnixFdList(@Nullable
 @Nullable UnixFDList fdList)

Sets the UNIX file descriptors associated with this DBusMessage. As a side-effect the DBusMessageHeaderField.NUM_UNIX_FDS header field is set to the number of fds in fdList (or cleared if fdList is null).

This method is only available on UNIX.

When designing D-Bus APIs that are intended to be interoperable, please note that non-GDBus implementations of D-Bus can usually only access file descriptors if they are referenced by a value of type G_VARIANT_TYPE_HANDLE in the body of the message.

Parameters:

fdList - A GUnixFDList or null.

toBlob

public byte[] toBlob(Set<DBusCapabilityFlags> capabilities)
              throws GErrorException

Serializes this DBusMessage to a blob. The byte order returned by g_dbus_message_get_byte_order() will be used.

Parameters:

capabilities - A GDBusCapabilityFlags describing what protocol features are supported.

Returns:

A pointer to a valid binary D-Bus message of outSize bytes generated by this DBusMessage or null if error is set. Free with g_free().

Throws:

GErrorException - see GError

toBlob

public byte[] toBlob(DBusCapabilityFlags... capabilities)
              throws GErrorException

Serializes this DBusMessage to a blob. The byte order returned by g_dbus_message_get_byte_order() will be used.

Parameters:

capabilities - A GDBusCapabilityFlags describing what protocol features are supported.

Returns:

A pointer to a valid binary D-Bus message of outSize bytes generated by this DBusMessage or null if error is set. Free with g_free().

Throws:

GErrorException - see GError

toGerror

public boolean toGerror()
                 throws GErrorException

If this DBusMessage is not of type DBusMessageType.ERROR does nothing and returns false.

Otherwise this method encodes the error in this DBusMessage as a GError using g_dbus_error_set_dbus_error() using the information in the DBusMessageHeaderField.ERROR_NAME header field of this DBusMessage as well as the first string item in this DBusMessage's body.

Returns:

true if error was set, false otherwise.

Throws:

GErrorException - see GError

builder

public static DBusMessage.Builder<? extends DBusMessage.Builder> builder()

A DBusMessage.Builder object constructs a DBusMessage with the specified properties. Use the various set...() methods to set properties, and finish construction with DBusMessage.Builder.build().