gerrit.o-ran-sc Code Review - smo/teiv.git/blob

   1 /*
   2  *  ============LICENSE_START=======================================================
   3  *  Copyright (C) 2024 Ericsson
   4  *  Modifications Copyright (C) 2024 OpenInfra Foundation Europe
   5  *  ================================================================================
   6  *  Licensed under the Apache License, Version 2.0 (the "License");
   7  *  you may not use this file except in compliance with the License.
   8  *  You may obtain a copy of the License at
   9  *
  10  *        http://www.apache.org/licenses/LICENSE-2.0
  11  *
  12  *  Unless required by applicable law or agreed to in writing, software
  13  *  distributed under the License is distributed on an "AS IS" BASIS,
  14  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15  *  See the License for the specific language governing permissions and
  16  *  limitations under the License.
  17  *
  18  *  SPDX-License-Identifier: Apache-2.0
  19  *  ============LICENSE_END=========================================================
  20  */
  21 package org.oran.smo.yangtools.parser.model.statements.ietf;
  22
  23 import java.util.Arrays;
  24 import java.util.List;
  25
  26 import org.oran.smo.yangtools.parser.ParserExecutionContext;
  27 import org.oran.smo.yangtools.parser.model.statements.AbstractStatement;
  28 import org.oran.smo.yangtools.parser.model.statements.ExtensionStatement;
  29 import org.oran.smo.yangtools.parser.model.statements.StatementModuleAndName;
  30 import org.oran.smo.yangtools.parser.model.statements.yang.CY;
  31 import org.oran.smo.yangtools.parser.model.yangdom.YangDomElement;
  32
  33 /**
  34  * Type-safe IETF statement.
  35  *
  36  * @author Mark Hollmann
  37  */
  38 public class YIetfMountPoint extends ExtensionStatement {
  39
  40     public YIetfMountPoint(final AbstractStatement parentStatement, final YangDomElement domNode) {
  41         super(parentStatement, domNode);
  42     }
  43
  44     @Override
  45     public StatementArgumentType getArgumentType() {
  46         return StatementArgumentType.NAME;
  47     }
  48
  49     @Override
  50     public StatementModuleAndName getStatementModuleAndName() {
  51         return CIETF.IETF_YANG_SCHEMA_MOUNT__MOUNT_POINT;
  52     }
  53
  54     @Override
  55     public boolean argumentIsMandatory() {
  56         return true;
  57     }
  58
  59     public String getLabel() {
  60         return getValue() != null ? getValue() : "";
  61     }
  62
  63     private static final List<StatementModuleAndName> REQUIRED_PARENTS = Arrays.asList(CY.STMT_LIST, CY.STMT_CONTAINER);
  64
  65     @Override
  66     public boolean canBeChildOf(final StatementModuleAndName parentSman) {
  67         return REQUIRED_PARENTS.contains(parentSman);
  68     }
  69
  70     @Override
  71     protected void validate(final ParserExecutionContext context) {
  72         /*
  73          * From module ietf-yang-schema-mount:
  74          *
  75          * The argument 'label' is a YANG identifier, i.e., it is of the
  76          * type 'yang:yang-identifier'.
  77          *
  78          * The 'mount-point' statement MUST NOT be used in a YANG
  79          * version 1 module, neither explicitly nor via a 'uses'
  80          * statement.
  81          * The 'mount-point' statement MAY be present as a substatement
  82          * of 'container' and 'list' and MUST NOT be present elsewhere.
  83          * There MUST NOT be more than one 'mount-point' statement in a
  84          * given 'container' or 'list' statement.
  85          *
  86          * If a mount point is defined within a grouping, its label is
  87          * bound to the module where the grouping is used.
  88          *
  89          * A mount point defines a place in the node hierarchy where
  90          * other data models may be attached.  A server that implements a
  91          * module with a mount point populates the
  92          * '/schema-mounts/mount-point' list with detailed information on
  93          * which data models are mounted at each mount point.
  94          *
  95          * Note that the 'mount-point' statement does not define a new
  96          * data node.
  97          */
  98         validateArgumentNotNullNotEmpty(context);
  99
 100         checkParentAlsoAllowDeviateOrRefine(context);
 101         checkCardinalityUnderParent(context, 1);
 102     }
 103 }