org.freedesktop.dbus

Class StructHelper

java.lang.Object

org.freedesktop.dbus.StructHelper

public class StructHelper
extends Object

Helper util to create Struct subclasses when receiving it from DBus.

Since:

v3.2.1 - 2019-10-25

Author:

David M.

Method Summary

Modifier and Type	Method and Description
static <T extends Struct> T	createStruct(Class<?>[] _constructorArgs, Object _values, Class<T> _classToConstruct) Will create a new Struct subclass instance if possible.
static <T extends Struct> T	createStructFromVariant(Variant<?> _variant, Class<T> _structClass) Creates a instance of the given Struct subclass if the given variant is some sort of Struct.

Methods inherited from class java.lang.Object

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

Method Detail

createStructFromVariant

public static <T extends Struct> T createStructFromVariant(Variant<?> _variant,
                                                           Class<T> _structClass)
                                                    throws NoSuchMethodException,
                                                           SecurityException,
                                                           InstantiationException,
                                                           IllegalAccessException,
                                                           IllegalArgumentException,
                                                           InvocationTargetException

Creates a instance of the given Struct subclass if the given variant is some sort of Struct.

Parameters:

_variant - variant to convert

_structClass - Struct subclass to create

Returns:

instance of _structClass or null if _variant is not Struct compatible or any input parameter is null

Throws:

NoSuchMethodException - when no constructor can be found for the arguments of the struct

SecurityException - when constructor cannot be accesses

InstantiationException - when reflection fails

IllegalAccessException - if this Constructor object is enforcing Java language access control and the underlying constructor is inaccessible.

IllegalArgumentException - when data types are incompatible

InvocationTargetException - if the underlying constructor throws an exception

createStruct

public static <T extends Struct> T createStruct(Class<?>[] _constructorArgs,
                                                Object _values,
                                                Class<T> _classToConstruct)
                                         throws NoSuchMethodException,
                                                SecurityException,
                                                InstantiationException,
                                                IllegalAccessException,
                                                IllegalArgumentException,
                                                InvocationTargetException

Will create a new Struct subclass instance if possible. May replace Wrapper-classes with primitive classes in _constructorArgs if constructor does not match.

Parameters:

_constructorArgs - argument-classes expected by constructor

_values - values passed to the constructor

_classToConstruct - Struct subclass to instantiate

Returns:

instance of _classToConstruct or null if any input argument is null

Throws:

NoSuchMethodException - when no constructor can be found for the arguments of the struct

SecurityException - when constructor cannot be accesses

InstantiationException - when reflection fails

IllegalAccessException - if this Constructor object is enforcing Java language access control and the underlying constructor is inaccessible.

IllegalArgumentException - when data types are incompatible

InvocationTargetException - if the underlying constructor throws an exception