Package org.freedesktop.dbus

Class Marshalling

java.lang.Object

org.freedesktop.dbus.Marshalling

public final class Marshalling
extends Object

Contains static methods for marshalling values.

Method Summary

Modifier and Type	Method	Description
static Object[]	convertParameters(Object[] _parameters, Type[] _types, AbstractConnection _conn)	Recursively converts types for serialization onto DBus.
static Object[]	deSerializeParameters(Object[] _parameters, Type[] _types, AbstractConnection _conn)
static String[]	getDBusType(Type _javaType)	Will return the DBus type corresponding to the given Java type.
static String	getDBusType(Type[] _javaType)	Will return the DBus type corresponding to the given Java type.
static String[]	getDBusType(Type _dataType, boolean _basic)	Will return the DBus type corresponding to the given Java type.
static int	getJavaType(String _dbusType, List<Type> _resultValue, int _limit)	Converts a dbus type string into Java Type objects,

Methods inherited from class java.lang.Object

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

Method Detail

getDBusType

public static String getDBusType(Type[] _javaType)
                          throws DBusException

Will return the DBus type corresponding to the given Java type. Note, container type should have their ParameterizedType not their Class passed in here.

Parameters:

_javaType - The Java types.

Returns:

The DBus types.

Throws:

DBusException - If the given type cannot be converted to a DBus type.

getDBusType

public static String[] getDBusType(Type _javaType)
                            throws DBusException

Will return the DBus type corresponding to the given Java type. Note, container type should have their ParameterizedType not their Class passed in here.

Parameters:

_javaType - The Java type.

Returns:

The DBus type.

Throws:

DBusException - If the given type cannot be converted to a DBus type.

getDBusType

public static String[] getDBusType(Type _dataType,
                                   boolean _basic)
                            throws DBusException

Will return the DBus type corresponding to the given Java type. Note, container type should have their ParameterizedType not their Class passed in here.

Parameters:

_dataType - The Java type.

_basic - If true enforces this to be a non-compound type. (compound types are Maps, Structs and Lists/arrays).

Returns:

The DBus type.

Throws:

DBusException - If the given type cannot be converted to a DBus type.

getJavaType

public static int getJavaType(String _dbusType,
                              List<Type> _resultValue,
                              int _limit)
                       throws DBusException

Converts a dbus type string into Java Type objects,

Parameters:

_dbusType - The DBus type or types.

_resultValue - List to return the types in.

_limit - Maximum number of types to parse (-1 == nolimit).

Returns:

number of characters parsed from the type string.

Throws:

DBusException - on error

convertParameters

public static Object[] convertParameters(Object[] _parameters,
                                         Type[] _types,
                                         AbstractConnection _conn)
                                  throws DBusException

Recursively converts types for serialization onto DBus.

Parameters:

_parameters - The parameters to convert.

_types - The (possibly generic) types of the parameters.

_conn - the connection

Returns:

The converted parameters.

Throws:

DBusException - Thrown if there is an error in converting the objects.

deSerializeParameters

public static Object[] deSerializeParameters(Object[] _parameters,
                                             Type[] _types,
                                             AbstractConnection _conn)
                                      throws Exception

Throws:

Exception