49 | * The properties are resolved iteratively, so if the value of property A refers to property B, then after 50 | * resolution the value of property B will contain the value of property B. 51 | *
52 | * 53 | * @param propFile The property file to load. 54 | * @param baseProps Properties containing the initial values to substitute into the properties file. 55 | * @return Properties object containing the properties in the file with their values fully resolved. 56 | * @throws IOException if profile does not exist, or cannot be read. 57 | */ 58 | public static Properties loadPropertyFile(Path propFile, Properties baseProps) throws IOException { 59 | return loadPropertyFile(propFile, baseProps, null); 60 | } 61 | 62 | /** 63 | * Reads a property file, resolving all internal variables, using the supplied base properties. 64 | *65 | * The properties are resolved iteratively, so if the value of property A refers to property B, then after 66 | * resolution the value of property B will contain the value of property B. 67 | *
68 | * 69 | * @param propFile The property file to load. 70 | * @param baseProps Properties containing the initial values to substitute into the properties file. 71 | * @param logger Logger instance 72 | * @return Properties object containing the properties in the file with their values fully resolved. 73 | * @throws IOException if profile does not exist, or cannot be read. 74 | * 75 | * @since 3.1.2 76 | */ 77 | public static Properties loadPropertyFile(Path propFile, Properties baseProps, Logger logger) throws IOException { 78 | if (!Files.exists(propFile)) { 79 | throw new FileNotFoundException(propFile.toString()); 80 | } 81 | 82 | final Properties fileProps = new Properties(); 83 | 84 | try (InputStream inStream = Files.newInputStream(propFile)) { 85 | fileProps.load(inStream); 86 | } 87 | 88 | final Properties combinedProps = new Properties(); 89 | combinedProps.putAll(baseProps == null ? new Properties() : baseProps); 90 | combinedProps.putAll(fileProps); 91 | 92 | // The algorithm iterates only over the fileProps which is all that is required to resolve 93 | // the properties defined within the file. This is slightly different to current, however 94 | // I suspect that this was the actual original intent. 95 | // 96 | // The difference is that #loadPropertyFile(File, boolean, boolean) also resolves System properties 97 | // whose values contain expressions. I believe this is unexpected and is not validated by the test cases, 98 | // as can be verified by replacing the implementation of #loadPropertyFile(File, boolean, boolean) 99 | // with the commented variant I have provided that reuses this method. 100 | 101 | for (Object o : fileProps.keySet()) { 102 | final String k = (String) o; 103 | final String propValue = getPropertyValue(k, combinedProps, logger); 104 | fileProps.setProperty(k, propValue); 105 | } 106 | 107 | return fileProps; 108 | } 109 | 110 | /** 111 | * Reads a property file, resolving all internal variables. 112 | * 113 | * @param propfile The property file to load 114 | * @param fail whether to throw an exception when the file cannot be loaded or to return null 115 | * @param useSystemProps whether to incorporate System.getProperties settings into the returned Properties object. 116 | * @return the loaded and fully resolved Properties object 117 | * @throws IOException if profile does not exist, or cannot be read. 118 | */ 119 | public static Properties loadPropertyFile(Path propfile, boolean fail, boolean useSystemProps) throws IOException { 120 | return loadPropertyFile(propfile, fail, useSystemProps, null); 121 | } 122 | 123 | /** 124 | * Reads a property file, resolving all internal variables. 125 | * 126 | * @param propfile The property file to load 127 | * @param fail whether to throw an exception when the file cannot be loaded or to return null 128 | * @param useSystemProps whether to incorporate System.getProperties settings into the returned Properties object. 129 | * @param logger Logger instance 130 | * @return the loaded and fully resolved Properties object 131 | * @throws IOException if profile does not exist, or cannot be read. 132 | * 133 | * @since 3.1.2 134 | */ 135 | public static Properties loadPropertyFile(Path propfile, boolean fail, boolean useSystemProps, Logger logger) 136 | throws IOException { 137 | 138 | final Properties baseProps = new Properties(); 139 | 140 | if (useSystemProps) { 141 | baseProps.putAll(System.getProperties()); 142 | } 143 | 144 | final Properties resolvedProps = new Properties(); 145 | try { 146 | resolvedProps.putAll(loadPropertyFile(propfile, baseProps, logger)); 147 | } catch (FileNotFoundException e) { 148 | if (fail) { 149 | throw new FileNotFoundException(propfile.toString()); 150 | } 151 | } 152 | 153 | if (useSystemProps) { 154 | resolvedProps.putAll(baseProps); 155 | } 156 | 157 | return resolvedProps; 158 | } 159 | 160 | /** 161 | * Retrieves a property value, replacing values like ${token} using the Properties to look them up. It will leave 162 | * unresolved properties alone, trying for System properties, and implements reparsing (in the case that the value 163 | * of a property contains a key), and will not loop endlessly on a pair like test = ${test}. 164 | * 165 | * @param k 166 | * @param p 167 | * @param logger Logger instance 168 | * @return The filtered property value. 169 | */ 170 | private static String getPropertyValue(String k, Properties p, Logger logger) { 171 | // This can also be done using InterpolationFilterReader, 172 | // but it requires reparsing the file over and over until 173 | // it doesn't change. 174 | 175 | // for cycle detection 176 | List- >> of <<
- >> of <<
- >> of properties files, provided as a parameter to the method
88 |
89 | * Filters defined in the <<<\
- >> of <<
- >> of resources, see {{{./index.html}Introduction}} for the default <<
- >> of
52 | <<
${project.name} ${project.version} is distributed in source format. Use a source archive if you intend to build 30 | ${project.name} yourself. Otherwise, simply use the ready-made binary artifacts from central repository.
31 | 32 |You will be prompted for a mirror - if the file is not found on yours, please be patient, as it may take 24 33 | hours to reach all mirrors.
34 | 35 |In order to guard against corrupted downloads/installations, it is highly recommended to 36 | verify the signature 37 | of the release bundles against the public KEYS used by the Apache Maven 38 | developers.
39 | 40 |${project.name} is distributed under the Apache License, version 2.0.
41 | 42 | We strongly encourage our users to configure a Maven repository mirror closer to their location, please read How to Use Mirrors for Repositories. 43 | 44 | 45 |
48 | [if-any logo]
49 |
50 |
52 |
53 | [end]
54 | The currently selected mirror is
55 | [preferred].
56 | If you encounter a problem with this mirror,
57 | please select another mirror.
58 | If all mirrors are failing, there are
59 | backup
60 | mirrors
61 | (at the end of the mirrors list) that should be available.
62 |
87 | You may also consult the 88 | complete list of 89 | mirrors. 90 |
91 | 92 |This is the current stable version of ${project.name}.
97 | 98 || 102 | | Link | 103 |Checksum | 104 |Signature | 105 |
|---|---|---|---|
| ${project.name} ${project.version} (Source zip) | 110 |maven/shared/${project.artifactId}-${project.version}-source-release.zip | 111 |maven/shared/${project.artifactId}-${project.version}-source-release.zip.sha512 | 112 |maven/shared/${project.artifactId}-${project.version}-source-release.zip.asc | 113 |
Older non-recommended releases can be found on our archive site.
121 | 122 |