blob: b77a158a829220fdd0ac60ed8c22825f8c6a9cb5 [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
Bharat saraswal748fc3c2016-09-06 16:38:20 +053098
Bharat saraswal97459962016-02-20 21:57:16 +053099 /**
100 * Returns version.
101 *
Vinod Kumar S08710982016-03-03 19:55:30 +0530102 * @param ver YANG version
Bharat saraswal97459962016-02-20 21:57:16 +0530103 * @return version
104 */
105 private static String getYangVersion(byte ver) {
Bharat saraswald532a4c2016-03-25 18:19:46 +0530106 return VERSION_PREFIX + ver;
Bharat saraswal97459962016-02-20 21:57:16 +0530107 }
108
109 /**
Bharat saraswal63f26fb2016-04-05 15:13:44 +0530110 * Returns package name from name space.
Bharat saraswal97459962016-02-20 21:57:16 +0530111 *
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530112 * @param nameSpace name space of YANG module
janani b3e357f62016-05-19 17:39:50 +0530113 * @param conflictResolver object of YANG to java naming conflict util
Vinod Kumar S08710982016-03-03 19:55:30 +0530114 * @return java package name as per java rules
Bharat saraswal97459962016-02-20 21:57:16 +0530115 */
janani b3e357f62016-05-19 17:39:50 +0530116 private static String getPkgFromNameSpace(String nameSpace, YangToJavaNamingConflictUtil conflictResolver) {
Vinod Kumar S9f26ae52016-03-23 15:30:27 +0530117
Bharat saraswal8beac342016-08-04 02:00:03 +0530118 ArrayList<String> pkgArr = new ArrayList<>();
Bharat saraswal84366c52016-03-23 19:40:35 +0530119 nameSpace = nameSpace.replace(QUOTES, EMPTY_STRING);
janani b1c6acc42016-04-15 16:18:30 +0530120 String properNameSpace = nameSpace.replaceAll(REGEX_WITH_ALL_SPECIAL_CHAR, COLAN);
Bharat saraswal84366c52016-03-23 19:40:35 +0530121 String[] nameSpaceArr = properNameSpace.split(COLAN);
Bharat saraswal97459962016-02-20 21:57:16 +0530122
Bharat saraswal8beac342016-08-04 02:00:03 +0530123 Collections.addAll(pkgArr, nameSpaceArr);
janani b3e357f62016-05-19 17:39:50 +0530124 return getPkgFrmArr(pkgArr, conflictResolver);
Bharat saraswal97459962016-02-20 21:57:16 +0530125 }
126
127 /**
128 * Returns revision string array.
129 *
130 * @param date YANG module revision
131 * @return revision string
132 */
Vidyashree Rama13b4c552016-06-20 15:12:43 +0530133 private static String getYangRevisionStr(Date date) {
134 SimpleDateFormat sdf = new SimpleDateFormat(DATE_FORMAT);
135 String dateInString = sdf.format(date);
136 String[] revisionArr = dateInString.split(HYPHEN);
Bharat saraswal97459962016-02-20 21:57:16 +0530137
Bharat saraswald532a4c2016-03-25 18:19:46 +0530138 String rev = REVISION_PREFIX;
Bharat saraswal022dae92016-03-04 20:08:09 +0530139 rev = rev + revisionArr[INDEX_ZERO];
b.jananie6d43af2016-03-04 12:29:05 +0530140
Vidyashree Rama13b4c552016-06-20 15:12:43 +0530141 for (int i = INDEX_ONE; i < revisionArr.length; i++) {
142 Integer val = Integer.parseInt(revisionArr[i]);
143 if (val < VALUE_CHECK) {
144 rev = rev + ZERO;
Bharat saraswal97459962016-02-20 21:57:16 +0530145 }
Vidyashree Rama13b4c552016-06-20 15:12:43 +0530146 rev = rev + val;
Bharat saraswal97459962016-02-20 21:57:16 +0530147 }
Vidyashree Rama13b4c552016-06-20 15:12:43 +0530148 return rev;
Bharat saraswal97459962016-02-20 21:57:16 +0530149 }
150
151 /**
152 * Returns the package string.
153 *
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530154 * @param pkgArr package array
janani b3e357f62016-05-19 17:39:50 +0530155 * @param conflictResolver object of YANG to java naming conflict util
Bharat saraswal97459962016-02-20 21:57:16 +0530156 * @return package string
157 */
janani b3e357f62016-05-19 17:39:50 +0530158 private static String getPkgFrmArr(ArrayList<String> pkgArr, YangToJavaNamingConflictUtil conflictResolver) {
Bharat saraswal97459962016-02-20 21:57:16 +0530159
Bharat saraswal84366c52016-03-23 19:40:35 +0530160 String pkg = EMPTY_STRING;
Bharat saraswal97459962016-02-20 21:57:16 +0530161 int size = pkgArr.size();
162 int i = 0;
163 for (String member : pkgArr) {
janani b3e357f62016-05-19 17:39:50 +0530164 boolean presenceOfKeyword = JAVA_KEY_WORDS.contains(member.toLowerCase());
Bharat saraswal84366c52016-03-23 19:40:35 +0530165 if (presenceOfKeyword || member.matches(REGEX_FOR_FIRST_DIGIT)) {
Bharat saraswal8beac342016-08-04 02:00:03 +0530166 String prefix = getPrefixForIdentifier(conflictResolver);
janani b3e357f62016-05-19 17:39:50 +0530167 member = prefix + member;
b.jananie6d43af2016-03-04 12:29:05 +0530168 }
Bharat saraswal97459962016-02-20 21:57:16 +0530169 pkg = pkg + member;
170 if (i != size - 1) {
Bharat saraswal84366c52016-03-23 19:40:35 +0530171 pkg = pkg + PERIOD;
Bharat saraswal97459962016-02-20 21:57:16 +0530172 }
173 i++;
174 }
175 return pkg;
176 }
177
178 /**
Bharat saraswal68fa0d12016-04-19 01:00:16 +0530179 * Returns enum's java name.
180 *
181 * @param name enum's name
182 * @return enum's java name
183 */
184 public static String getEnumJavaAttribute(String name) {
185
janani b3e357f62016-05-19 17:39:50 +0530186 name = name.replaceAll(REGEX_WITH_ALL_SPECIAL_CHAR, COLAN);
187 String[] strArray = name.split(COLAN);
Bharat saraswal68fa0d12016-04-19 01:00:16 +0530188 String output = EMPTY_STRING;
janani b3e357f62016-05-19 17:39:50 +0530189 if (strArray[0].isEmpty()) {
Bharat saraswal8beac342016-08-04 02:00:03 +0530190 List<String> stringArrangement = new ArrayList<>();
191 stringArrangement.addAll(Arrays.asList(strArray).subList(1, strArray.length));
janani b3e357f62016-05-19 17:39:50 +0530192 strArray = stringArrangement.toArray(new String[stringArrangement.size()]);
193 }
Bharat saraswal68fa0d12016-04-19 01:00:16 +0530194 for (int i = 0; i < strArray.length; i++) {
janani b3e357f62016-05-19 17:39:50 +0530195 if (i > 0 && i < strArray.length) {
Bharat saraswal68fa0d12016-04-19 01:00:16 +0530196 output = output + UNDER_SCORE;
197 }
janani b3e357f62016-05-19 17:39:50 +0530198 output = output + strArray[i];
Bharat saraswal68fa0d12016-04-19 01:00:16 +0530199 }
200 return output;
201 }
202
203 /**
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530204 * Creates a package structure with package info java file if not present.
Vinod Kumar S9f26ae52016-03-23 15:30:27 +0530205 *
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530206 * @param yangNode YANG node for which code is being generated
207 * @throws IOException any IO exception
Vinod Kumar S9f26ae52016-03-23 15:30:27 +0530208 */
Bharat saraswal1edde622016-09-06 10:18:04 +0530209 public static void createPackage(YangNode yangNode)
210 throws IOException {
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530211 if (!(yangNode instanceof JavaFileInfoContainer)) {
Bharat saraswale3175d32016-08-31 17:50:11 +0530212 throw new TranslatorException("current node must have java file info " +
Bharat saraswal1edde622016-09-06 10:18:04 +0530213 yangNode.getName() + " in " +
214 yangNode.getLineNumber() + " at " +
215 yangNode.getCharPosition()
216 + " in " + yangNode.getFileName());
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530217 }
218 String pkgInfo;
Bharat saraswale50edca2016-08-05 01:58:25 +0530219 JavaFileInfoTranslator javaFileInfo = ((JavaFileInfoContainer) yangNode).getJavaFileInfo();
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530220 String pkg = getAbsolutePackagePath(javaFileInfo.getBaseCodeGenPath(), javaFileInfo.getPackageFilePath());
221 if (!doesPackageExist(pkg)) {
222 try {
223 File pack = createDirectories(pkg);
224 YangNode parent = getParentNodeInGenCode(yangNode);
225 if (parent != null) {
226 pkgInfo = ((JavaFileInfoContainer) parent).getJavaFileInfo().getJavaName();
227 addPackageInfo(pack, pkgInfo, getJavaPackageFromPackagePath(pkg), true,
Bharat saraswal1edde622016-09-06 10:18:04 +0530228 ((JavaFileInfoContainer) parent).getJavaFileInfo().getPluginConfig());
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530229 } else {
230 pkgInfo = ((JavaFileInfoContainer) yangNode).getJavaFileInfo().getJavaName();
231 addPackageInfo(pack, pkgInfo, getJavaPackageFromPackagePath(pkg), false,
Bharat saraswal1edde622016-09-06 10:18:04 +0530232 ((JavaFileInfoContainer) yangNode).getJavaFileInfo().getPluginConfig());
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530233 }
234 } catch (IOException e) {
235 throw new IOException("failed to create package-info file");
236 }
237 }
238 }
239
240 /**
241 * Checks if the package directory structure created.
242 *
243 * @param pkg Package to check if it is created
244 * @return existence status of package
245 */
Bharat saraswal8beac342016-08-04 02:00:03 +0530246 static boolean doesPackageExist(String pkg) {
Gaurav Agrawalbfce9342016-06-15 13:58:01 +0530247 File pkgDir = new File(getPackageDirPathFromJavaJPackage(pkg));
248 File pkgWithFile = new File(pkgDir + SLASH + "package-info.java");
249 return pkgDir.exists() && pkgWithFile.isFile();
Vinod Kumar S9f26ae52016-03-23 15:30:27 +0530250 }
Bharat saraswal97459962016-02-20 21:57:16 +0530251}