Net::DBus::Binding::InUserpContributed PerlNet::DBus::Binding::Introspector(3)NAMENet::DBus::Binding::Introspector - Handler for object introspection
data
SYNOPSIS
# Create an object populating with info from an
# XML doc containing introspection data.
my $ins = Net::DBus::Binding::Introspector->new(xml => $data);
# Create an object, defining introspection data
# programmatically
my $ins = Net::DBus::Binding::Introspector->new(object_path => $object->get_object_path);
$ins->add_method("DoSomething", ["string"], [], "org.example.MyObject");
$ins->add_method("TestSomething", ["int32"], [], "org.example.MyObject");
DESCRIPTION
This class is responsible for managing introspection data, and
answering questions about it. This is not intended for use by
application developers, whom should instead consult the higher level
API in Net::DBus::Exporter.
METHODS
my $ins = Net::DBus::Binding::Introspector->new(object_path =>
$object_path, xml => $xml);
Creates a new introspection data manager for the object registered
at the path specified for the "object_path" parameter. The optional
"xml" parameter can be used to pre-load the manager with
introspection metadata from an XML document.
$ins->add_interface($name)
Register the object as providing an interface with the name $name
my $bool = $ins->has_interface($name)
Return a true value if the object is registered as providing an
interface with the name $name; returns false otherwise.
my @interfaces = $ins->has_method($name, [$interface])
Return a list of all interfaces provided by the object, which
contain a method called $name. This may be an empty list. The
optional $interface parameter can restrict the check to just that
one interface.
my $boolean = $ins->is_method_allowed($name[, $interface])
Checks according to whether the remote caller is allowed to invoke
the method $name on the object associated with this introspector.
If this object has 'strict exports' enabled, then only explicitly
exported methods will be allowed. The optional $interface parameter
can restrict the check to just that one interface. Returns a non-
zero value if the method should be allowed.
my @interfaces = $ins->has_signal($name)
Return a list of all interfaces provided by the object, which
contain a signal called $name. This may be an empty list.
my @interfaces = $ins->has_property($name)
Return a list of all interfaces provided by the object, which
contain a property called $name. This may be an empty list. The
optional $interface parameter can restrict the check to just that
one interface.
$ins->add_method($name, $params, $returns, $interface, $attributes,
$paramnames, $returnnames);
Register the object as providing a method called $name accepting
parameters whose types are declared by $params and returning values
whose type are declared by $returns. The method will be scoped to
the inteface named by $interface. The $attributes parameter is a
hash reference for annotating the method. The $paramnames and
$returnames parameters are a list of argument and return value
names.
$ins->add_signal($name, $params, $interface, $attributes);
Register the object as providing a signal called $name with
parameters whose types are declared by $params. The signal will be
scoped to the inteface named by $interface. The $attributes
parameter is a hash reference for annotating the signal.
$ins->add_property($name, $type, $access, $interface, $attributes);
Register the object as providing a property called $name with a
type of $type. The $access parameter can be one of "read", "write",
or "readwrite". The property will be scoped to the inteface named
by $interface. The $attributes parameter is a hash reference for
annotating the signal.
my $boolean = $ins->is_method_deprecated($name, $interface)
Returns a true value if the method called $name in the interface
$interface is marked as deprecated
my $boolean = $ins->is_signal_deprecated($name, $interface)
Returns a true value if the signal called $name in the interface
$interface is marked as deprecated
my $boolean = $ins->is_property_deprecated($name, $interface)
Returns a true value if the property called $name in the interface
$interface is marked as deprecated
my $boolean = $ins->does_method_reply($name, $interface)
Returns a true value if the method called $name in the interface
$interface will generate a reply. Returns a false value otherwise.
my @names = $ins->list_interfaces
Returns a list of all interfaces registered as being provided by
the object.
my @names = $ins->list_methods($interface)
Returns a list of all methods registered as being provided by the
object, within the interface $interface.
my @names = $ins->list_signals($interface)
Returns a list of all signals registered as being provided by the
object, within the interface $interface.
my @names = $ins->list_properties($interface)
Returns a list of all properties registered as being provided by
the object, within the interface $interface.
my @paths = $self->list_children;
Returns a list of object paths representing all the children of
this node.
my $path = $ins->get_object_path
Returns the path of the object associated with this introspection
data
my @types = $ins->get_method_params($interface, $name)
Returns a list of declared data types for parameters of the method
called $name within the interface $interface.
my @types = $ins->get_method_param_names($interface, $name)
Returns a list of declared names for parameters of the method
called $name within the interface $interface.
my @types = $ins->get_method_returns($interface, $name)
Returns a list of declared data types for return values of the
method called $name within the interface $interface.
my @types = $ins->get_method_return_names($interface, $name)
Returns a list of declared names for return values of the method
called $name within the interface $interface.
my @types = $ins->get_signal_params($interface, $name)
Returns a list of declared data types for values associated with
the signal called $name within the interface $interface.
my @types = $ins->get_signal_param_names($interface, $name)
Returns a list of declared names for values associated with the
signal called $name within the interface $interface.
my $type = $ins->get_property_type($interface, $name)
Returns the declared data type for property called $name within the
interface $interface.
my $bool = $ins->is_property_readable($interface, $name);
Returns a true value if the property called $name within the
interface $interface can have its value read.
my $bool = $ins->is_property_writable($interface, $name);
Returns a true value if the property called $name within the
interface $interface can have its value written to.
my $xml = $ins->format([$obj])
Return a string containing an XML document representing the state
of the introspection data. The optional $obj parameter can be an
instance of Net::DBus::Object to include object specific
information in the XML (eg child nodes).
my $xml_fragment = $ins->to_xml
Returns a string containing an XML fragment representing the state
of the introspection data. This is basically the same as the
"format" method, but without the leading doctype declaration.
$type = $ins->to_xml_type($type)
Takes a text-based representation of a data type and returns the
compact representation used in XML introspection data.
$ins->encode($message, $type, $name, $direction, @args)
Append a set of values <@args> to a message object $message. The
$type parameter is either "signal" or "method" and $direction is
either "params" or "returns". The introspection data will be
queried to obtain the declared data types & the argument
marshalling accordingly.
my @args = $ins->decode($message, $type, $name, $direction)
Unmarshalls the contents of a message object $message. The $type
parameter is either "signal" or "method" and $direction is either
"params" or "returns". The introspection data will be queried to
obtain the declared data types & the arguments unmarshalled
accordingly.
AUTHOR
Daniel P. Berrange
COPYRIGHT
Copyright (C) 2004-2011 Daniel P. Berrange
SEE ALSO
Net::DBus::Exporter, Net::DBus::Binding::Message
perl v5.16.32011-06-3Net::DBus::Binding::Introspector(3)