yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/api/ListSchemaNode.java

   1 /*
   2  * Copyright (c) 2013 Cisco Systems, Inc. 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.model.api;
   9
  10 import com.google.common.collect.ImmutableList;
  11 import java.util.Collection;
  12 import java.util.List;
  13 import javax.annotation.Nonnull;
  14 import org.opendaylight.yangtools.yang.common.QName;
  15
  16 /**
  17  * Interface describing YANG 'list' statement.
  18  * <p>
  19  * The 'list' statement is used to define an interior data node in the schema
  20  * tree. A list entry is uniquely identified by the values of the list's keys,
  21  * if defined.
  22  * </p>
  23  */
  24 public interface ListSchemaNode extends DataNodeContainer, AugmentationTarget, DataSchemaNode, NotificationNodeContainer,
  25         ActionNodeContainer {
  26
  27     /**
  28      * @return List of QNames of leaf identifiers of this list
  29      */
  30     List<QName> getKeyDefinition();
  31
  32     /**
  33      * YANG 'ordered-by' statement. It defines whether the order of entries
  34      * within a list are determined by the user or the system. If not present,
  35      * default is false.
  36      *
  37      * @return true if ordered-by argument is "user", false otherwise
  38      */
  39     boolean isUserOrdered();
  40
  41     /**
  42      * @return Collection of unique constraints of this list schema node
  43      */
  44     @Nonnull
  45     default Collection<UniqueConstraint> getUniqueConstraints() {
  46         return ImmutableList.of();
  47     }
  48 }