001/*
002 * Licensed to the Apache Software Foundation (ASF) under one
003 * or more contributor license agreements.  See the NOTICE file
004 * distributed with this work for additional information
005 * regarding copyright ownership.  The ASF licenses this file
006 * to you under the Apache License, Version 2.0 (the
007 * "License"); you may not use this file except in compliance
008 * with the License.  You may obtain a copy of the License at
009 *
010 *   http://www.apache.org/licenses/LICENSE-2.0
011 *
012 * Unless required by applicable law or agreed to in writing,
013 * software distributed under the License is distributed on an
014 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
015 * KIND, either express or implied.  See the License for the
016 * specific language governing permissions and limitations
017 * under the License.
018 */
019package org.apache.maven.scm.command.checkout;
020
021import org.apache.maven.scm.CommandParameter;
022import org.apache.maven.scm.CommandParameters;
023import org.apache.maven.scm.ScmException;
024import org.apache.maven.scm.ScmFileSet;
025import org.apache.maven.scm.ScmResult;
026import org.apache.maven.scm.ScmVersion;
027import org.apache.maven.scm.command.AbstractCommand;
028import org.apache.maven.scm.provider.ScmProviderRepository;
029
030/**
031 * @author <a href="mailto:evenisse@apache.org">Emmanuel Venisse</a>
032 * @author <a href="mailto:trygvis@inamo.no">Trygve Laugst&oslash;l</a>
033 * @author Olivier Lamy
034 *
035 */
036public abstract class AbstractCheckOutCommand extends AbstractCommand {
037    /**
038     * Execute Check out command line in a recursive check out way.
039     *
040     * @param repository not null
041     * @param fileSet not null
042     * @param scmVersion not null
043     * @return the checkout result
044     * @throws ScmException if any
045     * @see #executeCheckOutCommand(ScmProviderRepository, ScmFileSet, ScmVersion, boolean, boolean)
046     */
047    protected CheckOutScmResult executeCheckOutCommand(
048            ScmProviderRepository repository, ScmFileSet fileSet, ScmVersion scmVersion) throws ScmException {
049        return executeCheckOutCommand(repository, fileSet, scmVersion, true, false);
050    }
051
052    /**
053     * Execute Check out command line.
054     *
055     * @param repository not null
056     * @param fileSet not null
057     * @param scmVersion not null
058     * @param recursive <code>true</code> if recursive check out is wanted, <code>false</code> otherwise.
059     * @param shallow <code>true</code> if shallow check out is wanted, <code>false</code> otherwise.
060     * @return the checkout result
061     * @throws ScmException if any
062     * @since 1.1.1
063     */
064    protected abstract CheckOutScmResult executeCheckOutCommand(
065            ScmProviderRepository repository,
066            ScmFileSet fileSet,
067            ScmVersion scmVersion,
068            boolean recursive,
069            boolean shallow)
070            throws ScmException;
071
072    /** {@inheritDoc} */
073    public ScmResult executeCommand(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
074            throws ScmException {
075        ScmVersion scmVersion = parameters.getScmVersion(CommandParameter.SCM_VERSION, null);
076        boolean recursive = parameters.getBoolean(CommandParameter.RECURSIVE, true);
077        boolean shallow = parameters.getBoolean(CommandParameter.SHALLOW, false);
078        return executeCheckOutCommand(repository, fileSet, scmVersion, recursive, shallow);
079    }
080}