blob: ab8134fa79bafce959897a57f8d50d3f1e2625f6 [file] [log] [blame]
Bharat saraswal870c56f2016-02-20 21:57:16 +05301/*
Brian O'Connor5ab426f2016-04-09 01:19:45 -07002 * Copyright 2016-present Open Networking Laboratory
Bharat saraswal870c56f2016-02-20 21:57:16 +05303 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package org.onosproject.yangutils.translator.tojava.utils;
18
Shankara-Huaweidf7b9ca2016-07-14 11:35:34 +053019import org.onosproject.yangutils.datamodel.YangIdentity;
Bharat saraswalab4c6ba2016-05-17 14:19:38 +053020import org.onosproject.yangutils.datamodel.YangNode;
Gaurav Agrawal8a5af142016-06-15 13:58:01 +053021import org.onosproject.yangutils.datamodel.YangNotification;
Shankara-Huaweidf7b9ca2016-07-14 11:35:34 +053022import org.onosproject.yangutils.translator.exception.TranslatorException;
Bharat saraswalab4c6ba2016-05-17 14:19:38 +053023import org.onosproject.yangutils.translator.tojava.JavaQualifiedTypeInfo;
24import org.onosproject.yangutils.translator.tojava.TempJavaCodeFragmentFilesContainer;
Shankara-Huaweidf7b9ca2016-07-14 11:35:34 +053025import org.onosproject.yangutils.translator.tojava.javamodel.YangJavaIdentity;
Bharat saraswalab4c6ba2016-05-17 14:19:38 +053026
Bharat saraswale2d51d62016-03-23 19:40:35 +053027import static org.onosproject.yangutils.translator.tojava.GeneratedJavaFileType.BUILDER_CLASS_MASK;
28import static org.onosproject.yangutils.translator.tojava.GeneratedJavaFileType.BUILDER_INTERFACE_MASK;
Bharat saraswald72411a2016-04-19 01:00:16 +053029import static org.onosproject.yangutils.translator.tojava.GeneratedJavaFileType.GENERATE_ENUM_CLASS;
VinodKumarS-Huaweicb3a1f52016-05-10 17:58:57 +053030import static org.onosproject.yangutils.translator.tojava.GeneratedJavaFileType.GENERATE_EVENT_CLASS;
31import static org.onosproject.yangutils.translator.tojava.GeneratedJavaFileType.GENERATE_EVENT_LISTENER_INTERFACE;
Bharat saraswal33dfa012016-05-17 19:59:16 +053032import static org.onosproject.yangutils.translator.tojava.GeneratedJavaFileType.GENERATE_EVENT_SUBJECT_CLASS;
Shankara-Huaweidf7b9ca2016-07-14 11:35:34 +053033import static org.onosproject.yangutils.translator.tojava.GeneratedJavaFileType.GENERATE_IDENTITY_CLASS;
VinodKumarS-Huaweicb3a1f52016-05-10 17:58:57 +053034import static org.onosproject.yangutils.translator.tojava.GeneratedJavaFileType.GENERATE_SERVICE_AND_MANAGER;
Bharat saraswale2d51d62016-03-23 19:40:35 +053035import static org.onosproject.yangutils.translator.tojava.GeneratedJavaFileType.GENERATE_TYPEDEF_CLASS;
Gaurav Agrawal338735b2016-04-18 18:53:11 +053036import static org.onosproject.yangutils.translator.tojava.GeneratedJavaFileType.GENERATE_UNION_CLASS;
Bharat saraswale2d51d62016-03-23 19:40:35 +053037import static org.onosproject.yangutils.translator.tojava.GeneratedJavaFileType.IMPL_CLASS_MASK;
38import static org.onosproject.yangutils.translator.tojava.GeneratedJavaFileType.INTERFACE_MASK;
39import static org.onosproject.yangutils.utils.UtilConstants.BUILDER;
40import static org.onosproject.yangutils.utils.UtilConstants.CLASS;
Bharat saraswalcc1cdab2016-04-16 02:28:25 +053041import static org.onosproject.yangutils.utils.UtilConstants.COMMA;
Bharat saraswalab4c6ba2016-05-17 14:19:38 +053042import static org.onosproject.yangutils.utils.UtilConstants.DIAMOND_CLOSE_BRACKET;
43import static org.onosproject.yangutils.utils.UtilConstants.DIAMOND_OPEN_BRACKET;
44import static org.onosproject.yangutils.utils.UtilConstants.EIGHT_SPACE_INDENTATION;
Bharat saraswald72411a2016-04-19 01:00:16 +053045import static org.onosproject.yangutils.utils.UtilConstants.ENUM;
Bharat saraswalab4c6ba2016-05-17 14:19:38 +053046import static org.onosproject.yangutils.utils.UtilConstants.EVENT_LISTENER_STRING;
47import static org.onosproject.yangutils.utils.UtilConstants.EVENT_STRING;
Bharat saraswalcc1cdab2016-04-16 02:28:25 +053048import static org.onosproject.yangutils.utils.UtilConstants.EXTEND;
Bharat saraswale2d51d62016-03-23 19:40:35 +053049import static org.onosproject.yangutils.utils.UtilConstants.FINAL;
50import static org.onosproject.yangutils.utils.UtilConstants.IMPL;
51import static org.onosproject.yangutils.utils.UtilConstants.IMPLEMENTS;
52import static org.onosproject.yangutils.utils.UtilConstants.INTERFACE;
Bharat saraswalab4c6ba2016-05-17 14:19:38 +053053import static org.onosproject.yangutils.utils.UtilConstants.LISTENER_REG;
54import static org.onosproject.yangutils.utils.UtilConstants.LISTENER_SERVICE;
VinodKumarS-Huaweicb3a1f52016-05-10 17:58:57 +053055import static org.onosproject.yangutils.utils.UtilConstants.MANAGER;
Bharat saraswale2d51d62016-03-23 19:40:35 +053056import static org.onosproject.yangutils.utils.UtilConstants.NEW_LINE;
57import static org.onosproject.yangutils.utils.UtilConstants.OPEN_CURLY_BRACKET;
58import static org.onosproject.yangutils.utils.UtilConstants.PERIOD;
59import static org.onosproject.yangutils.utils.UtilConstants.PUBLIC;
janani bdd1314f2016-05-19 17:39:50 +053060import static org.onosproject.yangutils.utils.UtilConstants.REGEX_FOR_ANY_STRING_ENDING_WITH_SERVICE;
VinodKumarS-Huaweicb3a1f52016-05-10 17:58:57 +053061import static org.onosproject.yangutils.utils.UtilConstants.SERVICE;
Bharat saraswale2d51d62016-03-23 19:40:35 +053062import static org.onosproject.yangutils.utils.UtilConstants.SPACE;
Bharat saraswal33dfa012016-05-17 19:59:16 +053063import static org.onosproject.yangutils.utils.UtilConstants.SUBJECT;
Shankara-Huaweidf7b9ca2016-07-14 11:35:34 +053064import static org.onosproject.yangutils.utils.UtilConstants.ABSTRACT;
65import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.getCapitalCase;
Bharat saraswalcc1cdab2016-04-16 02:28:25 +053066import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.trimAtLast;
Bharat saraswal870c56f2016-02-20 21:57:16 +053067
68/**
Bharat saraswald9822e92016-04-05 15:13:44 +053069 * Represents generator for class definition of generated files.
Bharat saraswal870c56f2016-02-20 21:57:16 +053070 */
71public final class ClassDefinitionGenerator {
72
73 /**
Bharat saraswald9822e92016-04-05 15:13:44 +053074 * Creates an instance of class definition generator.
Bharat saraswal870c56f2016-02-20 21:57:16 +053075 */
76 private ClassDefinitionGenerator() {
77 }
78
79 /**
Vinod Kumar Sc4216002016-03-03 19:55:30 +053080 * Based on the file type and the YANG name of the file, generate the class
81 * / interface definition start.
Bharat saraswal870c56f2016-02-20 21:57:16 +053082 *
83 * @param genFileTypes generated file type
Gaurav Agrawal8a5af142016-06-15 13:58:01 +053084 * @param yangName class name
Bharat saraswal870c56f2016-02-20 21:57:16 +053085 * @return class definition
86 */
Vinod Kumar Sc4216002016-03-03 19:55:30 +053087 public static String generateClassDefinition(int genFileTypes, String yangName) {
Bharat saraswal870c56f2016-02-20 21:57:16 +053088
89 /**
Gaurav Agrawal56527662016-04-20 15:49:17 +053090 * Based on the file type and the YANG name of the file, generate the
Vinod Kumar Sc4216002016-03-03 19:55:30 +053091 * class / interface definition start.
Bharat saraswal870c56f2016-02-20 21:57:16 +053092 */
Bharat saraswalab4c6ba2016-05-17 14:19:38 +053093 switch (genFileTypes) {
Gaurav Agrawal8a5af142016-06-15 13:58:01 +053094 case BUILDER_CLASS_MASK:
95 return getBuilderClassDefinition(yangName);
96 case IMPL_CLASS_MASK:
97 return getImplClassDefinition(yangName);
98 case BUILDER_INTERFACE_MASK:
99 return getBuilderInterfaceDefinition(yangName);
100 case GENERATE_TYPEDEF_CLASS:
101 case GENERATE_UNION_CLASS:
102 return getTypeClassDefinition(yangName);
103 case GENERATE_ENUM_CLASS:
104 return getEnumClassDefinition(yangName);
105 default:
106 return null;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530107 }
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530108 }
109
110 /**
111 * Based on the file type and the YANG name of the file, generate the class
112 * / interface definition start.
113 *
114 * @param genFileTypes generated file type
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530115 * @param yangName class name
116 * @param curNode current YANG node
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530117 * @return class definition
118 */
119 public static String generateClassDefinition(int genFileTypes, String yangName, YangNode curNode) {
120
121 /**
122 * Based on the file type and the YANG name of the file, generate the
123 * class / interface definition start.
124 */
125 switch (genFileTypes) {
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530126 case INTERFACE_MASK:
127 return getInterfaceDefinition(yangName, curNode);
128 case GENERATE_SERVICE_AND_MANAGER:
129 return getRpcInterfaceDefinition(yangName, curNode);
130 case GENERATE_EVENT_CLASS:
131 String eventName = yangName + SUBJECT;
132 return getEventDefinition(yangName, eventName);
133 case GENERATE_EVENT_LISTENER_INTERFACE:
134 return getEventListenerDefinition(yangName);
135 case GENERATE_EVENT_SUBJECT_CLASS:
136 return getClassDefinition(yangName);
Shankara-Huaweidf7b9ca2016-07-14 11:35:34 +0530137 case GENERATE_IDENTITY_CLASS:
138 return getIdentityClassDefinition(yangName, curNode);
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530139 default:
140 return null;
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530141 }
Bharat saraswal870c56f2016-02-20 21:57:16 +0530142 }
143
144 /**
Bharat saraswald72411a2016-04-19 01:00:16 +0530145 * Returns enum file class definition.
146 *
147 * @param yangName class name
Gaurav Agrawal56527662016-04-20 15:49:17 +0530148 * @return enum file class definition
Bharat saraswald72411a2016-04-19 01:00:16 +0530149 */
150 private static String getEnumClassDefinition(String yangName) {
151 return PUBLIC + SPACE + ENUM + SPACE + yangName + SPACE + OPEN_CURLY_BRACKET + NEW_LINE;
152 }
153
154 /**
Bharat saraswal870c56f2016-02-20 21:57:16 +0530155 * Returns interface file class definition.
156 *
157 * @param yangName file name
158 * @return definition
159 */
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530160 private static String getInterfaceDefinition(String yangName, YangNode curNode) {
161 JavaExtendsListHolder holder = ((TempJavaCodeFragmentFilesContainer) curNode)
162 .getTempJavaCodeFragmentFiles().getBeanTempFiles().getJavaExtendsListHolder();
Bharat saraswal870c56f2016-02-20 21:57:16 +0530163
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530164 if (holder.getExtendsList() != null && !holder.getExtendsList().isEmpty()) {
165 String def = PUBLIC + SPACE + INTERFACE + SPACE + yangName + SPACE + EXTEND + SPACE;
166 for (JavaQualifiedTypeInfo info : holder.getExtendsList()) {
167 if (!holder.getExtendedClassStore().get(info)) {
168 def = def + info.getClassInfo() + COMMA + SPACE;
169 } else {
170 def = def + info.getPkgInfo() + PERIOD + info.getClassInfo() + COMMA + SPACE;
171 }
172 }
173
174 def = trimAtLast(def, COMMA);
175
176 return def + SPACE + OPEN_CURLY_BRACKET + NEW_LINE;
177 }
178 return PUBLIC + SPACE + INTERFACE + SPACE + yangName + SPACE + OPEN_CURLY_BRACKET + NEW_LINE;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530179 }
180
181 /**
182 * Returns builder interface file class definition.
183 *
Vinod Kumar Sc4216002016-03-03 19:55:30 +0530184 * @param yangName java class name, corresponding to which the builder class
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530185 * is being generated
Bharat saraswal870c56f2016-02-20 21:57:16 +0530186 * @return definition
187 */
Vinod Kumar Sc4216002016-03-03 19:55:30 +0530188 private static String getBuilderInterfaceDefinition(String yangName) {
Bharat saraswale2d51d62016-03-23 19:40:35 +0530189 return INTERFACE + SPACE + yangName + BUILDER + SPACE + OPEN_CURLY_BRACKET + NEW_LINE + NEW_LINE;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530190 }
191
192 /**
193 * Returns builder file class definition.
194 *
195 * @param yangName file name
196 * @return definition
197 */
Bharat saraswalc0e04842016-05-12 13:16:57 +0530198 private static String getBuilderClassDefinition(String yangName) {
199 return PUBLIC + SPACE + CLASS + SPACE + yangName + BUILDER + SPACE + IMPLEMENTS + SPACE + yangName + PERIOD
200 + yangName + BUILDER + SPACE + OPEN_CURLY_BRACKET + NEW_LINE;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530201 }
202
203 /**
204 * Returns impl file class definition.
205 *
206 * @param yangName file name
207 * @return definition
208 */
209 private static String getImplClassDefinition(String yangName) {
Bharat saraswal33dfa012016-05-17 19:59:16 +0530210 return PUBLIC + SPACE + FINAL + SPACE + CLASS + SPACE + yangName + IMPL + SPACE + IMPLEMENTS + SPACE
211 + yangName + SPACE + OPEN_CURLY_BRACKET + NEW_LINE;
212 }
213
214 /**
215 * Returns impl file class definition.
216 *
217 * @param yangName file name
218 * @return definition
219 */
220 private static String getClassDefinition(String yangName) {
221 return PUBLIC + SPACE + CLASS + SPACE + yangName + SPACE + OPEN_CURLY_BRACKET + NEW_LINE;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530222 }
223
Bharat saraswal2f00b4b2016-03-04 20:08:09 +0530224 /**
Shankara-Huaweidf7b9ca2016-07-14 11:35:34 +0530225 * Returns implementation file identity class definition.
226 *
227 * @param yangName file name
228 * @return identity class definition
229 */
230 private static String getIdentityClassDefinition(String yangName, YangNode curNode) {
231 if (!(curNode instanceof YangJavaIdentity)) {
232 throw new TranslatorException("Expected java identity instance node");
233 }
234 YangJavaIdentity identity = (YangJavaIdentity) curNode;
235 if (identity.getBaseNode() != null) {
236 YangIdentity baseIdentity = identity.getBaseNode().getReferredIdentity();
237 if (!(baseIdentity instanceof YangJavaIdentity)) {
238 throw new TranslatorException("Expected java identity instance node");
239 }
240
241 YangJavaIdentity baseJavaIdentity = (YangJavaIdentity) baseIdentity;
242 return PUBLIC + SPACE + ABSTRACT + SPACE + CLASS + SPACE + yangName + SPACE + EXTEND + SPACE
243 + getCapitalCase(baseJavaIdentity.getJavaFileInfo().getJavaName()) + SPACE +
244 OPEN_CURLY_BRACKET + NEW_LINE;
245 }
246
247 return PUBLIC + SPACE + ABSTRACT + SPACE + CLASS + SPACE + yangName + SPACE + OPEN_CURLY_BRACKET + NEW_LINE;
248 }
249
250 /**
Gaurav Agrawal338735b2016-04-18 18:53:11 +0530251 * Returns type file class definition.
Bharat saraswal2f00b4b2016-03-04 20:08:09 +0530252 *
253 * @param yangName file name
254 * @return definition
255 */
Gaurav Agrawal338735b2016-04-18 18:53:11 +0530256 private static String getTypeClassDefinition(String yangName) {
Bharat saraswale2d51d62016-03-23 19:40:35 +0530257 return PUBLIC + SPACE + FINAL + SPACE + CLASS + SPACE + yangName + SPACE + OPEN_CURLY_BRACKET + NEW_LINE;
Bharat saraswal2f00b4b2016-03-04 20:08:09 +0530258 }
Gaurav Agrawal56527662016-04-20 15:49:17 +0530259
260 /**
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530261 * Returns RPC file interface definition.
Gaurav Agrawal56527662016-04-20 15:49:17 +0530262 *
263 * @param yangName file name
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530264 * @param curNode current YANG node
Gaurav Agrawal56527662016-04-20 15:49:17 +0530265 * @return definition
266 */
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530267 private static String getRpcInterfaceDefinition(String yangName, YangNode curNode) {
268 JavaExtendsListHolder holder = ((TempJavaCodeFragmentFilesContainer) curNode)
269 .getTempJavaCodeFragmentFiles().getServiceTempFiles().getJavaExtendsListHolder();
270 if (holder.getExtendsList() != null && !holder.getExtendsList().isEmpty()) {
271 curNode = curNode.getChild();
272 while (curNode != null) {
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530273 if (curNode instanceof YangNotification) {
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530274 return getRpcInterfaceDefinitionWhenItExtends(yangName, holder);
275 }
276 curNode = curNode.getNextSibling();
277 }
278 }
janani bdd1314f2016-05-19 17:39:50 +0530279 if (yangName.matches(REGEX_FOR_ANY_STRING_ENDING_WITH_SERVICE)) {
Bharat saraswalc0e04842016-05-12 13:16:57 +0530280 return PUBLIC + SPACE + INTERFACE + SPACE + yangName + SPACE + OPEN_CURLY_BRACKET + NEW_LINE;
281 }
janani bdd1314f2016-05-19 17:39:50 +0530282 return PUBLIC + SPACE + CLASS + SPACE + yangName + SPACE + IMPLEMENTS + SPACE
283 + yangName.substring(0, yangName.length() - 7) + SERVICE + SPACE + OPEN_CURLY_BRACKET + NEW_LINE;
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530284 }
285
286 /* Provides class definition when RPC interface needs to extends any event.*/
287 private static String getRpcInterfaceDefinitionWhenItExtends(String yangName,
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530288 JavaExtendsListHolder holder) {
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530289
janani bdd1314f2016-05-19 17:39:50 +0530290 if (yangName.matches(REGEX_FOR_ANY_STRING_ENDING_WITH_SERVICE)) {
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530291 String[] strArray = yangName.split(SERVICE);
Bharat saraswal33dfa012016-05-17 19:59:16 +0530292 return PUBLIC + SPACE + INTERFACE + SPACE + yangName + NEW_LINE + EIGHT_SPACE_INDENTATION
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530293 + EXTEND + SPACE + LISTENER_SERVICE + DIAMOND_OPEN_BRACKET + strArray[0] + EVENT_STRING + COMMA
294 + SPACE + strArray[0] + EVENT_LISTENER_STRING + DIAMOND_CLOSE_BRACKET + SPACE
295 + OPEN_CURLY_BRACKET + NEW_LINE;
296 }
janani bdd1314f2016-05-19 17:39:50 +0530297 yangName = yangName.substring(0, yangName.length() - 7);
Bharat saraswal33dfa012016-05-17 19:59:16 +0530298 return PUBLIC + SPACE + CLASS + SPACE + yangName + MANAGER + NEW_LINE + EIGHT_SPACE_INDENTATION
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530299 + EXTEND + SPACE + LISTENER_REG + DIAMOND_OPEN_BRACKET + yangName + EVENT_STRING + COMMA + SPACE
Bharat saraswal33dfa012016-05-17 19:59:16 +0530300 + yangName + EVENT_LISTENER_STRING + DIAMOND_CLOSE_BRACKET + NEW_LINE
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530301 + EIGHT_SPACE_INDENTATION + IMPLEMENTS + SPACE + yangName + SERVICE + SPACE + OPEN_CURLY_BRACKET
302 + NEW_LINE;
Gaurav Agrawal56527662016-04-20 15:49:17 +0530303 }
VinodKumarS-Huaweicb3a1f52016-05-10 17:58:57 +0530304
305 /**
306 * Returns event class definition.
307 *
308 * @param javaName file name
309 * @return definition
310 */
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530311 private static String getEventDefinition(String javaName, String eventName) {
VinodKumarS-Huaweicb3a1f52016-05-10 17:58:57 +0530312 String classDef = PUBLIC + SPACE + CLASS + SPACE + javaName + SPACE + "extends AbstractEvent<"
Bharat saraswalab4c6ba2016-05-17 14:19:38 +0530313 + javaName + ".Type, " + eventName + ">" + SPACE + OPEN_CURLY_BRACKET + NEW_LINE;
VinodKumarS-Huaweicb3a1f52016-05-10 17:58:57 +0530314
315 return classDef;
316 }
317
318 /**
319 * Returns event listener interface definition.
320 *
321 * @param javaName file name
322 * @return definition
323 */
324 private static String getEventListenerDefinition(String javaName) {
325 String intfDef = PUBLIC + SPACE + INTERFACE + SPACE + javaName + SPACE + "extends EventListener<"
326 + javaName;
327 if (intfDef.length() < 8) {
328 throw new RuntimeException("Event listener interface name is error");
329 }
Bharat saraswalc0e04842016-05-12 13:16:57 +0530330 intfDef = intfDef.substring(0, intfDef.length() - 8);
VinodKumarS-Huaweicb3a1f52016-05-10 17:58:57 +0530331 intfDef = intfDef + "Event>" + SPACE + OPEN_CURLY_BRACKET + NEW_LINE;
332
333 return intfDef;
334 }
Bharat saraswal870c56f2016-02-20 21:57:16 +0530335}