org.apache.maven.shared.release.util.PomFinder Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of maven-release-manager Show documentation
There is a newer version: 3.1.1
Show newest version
package org.apache.maven.shared.release.util;

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

import java.io.File;
import java.io.IOException;

import org.apache.maven.model.Model;
import org.apache.maven.model.Parent;
import org.apache.maven.model.io.xpp3.MavenXpp3Reader;
import org.codehaus.plexus.logging.Logger;
import org.codehaus.plexus.util.IOUtil;
import org.codehaus.plexus.util.ReaderFactory;
import org.codehaus.plexus.util.xml.XmlStreamReader;
import org.codehaus.plexus.util.xml.pull.XmlPullParserException;

/**
 * This utility class helps with finding a maven pom file
 * which got parsed previously. It uses the fact that the
 * combination of any parent ids plus the ids of the current
 * pom itself is unique.
 * This is e.g. needed for SCM systems which do not support
 * sparse checkout but only can checkout the repository as whole
 * like e.g. GIT. If the module which we are going to release is
 * not in the parent directory, we first need to search for the
 * 'right' sub directory in this case.
 * subdirectory 
 *
 * Usage:
 * PomFinder is a statefull class. One instance of this class intended
 * for a singular use! You need to create a new instance if you like
 * to search for another pom.
 *   
 *     Parse an origin pom in a given directory with {@link #parsePom(java.io.File)}
 *     This will act as the information about what to search for.
 *   
 *   
 *      Search for the matching pom in a given tree using
 *      {@link #findMatchingPom(java.io.File)}
 *   
 * 
 *
 * @author Mark Struberg
 */
public class PomFinder
{

    private Logger log;
    private PomInfo foundPomInfo;

    public PomFinder( Logger log )
    {
        this.log = log;
    }

    /**
     *
     * @param originPom the pom File which should be used as blueprint for the search
     * @return true if a pom got parsed successfully, false otherwise
     */
    public boolean parsePom( File originPom )
    {
        if ( !originPom.exists() )
        {
            return false;
        }

        try
        {
            foundPomInfo = readPomInfo( originPom );
        }
        catch ( Exception e )
        {
            log.warn( "Error while parsing pom file", e );
            return false;
        }

        return foundPomInfo != null;
    }

    /**
     * Search for the previously with {@link #parsePom(java.io.File)}
     * parsed pom in the given directory.
     * @param startDirectory
     * @return the pom file which matches the previously parsed pom or null
     *         if no matching pom file could have been found.
     */
    public File findMatchingPom( File startDirectory )
    {
        if ( !startDirectory.exists() )
        {
            return null;
        }

        if ( !startDirectory.isDirectory() )
        {
            log.error( "PomFinder must be started with a directory! Got " + startDirectory.getAbsolutePath() );
            return null;
        }

        if ( foundPomInfo == null )
        {
            log.error( "Please run parsePom first!" );
            return null;
        }

        // look for the file in the current directory
        File matchingPom = new File( startDirectory, foundPomInfo.getFileName() );
        if ( matchingPom.exists() )
        {
            PomInfo pi = null;
            try
            {
                pi = readPomInfo( matchingPom );
            }
            catch ( Exception e )
            {
                log.warn( "Error while parsing pom file", e );
                // do nothing, just continue with the search
                // this might happen if a build contains unfinished pom.xml
                // files in integration tests, etc
            }

            if  ( pi == null || !pi.equals( foundPomInfo ) )
            {
                matchingPom = null;
            }
        }
        else
        {
            matchingPom = null;
        }

        if ( matchingPom == null )
        {
            String[] childFiles = startDirectory.list();
            for ( int i = 0; i < childFiles.length; i++ )
            {
                String childFile = childFiles[ i ];

                File subDir = new File( startDirectory, childFile );
                if ( subDir.isDirectory() && !subDir.isHidden() )
                {
                    matchingPom = findMatchingPom( subDir );
                }

                if ( matchingPom != null )
                {
                    break;
                }
            }
        }

        return matchingPom;
    }


    /**
     * Read the {@link PomInfo} from the given pom file
     * @param pomFile pom.xml file
     * @return the PomInfo or null