blob: 8c938ed9b4a2e8c97b1984f39d9655dcdfac801f [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
Gaurav Agrawal8a5af142016-06-15 13:58:01 +053019import java.io.File;
20import java.io.IOException;
Vidyashree Ramadeac28b2016-06-20 15:12:43 +053021import java.text.SimpleDateFormat;
Bharat saraswal870c56f2016-02-20 21:57:16 +053022import java.util.ArrayList;
Vidyashree Ramadeac28b2016-06-20 15:12:43 +053023import java.util.Date;
janani bde4ffab2016-04-15 16:18:30 +053024import java.util.List;
Vinod Kumar S38046502016-03-23 15:30:27 +053025import org.onosproject.yangutils.datamodel.YangNode;
b.janani1fef2732016-03-04 12:29:05 +053026import org.onosproject.yangutils.translator.exception.TranslatorException;
Vinod Kumar S38046502016-03-23 15:30:27 +053027import org.onosproject.yangutils.translator.tojava.JavaFileInfo;
Gaurav Agrawal8a5af142016-06-15 13:58:01 +053028import org.onosproject.yangutils.translator.tojava.JavaFileInfoContainer;
29import org.onosproject.yangutils.utils.io.impl.YangIoUtils;
30import org.onosproject.yangutils.utils.io.impl.YangToJavaNamingConflictUtil;
Bharat saraswale2d51d62016-03-23 19:40:35 +053031
Gaurav Agrawal8a5af142016-06-15 13:58:01 +053032import static org.onosproject.yangutils.datamodel.utils.DataModelUtils.getParentNodeInGenCode;
Bharat saraswale2d51d62016-03-23 19:40:35 +053033import static org.onosproject.yangutils.utils.UtilConstants.COLAN;
34import static org.onosproject.yangutils.utils.UtilConstants.DEFAULT_BASE_PKG;
35import static org.onosproject.yangutils.utils.UtilConstants.EMPTY_STRING;
36import static org.onosproject.yangutils.utils.UtilConstants.HYPHEN;
37import static org.onosproject.yangutils.utils.UtilConstants.JAVA_KEY_WORDS;
38import static org.onosproject.yangutils.utils.UtilConstants.PERIOD;
39import static org.onosproject.yangutils.utils.UtilConstants.QUOTES;
40import static org.onosproject.yangutils.utils.UtilConstants.REGEX_FOR_FIRST_DIGIT;
janani bde4ffab2016-04-15 16:18:30 +053041import static org.onosproject.yangutils.utils.UtilConstants.REGEX_WITH_ALL_SPECIAL_CHAR;
Bharat saraswal2f11f652016-03-25 18:19:46 +053042import static org.onosproject.yangutils.utils.UtilConstants.REVISION_PREFIX;
Bharat saraswale2d51d62016-03-23 19:40:35 +053043import static org.onosproject.yangutils.utils.UtilConstants.SLASH;
44import static org.onosproject.yangutils.utils.UtilConstants.UNDER_SCORE;
Bharat saraswal2f11f652016-03-25 18:19:46 +053045import static org.onosproject.yangutils.utils.UtilConstants.VERSION_PREFIX;
Gaurav Agrawal8a5af142016-06-15 13:58:01 +053046import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.addPackageInfo;
47import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.createDirectories;
48import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.getAbsolutePackagePath;
49import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.getJavaPackageFromPackagePath;
50import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.getPackageDirPathFromJavaJPackage;
Bharat saraswal870c56f2016-02-20 21:57:16 +053051
52/**
Bharat saraswald9822e92016-04-05 15:13:44 +053053 * Represents an utility Class for translating the name from YANG to java convention.
Bharat saraswal870c56f2016-02-20 21:57:16 +053054 */
55public final class JavaIdentifierSyntax {
56
b.janani1fef2732016-03-04 12:29:05 +053057 private static final int MAX_MONTHS = 12;
58 private static final int MAX_DAYS = 31;
59 private static final int INDEX_ZERO = 0;
60 private static final int INDEX_ONE = 1;
61 private static final int INDEX_TWO = 2;
Bharat saraswal6ef0b762016-04-05 12:45:45 +053062 private static final int VALUE_CHECK = 10;
63 private static final String ZERO = "0";
Vidyashree Ramadeac28b2016-06-20 15:12:43 +053064 private static final String DATE_FORMAT = "yyyy-MM-dd";
b.janani1fef2732016-03-04 12:29:05 +053065
Bharat saraswal870c56f2016-02-20 21:57:16 +053066 /**
Bharat saraswald9822e92016-04-05 15:13:44 +053067 * Create instance of java identifier syntax.
Bharat saraswal870c56f2016-02-20 21:57:16 +053068 */
69 private JavaIdentifierSyntax() {
70 }
71
72 /**
Bharat saraswald9822e92016-04-05 15:13:44 +053073 * Returns the root package string.
Bharat saraswal870c56f2016-02-20 21:57:16 +053074 *
Gaurav Agrawal8a5af142016-06-15 13:58:01 +053075 * @param version YANG version
76 * @param nameSpace name space of the module
77 * @param revision revision of the module defined
janani bdd1314f2016-05-19 17:39:50 +053078 * @param conflictResolver object of YANG to java naming conflict util
79 * @return the root package string
Bharat saraswal870c56f2016-02-20 21:57:16 +053080 */
Vidyashree Ramadeac28b2016-06-20 15:12:43 +053081 public static String getRootPackage(byte version, String nameSpace, Date revision,
Gaurav Agrawal8a5af142016-06-15 13:58:01 +053082 YangToJavaNamingConflictUtil conflictResolver) {
Bharat saraswal870c56f2016-02-20 21:57:16 +053083
84 String pkg;
Bharat saraswale2d51d62016-03-23 19:40:35 +053085 pkg = DEFAULT_BASE_PKG;
86 pkg = pkg + PERIOD;
Bharat saraswal870c56f2016-02-20 21:57:16 +053087 pkg = pkg + getYangVersion(version);
Bharat saraswale2d51d62016-03-23 19:40:35 +053088 pkg = pkg + PERIOD;
janani bdd1314f2016-05-19 17:39:50 +053089 pkg = pkg + getPkgFromNameSpace(nameSpace, conflictResolver);
Bharat saraswale2d51d62016-03-23 19:40:35 +053090 pkg = pkg + PERIOD;
Bharat saraswal870c56f2016-02-20 21:57:16 +053091 pkg = pkg + getYangRevisionStr(revision);
92
Bharat saraswal4bf8b152016-02-25 02:26:43 +053093 return pkg.toLowerCase();
Bharat saraswal870c56f2016-02-20 21:57:16 +053094 }
95
96 /**
97 * Returns version.
98 *
Vinod Kumar Sc4216002016-03-03 19:55:30 +053099 * @param ver YANG version
Bharat saraswal870c56f2016-02-20 21:57:16 +0530100 * @return version
101 */
102 private static String getYangVersion(byte ver) {
Bharat saraswal2f11f652016-03-25 18:19:46 +0530103 return VERSION_PREFIX + ver;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530104 }
105
106 /**
Bharat saraswald9822e92016-04-05 15:13:44 +0530107 * Returns package name from name space.
Bharat saraswal870c56f2016-02-20 21:57:16 +0530108 *
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530109 * @param nameSpace name space of YANG module
janani bdd1314f2016-05-19 17:39:50 +0530110 * @param conflictResolver object of YANG to java naming conflict util
Vinod Kumar Sc4216002016-03-03 19:55:30 +0530111 * @return java package name as per java rules
Bharat saraswal870c56f2016-02-20 21:57:16 +0530112 */
janani bdd1314f2016-05-19 17:39:50 +0530113 private static String getPkgFromNameSpace(String nameSpace, YangToJavaNamingConflictUtil conflictResolver) {
Vinod Kumar S38046502016-03-23 15:30:27 +0530114
Bharat saraswal870c56f2016-02-20 21:57:16 +0530115 ArrayList<String> pkgArr = new ArrayList<String>();
Bharat saraswale2d51d62016-03-23 19:40:35 +0530116 nameSpace = nameSpace.replace(QUOTES, EMPTY_STRING);
janani bde4ffab2016-04-15 16:18:30 +0530117 String properNameSpace = nameSpace.replaceAll(REGEX_WITH_ALL_SPECIAL_CHAR, COLAN);
Bharat saraswale2d51d62016-03-23 19:40:35 +0530118 String[] nameSpaceArr = properNameSpace.split(COLAN);
Bharat saraswal870c56f2016-02-20 21:57:16 +0530119
120 for (String nameSpaceString : nameSpaceArr) {
121 pkgArr.add(nameSpaceString);
122 }
janani bdd1314f2016-05-19 17:39:50 +0530123 return getPkgFrmArr(pkgArr, conflictResolver);
Bharat saraswal870c56f2016-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 Ramadeac28b2016-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 saraswal870c56f2016-02-20 21:57:16 +0530136
Bharat saraswal2f11f652016-03-25 18:19:46 +0530137 String rev = REVISION_PREFIX;
Bharat saraswal2f00b4b2016-03-04 20:08:09 +0530138 rev = rev + revisionArr[INDEX_ZERO];
b.janani1fef2732016-03-04 12:29:05 +0530139
Vidyashree Ramadeac28b2016-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 saraswal870c56f2016-02-20 21:57:16 +0530144 }
Vidyashree Ramadeac28b2016-06-20 15:12:43 +0530145 rev = rev + val;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530146 }
Vidyashree Ramadeac28b2016-06-20 15:12:43 +0530147 return rev;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530148 }
149
150 /**
151 * Returns the package string.
152 *
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530153 * @param pkgArr package array
janani bdd1314f2016-05-19 17:39:50 +0530154 * @param conflictResolver object of YANG to java naming conflict util
Bharat saraswal870c56f2016-02-20 21:57:16 +0530155 * @return package string
156 */
janani bdd1314f2016-05-19 17:39:50 +0530157 private static String getPkgFrmArr(ArrayList<String> pkgArr, YangToJavaNamingConflictUtil conflictResolver) {
Bharat saraswal870c56f2016-02-20 21:57:16 +0530158
Bharat saraswale2d51d62016-03-23 19:40:35 +0530159 String pkg = EMPTY_STRING;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530160 int size = pkgArr.size();
161 int i = 0;
162 for (String member : pkgArr) {
janani bdd1314f2016-05-19 17:39:50 +0530163 boolean presenceOfKeyword = JAVA_KEY_WORDS.contains(member.toLowerCase());
Bharat saraswale2d51d62016-03-23 19:40:35 +0530164 if (presenceOfKeyword || member.matches(REGEX_FOR_FIRST_DIGIT)) {
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530165 String prefix = YangIoUtils.getPrefixForIdentifier(conflictResolver);
janani bdd1314f2016-05-19 17:39:50 +0530166 member = prefix + member;
b.janani1fef2732016-03-04 12:29:05 +0530167 }
Bharat saraswal870c56f2016-02-20 21:57:16 +0530168 pkg = pkg + member;
169 if (i != size - 1) {
Bharat saraswale2d51d62016-03-23 19:40:35 +0530170 pkg = pkg + PERIOD;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530171 }
172 i++;
173 }
174 return pkg;
175 }
176
177 /**
Bharat saraswald72411a2016-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 bdd1314f2016-05-19 17:39:50 +0530185 name = name.replaceAll(REGEX_WITH_ALL_SPECIAL_CHAR, COLAN);
186 String[] strArray = name.split(COLAN);
Bharat saraswald72411a2016-04-19 01:00:16 +0530187 String output = EMPTY_STRING;
janani bdd1314f2016-05-19 17:39:50 +0530188 if (strArray[0].isEmpty()) {
189 List<String> stringArrangement = new ArrayList<String>();
190 for (int i = 1; i < strArray.length; i++) {
191 stringArrangement.add(strArray[i]);
192 }
193 strArray = stringArrangement.toArray(new String[stringArrangement.size()]);
194 }
Bharat saraswald72411a2016-04-19 01:00:16 +0530195 for (int i = 0; i < strArray.length; i++) {
janani bdd1314f2016-05-19 17:39:50 +0530196 if (i > 0 && i < strArray.length) {
Bharat saraswald72411a2016-04-19 01:00:16 +0530197 output = output + UNDER_SCORE;
198 }
janani bdd1314f2016-05-19 17:39:50 +0530199 output = output + strArray[i];
Bharat saraswald72411a2016-04-19 01:00:16 +0530200 }
201 return output;
202 }
203
204 /**
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530205 * Creates a package structure with package info java file if not present.
Vinod Kumar S38046502016-03-23 15:30:27 +0530206 *
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530207 * @param yangNode YANG node for which code is being generated
208 * @throws IOException any IO exception
Vinod Kumar S38046502016-03-23 15:30:27 +0530209 */
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530210 public static void createPackage(YangNode yangNode) throws IOException {
211 if (!(yangNode instanceof JavaFileInfoContainer)) {
212 throw new TranslatorException("current node must have java file info");
213 }
214 String pkgInfo;
215 JavaFileInfo javaFileInfo = ((JavaFileInfoContainer) yangNode).getJavaFileInfo();
216 String pkg = getAbsolutePackagePath(javaFileInfo.getBaseCodeGenPath(), javaFileInfo.getPackageFilePath());
217 if (!doesPackageExist(pkg)) {
218 try {
219 File pack = createDirectories(pkg);
220 YangNode parent = getParentNodeInGenCode(yangNode);
221 if (parent != null) {
222 pkgInfo = ((JavaFileInfoContainer) parent).getJavaFileInfo().getJavaName();
223 addPackageInfo(pack, pkgInfo, getJavaPackageFromPackagePath(pkg), true,
224 ((JavaFileInfoContainer) parent).getJavaFileInfo().getPluginConfig());
225 } else {
226 pkgInfo = ((JavaFileInfoContainer) yangNode).getJavaFileInfo().getJavaName();
227 addPackageInfo(pack, pkgInfo, getJavaPackageFromPackagePath(pkg), false,
228 ((JavaFileInfoContainer) yangNode).getJavaFileInfo().getPluginConfig());
229 }
230 } catch (IOException e) {
231 throw new IOException("failed to create package-info file");
232 }
233 }
234 }
235
236 /**
237 * Checks if the package directory structure created.
238 *
239 * @param pkg Package to check if it is created
240 * @return existence status of package
241 */
242 public static boolean doesPackageExist(String pkg) {
243 File pkgDir = new File(getPackageDirPathFromJavaJPackage(pkg));
244 File pkgWithFile = new File(pkgDir + SLASH + "package-info.java");
245 return pkgDir.exists() && pkgWithFile.isFile();
Vinod Kumar S38046502016-03-23 15:30:27 +0530246 }
Bharat saraswal870c56f2016-02-20 21:57:16 +0530247}