1 package org.apache.maven.model.building; 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 import org.apache.maven.model.Model; 23 24 /** 25 * Describes a problem that was encountered during model building. A problem can either be an exception that was thrown 26 * or a simple string message. In addition, a problem carries a hint about its source, e.g. the POM file that exhibits 27 * the problem. 28 * 29 * @author Benjamin Bentmann 30 */ 31 public class DefaultModelProblem 32 implements ModelProblem 33 { 34 35 private final String source; 36 37 private final int lineNumber; 38 39 private final int columnNumber; 40 41 private final String modelId; 42 43 private final String message; 44 45 private final Exception exception; 46 47 private final Severity severity; 48 49 private final Version version; 50 51 52 /** 53 * Creates a new problem with the specified message and exception. 54 * 55 * @param message The message describing the problem, may be {@code null}. 56 * @param severity The severity level of the problem, may be {@code null} to default to 57 * {@link ModelProblem.Severity#ERROR}. 58 * @param source The source of the problem, may be {@code null}. 59 * @param lineNumber The one-based index of the line containing the error or {@code -1} if unknown. 60 * @param columnNumber The one-based index of the column containing the error or {@code -1} if unknown. 61 * @param exception The exception that caused this problem, may be {@code null}. 62 */ 63 //mkleint: does this need to be public? 64 public DefaultModelProblem( String message, Severity severity, Version version, Model source, int lineNumber, int columnNumber, 65 Exception exception ) 66 { 67 this( message, severity, version, ModelProblemUtils.toPath( source ), lineNumber, columnNumber, 68 ModelProblemUtils.toId( source ), exception ); 69 } 70 71 /** 72 * Creates a new problem with the specified message and exception. 73 * 74 * @param message The message describing the problem, may be {@code null}. 75 * @param severity The severity level of the problem, may be {@code null} to default to 76 * {@link ModelProblem.Severity#ERROR}. 77 * @param version The version since the problem is relevant 78 * @param source A hint about the source of the problem like a file path, may be {@code null}. 79 * @param lineNumber The one-based index of the line containing the problem or {@code -1} if unknown. 80 * @param columnNumber The one-based index of the column containing the problem or {@code -1} if unknown. 81 * @param modelId The identifier of the model that exhibits the problem, may be {@code null}. 82 * @param exception The exception that caused this problem, may be {@code null}. 83 */ 84 //mkleint: does this need to be public? 85 public DefaultModelProblem( String message, Severity severity, Version version, String source, int lineNumber, int columnNumber, 86 String modelId, Exception exception ) 87 { 88 this.message = message; 89 this.severity = ( severity != null ) ? severity : Severity.ERROR; 90 this.source = ( source != null ) ? source : ""; 91 this.lineNumber = lineNumber; 92 this.columnNumber = columnNumber; 93 this.modelId = ( modelId != null ) ? modelId : ""; 94 this.exception = exception; 95 this.version = version; 96 } 97 98 public String getSource() 99 { 100 return source; 101 } 102 103 public int getLineNumber() 104 { 105 return lineNumber; 106 } 107 108 public int getColumnNumber() 109 { 110 return columnNumber; 111 } 112 113 public String getModelId() 114 { 115 return modelId; 116 } 117 118 public Exception getException() 119 { 120 return exception; 121 } 122 123 public String getMessage() 124 { 125 String msg; 126 127 if ( message != null && message.length() > 0 ) 128 { 129 msg = message; 130 } 131 else 132 { 133 msg = exception.getMessage(); 134 135 if ( msg == null ) 136 { 137 msg = ""; 138 } 139 } 140 141 return msg; 142 } 143 144 public Severity getSeverity() 145 { 146 return severity; 147 } 148 149 public Version getVersion() 150 { 151 return version; 152 } 153 154 155 @Override 156 public String toString() 157 { 158 StringBuilder buffer = new StringBuilder( 128 ); 159 160 buffer.append( "[" ).append( getSeverity() ).append( "] " ); 161 buffer.append( getMessage() ); 162 buffer.append( " @ " ).append( ModelProblemUtils.formatLocation( this, null ) ); 163 164 return buffer.toString(); 165 } 166 167 }