b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 1 | /* |
Brian O'Connor | 5ab426f | 2016-04-09 01:19:45 -0700 | [diff] [blame] | 2 | * Copyright 2016-present Open Networking Laboratory |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +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 | |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 19 | import java.lang.reflect.Constructor; |
| 20 | import java.lang.reflect.InvocationTargetException; |
| 21 | |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 22 | import org.junit.Rule; |
| 23 | import org.junit.Test; |
| 24 | import org.junit.rules.ExpectedException; |
| 25 | |
| 26 | import static org.hamcrest.core.Is.is; |
| 27 | import static org.hamcrest.core.IsNot.not; |
| 28 | import static org.junit.Assert.assertThat; |
| 29 | import static org.onosproject.yangutils.utils.io.impl.JavaDocGen.getJavaDoc; |
| 30 | import static org.onosproject.yangutils.utils.io.impl.JavaDocGen.JavaDocType.BUILDER_CLASS; |
| 31 | import static org.onosproject.yangutils.utils.io.impl.JavaDocGen.JavaDocType.BUILDER_INTERFACE; |
| 32 | import static org.onosproject.yangutils.utils.io.impl.JavaDocGen.JavaDocType.BUILD_METHOD; |
| 33 | import static org.onosproject.yangutils.utils.io.impl.JavaDocGen.JavaDocType.CONSTRUCTOR; |
| 34 | import static org.onosproject.yangutils.utils.io.impl.JavaDocGen.JavaDocType.DEFAULT_CONSTRUCTOR; |
| 35 | import static org.onosproject.yangutils.utils.io.impl.JavaDocGen.JavaDocType.GETTER_METHOD; |
| 36 | import static org.onosproject.yangutils.utils.io.impl.JavaDocGen.JavaDocType.IMPL_CLASS; |
| 37 | import static org.onosproject.yangutils.utils.io.impl.JavaDocGen.JavaDocType.INTERFACE; |
| 38 | import static org.onosproject.yangutils.utils.io.impl.JavaDocGen.JavaDocType.PACKAGE_INFO; |
| 39 | import static org.onosproject.yangutils.utils.io.impl.JavaDocGen.JavaDocType.SETTER_METHOD; |
| 40 | import static org.onosproject.yangutils.utils.io.impl.JavaDocGen.JavaDocType.TYPE_DEF_SETTER_METHOD; |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 41 | |
| 42 | /** |
| 43 | * Tests the java doc that is generated. |
| 44 | */ |
| 45 | public final class JavaDocGenTest { |
| 46 | |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 47 | private static final String TEST_NAME = "testName"; |
| 48 | private static final String END_STRING = " */\n"; |
| 49 | |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 50 | @Rule |
| 51 | public ExpectedException thrown = ExpectedException.none(); |
| 52 | |
| 53 | /** |
Bharat saraswal | c0e0484 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 54 | * This test case checks the content received for the builder class java doc. |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 55 | */ |
| 56 | @Test |
| 57 | public void builderClassGenerationTest() { |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 58 | String builderClassJavaDoc = getJavaDoc(BUILDER_CLASS, TEST_NAME, false, getStubPluginConfig()); |
Gaurav Agrawal | 338735b | 2016-04-18 18:53:11 +0530 | [diff] [blame] | 59 | assertThat(true, is(builderClassJavaDoc.contains("Represents the builder implementation of") |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 60 | && builderClassJavaDoc.contains(END_STRING))); |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 61 | } |
| 62 | |
| 63 | /** |
Bharat saraswal | c0e0484 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 64 | * This test case checks the content received for the builder interface ge java doc. |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 65 | */ |
| 66 | @Test |
| 67 | public void builderInterfaceGenerationTest() { |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 68 | String builderInterfaceJavaDoc = getJavaDoc(BUILDER_INTERFACE, TEST_NAME, false, getStubPluginConfig()); |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 69 | assertThat(true, |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 70 | is(builderInterfaceJavaDoc.contains("Builder for") |
| 71 | && builderInterfaceJavaDoc.contains(END_STRING))); |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 72 | } |
| 73 | |
| 74 | /** |
Bharat saraswal | c0e0484 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 75 | * This test case checks the content received for the build java doc. |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 76 | */ |
| 77 | @Test |
| 78 | public void buildGenerationTest() { |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 79 | String buildDoc = getJavaDoc(BUILD_METHOD, TEST_NAME, false, getStubPluginConfig()); |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 80 | assertThat(true, is(buildDoc.contains("Builds object of") && buildDoc.contains(END_STRING))); |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 81 | } |
| 82 | |
| 83 | /** |
| 84 | * A private constructor is tested. |
| 85 | * |
Bharat saraswal | 2f00b4b | 2016-03-04 20:08:09 +0530 | [diff] [blame] | 86 | * @throws SecurityException if any security violation is observed |
| 87 | * @throws NoSuchMethodException if when the method is not found |
| 88 | * @throws IllegalArgumentException if there is illegal argument found |
| 89 | * @throws InstantiationException if instantiation is provoked for the private constructor |
| 90 | * @throws IllegalAccessException if instance is provoked or a method is provoked |
| 91 | * @throws InvocationTargetException when an exception occurs by the method or constructor |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 92 | */ |
| 93 | @Test |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 94 | public void callPrivateConstructors() |
| 95 | throws SecurityException, NoSuchMethodException, IllegalArgumentException, |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 96 | InstantiationException, IllegalAccessException, InvocationTargetException { |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 97 | |
| 98 | Class<?>[] classesToConstruct = {JavaDocGen.class }; |
| 99 | for (Class<?> clazz : classesToConstruct) { |
| 100 | Constructor<?> constructor = clazz.getDeclaredConstructor(); |
| 101 | constructor.setAccessible(true); |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 102 | assertThat(null, not(constructor.newInstance())); |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 103 | } |
| 104 | } |
| 105 | |
| 106 | /** |
Bharat saraswal | c0e0484 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 107 | * This test case checks the content received for the constructor java doc. |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 108 | */ |
| 109 | @Test |
| 110 | public void constructorGenerationTest() { |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 111 | String constructorDoc = getJavaDoc(CONSTRUCTOR, TEST_NAME, false, getStubPluginConfig()); |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 112 | assertThat(true, |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 113 | is(constructorDoc.contains("Creates an instance of ") |
| 114 | && constructorDoc.contains("builder object of") |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 115 | && constructorDoc.contains("@param") && constructorDoc.contains("*/\n"))); |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 116 | } |
| 117 | |
| 118 | /** |
Bharat saraswal | c0e0484 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 119 | * This test case checks the content received for the default constructor java doc. |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 120 | */ |
| 121 | @Test |
| 122 | public void defaultConstructorGenerationTest() { |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 123 | String defaultConstructorDoc = getJavaDoc(DEFAULT_CONSTRUCTOR, TEST_NAME, false, getStubPluginConfig()); |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 124 | assertThat(true, is(defaultConstructorDoc.contains("Creates an instance of ") |
| 125 | && defaultConstructorDoc.contains(END_STRING))); |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 126 | } |
| 127 | |
| 128 | /** |
Bharat saraswal | c0e0484 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 129 | * This test case checks the content received for the getter java doc. |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 130 | */ |
| 131 | @Test |
| 132 | public void getterGenerationTest() { |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 133 | String getterJavaDoc = getJavaDoc(GETTER_METHOD, TEST_NAME, false, getStubPluginConfig()); |
| 134 | assertThat(true, |
| 135 | is(getterJavaDoc.contains("Returns the attribute") && getterJavaDoc.contains(END_STRING))); |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 136 | } |
| 137 | |
| 138 | /** |
Bharat saraswal | c0e0484 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 139 | * This test case checks the content received for the impl class java doc. |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 140 | */ |
| 141 | @Test |
| 142 | public void implClassGenerationTest() { |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 143 | String implClassJavaDoc = getJavaDoc(IMPL_CLASS, TEST_NAME, false, getStubPluginConfig()); |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 144 | assertThat(true, |
Gaurav Agrawal | 338735b | 2016-04-18 18:53:11 +0530 | [diff] [blame] | 145 | is(implClassJavaDoc.contains("Represents the implementation of") |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 146 | && implClassJavaDoc.contains(END_STRING))); |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 147 | } |
| 148 | |
| 149 | /** |
Bharat saraswal | c0e0484 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 150 | * This test case checks the content received for the interface java doc. |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 151 | */ |
| 152 | @Test |
| 153 | public void interfaceGenerationTest() { |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 154 | String interfaceJavaDoc = getJavaDoc(INTERFACE, TEST_NAME, false, getStubPluginConfig()); |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 155 | assertThat(true, |
Gaurav Agrawal | 338735b | 2016-04-18 18:53:11 +0530 | [diff] [blame] | 156 | is(interfaceJavaDoc.contains("Abstraction of an entity which represents the functionality of") |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 157 | && interfaceJavaDoc.contains(END_STRING))); |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 158 | } |
| 159 | |
| 160 | /** |
Bharat saraswal | c0e0484 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 161 | * This test case checks the content received for the package info java doc. |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 162 | */ |
| 163 | @Test |
| 164 | public void packageInfoGenerationTest() { |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 165 | String packageInfo = getJavaDoc(PACKAGE_INFO, TEST_NAME, false, getStubPluginConfig()); |
| 166 | assertThat(true, |
| 167 | is(packageInfo.contains("Implementation of YANG node") && packageInfo.contains(END_STRING))); |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 168 | } |
| 169 | |
| 170 | /** |
Bharat saraswal | c0e0484 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 171 | * This test case checks the content received for the package info java doc. |
| 172 | */ |
| 173 | @Test |
| 174 | public void packageInfoGenerationForChildNodeTest() { |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 175 | String packageInfo = getJavaDoc(PACKAGE_INFO, TEST_NAME, true, getStubPluginConfig()); |
Bharat saraswal | c0e0484 | 2016-05-12 13:16:57 +0530 | [diff] [blame] | 176 | assertThat(true, is(packageInfo.contains("Implementation of YANG node testName's children nodes") |
| 177 | && packageInfo.contains(END_STRING))); |
| 178 | } |
| 179 | |
| 180 | /** |
| 181 | * This test case checks the content received for the setter java doc. |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 182 | */ |
| 183 | @Test |
| 184 | public void setterGenerationTest() { |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 185 | String setterJavaDoc = getJavaDoc(SETTER_METHOD, TEST_NAME, false, getStubPluginConfig()); |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 186 | assertThat(true, |
| 187 | is(setterJavaDoc.contains("Returns the builder object of") && setterJavaDoc.contains(END_STRING))); |
b.janani | 68c55e1 | 2016-02-24 12:23:03 +0530 | [diff] [blame] | 188 | } |
Bharat saraswal | 2f00b4b | 2016-03-04 20:08:09 +0530 | [diff] [blame] | 189 | |
| 190 | /** |
| 191 | * This test case checks the content received for the typedef setter java doc. |
| 192 | */ |
| 193 | @Test |
| 194 | public void typeDefSetterGenerationTest() { |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 195 | String typeDefSetter = getJavaDoc(TYPE_DEF_SETTER_METHOD, TEST_NAME, false, getStubPluginConfig()); |
Bharat saraswal | 6ef0b76 | 2016-04-05 12:45:45 +0530 | [diff] [blame] | 196 | assertThat(true, is(typeDefSetter.contains("Sets the value of") && typeDefSetter.contains(END_STRING))); |
Bharat saraswal | 2f00b4b | 2016-03-04 20:08:09 +0530 | [diff] [blame] | 197 | } |
Bharat saraswal | 33dfa01 | 2016-05-17 19:59:16 +0530 | [diff] [blame] | 198 | |
| 199 | /** |
| 200 | * Returns stub pluginConfig. |
| 201 | * |
| 202 | * @return stub pluginConfig |
| 203 | */ |
| 204 | private YangPluginConfig getStubPluginConfig() { |
| 205 | YangPluginConfig pluginConfig = new YangPluginConfig(); |
| 206 | pluginConfig.setConflictResolver(null); |
| 207 | return pluginConfig; |
| 208 | } |
Gaurav Agrawal | 8a5af14 | 2016-06-15 13:58:01 +0530 | [diff] [blame] | 209 | } |