Consideration how to issue content discovery queries
This commit is contained in:
parent
452e1bb727
commit
007a6e1855
7 changed files with 240 additions and 30 deletions
BIN
doc/devel/uml/fig137733.png
Normal file
BIN
doc/devel/uml/fig137733.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 11 KiB |
|
|
@ -1,6 +1,6 @@
|
|||
format 58
|
||||
"ConfigQuery" // CommonLib::ConfigQuery
|
||||
revision 3
|
||||
revision 4
|
||||
modified_by 5 "hiv"
|
||||
// class settings
|
||||
//class diagram settings
|
||||
|
|
@ -448,6 +448,173 @@ ${inlines}
|
|||
relation_ref 147973 // <association>
|
||||
end
|
||||
end
|
||||
|
||||
classdiagram 137733 "Query Interface"
|
||||
draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
|
||||
size A4
|
||||
end
|
||||
|
||||
class 153989 "QueryResolver"
|
||||
visibility package stereotype "interface"
|
||||
cpp_decl "${comment}${template}class ${name}${inherit}
|
||||
{
|
||||
${members} };
|
||||
${inlines}
|
||||
"
|
||||
java_decl "${comment}${@}${visibility}interface ${name}${extends} {
|
||||
${members}}
|
||||
"
|
||||
php_decl "${comment}${visibility}interface ${name} {
|
||||
${members}}
|
||||
"
|
||||
python_2_2 python_decl ""
|
||||
idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
|
||||
${members}};
|
||||
"
|
||||
explicit_switch_type ""
|
||||
|
||||
end
|
||||
|
||||
class 155141 "Query"
|
||||
visibility package
|
||||
nformals 1
|
||||
formal name "TY" type "class" explicit_default_value ""
|
||||
explicit_extends ""
|
||||
cpp_decl "${comment}${template}class ${name}${inherit}
|
||||
{
|
||||
${members} };
|
||||
${inlines}
|
||||
"
|
||||
java_decl ""
|
||||
php_decl ""
|
||||
python_2_2 python_decl ""
|
||||
idl_decl ""
|
||||
explicit_switch_type ""
|
||||
|
||||
class 155269 "Cursor"
|
||||
visibility package
|
||||
nformals 1
|
||||
formal name "TY" type "class" explicit_default_value ""
|
||||
explicit_extends ""
|
||||
cpp_decl "${comment}${template}class ${name}${inherit}
|
||||
{
|
||||
${members} };
|
||||
${inlines}
|
||||
"
|
||||
java_decl ""
|
||||
php_decl ""
|
||||
python_2_2 python_decl ""
|
||||
idl_decl ""
|
||||
explicit_switch_type ""
|
||||
|
||||
end
|
||||
|
||||
operation 140037 "isValid"
|
||||
public explicit_return_type "bool"
|
||||
nparams 0
|
||||
cpp_decl " ${comment}${friend}${static}${inline}${virtual}${type} ${name} ${(}${)}${const}${volatile} ${throw}${abstract};"
|
||||
cpp_def "${comment}${inline}${type}
|
||||
${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
|
||||
{
|
||||
${body}
|
||||
}
|
||||
|
||||
"
|
||||
|
||||
|
||||
|
||||
|
||||
end
|
||||
|
||||
operation 140165 "nextResult"
|
||||
public return_type class_ref 155269 // Cursor
|
||||
nparams 0
|
||||
cpp_decl " ${comment}${friend}${static}${inline}${virtual}${type} ${name} ${(}${)}${const}${volatile} ${throw}${abstract};"
|
||||
cpp_def "${comment}${inline}${type}
|
||||
${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
|
||||
{
|
||||
${body}
|
||||
}
|
||||
|
||||
"
|
||||
|
||||
|
||||
|
||||
|
||||
end
|
||||
end
|
||||
|
||||
class 155397 "IterAdapter"
|
||||
visibility package
|
||||
cpp_decl "${comment}${template}class ${name}${inherit}
|
||||
{
|
||||
${members} };
|
||||
${inlines}
|
||||
"
|
||||
java_decl ""
|
||||
php_decl ""
|
||||
python_2_2 python_decl ""
|
||||
idl_decl ""
|
||||
explicit_switch_type ""
|
||||
|
||||
end
|
||||
|
||||
class 155525 "ResolvingFacility"
|
||||
visibility package
|
||||
cpp_decl "${comment}${template}class ${name}${inherit}
|
||||
{
|
||||
${members} };
|
||||
${inlines}
|
||||
"
|
||||
java_decl ""
|
||||
php_decl ""
|
||||
python_2_2 python_decl ""
|
||||
idl_decl ""
|
||||
explicit_switch_type ""
|
||||
|
||||
classrelation 179717 // <realization>
|
||||
relation 169733 -_-|>
|
||||
a public
|
||||
cpp default "${type}"
|
||||
classrelation_ref 179717 // <realization>
|
||||
b parent class_ref 153989 // QueryResolver
|
||||
end
|
||||
|
||||
classrelation 179973 // <unidirectional association>
|
||||
relation 169989 --->
|
||||
stereotype "generate"
|
||||
a role_name "" protected
|
||||
cpp default " ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
|
||||
"
|
||||
classrelation_ref 179973 // <unidirectional association>
|
||||
b parent class_ref 155653 // ActualQuery
|
||||
end
|
||||
end
|
||||
|
||||
class 155653 "ActualQuery"
|
||||
visibility package
|
||||
nactuals 1
|
||||
actual class class_ref 155141 // Query
|
||||
rank 0 explicit_value ""
|
||||
cpp_decl "${comment}${template}class ${name}${inherit}
|
||||
{
|
||||
${members} };
|
||||
${inlines}
|
||||
"
|
||||
java_decl ""
|
||||
php_decl ""
|
||||
python_2_2 python_decl ""
|
||||
idl_decl ""
|
||||
explicit_switch_type ""
|
||||
|
||||
classrelation 179845 // <generalisation>
|
||||
relation 169861 ---|>
|
||||
a public
|
||||
cpp default "${type}"
|
||||
classrelation_ref 179845 // <generalisation>
|
||||
b parent class_ref 155141 // Query
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
usecaseview 128389 "query use"
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
format 58
|
||||
"Placement" // ProcessingLayer::MObject::Placement
|
||||
revision 2
|
||||
revision 3
|
||||
modified_by 5 "hiv"
|
||||
// class settings
|
||||
//class diagram settings
|
||||
|
|
@ -201,26 +201,5 @@ ${inlines}
|
|||
b parent class_ref 153989 // QueryResolver
|
||||
end
|
||||
end
|
||||
|
||||
class 153989 "QueryResolver"
|
||||
visibility package stereotype "interface"
|
||||
cpp_decl "${comment}${template}class ${name}${inherit}
|
||||
{
|
||||
${members} };
|
||||
${inlines}
|
||||
"
|
||||
java_decl "${comment}${@}${visibility}interface ${name}${extends} {
|
||||
${members}}
|
||||
"
|
||||
php_decl "${comment}${visibility}interface ${name} {
|
||||
${members}}
|
||||
"
|
||||
python_2_2 python_decl ""
|
||||
idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
|
||||
${members}};
|
||||
"
|
||||
explicit_switch_type ""
|
||||
|
||||
end
|
||||
end
|
||||
end
|
||||
|
|
|
|||
50
uml/lumiera/137733.diagram
Normal file
50
uml/lumiera/137733.diagram
Normal file
|
|
@ -0,0 +1,50 @@
|
|||
format 58
|
||||
|
||||
classcanvas 128005 class_ref 153989 // QueryResolver
|
||||
draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
|
||||
xyz 251 37 2000
|
||||
end
|
||||
classcanvas 128133 class_ref 155141 // Query
|
||||
draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
|
||||
xyz 137 195 2000
|
||||
end
|
||||
classcanvas 128261 class_ref 155269 // Cursor
|
||||
draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
|
||||
xyz 225 271 2004
|
||||
end
|
||||
classcanvas 128517 class_ref 155397 // IterAdapter
|
||||
draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
|
||||
xyz 62 298 2000
|
||||
end
|
||||
classcanvas 128645 class_ref 155525 // ResolvingFacility
|
||||
draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
|
||||
xyz 480 293 2000
|
||||
end
|
||||
classcanvas 129157 class_ref 155653 // ActualQuery
|
||||
draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
|
||||
xyz 386 431 2000
|
||||
end
|
||||
line 128389 ---+
|
||||
from ref 128261 z 1999 to ref 128133
|
||||
relationcanvas 128773 relation_ref 169733 // <realization>
|
||||
geometry VHV
|
||||
from ref 128645 z 1999 to point 526 191
|
||||
line 128901 z 1999 to point 292 191
|
||||
line 129029 z 1999 to ref 128005
|
||||
no_role_a no_role_b
|
||||
no_multiplicity_a no_multiplicity_b
|
||||
end
|
||||
relationcanvas 129285 relation_ref 169861 // <generalisation>
|
||||
geometry VHV
|
||||
from ref 129157 z 1999 to point 420 350
|
||||
line 129413 z 1999 to point 168 350
|
||||
line 129541 z 1999 to ref 128133
|
||||
no_role_a no_role_b
|
||||
no_multiplicity_a no_multiplicity_b
|
||||
end
|
||||
relationcanvas 129669 relation_ref 169989 // <unidirectional association>
|
||||
from ref 128645 z 1999 stereotype "<<generate>>" xyz 469 379 3000 to ref 129157
|
||||
no_role_a no_role_b
|
||||
no_multiplicity_a no_multiplicity_b
|
||||
end
|
||||
end
|
||||
|
|
@ -2,10 +2,12 @@ window_sizes 1302 1004 270 1022 856 71
|
|||
diagrams
|
||||
classdiagram_ref 134021 // Command structure
|
||||
575 622 100 4 0 0
|
||||
active classdiagram_ref 136325 // Focus of Query
|
||||
classdiagram_ref 136325 // Focus of Query
|
||||
582 515 100 4 0 0
|
||||
classdiagram_ref 136581 // MObjectRef
|
||||
651 533 100 4 0 38
|
||||
active classdiagram_ref 137733 // Query Interface
|
||||
688 570 100 4 0 0
|
||||
end
|
||||
show_stereotypes
|
||||
selected
|
||||
|
|
@ -17,16 +19,16 @@ open
|
|||
|
||||
package_ref 128133 // Asset
|
||||
classview_ref 128389 // Controller Workings
|
||||
classview_ref 128005 // Session parts
|
||||
classview_ref 131973 // Object ref
|
||||
class_ref 152069 // PlacementIndex
|
||||
classview_ref 131845 // Scopes
|
||||
|
||||
package_ref 128901 // Builder
|
||||
classview_ref 128261 // Builder Workings
|
||||
usecaseview_ref 128261 // config examples
|
||||
classview_ref 128133 // Engine Workings
|
||||
class_ref 133253 // Frame
|
||||
classview_ref 129541 // InterfaceSystem
|
||||
classview_ref 129285 // StreamType
|
||||
class_ref 153989 // QueryResolver
|
||||
class_ref 155141 // Query
|
||||
classview_ref 132229 // Custom holders
|
||||
classview_ref 128266 // SmartPointers
|
||||
end
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
format 58
|
||||
"lumiera"
|
||||
revision 55
|
||||
revision 56
|
||||
modified_by 5 "hiv"
|
||||
cpp_root_dir "../../src/"
|
||||
|
||||
|
|
|
|||
|
|
@ -3400,7 +3400,7 @@ Viewed as a micro program, the processing patterns are ''weak typed'' &mdash
|
|||
<pre>a given Render Engine configuration is a list of Processors. Each Processor in turn contains a Graph of ProcNode.s to do the acutal data processing. In order to cary out any calculations, the Processor needs to be called with a StateProxy containing the state information for this RenderProcess
|
||||
</pre>
|
||||
</div>
|
||||
<div title="Query" modifier="Ichthyostega" modified="200910171644" created="200910171621" tags="Rules spec draft discuss" changecount="8">
|
||||
<div title="Query" modifier="Ichthyostega" modified="200910210243" created="200910171621" tags="Rules spec draft discuss" changecount="9">
|
||||
<pre>{{red{WIP as of 10/09}}}...//brainstorming about the first ideas towards a query subsystem//
|
||||
|
||||
!use case: discovering the contents of a container in the HighLevelModel
|
||||
|
|
@ -3412,6 +3412,8 @@ In the course of shaping the session API, __joel__ and __ichthyo__ realised that
|
|||
* client code gets a result iterator, which can be explored //only once until exhaustion.//
|
||||
* the handed out result iterator is used to manage the allocation for the query result set by sideeffect (smart handle). &rarr; Ticket #353
|
||||
|
||||
For decoupling the query invocation from the facility actually processing the query, we need to come up with common pattern. In 10/09, there is an immediate demand for such a solution pattern for implementing the QueryFocus and PlacementScope framework, which is crucial for contents discovery in general on the session interface. &rarr; QueryResolver was shaped to deal with this situation, but has the potential to evolve into a general solution for issuing queries.
|
||||
|
||||
----
|
||||
See also the notes on &rarr; QueryImplProlog
|
||||
</pre>
|
||||
|
|
@ -3474,6 +3476,16 @@ Then, running the goal {{{:-resolve(T, stream(T,mpeg)).}}} would search a Track
|
|||
In the design of the Lumiera Proc Layer done thus far, we provide //no possibility to introduce a new object kind// into the system via plugin interface. The system uses a fixed collection of classes intended to cover all needs (Clip, Effect, Track, Pipe, Label, Automation, ~Macro-Clips). Thus, plugins will only be able to provide new parametrisations of existing classes. This should not be any real limitation, because the whole system is designed to achieve most of its functionality by freely combining rather basic object kinds. As a plus, it plays nicely with any plain-C based plugin interface. For example, we will have C++ adapter classes for the most common sorts of effect plugin (pull system and synchronous frame-by-frame push with buffering) with a thin C adaptation layer for the specific external plugin systems used. Everything beyond this point can be considered "condiguration data" (including the actual plugin implementation to be loaded)
|
||||
</pre>
|
||||
</div>
|
||||
<div title="QueryResolver" modifier="Ichthyostega" modified="200910210330" created="200910210300" tags="Rules spec draft img" changecount="2">
|
||||
<pre>Within the Lumiera Proc-Layer, there is a general preference for issuing [[queries|Query]] over hard wired configuration (or even mere table based configuration). This leads to the demand of exposing a //possibility to issue queries// &mdash; without actually disclosing much details of the facility implementing this service. For example, for shaping the general session interface (in 10/09), we need a means of exposing a hook to discover HighLevelModel contents, without disclosing how the model is actually organised internally (namely by using an PlacementIndex).
|
||||
|
||||
!Analysis of the problem
|
||||
The situation can be decomposed as follows.[>img[QueryResolver|uml/fig137733.png]]
|
||||
* first off, we need a way to state //what kind of query we want to run.// This includes stipulations on the type of the result set contents expected
|
||||
* as the requirement is to keep the facility actually implementing the query service hidden behind an interface, we're forced to erase specific type information and pass on an encapsulated version of the query
|
||||
* providing an iterator for exploring the results poses the additional constraint of having an fairly generic iterator type, while still being able to communicate with the actual query implementation behind the interface.
|
||||
</pre>
|
||||
</div>
|
||||
<div title="RSSReaderPlugin" modifier="Ichthyostega" created="200708081515" tags="systemConfig" changecount="1">
|
||||
<pre>/***
|
||||
|''Name:''|RSSReaderPlugin|
|
||||
|
|
|
|||
Loading…
Reference in a new issue