src/main/java/net/onrc/onos/api/rest/RestError.java

package net.onrc.onos.api.rest;

/**
 * Describes a REST error.
 * code is a unique identifier for the error.
 * summary is indended to be a short description of what happened.
 * description is a long description of the problem, and can be formatted using
 * variable replacement.  Variable placeholders are indicated with the string
 * "{}" in the description.
 * Objects of this class are immutable.
 */

public final class RestError {

    private final RestErrorCodes.RestErrorCode code;
    private final String summary;
    private final String description;

    /**
     * Constructs a new RestError object from a code, summary and description.
     *
     * @param newCode code for the new error
     * @param newSummary short summary for the new error
     * @param newDescription formatable description for the new error
     */
    public RestError(final RestErrorCodes.RestErrorCode newCode,
                     final String newSummary,
                     final String newDescription) {
        code = newCode;
        summary = newSummary;
        description = newDescription;
    }

    /**
     * Gets the summary of the error.
     *
     * @return string for the summary
     */
    public String getSummary() {
        return summary;
    }

    /**
     * Gets the unique code for this error.
     *
     * @return unique code
     */
    public RestErrorCodes.RestErrorCode getCode() {
        return code;
    }

    /**
     * Gets the unformatted description string for the error.
     *
     * @return the unformatted description string.
     */
    public String getDescription() {
        return description;
    }
}