blob: d394568a07d59fffcbc0069ba72bf5b54a200393 [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;
Shankara-Huaweibdf24bb2016-08-02 18:13:13 +053027import org.onosproject.yangutils.datamodel.javadatamodel.JavaFileInfo;
Gaurav Agrawal8a5af142016-06-15 13:58:01 +053028import org.onosproject.yangutils.translator.tojava.JavaFileInfoContainer;
29import org.onosproject.yangutils.utils.io.impl.YangIoUtils;
Shankara-Huaweibdf24bb2016-08-02 18:13:13 +053030import org.onosproject.yangutils.datamodel.javadatamodel.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 INDEX_ZERO = 0;
58 private static final int INDEX_ONE = 1;
Bharat saraswal6ef0b762016-04-05 12:45:45 +053059 private static final int VALUE_CHECK = 10;
60 private static final String ZERO = "0";
Vidyashree Ramadeac28b2016-06-20 15:12:43 +053061 private static final String DATE_FORMAT = "yyyy-MM-dd";
b.janani1fef2732016-03-04 12:29:05 +053062
Bharat saraswal870c56f2016-02-20 21:57:16 +053063 /**
Bharat saraswald9822e92016-04-05 15:13:44 +053064 * Create instance of java identifier syntax.
Bharat saraswal870c56f2016-02-20 21:57:16 +053065 */
66 private JavaIdentifierSyntax() {
67 }
68
69 /**
Bharat saraswald9822e92016-04-05 15:13:44 +053070 * Returns the root package string.
Bharat saraswal870c56f2016-02-20 21:57:16 +053071 *
Gaurav Agrawal8a5af142016-06-15 13:58:01 +053072 * @param version YANG version
73 * @param nameSpace name space of the module
74 * @param revision revision of the module defined
janani bdd1314f2016-05-19 17:39:50 +053075 * @param conflictResolver object of YANG to java naming conflict util
76 * @return the root package string
Bharat saraswal870c56f2016-02-20 21:57:16 +053077 */
Vidyashree Ramadeac28b2016-06-20 15:12:43 +053078 public static String getRootPackage(byte version, String nameSpace, Date revision,
Gaurav Agrawal8a5af142016-06-15 13:58:01 +053079 YangToJavaNamingConflictUtil conflictResolver) {
Bharat saraswal870c56f2016-02-20 21:57:16 +053080
81 String pkg;
Bharat saraswale2d51d62016-03-23 19:40:35 +053082 pkg = DEFAULT_BASE_PKG;
83 pkg = pkg + PERIOD;
Bharat saraswal870c56f2016-02-20 21:57:16 +053084 pkg = pkg + getYangVersion(version);
Bharat saraswale2d51d62016-03-23 19:40:35 +053085 pkg = pkg + PERIOD;
janani bdd1314f2016-05-19 17:39:50 +053086 pkg = pkg + getPkgFromNameSpace(nameSpace, conflictResolver);
Bharat saraswale2d51d62016-03-23 19:40:35 +053087 pkg = pkg + PERIOD;
Bharat saraswal870c56f2016-02-20 21:57:16 +053088 pkg = pkg + getYangRevisionStr(revision);
89
Bharat saraswal4bf8b152016-02-25 02:26:43 +053090 return pkg.toLowerCase();
Bharat saraswal870c56f2016-02-20 21:57:16 +053091 }
92
93 /**
94 * Returns version.
95 *
Vinod Kumar Sc4216002016-03-03 19:55:30 +053096 * @param ver YANG version
Bharat saraswal870c56f2016-02-20 21:57:16 +053097 * @return version
98 */
99 private static String getYangVersion(byte ver) {
Bharat saraswal2f11f652016-03-25 18:19:46 +0530100 return VERSION_PREFIX + ver;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530101 }
102
103 /**
Bharat saraswald9822e92016-04-05 15:13:44 +0530104 * Returns package name from name space.
Bharat saraswal870c56f2016-02-20 21:57:16 +0530105 *
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530106 * @param nameSpace name space of YANG module
janani bdd1314f2016-05-19 17:39:50 +0530107 * @param conflictResolver object of YANG to java naming conflict util
Vinod Kumar Sc4216002016-03-03 19:55:30 +0530108 * @return java package name as per java rules
Bharat saraswal870c56f2016-02-20 21:57:16 +0530109 */
janani bdd1314f2016-05-19 17:39:50 +0530110 private static String getPkgFromNameSpace(String nameSpace, YangToJavaNamingConflictUtil conflictResolver) {
Vinod Kumar S38046502016-03-23 15:30:27 +0530111
Bharat saraswal870c56f2016-02-20 21:57:16 +0530112 ArrayList<String> pkgArr = new ArrayList<String>();
Bharat saraswale2d51d62016-03-23 19:40:35 +0530113 nameSpace = nameSpace.replace(QUOTES, EMPTY_STRING);
janani bde4ffab2016-04-15 16:18:30 +0530114 String properNameSpace = nameSpace.replaceAll(REGEX_WITH_ALL_SPECIAL_CHAR, COLAN);
Bharat saraswale2d51d62016-03-23 19:40:35 +0530115 String[] nameSpaceArr = properNameSpace.split(COLAN);
Bharat saraswal870c56f2016-02-20 21:57:16 +0530116
117 for (String nameSpaceString : nameSpaceArr) {
118 pkgArr.add(nameSpaceString);
119 }
janani bdd1314f2016-05-19 17:39:50 +0530120 return getPkgFrmArr(pkgArr, conflictResolver);
Bharat saraswal870c56f2016-02-20 21:57:16 +0530121 }
122
123 /**
124 * Returns revision string array.
125 *
126 * @param date YANG module revision
127 * @return revision string
128 */
Vidyashree Ramadeac28b2016-06-20 15:12:43 +0530129 private static String getYangRevisionStr(Date date) {
130 SimpleDateFormat sdf = new SimpleDateFormat(DATE_FORMAT);
131 String dateInString = sdf.format(date);
132 String[] revisionArr = dateInString.split(HYPHEN);
Bharat saraswal870c56f2016-02-20 21:57:16 +0530133
Bharat saraswal2f11f652016-03-25 18:19:46 +0530134 String rev = REVISION_PREFIX;
Bharat saraswal2f00b4b2016-03-04 20:08:09 +0530135 rev = rev + revisionArr[INDEX_ZERO];
b.janani1fef2732016-03-04 12:29:05 +0530136
Vidyashree Ramadeac28b2016-06-20 15:12:43 +0530137 for (int i = INDEX_ONE; i < revisionArr.length; i++) {
138 Integer val = Integer.parseInt(revisionArr[i]);
139 if (val < VALUE_CHECK) {
140 rev = rev + ZERO;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530141 }
Vidyashree Ramadeac28b2016-06-20 15:12:43 +0530142 rev = rev + val;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530143 }
Vidyashree Ramadeac28b2016-06-20 15:12:43 +0530144 return rev;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530145 }
146
147 /**
148 * Returns the package string.
149 *
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530150 * @param pkgArr package array
janani bdd1314f2016-05-19 17:39:50 +0530151 * @param conflictResolver object of YANG to java naming conflict util
Bharat saraswal870c56f2016-02-20 21:57:16 +0530152 * @return package string
153 */
janani bdd1314f2016-05-19 17:39:50 +0530154 private static String getPkgFrmArr(ArrayList<String> pkgArr, YangToJavaNamingConflictUtil conflictResolver) {
Bharat saraswal870c56f2016-02-20 21:57:16 +0530155
Bharat saraswale2d51d62016-03-23 19:40:35 +0530156 String pkg = EMPTY_STRING;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530157 int size = pkgArr.size();
158 int i = 0;
159 for (String member : pkgArr) {
janani bdd1314f2016-05-19 17:39:50 +0530160 boolean presenceOfKeyword = JAVA_KEY_WORDS.contains(member.toLowerCase());
Bharat saraswale2d51d62016-03-23 19:40:35 +0530161 if (presenceOfKeyword || member.matches(REGEX_FOR_FIRST_DIGIT)) {
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530162 String prefix = YangIoUtils.getPrefixForIdentifier(conflictResolver);
janani bdd1314f2016-05-19 17:39:50 +0530163 member = prefix + member;
b.janani1fef2732016-03-04 12:29:05 +0530164 }
Bharat saraswal870c56f2016-02-20 21:57:16 +0530165 pkg = pkg + member;
166 if (i != size - 1) {
Bharat saraswale2d51d62016-03-23 19:40:35 +0530167 pkg = pkg + PERIOD;
Bharat saraswal870c56f2016-02-20 21:57:16 +0530168 }
169 i++;
170 }
171 return pkg;
172 }
173
174 /**
Bharat saraswald72411a2016-04-19 01:00:16 +0530175 * Returns enum's java name.
176 *
177 * @param name enum's name
178 * @return enum's java name
179 */
180 public static String getEnumJavaAttribute(String name) {
181
janani bdd1314f2016-05-19 17:39:50 +0530182 name = name.replaceAll(REGEX_WITH_ALL_SPECIAL_CHAR, COLAN);
183 String[] strArray = name.split(COLAN);
Bharat saraswald72411a2016-04-19 01:00:16 +0530184 String output = EMPTY_STRING;
janani bdd1314f2016-05-19 17:39:50 +0530185 if (strArray[0].isEmpty()) {
186 List<String> stringArrangement = new ArrayList<String>();
187 for (int i = 1; i < strArray.length; i++) {
188 stringArrangement.add(strArray[i]);
189 }
190 strArray = stringArrangement.toArray(new String[stringArrangement.size()]);
191 }
Bharat saraswald72411a2016-04-19 01:00:16 +0530192 for (int i = 0; i < strArray.length; i++) {
janani bdd1314f2016-05-19 17:39:50 +0530193 if (i > 0 && i < strArray.length) {
Bharat saraswald72411a2016-04-19 01:00:16 +0530194 output = output + UNDER_SCORE;
195 }
janani bdd1314f2016-05-19 17:39:50 +0530196 output = output + strArray[i];
Bharat saraswald72411a2016-04-19 01:00:16 +0530197 }
198 return output;
199 }
200
201 /**
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530202 * Creates a package structure with package info java file if not present.
Vinod Kumar S38046502016-03-23 15:30:27 +0530203 *
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530204 * @param yangNode YANG node for which code is being generated
205 * @throws IOException any IO exception
Vinod Kumar S38046502016-03-23 15:30:27 +0530206 */
Gaurav Agrawal8a5af142016-06-15 13:58:01 +0530207 public static void createPackage(YangNode yangNode) throws IOException {
208 if (!(yangNode instanceof JavaFileInfoContainer)) {
209 throw new TranslatorException("current node must have java file info");
210 }
211 String pkgInfo;
212 JavaFileInfo javaFileInfo = ((JavaFileInfoContainer) yangNode).getJavaFileInfo();
213 String pkg = getAbsolutePackagePath(javaFileInfo.getBaseCodeGenPath(), javaFileInfo.getPackageFilePath());
214 if (!doesPackageExist(pkg)) {
215 try {
216 File pack = createDirectories(pkg);
217 YangNode parent = getParentNodeInGenCode(yangNode);
218 if (parent != null) {
219 pkgInfo = ((JavaFileInfoContainer) parent).getJavaFileInfo().getJavaName();
220 addPackageInfo(pack, pkgInfo, getJavaPackageFromPackagePath(pkg), true,
221 ((JavaFileInfoContainer) parent).getJavaFileInfo().getPluginConfig());
222 } else {
223 pkgInfo = ((JavaFileInfoContainer) yangNode).getJavaFileInfo().getJavaName();
224 addPackageInfo(pack, pkgInfo, getJavaPackageFromPackagePath(pkg), false,
225 ((JavaFileInfoContainer) yangNode).getJavaFileInfo().getPluginConfig());
226 }
227 } catch (IOException e) {
228 throw new IOException("failed to create package-info file");
229 }
230 }
231 }
232
233 /**
234 * Checks if the package directory structure created.
235 *
236 * @param pkg Package to check if it is created
237 * @return existence status of package
238 */
239 public static boolean doesPackageExist(String pkg) {
240 File pkgDir = new File(getPackageDirPathFromJavaJPackage(pkg));
241 File pkgWithFile = new File(pkgDir + SLASH + "package-info.java");
242 return pkgDir.exists() && pkgWithFile.isFile();
Vinod Kumar S38046502016-03-23 15:30:27 +0530243 }
Bharat saraswal870c56f2016-02-20 21:57:16 +0530244}