Modul org.freedesktop.dbus
Package org.freedesktop.dbus.messages

Klasse Message

java.lang.Object
org.freedesktop.dbus.messages.Message
Bekannte direkte Unterklassen:
DBusSignal, Error, MethodBase
public class Message extends Object
Superclass of all messages which are sent over the Bus. This class deals with all the marshalling to/from the wire format.

  • Verschachtelte Klassen - Übersicht

    Verschachtelte Klassen
    Modifizierer und Typ
    Klasse
    Beschreibung
    static interface 
    Message.ArgumentType
    Defines constants for each argument type.
    static interface 
    Message.Endian
    Defines constants representing the endianness of the message.
    static interface 
    Message.Flags
    Defines constants representing the flags which can be set on a message.
    static interface 
    Message.HeaderField
    Defines constants for each valid header field type.
    static interface 
    Message.MessageType
    Defines constants for each message type.

  • Feldübersicht

    Felder
    Modifizierer und Typ
    Feld
    Beschreibung
    protected final org.slf4j.Logger
    logger
     
    static final int
    MAXIMUM_ARRAY_LENGTH
     
    static final int
    MAXIMUM_MESSAGE_LENGTH
     
    static final int
    MAXIMUM_NUM_UNIX_FDS
     
    static final byte
    PROTOCOL
    The current protocol major version.

  • Konstruktorübersicht

    Konstruktoren
    Modifizierer
    Konstruktor
    Beschreibung
    protected
    Message()
    Create a blank message.
    protected
    Message(byte _endian, byte _type, byte _flags)
    Create a message; only to be called by sub-classes.

  • Methodenübersicht

    Modifizierer und Typ
    Methode
    Beschreibung
    int
    align(int _current, byte _type)
    Align a counter to the given type.
    void
    append(String _sig, Object... _data)
    Append a series of values to the message.
    protected void
    appendByte(byte _b)
    Appends a byte to the buffer list.
    protected void
    appendBytes(byte[] _buf)
    Appends a buffer to the buffer list.
    void
    appendint(long _l, int _width)
    Marshalls an integer of a given width and appends it to the message.
    protected Object[]
    createHeaderArgs(byte _header, String _argType, Object _value)
    Creates a message header.
    static long
    demarshallint(byte[] _buf, int _ofs, byte _endian, int _width)
    Demarshalls an integer of a given width from a buffer.
    long
    demarshallint(byte[] _buf, int _ofs, int _width)
    Demarshalls an integer of a given width from a buffer.
    static long
    demarshallintBig(byte[] _buf, int _ofs, int _width)
    Demarshalls an integer of a given width from a buffer using big-endian format.
    static long
    demarshallintLittle(byte[] _buf, int _ofs, int _width)
    Demarshalls an integer of a given width from a buffer using little-endian format.
    Object[]
    extract(String _signature, byte[] _dataBuf, int _offsets)
    Demarshall values from a buffer.
    Object[]
    extract(String _signature, byte[] _dataBuf, int[] _offsets)
    Demarshall values from a buffer.
    static int
    getAlignment(byte _type)
    Return the alignment for a given type.
    protected long
    getByteCounter()
     
    String
    getDestination()
    Returns the destination of the message.
    byte
    getEndianess()
     
    List<FileDescriptor>
    getFiledescriptors()
     
    int
    getFlags()
    Returns the message flags.
    protected Object[]
    getHeader()
     
    Object
    getHeader(byte _type)
    Returns the value of the header field of a given field.
    static String
    getHeaderFieldName(byte _field)
    Returns the name of the given header field.
    protected Map<Byte,Object>
    getHeaders()
    Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt.
    use getHeader().
    String
    getInterface()
    Returns the interface of the message.
    String
    getName()
    Returns the member name or error name this message represents.
    Object[]
    getParameters()
    Parses and returns the parameters to this message as an Object array.
    String
    getPath()
    Returns the object path of the message.
    long
    getReplySerial()
    If this is a reply to a message, this returns its serial.
    long
    getSerial()
    Returns the message serial ID (unique for this connection)
    String
    getSig()
    Returns the dbus signature of the parameters.
    String
    getSource()
    Returns the Bus ID that sent the message.
    byte
    getType()
    Type of this message.
    protected byte[][]
    getWiredata()
     
    byte[][]
    getWireData()
     
    void
    marshallint(long _l, byte[] _buf, int _ofs, int _width)
    Marshalls an integer of a given width into a buffer.
    static void
    marshallintBig(long _l, byte[] _buf, int _ofs, int _width)
    Marshalls an integer of a given width into a buffer using big-endian format.
    static void
    marshallintLittle(long _l, byte[] _buf, int _ofs, int _width)
    Marshalls an integer of a given width into a buffer using little-endian format.
    void
    pad(byte _type)
    Pad the message to the proper alignment for the given type.
    protected void
    padAndMarshall(List<Object> _hargs, long _serial, String _sig, Object... _args)
    Adds message padding and marshalling.
    void
    setArgs(Object[] _args)
     
    protected void
    setByteCounter(long _bytecounter)
     
    protected void
    setHeader(Object[] _header)
    Set header content.
    protected void
    setSerial(long _serial)
     
    void
    setSource(String _source)
    Warning, do not use this method unless you really know what you are doing.
    protected void
    setWiredata(byte[][] _wiredata)
     
    String
    toString()
    Formats the message in a human-readable format.

    Von Klasse geerbte Methoden java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • Felddetails

    • MAXIMUM_ARRAY_LENGTH

      public static final int MAXIMUM_ARRAY_LENGTH
      Siehe auch:

    • MAXIMUM_MESSAGE_LENGTH

      public static final int MAXIMUM_MESSAGE_LENGTH
      Siehe auch:

    • MAXIMUM_NUM_UNIX_FDS

      public static final int MAXIMUM_NUM_UNIX_FDS
      Siehe auch:

    • PROTOCOL

      public static final byte PROTOCOL
      The current protocol major version.
      Siehe auch:

    • logger

      protected final org.slf4j.Logger logger

  • Konstruktordetails

    • Message

      protected Message(byte _endian, byte _type, byte _flags) throws DBusException
      Create a message; only to be called by sub-classes.
      Parameter:
      _endian - The endianness to create the message.
      _type - The message type.
      _flags - Any message flags.
      Löst aus:
      DBusException - on error

    • Message

      protected Message()
      Create a blank message. Only to be used when calling populate.

  • Methodendetails

    • getHeaders

      @Deprecated(forRemoval=true, since="4.2.2 - 2023-01-19") protected Map<Byte,Object> getHeaders()
      Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt.
      use getHeader(). This method did return a map containing message header. It allows changing the map, but changes did not result in changing the actual message header. Therefore using a map was removed and an object array is used instead. Changes to that array (content) will be result in a changed header in the message.
      Gibt zurück:
      map of header

    • getHeader

      protected Object[] getHeader()

    • setHeader

      protected void setHeader(Object[] _header)
      Set header content. null value is ignored.
      Parameter:
      _header - header to set

    • getByteCounter

      protected long getByteCounter()

    • setByteCounter

      protected void setByteCounter(long _bytecounter)

    • setSerial

      protected void setSerial(long _serial)

    • getWiredata

      protected byte[][] getWiredata()

    • setWiredata

      protected void setWiredata(byte[][] _wiredata)

    • appendBytes

      protected void appendBytes(byte[] _buf)
      Appends a buffer to the buffer list.
      Parameter:
      _buf - buffer byte array

    • appendByte

      protected void appendByte(byte _b)
      Appends a byte to the buffer list.
      Parameter:
      _b - byte

    • demarshallint

      public long demarshallint(byte[] _buf, int _ofs, int _width)
      Demarshalls an integer of a given width from a buffer. Endianness is determined from the format of the message.
      Parameter:
      _buf - The buffer to demarshall from.
      _ofs - The offset to demarshall from.
      _width - The byte-width of the int.
      Gibt zurück:
      long

    • demarshallint

      public static long demarshallint(byte[] _buf, int _ofs, byte _endian, int _width)
      Demarshalls an integer of a given width from a buffer.
      Parameter:
      _buf - The buffer to demarshall from.
      _ofs - The offset to demarshall from.
      _endian - The endianness to use in demarshalling.
      _width - The byte-width of the int.
      Gibt zurück:
      long

    • demarshallintBig

      public static long demarshallintBig(byte[] _buf, int _ofs, int _width)
      Demarshalls an integer of a given width from a buffer using big-endian format.
      Parameter:
      _buf - The buffer to demarshall from.
      _ofs - The offset to demarshall from.
      _width - The byte-width of the int.
      Gibt zurück:
      long

    • demarshallintLittle

      public static long demarshallintLittle(byte[] _buf, int _ofs, int _width)
      Demarshalls an integer of a given width from a buffer using little-endian format.
      Parameter:
      _buf - The buffer to demarshall from.
      _ofs - The offset to demarshall from.
      _width - The byte-width of the int.
      Gibt zurück:
      long

    • appendint

      public void appendint(long _l, int _width)
      Marshalls an integer of a given width and appends it to the message. Endianness is determined from the message.
      Parameter:
      _l - The integer to marshall.
      _width - The byte-width of the int.

    • marshallint

      public void marshallint(long _l, byte[] _buf, int _ofs, int _width)
      Marshalls an integer of a given width into a buffer. Endianness is determined from the message.
      Parameter:
      _l - The integer to marshall.
      _buf - The buffer to marshall to.
      _ofs - The offset to marshall to.
      _width - The byte-width of the int.

    • marshallintBig

      public static void marshallintBig(long _l, byte[] _buf, int _ofs, int _width)
      Marshalls an integer of a given width into a buffer using big-endian format.
      Parameter:
      _l - The integer to marshall.
      _buf - The buffer to marshall to.
      _ofs - The offset to marshall to.
      _width - The byte-width of the int.

    • marshallintLittle

      public static void marshallintLittle(long _l, byte[] _buf, int _ofs, int _width)
      Marshalls an integer of a given width into a buffer using little-endian format.
      Parameter:
      _l - The integer to marshall.
      _buf - The buffer to demarshall to.
      _ofs - The offset to demarshall to.
      _width - The byte-width of the int.

    • getWireData

      public byte[][] getWireData()

    • getFiledescriptors

      public List<FileDescriptor> getFiledescriptors()

    • toString

      public String toString()
      Formats the message in a human-readable format.
      Setzt außer Kraft:
      toString in Klasse Object

    • getHeader

      public Object getHeader(byte _type)
      Returns the value of the header field of a given field.
      Parameter:
      _type - The field to return.
      Gibt zurück:
      The value of the field or null if unset.

    • pad

      public void pad(byte _type)
      Pad the message to the proper alignment for the given type.
      Parameter:
      _type - type

    • getAlignment

      public static int getAlignment(byte _type)
      Return the alignment for a given type.
      Parameter:
      _type - type
      Gibt zurück:
      int

    • append

      public void append(String _sig, Object... _data) throws DBusException
      Append a series of values to the message.
      Parameter:
      _sig - The signature(s) of the value(s).
      _data - The value(s).
      Löst aus:
      DBusException - on error

    • align

      public int align(int _current, byte _type)
      Align a counter to the given type.
      Parameter:
      _current - The current counter.
      _type - The type to align to.
      Gibt zurück:
      The new, aligned, counter.

    • extract

      public Object[] extract(String _signature, byte[] _dataBuf, int _offsets) throws DBusException
      Demarshall values from a buffer.
      Parameter:
      _signature - The D-Bus signature(s) of the value(s).
      _dataBuf - The buffer to demarshall from.
      _offsets - The offset into the data buffer to start.
      Gibt zurück:
      The demarshalled value(s).
      Löst aus:
      DBusException - on error

    • extract

      public Object[] extract(String _signature, byte[] _dataBuf, int[] _offsets) throws DBusException
      Demarshall values from a buffer.
      Parameter:
      _signature - The D-Bus signature(s) of the value(s).
      _dataBuf - The buffer to demarshall from.
      _offsets - An array of two ints, which holds the position of the current signature offset and the current offset of the data buffer. These values will be updated to the start of the next value after demarshalling.
      Gibt zurück:
      The demarshalled value(s).
      Löst aus:
      DBusException - on error

    • getSource

      public String getSource()
      Returns the Bus ID that sent the message.
      Gibt zurück:
      string

    • getDestination

      public String getDestination()
      Returns the destination of the message.
      Gibt zurück:
      string

    • getInterface

      public String getInterface()
      Returns the interface of the message.
      Gibt zurück:
      string

    • getPath

      public String getPath()
      Returns the object path of the message.
      Gibt zurück:
      string

    • getName

      public String getName()
      Returns the member name or error name this message represents.
      Gibt zurück:
      string

    • getSig

      public String getSig()
      Returns the dbus signature of the parameters.
      Gibt zurück:
      string

    • getFlags

      public int getFlags()
      Returns the message flags.
      Gibt zurück:
      int

    • getSerial

      public long getSerial()
      Returns the message serial ID (unique for this connection)
      Gibt zurück:
      the message serial.

    • getReplySerial

      public long getReplySerial()
      If this is a reply to a message, this returns its serial.
      Gibt zurück:
      The reply serial, or 0 if it is not a reply.

    • getParameters

      public Object[] getParameters() throws DBusException
      Parses and returns the parameters to this message as an Object array.
      Gibt zurück:
      object array
      Löst aus:
      DBusException - on failure

    • setArgs

      public void setArgs(Object[] _args)

    • setSource

      public void setSource(String _source) throws DBusException
      Warning, do not use this method unless you really know what you are doing.
      Parameter:
      _source - string
      Löst aus:
      DBusException - on error

    • getType

      public byte getType()
      Type of this message.
      Gibt zurück:
      byte

    • getEndianess

      public byte getEndianess()

    • createHeaderArgs

      protected Object[] createHeaderArgs(byte _header, String _argType, Object _value)
      Creates a message header. Will automatically add the values to the current instances header map.
      Parameter:
      _header - header type (one of Message.HeaderField)
      _argType - argument type (one of Message.ArgumentType)
      _value - value
      Gibt zurück:
      Object array

    • padAndMarshall

      protected void padAndMarshall(List<Object> _hargs, long _serial, String _sig, Object... _args) throws DBusException
      Adds message padding and marshalling.
      Parameter:
      _hargs -
      _serial -
      _sig -
      _args -
      Löst aus:
      DBusException

    • getHeaderFieldName

      public static String getHeaderFieldName(byte _field)
      Returns the name of the given header field.
      Parameter:
      _field - field
      Gibt zurück:
      string