improved handlers documentation: artifact vs dependency attributes

This commit is contained in:
Hervé Boutemy 2019-08-05 13:12:08 +01:00
parent cb71885c14
commit d5b0f4cef3
1 changed files with 27 additions and 26 deletions

View File

@ -26,33 +26,34 @@
Default Artifact Handlers Reference
Artifact handlers (see {{{../maven-artifact/apidocs/org/apache/maven/artifact/handler/ArtifactHandler.html} API}})
define for each {{{../maven-model/maven.html#class_dependency}dependency type}} information on the artifact.
define for each {{{../maven-model/maven.html#class_dependency}dependency type}} information on the artifact
(classifier, extension, language) and how to manage it as dependency (add to classpath, include dependencies).
Some artifact handlers
are configured by default in <<<META-INF/plexus/artifact-handlers.xml>>>:
*--------------------+------------+------------+---------------+-----------+---------------------+-----------------------+
|| type || extension || packaging || classifier || language || added to classpath || includesDependencies ||
*--------------------+------------+------------+---------------+-----------+---------------------+-----------------------+
| <<<pom>>> | <= type> | <= type> | | none | | |
*--------------------+------------+------------+---------------+-----------+---------------------+-----------------------+
| <<<jar>>> | <= type> | <= type> | | java | <<<true>>> | |
*--------------------+------------+------------+---------------+-----------+---------------------+-----------------------+
| <<<test-jar>>> | <<<jar>>> | <<<jar>>> | <<<tests>>> | java | <<<true>>> | |
*--------------------+------------+------------+---------------+-----------+---------------------+-----------------------+
| <<<maven-plugin>>> | <<<jar>>> | <= type> | | java | <<<true>>> | |
*--------------------+------------+------------+---------------+-----------+---------------------+-----------------------+
| <<<ejb>>> | <<<jar>>> | <= type> | | java | <<<true>>> | |
*--------------------+------------+------------+---------------+-----------+---------------------+-----------------------+
| <<<ejb-client>>> | <<<jar>>> | <<<ejb>>> | <<<client>>> | java | <<<true>>> | |
*--------------------+------------+------------+---------------+-----------+---------------------+-----------------------+
| <<<war>>> | <= type> | <= type> | | java | | <<<true>>> |
*--------------------+------------+------------+---------------+-----------+---------------------+-----------------------+
| <<<ear>>> | <= type> | <= type> | | java | | <<<true>>> |
*--------------------+------------+------------+---------------+-----------+---------------------+-----------------------+
| <<<rar>>> | <= type> | <= type> | | java | | <<<true>>> |
*--------------------+------------+------------+---------------+-----------+---------------------+-----------------------+
| <<<java-source>>> | <<<jar>>> | <= type> | <<<sources>>> | java | | |
*--------------------+------------+------------+---------------+-----------+---------------------+-----------------------+
| <<<javadoc>>> | <<<jar>>> | <= type> | <<<javadoc>>> | java | <<<true>>> | |
*--------------------+------------+------------+---------------+-----------+---------------------+-----------------------+
*--------------------+---------------+------------+------------+-----------+---------------------+-----------------------+
|| type || classifier || extension || packaging || language || added to classpath || includesDependencies ||
*--------------------+---------------+------------+------------+-----------+---------------------+-----------------------+
| <<<pom>>> | | <= type> | <= type> | none | | |
*--------------------+---------------+------------+------------+-----------+---------------------+-----------------------+
| <<<jar>>> | | <= type> | <= type> | java | <<<true>>> | |
*--------------------+---------------+------------+------------+-----------+---------------------+-----------------------+
| <<<test-jar>>> | <<<tests>>> | <<<jar>>> | <<<jar>>> | java | <<<true>>> | |
*--------------------+---------------+------------+------------+-----------+---------------------+-----------------------+
| <<<maven-plugin>>> | | <<<jar>>> | <= type> | java | <<<true>>> | |
*--------------------+---------------+------------+------------+-----------+---------------------+-----------------------+
| <<<ejb>>> | | <<<jar>>> | <= type> | java | <<<true>>> | |
*--------------------+---------------+------------+------------+-----------+---------------------+-----------------------+
| <<<ejb-client>>> | <<<client>>> | <<<jar>>> | <<<ejb>>> | java | <<<true>>> | |
*--------------------+---------------+------------+------------+-----------+---------------------+-----------------------+
| <<<war>>> | | <= type> | <= type> | java | | <<<true>>> |
*--------------------+---------------+------------+------------+-----------+---------------------+-----------------------+
| <<<ear>>> | | <= type> | <= type> | java | | <<<true>>> |
*--------------------+---------------+------------+------------+-----------+---------------------+-----------------------+
| <<<rar>>> | | <= type> | <= type> | java | | <<<true>>> |
*--------------------+---------------+------------+------------+-----------+---------------------+-----------------------+
| <<<java-source>>> | <<<sources>>> | <<<jar>>> | <= type> | java | | |
*--------------------+---------------+------------+------------+-----------+---------------------+-----------------------+
| <<<javadoc>>> | <<<javadoc>>> | <<<jar>>> | <= type> | java | <<<true>>> | |
*--------------------+---------------+------------+------------+-----------+---------------------+-----------------------+