Kevin Reid at 03:08, 7 August 2011

Kevin Reid — Sun, 07 Aug 2011 03:08:27 GMT

New page

'''__whenBroken/1''' is a [[Miranda message]] for determining when a reference has become a [[broken reference]].

{{instance msgdoc|__whenBroken|1|<var>reactor</var> :[[OneArgFunc]]|[[void]]}}

Notify the <var>reactor</var> when the reference has transitioned to the [[broken]] state.

* The Miranda method ignores the argument and returns null, as a near reference cannot become broken.
* If the recipient is an [[eventual ref]], then the message should not be forwarded, but the reactor should be stored for use as follows. (This forms part of the expected behavior of any [[proxy]] handler.)
** If it becomes broken, <code><var>reactor</var> <- run(<var>problem</var>)</code> should be performed for every __whenBroken message previously received.
** If it becomes resolved to another ref, then it should forward every __whenBroken message it received to the target.

==Original Javadoc==

{{XXX|merge}}

Used to implement "Ref whenBroken/2"; it should not be called directly.

The Miranda behavior ignores the message, as only breakable ref
implementations ever respond to this message.

See also: [[Ref#whenBroken/2]]

==Tests==

{{XXX|Write tests}}

[[Category:Miranda messages]]
[[Category:Pluribus]]

Miranda whenBroken - Revision history

Kevin Reid at 03:08, 7 August 2011