Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 1 | /* |
Brian O'Connor | 0f7908b | 2016-04-09 01:19:45 -0700 | [diff] [blame] | 2 | * Copyright 2016-present Open Networking Laboratory |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 3 | * |
| 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 | |
| 17 | package org.onosproject.yangutils.utils.io.impl; |
| 18 | |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 19 | import static org.onosproject.yangutils.utils.UtilConstants.ADD_STRING; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 20 | import static org.onosproject.yangutils.utils.UtilConstants.BUILDER; |
| 21 | import static org.onosproject.yangutils.utils.UtilConstants.BUILDER_CLASS_JAVA_DOC; |
| 22 | import static org.onosproject.yangutils.utils.UtilConstants.BUILDER_INTERFACE_JAVA_DOC; |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 23 | import static org.onosproject.yangutils.utils.UtilConstants.BUILDER_LOWER_CASE; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 24 | import static org.onosproject.yangutils.utils.UtilConstants.BUILDER_OBJECT; |
Bharat saraswal | af413b8 | 2016-07-14 15:18:20 +0530 | [diff] [blame] | 25 | import static org.onosproject.yangutils.utils.UtilConstants.CLASS; |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 26 | import static org.onosproject.yangutils.utils.UtilConstants.EIGHT_SPACE_INDENTATION; |
Bharat saraswal | 5cd9e9c | 2016-05-26 23:48:38 +0530 | [diff] [blame] | 27 | import static org.onosproject.yangutils.utils.UtilConstants.EMPTY_STRING; |
Bharat saraswal | 68fa0d1 | 2016-04-19 01:00:16 +0530 | [diff] [blame] | 28 | import static org.onosproject.yangutils.utils.UtilConstants.ENUM_ATTRIBUTE_JAVADOC; |
| 29 | import static org.onosproject.yangutils.utils.UtilConstants.ENUM_CLASS_JAVADOC; |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 30 | import static org.onosproject.yangutils.utils.UtilConstants.EVENT_JAVA_DOC; |
| 31 | import static org.onosproject.yangutils.utils.UtilConstants.EVENT_LISTENER_JAVA_DOC; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 32 | import static org.onosproject.yangutils.utils.UtilConstants.FOUR_SPACE_INDENTATION; |
Gaurav Agrawal | 97a5e1c | 2016-04-18 18:53:11 +0530 | [diff] [blame] | 33 | import static org.onosproject.yangutils.utils.UtilConstants.FROM_STRING_METHOD_NAME; |
| 34 | import static org.onosproject.yangutils.utils.UtilConstants.FROM_STRING_PARAM_NAME; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 35 | import static org.onosproject.yangutils.utils.UtilConstants.IMPL_CLASS_JAVA_DOC; |
Gaurav Agrawal | 97a5e1c | 2016-04-18 18:53:11 +0530 | [diff] [blame] | 36 | import static org.onosproject.yangutils.utils.UtilConstants.INPUT; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 37 | import static org.onosproject.yangutils.utils.UtilConstants.INTERFACE_JAVA_DOC; |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 38 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_ADD_TO_LIST; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 39 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_BUILD; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 40 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_CONSTRUCTOR; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 41 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_END_LINE; |
| 42 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_FIRST_LINE; |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 43 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_FOR_VALIDATOR; |
| 44 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_FOR_VALIDATOR_RETURN; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 45 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_GETTERS; |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 46 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_MANAGER_SETTERS; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 47 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_OF; |
| 48 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_PARAM; |
| 49 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_RETURN; |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 50 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_RPC; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 51 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_SETTERS; |
| 52 | import static org.onosproject.yangutils.utils.UtilConstants.JAVA_DOC_SETTERS_COMMON; |
| 53 | import static org.onosproject.yangutils.utils.UtilConstants.LIST; |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 54 | import static org.onosproject.yangutils.utils.UtilConstants.MIN_RANGE; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 55 | import static org.onosproject.yangutils.utils.UtilConstants.NEW_LINE; |
Bharat saraswal | d532a4c | 2016-03-25 18:19:46 +0530 | [diff] [blame] | 56 | import static org.onosproject.yangutils.utils.UtilConstants.NEW_LINE_ASTERISK; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 57 | import static org.onosproject.yangutils.utils.UtilConstants.OBJECT; |
Bharat saraswal | af413b8 | 2016-07-14 15:18:20 +0530 | [diff] [blame] | 58 | import static org.onosproject.yangutils.utils.UtilConstants.OBJECT_STRING; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 59 | import static org.onosproject.yangutils.utils.UtilConstants.OF; |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 60 | import static org.onosproject.yangutils.utils.UtilConstants.OP_PARAM_JAVA_DOC; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 61 | import static org.onosproject.yangutils.utils.UtilConstants.PACKAGE_INFO_JAVADOC; |
Bharat saraswal | 250a747 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 62 | import static org.onosproject.yangutils.utils.UtilConstants.PACKAGE_INFO_JAVADOC_OF_CHILD; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 63 | import static org.onosproject.yangutils.utils.UtilConstants.PERIOD; |
Vidyashree Rama | b367047 | 2016-08-06 15:49:56 +0530 | [diff] [blame] | 64 | import static org.onosproject.yangutils.utils.UtilConstants.QUEUE; |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 65 | import static org.onosproject.yangutils.utils.UtilConstants.RPC_INPUT_STRING; |
| 66 | import static org.onosproject.yangutils.utils.UtilConstants.RPC_OUTPUT_STRING; |
Vidyashree Rama | b367047 | 2016-08-06 15:49:56 +0530 | [diff] [blame] | 67 | import static org.onosproject.yangutils.utils.UtilConstants.SET; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 68 | import static org.onosproject.yangutils.utils.UtilConstants.SPACE; |
Gaurav Agrawal | 97a5e1c | 2016-04-18 18:53:11 +0530 | [diff] [blame] | 69 | import static org.onosproject.yangutils.utils.UtilConstants.STRING_DATA_TYPE; |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 70 | import static org.onosproject.yangutils.utils.UtilConstants.TO_CAPS; |
| 71 | import static org.onosproject.yangutils.utils.UtilConstants.VALIDATE_RANGE; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 72 | import static org.onosproject.yangutils.utils.UtilConstants.VALUE; |
Bharat saraswal | 250a747 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 73 | import static org.onosproject.yangutils.utils.UtilConstants.VOID; |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 74 | import static org.onosproject.yangutils.utils.UtilConstants.YANG_AUGMENTED_INFO; |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 75 | import static org.onosproject.yangutils.utils.UtilConstants.YANG_AUGMENTED_INFO_LOWER_CASE; |
Bharat saraswal | af413b8 | 2016-07-14 15:18:20 +0530 | [diff] [blame] | 76 | import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.getSmallCase; |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 77 | import static org.onosproject.yangutils.utils.io.impl.YangIoUtils.trimAtLast; |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 78 | |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 79 | /** |
Bharat saraswal | 63f26fb | 2016-04-05 15:13:44 +0530 | [diff] [blame] | 80 | * Represents javadoc for the generated classes. |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 81 | */ |
| 82 | public final class JavaDocGen { |
| 83 | |
| 84 | /** |
Bharat saraswal | 63f26fb | 2016-04-05 15:13:44 +0530 | [diff] [blame] | 85 | * Creates an instance of java doc gen. |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 86 | */ |
| 87 | private JavaDocGen() { |
| 88 | } |
| 89 | |
| 90 | /** |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 91 | * Returns java docs. |
| 92 | * |
Bharat saraswal | e304c25 | 2016-08-16 20:56:20 +0530 | [diff] [blame] | 93 | * @param type java doc type |
| 94 | * @param name name of the YangNode |
| 95 | * @param isList is list attribute |
Vidyashree Rama | b367047 | 2016-08-06 15:49:56 +0530 | [diff] [blame] | 96 | * @param compilerAnnotation compiler annotations for user defined data type |
Bharat saraswal | 2da23bf | 2016-08-25 15:28:39 +0530 | [diff] [blame] | 97 | * @return javaDocs. |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 98 | */ |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 99 | public static String getJavaDoc(JavaDocType type, String name, boolean isList, |
Bharat saraswal | e304c25 | 2016-08-16 20:56:20 +0530 | [diff] [blame] | 100 | String compilerAnnotation) { |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 101 | |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 102 | name = YangIoUtils.getSmallCase(name); |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 103 | switch (type) { |
| 104 | case IMPL_CLASS: { |
Bharat saraswal | 715d3fc | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 105 | return generateForClass(name); |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 106 | } |
| 107 | case BUILDER_CLASS: { |
| 108 | return generateForBuilderClass(name); |
| 109 | } |
Shankara-Huawei | a1039e5 | 2016-07-14 16:53:09 +0530 | [diff] [blame] | 110 | case OPERATION_CLASS: { |
| 111 | return generateForOpParamClass(name); |
| 112 | } |
| 113 | case OPERATION_BUILDER_CLASS: { |
| 114 | return generateForOpParamClass(name); |
| 115 | } |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 116 | case INTERFACE: { |
| 117 | return generateForInterface(name); |
| 118 | } |
| 119 | case BUILDER_INTERFACE: { |
| 120 | return generateForBuilderInterface(name); |
| 121 | } |
| 122 | case PACKAGE_INFO: { |
Bharat saraswal | 250a747 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 123 | return generateForPackage(name, isList); |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 124 | } |
| 125 | case GETTER_METHOD: { |
Vidyashree Rama | b367047 | 2016-08-06 15:49:56 +0530 | [diff] [blame] | 126 | return generateForGetters(name, isList, compilerAnnotation); |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 127 | } |
| 128 | case TYPE_DEF_SETTER_METHOD: { |
| 129 | return generateForTypeDefSetter(name); |
| 130 | } |
| 131 | case SETTER_METHOD: { |
Vidyashree Rama | b367047 | 2016-08-06 15:49:56 +0530 | [diff] [blame] | 132 | return generateForSetters(name, isList, compilerAnnotation); |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 133 | } |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 134 | case MANAGER_SETTER_METHOD: { |
Vidyashree Rama | b367047 | 2016-08-06 15:49:56 +0530 | [diff] [blame] | 135 | return generateForManagerSetters(name, isList, compilerAnnotation); |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 136 | } |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 137 | case OF_METHOD: { |
| 138 | return generateForOf(name); |
| 139 | } |
| 140 | case DEFAULT_CONSTRUCTOR: { |
| 141 | return generateForDefaultConstructors(name); |
| 142 | } |
| 143 | case BUILD_METHOD: { |
| 144 | return generateForBuild(name); |
| 145 | } |
| 146 | case TYPE_CONSTRUCTOR: { |
| 147 | return generateForTypeConstructor(name); |
| 148 | } |
| 149 | case FROM_METHOD: { |
| 150 | return generateForFromString(name); |
| 151 | } |
| 152 | case ENUM_CLASS: { |
| 153 | return generateForEnum(name); |
| 154 | } |
| 155 | case ENUM_ATTRIBUTE: { |
| 156 | return generateForEnumAttr(name); |
| 157 | } |
| 158 | case RPC_INTERFACE: { |
Bharat saraswal | af413b8 | 2016-07-14 15:18:20 +0530 | [diff] [blame] | 159 | return generateForRpcService(name); |
Bharat saraswal | 250a747 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 160 | } |
| 161 | case RPC_MANAGER: { |
Bharat saraswal | af413b8 | 2016-07-14 15:18:20 +0530 | [diff] [blame] | 162 | return generateForClass(name); |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 163 | } |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 164 | case EVENT: { |
| 165 | return generateForEvent(name); |
| 166 | } |
| 167 | case EVENT_LISTENER: { |
| 168 | return generateForEventListener(name); |
| 169 | } |
Bharat saraswal | 715d3fc | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 170 | case EVENT_SUBJECT_CLASS: { |
| 171 | return generateForClass(name); |
| 172 | } |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 173 | case ADD_TO_LIST: { |
| 174 | return generateForAddToList(name); |
| 175 | } |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 176 | default: { |
| 177 | return generateForConstructors(name); |
| 178 | } |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 179 | } |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 180 | } |
| 181 | |
| 182 | /** |
Bharat saraswal | 68fa0d1 | 2016-04-19 01:00:16 +0530 | [diff] [blame] | 183 | * Generates javaDocs for enum's attributes. |
| 184 | * |
| 185 | * @param name attribute name |
| 186 | * @return javaDocs |
| 187 | */ |
| 188 | private static String generateForEnumAttr(String name) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 189 | return getJavaDocForClass(name, ENUM_ATTRIBUTE_JAVADOC, |
| 190 | FOUR_SPACE_INDENTATION); |
Bharat saraswal | 748fc3c | 2016-09-06 16:38:20 +0530 | [diff] [blame] | 191 | } |
| 192 | |
| 193 | /** |
| 194 | * Generates javaDocs for inner class enum's attributes. |
| 195 | * |
| 196 | * @param name attribute name |
| 197 | * @return javaDocs |
| 198 | */ |
| 199 | public static String enumJavaDocForInnerClass(String name) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 200 | return getJavaDocForClass(name, ENUM_ATTRIBUTE_JAVADOC, |
| 201 | EIGHT_SPACE_INDENTATION); |
Bharat saraswal | 68fa0d1 | 2016-04-19 01:00:16 +0530 | [diff] [blame] | 202 | } |
| 203 | |
| 204 | /** |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 205 | * Generates javaDocs for rpc method. |
| 206 | * |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 207 | * @param rpcName name of the rpc |
| 208 | * @param inputName name of input |
| 209 | * @param outputName name of output |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 210 | * @return javaDocs of rpc method |
| 211 | */ |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 212 | public static String generateJavaDocForRpc(String rpcName, String inputName, |
| 213 | String outputName) { |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 214 | |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 215 | String javadoc = getJavaDocStartLine(rpcName, JAVA_DOC_RPC) + |
| 216 | getJavaDocEmptyAsteriskLine(); |
Bharat saraswal | 5cd9e9c | 2016-05-26 23:48:38 +0530 | [diff] [blame] | 217 | if (!inputName.equals(EMPTY_STRING)) { |
| 218 | javadoc = javadoc + getInputString(inputName, rpcName); |
| 219 | } |
Bharat saraswal | 250a747 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 220 | if (!outputName.equals(VOID)) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 221 | javadoc = javadoc + getOutputString(getSmallCase(outputName), |
| 222 | rpcName); |
Bharat saraswal | 250a747 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 223 | } |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 224 | return javadoc + getJavaDocEndLine(); |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 225 | } |
| 226 | |
| 227 | /** |
| 228 | * Returns output string of rpc. |
| 229 | * |
| 230 | * @param outputName name of output |
Bharat saraswal | af413b8 | 2016-07-14 15:18:20 +0530 | [diff] [blame] | 231 | * @param rpcName name of rpc |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 232 | * @return javaDocs for output string of rpc |
| 233 | */ |
| 234 | private static String getOutputString(String outputName, String rpcName) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 235 | return FOUR_SPACE_INDENTATION + JAVA_DOC_RETURN + outputName + SPACE + |
| 236 | RPC_OUTPUT_STRING + rpcName + NEW_LINE; |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 237 | } |
| 238 | |
| 239 | /** |
| 240 | * Returns input string of rpc. |
| 241 | * |
| 242 | * @param inputName name of input |
Bharat saraswal | af413b8 | 2016-07-14 15:18:20 +0530 | [diff] [blame] | 243 | * @param rpcName name of rpc |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 244 | * @return javaDocs for input string of rpc |
| 245 | */ |
| 246 | private static String getInputString(String inputName, String rpcName) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 247 | if (inputName.isEmpty()) { |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 248 | return null; |
| 249 | } else { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 250 | return FOUR_SPACE_INDENTATION + JAVA_DOC_PARAM + inputName + |
| 251 | SPACE + RPC_INPUT_STRING + rpcName + NEW_LINE; |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 252 | } |
| 253 | } |
| 254 | |
| 255 | /** |
| 256 | * Generates javaDoc for the interface. |
| 257 | * |
| 258 | * @param interfaceName interface name |
| 259 | * @return javaDocs |
| 260 | */ |
Bharat saraswal | 250a747 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 261 | private static String generateForRpcService(String interfaceName) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 262 | return getJavaDocForClass(interfaceName, INTERFACE_JAVA_DOC, EMPTY_STRING); |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 263 | } |
| 264 | |
| 265 | /** |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 266 | * Generates javaDoc for the event. |
| 267 | * |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 268 | * @param name event class name |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 269 | * @return javaDocs |
| 270 | */ |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 271 | private static String generateForEvent(String name) { |
| 272 | return getJavaDocForClass(name, EVENT_JAVA_DOC, EMPTY_STRING); |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 273 | } |
| 274 | |
| 275 | /** |
| 276 | * Generates javaDoc for the event listener. |
| 277 | * |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 278 | * @param name event class name |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 279 | * @return javaDocs |
| 280 | */ |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 281 | private static String generateForEventListener(String name) { |
| 282 | return getJavaDocForClass(name, EVENT_LISTENER_JAVA_DOC, EMPTY_STRING); |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 283 | } |
| 284 | |
| 285 | /** |
Bharat saraswal | 68fa0d1 | 2016-04-19 01:00:16 +0530 | [diff] [blame] | 286 | * Generates javaDocs for getter method. |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 287 | * |
Bharat saraswal | e304c25 | 2016-08-16 20:56:20 +0530 | [diff] [blame] | 288 | * @param attribute attribute |
| 289 | * @param isList is list attribute |
Vidyashree Rama | b367047 | 2016-08-06 15:49:56 +0530 | [diff] [blame] | 290 | * @param compilerAnnotation compiler annotation |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 291 | * @return javaDocs |
| 292 | */ |
Vidyashree Rama | b367047 | 2016-08-06 15:49:56 +0530 | [diff] [blame] | 293 | private static String generateForGetters(String attribute, boolean isList, |
Bharat saraswal | e304c25 | 2016-08-16 20:56:20 +0530 | [diff] [blame] | 294 | String compilerAnnotation) { |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 295 | |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 296 | String getter = getJavaDocStartLine(attribute, JAVA_DOC_GETTERS) + |
| 297 | getJavaDocEmptyAsteriskLine() + |
| 298 | FOUR_SPACE_INDENTATION + JAVA_DOC_RETURN + attribute + SPACE; |
Bharat saraswal | 022dae9 | 2016-03-04 20:08:09 +0530 | [diff] [blame] | 299 | |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 300 | getter = getParamForAnnotation(getter, compilerAnnotation, isList) + |
| 301 | attribute + NEW_LINE + getJavaDocEndLine(); |
Bharat saraswal | 022dae9 | 2016-03-04 20:08:09 +0530 | [diff] [blame] | 302 | return getter; |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 303 | } |
| 304 | |
| 305 | /** |
| 306 | * Generates javaDocs for setter method. |
| 307 | * |
Bharat saraswal | e304c25 | 2016-08-16 20:56:20 +0530 | [diff] [blame] | 308 | * @param attribute attribute |
| 309 | * @param isList is list attribute |
Vidyashree Rama | b367047 | 2016-08-06 15:49:56 +0530 | [diff] [blame] | 310 | * @param compilerAnnotation compiler annotation |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 311 | * @return javaDocs |
| 312 | */ |
Vidyashree Rama | b367047 | 2016-08-06 15:49:56 +0530 | [diff] [blame] | 313 | private static String generateForSetters(String attribute, boolean isList, |
Bharat saraswal | e304c25 | 2016-08-16 20:56:20 +0530 | [diff] [blame] | 314 | String compilerAnnotation) { |
Bharat saraswal | 84366c5 | 2016-03-23 19:40:35 +0530 | [diff] [blame] | 315 | |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 316 | String setter = getJavaDocStartLine(attribute, JAVA_DOC_SETTERS) + |
| 317 | getJavaDocEmptyAsteriskLine() + |
| 318 | FOUR_SPACE_INDENTATION + JAVA_DOC_PARAM + attribute + SPACE; |
| 319 | setter = getParamForAnnotation(setter, compilerAnnotation, isList) + |
| 320 | attribute + NEW_LINE + getJavaDocReturnLine(attribute) |
| 321 | + getJavaDocEndLine(); |
Bharat saraswal | 022dae9 | 2016-03-04 20:08:09 +0530 | [diff] [blame] | 322 | return setter; |
| 323 | } |
| 324 | |
| 325 | /** |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 326 | * Generates javaDocs for setter method. |
| 327 | * |
Bharat saraswal | e304c25 | 2016-08-16 20:56:20 +0530 | [diff] [blame] | 328 | * @param attribute attribute |
| 329 | * @param isList is list attribute |
Vidyashree Rama | b367047 | 2016-08-06 15:49:56 +0530 | [diff] [blame] | 330 | * @param compilerAnnotation compiler annotation |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 331 | * @return javaDocs |
| 332 | */ |
Vidyashree Rama | b367047 | 2016-08-06 15:49:56 +0530 | [diff] [blame] | 333 | private static String generateForManagerSetters(String attribute, boolean isList, |
Bharat saraswal | e304c25 | 2016-08-16 20:56:20 +0530 | [diff] [blame] | 334 | String compilerAnnotation) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 335 | String setter = getJavaDocStartLine(attribute, JAVA_DOC_MANAGER_SETTERS) + |
| 336 | getJavaDocEmptyAsteriskLine() + |
| 337 | FOUR_SPACE_INDENTATION + JAVA_DOC_PARAM + attribute + SPACE; |
| 338 | setter = getParamForAnnotation(setter, compilerAnnotation, isList) + |
| 339 | attribute + NEW_LINE + getJavaDocEndLine(); |
| 340 | return setter; |
| 341 | } |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 342 | |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 343 | private static String getParamForAnnotation( |
| 344 | String setter, String compilerAnnotation, boolean isList) { |
Vidyashree Rama | b367047 | 2016-08-06 15:49:56 +0530 | [diff] [blame] | 345 | String attributeParam; |
| 346 | if (compilerAnnotation != null) { |
| 347 | switch (compilerAnnotation) { |
| 348 | case QUEUE: { |
| 349 | attributeParam = QUEUE.toLowerCase() + SPACE + OF + SPACE; |
| 350 | setter = setter + attributeParam; |
| 351 | break; |
| 352 | } |
| 353 | case SET: { |
| 354 | attributeParam = SET.toLowerCase() + SPACE + OF + SPACE; |
| 355 | setter = setter + attributeParam; |
| 356 | break; |
| 357 | } |
| 358 | case LIST: { |
| 359 | attributeParam = LIST.toLowerCase() + SPACE + OF + SPACE; |
| 360 | setter = setter + attributeParam; |
| 361 | break; |
| 362 | } |
| 363 | default: { |
| 364 | |
| 365 | } |
| 366 | } |
| 367 | } else if (isList) { |
| 368 | attributeParam = LIST.toLowerCase() + SPACE + OF + SPACE; |
| 369 | setter = setter + attributeParam; |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 370 | } else { |
| 371 | setter = setter + VALUE + SPACE + OF + SPACE; |
| 372 | } |
VinodKumarS-Huawei | 6266db3 | 2016-05-10 17:58:57 +0530 | [diff] [blame] | 373 | return setter; |
| 374 | } |
| 375 | |
| 376 | /** |
Bharat saraswal | 022dae9 | 2016-03-04 20:08:09 +0530 | [diff] [blame] | 377 | * Generates javaDocs for of method. |
| 378 | * |
| 379 | * @param attribute attribute |
| 380 | * @return javaDocs |
| 381 | */ |
| 382 | private static String generateForOf(String attribute) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 383 | return getJavaDocStartLine(attribute, JAVA_DOC_OF) + |
| 384 | getJavaDocEmptyAsteriskLine() + |
| 385 | getJavaDocParamLine(attribute, VALUE) + |
| 386 | getJavaDocReturnLine(attribute) + |
| 387 | getJavaDocEndLine(); |
Bharat saraswal | 022dae9 | 2016-03-04 20:08:09 +0530 | [diff] [blame] | 388 | } |
| 389 | |
| 390 | /** |
Gaurav Agrawal | 97a5e1c | 2016-04-18 18:53:11 +0530 | [diff] [blame] | 391 | * Generates javaDocs for from method. |
| 392 | * |
| 393 | * @param attribute attribute |
| 394 | * @return javaDocs |
| 395 | */ |
Gaurav Agrawal | 02a60de | 2016-04-20 15:49:17 +0530 | [diff] [blame] | 396 | private static String generateForFromString(String attribute) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 397 | return getJavaDocStartLine(attribute, JAVA_DOC_OF |
| 398 | + attribute + SPACE + FROM_STRING_METHOD_NAME + SPACE + INPUT + |
| 399 | SPACE + STRING_DATA_TYPE) + |
| 400 | getJavaDocEmptyAsteriskLine() + |
| 401 | getJavaDocParamLine(INPUT + SPACE + STRING_DATA_TYPE, |
| 402 | FROM_STRING_PARAM_NAME) + |
| 403 | getJavaDocReturnLine(attribute) + |
| 404 | getJavaDocEndLine(); |
Gaurav Agrawal | 97a5e1c | 2016-04-18 18:53:11 +0530 | [diff] [blame] | 405 | } |
| 406 | |
| 407 | /** |
Bharat saraswal | 022dae9 | 2016-03-04 20:08:09 +0530 | [diff] [blame] | 408 | * Generates javaDocs for typedef setter method. |
| 409 | * |
| 410 | * @param attribute attribute |
| 411 | * @return javaDocs |
| 412 | */ |
| 413 | private static String generateForTypeDefSetter(String attribute) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 414 | return getJavaDocStartLine(attribute, JAVA_DOC_SETTERS_COMMON) + |
| 415 | getJavaDocEmptyAsteriskLine() + |
| 416 | getJavaDocParamLine(attribute, VALUE) + |
| 417 | getJavaDocEndLine(); |
Bharat saraswal | 022dae9 | 2016-03-04 20:08:09 +0530 | [diff] [blame] | 418 | } |
| 419 | |
| 420 | /** |
Bharat saraswal | 68fa0d1 | 2016-04-19 01:00:16 +0530 | [diff] [blame] | 421 | * Generates javaDocs for the impl class. |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 422 | * |
| 423 | * @param className class name |
Vinod Kumar S | 0871098 | 2016-03-03 19:55:30 +0530 | [diff] [blame] | 424 | * @return javaDocs |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 425 | */ |
Bharat saraswal | 715d3fc | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 426 | private static String generateForClass(String className) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 427 | return getJavaDocForClass(className, IMPL_CLASS_JAVA_DOC, EMPTY_STRING); |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 428 | } |
| 429 | |
| 430 | /** |
Bharat saraswal | 68fa0d1 | 2016-04-19 01:00:16 +0530 | [diff] [blame] | 431 | * Generates javaDocs for enum. |
| 432 | * |
| 433 | * @param className enum class name |
| 434 | * @return javaDocs |
| 435 | */ |
| 436 | private static String generateForEnum(String className) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 437 | return getJavaDocForClass(className, ENUM_CLASS_JAVADOC, EMPTY_STRING); |
Bharat saraswal | 68fa0d1 | 2016-04-19 01:00:16 +0530 | [diff] [blame] | 438 | } |
| 439 | |
| 440 | /** |
| 441 | * Generates javaDocs for the builder class. |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 442 | * |
| 443 | * @param className class name |
Vinod Kumar S | 0871098 | 2016-03-03 19:55:30 +0530 | [diff] [blame] | 444 | * @return javaDocs |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 445 | */ |
| 446 | private static String generateForBuilderClass(String className) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 447 | return getJavaDocForClass(className, BUILDER_CLASS_JAVA_DOC, |
| 448 | EMPTY_STRING); |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 449 | } |
| 450 | |
| 451 | /** |
Shankara-Huawei | a1039e5 | 2016-07-14 16:53:09 +0530 | [diff] [blame] | 452 | * Generates javaDocs for the op param class. |
| 453 | * |
| 454 | * @param className class name |
| 455 | * @return javaDocs |
| 456 | */ |
| 457 | private static String generateForOpParamClass(String className) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 458 | return getJavaDocForClass(className, OP_PARAM_JAVA_DOC, |
| 459 | EMPTY_STRING); |
Shankara-Huawei | a1039e5 | 2016-07-14 16:53:09 +0530 | [diff] [blame] | 460 | } |
| 461 | |
| 462 | /** |
Bharat saraswal | 68fa0d1 | 2016-04-19 01:00:16 +0530 | [diff] [blame] | 463 | * Generates javaDoc for the interface. |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 464 | * |
| 465 | * @param interfaceName interface name |
Vinod Kumar S | 0871098 | 2016-03-03 19:55:30 +0530 | [diff] [blame] | 466 | * @return javaDocs |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 467 | */ |
| 468 | private static String generateForInterface(String interfaceName) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 469 | return getJavaDocForClass(interfaceName, INTERFACE_JAVA_DOC, |
| 470 | EMPTY_STRING); |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 471 | } |
| 472 | |
| 473 | /** |
Bharat saraswal | 68fa0d1 | 2016-04-19 01:00:16 +0530 | [diff] [blame] | 474 | * Generates javaDoc for the builder interface. |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 475 | * |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 476 | * @param builderForName builder for name |
Vinod Kumar S | 0871098 | 2016-03-03 19:55:30 +0530 | [diff] [blame] | 477 | * @return javaDocs |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 478 | */ |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 479 | private static String generateForBuilderInterface(String builderForName) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 480 | return getJavaDocForClass(builderForName, BUILDER_INTERFACE_JAVA_DOC, |
| 481 | EMPTY_STRING); |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 482 | } |
| 483 | |
| 484 | /** |
Bharat saraswal | 68fa0d1 | 2016-04-19 01:00:16 +0530 | [diff] [blame] | 485 | * Generates javaDocs for package-info. |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 486 | * |
| 487 | * @param packageName package name |
Bharat saraswal | 250a747 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 488 | * @param isChildNode is it child node |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 489 | * @return javaDocs |
| 490 | */ |
Bharat saraswal | 250a747 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 491 | private static String generateForPackage(String packageName, boolean isChildNode) { |
Bharat saraswal | 250a747 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 492 | if (isChildNode) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 493 | return getJavaDocForClass( |
| 494 | packageName + PACKAGE_INFO_JAVADOC_OF_CHILD, |
| 495 | PACKAGE_INFO_JAVADOC, EMPTY_STRING); |
Bharat saraswal | 250a747 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 496 | } |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 497 | return getJavaDocForClass(packageName, PACKAGE_INFO_JAVADOC, EMPTY_STRING); |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 498 | } |
| 499 | |
| 500 | /** |
Bharat saraswal | 68fa0d1 | 2016-04-19 01:00:16 +0530 | [diff] [blame] | 501 | * Generates javaDocs for default constructor. |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 502 | * |
Bharat saraswal | 780eca3 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 503 | * @param className class name |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 504 | * @return javaDocs |
| 505 | */ |
Bharat saraswal | 780eca3 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 506 | private static String generateForDefaultConstructors(String className) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 507 | return getJavaDocStartLine(className, JAVA_DOC_CONSTRUCTOR) + |
| 508 | getJavaDocEndLine(); |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 509 | } |
| 510 | |
| 511 | /** |
Bharat saraswal | 68fa0d1 | 2016-04-19 01:00:16 +0530 | [diff] [blame] | 512 | * Generates javaDocs for constructor with parameters. |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 513 | * |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 514 | * @param className class name |
| 515 | * @return javaDocs |
| 516 | */ |
| 517 | private static String generateForConstructors(String className) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 518 | return getJavaDocStartLine(className, JAVA_DOC_CONSTRUCTOR) + |
| 519 | getJavaDocEmptyAsteriskLine() + |
| 520 | getJavaDocParamLine(BUILDER_OBJECT + className, |
| 521 | BUILDER_LOWER_CASE + OBJECT) + |
| 522 | getJavaDocEndLine(); |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 523 | } |
| 524 | |
| 525 | /** |
Bharat saraswal | 68fa0d1 | 2016-04-19 01:00:16 +0530 | [diff] [blame] | 526 | * Generates javaDocs for build. |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 527 | * |
Vinod Kumar S | 0871098 | 2016-03-03 19:55:30 +0530 | [diff] [blame] | 528 | * @param buildName builder name |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 529 | * @return javaDocs |
| 530 | */ |
| 531 | private static String generateForBuild(String buildName) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 532 | return getJavaDocStartLine(buildName, JAVA_DOC_BUILD) + |
| 533 | getJavaDocEmptyAsteriskLine() + |
| 534 | getJavaDocReturnLine(buildName) + |
| 535 | getJavaDocEndLine(); |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 536 | } |
Gaurav Agrawal | 97a5e1c | 2016-04-18 18:53:11 +0530 | [diff] [blame] | 537 | |
| 538 | /** |
| 539 | * Generates javaDocs for type constructor. |
| 540 | * |
| 541 | * @param attribute attribute string |
| 542 | * @return javaDocs for type constructor |
| 543 | */ |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 544 | private static String generateForTypeConstructor(String attribute) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 545 | return getJavaDocStartLine(attribute, |
| 546 | JAVA_DOC_CONSTRUCTOR) + |
| 547 | getJavaDocEmptyAsteriskLine() + |
| 548 | getJavaDocParamLine(attribute, attribute) + |
| 549 | getJavaDocEndLine(); |
Gaurav Agrawal | 97a5e1c | 2016-04-18 18:53:11 +0530 | [diff] [blame] | 550 | } |
Bharat saraswal | af413b8 | 2016-07-14 15:18:20 +0530 | [diff] [blame] | 551 | |
| 552 | /** |
| 553 | * Generates javaDocs for add augmentation method. |
| 554 | * |
| 555 | * @return javaDocs |
| 556 | */ |
| 557 | public static String generateForAddAugmentation() { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 558 | return getJavaDocStartLine(YANG_AUGMENTED_INFO_LOWER_CASE, |
| 559 | JAVA_DOC_SETTERS_COMMON) + |
| 560 | getJavaDocEmptyAsteriskLine() + |
| 561 | getJavaDocParamLine(YANG_AUGMENTED_INFO_LOWER_CASE, VALUE) + |
| 562 | getJavaDocParamLine(YANG_AUGMENTED_INFO_LOWER_CASE, CLASS + |
| 563 | OBJECT_STRING) + |
| 564 | getJavaDocEndLine(); |
Bharat saraswal | af413b8 | 2016-07-14 15:18:20 +0530 | [diff] [blame] | 565 | } |
| 566 | |
Bharat saraswal | 64e7e23 | 2016-07-14 23:33:55 +0530 | [diff] [blame] | 567 | /** |
| 568 | * Returns javadoc for get augmentation method. |
| 569 | * |
| 570 | * @return javadoc for get augmentation method |
| 571 | */ |
Bharat saraswal | af413b8 | 2016-07-14 15:18:20 +0530 | [diff] [blame] | 572 | public static String generateForGetAugmentation() { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 573 | return NEW_LINE + getJavaDocStartLine(YANG_AUGMENTED_INFO_LOWER_CASE, |
| 574 | JAVA_DOC_GETTERS) + |
| 575 | getJavaDocEmptyAsteriskLine() + |
| 576 | getJavaDocParamLine(YANG_AUGMENTED_INFO_LOWER_CASE, CLASS + |
| 577 | OBJECT_STRING) + |
| 578 | getJavaDocReturnLine(YANG_AUGMENTED_INFO) + |
| 579 | getJavaDocEndLine(); |
Bharat saraswal | af413b8 | 2016-07-14 15:18:20 +0530 | [diff] [blame] | 580 | } |
| 581 | |
| 582 | /** |
Bharat saraswal | 64e7e23 | 2016-07-14 23:33:55 +0530 | [diff] [blame] | 583 | * Returns javadoc for validator method. |
| 584 | * |
| 585 | * @return javadoc for validator method |
| 586 | */ |
| 587 | public static String generateForValidatorMethod() { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 588 | return getJavaDocStartLine(VALIDATE_RANGE, JAVA_DOC_FOR_VALIDATOR) + |
| 589 | getJavaDocEmptyAsteriskLine() + |
| 590 | trimAtLast(getJavaDocParamLine(MIN_RANGE, MIN_RANGE), NEW_LINE) + |
| 591 | getJavaDocParamLine(MIN_RANGE, MIN_RANGE) + |
| 592 | getJavaDocReturnLine(JAVA_DOC_FOR_VALIDATOR_RETURN) + |
| 593 | getJavaDocEndLine(); |
Bharat saraswal | 64e7e23 | 2016-07-14 23:33:55 +0530 | [diff] [blame] | 594 | } |
| 595 | |
| 596 | /** |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 597 | * Generates javaDocs for type constructor. |
| 598 | * |
| 599 | * @param attribute attribute string |
| 600 | * @return javaDocs for type constructor |
| 601 | */ |
| 602 | public static String generateForGetMethodWithAttribute(String attribute) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 603 | attribute = getSmallCase(attribute); |
| 604 | return getJavaDocStartLine(attribute, JAVA_DOC_GETTERS) + |
| 605 | getJavaDocEmptyAsteriskLine() + |
| 606 | getJavaDocParamLine(attribute, attribute) + |
| 607 | getJavaDocReturnLine(attribute) + |
| 608 | getJavaDocEndLine(); |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 609 | } |
| 610 | |
| 611 | /** |
| 612 | * Returns javaDocs for add to list method. |
| 613 | * |
| 614 | * @param attribute attribute |
| 615 | * @return javaDocs |
| 616 | */ |
| 617 | private static String generateForAddToList(String attribute) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 618 | return getJavaDocStartLine(attribute, JAVA_DOC_ADD_TO_LIST) + |
| 619 | getJavaDocEmptyAsteriskLine() + |
| 620 | getJavaDocParamLine(attribute, ADD_STRING + TO_CAPS) + |
| 621 | getJavaDocReturnLine(BUILDER_OBJECT + attribute) + |
| 622 | getJavaDocEndLine(); |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 623 | } |
| 624 | |
| 625 | /** |
| 626 | * Generates for builder method. |
| 627 | * |
| 628 | * @param attribute attribute |
| 629 | * @return javaDocs |
| 630 | */ |
| 631 | public static String generateForBuilderMethod(String attribute) { |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 632 | return getJavaDocStartLine(attribute + BUILDER, JAVA_DOC_GETTERS) + |
| 633 | getJavaDocEmptyAsteriskLine() + |
| 634 | getJavaDocReturnLine(attribute + BUILDER) + |
| 635 | getJavaDocEndLine(); |
| 636 | } |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 637 | |
Bharat saraswal | 9fab16b | 2016-09-23 23:27:24 +0530 | [diff] [blame^] | 638 | /** |
| 639 | * Returns class javadoc. |
| 640 | * |
| 641 | * @param name name of class |
| 642 | * @param type type of javadoc |
| 643 | * @param indent indentation |
| 644 | * @return class javadoc |
| 645 | */ |
| 646 | private static String getJavaDocForClass(String name, String type, |
| 647 | String indent) { |
| 648 | return NEW_LINE + indent + JAVA_DOC_FIRST_LINE + indent + type + |
| 649 | getSmallCase(name) + PERIOD + NEW_LINE + indent + JAVA_DOC_END_LINE; |
| 650 | } |
| 651 | |
| 652 | /** |
| 653 | * Returns javadoc start line. |
| 654 | * |
| 655 | * @param name name of attribute |
| 656 | * @param javaDoc type of javadoc |
| 657 | * @return javadoc start line |
| 658 | */ |
| 659 | private static String getJavaDocStartLine(String name, String javaDoc) { |
| 660 | return FOUR_SPACE_INDENTATION + JAVA_DOC_FIRST_LINE + |
| 661 | FOUR_SPACE_INDENTATION + javaDoc + getSmallCase(name) + |
| 662 | PERIOD + NEW_LINE; |
| 663 | } |
| 664 | |
| 665 | /** |
| 666 | * Returns asterisk line. |
| 667 | * |
| 668 | * @return asterisk line |
| 669 | */ |
| 670 | private static String getJavaDocEmptyAsteriskLine() { |
| 671 | return FOUR_SPACE_INDENTATION + NEW_LINE_ASTERISK; |
| 672 | } |
| 673 | |
| 674 | /** |
| 675 | * Returns javadoc param line. |
| 676 | * |
| 677 | * @param name name of attribute |
| 678 | * @return javadoc param line |
| 679 | */ |
| 680 | private static String getJavaDocParamLine(String name, String paraName) { |
| 681 | return FOUR_SPACE_INDENTATION + JAVA_DOC_PARAM + |
| 682 | getSmallCase(paraName) + SPACE + VALUE + SPACE + OF + SPACE + |
| 683 | getSmallCase(name) + NEW_LINE; |
| 684 | } |
| 685 | |
| 686 | /** |
| 687 | * Returns javadoc return line. |
| 688 | * |
| 689 | * @param name name of attribute |
| 690 | * @return javadoc return line |
| 691 | */ |
| 692 | private static String getJavaDocReturnLine(String name) { |
| 693 | return FOUR_SPACE_INDENTATION + JAVA_DOC_RETURN + getSmallCase(name) |
| 694 | + NEW_LINE; |
| 695 | } |
| 696 | |
| 697 | /** |
| 698 | * Returns javadoc end line. |
| 699 | * |
| 700 | * @return javadoc end line |
| 701 | */ |
| 702 | private static String getJavaDocEndLine() { |
| 703 | return FOUR_SPACE_INDENTATION + JAVA_DOC_END_LINE; |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 704 | } |
| 705 | |
| 706 | |
| 707 | /** |
Bharat saraswal | af413b8 | 2016-07-14 15:18:20 +0530 | [diff] [blame] | 708 | * JavaDocs types. |
| 709 | */ |
| 710 | public enum JavaDocType { |
| 711 | |
| 712 | /** |
| 713 | * For class. |
| 714 | */ |
| 715 | IMPL_CLASS, |
| 716 | |
| 717 | /** |
| 718 | * For builder class. |
| 719 | */ |
| 720 | BUILDER_CLASS, |
| 721 | |
| 722 | /** |
| 723 | * For interface. |
| 724 | */ |
| 725 | INTERFACE, |
| 726 | |
| 727 | /** |
| 728 | * For builder interface. |
| 729 | */ |
| 730 | BUILDER_INTERFACE, |
| 731 | |
| 732 | /** |
| 733 | * For package-info. |
| 734 | */ |
| 735 | PACKAGE_INFO, |
| 736 | |
| 737 | /** |
| 738 | * For getters. |
| 739 | */ |
| 740 | GETTER_METHOD, |
| 741 | |
| 742 | /** |
| 743 | * For rpc service. |
| 744 | */ |
| 745 | RPC_INTERFACE, |
| 746 | |
| 747 | /** |
| 748 | * For rpc manager. |
| 749 | */ |
| 750 | RPC_MANAGER, |
| 751 | |
| 752 | /** |
| 753 | * For event. |
| 754 | */ |
| 755 | EVENT, |
| 756 | |
| 757 | /** |
| 758 | * For event listener. |
| 759 | */ |
| 760 | EVENT_LISTENER, |
| 761 | |
| 762 | /** |
| 763 | * For setters. |
| 764 | */ |
| 765 | SETTER_METHOD, |
| 766 | |
| 767 | /** |
| 768 | * For type def's setters. |
| 769 | */ |
| 770 | TYPE_DEF_SETTER_METHOD, |
| 771 | |
| 772 | /** |
| 773 | * For of method. |
| 774 | */ |
| 775 | OF_METHOD, |
| 776 | |
| 777 | /** |
| 778 | * For default constructor. |
| 779 | */ |
| 780 | DEFAULT_CONSTRUCTOR, |
| 781 | |
| 782 | /** |
| 783 | * For constructor. |
| 784 | */ |
| 785 | CONSTRUCTOR, |
| 786 | |
| 787 | /** |
| 788 | * For from method. |
| 789 | */ |
| 790 | FROM_METHOD, |
| 791 | |
| 792 | /** |
| 793 | * For type constructor. |
| 794 | */ |
| 795 | TYPE_CONSTRUCTOR, |
| 796 | |
| 797 | /** |
| 798 | * For build. |
| 799 | */ |
| 800 | BUILD_METHOD, |
| 801 | |
| 802 | /** |
| 803 | * For enum. |
| 804 | */ |
| 805 | ENUM_CLASS, |
| 806 | |
| 807 | /** |
| 808 | * For enum's attributes. |
| 809 | */ |
| 810 | ENUM_ATTRIBUTE, |
| 811 | |
| 812 | /** |
| 813 | * For manager setters. |
| 814 | */ |
| 815 | MANAGER_SETTER_METHOD, |
| 816 | |
| 817 | /** |
| 818 | * For event subject. |
| 819 | */ |
Shankara-Huawei | a1039e5 | 2016-07-14 16:53:09 +0530 | [diff] [blame] | 820 | EVENT_SUBJECT_CLASS, |
| 821 | |
| 822 | /** |
| 823 | * For operation. |
| 824 | */ |
| 825 | OPERATION_CLASS, |
| 826 | |
| 827 | /** |
| 828 | * For operation builder. |
| 829 | */ |
Bharat saraswal | 8beac34 | 2016-08-04 02:00:03 +0530 | [diff] [blame] | 830 | OPERATION_BUILDER_CLASS, |
| 831 | |
| 832 | /** |
| 833 | * For add to list. |
| 834 | */ |
| 835 | ADD_TO_LIST, |
Bharat saraswal | af413b8 | 2016-07-14 15:18:20 +0530 | [diff] [blame] | 836 | } |
Bharat saraswal | 9745996 | 2016-02-20 21:57:16 +0530 | [diff] [blame] | 837 | } |