Kevin Reid: create from javadoc

2011-08-07T03:25:06Z

create from javadoc

New page

'''__optSealedDispatch/1''' is a [[Miranda message]].

{{instance msgdoc|__optSealedDispatch|1|<var>brand</var> :[[Brand]]|[[void]]}}

Generic object-level rights amplification protocol.

Dispatch on the brand much as one would dispatch on a message name. If
we recognize the brand and we have the corresponding sealer, then we may
return something meaningful inside a [[SealedBox]] sealed with that [[Sealer]].
If we have nothing to return, given the meaning we associate with that
brand as a request, then we return null.

Something meaningful? Sounds strange. See [http://www.eros-os.org/pipermail/e-lang/2002-May/006435.html <nowiki>[e-lang]</nowiki> Object coercion / adaptation] and the surrounding thread for more on
the rationale for the design of this method. Note that, at the time of
that discussion, this method was named getOptMeta instead.

The default implementation: return null.

If this object isn't actually transparent, but if <tt>brand</tt>
represents a party this object would like to reveal itself to (such as a
serialization system implementing persistence for this object's
subsystem), then this object can choose to return a [[SealedBox]], sealed by
the by the [[Sealer]] for that brand, containing the same triple that [[Miranda optUncall|__optUncall]] would otherwise have returned. By so doing, the object
reveals its internals only to someone having the corresponding
[[Unsealer]].

[[Category:Miranda messages]]

Miranda optSealedDispatch - Revision history

Kevin Reid: create from javadoc