2 * Copyright (c) 2015 Cisco Systems, Inc. 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
10 * Meta model of YANG model as was defined in RFC6020 and extracted by analysis
14 * Existence of meta-model allows for better evolution of YANG language as it evolves
15 * and allows for better support of different serializations of YANG model.
18 * YANG source is defined as sequence of statement in
19 * <a href="https://www.rfc-editor.org/rfc/rfc6020#section-6.3">RFC6020, Section 6.3</a>.
20 * this model is also correct for YIN, which is XML serialisation of YANG source.
23 * Statements are represented as instances / subclasses of
24 * {@link org.opendaylight.yangtools.yang.model.api.meta.ModelStatement} concept and its two subconcepts which are:
27 * {@link org.opendaylight.yangtools.yang.model.api.meta.DeclaredStatement} - this contains navigable
28 * set of statements model as they was defined / present in original processed
31 * <li>{@link org.opendaylight.yangtools.yang.model.api.meta.EffectiveStatement} - navigable set of statements
32 * which represents effective model of parsed YANG sources, which is derived by rules
33 * present in YANG specification and/or was introduced in form of extensions.
38 * Clear separation of declared / effective model is needed, since statement definition also
39 * contains information how effective model is computed and there is no one to one mapping
40 * between declared and effective model thanks to statements such as {@code uses},
41 * {@code augment},{@code deviate},{@code refine}.
43 * <h2>Identifiers and Namespaces</h2>
44 * Effective model of YANG has several identifier types and namespaces, which behaves differently
45 * and are mostly used during data processing and transformation. Namespaces are typically exposed as a pair of methods
46 * in an appropriate {@code SomethingAwareEffectiveStatement} -- one for enumeration and one for lookups.
48 @org.osgi.annotation.bundle.Export
49 package org.opendaylight.yangtools.yang.model.api.meta;