2 * Copyright (c) 2021 PANTHEON.tech, s.r.o. and others. All rights reserved.
4 * This program and the accompanying materials are made available under the
5 * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6 * and is available at http://www.eclipse.org/legal/epl-v10.html
8 package org.opendaylight.yangtools.yang.data.api;
10 import com.google.common.annotations.Beta;
11 import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;
12 import java.util.List;
13 import javax.annotation.processing.Generated;
14 import org.eclipse.jdt.annotation.NonNullByDefault;
15 import org.eclipse.jdt.annotation.Nullable;
16 import org.immutables.value.Value;
17 import org.opendaylight.yangtools.yang.common.ErrorSeverity;
18 import org.opendaylight.yangtools.yang.common.ErrorTag;
19 import org.opendaylight.yangtools.yang.common.ErrorType;
22 * Baseline interface for metadata associated with a NETCONF notion of an 'error'. Except what NETCONF regards as
23 * an 'error', really means 'notable event' in that it can either be a warning or an error. No warnings were defined
24 * at the time this distinction was made.
28 @Value.Immutable(copy = false)
29 @Value.Style(stagedBuilder = true, allowedClasspathAnnotations = {
30 SuppressWarnings.class, Generated.class, SuppressFBWarnings.class,
32 public interface YangNetconfError {
34 * Return this error's severity.
36 * @return Error severity.
38 ErrorSeverity severity();
41 * Return this error's type.
48 * Return this error's tag.
55 * Return this errors's {@code error-message}, if available. This value is expected to be defined in a YANG model
56 * through a {@code error-message} statement.
58 * @return Event message, or null.
60 @Nullable String message();
63 * Return this error's {@code error-app-tag}, if available. This value is expected to be defined in a YANG model
64 * through a {@code error-app-tag} statement.
66 * @return Application tag, or null.
68 @Nullable String appTag();
71 * Return the path which triggered this error, if available.
73 * @return Triggering path, or null.
75 @Nullable YangInstanceIdentifier path();
78 * Return this error's additional info.
80 * @return Additional info.
82 List<YangErrorInfo> info();