File: DBusSerializable.java

package info (click to toggle)
dbus-java 2.8-11
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 1,328 kB
  • sloc: java: 11,718; makefile: 287; sh: 35
file content (38 lines) | stat: -rw-r--r-- 1,356 bytes parent folder | download | duplicates (8)
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
/*
   D-Bus Java Implementation
   Copyright (c) 2005-2006 Matthew Johnson

   This program is free software; you can redistribute it and/or modify it
   under the terms of either the GNU Lesser General Public License Version 2 or the
   Academic Free Licence Version 2.1.

   Full licence texts are included in the COPYING file with this program.
*/
package org.freedesktop.dbus;
import org.freedesktop.dbus.exceptions.DBusException;
/**
 * Custom classes may be sent over DBus if they implement this interface.
 * <p>
 * In addition to the serialize method, classes <b>MUST</b> implement
 * a deserialize method which returns null and takes as it's arguments
 * all the DBus types the class will be serialied to <i>in order</i> and
 * <i>with type parameterisation</i>. They <b>MUST</b> also provide a 
 * zero-argument constructor. 
 * </p>
 * <p>
 * The serialize method should return the class properties you wish to
 * serialize, correctly formatted for the wire
 * (DBusConnection.convertParameters() can help with this), in order in an
 * Object array.
 * </p>
 * <p>
 * The deserialize method will be called once after the zero-argument
 * constructor. This should contain all the code to initialise the object 
 * from the types.
 * </p>
 */
public interface DBusSerializable
{
   public Object[] serialize() throws DBusException;
}