001package org.apache.maven.settings.building;
002
003/*
004 * Licensed to the Apache Software Foundation (ASF) under one
005 * or more contributor license agreements.  See the NOTICE file
006 * distributed with this work for additional information
007 * regarding copyright ownership.  The ASF licenses this file
008 * to you under the Apache License, Version 2.0 (the
009 * "License"); you may not use this file except in compliance
010 * with the License.  You may obtain a copy of the License at
011 *
012 *   http://www.apache.org/licenses/LICENSE-2.0
013 *
014 * Unless required by applicable law or agreed to in writing,
015 * software distributed under the License is distributed on an
016 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
017 * KIND, either express or implied.  See the License for the
018 * specific language governing permissions and limitations
019 * under the License.
020 */
021
022/**
023 * Describes a problem that was encountered during settings building. A problem can either be an exception that was
024 * thrown or a simple string message. In addition, a problem carries a hint about its source, e.g. the settings file
025 * that exhibits the problem.
026 *
027 * @author Benjamin Bentmann
028 */
029public class DefaultSettingsProblem
030    implements SettingsProblem
031{
032
033    private final String source;
034
035    private final int lineNumber;
036
037    private final int columnNumber;
038
039    private final String message;
040
041    private final Exception exception;
042
043    private final Severity severity;
044
045    /**
046     * Creates a new problem with the specified message and exception.
047     *
048     * @param message The message describing the problem, may be {@code null}.
049     * @param severity The severity level of the problem, may be {@code null} to default to
050     *            {@link SettingsProblem.Severity#ERROR}.
051     * @param source A hint about the source of the problem like a file path, may be {@code null}.
052     * @param lineNumber The one-based index of the line containing the problem or {@code -1} if unknown.
053     * @param columnNumber The one-based index of the column containing the problem or {@code -1} if unknown.
054     * @param exception The exception that caused this problem, may be {@code null}.
055     */
056    public DefaultSettingsProblem( String message, Severity severity, String source, int lineNumber, int columnNumber,
057                                   Exception exception )
058    {
059        this.message = message;
060        this.severity = ( severity != null ) ? severity : Severity.ERROR;
061        this.source = ( source != null ) ? source : "";
062        this.lineNumber = lineNumber;
063        this.columnNumber = columnNumber;
064        this.exception = exception;
065    }
066
067    @Override
068    public String getSource()
069    {
070        return source;
071    }
072
073    @Override
074    public int getLineNumber()
075    {
076        return lineNumber;
077    }
078
079    @Override
080    public int getColumnNumber()
081    {
082        return columnNumber;
083    }
084
085    @Override
086    public String getLocation()
087    {
088        StringBuilder buffer = new StringBuilder( 256 );
089
090        if ( getSource().length() > 0 )
091        {
092            if ( buffer.length() > 0 )
093            {
094                buffer.append( ", " );
095            }
096            buffer.append( getSource() );
097        }
098
099        if ( getLineNumber() > 0 )
100        {
101            if ( buffer.length() > 0 )
102            {
103                buffer.append( ", " );
104            }
105            buffer.append( "line " ).append( getLineNumber() );
106        }
107
108        if ( getColumnNumber() > 0 )
109        {
110            if ( buffer.length() > 0 )
111            {
112                buffer.append( ", " );
113            }
114            buffer.append( "column " ).append( getColumnNumber() );
115        }
116
117        return buffer.toString();
118    }
119
120    @Override
121    public Exception getException()
122    {
123        return exception;
124    }
125
126    @Override
127    public String getMessage()
128    {
129        String msg;
130
131        if ( message != null && message.length() > 0 )
132        {
133            msg = message;
134        }
135        else
136        {
137            msg = exception.getMessage();
138
139            if ( msg == null )
140            {
141                msg = "";
142            }
143        }
144
145        return msg;
146    }
147
148    @Override
149    public Severity getSeverity()
150    {
151        return severity;
152    }
153
154    @Override
155    public String toString()
156    {
157        StringBuilder buffer = new StringBuilder( 128 );
158
159        buffer.append( "[" ).append( getSeverity() ).append( "] " );
160        buffer.append( getMessage() );
161        buffer.append( " @ " ).append( getLocation() );
162
163        return buffer.toString();
164    }
165
166}