Kevin Reid at 02:32, 13 February 2011

Kevin Reid — Sun, 13 Feb 2011 02:32:40 GMT

New page

An [[uncaller]] generates [[portrayal]]s of objects.

Uncallers are used by [[deSubgraphKit]] to convert each object in the graph being serialized into its serializable portrayal.

Original javadoc ({{XXX|Integrate}}):

If <tt>obj</tt> is neither a bare string nor a scalar, and is transparent to
<i>this Uncaller</i>, then <tt>uncaller.optUncall(obj)</tt> returns a triple
corresponding to the three arguments of E.call/3:<ul> <li>The receiver
<li>The "verb", ie, the message name to call with <li>The list of arguments
</ul> Alternatively, uncall may return null to indicate that obj was not
uncallable by this uncall function.

'''FQN''': <code>org.erights.e.elib.serial.Uncaller</code>

==Protocol==

{{instance msgdoc|optUncall|1|<var>obj</var>|{{sub|[[nullOK]]|[[Portrayal]]}}}}

Returns a portrayal for <var>obj</var>, or [[null]] if this uncaller does not handle the provided object.

Original javadoc ({{XXX|Integrate}}):

Returns a description of the call that would reconstruct the argument
object.

The reconstructing call would proceed not with the elements of this
description, but with reconstructions of the elements of this
description. Return null to indicate that this Uncaller has no
description to offer, in which case another one may be tried.

If a description triple is returned, the elements of this triple must
not provide any further authority beyond that held by a client who
already has both this <tt>Uncaller</tt> and <tt>obj</tt>. In particular,
if this Uncaller is an authority-diminishing facet on a more powerful
Uncaller, then this facet may chose to implements its {{msg|optUncall/1}} in
terms of the underlying's {{msg|optUncall/1}}. It so, it had better be very
careful to re-diminish the result before returning it. See [[BaseLoader#getOptWrappingUncall/4]] for a convenience to help write such
wrappers.

@return :nullOk[Tuple[any, String, List]]; either null or a 3-element list of<ul> <li>a receiver object whose reconstruction would
receive the message <li>a String, which is the name of the
message to call <li>a list of arguments, whose reconstruction
are the actual arguments to the call. </ul>

Uncaller - Revision history

Kevin Reid at 02:32, 13 February 2011