BUG-865: deprecate pre-Beryllium parser elements

[yangtools.git] / yang / yang-parser-impl / src / main / java / org / opendaylight / yangtools / yang / parser / builder / api / SchemaNodeBuilder.java

diff --git a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/SchemaNodeBuilder.java b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/SchemaNodeBuilder.java
index b6817ca8574fdbc09e333889a5b1c61512b9db8f..a2d3a51d9f89b9a5cb2e9255f3dc99e5bebd11f2 100644 (file)
--- a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/SchemaNodeBuilder.java
+++ b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/SchemaNodeBuilder.java
@@ -1,81 +1,49 @@
-/*\r
- * Copyright (c) 2013 Cisco Systems, Inc. and others.  All rights reserved.\r
- *\r
- * This program and the accompanying materials are made available under the\r
- * terms of the Eclipse Public License v1.0 which accompanies this distribution,\r
- * and is available at http://www.eclipse.org/legal/epl-v10.html\r
- */\r
-package org.opendaylight.yangtools.yang.parser.builder.api;\r
-\r
-import org.opendaylight.yangtools.yang.common.QName;\r
-import org.opendaylight.yangtools.yang.model.api.SchemaNode;\r
-import org.opendaylight.yangtools.yang.model.api.SchemaPath;\r
-import org.opendaylight.yangtools.yang.model.api.Status;\r
-\r
-/**\r
- * Interface for all builders of SchemaNode nodes.\r
- */\r
-public interface SchemaNodeBuilder extends Builder {\r
-\r
-    /**\r
-     * Get qname of this node.\r
-     *\r
-     * @return QName of this node\r
-     */\r
-    QName getQName();\r
-\r
-    /**\r
-     * Get schema path of this node.\r
-     *\r
-     * @return SchemaPath of this node\r
-     */\r
-    SchemaPath getPath();\r
-\r
-    /**\r
-     * Get description of this node.\r
-     *\r
-     * @return description statement\r
-     */\r
-    String getDescription();\r
-\r
-    /**\r
-     * Set description to this node.\r
-     *\r
-     * @param description\r
-     */\r
-    void setDescription(String description);\r
-\r
-    /**\r
-     * Get reference of this node.\r
-     *\r
-     * @return reference statement\r
-     */\r
-    String getReference();\r
-\r
-    /**\r
-     * Set reference to this node.\r
-     *\r
-     * @param reference\r
-     */\r
-    void setReference(String reference);\r
-\r
-    /**\r
-     * Get status of this node.\r
-     *\r
-     * @return status statement\r
-     */\r
-    Status getStatus();\r
-\r
-    /**\r
-     * Set status to this node.\r
-     *\r
-     * @param status\r
-     */\r
-    void setStatus(Status status);\r
-\r
-    /**\r
-     * Build SchemaNode object from this builder.\r
-     */\r
-    SchemaNode build();\r
-\r
-}\r
+/*
+ * Copyright (c) 2013 Cisco Systems, Inc. and others.  All rights reserved.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v1.0 which accompanies this distribution,
+ * and is available at http://www.eclipse.org/legal/epl-v10.html
+ */
+package org.opendaylight.yangtools.yang.parser.builder.api;
+
+import org.opendaylight.yangtools.yang.common.QName;
+import org.opendaylight.yangtools.yang.model.api.SchemaNode;
+import org.opendaylight.yangtools.yang.model.api.SchemaPath;
+
+/**
+ * Builder for {@link SchemaNode}.
+ *
+ * @deprecated Pre-Beryllium implementation, scheduled for removal.
+ */
+@Deprecated
+public interface SchemaNodeBuilder extends DocumentedNodeBuilder, Builder {
+
+    /**
+     * Returns qname of resulting {@link SchemaNode}.
+     *
+     * @return QName of this node
+     */
+    QName getQName();
+
+    /**
+     * Returns schema path of resulting  {@link SchemaNode}.
+     *
+     * @return SchemaPath of this node
+     */
+    SchemaPath getPath();
+
+    /**
+     * Updates schema path to resulting {@link SchemaNode}.
+     *
+     * @param path schema path
+     */
+    void setPath(SchemaPath path);
+
+    /**
+     * Build SchemaNode object from this builder.
+     */
+    @Override
+    SchemaNode build();
+
+}