2 * Copyright (c) 2017 Pantheon Technologies, s.r.o. 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
8 package org.opendaylight.yangtools.yang.model.parser.api;
10 import com.google.common.annotations.Beta;
11 import java.util.Collection;
12 import org.eclipse.jdt.annotation.NonNull;
13 import org.opendaylight.yangtools.yang.model.repo.api.StatementParserMode;
14 import org.opendaylight.yangtools.yang.parser.api.ImportResolutionMode;
15 import org.opendaylight.yangtools.yang.parser.api.YangParserConfiguration;
18 * Basic entry point into a YANG parser implementation. Implementations of this interface are expected to be
21 * @deprecated Use {@link org.opendaylight.yangtools.yang.parser.api.YangParserFactory} instead.
24 @Deprecated(since = "7.0.0", forRemoval = true)
25 public interface YangParserFactory {
27 * Return enumeration of {@link StatementParserMode}s supported by this factory.
29 * @return Enumeration of supported schema source representations
31 Collection<StatementParserMode> supportedParserModes();
34 * Create a {@link YangParser} instance operating with default {@link YangParserConfiguration}.
36 * @return A new {@link YangParser} instance
38 default @NonNull YangParser createParser() {
39 return createParser(YangParserConfiguration.DEFAULT);
43 * Create a {@link YangParser} instance operating with specified {@link YangParserConfiguration}.
45 * @param configuration Requested parser configuration
46 * @return A new {@link YangParser} instance
47 * @throws NullPointerException if configuration is null
48 * @throws IllegalArgumentException if specified configuration is not supported
50 @NonNull YangParser createParser(YangParserConfiguration configuration);
53 * Create a {@link YangParser} instance operating in specified import resolution mode.
55 * @param parserMode Requested parser mode, may not be null.
56 * @return A new {@link YangParser} instance
57 * @throws NullPointerException if parser mode is null
58 * @throws IllegalArgumentException if specified parser mode is not supported
59 * @deprecated Use {@link #createParser(YangParserConfiguration)} instead.
61 @Deprecated(forRemoval = true)
62 default @NonNull YangParser createParser(final StatementParserMode parserMode) {
63 final ImportResolutionMode importMode;
66 importMode = ImportResolutionMode.DEFAULT;
69 importMode = ImportResolutionMode.OPENCONFIG_SEMVER;
72 throw new IllegalArgumentException("Unsupported mode " + parserMode);
75 return createParser(YangParserConfiguration.builder().importResolutionMode(importMode).build());