API Clarity: Documentented o.o.y.yang.parser.impl.util
[yangtools.git] / yang / yang-parser-impl / src / main / java / org / opendaylight / yangtools / yang / parser / impl / util / YangSourceFromCapabilitiesResolver.java
1 /*
2  * Copyright (c) 2014 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/eplv10.html
7  */
8 package org.opendaylight.yangtools.yang.parser.impl.util;
9
10 import java.io.InputStream;
11
12 import org.opendaylight.yangtools.yang.common.QName;
13 import org.opendaylight.yangtools.yang.model.util.repo.SchemaSourceProvider;
14 import org.opendaylight.yangtools.yang.model.util.repo.SchemaSourceProviders;
15 import org.opendaylight.yangtools.yang.model.util.repo.SourceIdentifier;
16
17 import com.google.common.base.Optional;
18
19 /**
20  *
21  * Source code resolver which resolves Yang Source Context against
22  * {@link SchemaSourceProvider} and set of QName which represent capabilities.
23  *
24  * This source code resolver is useful for components which deals with
25  * capability exchange similar to YANG/Netconf specification
26  * and there is {@link SchemaSourceProvider} able to retrieve YANG models.
27  *
28  */
29 public final class YangSourceFromCapabilitiesResolver extends YangSourceContextResolver {
30
31     private final Iterable<QName> capabilities;
32
33     /**
34      * Construct new {@link YangSourceFromCapabilitiesResolver}.
35      *
36      * @param capabilities Set of QName representing module capabilities, {@link QName#getLocalName()} represents
37      * source name and {@link QName#getRevision()} represents revision of source.
38      *
39      * @param schemaSourceProvider - {@link SchemaSourceProvider} which should be used to resolve sources.
40      */
41     public YangSourceFromCapabilitiesResolver(final Iterable<QName> capabilities,
42             final SchemaSourceProvider<InputStream> schemaSourceProvider) {
43         super(SchemaSourceProviders.toAdvancedSchemaSourceProvider(schemaSourceProvider));
44         this.capabilities = capabilities;
45     }
46
47     @Override
48     public YangSourceContext resolveContext() {
49         for (QName capability : capabilities) {
50             resolveCapability(capability);
51         }
52         return createSourceContext();
53     }
54
55     private void resolveCapability(final QName capability) {
56         super.resolveSource(capability.getLocalName(), Optional.fromNullable(capability.getFormattedRevision()));
57     }
58
59     @Override
60     public Optional<YangModelDependencyInfo> getDependencyInfo(final SourceIdentifier identifier) {
61         Optional<InputStream> source = getSourceProvider().getSchemaSource(identifier);
62         if (source.isPresent()) {
63             return Optional.of(YangModelDependencyInfo.fromInputStream(source.get()));
64         }
65         return Optional.absent();
66     }
67
68 }