Discussion of two API flavors for the Shrinkwrap Descriptor project

descriptor_API_flavors.txt

Settings filters in a webapp descriptor
---------------------------------------

First Option using up() for jumping back to the parent node:            Second option using type information

String desc = create(WebApp30Descriptor.class)                          String desc = create(WebAppDescriptor.class)
                 .filter()                                                              .filter(type(Filter.class)
                    .setFilterClass("org.dot.clazz")                                       .name("name")
                    .setFilterName("name").up()                                            .className("org.dot.clazz") )
                 .filterMapping()                                                       .filterMapping(type(FilterMapping.class)
                    .setFilterName("name")                                                 .filterName("name")
                    .setUrlPattern("mapping").up()                                         .urlPattern("http://someLink") )
                 .exportAsString();                                                     .exportAsString();

The generation is a one time thing right, so the generation will generate the TypeBuilder's as well, but possible as just empty interfaces.

I think it will be hard to generate the convenience methods for the TypeBuilders, since that is very much up to the type and what is possible based on what other things we have around and information not available in the XSD. So a Type's TypeBuilder can be manually extended as we see fit, but only as helpers for creating a Type.

So to explain from the Example:

// ServletBuilder interface is generated from the XSD as part of the Servlet Type
public interface ServletBuilder extends WebAppTypeBuilder
{
  // The convenience method from() is added manually after generation
  Servlet from(Class<? extends Servlet> servlet);
}

That should give us a fully generated core Model based on the XSD, but with a opening to do manual adjustments to the Type creation.

Hi All

I am after the education trip in the nice Caribbean for two weeks. Sun, beach, everything is beautiful. But I wanted to say that I have my laptop with me and a will proceed with more testing work. I am thinking of a generated test cases to cover more of the functionalities. This is independent of the API discussion. In the meanwhile, the transformation is now integrated into maven. I had to choose a better maven xml plugin.