Shrinkwrap Deployment Descriptors Wiki

Version 16

    Overview

    Unit testing of Java EE applications by using arquillian and shrinkwrap simplifies und speeds up the development process. Skip the build and spend more time on implementation and testing. Arquillian and Shrinkwrap are work nicely together for this work.

     

    But there is a third thing, the Shrinkwrap Descriptor project. For some junit tests, there is no need for deployment descriptors but I believe, most applications require one or even more deployment descriptors. If you need deployment descriptors in your regular application, then you need most probably deployment descriptors in your unit tests as well. Shrinkwrap Descriptor provides exactly this. As easy you can create Java EE archives with Shrinkwrap, you can create distinct deployment descriptors for your unit tests with Shrinkwrap Descriptors.

     

    Goal

    The goal is to provide most of the Java EE deployment descriptors. Each descriptor follows the same API style and allows to manipulate all elements as the specification describes.

     

    API Style

    The API is based a fluent API style as described by M. Fowler.

     

    What is not supported

    Not supported are the order of the elements. This is in the responsibility of the user.  

     

    Examples:

    There is nothing better than examples. Please have a look at the attached examples.

     

    Full API documentation

    A full API documentation can be found here: tbd

     

    Availability of the deployment descriptors:

     

    Java EE 6 Specifications
    Implemented
    Descriptor Name
    application_6.xsdxApplication6Descriptor
    application-client_6.xsd

    beans_1_0.xsdxBeans10Descriptor
    connector_1_6.xsdxConnector16Descriptor
    ejb-jar_3_1.xsdxEjbJar31Descriptor
    javaee_6.xsdx
    javaee_web_services_1_3.xsd

    javaee_web_services_client_1_3.xsd

    jsp_2_2.xsdx
    web-app_3_0.xsdxWebApp30Descriptor
    web-common_3_0.xsdx
    web-fragment_3_0.xsdxWebFragment30Descriptor
    web-facelettaglibrary_2_0.xsd

    web-facesconfig_2_0.xsd

    web-facesuicomponent_2_0.xsd

    web-partialresponse_2_0.xsd

    web-jsptaglibrary_2_1.xsd

    javaee_web_services_metadata_handler_2_0.xsd

    persistence_2_0.xsd
    Persistence20Descriptor



    Java EE 5 SpecificationsJava EE 5 Specifications


     

     

    Java EE 5 Specifications
    Implemented
    Descriptor Name
    application_5.xsdxApplication5Descriptor
    application-client_5.xsd

    ejb-jar_3_0.xsdxEjbJar30Descriptor
    javaee_5.xsdx
    javaee_web_services_1_2.xsd

    javaee_web_services_client_1_2.xsd

    jsp_2_1.xsd

    web-app_2_5.xsd

    web-facesconfig_1_2.xsd

    web-jsptaglibrary_2_1.xs



    web-partialresponse_2_0.xsd

    web-jsptaglibrary_2_1.xsd

    javaee_web_services_metadata_handler_2_0.xsd

     

    Vendor Related Descriptors
    Implemented
    Descriptor Name
    jboss.xml (JBoss 5.1)xJboss51Descriptor