Maven仓库的布局

来自站长百科
跳转至: 导航、​ 搜索

导航:上一页|ASP | PHP | JSP | HTML | CSS | XHTML | aJAX | Ruby | JAVA | XML | Python | ColdFusion

任何一个构件都有其唯一的坐标,根据这个坐标可以定义其在仓库中的唯一存储路径,这便是Maven的仓库布局方式。

概述[ ]

如 log4j:log4j:1.2.15这一依赖,其对应的仓库路径为log4j/log4j/1.2.15/log4j-1.2.15.jar,很容易看出,该路径与坐标的大致对应关系为groupId/artifactId/version/artifactId- version.packaging。下面看一段Maven的源码并结合具体的实例来理解Maven仓库的布局方式:

     private static final char PATH_SEPARATOR = '/';  
   
     private static final char GROUP_SEPARATOR = '.';  
   
     private static final char ARTIFACT_SEPARATOR = '-';  
   
     public String pathOf( Artifact artifact )  
     {  
         ArtifactHandler artifactHandler = artifact.getArtifactHandler();  
   
         StringBuilder path = new StringBuilder( 128 );  
   
         path.append( formatAsDirectory( artifact.getGroupId() ) ).append( PATH_SEPARATOR );  
         path.append( artifact.getArtifactId() ).append( PATH_SEPARATOR );  
         path.append( artifact.getBaseVersion() ).append( PATH_SEPARATOR );  
         path.append( artifact.getArtifactId() ).append( ARTIFACT_SEPARATOR ).append( artifact.getVersion() );  
   
         if ( artifact.hasClassifier() )  
         {  
             path.append( ARTIFACT_SEPARATOR ).append( artifact.getClassifier() );  
         }  
   
         if ( artifactHandler.getExtension() != null && artifactHandler.getExtension().length() > 0 )  
         {  
             path.append( GROUP_SEPARATOR ).append( artifactHandler.getExtension() );  
         }  
   
         return path.toString();  
 }  
   
     private String formatAsDirectory( String directory )  
     {  
         return directory.replace( GROUP_SEPARATOR, PATH_SEPARATOR );  
     } 

分析[ ]

该pathOf()方法的目的是根据构件信息生成其在仓库中的路径。这里,我们根据一个实际的例子来分析路径的生成,考虑这样一个构件:groupId=org.testng、artifactId=testng、 version=5.8、classifier=jdk15、packaging=jar,其对应的路径按如下步骤生成:

  • 首先基于构件的groupId准备路径,formatAsDirectory()将groupId中的句点分隔符转换成路径分隔符,该例中,groupId org.testng就会被转换成org/testng,之后再加一个路径分隔符斜杠,那么org.testng就成为了org/testng/。
  • 基于构件的artifactId准备路径,也就是在前面的基础上加上artifactId以及一个路径分隔符,该例中的artifactId为testng,那么在这一步过后路径就成为了org/testng/testng/。
  • 接着使用版本信息,在前面的基础上加上version和路径分隔符,该例中版本是5.8,那么路径就成为了org/testng/tesgng/5.8/。
  • 这一步再依次加上artifactId,构件分隔符连字号,以及version,于是构建的路径就变成了org/testng/testng /5.8/testng-5.8。读者可能会注意到这里使用了artifactId.getVersion(),而上一步用的是 artifactId.getBaseVersion(),version和baseVersion的区别在本章讨论SNAPSHOT的时候会具体阐述。
  • 紧接着如果构件有classifier,就加上构件分隔符和classifier,该例中构件的classifier是jdk15,那么路径就变成org/testng/testng/5.8/testng-5.8-jdk5。
  • 最后第检查构件的extension,若extension存在,则加上句点分隔符和extension,从代码中可以看到,extension 是从artifactHandler而非artifact获取,artifactHandler是由项目的packaging决定的,因此可以说,packaging决定了构件的扩展名,该例的packaging是的jar,因此最终的路径为org/testng/testng/5.8 /testng-5.8-jdk5.jar。

总结[ ]

由于Maven仓库是基于简单文件系统存储的,现在我们又理解了其存储方式,因此当遇到一些与仓库相关的问题时,可以很方便的查找相关文件,方便定位问题。例如当Maven无法获得项目声明的依赖时,可以简单该依赖对应的文件在仓库中是否存在,如果不存在,是否有其它版本可用,等等。

相关条目[ ]


参考来源[ ]

参考来源