JWebAssembly/src/de/inetsoftware/jwebassembly/WasmException.java

/*
 * Copyright 2017 - 2021 Volker Berlin (i-net software)
 *
 * Licensed 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.
 */
package de.inetsoftware.jwebassembly;

/**
 * If there any error occur on converting a class file to a WebAssembly module.
 * 
 * @author Volker Berlin
 *
 */
public class WasmException extends RuntimeException {

    private int    lineNumber;

    private String sourceFile;

    private String className;

    private String methodName;

    /**
     * Create a new instance.
     * 
     * @param message
     *            the error message
     * @param lineNumber
     *            the line number in Java Code
     */
    public WasmException( String message, int lineNumber ) {
        this( message, null, null, lineNumber );
    }

    /**
     * Create a new instance.
     * 
     * @param message
     *            the error message
     * @param sourceFile
     *            the sourceFile of the Java code
     * @param className
     *            the class name of the Java code
     * @param lineNumber
     *            the line number in Java Code
     */
    public WasmException( String message, String sourceFile, String className, int lineNumber ) {
        super( message );
        this.sourceFile = sourceFile;
        this.className = className;
        this.lineNumber = lineNumber;
    }

    /**
     * Create a new instance with a cause.
     * 
     * @param cause
     *            the cause
     */
    private WasmException( Throwable cause ) {
        super( cause );
        lineNumber = -1;
    }

    /**
     * Create a new instance with a cause.
     * 
     * @param message
     *            the detail message
     * @param cause
     *            the cause
     */
    private WasmException( String message, Throwable cause ) {
        super( message, cause );
        lineNumber = -1;
    }

    /**
     * Create a wrapped exception needed.
     * 
     * @param cause
     *            the wrapped cause
     * @param lineNumber
     *            the line number in Java Code
     * @return a new instance
     */
    public static WasmException create( Throwable cause, int lineNumber ) {
        return create( cause, null, null, null, lineNumber );
    }

    /**
     * Create a wrapped exception needed.
     * 
     * @param cause
     *            the wrapped cause
     * @param sourceFile
     *            the source file of the Java code
     * @param className
     *            the class name of the Java code
     * @param methodName
     *            the method of the Java code
     * @param lineNumber
     *            the line number in Java Code
     * @return a new instance
     */
    public static WasmException create( Throwable cause, String sourceFile, String className, String methodName, int lineNumber ) {
        WasmException wasmEx = create( cause );
        if( wasmEx.sourceFile == null ) {
            wasmEx.sourceFile = sourceFile;
        }
        if( wasmEx.className == null ) {
            wasmEx.className = className;
        }
        if( wasmEx.methodName == null ) {
            wasmEx.methodName = methodName;
        }
        if( wasmEx.lineNumber < 0 ) {
            wasmEx.lineNumber = lineNumber;
        }
        return wasmEx;
    }

    /**
     * Create a wrapped exception needed.
     * 
     * @param cause
     *            the wrapped cause
     * @return a new instance
     */
    public static WasmException create( Throwable cause ) {
        if( cause instanceof WasmException ) {
            return (WasmException)cause;
        }
        return new WasmException( cause );
    }

    /**
     * Create a wrapped exception needed with an additional message.
     * 
     * @param cause
     *            the wrapped cause
     * @param message
     *            the message
     * @return a new instance
     */
    public static WasmException create( String message, Throwable cause ) {
        if( cause instanceof WasmException ) {
            return (WasmException)cause;
        }
        return new WasmException( message, cause );
    }

    /**
     * Get the line number in Java code on which the error occurred.
     * 
     * @return the line number or -1
     */
    public int getLineNumber() {
        return lineNumber;
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public String getMessage() {
        String str = super.getMessage();
        if( sourceFile != null || className != null || lineNumber >= 0 ) {
            str += "\n\tat ";
            if( className != null ) {
                str += className.replace( '/', '.' ).replace( '$', '.' );
                str += '.';
            }
            if( methodName != null ) {
                str += methodName;
            }
            str += "(";
            str += (sourceFile != null ? sourceFile : "line");
            if( lineNumber > 0 ) {
                str += ":" + lineNumber;
            }
            str += ")";
        }
        return str;
    }
}