Package org.apache.maven.report.projectinfo

Source Code of org.apache.maven.report.projectinfo.ScmReport$ScmRenderer

package org.apache.maven.report.projectinfo;

/*
* 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 org.apache.commons.lang.SystemUtils;
import org.apache.maven.doxia.sink.Sink;
import org.apache.maven.model.Model;
import org.apache.maven.model.Scm;
import org.apache.maven.plugin.logging.Log;
import org.apache.maven.plugins.annotations.Component;
import org.apache.maven.plugins.annotations.Mojo;
import org.apache.maven.plugins.annotations.Parameter;
import org.apache.maven.scm.manager.NoSuchScmProviderException;
import org.apache.maven.scm.manager.ScmManager;
import org.apache.maven.scm.provider.cvslib.repository.CvsScmProviderRepository;
import org.apache.maven.scm.provider.git.repository.GitScmProviderRepository;
import org.apache.maven.scm.provider.hg.repository.HgScmProviderRepository;
import org.apache.maven.scm.provider.perforce.repository.PerforceScmProviderRepository;
import org.apache.maven.scm.provider.starteam.repository.StarteamScmProviderRepository;
import org.apache.maven.scm.provider.svn.repository.SvnScmProviderRepository;
import org.apache.maven.scm.repository.ScmRepository;
import org.apache.maven.scm.repository.ScmRepositoryException;
import org.codehaus.plexus.i18n.I18N;
import org.codehaus.plexus.util.StringUtils;

import java.util.ArrayList;
import java.util.List;
import java.util.Locale;

/**
* Generates the Project Source Code Management (SCM) report.
*
* @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton </a>
* @version $Id: ScmReport.java 1481329 2013-05-11 13:53:33Z rfscholte $
* @since 2.0
*/
@Mojo( name = "scm" )
public class ScmReport
    extends AbstractProjectInfoReport
{
    // ----------------------------------------------------------------------
    // Mojo parameters
    // ----------------------------------------------------------------------

    /**
     * Maven SCM Manager.
     */
    @Component
    protected ScmManager scmManager;

    /**
     * The directory name to checkout right after the SCM URL.
     */
    @Parameter( defaultValue = "${project.artifactId}", required = true )
    private String checkoutDirectoryName;

    /**
     * The SCM anonymous connection url respecting the SCM URL Format.
     *
     * @see <a href="http://maven.apache.org/scm/scm-url-format.html">SCM URL Format< /a>
     * @since 2.1
     */
    @Parameter( defaultValue = "${project.scm.connection}" )
    private String anonymousConnection;

    /**
     * The SCM developer connection url respecting the SCM URL Format.
     *
     * @see <a href="http://maven.apache.org/scm/scm-url-format.html">SCM URL Format< /a>
     * @since 2.1
     */
    @Parameter( defaultValue = "${project.scm.developerConnection}" )
    private String developerConnection;

    /**
     * The SCM web access url.
     *
     * @since 2.1
     */
    @Parameter( defaultValue = "${project.scm.url}" )
    private String webAccessUrl;

    // ----------------------------------------------------------------------
    // Public methods
    // ----------------------------------------------------------------------

    @Override
    public void executeReport( Locale locale )
    {
        ScmRenderer r =
            new ScmRenderer( getLog(), scmManager, getSink(), getProject().getModel(), getI18N( locale ), locale,
                             checkoutDirectoryName, webAccessUrl, anonymousConnection, developerConnection );

        r.render();
    }

    /** {@inheritDoc} */
    public String getOutputName()
    {
        return "source-repository";
    }

    @Override
    protected String getI18Nsection()
    {
        return "scm";
    }

    // ----------------------------------------------------------------------
    // Private
    // ----------------------------------------------------------------------

    /**
     * Internal renderer class
     */
    private static class ScmRenderer
        extends AbstractProjectInfoRenderer
    {
        private Log log;

        private Model model;

        private ScmManager scmManager;

        /**
         * To support more SCM
         */
        private String anonymousConnection;

        private String devConnection;

        private String checkoutDirectoryName;

        private String webAccessUrl;

        ScmRenderer( Log log, ScmManager scmManager, Sink sink, Model model, I18N i18n, Locale locale,
                     String checkoutDirName, String webAccessUrl, String anonymousConnection, String devConnection )
        {
            super( sink, i18n, locale );

            this.log = log;

            this.scmManager = scmManager;

            this.model = model;

            this.checkoutDirectoryName = checkoutDirName;

            this.webAccessUrl = webAccessUrl;

            this.anonymousConnection = anonymousConnection;

            this.devConnection = devConnection;

        }

        @Override
        protected String getI18Nsection()
        {
            return "scm";
        }

        @Override
        public void renderBody()
        {
            Scm scm = model.getScm();
            if ( scm == null )
            {
                startSection( getTitle() );

                paragraph( getI18nString( "noscm" ) );

                endSection();

                return;
            }

            if ( StringUtils.isEmpty( anonymousConnection ) && StringUtils.isEmpty( devConnection )
                && StringUtils.isEmpty( scm.getUrl() ) )
            {
                startSection( getTitle() );

                paragraph( getI18nString( "noscm" ) );

                endSection();

                return;
            }

            ScmRepository anonymousRepository = getScmRepository( anonymousConnection );
            ScmRepository devRepository = getScmRepository( devConnection );

            // Overview section
            renderOverViewSection( anonymousRepository );

            // Web access section
            renderWebAccesSection( webAccessUrl );

            // Anonymous access section if needed
            renderAnonymousAccessSection( anonymousRepository );

            // Developer access section
            renderDeveloperAccessSection( devRepository );

            // Access from behind a firewall section if needed
            renderAccessBehindFirewallSection( devRepository );

            // Access through a proxy section if needed
            renderAccessThroughProxySection( anonymousRepository, devRepository );
        }

        /**
         * Render the overview section
         *
         * @param anonymousRepository the anonymous repository
         */
        private void renderOverViewSection( ScmRepository anonymousRepository )
        {
            startSection( getI18nString( "overview.title" ) );

            if ( isScmSystem( anonymousRepository, "clearcase" ) )
            {
                sink.paragraph();
                linkPatternedText( getI18nString( "clearcase.intro" ) );
                sink.paragraph_();
            }
            else if ( isScmSystem( anonymousRepository, "cvs" ) )
            {
                sink.paragraph();
                linkPatternedText( getI18nString( "cvs.intro" ) );
                sink.paragraph_();
            }
            else if ( isScmSystem( anonymousRepository, "git" ) )
            {
                sink.paragraph();
                linkPatternedText( getI18nString( "git.intro" ) );
                sink.paragraph_();
            }
            else if ( isScmSystem( anonymousRepository, "hg" ) )
            {
                sink.paragraph();
                linkPatternedText( getI18nString( "hg.intro" ) );
                sink.paragraph_();
            }
            else if ( isScmSystem( anonymousRepository, "perforce" ) )
            {
                sink.paragraph();
                linkPatternedText( getI18nString( "perforce.intro" ) );
                sink.paragraph_();
            }
            else if ( isScmSystem( anonymousRepository, "starteam" ) )
            {
                sink.paragraph();
                linkPatternedText( getI18nString( "starteam.intro" ) );
                sink.paragraph_();
            }
            else if ( isScmSystem( anonymousRepository, "svn" ) )
            {
                sink.paragraph();
                linkPatternedText( getI18nString( "svn.intro" ) );
                sink.paragraph_();
            }
            else
            {
                paragraph( getI18nString( "general.intro" ) );
            }

            endSection();
        }

        /**
         * Render the web access section
         *
         * @param scmUrl The URL to the project's browsable repository.
         */
        private void renderWebAccesSection( String scmUrl )
        {
            startSection( getI18nString( "webaccess.title" ) );

            if ( StringUtils.isEmpty( scmUrl ) )
            {
                paragraph( getI18nString( "webaccess.nourl" ) );
            }
            else
            {
                paragraph( getI18nString( "webaccess.url" ) );

                verbatimLink( scmUrl, scmUrl );
            }

            endSection();
        }

        /**
         * Render the anonymous access section depending the repository.
         * <p>Note: ClearCase, Starteam et Perforce seems to have no anonymous access.</p>
         *
         * @param anonymousRepository the anonymous repository
         */
        private void renderAnonymousAccessSection( ScmRepository anonymousRepository )
        {
            if ( isScmSystem( anonymousRepository, "clearcase" ) || isScmSystem( anonymousRepository, "perforce" )
                || isScmSystem( anonymousRepository, "starteam" ) || StringUtils.isEmpty( anonymousConnection ) )
            {
                return;
            }

            startSection( getI18nString( "anonymousaccess.title" ) );

            if ( anonymousRepository != null && isScmSystem( anonymousRepository, "cvs" ) )
            {
                CvsScmProviderRepository cvsRepo = (CvsScmProviderRepository) anonymousRepository
                    .getProviderRepository();

                anonymousAccessCVS( cvsRepo );
            }
            else if ( anonymousRepository != null && isScmSystem( anonymousRepository, "git" ) )
            {
                GitScmProviderRepository gitRepo = (GitScmProviderRepository) anonymousRepository
                    .getProviderRepository();

                anonymousAccessGit( gitRepo );
            }
            else if ( anonymousRepository != null && isScmSystem( anonymousRepository, "hg" ) )
            {
                HgScmProviderRepository hgRepo = (HgScmProviderRepository) anonymousRepository
                    .getProviderRepository();

                anonymousAccessMercurial( hgRepo );
            }
            else if ( anonymousRepository != null && isScmSystem( anonymousRepository, "svn" ) )
            {
                SvnScmProviderRepository svnRepo = (SvnScmProviderRepository) anonymousRepository
                    .getProviderRepository();

                anonymousAccessSVN( svnRepo );
            }
            else
            {
                paragraph( getI18nString( "anonymousaccess.general.intro" ) );

                verbatimText( anonymousConnection.substring( 4 ) );
            }

            endSection();
        }

        /**
         * Render the developer access section
         *
         * @param devRepository the dev repository
         */
        private void renderDeveloperAccessSection( ScmRepository devRepository )
        {
            if ( StringUtils.isEmpty( devConnection ) )
            {
                return;
            }

            startSection( getI18nString( "devaccess.title" ) );

            if ( devRepository != null && isScmSystem( devRepository, "clearcase" ) )
            {
                developerAccessClearCase();
            }
            else if ( devRepository != null && isScmSystem( devRepository, "cvs" ) )
            {
                CvsScmProviderRepository cvsRepo = (CvsScmProviderRepository) devRepository.getProviderRepository();

                developerAccessCVS( cvsRepo );
            }
            else if ( devRepository != null && isScmSystem( devRepository, "git" ) )
            {
                GitScmProviderRepository gitRepo = (GitScmProviderRepository) devRepository.getProviderRepository();

                developerAccessGit( gitRepo );
            }
            else if ( devRepository != null && isScmSystem( devRepository, "hg" ) )
            {
                HgScmProviderRepository hgRepo = (HgScmProviderRepository) devRepository.getProviderRepository();

                developerAccessMercurial( hgRepo );
            }
            else if ( devRepository != null && isScmSystem( devRepository, "perforce" ) )
            {
                PerforceScmProviderRepository perforceRepo = (PerforceScmProviderRepository) devRepository
                    .getProviderRepository();

                developerAccessPerforce( perforceRepo );
            }
            else if ( devRepository != null && isScmSystem( devRepository, "starteam" ) )
            {
                StarteamScmProviderRepository starteamRepo = (StarteamScmProviderRepository) devRepository
                    .getProviderRepository();

                developerAccessStarteam( starteamRepo );
            }
            else if ( devRepository != null && isScmSystem( devRepository, "svn" ) )
            {
                SvnScmProviderRepository svnRepo = (SvnScmProviderRepository) devRepository.getProviderRepository();

                developerAccessSVN( svnRepo );
            }
            else
            {
                paragraph( getI18nString( "devaccess.general.intro" ) );

                verbatimText( devConnection.substring( 4 ) );
            }

            endSection();
        }

        /**
         * Render the access from behind a firewall section
         *
         * @param devRepository the dev repository
         */
        private void renderAccessBehindFirewallSection( ScmRepository devRepository )
        {
            startSection( getI18nString( "accessbehindfirewall.title" ) );

            if ( devRepository != null && isScmSystem( devRepository, "svn" ) )
            {
                SvnScmProviderRepository svnRepo = (SvnScmProviderRepository) devRepository.getProviderRepository();

                paragraph( getI18nString( "accessbehindfirewall.svn.intro" ) );

                StringBuilder sb = new StringBuilder();
                sb.append( "$ svn checkout " ).append( svnRepo.getUrl() );
                sb.append( " " ).append( checkoutDirectoryName );
                verbatimText( sb.toString() );
            }
            else if ( devRepository != null && isScmSystem( devRepository, "cvs" ) )
            {
                linkPatternedText( getI18nString( "accessbehindfirewall.cvs.intro" ) );
            }
            else
            {
                paragraph( getI18nString( "accessbehindfirewall.general.intro" ) );
            }

            endSection();
        }

        /**
         * Render the access from behind a firewall section
         *
         * @param anonymousRepository the anonymous repository
         * @param devRepository the dev repository
         */
        private void renderAccessThroughProxySection( ScmRepository anonymousRepository, ScmRepository devRepository )
        {
            if ( isScmSystem( anonymousRepository, "svn" ) || isScmSystem( devRepository, "svn" ) )
            {
                startSection( getI18nString( "accessthroughtproxy.title" ) );

                paragraph( getI18nString( "accessthroughtproxy.svn.intro1" ) );
                paragraph( getI18nString( "accessthroughtproxy.svn.intro2" ) );
                paragraph( getI18nString( "accessthroughtproxy.svn.intro3" ) );

                StringBuilder sb = new StringBuilder();
                sb.append( "[global]" );
                sb.append( SystemUtils.LINE_SEPARATOR );
                sb.append( "http-proxy-host = your.proxy.name" ).append( SystemUtils.LINE_SEPARATOR );
                sb.append( "http-proxy-port = 3128" ).append( SystemUtils.LINE_SEPARATOR );
                verbatimText( sb.toString() );

                endSection();
            }
        }

        // Clearcase

        /**
         * Create the documentation to provide an developer access with a <code>Clearcase</code> SCM.
         * For example, generate the following command line:
         * <p>cleartool checkout module</p>
         */
        private void developerAccessClearCase()
        {
            paragraph( getI18nString( "devaccess.clearcase.intro" ) );

            StringBuilder command = new StringBuilder();
            command.append( "$ cleartool checkout " );

            verbatimText( command.toString() );
        }

        // CVS

        /**
         * Create the documentation to provide an anonymous access with a <code>CVS</code> SCM.
         * For example, generate the following command line:
         * <p>cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic login</p>
         * <p>cvs -z3 -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic co maven-plugins/dist</p>
         *
         * @param cvsRepo
         * @see <a href="https://www.cvshome.org/docs/manual/cvs-1.12.12/cvs_16.html#SEC115">https://www.cvshome.org/docs/manual/cvs-1.12.12/cvs_16.html#SEC115</a>
         */
        private void anonymousAccessCVS( CvsScmProviderRepository cvsRepo )
        {
            paragraph( getI18nString( "anonymousaccess.cvs.intro" ) );

            StringBuilder command = new StringBuilder();
            command.append( "$ cvs -d " ).append( cvsRepo.getCvsRoot() ).append( " login" );
            command.append( SystemUtils.LINE_SEPARATOR );
            command.append( "$ cvs -z3 -d " ).append( cvsRepo.getCvsRoot() );
            command.append( " co " ).append( cvsRepo.getModule() );

            verbatimText( command.toString() );
        }

        // Git

        /**
         * Create the documentation to provide an anonymous access with a <code>Git</code> SCM.
         * For example, generate the following command line:
         * <p>git clone uri</p>
         *
         * @param gitRepo
         */
        private void anonymousAccessGit( GitScmProviderRepository gitRepo )
        {
            sink.paragraph();
            linkPatternedText( getI18nString( "anonymousaccess.git.intro" ) );
            sink.paragraph_();

            StringBuilder command = new StringBuilder();
            command.append( "$ git clone " ).append( gitRepo.getFetchUrl() );

            verbatimText( command.toString() );
        }

        // Mercurial

        /**
         * Create the documentation to provide an anonymous access with a <code>Mercurial</code> SCM.
         * For example, generate the following command line:
         * <p>hg clone uri</p>
         *
         * @param hgRepo
         */
        private void anonymousAccessMercurial( HgScmProviderRepository hgRepo )
        {
            sink.paragraph();
            linkPatternedText( getI18nString( "anonymousaccess.hg.intro" ) );
            sink.paragraph_();

            StringBuilder command = new StringBuilder();
            command.append( "$ hg clone " ).append( hgRepo.getURI() );

            verbatimText( command.toString() );
        }

        /**
         * Create the documentation to provide an developer access with a <code>CVS</code> SCM.
         * For example, generate the following command line:
         * <p>cvs -d :pserver:username@cvs.apache.org:/home/cvs login</p>
         * <p>cvs -z3 -d :ext:username@cvs.apache.org:/home/cvs co maven-plugins/dist</p>
         *
         * @param cvsRepo
         * @see <a href="https://www.cvshome.org/docs/manual/cvs-1.12.12/cvs_16.html#SEC115">https://www.cvshome.org/docs/manual/cvs-1.12.12/cvs_16.html#SEC115</a>
         */
        private void developerAccessCVS( CvsScmProviderRepository cvsRepo )
        {
            paragraph( getI18nString( "devaccess.cvs.intro" ) );

            // Safety: remove the username if present
            String cvsRoot = StringUtils.replace( cvsRepo.getCvsRoot(), cvsRepo.getUser(), "username" );

            StringBuilder command = new StringBuilder();
            command.append( "$ cvs -d " ).append( cvsRoot ).append( " login" );
            command.append( SystemUtils.LINE_SEPARATOR );
            command.append( "$ cvs -z3 -d " ).append( cvsRoot ).append( " co " ).append( cvsRepo.getModule() );

            verbatimText( command.toString() );
        }

        // Git

        /**
         * Create the documentation to provide an developer access with a <code>Git</code> SCM.
         * For example, generate the following command line:
         * <p>git clone repo </p>
         *
         * @param gitRepo
         */
        private void developerAccessGit( GitScmProviderRepository gitRepo )
        {
            sink.paragraph();
            linkPatternedText( getI18nString( "devaccess.git.intro" ) );
            sink.paragraph_();

            StringBuilder command = new StringBuilder();
            command.append( "$ git clone " );
            command.append( gitRepo.getPushUrl() );

            verbatimText( command.toString() );
        }

        // Mercurial

        /**
         * Create the documentation to provide an developer access with a <code>Mercurial</code> SCM.
         * For example, generate the following command line:
         * <p>hg clone repo </p>
         *
         * @param hgRepo
         */
        private void developerAccessMercurial( HgScmProviderRepository hgRepo )
        {
            sink.paragraph();
            linkPatternedText( getI18nString( "devaccess.hg.intro" ) );
            sink.paragraph_();

            StringBuilder command = new StringBuilder();
            command.append( "$ hg clone " );
            command.append( hgRepo.getURI() );

            verbatimText( command.toString() );
        }

        // Perforce

        /**
         * Create the documentation to provide an developer access with a <code>Perforce</code> SCM.
         * For example, generate the following command line:
         * <p>p4 -H hostname -p port -u username -P password path</p>
         * <p>p4 -H hostname -p port -u username -P password path submit -c changement</p>
         *
         * @param perforceRepo
         * @see <a href="http://www.perforce.com/perforce/doc.051/manuals/cmdref/index.html">http://www.perforce.com/perforce/doc.051/manuals/cmdref/index.html</>
         */
        private void developerAccessPerforce( PerforceScmProviderRepository perforceRepo )
        {
            paragraph( getI18nString( "devaccess.perforce.intro" ) );

            StringBuilder command = new StringBuilder();
            command.append( "$ p4" );
            if ( !StringUtils.isEmpty( perforceRepo.getHost() ) )
            {
                command.append( " -H " ).append( perforceRepo.getHost() );
            }
            if ( perforceRepo.getPort() > 0 )
            {
                command.append( " -p " ).append( perforceRepo.getPort() );
            }
            command.append( " -u username" );
            command.append( " -P password" );
            command.append( " " );
            command.append( perforceRepo.getPath() );
            command.append( SystemUtils.LINE_SEPARATOR );
            command.append( "$ p4 submit -c \"A comment\"" );

            verbatimText( command.toString() );
        }

        // Starteam

        /**
         * Create the documentation to provide an developer access with a <code>Starteam</code> SCM.
         * For example, generate the following command line:
         * <p>stcmd co -x -nologo -stop -p myusername:mypassword@myhost:1234/projecturl -is</p>
         * <p>stcmd ci -x -nologo -stop -p myusername:mypassword@myhost:1234/projecturl -f NCI -is</p>
         *
         * @param starteamRepo
         */
        private void developerAccessStarteam( StarteamScmProviderRepository starteamRepo )
        {
            paragraph( getI18nString( "devaccess.starteam.intro" ) );

            StringBuilder command = new StringBuilder();

            // Safety: remove the username/password if present
            String fullUrl = StringUtils.replace( starteamRepo.getFullUrl(), starteamRepo.getUser(), "username" );
            fullUrl = StringUtils.replace( fullUrl, starteamRepo.getPassword(), "password" );

            command.append( "$ stcmd co -x -nologo -stop -p " );
            command.append( fullUrl );
            command.append( " -is" );
            command.append( SystemUtils.LINE_SEPARATOR );
            command.append( "$ stcmd ci -x -nologo -stop -p " );
            command.append( fullUrl );
            command.append( " -f NCI -is" );

            verbatimText( command.toString() );
        }

        // SVN

        /**
         * Create the documentation to provide an anonymous access with a <code>SVN</code> SCM.
         * For example, generate the following command line:
         * <p>svn checkout http://svn.apache.org/repos/asf/maven/components/trunk maven</p>
         *
         * @param svnRepo
         * @see <a href="http://svnbook.red-bean.com/">http://svnbook.red-bean.com/</a>
         */
        private void anonymousAccessSVN( SvnScmProviderRepository svnRepo )
        {
            paragraph( getI18nString( "anonymousaccess.svn.intro" ) );

            StringBuilder sb = new StringBuilder();
            sb.append( "$ svn checkout " ).append( svnRepo.getUrl() ).append( " " ).append( checkoutDirectoryName );

            verbatimText( sb.toString() );
        }

        /**
         * Create the documentation to provide an developer access with a <code>SVN</code> SCM.
         * For example, generate the following command line:
         * <p>svn checkout https://svn.apache.org/repos/asf/maven/components/trunk maven</p>
         * <p>svn commit --username your-username -m "A message"</p>
         *
         * @param svnRepo
         * @see <a href="http://svnbook.red-bean.com/">http://svnbook.red-bean.com/</a>
         */
        private void developerAccessSVN( SvnScmProviderRepository svnRepo )
        {
            if ( svnRepo.getUrl() != null )
            {
                if ( svnRepo.getUrl().startsWith( "https://" ) )
                {
                    paragraph( getI18nString( "devaccess.svn.intro1.https" ) );
                }
                else if ( svnRepo.getUrl().startsWith( "svn://" ) )
                {
                    paragraph( getI18nString( "devaccess.svn.intro1.svn" ) );
                }
                else if ( svnRepo.getUrl().startsWith( "svn+ssh://" ) )
                {
                    paragraph( getI18nString( "devaccess.svn.intro1.svnssh" ) );
                }
                else
                {
                    paragraph( getI18nString( "devaccess.svn.intro1.other" ) );
                }
            }

            StringBuilder sb = new StringBuilder();

            sb.append( "$ svn checkout " ).append( svnRepo.getUrl() ).append( " " ).append( checkoutDirectoryName );

            verbatimText( sb.toString() );

            paragraph( getI18nString( "devaccess.svn.intro2" ) );

            sb = new StringBuilder();
            sb.append( "$ svn commit --username your-username -m \"A message\"" );

            verbatimText( sb.toString() );
        }

        /**
         * Return a <code>SCM repository</code> defined by a given url
         *
         * @param scmUrl an SCM URL
         * @return a valid SCM repository or null
         */
        public ScmRepository getScmRepository( String scmUrl )
        {
            if ( StringUtils.isEmpty( scmUrl ) )
            {
                return null;
            }

            ScmRepository repo = null;
            List<String> messages = new ArrayList<String>();
            try
            {
                messages.addAll( scmManager.validateScmRepository( scmUrl ) );
            }
            catch ( Exception e )
            {
                messages.add( e.getMessage() );
            }

            if ( messages.size() > 0 )
            {
                StringBuilder sb = new StringBuilder();
                boolean isIntroAdded = false;
                for ( String msg : messages )
                {
                    // Ignore NoSuchScmProviderException msg
                    // See impl of AbstractScmManager#validateScmRepository()
                    if ( msg.startsWith( "No such provider" ) )
                    {
                        continue;
                    }

                    if ( !isIntroAdded )
                    {
                        sb.append( "This SCM url '" + scmUrl + "' is invalid due to the following errors:" );
                        sb.append( SystemUtils.LINE_SEPARATOR );
                        isIntroAdded = true;
                    }
                    sb.append( " * " );
                    sb.append( msg );
                    sb.append( SystemUtils.LINE_SEPARATOR );
                }

                if ( StringUtils.isNotEmpty( sb.toString() ) )
                {
                    sb.append( "For more information about SCM URL Format, please refer to: "
                        + "http://maven.apache.org/scm/scm-url-format.html" );

                    throw new IllegalArgumentException( sb.toString() );
                }
            }

            try
            {
                repo = scmManager.makeScmRepository( scmUrl );
            }
            catch ( NoSuchScmProviderException e )
            {
                if ( log.isDebugEnabled() )
                {
                    log.debug( e.getMessage(), e );
                }
            }
            catch ( ScmRepositoryException e )
            {
                if ( log.isDebugEnabled() )
                {
                    log.debug( e.getMessage(), e );
                }
            }
            catch ( Exception e )
            {
                // Should be already catched
                if ( log.isDebugEnabled() )
                {
                    log.debug( e.getMessage(), e );
                }
            }

            return repo;
        }

        /**
         * Convenience method that return true is the defined <code>SCM repository</code> is a known provider.
         * <p>
         * Actually, we fully support Clearcase, CVS, Perforce, Starteam, SVN by the maven-scm-providers component.
         * </p>
         *
         * @param scmRepository a SCM repository
         * @param scmProvider a SCM provider name
         * @return true if the provider of the given SCM repository is equal to the given scm provider.
         * @see <a href="http://svn.apache.org/repos/asf/maven/scm/trunk/maven-scm-providers/">maven-scm-providers</a>
         */
        private static boolean isScmSystem( ScmRepository scmRepository, String scmProvider )
        {
            if ( StringUtils.isEmpty( scmProvider ) )
            {
                return false;
            }

            if ( scmRepository != null && scmProvider.equalsIgnoreCase( scmRepository.getProvider() ) )
            {
                return true;
            }

            return false;
        }
    }
}
TOP

Related Classes of org.apache.maven.report.projectinfo.ScmReport$ScmRenderer

TOP
Copyright © 2018 www.massapi.com. All rights reserved.
All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.