Skip to content

Latest commit

 

History

History
57 lines (47 loc) · 5.68 KB

mvn_cheat-sheet.md

File metadata and controls

57 lines (47 loc) · 5.68 KB
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements.  See the NOTICE file
distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License.  You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.

1. IDE Specific

Maven Command Description
mvn eclipse:eclipse generates Eclipse project files (alternatively, you could use m2e)
mvn idea:idea generates IDEA IntelliJ project files

2. Build Specific

Maven Command (1) Description
mvn performs a default build clean verify apache-rat:check
mvn clean install performs a build
mvn clean install -Dmaven.test.skip performs a build, skipping the tests (not recommended)
mvn clean test compiles the source and executes the tests
mvn test -Dtest=JSPWikiMarkupParserTest run just a single test class
mvn test -Dtest=JSPWikiMarkupParserTest#testHeadingHyperlinks3 run just a single test within a test class
mvn test -Dtest=TestClassName#methodName -Dmaven.surefire.debug debug a test in Eclipse or IDEA to see why it's failing (see http://www.jroller.com/gmazza/entry/jpa_and_junit#debugging)
mvn org.codehaus.cargo:cargo-maven3-plugin:run (from main war module) starts JSPWiki on a Tomcat9 instance at http://localhost:8080/JSPWiki with an attached debugger on port 5005
mvn clean deploy -Papache-release -Dgpg.passphrase= deploys generated artifact to a repository. If -Dgpg.passphrase is not given, expects a gpg-agent running
mvn clean install -Pintegration-tests performs a build, enabling functional tests execution (best run from the jspwiki-it-tests folder)
mvn wro4j:run -Dminimize=true merge & compress js & css files
mvn wro4j:run -Dminimize=false only merge the js & css files (no compression)
mvn clean install -Dmaven.test.skip -Dminimize=false performs a build, skipping the tests and skip compression
mvn clean install -Dgenerate-native-launchers=true (from portable module) performs a build, regenerating the native executables on the portable build
mvn test -Dtest=MemoryProfiling (from jspwiki-main module) runs a memory profiling test

(1) -T 1C can be added to any of these commands in order to run a parallel build, thus decreasing build time, i.e., mvn clean install -T 1C.

3. Reports Specific

Maven Command Description
mvn apache-rat:check creates an Apache RAT report. See: http://creadur.apache.org/rat/apache-rat-plugin/plugin-info.html
mvn cobertura:cobertura generates a cobertura maven report. See: http://mojo.codehaus.org/cobertura-maven-plugin/usage.html
mvn javadoc:javadoc creates javadocs adding some UML class/package level diagrams
mvn sonar:sonar generates a Sonar report. Expects a Sonar server running at http://localhost:9000/