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 java.util.List;
12 import javax.annotation.processing.Generated;
13 import org.eclipse.jdt.annotation.NonNullByDefault;
14 import org.eclipse.jdt.annotation.Nullable;
15 import org.immutables.value.Value;
16 import org.opendaylight.yangtools.yang.common.ErrorSeverity;
17 import org.opendaylight.yangtools.yang.common.ErrorTag;
18 import org.opendaylight.yangtools.yang.common.ErrorType;
21 * Baseline interface for metadata associated with a NETCONF notion of an 'error'. Except what NETCONF regards as
22 * an 'error', really means 'notable event' in that it can either be a warning or an error. No warnings were defined
23 * at the time this distinction was made.
27 @Value.Immutable(copy = false)
28 @Value.Style(stagedBuilder = true, allowedClasspathAnnotations = { SuppressWarnings.class, Generated.class })
29 // FIXME: 8.0.0: Split this interface into two:
30 // - yang.common.NetconfError, which does not have a builder sets up the stage
31 // - data.api.schema.NormalizedNetconfError
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 // FIXME: 8.0.0: yang.common returns concepts.HierarchicalIdentifier<?>
76 @Nullable YangInstanceIdentifier path();
79 * Return this error's additional info.
81 * @return Additional info.
83 // FIXME: 8.0.0: return NetconfErrorInfoRepresentation
84 List<YangErrorInfo> info();