protected static final String getUriOfCactifiedWebModule(EarArchive theEar) throws IOException, SAXException, ParserConfigurationException 
{
        ApplicationXml applicationXml = theEar.getApplicationXml();
        for (Iterator i = applicationXml.getWebModuleUris(); i.hasNext();)
        {
            String webUri = (String) i.next();
            WarArchive war = theEar.getWebModule(webUri);
            if ((war != null) 
                && (WarParser.parseServletRedirectorMapping(war) != null))
            {
                return webUri;
            }
        }
        return null;
}

Finds the web module in the EAR that contains the servlet test redirector, and returns the web-uri of the module found. A web-app is considered cactified when it contains at least a mapping for the Cactus servlet test redirector

 public static final EarDeployableFile parse(File theDeployableFile) 
{
        EarDeployableFile deployable = new EarDeployableFile();
        try
        {
            deployable.setFile(theDeployableFile);
            EarArchive earArchive = new DefaultEarArchive(
                new FileInputStream(theDeployableFile));
            String webUri = getUriOfCactifiedWebModule(earArchive);
            if (webUri == null)
            {
                throw new BuildException("Could not find cactified web "
                    + "module in the [" + theDeployableFile + "] EAR.");
            }
            WarArchive warArchive = earArchive.getWebModule(webUri);
            if (warArchive == null)
            {
                throw new BuildException("Could not find the WAR [" + webUri
                    + "] in the [" + theDeployableFile + "] EAR.");
            }
            deployable.setWarArchive(warArchive);
            deployable.setTestContext(parseTestContext(earArchive, webUri));
            deployable.setServletRedirectorMapping(
                WarParser.parseServletRedirectorMapping(
                    deployable.getWarArchive()));
            deployable.setFilterRedirectorMapping(
                WarParser.parseFilterRedirectorMapping(
                    deployable.getWarArchive()));
            deployable.setJspRedirectorMapping(
                WarParser.parseJspRedirectorMapping(
                    deployable.getWarArchive()));
        }
        catch (IOException e)
        {
            throw new BuildException("Failed to parse deployment descriptor "
                + "for EAR file [" + theDeployableFile + "].", e);
        }
        catch (ParserConfigurationException e)
        {
            throw new BuildException("Failed to parse deployment descriptor "
                + "for EAR file [" + theDeployableFile + "].", e);
        }
        catch (SAXException e)
        {
            throw new BuildException("Failed to parse deployment descriptor "
                + "for EAR file [" + theDeployableFile + "].", e);
        }
        return deployable;
}

Parse an EAR descriptor to extract meaninful information for Cactus.

 protected static final String parseTestContext(EarArchive theEar,
    String theWebUri) throws IOException, SAXException, ParserConfigurationException 
{
        String context = theEar.getApplicationXml()
            .getWebModuleContextRoot(theWebUri);
        if (context == null)
        {
            // The application.xml does not define a < context-root > element.
            // This is wrong!
            throw new BuildException("Your application.xml must define a "
                + "< context-root > element in the < web > module definition.");
        }
        // Remove leading "/" if there is one.
        if (context.startsWith("/"))
        {
            context = context.substring(1);
        }
        return context;
}

Find the test context from the EAR archive.