Modified: maven/website/components/plugin-tools-archives/plugin-tools-LATEST/apidocs/src-html/org/apache/maven/plugin/plugin/metadata/AddPluginArtifactMetadataMojo.html ============================================================================== --- maven/website/components/plugin-tools-archives/plugin-tools-LATEST/apidocs/src-html/org/apache/maven/plugin/plugin/metadata/AddPluginArtifactMetadataMojo.html (original) +++ maven/website/components/plugin-tools-archives/plugin-tools-LATEST/apidocs/src-html/org/apache/maven/plugin/plugin/metadata/AddPluginArtifactMetadataMojo.html Sat Mar 30 02:00:43 2024 @@ -34,81 +34,82 @@ <span class="sourceLineNo">025</span><a id="line.25">import org.apache.maven.plugin.AbstractMojo;</a> <span class="sourceLineNo">026</span><a id="line.26">import org.apache.maven.plugin.MojoExecutionException;</a> <span class="sourceLineNo">027</span><a id="line.27">import org.apache.maven.plugin.descriptor.PluginDescriptor;</a> -<span class="sourceLineNo">028</span><a id="line.28">import org.apache.maven.plugins.annotations.LifecyclePhase;</a> -<span class="sourceLineNo">029</span><a id="line.29">import org.apache.maven.plugins.annotations.Mojo;</a> -<span class="sourceLineNo">030</span><a id="line.30">import org.apache.maven.plugins.annotations.Parameter;</a> -<span class="sourceLineNo">031</span><a id="line.31">import org.apache.maven.project.MavenProject;</a> -<span class="sourceLineNo">032</span><a id="line.32"></a> -<span class="sourceLineNo">033</span><a id="line.33">/**</a> -<span class="sourceLineNo">034</span><a id="line.34"> * Inject any plugin-specific</a> -<span class="sourceLineNo">035</span><a id="line.35"> * <a href="/ref/current/maven-repository-metadata/repository-metadata.html">artifact metadata</a> to the project's</a> -<span class="sourceLineNo">036</span><a id="line.36"> * artifact, for subsequent installation and deployment.</a> -<span class="sourceLineNo">037</span><a id="line.37"> * It is used:</a> -<span class="sourceLineNo">038</span><a id="line.38"> * <ol></a> -<span class="sourceLineNo">039</span><a id="line.39"> * <li>to add the <code>latest</code> metadata (which is plugin-specific) for shipping alongside the plugin's</a> -<span class="sourceLineNo">040</span><a id="line.40"> * artifact</li></a> -<span class="sourceLineNo">041</span><a id="line.41"> * <li>to define plugin mapping in the group</li></a> -<span class="sourceLineNo">042</span><a id="line.42"> * </ol></a> -<span class="sourceLineNo">043</span><a id="line.43"> *</a> -<span class="sourceLineNo">044</span><a id="line.44"> * @see ArtifactRepositoryMetadata</a> -<span class="sourceLineNo">045</span><a id="line.45"> * @see GroupRepositoryMetadata</a> -<span class="sourceLineNo">046</span><a id="line.46"> *</a> -<span class="sourceLineNo">047</span><a id="line.47"> * @since 2.0</a> -<span class="sourceLineNo">048</span><a id="line.48"> */</a> -<span class="sourceLineNo">049</span><a id="line.49">@Mojo(name = "addPluginArtifactMetadata", defaultPhase = LifecyclePhase.PACKAGE, threadSafe = true)</a> -<span class="sourceLineNo">050</span><a id="line.50">public class AddPluginArtifactMetadataMojo extends AbstractMojo {</a> -<span class="sourceLineNo">051</span><a id="line.51"> /**</a> -<span class="sourceLineNo">052</span><a id="line.52"> * The project artifact, which should have the <code>latest</code> metadata added to it.</a> -<span class="sourceLineNo">053</span><a id="line.53"> */</a> -<span class="sourceLineNo">054</span><a id="line.54"> @Parameter(defaultValue = "${project}", readonly = true)</a> -<span class="sourceLineNo">055</span><a id="line.55"> private MavenProject project;</a> -<span class="sourceLineNo">056</span><a id="line.56"></a> -<span class="sourceLineNo">057</span><a id="line.57"> /**</a> -<span class="sourceLineNo">058</span><a id="line.58"> * The prefix for the plugin goal.</a> -<span class="sourceLineNo">059</span><a id="line.59"> */</a> -<span class="sourceLineNo">060</span><a id="line.60"> @Parameter</a> -<span class="sourceLineNo">061</span><a id="line.61"> private String goalPrefix;</a> -<span class="sourceLineNo">062</span><a id="line.62"></a> -<span class="sourceLineNo">063</span><a id="line.63"> /**</a> -<span class="sourceLineNo">064</span><a id="line.64"> * Set this to "true" to skip invoking any goals or reports of the plugin.</a> -<span class="sourceLineNo">065</span><a id="line.65"> *</a> -<span class="sourceLineNo">066</span><a id="line.66"> * @since 2.8</a> -<span class="sourceLineNo">067</span><a id="line.67"> */</a> -<span class="sourceLineNo">068</span><a id="line.68"> @Parameter(defaultValue = "false", property = "maven.plugin.skip")</a> -<span class="sourceLineNo">069</span><a id="line.69"> private boolean skip;</a> -<span class="sourceLineNo">070</span><a id="line.70"></a> -<span class="sourceLineNo">071</span><a id="line.71"> /** {@inheritDoc} */</a> -<span class="sourceLineNo">072</span><a id="line.72"> @Override</a> -<span class="sourceLineNo">073</span><a id="line.73"> public void execute() throws MojoExecutionException {</a> -<span class="sourceLineNo">074</span><a id="line.74"> if (skip) {</a> -<span class="sourceLineNo">075</span><a id="line.75"> getLog().warn("Execution skipped");</a> -<span class="sourceLineNo">076</span><a id="line.76"> return;</a> -<span class="sourceLineNo">077</span><a id="line.77"> }</a> -<span class="sourceLineNo">078</span><a id="line.78"> Artifact projectArtifact = project.getArtifact();</a> -<span class="sourceLineNo">079</span><a id="line.79"></a> -<span class="sourceLineNo">080</span><a id="line.80"> Versioning versioning = new Versioning();</a> -<span class="sourceLineNo">081</span><a id="line.81"> versioning.setLatest(projectArtifact.getVersion());</a> -<span class="sourceLineNo">082</span><a id="line.82"> versioning.updateTimestamp();</a> -<span class="sourceLineNo">083</span><a id="line.83"> ArtifactRepositoryMetadata metadata = new ArtifactRepositoryMetadata(projectArtifact, versioning);</a> -<span class="sourceLineNo">084</span><a id="line.84"> projectArtifact.addMetadata(metadata);</a> -<span class="sourceLineNo">085</span><a id="line.85"></a> -<span class="sourceLineNo">086</span><a id="line.86"> GroupRepositoryMetadata groupMetadata = new GroupRepositoryMetadata(project.getGroupId());</a> -<span class="sourceLineNo">087</span><a id="line.87"> groupMetadata.addPluginMapping(getGoalPrefix(), project.getArtifactId(), project.getName());</a> -<span class="sourceLineNo">088</span><a id="line.88"></a> -<span class="sourceLineNo">089</span><a id="line.89"> projectArtifact.addMetadata(groupMetadata);</a> -<span class="sourceLineNo">090</span><a id="line.90"> }</a> -<span class="sourceLineNo">091</span><a id="line.91"></a> -<span class="sourceLineNo">092</span><a id="line.92"> /**</a> -<span class="sourceLineNo">093</span><a id="line.93"> * @return the goal prefix parameter or the goal prefix from the Plugin artifactId.</a> -<span class="sourceLineNo">094</span><a id="line.94"> */</a> -<span class="sourceLineNo">095</span><a id="line.95"> private String getGoalPrefix() {</a> -<span class="sourceLineNo">096</span><a id="line.96"> if (goalPrefix == null) {</a> -<span class="sourceLineNo">097</span><a id="line.97"> goalPrefix = PluginDescriptor.getGoalPrefixFromArtifactId(project.getArtifactId());</a> -<span class="sourceLineNo">098</span><a id="line.98"> }</a> -<span class="sourceLineNo">099</span><a id="line.99"></a> -<span class="sourceLineNo">100</span><a id="line.100"> return goalPrefix;</a> -<span class="sourceLineNo">101</span><a id="line.101"> }</a> -<span class="sourceLineNo">102</span><a id="line.102">}</a> +<span class="sourceLineNo">028</span><a id="line.28">import org.apache.maven.plugins.annotations.Component;</a> +<span class="sourceLineNo">029</span><a id="line.29">import org.apache.maven.plugins.annotations.LifecyclePhase;</a> +<span class="sourceLineNo">030</span><a id="line.30">import org.apache.maven.plugins.annotations.Mojo;</a> +<span class="sourceLineNo">031</span><a id="line.31">import org.apache.maven.plugins.annotations.Parameter;</a> +<span class="sourceLineNo">032</span><a id="line.32">import org.apache.maven.project.MavenProject;</a> +<span class="sourceLineNo">033</span><a id="line.33"></a> +<span class="sourceLineNo">034</span><a id="line.34">/**</a> +<span class="sourceLineNo">035</span><a id="line.35"> * Inject any plugin-specific</a> +<span class="sourceLineNo">036</span><a id="line.36"> * <a href="/ref/current/maven-repository-metadata/repository-metadata.html">artifact metadata</a> to the project's</a> +<span class="sourceLineNo">037</span><a id="line.37"> * artifact, for subsequent installation and deployment.</a> +<span class="sourceLineNo">038</span><a id="line.38"> * It is used:</a> +<span class="sourceLineNo">039</span><a id="line.39"> * <ol></a> +<span class="sourceLineNo">040</span><a id="line.40"> * <li>to add the <code>latest</code> metadata (which is plugin-specific) for shipping alongside the plugin's</a> +<span class="sourceLineNo">041</span><a id="line.41"> * artifact</li></a> +<span class="sourceLineNo">042</span><a id="line.42"> * <li>to define plugin mapping in the group</li></a> +<span class="sourceLineNo">043</span><a id="line.43"> * </ol></a> +<span class="sourceLineNo">044</span><a id="line.44"> *</a> +<span class="sourceLineNo">045</span><a id="line.45"> * @see ArtifactRepositoryMetadata</a> +<span class="sourceLineNo">046</span><a id="line.46"> * @see GroupRepositoryMetadata</a> +<span class="sourceLineNo">047</span><a id="line.47"> *</a> +<span class="sourceLineNo">048</span><a id="line.48"> * @since 2.0</a> +<span class="sourceLineNo">049</span><a id="line.49"> */</a> +<span class="sourceLineNo">050</span><a id="line.50">@Mojo(name = "addPluginArtifactMetadata", defaultPhase = LifecyclePhase.PACKAGE, threadSafe = true)</a> +<span class="sourceLineNo">051</span><a id="line.51">public class AddPluginArtifactMetadataMojo extends AbstractMojo {</a> +<span class="sourceLineNo">052</span><a id="line.52"> /**</a> +<span class="sourceLineNo">053</span><a id="line.53"> * The project artifact, which should have the <code>latest</code> metadata added to it.</a> +<span class="sourceLineNo">054</span><a id="line.54"> */</a> +<span class="sourceLineNo">055</span><a id="line.55"> @Component</a> +<span class="sourceLineNo">056</span><a id="line.56"> private MavenProject project;</a> +<span class="sourceLineNo">057</span><a id="line.57"></a> +<span class="sourceLineNo">058</span><a id="line.58"> /**</a> +<span class="sourceLineNo">059</span><a id="line.59"> * The prefix for the plugin goal.</a> +<span class="sourceLineNo">060</span><a id="line.60"> */</a> +<span class="sourceLineNo">061</span><a id="line.61"> @Parameter</a> +<span class="sourceLineNo">062</span><a id="line.62"> private String goalPrefix;</a> +<span class="sourceLineNo">063</span><a id="line.63"></a> +<span class="sourceLineNo">064</span><a id="line.64"> /**</a> +<span class="sourceLineNo">065</span><a id="line.65"> * Set this to "true" to skip invoking any goals or reports of the plugin.</a> +<span class="sourceLineNo">066</span><a id="line.66"> *</a> +<span class="sourceLineNo">067</span><a id="line.67"> * @since 2.8</a> +<span class="sourceLineNo">068</span><a id="line.68"> */</a> +<span class="sourceLineNo">069</span><a id="line.69"> @Parameter(defaultValue = "false", property = "maven.plugin.skip")</a> +<span class="sourceLineNo">070</span><a id="line.70"> private boolean skip;</a> +<span class="sourceLineNo">071</span><a id="line.71"></a> +<span class="sourceLineNo">072</span><a id="line.72"> /** {@inheritDoc} */</a> +<span class="sourceLineNo">073</span><a id="line.73"> @Override</a> +<span class="sourceLineNo">074</span><a id="line.74"> public void execute() throws MojoExecutionException {</a> +<span class="sourceLineNo">075</span><a id="line.75"> if (skip) {</a> +<span class="sourceLineNo">076</span><a id="line.76"> getLog().warn("Execution skipped");</a> +<span class="sourceLineNo">077</span><a id="line.77"> return;</a> +<span class="sourceLineNo">078</span><a id="line.78"> }</a> +<span class="sourceLineNo">079</span><a id="line.79"> Artifact projectArtifact = project.getArtifact();</a> +<span class="sourceLineNo">080</span><a id="line.80"></a> +<span class="sourceLineNo">081</span><a id="line.81"> Versioning versioning = new Versioning();</a> +<span class="sourceLineNo">082</span><a id="line.82"> versioning.setLatest(projectArtifact.getVersion());</a> +<span class="sourceLineNo">083</span><a id="line.83"> versioning.updateTimestamp();</a> +<span class="sourceLineNo">084</span><a id="line.84"> ArtifactRepositoryMetadata metadata = new ArtifactRepositoryMetadata(projectArtifact, versioning);</a> +<span class="sourceLineNo">085</span><a id="line.85"> projectArtifact.addMetadata(metadata);</a> +<span class="sourceLineNo">086</span><a id="line.86"></a> +<span class="sourceLineNo">087</span><a id="line.87"> GroupRepositoryMetadata groupMetadata = new GroupRepositoryMetadata(project.getGroupId());</a> +<span class="sourceLineNo">088</span><a id="line.88"> groupMetadata.addPluginMapping(getGoalPrefix(), project.getArtifactId(), project.getName());</a> +<span class="sourceLineNo">089</span><a id="line.89"></a> +<span class="sourceLineNo">090</span><a id="line.90"> projectArtifact.addMetadata(groupMetadata);</a> +<span class="sourceLineNo">091</span><a id="line.91"> }</a> +<span class="sourceLineNo">092</span><a id="line.92"></a> +<span class="sourceLineNo">093</span><a id="line.93"> /**</a> +<span class="sourceLineNo">094</span><a id="line.94"> * @return the goal prefix parameter or the goal prefix from the Plugin artifactId.</a> +<span class="sourceLineNo">095</span><a id="line.95"> */</a> +<span class="sourceLineNo">096</span><a id="line.96"> private String getGoalPrefix() {</a> +<span class="sourceLineNo">097</span><a id="line.97"> if (goalPrefix == null) {</a> +<span class="sourceLineNo">098</span><a id="line.98"> goalPrefix = PluginDescriptor.getGoalPrefixFromArtifactId(project.getArtifactId());</a> +<span class="sourceLineNo">099</span><a id="line.99"> }</a> +<span class="sourceLineNo">100</span><a id="line.100"></a> +<span class="sourceLineNo">101</span><a id="line.101"> return goalPrefix;</a> +<span class="sourceLineNo">102</span><a id="line.102"> }</a> +<span class="sourceLineNo">103</span><a id="line.103">}</a>
Modified: maven/website/components/plugin-tools-archives/plugin-tools-LATEST/apidocs/src-html/org/apache/maven/plugin/plugin/report/PluginReport.html ============================================================================== --- maven/website/components/plugin-tools-archives/plugin-tools-LATEST/apidocs/src-html/org/apache/maven/plugin/plugin/report/PluginReport.html (original) +++ maven/website/components/plugin-tools-archives/plugin-tools-LATEST/apidocs/src-html/org/apache/maven/plugin/plugin/report/PluginReport.html Sat Mar 30 02:00:43 2024 @@ -198,141 +198,147 @@ <span class="sourceLineNo">189</span><a id="line.189"> String v = null;</a> <span class="sourceLineNo">190</span><a id="line.190"> try {</a> <span class="sourceLineNo">191</span><a id="line.191"> List<Version> versions = discoverVersions(requirementsHistoryDetectionRange);</a> -<span class="sourceLineNo">192</span><a id="line.192"> getLog().info("Detecting requirements history for " + requirementsHistoryDetectionRange + ": "</a> -<span class="sourceLineNo">193</span><a id="line.193"> + versions.size());</a> -<span class="sourceLineNo">194</span><a id="line.194"></a> -<span class="sourceLineNo">195</span><a id="line.195"> Collections.reverse(versions);</a> -<span class="sourceLineNo">196</span><a id="line.196"> for (Version version : versions) {</a> -<span class="sourceLineNo">197</span><a id="line.197"> v = version.toString();</a> -<span class="sourceLineNo">198</span><a id="line.198"> MavenProject versionProject = buildMavenProject(v);</a> -<span class="sourceLineNo">199</span><a id="line.199"> RequirementsHistory requirements = RequirementsHistory.discoverRequirements(versionProject);</a> -<span class="sourceLineNo">200</span><a id="line.200"> requirementsHistories.add(requirements);</a> -<span class="sourceLineNo">201</span><a id="line.201"> getLog().info(" - " + requirements);</a> -<span class="sourceLineNo">202</span><a id="line.202"> }</a> -<span class="sourceLineNo">203</span><a id="line.203"> } catch (VersionRangeResolutionException vrre) {</a> -<span class="sourceLineNo">204</span><a id="line.204"> throw new MavenReportException(</a> -<span class="sourceLineNo">205</span><a id="line.205"> "Cannot resolve past versions " + requirementsHistoryDetectionRange, vrre);</a> -<span class="sourceLineNo">206</span><a id="line.206"> } catch (ProjectBuildingException pbe) {</a> -<span class="sourceLineNo">207</span><a id="line.207"> throw new MavenReportException("Cannot resolve MavenProject for version " + v, pbe);</a> -<span class="sourceLineNo">208</span><a id="line.208"> }</a> -<span class="sourceLineNo">209</span><a id="line.209"> }</a> -<span class="sourceLineNo">210</span><a id="line.210"></a> -<span class="sourceLineNo">211</span><a id="line.211"> // Write the overview</a> -<span class="sourceLineNo">212</span><a id="line.212"> PluginOverviewRenderer r = new PluginOverviewRenderer(</a> -<span class="sourceLineNo">213</span><a id="line.213"> getSink(), i18n, locale, getProject(), requirementsHistories, pluginDescriptor, hasExtensionsToLoad);</a> -<span class="sourceLineNo">214</span><a id="line.214"> r.render();</a> -<span class="sourceLineNo">215</span><a id="line.215"> }</a> +<span class="sourceLineNo">192</span><a id="line.192"> if (versions.isEmpty()) {</a> +<span class="sourceLineNo">193</span><a id="line.193"> getLog().info("No plugin history found for range " + requirementsHistoryDetectionRange);</a> +<span class="sourceLineNo">194</span><a id="line.194"> } else {</a> +<span class="sourceLineNo">195</span><a id="line.195"> getLog().info("Detecting plugin requirements history for range "</a> +<span class="sourceLineNo">196</span><a id="line.196"> + requirementsHistoryDetectionRange + ": "</a> +<span class="sourceLineNo">197</span><a id="line.197"> + versions.size() + " releases, from " + versions.get(0) + " to "</a> +<span class="sourceLineNo">198</span><a id="line.198"> + versions.get(versions.size() - 1));</a> +<span class="sourceLineNo">199</span><a id="line.199"> }</a> +<span class="sourceLineNo">200</span><a id="line.200"></a> +<span class="sourceLineNo">201</span><a id="line.201"> Collections.reverse(versions);</a> +<span class="sourceLineNo">202</span><a id="line.202"> for (Version version : versions) {</a> +<span class="sourceLineNo">203</span><a id="line.203"> v = version.toString();</a> +<span class="sourceLineNo">204</span><a id="line.204"> MavenProject versionProject = buildMavenProject(v);</a> +<span class="sourceLineNo">205</span><a id="line.205"> RequirementsHistory requirements = RequirementsHistory.discoverRequirements(versionProject);</a> +<span class="sourceLineNo">206</span><a id="line.206"> requirementsHistories.add(requirements);</a> +<span class="sourceLineNo">207</span><a id="line.207"> getLog().info(" - " + requirements);</a> +<span class="sourceLineNo">208</span><a id="line.208"> }</a> +<span class="sourceLineNo">209</span><a id="line.209"> } catch (VersionRangeResolutionException vrre) {</a> +<span class="sourceLineNo">210</span><a id="line.210"> throw new MavenReportException(</a> +<span class="sourceLineNo">211</span><a id="line.211"> "Cannot resolve past versions " + requirementsHistoryDetectionRange, vrre);</a> +<span class="sourceLineNo">212</span><a id="line.212"> } catch (ProjectBuildingException pbe) {</a> +<span class="sourceLineNo">213</span><a id="line.213"> throw new MavenReportException("Cannot resolve MavenProject for version " + v, pbe);</a> +<span class="sourceLineNo">214</span><a id="line.214"> }</a> +<span class="sourceLineNo">215</span><a id="line.215"> }</a> <span class="sourceLineNo">216</span><a id="line.216"></a> -<span class="sourceLineNo">217</span><a id="line.217"> private PluginDescriptor extractPluginDescriptor() throws MavenReportException {</a> -<span class="sourceLineNo">218</span><a id="line.218"> PluginDescriptorBuilder builder = new EnhancedPluginDescriptorBuilder(rtInfo);</a> -<span class="sourceLineNo">219</span><a id="line.219"></a> -<span class="sourceLineNo">220</span><a id="line.220"> try (Reader input = new XmlStreamReader(Files.newInputStream(enhancedPluginXmlFile.toPath()))) {</a> -<span class="sourceLineNo">221</span><a id="line.221"> return builder.build(input);</a> -<span class="sourceLineNo">222</span><a id="line.222"> } catch (IOException | PlexusConfigurationException e) {</a> -<span class="sourceLineNo">223</span><a id="line.223"> throw new MavenReportException("Error extracting plugin descriptor from " + enhancedPluginXmlFile, e);</a> -<span class="sourceLineNo">224</span><a id="line.224"> }</a> -<span class="sourceLineNo">225</span><a id="line.225"> }</a> -<span class="sourceLineNo">226</span><a id="line.226"></a> -<span class="sourceLineNo">227</span><a id="line.227"> /**</a> -<span class="sourceLineNo">228</span><a id="line.228"> * @param locale The locale</a> -<span class="sourceLineNo">229</span><a id="line.229"> * @param key The key to search for</a> -<span class="sourceLineNo">230</span><a id="line.230"> * @return The text appropriate for the locale.</a> -<span class="sourceLineNo">231</span><a id="line.231"> */</a> -<span class="sourceLineNo">232</span><a id="line.232"> private String getI18nString(Locale locale, String key) {</a> -<span class="sourceLineNo">233</span><a id="line.233"> return i18n.getString("plugin-report", locale, "report.plugin." + key);</a> -<span class="sourceLineNo">234</span><a id="line.234"> }</a> -<span class="sourceLineNo">235</span><a id="line.235"></a> -<span class="sourceLineNo">236</span><a id="line.236"> /**</a> -<span class="sourceLineNo">237</span><a id="line.237"> * {@inheritDoc}</a> -<span class="sourceLineNo">238</span><a id="line.238"> */</a> -<span class="sourceLineNo">239</span><a id="line.239"> @Override</a> -<span class="sourceLineNo">240</span><a id="line.240"> public String getName(Locale locale) {</a> -<span class="sourceLineNo">241</span><a id="line.241"> return getI18nString(locale, "name");</a> -<span class="sourceLineNo">242</span><a id="line.242"> }</a> -<span class="sourceLineNo">243</span><a id="line.243"></a> -<span class="sourceLineNo">244</span><a id="line.244"> /**</a> -<span class="sourceLineNo">245</span><a id="line.245"> * {@inheritDoc}</a> -<span class="sourceLineNo">246</span><a id="line.246"> */</a> -<span class="sourceLineNo">247</span><a id="line.247"> @Override</a> -<span class="sourceLineNo">248</span><a id="line.248"> public String getDescription(Locale locale) {</a> -<span class="sourceLineNo">249</span><a id="line.249"> return getI18nString(locale, "description");</a> -<span class="sourceLineNo">250</span><a id="line.250"> }</a> -<span class="sourceLineNo">251</span><a id="line.251"></a> -<span class="sourceLineNo">252</span><a id="line.252"> /**</a> -<span class="sourceLineNo">253</span><a id="line.253"> * {@inheritDoc}</a> -<span class="sourceLineNo">254</span><a id="line.254"> */</a> -<span class="sourceLineNo">255</span><a id="line.255"> @Override</a> -<span class="sourceLineNo">256</span><a id="line.256"> public String getOutputName() {</a> -<span class="sourceLineNo">257</span><a id="line.257"> return "plugin-info";</a> -<span class="sourceLineNo">258</span><a id="line.258"> }</a> -<span class="sourceLineNo">259</span><a id="line.259"></a> -<span class="sourceLineNo">260</span><a id="line.260"> /**</a> -<span class="sourceLineNo">261</span><a id="line.261"> * Generate the mojos' documentation with the {@link #getSinkFactory()}</a> -<span class="sourceLineNo">262</span><a id="line.262"> *</a> -<span class="sourceLineNo">263</span><a id="line.263"> * @param pluginDescriptor not null</a> -<span class="sourceLineNo">264</span><a id="line.264"> * @param locale not null</a> -<span class="sourceLineNo">265</span><a id="line.265"> * @throws MavenReportException if any</a> -<span class="sourceLineNo">266</span><a id="line.266"> * @throws IOException</a> -<span class="sourceLineNo">267</span><a id="line.267"> */</a> -<span class="sourceLineNo">268</span><a id="line.268"> private void generateMojosDocumentation(PluginDescriptor pluginDescriptor, Locale locale)</a> -<span class="sourceLineNo">269</span><a id="line.269"> throws MavenReportException {</a> -<span class="sourceLineNo">270</span><a id="line.270"></a> -<span class="sourceLineNo">271</span><a id="line.271"> if (pluginDescriptor.getMojos() != null) {</a> -<span class="sourceLineNo">272</span><a id="line.272"> for (MojoDescriptor descriptor : pluginDescriptor.getMojos()) {</a> -<span class="sourceLineNo">273</span><a id="line.273"> GoalRenderer renderer;</a> -<span class="sourceLineNo">274</span><a id="line.274"> try {</a> -<span class="sourceLineNo">275</span><a id="line.275"> String filename = descriptor.getGoal() + "-mojo.html";</a> -<span class="sourceLineNo">276</span><a id="line.276"> Sink sink = getSinkFactory().createSink(getReportOutputDirectory(), filename);</a> -<span class="sourceLineNo">277</span><a id="line.277"> renderer = new GoalRenderer(</a> -<span class="sourceLineNo">278</span><a id="line.278"> sink,</a> -<span class="sourceLineNo">279</span><a id="line.279"> i18n,</a> -<span class="sourceLineNo">280</span><a id="line.280"> locale,</a> -<span class="sourceLineNo">281</span><a id="line.281"> project,</a> -<span class="sourceLineNo">282</span><a id="line.282"> descriptor,</a> -<span class="sourceLineNo">283</span><a id="line.283"> getReportOutputDirectory(),</a> -<span class="sourceLineNo">284</span><a id="line.284"> disableInternalJavadocLinkValidation,</a> -<span class="sourceLineNo">285</span><a id="line.285"> getLog());</a> -<span class="sourceLineNo">286</span><a id="line.286"> } catch (IOException e) {</a> -<span class="sourceLineNo">287</span><a id="line.287"> throw new MavenReportException("Cannot generate sink for mojo " + descriptor.getGoal(), e);</a> -<span class="sourceLineNo">288</span><a id="line.288"> }</a> -<span class="sourceLineNo">289</span><a id="line.289"> renderer.render();</a> -<span class="sourceLineNo">290</span><a id="line.290"> }</a> -<span class="sourceLineNo">291</span><a id="line.291"> }</a> -<span class="sourceLineNo">292</span><a id="line.292"> }</a> -<span class="sourceLineNo">293</span><a id="line.293"></a> -<span class="sourceLineNo">294</span><a id="line.294"> private List<Version> discoverVersions(String range) throws VersionRangeResolutionException {</a> -<span class="sourceLineNo">295</span><a id="line.295"> MavenProject currentProject = mavenSession.getCurrentProject();</a> -<span class="sourceLineNo">296</span><a id="line.296"> VersionRangeRequest rangeRequest = new VersionRangeRequest();</a> -<span class="sourceLineNo">297</span><a id="line.297"> rangeRequest.setArtifact(</a> -<span class="sourceLineNo">298</span><a id="line.298"> new DefaultArtifact(currentProject.getGroupId() + ":" + currentProject.getArtifactId() + ":" + range));</a> -<span class="sourceLineNo">299</span><a id="line.299"> rangeRequest.setRepositories(</a> -<span class="sourceLineNo">300</span><a id="line.300"> RepositoryUtils.toRepos(mavenSession.getCurrentProject().getRemoteArtifactRepositories()));</a> -<span class="sourceLineNo">301</span><a id="line.301"> VersionRangeResult rangeResult =</a> -<span class="sourceLineNo">302</span><a id="line.302"> repositorySystem.resolveVersionRange(mavenSession.getRepositorySession(), rangeRequest);</a> -<span class="sourceLineNo">303</span><a id="line.303"> return rangeResult.getVersions().stream()</a> -<span class="sourceLineNo">304</span><a id="line.304"> .filter(version -> !ArtifactUtils.isSnapshot(version.toString()))</a> -<span class="sourceLineNo">305</span><a id="line.305"> .collect(Collectors.toList());</a> -<span class="sourceLineNo">306</span><a id="line.306"> }</a> -<span class="sourceLineNo">307</span><a id="line.307"></a> -<span class="sourceLineNo">308</span><a id="line.308"> private MavenProject buildMavenProject(String version) throws ProjectBuildingException {</a> -<span class="sourceLineNo">309</span><a id="line.309"> MavenProject currentProject = mavenSession.getCurrentProject();</a> -<span class="sourceLineNo">310</span><a id="line.310"> ProjectBuildingRequest buildRequest = new DefaultProjectBuildingRequest();</a> -<span class="sourceLineNo">311</span><a id="line.311"> buildRequest.setLocalRepository(mavenSession.getLocalRepository());</a> -<span class="sourceLineNo">312</span><a id="line.312"> buildRequest.setRemoteRepositories(mavenSession.getCurrentProject().getRemoteArtifactRepositories());</a> -<span class="sourceLineNo">313</span><a id="line.313"> buildRequest.setValidationLevel(ModelBuildingRequest.VALIDATION_LEVEL_MINIMAL);</a> -<span class="sourceLineNo">314</span><a id="line.314"> buildRequest.setProcessPlugins(false);</a> -<span class="sourceLineNo">315</span><a id="line.315"> buildRequest.setRepositoryMerging(ProjectBuildingRequest.RepositoryMerging.REQUEST_DOMINANT);</a> -<span class="sourceLineNo">316</span><a id="line.316"> buildRequest.setSystemProperties(mavenSession.getSystemProperties());</a> -<span class="sourceLineNo">317</span><a id="line.317"> buildRequest.setUserProperties(mavenSession.getUserProperties());</a> -<span class="sourceLineNo">318</span><a id="line.318"> buildRequest.setRepositorySession(mavenSession.getRepositorySession());</a> -<span class="sourceLineNo">319</span><a id="line.319"> return projectBuilder</a> -<span class="sourceLineNo">320</span><a id="line.320"> .build(</a> -<span class="sourceLineNo">321</span><a id="line.321"> RepositoryUtils.toArtifact(new DefaultArtifact(currentProject.getGroupId() + ":"</a> -<span class="sourceLineNo">322</span><a id="line.322"> + currentProject.getArtifactId() + ":pom:" + version)),</a> -<span class="sourceLineNo">323</span><a id="line.323"> buildRequest)</a> -<span class="sourceLineNo">324</span><a id="line.324"> .getProject();</a> -<span class="sourceLineNo">325</span><a id="line.325"> }</a> -<span class="sourceLineNo">326</span><a id="line.326">}</a> +<span class="sourceLineNo">217</span><a id="line.217"> // Write the overview</a> +<span class="sourceLineNo">218</span><a id="line.218"> PluginOverviewRenderer r = new PluginOverviewRenderer(</a> +<span class="sourceLineNo">219</span><a id="line.219"> getSink(), i18n, locale, getProject(), requirementsHistories, pluginDescriptor, hasExtensionsToLoad);</a> +<span class="sourceLineNo">220</span><a id="line.220"> r.render();</a> +<span class="sourceLineNo">221</span><a id="line.221"> }</a> +<span class="sourceLineNo">222</span><a id="line.222"></a> +<span class="sourceLineNo">223</span><a id="line.223"> private PluginDescriptor extractPluginDescriptor() throws MavenReportException {</a> +<span class="sourceLineNo">224</span><a id="line.224"> PluginDescriptorBuilder builder = new EnhancedPluginDescriptorBuilder(rtInfo);</a> +<span class="sourceLineNo">225</span><a id="line.225"></a> +<span class="sourceLineNo">226</span><a id="line.226"> try (Reader input = new XmlStreamReader(Files.newInputStream(enhancedPluginXmlFile.toPath()))) {</a> +<span class="sourceLineNo">227</span><a id="line.227"> return builder.build(input);</a> +<span class="sourceLineNo">228</span><a id="line.228"> } catch (IOException | PlexusConfigurationException e) {</a> +<span class="sourceLineNo">229</span><a id="line.229"> throw new MavenReportException("Error extracting plugin descriptor from " + enhancedPluginXmlFile, e);</a> +<span class="sourceLineNo">230</span><a id="line.230"> }</a> +<span class="sourceLineNo">231</span><a id="line.231"> }</a> +<span class="sourceLineNo">232</span><a id="line.232"></a> +<span class="sourceLineNo">233</span><a id="line.233"> /**</a> +<span class="sourceLineNo">234</span><a id="line.234"> * @param locale The locale</a> +<span class="sourceLineNo">235</span><a id="line.235"> * @param key The key to search for</a> +<span class="sourceLineNo">236</span><a id="line.236"> * @return The text appropriate for the locale.</a> +<span class="sourceLineNo">237</span><a id="line.237"> */</a> +<span class="sourceLineNo">238</span><a id="line.238"> private String getI18nString(Locale locale, String key) {</a> +<span class="sourceLineNo">239</span><a id="line.239"> return i18n.getString("plugin-report", locale, "report.plugin." + key);</a> +<span class="sourceLineNo">240</span><a id="line.240"> }</a> +<span class="sourceLineNo">241</span><a id="line.241"></a> +<span class="sourceLineNo">242</span><a id="line.242"> /**</a> +<span class="sourceLineNo">243</span><a id="line.243"> * {@inheritDoc}</a> +<span class="sourceLineNo">244</span><a id="line.244"> */</a> +<span class="sourceLineNo">245</span><a id="line.245"> @Override</a> +<span class="sourceLineNo">246</span><a id="line.246"> public String getName(Locale locale) {</a> +<span class="sourceLineNo">247</span><a id="line.247"> return getI18nString(locale, "name");</a> +<span class="sourceLineNo">248</span><a id="line.248"> }</a> +<span class="sourceLineNo">249</span><a id="line.249"></a> +<span class="sourceLineNo">250</span><a id="line.250"> /**</a> +<span class="sourceLineNo">251</span><a id="line.251"> * {@inheritDoc}</a> +<span class="sourceLineNo">252</span><a id="line.252"> */</a> +<span class="sourceLineNo">253</span><a id="line.253"> @Override</a> +<span class="sourceLineNo">254</span><a id="line.254"> public String getDescription(Locale locale) {</a> +<span class="sourceLineNo">255</span><a id="line.255"> return getI18nString(locale, "description");</a> +<span class="sourceLineNo">256</span><a id="line.256"> }</a> +<span class="sourceLineNo">257</span><a id="line.257"></a> +<span class="sourceLineNo">258</span><a id="line.258"> /**</a> +<span class="sourceLineNo">259</span><a id="line.259"> * {@inheritDoc}</a> +<span class="sourceLineNo">260</span><a id="line.260"> */</a> +<span class="sourceLineNo">261</span><a id="line.261"> @Override</a> +<span class="sourceLineNo">262</span><a id="line.262"> public String getOutputName() {</a> +<span class="sourceLineNo">263</span><a id="line.263"> return "plugin-info";</a> +<span class="sourceLineNo">264</span><a id="line.264"> }</a> +<span class="sourceLineNo">265</span><a id="line.265"></a> +<span class="sourceLineNo">266</span><a id="line.266"> /**</a> +<span class="sourceLineNo">267</span><a id="line.267"> * Generate the mojos' documentation with the {@link #getSinkFactory()}</a> +<span class="sourceLineNo">268</span><a id="line.268"> *</a> +<span class="sourceLineNo">269</span><a id="line.269"> * @param pluginDescriptor not null</a> +<span class="sourceLineNo">270</span><a id="line.270"> * @param locale not null</a> +<span class="sourceLineNo">271</span><a id="line.271"> * @throws MavenReportException if any</a> +<span class="sourceLineNo">272</span><a id="line.272"> * @throws IOException</a> +<span class="sourceLineNo">273</span><a id="line.273"> */</a> +<span class="sourceLineNo">274</span><a id="line.274"> private void generateMojosDocumentation(PluginDescriptor pluginDescriptor, Locale locale)</a> +<span class="sourceLineNo">275</span><a id="line.275"> throws MavenReportException {</a> +<span class="sourceLineNo">276</span><a id="line.276"></a> +<span class="sourceLineNo">277</span><a id="line.277"> if (pluginDescriptor.getMojos() != null) {</a> +<span class="sourceLineNo">278</span><a id="line.278"> for (MojoDescriptor descriptor : pluginDescriptor.getMojos()) {</a> +<span class="sourceLineNo">279</span><a id="line.279"> GoalRenderer renderer;</a> +<span class="sourceLineNo">280</span><a id="line.280"> try {</a> +<span class="sourceLineNo">281</span><a id="line.281"> String filename = descriptor.getGoal() + "-mojo.html";</a> +<span class="sourceLineNo">282</span><a id="line.282"> Sink sink = getSinkFactory().createSink(getReportOutputDirectory(), filename);</a> +<span class="sourceLineNo">283</span><a id="line.283"> renderer = new GoalRenderer(</a> +<span class="sourceLineNo">284</span><a id="line.284"> sink,</a> +<span class="sourceLineNo">285</span><a id="line.285"> i18n,</a> +<span class="sourceLineNo">286</span><a id="line.286"> locale,</a> +<span class="sourceLineNo">287</span><a id="line.287"> project,</a> +<span class="sourceLineNo">288</span><a id="line.288"> descriptor,</a> +<span class="sourceLineNo">289</span><a id="line.289"> getReportOutputDirectory(),</a> +<span class="sourceLineNo">290</span><a id="line.290"> disableInternalJavadocLinkValidation,</a> +<span class="sourceLineNo">291</span><a id="line.291"> getLog());</a> +<span class="sourceLineNo">292</span><a id="line.292"> } catch (IOException e) {</a> +<span class="sourceLineNo">293</span><a id="line.293"> throw new MavenReportException("Cannot generate sink for mojo " + descriptor.getGoal(), e);</a> +<span class="sourceLineNo">294</span><a id="line.294"> }</a> +<span class="sourceLineNo">295</span><a id="line.295"> renderer.render();</a> +<span class="sourceLineNo">296</span><a id="line.296"> }</a> +<span class="sourceLineNo">297</span><a id="line.297"> }</a> +<span class="sourceLineNo">298</span><a id="line.298"> }</a> +<span class="sourceLineNo">299</span><a id="line.299"></a> +<span class="sourceLineNo">300</span><a id="line.300"> private List<Version> discoverVersions(String range) throws VersionRangeResolutionException {</a> +<span class="sourceLineNo">301</span><a id="line.301"> MavenProject currentProject = mavenSession.getCurrentProject();</a> +<span class="sourceLineNo">302</span><a id="line.302"> VersionRangeRequest rangeRequest = new VersionRangeRequest();</a> +<span class="sourceLineNo">303</span><a id="line.303"> rangeRequest.setArtifact(</a> +<span class="sourceLineNo">304</span><a id="line.304"> new DefaultArtifact(currentProject.getGroupId() + ":" + currentProject.getArtifactId() + ":" + range));</a> +<span class="sourceLineNo">305</span><a id="line.305"> rangeRequest.setRepositories(</a> +<span class="sourceLineNo">306</span><a id="line.306"> RepositoryUtils.toRepos(mavenSession.getCurrentProject().getRemoteArtifactRepositories()));</a> +<span class="sourceLineNo">307</span><a id="line.307"> VersionRangeResult rangeResult =</a> +<span class="sourceLineNo">308</span><a id="line.308"> repositorySystem.resolveVersionRange(mavenSession.getRepositorySession(), rangeRequest);</a> +<span class="sourceLineNo">309</span><a id="line.309"> return rangeResult.getVersions().stream()</a> +<span class="sourceLineNo">310</span><a id="line.310"> .filter(version -> !ArtifactUtils.isSnapshot(version.toString()))</a> +<span class="sourceLineNo">311</span><a id="line.311"> .collect(Collectors.toList());</a> +<span class="sourceLineNo">312</span><a id="line.312"> }</a> +<span class="sourceLineNo">313</span><a id="line.313"></a> +<span class="sourceLineNo">314</span><a id="line.314"> private MavenProject buildMavenProject(String version) throws ProjectBuildingException {</a> +<span class="sourceLineNo">315</span><a id="line.315"> MavenProject currentProject = mavenSession.getCurrentProject();</a> +<span class="sourceLineNo">316</span><a id="line.316"> ProjectBuildingRequest buildRequest = new DefaultProjectBuildingRequest();</a> +<span class="sourceLineNo">317</span><a id="line.317"> buildRequest.setLocalRepository(mavenSession.getLocalRepository());</a> +<span class="sourceLineNo">318</span><a id="line.318"> buildRequest.setRemoteRepositories(mavenSession.getCurrentProject().getRemoteArtifactRepositories());</a> +<span class="sourceLineNo">319</span><a id="line.319"> buildRequest.setValidationLevel(ModelBuildingRequest.VALIDATION_LEVEL_MINIMAL);</a> +<span class="sourceLineNo">320</span><a id="line.320"> buildRequest.setProcessPlugins(false);</a> +<span class="sourceLineNo">321</span><a id="line.321"> buildRequest.setRepositoryMerging(ProjectBuildingRequest.RepositoryMerging.REQUEST_DOMINANT);</a> +<span class="sourceLineNo">322</span><a id="line.322"> buildRequest.setSystemProperties(mavenSession.getSystemProperties());</a> +<span class="sourceLineNo">323</span><a id="line.323"> buildRequest.setUserProperties(mavenSession.getUserProperties());</a> +<span class="sourceLineNo">324</span><a id="line.324"> buildRequest.setRepositorySession(mavenSession.getRepositorySession());</a> +<span class="sourceLineNo">325</span><a id="line.325"> return projectBuilder</a> +<span class="sourceLineNo">326</span><a id="line.326"> .build(</a> +<span class="sourceLineNo">327</span><a id="line.327"> RepositoryUtils.toArtifact(new DefaultArtifact(currentProject.getGroupId() + ":"</a> +<span class="sourceLineNo">328</span><a id="line.328"> + currentProject.getArtifactId() + ":pom:" + version)),</a> +<span class="sourceLineNo">329</span><a id="line.329"> buildRequest)</a> +<span class="sourceLineNo">330</span><a id="line.330"> .getProject();</a> +<span class="sourceLineNo">331</span><a id="line.331"> }</a> +<span class="sourceLineNo">332</span><a id="line.332">}</a> Modified: maven/website/components/plugin-tools-archives/plugin-tools-LATEST/apidocs/src-html/org/apache/maven/plugin/plugin/report/RequirementsHistory.html ============================================================================== --- maven/website/components/plugin-tools-archives/plugin-tools-LATEST/apidocs/src-html/org/apache/maven/plugin/plugin/report/RequirementsHistory.html (original) +++ maven/website/components/plugin-tools-archives/plugin-tools-LATEST/apidocs/src-html/org/apache/maven/plugin/plugin/report/RequirementsHistory.html Sat Mar 30 02:00:43 2024 @@ -29,160 +29,165 @@ <span class="sourceLineNo">020</span><a id="line.20"></a> <span class="sourceLineNo">021</span><a id="line.21">import java.util.Arrays;</a> <span class="sourceLineNo">022</span><a id="line.22">import java.util.Map;</a> -<span class="sourceLineNo">023</span><a id="line.23">import java.util.Optional;</a> -<span class="sourceLineNo">024</span><a id="line.24"></a> -<span class="sourceLineNo">025</span><a id="line.25">import org.apache.commons.lang3.StringUtils;</a> -<span class="sourceLineNo">026</span><a id="line.26">import org.apache.maven.model.Plugin;</a> -<span class="sourceLineNo">027</span><a id="line.27">import org.apache.maven.model.Prerequisites;</a> -<span class="sourceLineNo">028</span><a id="line.28">import org.apache.maven.plugin.descriptor.PluginDescriptor;</a> -<span class="sourceLineNo">029</span><a id="line.29">import org.apache.maven.project.MavenProject;</a> -<span class="sourceLineNo">030</span><a id="line.30">import org.apache.maven.tools.plugin.ExtendedPluginDescriptor;</a> -<span class="sourceLineNo">031</span><a id="line.31">import org.codehaus.plexus.util.xml.Xpp3Dom;</a> -<span class="sourceLineNo">032</span><a id="line.32"></a> -<span class="sourceLineNo">033</span><a id="line.33">/**</a> -<span class="sourceLineNo">034</span><a id="line.34"> * Plugin requirements history.</a> -<span class="sourceLineNo">035</span><a id="line.35"> *</a> -<span class="sourceLineNo">036</span><a id="line.36"> * @author Slawomir Jaranowski</a> -<span class="sourceLineNo">037</span><a id="line.37"> */</a> -<span class="sourceLineNo">038</span><a id="line.38">public class RequirementsHistory {</a> -<span class="sourceLineNo">039</span><a id="line.39"> /**</a> -<span class="sourceLineNo">040</span><a id="line.40"> * The plugin version.</a> -<span class="sourceLineNo">041</span><a id="line.41"> */</a> -<span class="sourceLineNo">042</span><a id="line.42"> private String version;</a> -<span class="sourceLineNo">043</span><a id="line.43"></a> -<span class="sourceLineNo">044</span><a id="line.44"> /**</a> -<span class="sourceLineNo">045</span><a id="line.45"> * The minimum version of Maven to run this plugin.</a> -<span class="sourceLineNo">046</span><a id="line.46"> */</a> -<span class="sourceLineNo">047</span><a id="line.47"> private String maven;</a> -<span class="sourceLineNo">048</span><a id="line.48"></a> -<span class="sourceLineNo">049</span><a id="line.49"> /**</a> -<span class="sourceLineNo">050</span><a id="line.50"> * The minimum version of the JDK to run this plugin.</a> -<span class="sourceLineNo">051</span><a id="line.51"> */</a> -<span class="sourceLineNo">052</span><a id="line.52"> private String jdk;</a> -<span class="sourceLineNo">053</span><a id="line.53"></a> -<span class="sourceLineNo">054</span><a id="line.54"> public String getVersion() {</a> -<span class="sourceLineNo">055</span><a id="line.55"> return version;</a> -<span class="sourceLineNo">056</span><a id="line.56"> }</a> -<span class="sourceLineNo">057</span><a id="line.57"></a> -<span class="sourceLineNo">058</span><a id="line.58"> public String getMaven() {</a> -<span class="sourceLineNo">059</span><a id="line.59"> return maven;</a> -<span class="sourceLineNo">060</span><a id="line.60"> }</a> -<span class="sourceLineNo">061</span><a id="line.61"></a> -<span class="sourceLineNo">062</span><a id="line.62"> public String getJdk() {</a> -<span class="sourceLineNo">063</span><a id="line.63"> return jdk;</a> -<span class="sourceLineNo">064</span><a id="line.64"> }</a> -<span class="sourceLineNo">065</span><a id="line.65"></a> -<span class="sourceLineNo">066</span><a id="line.66"> @Override</a> -<span class="sourceLineNo">067</span><a id="line.67"> public String toString() {</a> -<span class="sourceLineNo">068</span><a id="line.68"> final StringBuilder sb = new StringBuilder("RequirementsHistory{");</a> -<span class="sourceLineNo">069</span><a id="line.69"> sb.append("version='").append(version).append('\'');</a> -<span class="sourceLineNo">070</span><a id="line.70"> sb.append(", maven='").append(maven).append('\'');</a> -<span class="sourceLineNo">071</span><a id="line.71"> sb.append(", jdk='").append(jdk).append('\'');</a> -<span class="sourceLineNo">072</span><a id="line.72"> sb.append('}');</a> -<span class="sourceLineNo">073</span><a id="line.73"> return sb.toString();</a> -<span class="sourceLineNo">074</span><a id="line.74"> }</a> -<span class="sourceLineNo">075</span><a id="line.75"></a> -<span class="sourceLineNo">076</span><a id="line.76"> public static RequirementsHistory discoverRequirements(MavenProject project) {</a> -<span class="sourceLineNo">077</span><a id="line.77"> RequirementsHistory req = new RequirementsHistory();</a> -<span class="sourceLineNo">078</span><a id="line.78"> req.version = project.getVersion();</a> -<span class="sourceLineNo">079</span><a id="line.79"> req.jdk = discoverJdkRequirement(project, null);</a> -<span class="sourceLineNo">080</span><a id="line.80"> req.maven = discoverMavenRequirement(project, null);</a> -<span class="sourceLineNo">081</span><a id="line.81"> return req;</a> -<span class="sourceLineNo">082</span><a id="line.82"> }</a> -<span class="sourceLineNo">083</span><a id="line.83"> /**</a> -<span class="sourceLineNo">084</span><a id="line.84"> * Tries to determine the Maven requirement from either the plugin descriptor or (if not set) from the</a> -<span class="sourceLineNo">085</span><a id="line.85"> * Maven prerequisites element in the POM.</a> -<span class="sourceLineNo">086</span><a id="line.86"> *</a> -<span class="sourceLineNo">087</span><a id="line.87"> * @param project not null</a> -<span class="sourceLineNo">088</span><a id="line.88"> * @param pluginDescriptor the plugin descriptor (can be null)</a> -<span class="sourceLineNo">089</span><a id="line.89"> * @return the Maven version or null if not specified</a> -<span class="sourceLineNo">090</span><a id="line.90"> */</a> -<span class="sourceLineNo">091</span><a id="line.91"> public static String discoverMavenRequirement(MavenProject project, PluginDescriptor pluginDescriptor) {</a> -<span class="sourceLineNo">092</span><a id="line.92"> if (pluginDescriptor != null && StringUtils.isNotBlank(pluginDescriptor.getRequiredMavenVersion())) {</a> -<span class="sourceLineNo">093</span><a id="line.93"> return pluginDescriptor.getRequiredMavenVersion();</a> -<span class="sourceLineNo">094</span><a id="line.94"> }</a> -<span class="sourceLineNo">095</span><a id="line.95"> return Optional.ofNullable(project.getPrerequisites())</a> -<span class="sourceLineNo">096</span><a id="line.96"> .map(Prerequisites::getMaven)</a> -<span class="sourceLineNo">097</span><a id="line.97"> .orElse(null);</a> -<span class="sourceLineNo">098</span><a id="line.98"> }</a> -<span class="sourceLineNo">099</span><a id="line.99"></a> -<span class="sourceLineNo">100</span><a id="line.100"> /**</a> -<span class="sourceLineNo">101</span><a id="line.101"> * Tries to determine the JDK requirement from the following sources (until one is found)</a> -<span class="sourceLineNo">102</span><a id="line.102"> * <ol></a> -<span class="sourceLineNo">103</span><a id="line.103"> * <li>use JDK requirement from plugin descriptor</li></a> -<span class="sourceLineNo">104</span><a id="line.104"> * <li>use {@code release} configuration of {@code org.apache.maven.plugins:maven-compiler-plugin}</li></a> -<span class="sourceLineNo">105</span><a id="line.105"> * <li>use {@code maven.compiler.release<} property</li></a> -<span class="sourceLineNo">106</span><a id="line.106"> * <li>use {@code target} configuration of {@code org.apache.maven.plugins:maven-compiler-plugin}</li></a> -<span class="sourceLineNo">107</span><a id="line.107"> * <li>use {@code maven.compiler.target} property</li></a> -<span class="sourceLineNo">108</span><a id="line.108"> * </ol></a> -<span class="sourceLineNo">109</span><a id="line.109"> *</a> -<span class="sourceLineNo">110</span><a id="line.110"> * @param project not null</a> -<span class="sourceLineNo">111</span><a id="line.111"> * @param pluginDescriptor the plugin descriptor (can be null)</a> -<span class="sourceLineNo">112</span><a id="line.112"> * @return the JDK version</a> -<span class="sourceLineNo">113</span><a id="line.113"> */</a> -<span class="sourceLineNo">114</span><a id="line.114"> public static String discoverJdkRequirement(MavenProject project, PluginDescriptor pluginDescriptor) {</a> -<span class="sourceLineNo">115</span><a id="line.115"> String jdk = null;</a> -<span class="sourceLineNo">116</span><a id="line.116"> if (pluginDescriptor instanceof ExtendedPluginDescriptor) {</a> -<span class="sourceLineNo">117</span><a id="line.117"> ExtendedPluginDescriptor extPluginDescriptor = (ExtendedPluginDescriptor) pluginDescriptor;</a> -<span class="sourceLineNo">118</span><a id="line.118"> jdk = extPluginDescriptor.getRequiredJavaVersion();</a> -<span class="sourceLineNo">119</span><a id="line.119"> }</a> -<span class="sourceLineNo">120</span><a id="line.120"> if (jdk != null) {</a> -<span class="sourceLineNo">121</span><a id="line.121"> return jdk;</a> -<span class="sourceLineNo">122</span><a id="line.122"> }</a> -<span class="sourceLineNo">123</span><a id="line.123"> Plugin compiler = getCompilerPlugin(project.getBuild().getPluginsAsMap());</a> -<span class="sourceLineNo">124</span><a id="line.124"> if (compiler == null) {</a> -<span class="sourceLineNo">125</span><a id="line.125"> compiler = getCompilerPlugin(project.getPluginManagement().getPluginsAsMap());</a> -<span class="sourceLineNo">126</span><a id="line.126"> }</a> -<span class="sourceLineNo">127</span><a id="line.127"></a> -<span class="sourceLineNo">128</span><a id="line.128"> jdk = getPluginParameter(compiler, "release");</a> -<span class="sourceLineNo">129</span><a id="line.129"> if (jdk == null) {</a> -<span class="sourceLineNo">130</span><a id="line.130"> jdk = project.getProperties().getProperty("maven.compiler.release");</a> -<span class="sourceLineNo">131</span><a id="line.131"> }</a> -<span class="sourceLineNo">132</span><a id="line.132"></a> -<span class="sourceLineNo">133</span><a id="line.133"> if (jdk == null) {</a> -<span class="sourceLineNo">134</span><a id="line.134"> jdk = getPluginParameter(compiler, "target");</a> -<span class="sourceLineNo">135</span><a id="line.135"> }</a> -<span class="sourceLineNo">136</span><a id="line.136"></a> -<span class="sourceLineNo">137</span><a id="line.137"> if (jdk == null) {</a> -<span class="sourceLineNo">138</span><a id="line.138"> // default value</a> -<span class="sourceLineNo">139</span><a id="line.139"> jdk = project.getProperties().getProperty("maven.compiler.target");</a> -<span class="sourceLineNo">140</span><a id="line.140"> }</a> -<span class="sourceLineNo">141</span><a id="line.141"></a> -<span class="sourceLineNo">142</span><a id="line.142"> if (jdk == null) {</a> -<span class="sourceLineNo">143</span><a id="line.143"> String version = (compiler == null) ? null : compiler.getVersion();</a> -<span class="sourceLineNo">144</span><a id="line.144"></a> -<span class="sourceLineNo">145</span><a id="line.145"> if (version != null) {</a> -<span class="sourceLineNo">146</span><a id="line.146"> return "Default target for maven-compiler-plugin version " + version;</a> -<span class="sourceLineNo">147</span><a id="line.147"> }</a> -<span class="sourceLineNo">148</span><a id="line.148"> } else {</a> -<span class="sourceLineNo">149</span><a id="line.149"> if (Arrays.asList("1.5", "1.6", "1.7", "1.8").contains(jdk)) {</a> -<span class="sourceLineNo">150</span><a id="line.150"> jdk = jdk.substring(2);</a> -<span class="sourceLineNo">151</span><a id="line.151"> }</a> -<span class="sourceLineNo">152</span><a id="line.152"> }</a> -<span class="sourceLineNo">153</span><a id="line.153"></a> -<span class="sourceLineNo">154</span><a id="line.154"> return jdk;</a> -<span class="sourceLineNo">155</span><a id="line.155"> }</a> -<span class="sourceLineNo">156</span><a id="line.156"></a> -<span class="sourceLineNo">157</span><a id="line.157"> private static Plugin getCompilerPlugin(Map<String, Plugin> pluginsAsMap) {</a> -<span class="sourceLineNo">158</span><a id="line.158"> return pluginsAsMap.get("org.apache.maven.plugins:maven-compiler-plugin");</a> -<span class="sourceLineNo">159</span><a id="line.159"> }</a> -<span class="sourceLineNo">160</span><a id="line.160"></a> -<span class="sourceLineNo">161</span><a id="line.161"> private static String getPluginParameter(Plugin plugin, String parameter) {</a> -<span class="sourceLineNo">162</span><a id="line.162"> if (plugin != null) {</a> -<span class="sourceLineNo">163</span><a id="line.163"> Xpp3Dom pluginConf = (Xpp3Dom) plugin.getConfiguration();</a> -<span class="sourceLineNo">164</span><a id="line.164"></a> -<span class="sourceLineNo">165</span><a id="line.165"> if (pluginConf != null) {</a> -<span class="sourceLineNo">166</span><a id="line.166"> Xpp3Dom target = pluginConf.getChild(parameter);</a> -<span class="sourceLineNo">167</span><a id="line.167"></a> -<span class="sourceLineNo">168</span><a id="line.168"> if (target != null) {</a> -<span class="sourceLineNo">169</span><a id="line.169"> return target.getValue();</a> -<span class="sourceLineNo">170</span><a id="line.170"> }</a> -<span class="sourceLineNo">171</span><a id="line.171"> }</a> -<span class="sourceLineNo">172</span><a id="line.172"> }</a> -<span class="sourceLineNo">173</span><a id="line.173"></a> -<span class="sourceLineNo">174</span><a id="line.174"> return null;</a> -<span class="sourceLineNo">175</span><a id="line.175"> }</a> -<span class="sourceLineNo">176</span><a id="line.176">}</a> +<span class="sourceLineNo">023</span><a id="line.23">import java.util.Objects;</a> +<span class="sourceLineNo">024</span><a id="line.24">import java.util.Optional;</a> +<span class="sourceLineNo">025</span><a id="line.25"></a> +<span class="sourceLineNo">026</span><a id="line.26">import org.apache.commons.lang3.StringUtils;</a> +<span class="sourceLineNo">027</span><a id="line.27">import org.apache.maven.model.Plugin;</a> +<span class="sourceLineNo">028</span><a id="line.28">import org.apache.maven.model.Prerequisites;</a> +<span class="sourceLineNo">029</span><a id="line.29">import org.apache.maven.plugin.descriptor.PluginDescriptor;</a> +<span class="sourceLineNo">030</span><a id="line.30">import org.apache.maven.project.MavenProject;</a> +<span class="sourceLineNo">031</span><a id="line.31">import org.apache.maven.tools.plugin.ExtendedPluginDescriptor;</a> +<span class="sourceLineNo">032</span><a id="line.32">import org.codehaus.plexus.util.xml.Xpp3Dom;</a> +<span class="sourceLineNo">033</span><a id="line.33"></a> +<span class="sourceLineNo">034</span><a id="line.34">/**</a> +<span class="sourceLineNo">035</span><a id="line.35"> * Plugin requirements history.</a> +<span class="sourceLineNo">036</span><a id="line.36"> *</a> +<span class="sourceLineNo">037</span><a id="line.37"> * @author Slawomir Jaranowski</a> +<span class="sourceLineNo">038</span><a id="line.38"> */</a> +<span class="sourceLineNo">039</span><a id="line.39">public class RequirementsHistory {</a> +<span class="sourceLineNo">040</span><a id="line.40"> /**</a> +<span class="sourceLineNo">041</span><a id="line.41"> * The plugin version.</a> +<span class="sourceLineNo">042</span><a id="line.42"> */</a> +<span class="sourceLineNo">043</span><a id="line.43"> private String version;</a> +<span class="sourceLineNo">044</span><a id="line.44"></a> +<span class="sourceLineNo">045</span><a id="line.45"> /**</a> +<span class="sourceLineNo">046</span><a id="line.46"> * The minimum version of Maven to run this plugin.</a> +<span class="sourceLineNo">047</span><a id="line.47"> */</a> +<span class="sourceLineNo">048</span><a id="line.48"> private String maven;</a> +<span class="sourceLineNo">049</span><a id="line.49"></a> +<span class="sourceLineNo">050</span><a id="line.50"> /**</a> +<span class="sourceLineNo">051</span><a id="line.51"> * The minimum version of the JDK to run this plugin.</a> +<span class="sourceLineNo">052</span><a id="line.52"> */</a> +<span class="sourceLineNo">053</span><a id="line.53"> private String jdk;</a> +<span class="sourceLineNo">054</span><a id="line.54"></a> +<span class="sourceLineNo">055</span><a id="line.55"> public String getVersion() {</a> +<span class="sourceLineNo">056</span><a id="line.56"> return version;</a> +<span class="sourceLineNo">057</span><a id="line.57"> }</a> +<span class="sourceLineNo">058</span><a id="line.58"></a> +<span class="sourceLineNo">059</span><a id="line.59"> public String getMaven() {</a> +<span class="sourceLineNo">060</span><a id="line.60"> return maven;</a> +<span class="sourceLineNo">061</span><a id="line.61"> }</a> +<span class="sourceLineNo">062</span><a id="line.62"></a> +<span class="sourceLineNo">063</span><a id="line.63"> public String getJdk() {</a> +<span class="sourceLineNo">064</span><a id="line.64"> return jdk;</a> +<span class="sourceLineNo">065</span><a id="line.65"> }</a> +<span class="sourceLineNo">066</span><a id="line.66"></a> +<span class="sourceLineNo">067</span><a id="line.67"> @Override</a> +<span class="sourceLineNo">068</span><a id="line.68"> public String toString() {</a> +<span class="sourceLineNo">069</span><a id="line.69"> final StringBuilder sb = new StringBuilder("RequirementsHistory{");</a> +<span class="sourceLineNo">070</span><a id="line.70"> sb.append("version='").append(version).append('\'');</a> +<span class="sourceLineNo">071</span><a id="line.71"> sb.append(", maven='").append(maven).append('\'');</a> +<span class="sourceLineNo">072</span><a id="line.72"> sb.append(", jdk='").append(jdk).append('\'');</a> +<span class="sourceLineNo">073</span><a id="line.73"> sb.append('}');</a> +<span class="sourceLineNo">074</span><a id="line.74"> return sb.toString();</a> +<span class="sourceLineNo">075</span><a id="line.75"> }</a> +<span class="sourceLineNo">076</span><a id="line.76"></a> +<span class="sourceLineNo">077</span><a id="line.77"> public static RequirementsHistory discoverRequirements(MavenProject project) {</a> +<span class="sourceLineNo">078</span><a id="line.78"> RequirementsHistory req = new RequirementsHistory();</a> +<span class="sourceLineNo">079</span><a id="line.79"> req.version = project.getVersion();</a> +<span class="sourceLineNo">080</span><a id="line.80"> req.jdk = discoverJdkRequirement(project, null);</a> +<span class="sourceLineNo">081</span><a id="line.81"> req.maven = discoverMavenRequirement(project, null);</a> +<span class="sourceLineNo">082</span><a id="line.82"> return req;</a> +<span class="sourceLineNo">083</span><a id="line.83"> }</a> +<span class="sourceLineNo">084</span><a id="line.84"> /**</a> +<span class="sourceLineNo">085</span><a id="line.85"> * Tries to determine the Maven requirement from either the plugin descriptor or (if not set) from the</a> +<span class="sourceLineNo">086</span><a id="line.86"> * Maven prerequisites element in the POM.</a> +<span class="sourceLineNo">087</span><a id="line.87"> *</a> +<span class="sourceLineNo">088</span><a id="line.88"> * @param project not null</a> +<span class="sourceLineNo">089</span><a id="line.89"> * @param pluginDescriptor the plugin descriptor (can be null)</a> +<span class="sourceLineNo">090</span><a id="line.90"> * @return the Maven version or null if not specified</a> +<span class="sourceLineNo">091</span><a id="line.91"> */</a> +<span class="sourceLineNo">092</span><a id="line.92"> public static String discoverMavenRequirement(MavenProject project, PluginDescriptor pluginDescriptor) {</a> +<span class="sourceLineNo">093</span><a id="line.93"> if (pluginDescriptor != null && StringUtils.isNotBlank(pluginDescriptor.getRequiredMavenVersion())) {</a> +<span class="sourceLineNo">094</span><a id="line.94"> return pluginDescriptor.getRequiredMavenVersion();</a> +<span class="sourceLineNo">095</span><a id="line.95"> }</a> +<span class="sourceLineNo">096</span><a id="line.96"> return Optional.ofNullable(project.getPrerequisites())</a> +<span class="sourceLineNo">097</span><a id="line.97"> .map(Prerequisites::getMaven)</a> +<span class="sourceLineNo">098</span><a id="line.98"> .orElse(null);</a> +<span class="sourceLineNo">099</span><a id="line.99"> }</a> +<span class="sourceLineNo">100</span><a id="line.100"></a> +<span class="sourceLineNo">101</span><a id="line.101"> /**</a> +<span class="sourceLineNo">102</span><a id="line.102"> * Tries to determine the JDK requirement from the following sources (until one is found)</a> +<span class="sourceLineNo">103</span><a id="line.103"> * <ol></a> +<span class="sourceLineNo">104</span><a id="line.104"> * <li>use JDK requirement from plugin descriptor</li></a> +<span class="sourceLineNo">105</span><a id="line.105"> * <li>use {@code release} configuration of {@code org.apache.maven.plugins:maven-compiler-plugin}</li></a> +<span class="sourceLineNo">106</span><a id="line.106"> * <li>use {@code maven.compiler.release<} property</li></a> +<span class="sourceLineNo">107</span><a id="line.107"> * <li>use {@code target} configuration of {@code org.apache.maven.plugins:maven-compiler-plugin}</li></a> +<span class="sourceLineNo">108</span><a id="line.108"> * <li>use {@code maven.compiler.target} property</li></a> +<span class="sourceLineNo">109</span><a id="line.109"> * </ol></a> +<span class="sourceLineNo">110</span><a id="line.110"> *</a> +<span class="sourceLineNo">111</span><a id="line.111"> * @param project not null</a> +<span class="sourceLineNo">112</span><a id="line.112"> * @param pluginDescriptor the plugin descriptor (can be null)</a> +<span class="sourceLineNo">113</span><a id="line.113"> * @return the JDK version</a> +<span class="sourceLineNo">114</span><a id="line.114"> */</a> +<span class="sourceLineNo">115</span><a id="line.115"> public static String discoverJdkRequirement(MavenProject project, PluginDescriptor pluginDescriptor) {</a> +<span class="sourceLineNo">116</span><a id="line.116"> String jdk = null;</a> +<span class="sourceLineNo">117</span><a id="line.117"> if (pluginDescriptor instanceof ExtendedPluginDescriptor) {</a> +<span class="sourceLineNo">118</span><a id="line.118"> ExtendedPluginDescriptor extPluginDescriptor = (ExtendedPluginDescriptor) pluginDescriptor;</a> +<span class="sourceLineNo">119</span><a id="line.119"> jdk = extPluginDescriptor.getRequiredJavaVersion();</a> +<span class="sourceLineNo">120</span><a id="line.120"> }</a> +<span class="sourceLineNo">121</span><a id="line.121"> if (jdk != null) {</a> +<span class="sourceLineNo">122</span><a id="line.122"> return jdk;</a> +<span class="sourceLineNo">123</span><a id="line.123"> }</a> +<span class="sourceLineNo">124</span><a id="line.124"> Plugin compiler = getCompilerPlugin(project.getBuild().getPluginsAsMap());</a> +<span class="sourceLineNo">125</span><a id="line.125"> if (compiler == null) {</a> +<span class="sourceLineNo">126</span><a id="line.126"> compiler = getCompilerPlugin(project.getPluginManagement().getPluginsAsMap());</a> +<span class="sourceLineNo">127</span><a id="line.127"> }</a> +<span class="sourceLineNo">128</span><a id="line.128"></a> +<span class="sourceLineNo">129</span><a id="line.129"> jdk = getPluginParameter(compiler, "release");</a> +<span class="sourceLineNo">130</span><a id="line.130"> if (jdk == null) {</a> +<span class="sourceLineNo">131</span><a id="line.131"> jdk = project.getProperties().getProperty("maven.compiler.release");</a> +<span class="sourceLineNo">132</span><a id="line.132"> }</a> +<span class="sourceLineNo">133</span><a id="line.133"></a> +<span class="sourceLineNo">134</span><a id="line.134"> if (jdk == null) {</a> +<span class="sourceLineNo">135</span><a id="line.135"> jdk = getPluginParameter(compiler, "target");</a> +<span class="sourceLineNo">136</span><a id="line.136"> }</a> +<span class="sourceLineNo">137</span><a id="line.137"></a> +<span class="sourceLineNo">138</span><a id="line.138"> if (jdk == null) {</a> +<span class="sourceLineNo">139</span><a id="line.139"> // default value</a> +<span class="sourceLineNo">140</span><a id="line.140"> jdk = project.getProperties().getProperty("maven.compiler.target");</a> +<span class="sourceLineNo">141</span><a id="line.141"> }</a> +<span class="sourceLineNo">142</span><a id="line.142"></a> +<span class="sourceLineNo">143</span><a id="line.143"> if (jdk == null) {</a> +<span class="sourceLineNo">144</span><a id="line.144"> String version = (compiler == null) ? null : compiler.getVersion();</a> +<span class="sourceLineNo">145</span><a id="line.145"></a> +<span class="sourceLineNo">146</span><a id="line.146"> if (version != null) {</a> +<span class="sourceLineNo">147</span><a id="line.147"> return "Default target for maven-compiler-plugin version " + version;</a> +<span class="sourceLineNo">148</span><a id="line.148"> }</a> +<span class="sourceLineNo">149</span><a id="line.149"> } else {</a> +<span class="sourceLineNo">150</span><a id="line.150"> if (Arrays.asList("1.5", "1.6", "1.7", "1.8").contains(jdk)) {</a> +<span class="sourceLineNo">151</span><a id="line.151"> jdk = jdk.substring(2);</a> +<span class="sourceLineNo">152</span><a id="line.152"> }</a> +<span class="sourceLineNo">153</span><a id="line.153"> }</a> +<span class="sourceLineNo">154</span><a id="line.154"></a> +<span class="sourceLineNo">155</span><a id="line.155"> return jdk;</a> +<span class="sourceLineNo">156</span><a id="line.156"> }</a> +<span class="sourceLineNo">157</span><a id="line.157"></a> +<span class="sourceLineNo">158</span><a id="line.158"> private static Plugin getCompilerPlugin(Map<String, Plugin> pluginsAsMap) {</a> +<span class="sourceLineNo">159</span><a id="line.159"> return pluginsAsMap.get("org.apache.maven.plugins:maven-compiler-plugin");</a> +<span class="sourceLineNo">160</span><a id="line.160"> }</a> +<span class="sourceLineNo">161</span><a id="line.161"></a> +<span class="sourceLineNo">162</span><a id="line.162"> private static String getPluginParameter(Plugin plugin, String parameter) {</a> +<span class="sourceLineNo">163</span><a id="line.163"> if (plugin != null) {</a> +<span class="sourceLineNo">164</span><a id="line.164"> Xpp3Dom pluginConf = (Xpp3Dom) plugin.getConfiguration();</a> +<span class="sourceLineNo">165</span><a id="line.165"></a> +<span class="sourceLineNo">166</span><a id="line.166"> if (pluginConf != null) {</a> +<span class="sourceLineNo">167</span><a id="line.167"> Xpp3Dom target = pluginConf.getChild(parameter);</a> +<span class="sourceLineNo">168</span><a id="line.168"></a> +<span class="sourceLineNo">169</span><a id="line.169"> if (target != null) {</a> +<span class="sourceLineNo">170</span><a id="line.170"> return target.getValue();</a> +<span class="sourceLineNo">171</span><a id="line.171"> }</a> +<span class="sourceLineNo">172</span><a id="line.172"> }</a> +<span class="sourceLineNo">173</span><a id="line.173"> }</a> +<span class="sourceLineNo">174</span><a id="line.174"></a> +<span class="sourceLineNo">175</span><a id="line.175"> return null;</a> +<span class="sourceLineNo">176</span><a id="line.176"> }</a> +<span class="sourceLineNo">177</span><a id="line.177"></a> +<span class="sourceLineNo">178</span><a id="line.178"> public boolean hasSameRequirements(RequirementsHistory other) {</a> +<span class="sourceLineNo">179</span><a id="line.179"> return Objects.equals(this.maven, other.getMaven()) && Objects.equals(this.jdk, other.getJdk());</a> +<span class="sourceLineNo">180</span><a id="line.180"> }</a> +<span class="sourceLineNo">181</span><a id="line.181">}</a>