maven-scm-api/src/main/java/org/apache/maven/scm/ScmFileSet.java

package org.apache.maven.scm;

/*
 * Copyright 2001-2006 The Apache Software Foundation.
 *
 * Licensed 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 java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

import org.codehaus.plexus.util.FileUtils;

/**
 * Set of files used for SCM operations.
 * Consists of the base directory of the files and a list of files relative to that directory.
 * 
 * @author <a href="mailto:brett@apache.org">Brett Porter</a>
 * @version $Id$
 */
public class ScmFileSet
{
    private static final String DEFAULT_EXCLUDES = "**/CVS/**,**/.svn/**";

    private File basedir;

    /**
     * List of File objects, all relative to the basedir.
     */
    private List files = new ArrayList( 0 );

    /**
     * Create a file set with no files, only the base directory.
     * 
     * @param basedir directory files in the set are relative to
     */
    public ScmFileSet( File basedir )
    {
        this( basedir, new ArrayList( 0 ) );
    }

    /**
     * Create a file set with only the file provided, relative to basedir.
     * 
     * @param basedir directory file is relative to
     * @param file file that the set will contain, has to be relative to basedir 
     */
    public ScmFileSet( File basedir, File file )
    {
        this( basedir, new File[]{file} );
    }

    /**
     * Create a file set with only files (not directories) from basefile,
     * using includes and excludes provided.
     * 
     * @param basedir directory files are relative to
     * @param includes Ant pattern for files to include 
     * @param excludes Ant pattern for files to exclude,
     *        if null DEFAULT_EXCLUDES is used, else DEFAULT_EXCLUDES is added.
     * @throws IOException
     */
    public ScmFileSet( File basedir, String includes, String excludes )
        throws IOException
    {
        this.basedir = basedir;

        if ( excludes != null && excludes.length() > 0 )
        {
            excludes += "," + DEFAULT_EXCLUDES;
        }
        else
        {
            excludes = DEFAULT_EXCLUDES;
        }

        this.files = FileUtils.getFiles( basedir, includes, excludes, false );
    }

    /**
     * Create a file set with files from basefile, using includes provided and default excludes.
     * 
     * @param basedir directory files are relative to
     * @param includes Ant pattern for files to include 
     * @throws IOException
     * @since 1.0
     */
    public ScmFileSet( File basedir, String includes )
        throws IOException
    {
        this( basedir, includes, null );
    }

    /**
     * Create a file set with the files provided, relative to basedir.
     * 
     * @deprecated use ScmFileSet( File, List )
     * 
     * @param basedir directory files are relative to
     * @param files files that the set will contain, have to be relative to basedir 
     */
    public ScmFileSet( File basedir, File[] files )
    {
        this( basedir, Arrays.asList( files ) );
    }

    /**
     * Create a file set with the files provided, relative to basedir.
     * 
     * @param basedir directory files are relative to
     * @param files list of File objects, files that the set will contain, have to be relative to basedir 
     */
    public ScmFileSet( File basedir, List files )
    {
        if ( basedir == null )
        {
            throw new NullPointerException( "basedir must not be null" );
        }

        if ( files == null )
        {
            throw new NullPointerException( "files must not be null" );
        }

        this.basedir = basedir;
        this.files = files;
    }

    /**
     * Get the base directory of the file set. It's the directory files in the set are relative to.
     * @return base directory
     */
    public File getBasedir()
    {
        return basedir;
    }

    /**
     * Get the list of files in the set, relative to basedir
     * 
     * @deprecated use getFileList() instead
     * 
     * @return files in this set
     */
    public File[] getFiles()
    {
        return (File[]) this.files.toArray( new File[0] );
    }

    /**
     * Get the list of files in the set, relative to basedir
     * @return List of File objects
     */
    public List getFileList()
    {
        return this.files;
    }

    public String toString()
    {
        return "basedir = " + basedir + "; files = " + files;
    }
}