assert !targetPath.endsWith("/") : "targetPath must not end with a '/'";

        // parse the spec dd

        String specDD = null;

        try {

            if (specDDUrl == null) {

                specDDUrl = JarUtils.createJarURL(moduleFile, "WEB-INF/web.xml");

            }

            // read in the entire specDD as a string, we need this for getDeploymentDescriptor

            // on the J2ee management object

            specDD = JarUtils.readAll(specDDUrl);

            // we found web.xml, if it won't parse that's an error.

            XmlObject parsed = XmlBeansUtil.parse(specDD);

            WebAppDocument webAppDoc = SchemaConversionUtils.convertToServletSchema(parsed);

            webApp = webAppDoc.getWebApp();

            WebDeploymentValidationUtils.validateWebApp(webApp);

        } catch (XmlException e) {

            // Output the target path in the error to make it clearer to the user which webapp

            // has the problem.  The targetPath is used, as moduleFile may have an unhelpful

            // value such as C:\geronimo-1.1\var\temp\geronimo-deploymentUtil22826.tmpdir

            throw new DeploymentException("Error parsing web.xml for " + targetPath, e);

        } catch (Exception e) {

            if (!moduleFile.getName().endsWith(".war")) {

                //not for us

                return null;

            }

            //else ignore as jee5 allows optional spec dd for .war's

        }

        if (webApp == null) {

            webApp = WebAppType.Factory.newInstance();

        }

        Deployable deployable = new DeployableJarFile(moduleFile);

        // parse vendor dd

        boolean standAlone = earEnvironment == null;

        JettyWebAppType jettyWebApp = getJettyWebApp(plan, deployable, standAlone, targetPath, webApp);

        contextRoot = getContextRoot(jettyWebApp, contextRoot, webApp, standAlone, moduleFile, targetPath);

        EnvironmentType environmentType = jettyWebApp.getEnvironment();

        Environment environment = EnvironmentBuilder.buildEnvironment(environmentType, defaultEnvironment);

            clusteringBuilders.buildEnvironment(jettyWebApp, environment);

        }

        if (!standAlone && COMBINED_BUNDLE) {

            EnvironmentBuilder.mergeEnvironments(earEnvironment, environment);

        EARContext moduleContext = module.getEarContext();

        AbstractName moduleName = module.getModuleName();

        WebModule webModule = (WebModule) module;

        JettyWebAppType jettyWebApp = (JettyWebAppType) webModule.getVendorDD();

        GBeanData webModuleData = new GBeanData(moduleName, WebAppContextWrapper.class);

        configureBasicWebModuleAttributes(webApp, jettyWebApp, moduleContext, earContext, webModule, webModuleData);

        // unsharableResources, applicationManagedSecurityResources

        GBeanResourceEnvironmentBuilder rebuilder = new GBeanResourceEnvironmentBuilder(webModuleData);

        //N.B. use earContext not moduleContext

        //TODO fix this for javaee 5 !!!

        try {

            moduleContext.addGBean(webModuleData);

            // configure WebAppContextManager with right priority so that it starts last

            AbstractName contextManagerName = earContext.getNaming().createChildName(moduleName, "WebAppContextManager", NameFactory.SERVICE_MODULE);

            GBeanData contextManagerGBean = new GBeanData(contextManagerName, WebAppContextManager.class);

            contextManagerGBean.setPriority(100);

            contextManagerGBean.setReferencePattern("webApp", moduleName);

            moduleContext.addGBean(contextManagerGBean);

            // configure hosts and virtual-hosts

            configureHosts(earContext, jettyWebApp, webModuleData);

            String contextPath = webModule.getContextRoot();

            if (contextPath == null) {

                throw new DeploymentException("null contextPath");

            }

            if (!contextPath.startsWith("/")) {

                contextPath = "/" + contextPath;

            }

            webModuleData.setAttribute("contextPath", contextPath);

            if (jettyWebApp.isSetWorkDir()) {

                String workDir = jettyWebApp.getWorkDir();

                webModuleData.setAttribute("workDir", workDir);

            }

            if (jettyWebApp.isSetWebContainer()) {

                AbstractNameQuery webContainerName = ENCConfigBuilder.getGBeanQuery(GBeanInfoBuilder.DEFAULT_J2EE_TYPE, jettyWebApp.getWebContainer());

                webModuleData.setReferencePattern("JettyContainer", webContainerName);

            } else {

                webModuleData.setReferencePattern("JettyContainer", jettyContainerObjectName);

            }

            //stuff that jetty used to do

            }

            // configure context parameters.

            configureContextParams(webApp, webModuleData);

            // configure listeners.

            configureListeners(webApp, webModuleData);

            webModuleData.setAttribute(WebAppContextWrapper.GBEAN_ATTR_SESSION_TIMEOUT,

                            defaultSessionTimeoutSeconds);

            webModuleData.setAttribute("distributable", distributable);

            if (TRUE == distributable) {

                clusteringBuilders.build(jettyWebApp, earContext, moduleContext);

                if (webModuleData.getReferencePatterns(WebAppContextWrapper.GBEAN_REF_SESSION_HANDLER_FACTORY) == null) {

                    log.warn("No clustering builders configured: app will not be clustered");

                    configureNoClustering(moduleContext, webModuleData);

                }

            } else {

                configureNoClustering(moduleContext, webModuleData);

            }

            // configure mime mappings.

            configureMimeMappings(webApp, webModuleData);

            // configure welcome file lists.

            configureWelcomeFileLists(webApp, webModuleData);

            // configure local encoding mapping lists.

            configureLocaleEncodingMappingLists(webApp, webModuleData);

            // configure error pages.

            configureErrorPages(webApp, webModuleData);

            // configure tag libs.

            Set<String> knownServletMappings = new HashSet<String>();

            Set<String> knownJspMappings = new HashSet<String>();

            Map<String, Set<String>> servletMappings = new HashMap<String, Set<String>>();

            if (jspServlet != null) {

                configureTagLibs(module, webApp, webModuleData, servletMappings, knownJspMappings, jspServlet.getServletName());

                GBeanData jspServletData = configureDefaultServlet(jspServlet, earContext, moduleName, knownJspMappings);

                knownServletMappings.addAll(knownJspMappings);

                module.getSharedContext().put(DEFAULT_JSP_SERVLET_KEY, jspServletData);

            }

            // configure login configs.

            configureAuthentication(module, webApp, jettyWebApp, webModuleData);

            // Make sure that servlet mappings point to available servlets and never add a duplicate pattern.

            buildServletMappings(module, webApp, servletMappings, knownServletMappings);

            //be careful that the jsp servlet defaults don't override anything configured in the app.

            if (jspServlet != null) {

                GBeanData jspServletData = (GBeanData) module.getSharedContext().get(DEFAULT_JSP_SERVLET_KEY);

                Set<String> jspMappings = (Set<String>) jspServletData.getAttribute("servletMappings");

                jspMappings.removeAll(knownServletMappings);

                jspMappings.addAll(knownJspMappings);

                jspServletData.setAttribute("servletMappings", jspMappings);

            }

            //"previous" filter mapping for linked list to keep dd's ordering.

            AbstractName previous = null;

            //add default filters

            if (defaultFilters != null) {

                previous = addDefaultFiltersGBeans(earContext, moduleContext, moduleName, previous);

            }

            //add default filtermappings

//            if (defaultFilterMappings != null) {

//                for (Iterator iterator = defaultFilterMappings.iterator(); iterator.hasNext();) {

//                    Object defaultFilterMapping = iterator.next();

//                    GBeanData filterMappingGBeanData = getGBeanData(kernel, defaultFilterMapping);

//                    String filterName = (String) filterMappingGBeanData.getAttribute("filterName");

//                    ObjectName defaultFilterMappingObjectName;

//                    if (filterMappingGBeanData.getAttribute("urlPattern") != null) {

//                        String urlPattern = (String) filterMappingGBeanData.getAttribute("urlPattern");

//                        defaultFilterMappingObjectName = NameFactory.getWebFilterMappingName(null, null, null, null, filterName, null, urlPattern, moduleName);

//                    } else {

//                        Set servletNames = filterMappingGBeanData.getReferencePatterns("Servlet");

//                        if (servletNames == null || servletNames.size() != 1) {

//                            throw new DeploymentException("Exactly one servlet name must be supplied");

//                        }

//                        ObjectName servletObjectName = (ObjectName) servletNames.iterator().next();

//                        String servletName = servletObjectName.getKeyProperty("name");

//                        defaultFilterMappingObjectName = NameFactory.getWebFilterMappingName(null, null, null, null, filterName, servletName, null, moduleName);

//                    }

//                    filterMappingGBeanData.setName(defaultFilterMappingObjectName);

//                    filterMappingGBeanData.setReferencePattern("JettyFilterMappingRegistration", webModuleName);

//                    moduleContext.addGBean(filterMappingGBeanData);

//                }

//            }

            // add filter mapping GBeans.

            addFilterMappingsGBeans(earContext, moduleContext, moduleName, webApp, previous);

            // add filter GBeans.

            addFiltersGBeans(earContext, moduleContext, moduleName, webApp);

            //add default servlets

            if (defaultServlets != null) {

                addDefaultServletsGBeans(earContext, moduleContext, moduleName, knownServletMappings);

            }

            //set up servlet gbeans.

            addServlets(moduleName, webModule, servletTypes, servletMappings, moduleContext);

            if (jettyWebApp.isSetSecurityRealmName()) {

                configureSecurityRealm(earContext, webApp, jettyWebApp, bundle, webModuleData);

            }

            //See Jetty-386, GERONIMO-3738

            if (jettyWebApp.getCompactPath()) {

                webModuleData.setAttribute("compactPath", Boolean.TRUE);

            }

            //TODO this may definitely not be the best place for this!

            for (ModuleBuilderExtension mbe : moduleBuilderExtensions) {

                mbe.addGBeans(earContext, module, bundle, repository);

            }

            //not truly metadata complete until MBEs have run

                if (INITIAL_WEB_XML_SCHEMA_VERSION.get(earContext.getGeneralData()) >= 2.5f) {

                    String specDeploymentPlan = getSpecDDAsString(webModule);

                    module.setOriginalSpecDD(specDeploymentPlan);

                    earContext.addFile(new URI("./WEB-INF/web.xml"), specDeploymentPlan);

                }

                String url = enumeration.nextElement();

                if (!url.endsWith(".jar")) {

                    continue;

                }

                ZipInputStream in = null;

                try {

                    in = new ZipInputStream(bundle.getEntry(url).openStream());

                    ZipEntry entry;

                    while ((entry = in.getNextEntry()) != null) {

                        if (entry.getName().equals("META-INF/web-fragment.xml")) {

                            webFragmentDocument = (WebFragmentDocument) XmlBeansUtil.parse(in);

                            break;

                        }

                    }

                } catch (IOException e) {

                    logger.error("Fail to parse web-fragment.xml files in jar " + url, e);

                    throw new DeploymentException("Fail to scan web-fragment.xml files", e);

                } catch (XmlException e) {

                    logger.error("Fail to parse web-fragment.xml files in jar " + url, e);

                    throw new DeploymentException("Fail to scan web-fragment.xml files", e);

                } finally {

                    IOUtils.close(in);

                }

                if (webFragmentDocument == null) {

                    webFragmentDocument = WebFragmentDocument.Factory.newInstance();

                }

                jarUrlWebFragmentDocumentMap.put(url, webFragmentDocument);

            }

            webFragmentEntries = sortWebFragments(earContext, module, bundle, webApp, jarUrlWebFragmentDocumentMap);

        } else {

        }

        //Merge the web fragment and annotations to web.xml

        for (WebFragmentEntry webFragmentEntry : webFragmentEntries) {

            mergeContext.setWebFragmentEntry(webFragmentEntry);

            for (WebFragmentMergeHandler<WebFragmentType, WebAppType> webFragmentMergeHandler : WEB_FRAGMENT_MERGE_HANDLERS) {

                webFragmentMergeHandler.merge(webFragment, webApp, mergeContext);

            }

                mergeAnnotations(bundle, webApp, mergeContext, webFragmentEntry.getJarURL());

            }

        }

        mergeContext.setWebFragmentEntry(null);

        for (WebFragmentMergeHandler<WebFragmentType, WebAppType> webFragmentMergeHandler : WEB_FRAGMENT_MERGE_HANDLERS) {

        boolean absoluteOrderingConfigured = webApp.getAbsoluteOrderingArray().length != 0;

        Set<String> usedWebFragmentNames = new HashSet<String>();

        Map<String, WebFragmentType> unnamedWebFragmentMap = new HashMap<String, WebFragmentType>();

        for (String jarURL : jarURLDocumentMap.keySet()) {

            String webFragmentName = names.length == 0 ? null : names[0].getStringValue();

            if (webFragmentName != null) {

                if (webFragmentEntryMap.containsKey(webFragmentName)) {

                    //TODO Please correct my understanding about how to handle the duplicate web-fragment name (spec 8.2.2)

                    //If absolute-ordering is configured, the web-fragments of the same name are allowed, but only the first occurrence is considered

                    //If relative-ordering is configured, Duplicate name exception: if, when traversing the web-fragments, multiple

                    //members with the same <name> element are encountered, the application must

                    //log an informative error message including information to help fix the

                    //problem, and must fail to deploy. For example, one way to fix this problem is

                    //for the user to use absolute ordering, in which case relative ordering is ignored.

                    //TODO If there is no configuration for absolute-ordering in web.xml and relative-ordering in webfragment.xml files, shall we allowed duplicate names ?

                    if (!absoluteOrderingConfigured) {

                        throw new DeploymentException("Mutiple web-fragments with the same name [" + webFragmentName + "] are found in " + jarURL + " and "

                                + webFragmentEntryMap.get(webFragmentName).getJarURL() + ", you might make the name unique or use absolute ordering in web.xml");

                    }

                } else {

                    webFragmentEntryMap.put(webFragmentName, new WebFragmentEntry(webFragmentName, webFragmentName, webFragment, jarURL));

                }

                usedWebFragmentNames.add(webFragmentName);

            } else {

                unnamedWebFragmentMap.put(jarURL, webFragment);

            }

            //Add names configurations in before/after, so that we would not add an existing name for those unamed web fragment by sudden.

                if (order.getBefore() != null) {

                    for (JavaIdentifierType name : order.getBefore().getNameArray()) {

                        usedWebFragmentNames.add(name.getStringValue());

                    }

                }

                if (order.getAfter() != null) {

                    for (JavaIdentifierType name : order.getAfter().getNameArray()) {

                        usedWebFragmentNames.add(name.getStringValue());

                    }

                }

            }

        }

        //Generate names for all the web fragments which are not explicitly configured

        String tempNamePrefix = "geronimo-deployment";

        int nameSubfix = 0;

        for (String webFragmentURL : unnamedWebFragmentMap.keySet()) {

            String tempWebFragmentName = tempNamePrefix + nameSubfix++;

            while (usedWebFragmentNames.contains(tempWebFragmentName)) {

                tempWebFragmentName = tempNamePrefix + nameSubfix++;

            }

            webFragmentEntryMap.put(tempWebFragmentName, new WebFragmentEntry(tempNamePrefix, null, webFragment, webFragmentURL));

                        // mappedName

                        String mappdedNameAnnotation = annotation.mappedName();

                        if (!mappdedNameAnnotation.equals("")) {

                        }

                        // lookup

                        String lookup = annotation.lookup();

                        if (!lookup.equals("")) {

                        }

                    }

                    catch (Exception anyException) {

                        log.debug("ResourceRefBuilder: Exception caught while processing <resource-ref>");

                    }

            // mappedName

            String mappdedNameAnnotation = annotation.mappedName();

            if (!mappdedNameAnnotation.equals("")) {

            }

           

            // lookup

            String lookup = annotation.lookup();

            if (!lookup.equals("")) {

            }

        }

            // mappedName

            String mappdedNameAnnotation = annotation.mappedName();

            if (!mappdedNameAnnotation.equals("")) {

            }

           

            // lookup

            String lookup = annotation.lookup();

            if (!lookup.equals("")) {

            }

        }

        // persistence-context-properties

        PersistenceProperty[] properties = annotation.properties();

        for (PersistenceProperty property : properties) {

            PropertyType propertyType = persistenceContextRef.addNewPersistenceProperty();

        }

        // injection targets

        if (method != null || field != null) {

            configureInjectionTarget(persistenceContextRef.addNewInjectionTarget(), method, field);

                       

                        // mappedName

                        String mappdedNameAnnotation = annotation.mappedName();

                        if (!mappdedNameAnnotation.equals("")) {

                        }

                        // description

                        String descriptionAnnotation = annotation.description();

                        if (!descriptionAnnotation.equals("")) {

                            DescriptionType description = envEntry.addNewDescription();

                            description.setStringValue(descriptionAnnotation);

                        }

                        // lookup

                        String lookup = annotation.lookup();

                        if (!lookup.equals("")) {

                        }

                    }

                    catch (Exception anyException) {

                        log.debug("ResourceAnnotationHelper: Exception caught while processing <env-entry>");

                    }