blob: 93e26c756ee4e771586e91bacd26f5a5fd21f51f [file] [log] [blame]
Bharat saraswal97459962016-02-20 21:57:16 +05301/*
Brian O'Connor0f7908b2016-04-09 01:19:45 -07002 * Copyright 2016-present Open Networking Laboratory
Bharat saraswal97459962016-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
Gaurav Agrawalbfce9342016-06-15 13:58:01 +053019import java.io.File;
20import java.io.IOException;
Vidyashree Rama13b4c552016-06-20 15:12:43 +053021import java.text.SimpleDateFormat;
Bharat saraswal97459962016-02-20 21:57:16 +053022import java.util.ArrayList;
Bharat saraswal8beac342016-08-04 02:00:03 +053023import java.util.Arrays;
24import java.util.Collections;
Vidyashree Rama13b4c552016-06-20 15:12:43 +053025import java.util.Date;
janani b1c6acc42016-04-15 16:18:30 +053026import java.util.List;
Bharat saraswal8beac342016-08-04 02:00:03 +053027
Vinod Kumar S9f26ae52016-03-23 15:30:27 +053028import org.onosproject.yangutils.datamodel.YangNode;
Bharat saraswal1edde622016-09-06 10:18:04 +053029import org.onosproject.yangutils.datamodel.YangRevision;
Bharat saraswal8beac342016-08-04 02:00:03 +053030import org.onosproject.yangutils.translator.exception.TranslatorException;
31import org.onosproject.yangutils.translator.tojava.JavaFileInfoContainer;
Bharat saraswale50edca2016-08-05 01:58:25 +053032import org.onosproject.yangutils.translator.tojava.JavaFileInfoTranslator;
Bharat saraswale3175d32016-08-31 17:50:11 +053033import org.onosproject.yangutils.utils.io.YangToJavaNamingConflictUtil;
Bharat saraswal84366c52016-03-23 19:40:35 +053034
Gaurav Agrawalbfce9342016-06-15 13:58:01 +053035import static org.onosproject.yangutils.datamodel.utils.DataModelUtils.getParentNodeInGenCode;
Bharat saraswal84366c52016-03-23 19:40:35 +053036import static org.onosproject.yangutils.utils.UtilConstants.COLAN;
37import static org.onosproject.yangutils.utils.UtilConstants.DEFAULT_BASE_PKG;
38import static org.onosproject.yangutils.utils.UtilConstants.EMPTY_STRING;
39import static org.onosproject.yangutils.utils.UtilConstants.HYPHEN;
40import static org.onosproject.yangutils.utils.UtilConstants.JAVA_KEY_WORDS;
41import static org.onosproject.yangutils.utils.UtilConstants.PERIOD;
42import static org.onosproject.yangutils.utils.UtilConstants.QUOTES;
43import static org.onosproject.yangutils.utils.UtilConstants.REGEX_FOR_FIRST_DIGIT;
janani b1c6acc42016-04-15 16:18:30 +053044import static org.onosproject.yangutils.utils.UtilConstants.REGEX_WITH_ALL_SPECIAL_CHAR;
Bharat saraswald532a4c2016-03-25 18:19:46 +053045import static org.onosproject.yangutils.utils.UtilConstants.REVISION_PREFIX;
Bharat saraswal84366c52016-03-23 19:40:35 +053046import static org.onosproject.yangutils.utils.UtilConstants.SLASH;
47import static org.onosproject.yangutils.utils.UtilConstants.UNDER_SCORE;
Bharat saraswald532a4c2016-03-25 18:19:46 +053048import static org.onosproject.yangutils.utils.UtilConstants.VERSION_PREFIX;
Gaurav Agrawalbfce9342016-06-15 13:58:01 +053049import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.addPackageInfo;
50import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.createDirectories;
51import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.getAbsolutePackagePath;
52import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.getJavaPackageFromPackagePath;
53import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.getPackageDirPathFromJavaJPackage;
Bharat saraswal8beac342016-08-04 02:00:03 +053054import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.getPrefixForIdentifier;
Bharat saraswal97459962016-02-20 21:57:16 +053055
56/**
Bharat saraswal63f26fb2016-04-05 15:13:44 +053057 * Represents an utility Class for translating the name from YANG to java convention.
Bharat saraswal97459962016-02-20 21:57:16 +053058 */
59public final class JavaIdentifierSyntax {
60
b.jananie6d43af2016-03-04 12:29:05 +053061 private static final int INDEX_ZERO = 0;
62 private static final int INDEX_ONE = 1;
Bharat saraswal780eca32016-04-05 12:45:45 +053063 private static final int VALUE_CHECK = 10;
64 private static final String ZERO = "0";
Vidyashree Rama13b4c552016-06-20 15:12:43 +053065 private static final String DATE_FORMAT = "yyyy-MM-dd";
b.jananie6d43af2016-03-04 12:29:05 +053066
Bharat saraswal97459962016-02-20 21:57:16 +053067 /**
Bharat saraswal63f26fb2016-04-05 15:13:44 +053068 * Create instance of java identifier syntax.
Bharat saraswal97459962016-02-20 21:57:16 +053069 */
70 private JavaIdentifierSyntax() {
71 }
72
73 /**
Bharat saraswal63f26fb2016-04-05 15:13:44 +053074 * Returns the root package string.
Bharat saraswal97459962016-02-20 21:57:16 +053075 *
Gaurav Agrawalbfce9342016-06-15 13:58:01 +053076 * @param version YANG version
77 * @param nameSpace name space of the module
78 * @param revision revision of the module defined
janani b3e357f62016-05-19 17:39:50 +053079 * @param conflictResolver object of YANG to java naming conflict util
80 * @return the root package string
Bharat saraswal97459962016-02-20 21:57:16 +053081 */
Bharat saraswal1edde622016-09-06 10:18:04 +053082 public static String getRootPackage(byte version, String nameSpace, YangRevision revision,
Gaurav Agrawalbfce9342016-06-15 13:58:01 +053083 YangToJavaNamingConflictUtil conflictResolver) {
Bharat saraswal97459962016-02-20 21:57:16 +053084
85 String pkg;
Bharat saraswal84366c52016-03-23 19:40:35 +053086 pkg = DEFAULT_BASE_PKG;
87 pkg = pkg + PERIOD;
Bharat saraswal97459962016-02-20 21:57:16 +053088 pkg = pkg + getYangVersion(version);
Bharat saraswal84366c52016-03-23 19:40:35 +053089 pkg = pkg + PERIOD;
janani b3e357f62016-05-19 17:39:50 +053090 pkg = pkg + getPkgFromNameSpace(nameSpace, conflictResolver);
Bharat saraswal1edde622016-09-06 10:18:04 +053091 if (revision != null) {
92 pkg = pkg + PERIOD;
93 pkg = pkg + getYangRevisionStr(revision.getRevDate());
94 }
Bharat saraswalc46ee2a2016-02-25 02:26:43 +053095 return pkg.toLowerCase();
Bharat saraswal97459962016-02-20 21:57:16 +053096 }
97
98 /**
99 * Returns version.
100 *
Vinod Kumar S08710982016-03-03 19:55:30 +0530101 * @param ver YANG version
Bharat saraswal97459962016-02-20 21:57:16 +0530102 * @return version
103 */
104 private static String getYangVersion(byte ver) {
Bharat saraswald532a4c2016-03-25 18:19:46 +0530105 return VERSION_PREFIX + ver;
Bharat saraswal97459962016-02-20 21:57:16 +0530106 }
107
108 /**
Bharat saraswal63f26fb2016-04-05 15:13:44 +0530109 * Returns package name from name space.
Bharat saraswal97459962016-02-20 21:57:16 +0530110 *
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530111 * @param nameSpace name space of YANG module
janani b3e357f62016-05-19 17:39:50 +0530112 * @param conflictResolver object of YANG to java naming conflict util
Vinod Kumar S08710982016-03-03 19:55:30 +0530113 * @return java package name as per java rules
Bharat saraswal97459962016-02-20 21:57:16 +0530114 */
janani b3e357f62016-05-19 17:39:50 +0530115 private static String getPkgFromNameSpace(String nameSpace, YangToJavaNamingConflictUtil conflictResolver) {
Vinod Kumar S9f26ae52016-03-23 15:30:27 +0530116
Bharat saraswal8beac342016-08-04 02:00:03 +0530117 ArrayList<String> pkgArr = new ArrayList<>();
Bharat saraswal84366c52016-03-23 19:40:35 +0530118 nameSpace = nameSpace.replace(QUOTES, EMPTY_STRING);
janani b1c6acc42016-04-15 16:18:30 +0530119 String properNameSpace = nameSpace.replaceAll(REGEX_WITH_ALL_SPECIAL_CHAR, COLAN);
Bharat saraswal84366c52016-03-23 19:40:35 +0530120 String[] nameSpaceArr = properNameSpace.split(COLAN);
Bharat saraswal97459962016-02-20 21:57:16 +0530121
Bharat saraswal8beac342016-08-04 02:00:03 +0530122 Collections.addAll(pkgArr, nameSpaceArr);
janani b3e357f62016-05-19 17:39:50 +0530123 return getPkgFrmArr(pkgArr, conflictResolver);
Bharat saraswal97459962016-02-20 21:57:16 +0530124 }
125
126 /**
127 * Returns revision string array.
128 *
129 * @param date YANG module revision
130 * @return revision string
131 */
Vidyashree Rama13b4c552016-06-20 15:12:43 +0530132 private static String getYangRevisionStr(Date date) {
133 SimpleDateFormat sdf = new SimpleDateFormat(DATE_FORMAT);
134 String dateInString = sdf.format(date);
135 String[] revisionArr = dateInString.split(HYPHEN);
Bharat saraswal97459962016-02-20 21:57:16 +0530136
Bharat saraswald532a4c2016-03-25 18:19:46 +0530137 String rev = REVISION_PREFIX;
Bharat saraswal022dae92016-03-04 20:08:09 +0530138 rev = rev + revisionArr[INDEX_ZERO];
b.jananie6d43af2016-03-04 12:29:05 +0530139
Vidyashree Rama13b4c552016-06-20 15:12:43 +0530140 for (int i = INDEX_ONE; i < revisionArr.length; i++) {
141 Integer val = Integer.parseInt(revisionArr[i]);
142 if (val < VALUE_CHECK) {
143 rev = rev + ZERO;
Bharat saraswal97459962016-02-20 21:57:16 +0530144 }
Vidyashree Rama13b4c552016-06-20 15:12:43 +0530145 rev = rev + val;
Bharat saraswal97459962016-02-20 21:57:16 +0530146 }
Vidyashree Rama13b4c552016-06-20 15:12:43 +0530147 return rev;
Bharat saraswal97459962016-02-20 21:57:16 +0530148 }
149
150 /**
151 * Returns the package string.
152 *
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530153 * @param pkgArr package array
janani b3e357f62016-05-19 17:39:50 +0530154 * @param conflictResolver object of YANG to java naming conflict util
Bharat saraswal97459962016-02-20 21:57:16 +0530155 * @return package string
156 */
janani b3e357f62016-05-19 17:39:50 +0530157 private static String getPkgFrmArr(ArrayList<String> pkgArr, YangToJavaNamingConflictUtil conflictResolver) {
Bharat saraswal97459962016-02-20 21:57:16 +0530158
Bharat saraswal84366c52016-03-23 19:40:35 +0530159 String pkg = EMPTY_STRING;
Bharat saraswal97459962016-02-20 21:57:16 +0530160 int size = pkgArr.size();
161 int i = 0;
162 for (String member : pkgArr) {
janani b3e357f62016-05-19 17:39:50 +0530163 boolean presenceOfKeyword = JAVA_KEY_WORDS.contains(member.toLowerCase());
Bharat saraswal84366c52016-03-23 19:40:35 +0530164 if (presenceOfKeyword || member.matches(REGEX_FOR_FIRST_DIGIT)) {
Bharat saraswal8beac342016-08-04 02:00:03 +0530165 String prefix = getPrefixForIdentifier(conflictResolver);
janani b3e357f62016-05-19 17:39:50 +0530166 member = prefix + member;
b.jananie6d43af2016-03-04 12:29:05 +0530167 }
Bharat saraswal97459962016-02-20 21:57:16 +0530168 pkg = pkg + member;
169 if (i != size - 1) {
Bharat saraswal84366c52016-03-23 19:40:35 +0530170 pkg = pkg + PERIOD;
Bharat saraswal97459962016-02-20 21:57:16 +0530171 }
172 i++;
173 }
174 return pkg;
175 }
176
177 /**
Bharat saraswal68fa0d12016-04-19 01:00:16 +0530178 * Returns enum's java name.
179 *
180 * @param name enum's name
181 * @return enum's java name
182 */
183 public static String getEnumJavaAttribute(String name) {
184
janani b3e357f62016-05-19 17:39:50 +0530185 name = name.replaceAll(REGEX_WITH_ALL_SPECIAL_CHAR, COLAN);
186 String[] strArray = name.split(COLAN);
Bharat saraswal68fa0d12016-04-19 01:00:16 +0530187 String output = EMPTY_STRING;
janani b3e357f62016-05-19 17:39:50 +0530188 if (strArray[0].isEmpty()) {
Bharat saraswal8beac342016-08-04 02:00:03 +0530189 List<String> stringArrangement = new ArrayList<>();
190 stringArrangement.addAll(Arrays.asList(strArray).subList(1, strArray.length));
janani b3e357f62016-05-19 17:39:50 +0530191 strArray = stringArrangement.toArray(new String[stringArrangement.size()]);
192 }
Bharat saraswal68fa0d12016-04-19 01:00:16 +0530193 for (int i = 0; i < strArray.length; i++) {
janani b3e357f62016-05-19 17:39:50 +0530194 if (i > 0 && i < strArray.length) {
Bharat saraswal68fa0d12016-04-19 01:00:16 +0530195 output = output + UNDER_SCORE;
196 }
janani b3e357f62016-05-19 17:39:50 +0530197 output = output + strArray[i];
Bharat saraswal68fa0d12016-04-19 01:00:16 +0530198 }
199 return output;
200 }
201
202 /**
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530203 * Creates a package structure with package info java file if not present.
Vinod Kumar S9f26ae52016-03-23 15:30:27 +0530204 *
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530205 * @param yangNode YANG node for which code is being generated
206 * @throws IOException any IO exception
Vinod Kumar S9f26ae52016-03-23 15:30:27 +0530207 */
Bharat saraswal1edde622016-09-06 10:18:04 +0530208 public static void createPackage(YangNode yangNode)
209 throws IOException {
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530210 if (!(yangNode instanceof JavaFileInfoContainer)) {
Bharat saraswale3175d32016-08-31 17:50:11 +0530211 throw new TranslatorException("current node must have java file info " +
Bharat saraswal1edde622016-09-06 10:18:04 +0530212 yangNode.getName() + " in " +
213 yangNode.getLineNumber() + " at " +
214 yangNode.getCharPosition()
215 + " in " + yangNode.getFileName());
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530216 }
217 String pkgInfo;
Bharat saraswale50edca2016-08-05 01:58:25 +0530218 JavaFileInfoTranslator javaFileInfo = ((JavaFileInfoContainer) yangNode).getJavaFileInfo();
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530219 String pkg = getAbsolutePackagePath(javaFileInfo.getBaseCodeGenPath(), javaFileInfo.getPackageFilePath());
220 if (!doesPackageExist(pkg)) {
221 try {
222 File pack = createDirectories(pkg);
223 YangNode parent = getParentNodeInGenCode(yangNode);
224 if (parent != null) {
225 pkgInfo = ((JavaFileInfoContainer) parent).getJavaFileInfo().getJavaName();
226 addPackageInfo(pack, pkgInfo, getJavaPackageFromPackagePath(pkg), true,
Bharat saraswal1edde622016-09-06 10:18:04 +0530227 ((JavaFileInfoContainer) parent).getJavaFileInfo().getPluginConfig());
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530228 } else {
229 pkgInfo = ((JavaFileInfoContainer) yangNode).getJavaFileInfo().getJavaName();
230 addPackageInfo(pack, pkgInfo, getJavaPackageFromPackagePath(pkg), false,
Bharat saraswal1edde622016-09-06 10:18:04 +0530231 ((JavaFileInfoContainer) yangNode).getJavaFileInfo().getPluginConfig());
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530232 }
233 } catch (IOException e) {
234 throw new IOException("failed to create package-info file");
235 }
236 }
237 }
238
239 /**
240 * Checks if the package directory structure created.
241 *
242 * @param pkg Package to check if it is created
243 * @return existence status of package
244 */
Bharat saraswal8beac342016-08-04 02:00:03 +0530245 static boolean doesPackageExist(String pkg) {
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530246 File pkgDir = new File(getPackageDirPathFromJavaJPackage(pkg));
247 File pkgWithFile = new File(pkgDir + SLASH + "package-info.java");
248 return pkgDir.exists() && pkgWithFile.isFile();
Vinod Kumar S9f26ae52016-03-23 15:30:27 +0530249 }
Bharat saraswal97459962016-02-20 21:57:16 +0530250}