/* * Copyright (c) 2014 Brocade Communications Systems, Inc. and others. All rights reserved. * * This program and the accompanying materials are made available under the * terms of the Eclipse Public License v1.0 which accompanies this distribution, * and is available at http://www.eclipse.org/legal/epl-v10.html */ package org.opendaylight.restconf.common.errors; import static java.util.Objects.requireNonNull; import java.io.Serializable; import org.eclipse.jdt.annotation.NonNull; import org.opendaylight.yangtools.yang.common.ErrorTag; import org.opendaylight.yangtools.yang.common.ErrorType; import org.opendaylight.yangtools.yang.common.RpcError; import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier; /** * Encapsulates a single {@code error} within the * "errors" YANG Data Template. * * @author Devin Avery */ @Deprecated public class RestconfError implements Serializable { @java.io.Serial private static final long serialVersionUID = 1L; private final @NonNull ErrorType errorType; private final @NonNull ErrorTag errorTag; // FIXME: 'errorInfo' is defined as a formatted XML string. We need a better representation to enable reasonable // interop with JSON (and others) private final String errorInfo; private final String errorAppTag; private final String errorMessage; private final YangInstanceIdentifier errorPath; /** * Constructs a RestconfError. * * @param errorType The enumerated type indicating the layer where the error occurred. * @param errorTag The enumerated tag representing a more specific error cause. * @param errorMessage A string which provides a plain text string describing the error. */ public RestconfError(final ErrorType errorType, final ErrorTag errorTag, final String errorMessage) { this(errorType, errorTag, errorMessage, null, null, null); } /** * Constructs a RestconfError object. * * @param errorType The enumerated type indicating the layer where the error occurred. * @param errorTag The enumerated tag representing a more specific error cause. * @param errorMessage A string which provides a plain text string describing the error. * @param errorAppTag A string which represents an application-specific error tag that further specifies the error * cause. */ public RestconfError(final ErrorType errorType, final ErrorTag errorTag, final String errorMessage, final String errorAppTag) { this(errorType, errorTag, errorMessage, errorAppTag, null, null); } /** * Constructs a RestconfError object. * * @param errorType The enumerated type indicating the layer where the error occurred. * @param errorTag The enumerated tag representing a more specific error cause. * @param errorMessage A string which provides a plain text string describing the error. * @param errorPath An instance identifier which contains error path */ public RestconfError(final ErrorType errorType, final ErrorTag errorTag, final String errorMessage, final YangInstanceIdentifier errorPath) { this(errorType, errorTag, errorMessage, null, null, errorPath); } /** * Constructs a RestconfError object. * * @param errorType The enumerated type indicating the layer where the error occurred. * @param errorTag The enumerated tag representing a more specific error cause. * @param errorMessage A string which provides a plain text string describing the error. * @param errorAppTag A string which represents an application-specific error tag that further specifies the error * cause. * @param errorInfo A string, formatted as XML, which contains additional error information. */ public RestconfError(final ErrorType errorType, final ErrorTag errorTag, final String errorMessage, final String errorAppTag, final String errorInfo) { this(errorType, errorTag, errorMessage, errorAppTag, errorInfo, null); } /** * Constructs a RestConfError object. * * @param errorType The enumerated type indicating the layer where the error occurred. * @param errorTag The enumerated tag representing a more specific error cause. * @param errorMessage A string which provides a plain text string describing the error. * @param errorAppTag A string which represents an application-specific error tag that further specifies the error * cause. * @param errorInfo A string, formatted as XML, which contains additional error information. * @param errorPath An instance identifier which contains error path */ public RestconfError(final ErrorType errorType, final ErrorTag errorTag, final String errorMessage, final String errorAppTag, final String errorInfo, final YangInstanceIdentifier errorPath) { this.errorType = requireNonNull(errorType, "Error type is required for RestConfError"); this.errorTag = requireNonNull(errorTag, "Error tag is required for RestConfError"); this.errorMessage = errorMessage; this.errorAppTag = errorAppTag; this.errorInfo = errorInfo; this.errorPath = errorPath; } /** * Constructs a RestConfError object from an RpcError. */ public RestconfError(final RpcError rpcError) { errorType = rpcError.getErrorType(); final var tag = rpcError.getTag(); errorTag = tag != null ? tag : ErrorTag.OPERATION_FAILED; errorMessage = rpcError.getMessage(); errorAppTag = rpcError.getApplicationTag(); errorInfo = rpcErrorInfo(rpcError); errorPath = null; } private static String rpcErrorInfo(final RpcError rpcError) { final var info = rpcError.getInfo(); if (info != null) { return info; } final var cause = rpcError.getCause(); if (cause != null) { return cause.getMessage(); } final var severity = rpcError.getSeverity(); if (severity != null) { return "" + severity.elementBody() + ""; } return null; } public @NonNull ErrorType getErrorType() { return errorType; } public @NonNull ErrorTag getErrorTag() { return errorTag; } public String getErrorInfo() { return errorInfo; } public String getErrorAppTag() { return errorAppTag; } public String getErrorMessage() { return errorMessage; } public YangInstanceIdentifier getErrorPath() { return errorPath; } @Override public String toString() { return "RestconfError [" + "error-type: " + errorType.elementBody() + ", error-tag: " + errorTag.elementBody() + (errorAppTag != null ? ", error-app-tag: " + errorAppTag : "") + (errorMessage != null ? ", error-message: " + errorMessage : "") + (errorInfo != null ? ", error-info: " + errorInfo : "") + (errorPath != null ? ", error-path: " + errorPath.toString() : "") + "]"; } }