Max Pfingsthorn wrote:

Hi everyone!

Sorry that I haven't touched base for so long, but I am pretty busy... I've 
been working on Slide a lot and I've been implementing yet another Schema to 
CForms transformation, both for my wonderful employer.

Is the schema to CForms something that could be contributed? That would be really great!

Anyway, I've finally found some time to write some more code and now I've come 
across these few things... I thought it would be nice to get some input from 
you guys:

1. Macro expansion, at library-build-time, definition-build-time or 
instance-build-time? I guess this is a performance thing, both ways: Takes more time 
to instantiate a form, but if a library deep in the inclusion tree changes, you don't 
have to reload all levels on top. Kinda want to avoid what bothers me the most with 
<xsl:include>...

I would avoid if possible instance-build-time for performance reasons. About reload management, there could be a kind of include tracker where all includes files are registered.

2. Macro inheritance? I would imagine something like:

<fd:macro define="mymacro">
  <fd:field id="field">
    <fd:label>mylabel</fd:label>
  </fd:field>
</fd:macro>

<fd:macro define="mysecondmacro" extends="mymacro">
  <fd:field id="firstname" replaces="field">
    <fd:label>firstname</fd:label>
  </fd:field>
  <fd:field id="lastname">
    <fd:label>lastname</fd:label>
  </fd:field>
</fd:macro>

Instead of "replaces", I could think of (goes for library-level reuse too):
- replaces: well, completely replace other widget
- base: make a new widget alongside the other one, but take the other as a base
- extends: elaborate on the definition of the other widget, no new widgets 
created

I may have missed something, but this "replace" thing seems to me to introduce way too much complexity. If you make the analogy with classes, a subclass cannot remove a method of its parent class and replace it with something else. It can however overload it to provide more, while still respecting the contract of the parent class.

BTW, macros don't seem to me very different from other container widgets such as repeater or even form, and this behaviour should actually be consistent among all container types.

<fd:macro expand="mysecondmacro"/> would give:

<fd:field id="firstname">
 <fd:label>firstname</fd:label>
</fd:field>
<fd:field id="lastname">
 <fd:label>lastname</fd:label>
</fd:field>

I think we can implement rules for everything the DefinitionBuilders do for 
inheritance (i.e. by defining a label, it replaces the old one, and by defining 
a static selection list it extends the old one, etc...) inside the specific 
DefinitionBuilders. They should do the parsing/setting of the definition 
objects, but the validation should be up to the definition itself. This way, we 
can have partial definitions present in the library objects ready for extension 
and use at the same time.

Makes sense. A definition should check its consistency and completeness on the first call to createInstance().

3. The wiki page said, there was support for parameterized macros, but I don't 
see it... Any pointers?

Hmm... what about considering parameter-less macros for now? ;-)

4. Library object: Should it be a standalone thing or rather a 
AbstractContainerDefinition (like in the whiteboard code)? I don't see the big 
use of it being a widget yet...

Me neither. Furthermore considering that it doesn't really make sense to instanciate a library!

5. Deep copying of widget definitions: This needs to be possible to keep the 
definitions stored in the libraries intact. This might be a hassle, especially 
with selection lists and all that extra stuff. Does anyone have an idea how to 
do this without implementing it for every widget?

What do you mean by "deep copying"? Is it copying in a definition the elements that are reused from the definition it extends? I don't think it should be deep: since a definition is immutable, just copying the needed information from the extended definition should be enough.

And to avoid typing too much code, you can use the nice BeanUtils class [1], either using copyProperties() or iterating on copyProperty() using a class-specific list of properties to be copied.

I am looking forward to some input!

By the way, I know I am behind... But it is still a "long" time to September 
1st, so I might just make it. Next weekend should be free (finally), so I'll be coding 
then. It would be great if we could address some of the issues above before that so I can 
dive in big time ;)

Hope this helps!

Sylvain

[1] http://jakarta.apache.org/commons/beanutils/apidocs/org/apache/commons/beanutils/BeanUtils.html

--
Sylvain Wallez                        Anyware Technologies
http://people.apache.org/~sylvain     http://www.anyware-tech.com
Apache Software Foundation Member     Research & Technology Director

Reply via email to