001package org.apache.maven.scm.plugin;
002
003/*
004 * Licensed to the Apache Software Foundation (ASF) under one
005 * or more contributor license agreements.  See the NOTICE file
006 * distributed with this work for additional information
007 * regarding copyright ownership.  The ASF licenses this file
008 * to you under the Apache License, Version 2.0 (the
009 * "License"); you may not use this file except in compliance
010 * with the License.  You may obtain a copy of the License at
011 *
012 * http://www.apache.org/licenses/LICENSE-2.0
013 *
014 * Unless required by applicable law or agreed to in writing,
015 * software distributed under the License is distributed on an
016 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
017 * KIND, either express or implied.  See the License for the
018 * specific language governing permissions and limitations
019 * under the License.
020 */
021
022import java.io.File;
023import java.io.IOException;
024
025import org.apache.maven.plugin.MojoExecutionException;
026import org.apache.maven.plugins.annotations.Mojo;
027import org.apache.maven.plugins.annotations.Parameter;
028import org.apache.maven.scm.ScmException;
029import org.apache.maven.scm.ScmFileSet;
030import org.apache.maven.scm.ScmResult;
031import org.apache.maven.scm.repository.ScmRepository;
032import org.codehaus.plexus.util.FileUtils;
033
034/**
035 * Get a fresh copy of the latest source from the configured scm url.
036 *
037 * @author <a href="evenisse@apache.org">Emmanuel Venisse</a>
038 */
039@Mojo( name = "checkout", requiresProject = false )
040public class CheckoutMojo
041    extends AbstractScmMojo
042{
043    /**
044     * Use Export instead of checkout
045     */
046    @Parameter( property = "useExport", defaultValue = "false" )
047    private boolean useExport;
048    
049    /**
050     * The directory to checkout the sources to for the bootstrap and checkout goals.
051     */
052    @Parameter( property = "checkoutDirectory", defaultValue = "${project.build.directory}/checkout" )
053    private File checkoutDirectory;
054
055    /**
056     * Skip checkout if checkoutDirectory exists.
057     */
058    @Parameter( property = "skipCheckoutIfExists", defaultValue = "false" )
059    private boolean skipCheckoutIfExists = false;
060
061    /**
062     * The version type (branch/tag/revision) of scmVersion.
063     */
064    @Parameter( property = "scmVersionType" )
065    private String scmVersionType;
066
067    /**
068     * The version (revision number/branch name/tag name).
069     */
070    @Parameter( property = "scmVersion" )
071    private String scmVersion;
072
073    /**
074     * allow extended mojo (ie BootStrap ) to see checkout result
075     */
076    private ScmResult checkoutResult;
077
078    /** {@inheritDoc} */
079    public void execute()
080        throws MojoExecutionException
081    {
082        super.execute();
083
084        //skip checkout if checkout directory is already created. See SCM-201
085        checkoutResult = null;
086        if ( !getCheckoutDirectory().isDirectory() || !this.skipCheckoutIfExists )
087        {
088            checkoutResult = checkout();
089        }
090    }
091
092    protected File getCheckoutDirectory()
093    {
094        return this.checkoutDirectory;
095    }
096
097    public void setCheckoutDirectory( File checkoutDirectory )
098    {
099        this.checkoutDirectory = checkoutDirectory;
100    }
101
102    protected ScmResult checkout()
103        throws MojoExecutionException
104    {
105        try
106        {
107            ScmRepository repository = getScmRepository();
108
109            this.prepareOutputDirectory( getCheckoutDirectory() );
110            
111            ScmResult result = null;
112            
113            ScmFileSet fileSet = new ScmFileSet( getCheckoutDirectory().getAbsoluteFile() );
114            if ( useExport )
115            {
116                result = getScmManager().export( repository,fileSet, getScmVersion( scmVersionType, scmVersion ) );
117            }
118            else
119            {
120                result = getScmManager().checkOut( repository,fileSet , getScmVersion( scmVersionType, scmVersion ) );
121            }
122
123            checkResult( result );
124            
125           
126            handleExcludesIncludesAfterCheckoutAndExport( this.checkoutDirectory );
127
128            return result;
129        }
130        catch ( ScmException e )
131        {
132            throw new MojoExecutionException( "Cannot run checkout command : ", e );
133        }
134    }
135
136    private void prepareOutputDirectory( File ouputDirectory )
137        throws MojoExecutionException
138    {
139        try
140        {
141            this.getLog().info( "Removing " + ouputDirectory );
142
143            FileUtils.deleteDirectory( getCheckoutDirectory() );
144        }
145        catch ( IOException e )
146        {
147            throw new MojoExecutionException( "Cannot remove " + ouputDirectory );
148        }
149        
150        if ( !getCheckoutDirectory().mkdirs() )
151        {
152            throw new MojoExecutionException( "Cannot create " + ouputDirectory );
153        }
154    }
155    
156    protected ScmResult getCheckoutResult()
157    {
158        return checkoutResult;
159    }
160    
161
162}