[jira] [Commented] (QPID-7095) [Java Broker] Add meta data for context variables describing their usage

2016-03-28 Thread Rob Godfrey (JIRA)

[ 
https://issues.apache.org/jira/browse/QPID-7095?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15214126#comment-15214126
 ] 

Rob Godfrey commented on QPID-7095:
---

{quote}
>From reviewing your changes I take the following:
* yes, my understanding of the intended use of {{@ManagedContextDependency}} is 
correct.
* no, the problem was not that {{doWithAllParents}} considers the type 
hierarchy instead of the model hierarchy
{quote}

Yep... The interesting thing I found when looking into the issue was that 
context defaults defined in {{Broker}} didn't seem to be being processed at 
all... I couldn't determine which change had caused this behaviour.

Separately, on your final point in your original comment:

bq. * While not being directly related to your patch I think I would like to 
see the default values for ManagedAttributes and ManagedContextDefaults in the 
ApiDocs and the MetaData.

I'm in two minds about this - at run time the default value may be overridden 
by a system property (potentially automatically overridden through packaged 
properties files) and obviously at different points in the configuration, the 
context may be overridden.  As such the "default" may be wildly misleading.

I think if we want to display the defaults somewhere, maybe there should be a 
separate page which just shows system context name -> default value or 
something.

> [Java Broker] Add meta data for context variables describing their usage
> 
>
> Key: QPID-7095
> URL: https://issues.apache.org/jira/browse/QPID-7095
> Project: Qpid
>  Issue Type: Improvement
>  Components: Java Broker
>Reporter: Rob Godfrey
>
> Currently there is no way to discover which context variables are used by the 
> broker, and the description of what they do.  We should add meta data 
> covering this and also provide this information through the dynamic API docs.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

-
To unsubscribe, e-mail: dev-unsubscr...@qpid.apache.org
For additional commands, e-mail: dev-h...@qpid.apache.org



[jira] [Commented] (QPID-7095) [Java Broker] Add meta data for context variables describing their usage

2016-03-28 Thread Lorenz Quack (JIRA)

[ 
https://issues.apache.org/jira/browse/QPID-7095?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15214060#comment-15214060
 ] 

Lorenz Quack commented on QPID-7095:


tl;dr: I think this is okay, now! The mechanism is in place but we still need 
to add the actual information.

>From reviewing your changes I take the following:
* yes, my understanding of the intended use of {{@ManagedContextDependency}} is 
correct.
* no, the problem was not that {{doWithAllParents}} considers the type 
hierarchy instead of the model hierarchy

I found the last point a bit confusing because the declaration of a default 
context variable is a global operation while overriding/setting it is a local 
operation only affecting children in the model hierarchy. The code under review 
is only concerned with the declaration part not with the setting therefore 
considering the type hierarchy is fine as long as all are processed eventually.



> [Java Broker] Add meta data for context variables describing their usage
> 
>
> Key: QPID-7095
> URL: https://issues.apache.org/jira/browse/QPID-7095
> Project: Qpid
>  Issue Type: Improvement
>  Components: Java Broker
>Reporter: Rob Godfrey
>
> Currently there is no way to discover which context variables are used by the 
> broker, and the description of what they do.  We should add meta data 
> covering this and also provide this information through the dynamic API docs.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

-
To unsubscribe, e-mail: dev-unsubscr...@qpid.apache.org
For additional commands, e-mail: dev-h...@qpid.apache.org



[jira] [Commented] (QPID-7095) [Java Broker] Add meta data for context variables describing their usage

2016-03-27 Thread ASF subversion and git services (JIRA)

[ 
https://issues.apache.org/jira/browse/QPID-7095?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15213598#comment-15213598
 ] 

ASF subversion and git services commented on QPID-7095:
---

Commit 1736810 from [~godfrer] in branch 'java/trunk'
[ https://svn.apache.org/r1736810 ]

QPID-7095 : Ensure Broker context defaults are processed, and that unresolved 
context dependencies are determined only at the completion of processing

> [Java Broker] Add meta data for context variables describing their usage
> 
>
> Key: QPID-7095
> URL: https://issues.apache.org/jira/browse/QPID-7095
> Project: Qpid
>  Issue Type: Improvement
>  Components: Java Broker
>Reporter: Rob Godfrey
>
> Currently there is no way to discover which context variables are used by the 
> broker, and the description of what they do.  We should add meta data 
> covering this and also provide this information through the dynamic API docs.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

-
To unsubscribe, e-mail: dev-unsubscr...@qpid.apache.org
For additional commands, e-mail: dev-h...@qpid.apache.org



[jira] [Commented] (QPID-7095) [Java Broker] Add meta data for context variables describing their usage

2016-03-25 Thread Lorenz Quack (JIRA)

[ 
https://issues.apache.org/jira/browse/QPID-7095?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15211972#comment-15211972
 ] 

Lorenz Quack commented on QPID-7095:


Hi Rob,
I just reviewed your patch.

* I am not sure I understand the intended use of the 
{{@ManagedContextDependency}} annotation which is currently unused. Is it that 
we can annotate a class and declare the usage of context variables that are 
define else where? For example the context variable 
{{qpid.security.tls.protocolWhiteList}} is defined as a 
{{ManagedContextDefault}} on the {{Broker}}. The {{Port}} interface would then 
be annotated with 
{{@ManagedContextDependency(value=\{"qpid.security.tls.protocolWhiteList"})}} 
and this would cause the context variable to show up in the ApiDocs for both 
the {{Broker}} as well as the {{Port}}. If that is the intended purpose then I 
don't think it is currently working. The problem is that 
{{ConfiguredObjectTypeRegistry#doWithAllParents}} considers the Java type 
hierarchy and not the Qpid model hierarchy when traversing the parents. So a 
context variable defined on the {{Broker}} will not be detected by the {{Port}}.
* While not being directly related to your patch I think I would like to see 
the default values for {{ManagedAttributes}} and {{ManagedContextDefaults}} in 
the ApiDocs and the MetaData.

> [Java Broker] Add meta data for context variables describing their usage
> 
>
> Key: QPID-7095
> URL: https://issues.apache.org/jira/browse/QPID-7095
> Project: Qpid
>  Issue Type: Improvement
>  Components: Java Broker
>Reporter: Rob Godfrey
>
> Currently there is no way to discover which context variables are used by the 
> broker, and the description of what they do.  We should add meta data 
> covering this and also provide this information through the dynamic API docs.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

-
To unsubscribe, e-mail: dev-unsubscr...@qpid.apache.org
For additional commands, e-mail: dev-h...@qpid.apache.org



[jira] [Commented] (QPID-7095) [Java Broker] Add meta data for context variables describing their usage

2016-03-21 Thread ASF subversion and git services (JIRA)

[ 
https://issues.apache.org/jira/browse/QPID-7095?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15204037#comment-15204037
 ] 

ASF subversion and git services commented on QPID-7095:
---

Commit 1735943 from [~godfrer] in branch 'java/trunk'
[ https://svn.apache.org/r1735943 ]

QPID-7095 : Add ability to describe context variables usage through meta data

> [Java Broker] Add meta data for context variables describing their usage
> 
>
> Key: QPID-7095
> URL: https://issues.apache.org/jira/browse/QPID-7095
> Project: Qpid
>  Issue Type: Improvement
>  Components: Java Broker
>Reporter: Rob Godfrey
>
> Currently there is no way to discover which context variables are used by the 
> broker, and the description of what they do.  We should add meta data 
> covering this and also provide this information through the dynamic API docs.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

-
To unsubscribe, e-mail: dev-unsubscr...@qpid.apache.org
For additional commands, e-mail: dev-h...@qpid.apache.org