yang/yang-parser-rfc7950/src/main/java/org/opendaylight/yangtools/yang/parser/rfc7950/stmt/AbstractEffectiveDocumentedNode.java

   1 /*
   2  * Copyright (c) 2019 PANTHEON.tech, s.r.o. and others.  All rights reserved.
   3  *
   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
   7  */
   8 package org.opendaylight.yangtools.yang.parser.rfc7950.stmt;
   9
  10 import com.google.common.annotations.Beta;
  11 import java.util.Optional;
  12 import org.eclipse.jdt.annotation.Nullable;
  13 import org.opendaylight.yangtools.yang.model.api.DocumentedNode;
  14 import org.opendaylight.yangtools.yang.model.api.meta.DeclaredStatement;
  15 import org.opendaylight.yangtools.yang.model.api.stmt.DescriptionEffectiveStatement;
  16 import org.opendaylight.yangtools.yang.model.api.stmt.ReferenceEffectiveStatement;
  17 import org.opendaylight.yangtools.yang.parser.spi.meta.StmtContext;
  18
  19 @Beta
  20 // FIXME: 6.0.0: fold this into AbstractEffectiveDocumentedNodeWithStatus
  21 public abstract class AbstractEffectiveDocumentedNode<A, D extends DeclaredStatement<A>>
  22         extends DeclaredEffectiveStatementBase<A, D> implements DocumentedNode {
  23     private final @Nullable String description;
  24     private final @Nullable String reference;
  25
  26     protected AbstractEffectiveDocumentedNode(final StmtContext<A, D, ?> ctx) {
  27         super(ctx);
  28         description = findFirstEffectiveSubstatementArgument(DescriptionEffectiveStatement.class).orElse(null);
  29         reference = findFirstEffectiveSubstatementArgument(ReferenceEffectiveStatement.class).orElse(null);
  30     }
  31
  32     @Override
  33     public final Optional<String> getDescription() {
  34         return Optional.ofNullable(description);
  35     }
  36
  37     @Override
  38     public final Optional<String> getReference() {
  39         return Optional.ofNullable(reference);
  40     }
  41
  42     protected final @Nullable String nullableDescription() {
  43         return description;
  44     }
  45
  46     protected final @Nullable String nullableReference() {
  47         return reference;
  48     }
  49 }