View Javadoc
1   package org.apache.maven.plugin;
2   
3   /*
4    * Licensed to the Apache Software Foundation (ASF) under one
5    * or more contributor license agreements.  See the NOTICE file
6    * distributed with this work for additional information
7    * regarding copyright ownership.  The ASF licenses this file
8    * to you under the Apache License, Version 2.0 (the
9    * "License"); you may not use this file except in compliance
10   * with the License.  You may obtain a copy of the License at
11   *
12   *  http://www.apache.org/licenses/LICENSE-2.0
13   *
14   * Unless required by applicable law or agreed to in writing,
15   * software distributed under the License is distributed on an
16   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
17   * KIND, either express or implied.  See the License for the
18   * specific language governing permissions and limitations
19   * under the License.
20   */
21  
22  /**
23   * An exception occurring during the execution of a plugin.<br>
24   * Throwing this exception causes a "BUILD ERROR" message to be displayed.
25   *
26   * @author Brett Porter
27   */
28  public class MojoExecutionException
29      extends AbstractMojoExecutionException
30  {
31      /**
32       * Construct a new <code>MojoExecutionException</code> exception providing the source and a short and long message:
33       * these messages are used to improve the message written at the end of Maven build.
34       *
35       * @param source
36       * @param shortMessage
37       * @param longMessage
38       */
39      public MojoExecutionException( Object source, String shortMessage, String longMessage )
40      {
41          super( shortMessage );
42          this.source = source;
43          this.longMessage = longMessage;
44      }
45  
46      /**
47       * Construct a new <code>MojoExecutionException</code> exception wrapping an underlying <code>Exception</code>
48       * and providing a <code>message</code>.
49       *
50       * @param message
51       * @param cause
52       */
53      public MojoExecutionException( String message, Exception cause )
54      {
55          super( message, cause );
56      }
57  
58      /**
59       * Construct a new <code>MojoExecutionException</code> exception wrapping an underlying <code>Throwable</code>
60       * and providing a <code>message</code>.
61       *
62       * @param message
63       * @param cause
64       */
65      public MojoExecutionException( String message, Throwable cause )
66      {
67          super( message, cause );
68      }
69  
70      /**
71       * Construct a new <code>MojoExecutionException</code> exception providing a <code>message</code>.
72       *
73       * @param message
74       */
75      public MojoExecutionException( String message )
76      {
77          super( message );
78      }
79  
80      /**
81       * Constructs a new {@code MojoExecutionException} exception wrapping an underlying {@code Throwable}.
82       *
83       * @param cause the cause which is saved for later retrieval by the {@link #getCause()} method.
84       *              A {@code null} value is permitted, and indicates that the cause is nonexistent or unknown.
85       * @since 3.8.3
86       */
87      public MojoExecutionException( Throwable cause )
88      {
89          super( cause );
90      }
91  
92  }