mvn clean install 與 mvn install 的區別（爲啥用clean）[轉]

原文點擊這裏

之前寫代碼的過程中曾經遇到過問題，用mvn install後，新改的內容不生效，一定要後來使用mvn clean install 才生效，由於之前沒有做記錄，以及記不清是什麼情況下才會出現的問題，於是想看看clean和不clean的區別。

就如大家知道的，maven在執行一個生命週期的命令的是時候將會執行之前的所有生命週期操作，比如執行mvn install，會執行前面一系列的動作包括 compile , package , test 等，具體請查看maven的官方文檔。這個特性使maven的命令更加簡潔易用。

再來分析原來的問題，爲什麼修改的內容不生效，肯定是最終打出來的war包中的內容沒有更新，而war包中會依賴其他子工程的jar包，如果jar 包沒有更新過，那war包調用老的jar包也會導致新內容不生效。定位到問題的原因應該是jar包沒有用最新的資源（java或者配置文件），那jar包又是什麼時候，誰去打的呢。

上面我們提到我們執行mvn install的時候會先執行mvn package，maven就是通過這個生命週期來根據用戶配置，進行打包（war、jar或者其他），這會在每個工程 pom.xml 文件中設置，類似如下：

<project xmlns="http://maven.apache.org/POM/4.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0

http://maven.apache.org/xsd/maven-4.0.0.xsd">

  ...
  <packaging>war</packaging>
  ...
</project>

這裏指定package的時候打成一個war包，改成jar，就會被打成jar包。

我們看jar形式的情況，mvn package 會調用 maven-jar-plugin 這個插件進行打包。
下面我們做一些實驗來看這個插件打包的時候的情況

修改target目錄下打好的jar包中class以及配置文件的內容，在運行命令mvn package，結果target包中的內容沒有被覆蓋。
修改源代碼中的內容，再運行命令mvn package,結果target包中的內容被覆蓋了，產生了新的包。
修改target目錄下打好的jar包中的內容，運行命令mvn package -Djar.forceCreation，這個參數應該是強制創建jar包，所以結果target中的jar包內容被覆蓋了，產生了新的jar包。

根據上面的實驗好像還是不能解釋什麼時候應該用clean將target下面的內容刪除重新生成，jar包，不過至少是明白了一些規則。
下面我們還是去看看 maven-jar-plugin 的源碼吧。

之前，我提一點，maven的debugg信息非常完備，需要查看debug信息只要在命令後面添加 -X 參數即可，如：
mvn clean package -X 就能看到非常豐富的DEBUG信息。

回來，我們發現 org.codehaus.plexus.archiver.AbstractArchiver中的關鍵一段，用來判斷是否強制新建jar

    protected boolean checkForced()
        throws ArchiverException
    {
        if ( !isForced() && isSupportingForced() && isUptodate() )
        {
            getLogger().debug( "Archive " + getDestFile() + " is uptodate." );
            return false;
        }
        return true;
    }

這個方法是校驗是否強制重新創建jar包，只有當
1. 沒有將 jar.forceCreation 參數設爲true
2. 並且支持強制設置
3. up to date,意思就是被認爲是最新的內容，沒有改動
這個時候maven不進行新包的生成直接返回。

   protected void execute()
        throws ArchiverException, IOException
    {
        if ( ! checkForced() )
        {
            return;
        }

        if ( doubleFilePass )
        {
            skipWriting = true;
            createArchiveMain();
            skipWriting = false;
            createArchiveMain();
        }
        else
        {
            createArchiveMain();
        }

        finalizeZipOutputStream( zOut );
    }

所以除了那個強制的參數以外，就是看什麼時候 isUptodate 爲true，查看關鍵代碼：

protected boolean isUptodate()
        throws ArchiverException
    {
        final File zipFile = getDestFile();
        final long destTimestamp = zipFile.lastModified();
        if ( destTimestamp == 0 )
        {
            getLogger().debug( "isUp2date: false (Destination " + zipFile.getPath() + " not found.)" );
            return false; // File doesn't yet exist
        }

        final Iterator it = resources.iterator();
        if ( !it.hasNext() )
        {
            getLogger().debug( "isUp2date: false (No input files.)" );
            return false; // No timestamp to compare
        }

        while ( it.hasNext() )
        {
            final Object o = it.next();
            final long l;
            if ( o instanceof ArchiveEntry )
            {
                l = ( (ArchiveEntry) o ).getResource()
                                        .getLastModified();
            }
            else if ( o instanceof PlexusIoResourceCollection )
            {
                try
                {
                    l = ( (PlexusIoResourceCollection) o ).getLastModified();
                }
                catch ( final IOException e )
                {
                    throw new ArchiverException( e.getMessage(), e );
                }
            }
            else
            {
                throw new IllegalStateException( "Invalid object type: " + o.getClass()
                                                                            .getName() );
            }
            if ( l == PlexusIoResource.UNKNOWN_MODIFICATION_DATE )
            {
                // Don't know what to do. Safe thing is to assume not up2date.
                getLogger().debug( "isUp2date: false (Resource with unknown modification date found.)" );
                return false;
            }
            if ( l > destTimestamp )
            {
                getLogger().debug( "isUp2date: false (Resource with newer modification date found.)" );
                return false;
            }
        }

        getLogger().debug( "isUp2date: true" );
        return true;
    }

代碼中提到有這麼幾個情況，會認爲jar包不是最新的：
1. jar包不存在（其實就是mvn clean的效果）
2. 傳入比較的文件資源不存在
3. Resource with unknown modification date found，資源的修改時間未知
4. Resource with newer modification date found，jar包的最後修改時間比資源的最後修改時間早

總結
1. 理論上來講不做mvn clean 得到的jar包應該是最新的，除非其他方式修改jar包中的內容而不修改源代碼。
2. 平時可以用mvn install，而不進行chean節省時間（如果你覺得節省時間多的話），但最保險還是用 mvn clean install 生成最新的jar包或其他包
3. 不想用mvn clean又想保證jar包最新，建議添加 -Djar.forceCreation 參數

jar-plugin源代碼地址：http://svn.apache.org/repos/asf/maven/plugins/tags/maven-jar-plugin-2.4