[OLINGO-530] Javadoc and cleanup unused imports

fit/src/test/java/org/apache/olingo/fit/v3/BatchTestITCase.java

@@ -301,7 +301,7 @@ public class BatchTestITCase extends AbstractTestITCase {
   }
 
   @Test
-  @SuppressWarnings("unchecked")
+  @SuppressWarnings({ "unchecked", "rawtypes" })
   public void batchRequest() throws EdmPrimitiveTypeException {
     // create your request
     final ODataBatchRequest request = client.getBatchRequestFactory().getBatchRequest(testStaticServiceRootURL);

fit/src/test/java/org/apache/olingo/fit/v4/BatchTestITCase.java

@@ -390,7 +390,7 @@ public class BatchTestITCase extends AbstractTestITCase {
   }
 
   @Test
-  @SuppressWarnings({"unchecked"})
+  @SuppressWarnings({"unchecked", "rawtypes"})
   public void batchRequest() throws EdmPrimitiveTypeException {
     // create your request
     final ODataBatchRequest request = client.getBatchRequestFactory().getBatchRequest(testStaticServiceRootURL);

lib/server-api/src/main/java/org/apache/olingo/server/api/deserializer/ODataDeserializer.java

@@ -24,10 +24,27 @@ import org.apache.olingo.commons.api.data.Entity;
 import org.apache.olingo.commons.api.data.EntitySet;
 import org.apache.olingo.commons.api.edm.EdmEntityType;
 
+/**
+ * Deserializer on OData server side.
+ */
 public interface ODataDeserializer {
 
+  /**
+   * Deserializes an entity stream into an {@link Entity} object.
+   * @param stream
+   * @param edmEntityType
+   * @return deserialized {@link Entity} object
+   * @throws DeserializerException
+   */
   Entity entity(InputStream stream, EdmEntityType edmEntityType) throws DeserializerException;
 
+  /**
+   * Deserializes an entity collection stream into an {@link EntitySet} object.
+   * @param stream
+   * @param edmEntityType
+   * @return deserialized {@link EntitySet} object
+   * @throws DeserializerException
+   */
   EntitySet entityCollection(InputStream stream, EdmEntityType edmEntityType) throws DeserializerException;
 
 }