1 package org.apache.maven.scm; 2 3 /* 4 * Licensed to the Apache Software Foundation (ASF) under one 5 * or more contributor license agreements. See the NOTICE file 6 * distributed with this work for additional information 7 * regarding copyright ownership. The ASF licenses this file 8 * to you under the Apache License, Version 2.0 (the 9 * "License"); you may not use this file except in compliance 10 * with the License. You may obtain a copy of the License at 11 * 12 * http://www.apache.org/licenses/LICENSE-2.0 13 * 14 * Unless required by applicable law or agreed to in writing, 15 * software distributed under the License is distributed on an 16 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 17 * KIND, either express or implied. See the License for the 18 * specific language governing permissions and limitations 19 * under the License. 20 */ 21 22 import java.io.File; 23 import java.io.IOException; 24 import java.io.Serializable; 25 import java.util.ArrayList; 26 import java.util.Arrays; 27 import java.util.List; 28 29 import org.codehaus.plexus.util.DirectoryScanner; 30 import org.codehaus.plexus.util.FileUtils; 31 import org.codehaus.plexus.util.StringUtils; 32 33 /** 34 * Set of files used for SCM operations. 35 * Consists of the base directory of the files and a list of files relative to that directory. 36 * 37 * @author <a href="mailto:brett@apache.org">Brett Porter</a> 38 * 39 */ 40 public class ScmFileSet 41 implements Serializable 42 { 43 private static final long serialVersionUID = -5978597349974797556L; 44 45 private static final String DELIMITER = ","; 46 47 /** @see DirectoryScanner#DEFAULTEXCLUDES */ 48 private static final String DEFAULT_EXCLUDES = StringUtils.join( DirectoryScanner.DEFAULTEXCLUDES, DELIMITER ); 49 50 private final File basedir; 51 52 private String includes; 53 54 private String excludes; 55 56 /** 57 * List of File objects, all relative to the basedir. 58 */ 59 private final List<File> files; 60 61 /** 62 * Create a file set with no files, only the base directory. 63 * 64 * @param basedir directory files in the set are relative to 65 */ 66 public ScmFileSet( File basedir ) 67 { 68 this( basedir, new ArrayList<File>( 0 ) ); 69 } 70 71 /** 72 * Create a file set with only the file provided, relative to basedir. 73 * 74 * @param basedir directory file is relative to 75 * @param file file that the set will contain, has to be relative to basedir 76 */ 77 public ScmFileSet( File basedir, File file ) 78 { 79 this( basedir, new File[]{file} ); 80 } 81 82 /** 83 * Create a file set with only files (not directories) from basefile, 84 * using includes and excludes provided. 85 * 86 * @param basedir directory files are relative to 87 * @param includes Ant pattern for files to include 88 * @param excludes Ant pattern for files to exclude, 89 * if null DEFAULT_EXCLUDES is used, else DEFAULT_EXCLUDES is added. 90 * @throws IOException if any 91 */ 92 public ScmFileSet( File basedir, String includes, String excludes ) 93 throws IOException 94 { 95 this.basedir = basedir; 96 97 if ( excludes != null && excludes.length() > 0 ) 98 { 99 excludes += DELIMITER + DEFAULT_EXCLUDES; 100 } 101 else 102 { 103 excludes = DEFAULT_EXCLUDES; 104 } 105 this.files = FileUtils.getFiles( basedir, includes, excludes, false ); 106 this.includes = includes; 107 this.excludes = excludes; 108 } 109 110 /** 111 * Create a file set with files from basefile, using includes provided and default excludes. 112 * 113 * @param basedir directory files are relative to 114 * @param includes Ant pattern for files to include 115 * @throws IOException if any 116 * @since 1.0 117 */ 118 public ScmFileSet( File basedir, String includes ) 119 throws IOException 120 { 121 this( basedir, includes, null ); 122 } 123 124 /** 125 * Create a file set with the files provided, relative to basedir. 126 * 127 * @param basedir directory files are relative to 128 * @param files files that the set will contain, have to be relative to basedir 129 * @deprecated use ScmFileSet( File, List ) 130 */ 131 public ScmFileSet( File basedir, File[] files ) 132 { 133 this( basedir, Arrays.asList( files ) ); 134 } 135 136 /** 137 * Create a file set with the files provided, relative to basedir. 138 * 139 * @param basedir directory files are relative to 140 * @param files list of File objects, files that the set will contain, have to be relative to basedir 141 */ 142 public ScmFileSet( File basedir, List<File> files ) 143 { 144 if ( basedir == null ) 145 { 146 throw new NullPointerException( "basedir must not be null" ); 147 } 148 149 if ( files == null ) 150 { 151 throw new NullPointerException( "files must not be null" ); 152 } 153 154 this.basedir = basedir; 155 this.files = files; 156 } 157 158 /** 159 * Get the base directory of the file set. It's the directory files in the set are relative to. 160 * 161 * @return base directory 162 */ 163 public File getBasedir() 164 { 165 return basedir; 166 } 167 168 /** 169 * Get the list of files in the set, relative to basedir 170 * 171 * @return files in this set 172 * @deprecated use getFileList() instead 173 */ 174 public File[] getFiles() 175 { 176 return this.files.toArray( new File[this.files.size()] ); 177 } 178 179 /** 180 * Get the list of files in the set, relative to basedir 181 * 182 * @return List of File objects 183 */ 184 public List<File> getFileList() 185 { 186 return this.files; 187 } 188 189 190 /** 191 * @return the includes files as a comma separated string 192 */ 193 public String getIncludes() 194 { 195 return this.includes; 196 } 197 198 199 /** 200 * @return the excludes files as a comma separated string 201 */ 202 public String getExcludes() 203 { 204 return this.excludes; 205 } 206 207 /** {@inheritDoc} */ 208 public String toString() 209 { 210 return "basedir = " + basedir + "; files = " + files; 211 } 212 }