Deprecated API

Contents

• Deprecated Packages
• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Packages

Package and Description
org.opendaylight.yangtools.yang.data.api.schema.xpath

Deprecated Interfaces

Interface and Description
org.opendaylight.yangtools.yang.model.api.AddedByUsesAware This interface relates to declared model rather than to effective mode and as such should not exist. It is provided to provide common method definition and eash migration of users.
org.opendaylight.yangtools.yang.parser.spi.source.AugmentToChoiceNamespace This namespace is no longer used anywhere and not supported by the default reactor. It is scheduled for removal.
org.opendaylight.yangtools.yang.model.api.CopyableNode Aside from the deprecated AddedByUsesAware contract, this interface adds only a trait related to now how we arrived at this effective node. Users who need to know this information should really be looking at the DeclaredStatement world, which holds the original node definition.
org.opendaylight.yangtools.yang.data.api.schema.xpath.LazyXPathExpression PREVIEW API. DO NOT IMPLEMENT YET AS THIS NEEDS TO BE VALIDATED FOR USE IN CLIENT APPLICATIONS. APPLICATIONS WILLING TO USE THIS API PLEASE CONTACT yangtools-dev.
org.opendaylight.yangtools.yang.data.api.schema.xpath.OptimizableXPathExpression
org.opendaylight.yangtools.yang.data.api.schema.xpath.RelocatableXPathExpression
org.opendaylight.yangtools.yang.model.repo.api.SchemaContextFactory Use EffectiveModelContextFactory instead.
org.opendaylight.yangtools.yang.parser.rfc7950.namespace.URIStringToImportPrefix Use ModuleQNameToPrefix instead.
org.opendaylight.yangtools.yang.data.api.schema.xpath.XPathBooleanResult
org.opendaylight.yangtools.yang.data.api.schema.xpath.XPathDocument
org.opendaylight.yangtools.yang.data.api.schema.xpath.XPathExpression
org.opendaylight.yangtools.yang.data.api.schema.xpath.XPathNodesetResult
org.opendaylight.yangtools.yang.data.api.schema.xpath.XPathNumberResult
org.opendaylight.yangtools.yang.data.api.schema.xpath.XPathResult
org.opendaylight.yangtools.yang.data.api.schema.xpath.XPathSchemaContext
org.opendaylight.yangtools.yang.data.api.schema.xpath.XPathSchemaContextFactory
org.opendaylight.yangtools.yang.data.api.schema.xpath.XPathStringResult

Deprecated Classes

Class and Description
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.anyxml.AnyxmlEffectiveStatementImpl This class is visible only for historical purposes and is going to be hidden.
org.opendaylight.yangtools.yang.model.util.type.CompatUtils This class is provided strictly for compatibility only. No new users should be introduced, as this class is scheduled for removal when its two OpenDaylight users, Java Binding v1 and YANG JMX Bindings are removed.
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.container.ContainerEffectiveStatementImpl This class is visible only for historical purposes and is going to be hidden.
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.choice.ImplicitCaseSchemaNode This class is no longer used as all implicit statements are handled transparently.
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.leaf.LeafEffectiveStatementImpl This class is visible only for historical purposes and is going to be hidden.
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.leaf_list.LeafListEffectiveStatementImpl This class is visible only for historical purposes and is going to be hidden.
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.list.ListEffectiveStatementImpl This class is visible only for historical purposes and is going to be hidden.
org.opendaylight.yangtools.util.concurrent.LoggingThreadUncaughtExceptionHandler This class forms a hard dependency on SLF4J API and is therefore deprecated for removal.
org.opendaylight.yangtools.yang.model.util.PathExpressionImpl This is a transitional class to transition from RevisionAwareXPathImpl. Users are advised to supply their own implementation of PathExpression.
org.opendaylight.yangtools.yang.data.api.schema.xpath.PrefixConverters

Deprecated Exceptions

Exceptions and Description
org.opendaylight.yangtools.yang.data.api.schema.xpath.LazyXPathExpressionException PREVIEW API. DO NOT IMPLEMENT YET AS THIS NEEDS TO BE VALIDATED FOR USE IN CLIENT APPLICATIONS. APPLICATIONS WILLING TO USE THIS API PLEASE CONTACT yangtools-dev.

Deprecated Fields

Field and Description
org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.EMPTY Use YangInstanceIdentifier.empty() instead.
org.opendaylight.yangtools.yang.data.codec.xml.XmlParserStream.LEGACY_ATTRIBUTE_NAMESPACE The use on this namespace is discouraged and users are strongly encouraged to proper RFC7952 metadata annotations.
org.opendaylight.yangtools.yang.parser.rfc7950.reactor.YangValidationBundles.SUPPORTED_DEVIATION_TARGETS This is an implementation leak from statement support and will be removed in next major version.
org.opendaylight.yangtools.yang.data.impl.leafref.LeafRefPathParser.tokenNames Use LeafRefPathParser.VOCABULARY instead.
org.opendaylight.yangtools.yang.data.impl.leafref.LeafRefPathLexer.tokenNames Use LeafRefPathLexer.VOCABULARY instead.
org.opendaylight.yangtools.yang.xpath.impl.xpathParser.tokenNames Use xpathParser.VOCABULARY instead.
org.opendaylight.yangtools.yang.xpath.impl.xpathLexer.tokenNames Use xpathLexer.VOCABULARY instead.
org.opendaylight.yangtools.yang.xpath.impl.instanceIdentifierParser.tokenNames Use instanceIdentifierParser.VOCABULARY instead.
org.opendaylight.yangtools.yang.xpath.impl.instanceIdentifierLexer.tokenNames Use instanceIdentifierLexer.VOCABULARY instead.
org.opendaylight.yangtools.antlrv4.code.gen.YangStatementParser.tokenNames Use YangStatementParser.VOCABULARY instead.
org.opendaylight.yangtools.antlrv4.code.gen.YangStatementLexer.tokenNames Use YangStatementLexer.VOCABULARY instead.
org.opendaylight.yangtools.antlrv4.code.gen.LeafRefPathParser.tokenNames Use LeafRefPathParser.VOCABULARY instead.
org.opendaylight.yangtools.antlrv4.code.gen.LeafRefPathLexer.tokenNames Use LeafRefPathLexer.VOCABULARY instead.
org.opendaylight.yangtools.antlrv4.code.gen.IfFeatureExpressionParser.tokenNames Use IfFeatureExpressionParser.VOCABULARY instead.
org.opendaylight.yangtools.antlrv4.code.gen.IfFeatureExpressionLexer.tokenNames Use IfFeatureExpressionLexer.VOCABULARY instead.

Deprecated Methods

Method and Description
org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifierWithPredicates.asMap() This method in a provisional one. It can be used in the code base, but users requiring it should contact yangtools-dev for migration guidelines. Callers are strongly encouraged to explore YangInstanceIdentifier.NodeIdentifierWithPredicates.entrySet(), YangInstanceIdentifier.NodeIdentifierWithPredicates.size(), YangInstanceIdentifier.NodeIdentifierWithPredicates.values() and YangInstanceIdentifier.NodeIdentifierWithPredicates.keySet() as an alternative.
org.opendaylight.yangtools.yang.model.repo.api.EffectiveModelContextFactory.createSchemaContext(Collection<SourceIdentifier>)
org.opendaylight.yangtools.yang.data.api.schema.tree.DataTreeCandidateNodes.fromNormalizedNode(NormalizedNode<?, ?>)
org.opendaylight.yangtools.yang.model.api.ChoiceSchemaNode.getCaseNodeByName(QName) Use either getCases().get(name) or #findCase(QName)
org.opendaylight.yangtools.yang.data.util.DataSchemaContextTree.getChild(YangInstanceIdentifier) Use DataSchemaContextTree.findChild(YangInstanceIdentifier) instead.
org.opendaylight.yangtools.yang.model.api.DataNodeContainer.getDataChildByName(QName) Use DataNodeContainer.findDataChildByName(QName) instead.
org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifierWithPredicates.getKeyValues() Map view is actively discouraged and should be considered deprecated. For replacement, please see YangInstanceIdentifier.NodeIdentifierWithPredicates.keySet(), #entrySet()}, YangInstanceIdentifier.NodeIdentifierWithPredicates.values() and YangInstanceIdentifier.NodeIdentifierWithPredicates.size(). As a last resort, please migrate to YangInstanceIdentifier.NodeIdentifierWithPredicates.asMap().
org.opendaylight.yangtools.yang.model.api.SchemaPath.getPath() Use SchemaPath.getPathFromRoot() instead.
org.opendaylight.yangtools.yang.data.impl.leafref.LeafRefPathParser.getTokenNames()
org.opendaylight.yangtools.yang.data.impl.leafref.LeafRefPathLexer.getTokenNames()
org.opendaylight.yangtools.yang.xpath.impl.xpathParser.getTokenNames()
org.opendaylight.yangtools.yang.xpath.impl.xpathLexer.getTokenNames()
org.opendaylight.yangtools.yang.xpath.impl.instanceIdentifierParser.getTokenNames()
org.opendaylight.yangtools.yang.xpath.impl.instanceIdentifierLexer.getTokenNames()
org.opendaylight.yangtools.antlrv4.code.gen.YangStatementParser.getTokenNames()
org.opendaylight.yangtools.antlrv4.code.gen.YangStatementLexer.getTokenNames()
org.opendaylight.yangtools.antlrv4.code.gen.LeafRefPathParser.getTokenNames()
org.opendaylight.yangtools.antlrv4.code.gen.LeafRefPathLexer.getTokenNames()
org.opendaylight.yangtools.antlrv4.code.gen.IfFeatureExpressionParser.getTokenNames()
org.opendaylight.yangtools.antlrv4.code.gen.IfFeatureExpressionLexer.getTokenNames()
org.opendaylight.yangtools.yang.model.api.UnknownSchemaNode.isAddedByAugmentation() This method exposes mechanism of how this node was instantiated. This runs contrary to the idea that a SchemaNode is part of the effective model of the world. Examining a node's DeclaredStatement world should be sufficient to ascertain its origin.
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.UnknownEffectiveStatementBase.isAddedByAugmentation()
org.opendaylight.yangtools.yang.data.util.OperationAsContainer.isAddedByUses()
org.opendaylight.yangtools.yang.model.util.AbstractSchemaContext.isAddedByUses()
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.choice.ImplicitCaseSchemaNode.isAddedByUses()
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.UnknownEffectiveStatementBase.isAddedByUses()
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.AbstractEffectiveSimpleDataNodeContainer.isAddedByUses()
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.AbstractEffectiveDataSchemaNode.isAddedByUses()
org.opendaylight.yangtools.yang.data.util.OperationAsContainer.isAugmenting()
org.opendaylight.yangtools.yang.model.util.AbstractSchemaContext.isAugmenting()
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.choice.ImplicitCaseSchemaNode.isAugmenting()
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.AbstractEffectiveSimpleDataNodeContainer.isAugmenting()
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.AbstractEffectiveDataSchemaNode.isAugmenting()
org.opendaylight.yangtools.yang.parser.spi.source.PrefixToModuleMap.isPreLinkageMap()
org.opendaylight.yangtools.yang.parser.spi.source.PrefixToModule.isPreLinkageMap() This property is bound to the currently-executing stage and so should be statically-wired.
org.opendaylight.yangtools.yang.parser.spi.meta.ModelActionBuilder.mutatesNs(StmtContext.Mutable<?, ?, ?>, Class<N>) Undocumented method. Use at your own risk.
org.opendaylight.yangtools.yang.parser.stmt.reactor.StatementContextBase.removeStatementsFromEffectiveSubstatements(Collection<? extends StmtContext<?, ?, ?>>) This method was used by EffectiveStatementBase to restore proper order of effects of uses statements. It is no longer used in that capacity and slated for removal.
org.opendaylight.yangtools.yang.parser.spi.meta.ModelActionBuilder.requiresDeclared(StmtContext<?, ?, ?>, Class<N>, K) Undocumented method. Use at your own risk.
org.opendaylight.yangtools.yang.parser.spi.meta.ModelActionBuilder.requiresDeclaredCtx(StmtContext<?, ?, ?>, Class<N>, K) Undocumented method. Use at your own risk.
org.opendaylight.yangtools.yang.parser.spi.meta.ModelActionBuilder.requiresEffective(StmtContext<?, ?, ?>, Class<N>, K) Undocumented method. Use at your own risk.
org.opendaylight.yangtools.yang.parser.spi.meta.ModelActionBuilder.requiresEffective(StmtContext<?, ?, ? extends E>) Undocumented method. Use at your own risk.
org.opendaylight.yangtools.yang.parser.spi.meta.ModelActionBuilder.requiresEffectiveCtx(StmtContext<?, ?, ?>, Class<N>, K) Undocumented method. Use at your own risk.
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.AbstractEffectiveSimpleDataNodeContainer.resetAugmenting() This method is a violation of immutable contract and is a side-effect of bad/incomplete lifecycle, which needs to be fixed. Do not introduce new callers. This deficiency is tracked in YANGTOOLS-724.
org.opendaylight.yangtools.yang.parser.rfc7950.stmt.AbstractEffectiveDataSchemaNode.resetAugmenting() This method is a violation of immutable contract and is a side-effect of bad/incomplete lifecycle, which needs to be fixed. Do not introduce new callers. This deficiency is tracked in YANGTOOLS-724.

Deprecated Constructors

Constructor and Description
org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifierWithPredicates(QName)
org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifierWithPredicates(QName, ImmutableOffsetMap<QName, Object>)
org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifierWithPredicates(QName, Map<QName, Object>)
org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifierWithPredicates(QName, QName, Object)
org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifierWithPredicates(QName, SharedSingletonMap<QName, Object>)
org.opendaylight.yangtools.yang.parser.spi.source.PrefixToModuleMap(boolean)