Added java doc comments

Author: Mohamed Bilal

src/test/java/com/microsoft/graph/serializer/CalendarSerializerTests.java

@@ -16,6 +16,10 @@
  */
 public class CalendarSerializerTests {
 
+	/**
+	 * Validate if a calendar date instance could be serialized
+	 * @throws Exception if calendar couldn't be serialized
+	 */
 	@Test
 	public void testDateSerialization() throws Exception {
 		Calendar calendar = Calendar.getInstance();
@@ -25,7 +29,11 @@ public void testDateSerialization() throws Exception {
 		assertNotNull(actual);
 		assertEquals(expected, actual);
 	}
-
+	
+	/**
+	 * Validate if a date without milliseconds and offset could be deserialized
+	 * @throws Exception if date is not parsable
+	 */
 	@Test
 	public void testSimpleDateTimeDeserialization() throws Exception {
 
@@ -44,6 +52,10 @@ public void testSimpleDateTimeDeserialization() throws Exception {
 		TimeZone.setDefault(defaultTimeZone);
 	}
 
+	/**
+	 * Validate if date with UTC timezone (z) could be deserialized
+	 * @throws Exception if date is not parsable
+	 */
 	@Test
 	public void testUTCSimpleDateTimeDeserialization() throws Exception {
 		String datetime = "2019-06-21T17:12:35Z";
@@ -54,6 +66,10 @@ public void testUTCSimpleDateTimeDeserialization() throws Exception {
 		assertEquals(expected.getTimeInMillis(), actual.getTimeInMillis());
 	}
 
+	/**
+	 * Validate if date with UTC timezone (z) and milliseconds could be deserialized
+	 * @throws Exception if date is not parsable
+	 */
 	@Test
 	public void testUTCDateTimeWithMillisDeserialization() throws Exception {
 		String datetime = "2019-06-21T17:12:35.1385912Z";
@@ -64,6 +80,10 @@ public void testUTCDateTimeWithMillisDeserialization() throws Exception {
 		assertEquals(expected.getTimeInMillis(), actual.getTimeInMillis());
 	}
 
+	/**
+	 * Validate if date with UTC offset (+00:00) could be deserialized
+	 * @throws Exception if date is not parsable
+	 */
 	@Test
 	public void testUTCDateTimeInOffsetFormatDeserialization() throws Exception {
 		String datetime = "2019-06-21T17:12:35+00:00";
@@ -74,6 +94,10 @@ public void testUTCDateTimeInOffsetFormatDeserialization() throws Exception {
 		assertEquals(expected.getTimeInMillis(), actual.getTimeInMillis());
 	}
 
+	/**
+	 * Validate if date with UTC offset (+00:00) and milliseconds could be deserialized
+	 * @throws Exception if date is not parsable
+	 */
 	@Test
 	public void testUTCDateTimeWithMillisAndOffsetDeserialization() throws Exception {
 		String datetime = "2019-06-21T17:12:35.1385912+00:00";
@@ -84,6 +108,10 @@ public void testUTCDateTimeWithMillisAndOffsetDeserialization() throws Exception
 		assertEquals(expected.getTimeInMillis(), actual.getTimeInMillis());
 	}
 
+	/**
+	 * Validate if date with different UTC offset (+0000) could be deserialized
+	 * @throws Exception if date is not parsable
+	 */
 	@Test
 	public void testUTCDateTimeInNonstandardOffsetFormatDeserialization() throws Exception {
 		String datetime = "2019-06-21T17:12:35+0000";
@@ -94,6 +122,10 @@ public void testUTCDateTimeInNonstandardOffsetFormatDeserialization() throws Exc
 		assertEquals(expected.getTimeInMillis(), actual.getTimeInMillis());
 	}
 
+	/**
+	 * Validate if date with positive timezone offset (+07:00) could be deserialized
+	 * @throws Exception if date is not parsable
+	 */
 	@Test
 	public void testDateTimePositiveOffsetFormatDeserialization() throws Exception {
 		String datetime = "2019-06-21T17:12:35+07:00";
@@ -104,6 +136,10 @@ public void testDateTimePositiveOffsetFormatDeserialization() throws Exception {
 		assertEquals(expected.getTimeInMillis(), actual.getTimeInMillis());
 	}
 
+	/**
+	 * Validate if date with positive timezone offset (+07:00) and milliseconds could be deserialized
+	 * @throws Exception if date is not parsable
+	 */
 	@Test
 	public void testDateTimeWithMillisAndPositiveOffsetDeserialization() throws Exception {
 		String datetime = "2019-06-21T17:12:35.1385912+07:00";
@@ -114,6 +150,10 @@ public void testDateTimeWithMillisAndPositiveOffsetDeserialization() throws Exce
 		assertEquals(expected.getTimeInMillis(), actual.getTimeInMillis());
 	}
 
+	/**
+	 * Validate if date with positive timezone offset in different format (+0700) could be deserialized
+	 * @throws Exception if date is not parsable
+	 */
 	@Test
 	public void testUTCDateTimeInNonstandardPositiveOffsetFormatDeserialization() throws Exception {
 		String datetime = "2019-06-21T17:12:35+0700";
@@ -124,6 +164,10 @@ public void testUTCDateTimeInNonstandardPositiveOffsetFormatDeserialization() th
 		assertEquals(expected.getTimeInMillis(), actual.getTimeInMillis());
 	}
 
+	/**
+	 * Validate if date with negative timezone offset (-07:00) could be deserialized
+	 * @throws Exception if date is not parsable
+	 */
 	@Test
 	public void testDateTimeNegativeOffsetFormatDeserialization() throws Exception {
 		String datetime = "2019-06-21T17:12:35-07:00";
@@ -134,6 +178,10 @@ public void testDateTimeNegativeOffsetFormatDeserialization() throws Exception {
 		assertEquals(expected.getTimeInMillis(), actual.getTimeInMillis());
 	}
 
+	/**
+	 * Validate if date with negative timezone offset (-07:00) and milliseconds could be deserialized
+	 * @throws Exception if date is not parsable
+	 */
 	@Test
 	public void testDateTimeWithMillisAndNegativeOffsetDeserialization() throws Exception {
 		String datetime = "2019-06-21T17:12:35.1385912-07:00";
@@ -144,6 +192,10 @@ public void testDateTimeWithMillisAndNegativeOffsetDeserialization() throws Exce
 		assertEquals(expected.getTimeInMillis(), actual.getTimeInMillis());
 	}
 
+	/**
+	 * Validate if date with negative timezone offset in different format (-0700) could be deserialized
+	 * @throws Exception if date is not parsable
+	 */
 	@Test
 	public void testUTCDateTimeInNonstandardNegativeOffsetFormatDeserialization() throws Exception {
 		String datetime = "2019-06-21T17:12:35-0700";