beehive-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Jeremiah Johnson (JIRA)" <>
Subject [jira] Reopened: (BEEHIVE-917) Controls Programming leaves off @ControlImplementation
Date Mon, 12 Sep 2005 16:26:30 GMT
     [ ]
Jeremiah Johnson reopened BEEHIVE-917:

     Assign To: Steve Hanson  (was: Jeremiah Johnson)

There are two examples that I think were missed:

Section 12.1 (Composition Using Declarative Instantiation) has a control implementation example
that I think could cause confusion if left as is.  If you agree, please replace 'public class
OrderRouterImpl' with @ControlImplementation public class OrderRouterImpl implements OrderRouter.
 The same issue exists in the example in Section 12.1.1 (Composition using Programmatic Mechanisms).

In both of those examples, a Controls container is expected (first uses @Control and second
uses @Context), so I think that it is important to be consistent and mark these as ControlImplementations.

> Controls Programming leaves off @ControlImplementation
> ------------------------------------------------------
>          Key: BEEHIVE-917
>          URL:
>      Project: Beehive
>         Type: Bug
>   Components: Documentation
>  Environment: going through docs on dist built from SVN 279793
>     Reporter: Jeremiah Johnson
>     Assignee: Steve Hanson
>     Priority: Minor
>      Fix For: V1

> In Section 5 of Controls Programming (trunk/docs/forrest/release/src/documentation/context/xdocs/controls/programming.xml),
it doesn't mention the ControlImplementation annotation.  The Control Implementation Class
example doesn't use the annotation.  The text should be updated to speak of the annotation
and the example should use it.
> --- current text
> The only basic rule for a Control Implementation Class is that it must always implement
the associated Control Public Interface.
> --- change that to something like this
> The basic rules for a Control Implementation Class are that it must be annotated with
ControlImplementation and it must implement the associated Control Public Interface.
> ---
> Don't forget to update the example.  The example source as it is will compile, but if
a person were walking through the document and attempted instantiation of their new control
(Section 6) it would fail at runtime with 'ControlImplementation is missing from control implementation

This message is automatically generated by JIRA.
If you think it was sent incorrectly contact one of the administrators:
For more information on JIRA, see:

View raw message