Ein eigenes Maven-Plugin zu erstellen ist nicht schwer und ist schnell gemacht. Wir wollen ein Plugin welches einen Verzeichnis Inhalt mit ls -la in das Log schreibt erstellen. Es können aber auch andere Linux Befehle übergeben werden. Hier nun die 6 Schritte mit den Vorlagen die mind. nötig sind.
1. Wir legen in Eclipse ein neue Maven Projekt mit Java 1.8 an. mit Artifact Id und Group Id de.wenzlaff.command.maven.plugin
2. In der pom.xml fügen wir die folgenden Abhängikeiten hinzu:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 |
<?xml version="1.0" encoding="UTF-8"?> <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 https://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>de.wenzlaff.command.maven.plugin</groupId> <artifactId>de.wenzlaff.command.maven.plugin</artifactId> <version>1.0-SNAPSHOT</version> <packaging>maven-plugin</packaging> <name>Command Maven Plugin</name> <description>Command Maven Plugin</description> <organization> <name>Thomas Wenzlaff</name> <url>https://www.wenzlaff.info</url> </organization> <prerequisites> <maven>3.5.0</maven> </prerequisites> <properties> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> </properties> <reporting> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-plugin-plugin</artifactId> <reportSets> <reportSet> <reports> <report>report</report> </reports> </reportSet> </reportSets> </plugin> </plugins> </reporting> <dependencies> <dependency> <groupId>org.apache.maven</groupId> <artifactId>maven-plugin-api</artifactId> <version>3.6.3</version> <scope>provided</scope> </dependency> <dependency> <groupId>org.apache.maven</groupId> <artifactId>maven-core</artifactId> <version>3.6.0</version> <scope>provided</scope> </dependency> <dependency> <groupId>org.apache.maven.plugin-tools</groupId> <artifactId>maven-plugin-annotations</artifactId> <version>3.5</version> <scope>provided</scope> </dependency> </dependencies> <build> <pluginManagement> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-plugin-plugin</artifactId> <version>3.6.0</version> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-site-plugin</artifactId> <version>3.8.2</version> </plugin> <!--This plugin's configuration is used to store Eclipse m2e settings only. It has no influence on the Maven build itself. --> <plugin> <groupId>org.eclipse.m2e</groupId> <artifactId>lifecycle-mapping</artifactId> <version>1.0.0</version> <configuration> <lifecycleMappingMetadata> <pluginExecutions> <pluginExecution> <pluginExecutionFilter> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-plugin-plugin</artifactId> <versionRange>[3.6.0,)</versionRange> <goals> <goal>descriptor</goal> </goals> </pluginExecutionFilter> <action> <ignore></ignore> </action> </pluginExecution> </pluginExecutions> </lifecycleMappingMetadata> </configuration> </plugin> </plugins> </pluginManagement> </build> </project> |
3. Dann brauchen wir noch ein Mojo. Mit einem Parameter, der default das ls -la ausführt.
Dazu die folgende Klasse im Package de.wenzlaff.command.maven.plugin anlegen:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 |
package de.wenzlaff.command.maven.plugin; import java.io.BufferedReader; import java.io.IOException; import java.io.InputStreamReader; import org.apache.maven.plugin.AbstractMojo; import org.apache.maven.plugin.MojoExecutionException; import org.apache.maven.plugin.MojoFailureException; import org.apache.maven.plugins.annotations.LifecyclePhase; import org.apache.maven.plugins.annotations.Mojo; import org.apache.maven.plugins.annotations.Parameter; import org.apache.maven.project.MavenProject; /** * Ein Kommando-Mojo. * * @author Thomas Wenzlaff * */ @Mojo(name = "info", defaultPhase = LifecyclePhase.INITIALIZE) public class CommandMojo extends AbstractMojo { /** * Der command Parameter. Wenn er nicht angegeben wird, wird default: ls -la * verwendet. * * Es kann aber auch noch ein Verzeichnis übergeben werden, das überwacht werden * soll. Z.B. * * mvn de.wenzlaff.dir.maven.plugin:de.wenzlaff.command.maven.plugin:info * -Dcommand="ls -la /Users/thomaswenzlaff" * */ @Parameter(property = "command", defaultValue = "ls -la") private String command; @Parameter(property = "project", readonly = true) private MavenProject project; public void execute() throws MojoExecutionException, MojoFailureException { getLog().info("Thomas sein Command-Plugin in Version: " + project.getVersion() + ", ArtifactId: " + project.getArtifactId()); getLog().info("Führe das Kommando aus: " + command); String commandoErgebnis = getCommand(command); getLog().info(commandoErgebnis); } public String getCommand(String command) throws MojoExecutionException { String s = null; StringBuilder buffer = new StringBuilder("\n"); try { Process p = Runtime.getRuntime().exec(command); try (BufferedReader stdInput = new BufferedReader(new InputStreamReader(p.getInputStream()))) { while ((s = stdInput.readLine()) != null) { buffer.append(s); buffer.append("\n"); } } try (BufferedReader stdError = new BufferedReader(new InputStreamReader(p.getErrorStream()))) { while ((s = stdError.readLine()) != null) { buffer.append("Error: " + s); } } } catch (IOException e) { throw new MojoExecutionException("Fehler beim ausführen des Kommandos: '" + command, e); } return buffer.toString(); } } |
Die Klasse CommandMojo wird von dem AbstractMojo abgeleitet. Es muss nur eine Methode (execute) implementiert werden. Das Projekt sieht nun so aus:
4. Jetzt können wir das Plugin schon bauen mit: mvn clean install
5. Das Plugin testen wir auf der Kommandozeile, indem wir in das Projektverzeichnis wechseln (da wo die pom.xml liegt) und das info Goal aufrufen:
mvn de.wenzlaff.command.maven.plugin:de.wenzlaff.command.maven.plugin:info
Es wird nun das Verzeichnis augegeben und im log geschrieben:
Wenn man einen anderen als den default Parameter haben will, kann der mit -D angegeben werden z.B.
mvn de.wenzlaff.command.maven.plugin:de.wenzlaff.command.maven.plugin:info -Dcommand=“ps“
um alle Prozesse auszugeben.
6. Mit mvn site kann auch leicht der gewohnt Report erzeugt werden:
