Provided descriptions + todo for empty classes

src/main/java/de/rwu/easydrop/api/client/AmazonProductDataSource.java

@@ -50,8 +50,8 @@ public final class AmazonProductDataSource implements DataSource {
     }
 
     @Override
-    public ProductDTO getProductDTOById(final String productId) {
+    public ProductDTO getProductDTOById(final String productId) throws IllegalArgumentException {
-        JSONObject offer = null;
+        StringBuilder response = new StringBuilder();
         ProductDTO product = new ProductDTO(productId, DATA_ORIGIN);
 
         try {
@@ -73,27 +73,21 @@ public final class AmazonProductDataSource implements DataSource {
             if (responseCode == HttpURLConnection.HTTP_OK) {
                 reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
             } else {
-                return product;
+                throw new IllegalArgumentException(
+                        "Amazon API responded with error code " + responseCode);
             }
 
             String line;
-            StringBuilder response = new StringBuilder();
             while ((line = reader.readLine()) != null) {
                 response.append(line);
             }
             reader.close();
-
-            offer = new JSONObject(response.toString());
         } catch (IOException e) {
-            e.printStackTrace();
+            throw new IllegalArgumentException("Couldn't fulfill Amazon API request");
-        }
-
-        if (offer == null) {
-            return product;
         }
 
         try {
-            offer = offer.getJSONObject("featuredOffer");
+            JSONObject offer = new JSONObject(response.toString()).getJSONObject("featuredOffer");
 
             product.setDataOrigin(DATA_ORIGIN);
             product.setAvailable(offer
@@ -113,7 +107,7 @@ public final class AmazonProductDataSource implements DataSource {
                     .getJSONObject("merchant")
                     .getString("name"));
         } catch (JSONException e) {
-            return product;
+            // Pass, allow incomplete ProductDTO to pass for later validation
         }
 
         return product;

src/main/java/de/rwu/easydrop/data/connector/DatabaseConnector.java

@@ -1,5 +1,10 @@
 package de.rwu.easydrop.data.connector;
 
+/**
+ * Allows connecting to a SQLite Database.
+ *
+ * @todo implement
+ */
 public class DatabaseConnector {
 
 }

src/main/java/de/rwu/easydrop/data/dao/ProductDAO.java

@@ -1,5 +1,10 @@
 package de.rwu.easydrop.data.dao;
 
+/**
+ * Product data access object.
+ *
+ * @todo implement
+ */
 public class ProductDAO {
 
 }

src/main/java/de/rwu/easydrop/data/model/Product.java

@@ -1,5 +1,10 @@
 package de.rwu.easydrop.data.model;
 
+/**
+ * A Product
+ *
+ * @since 0.1.0
+ */
 public class Product {
 
 }

src/main/java/de/rwu/easydrop/service/mapping/ProductMapper.java

@@ -1,5 +1,13 @@
 package de.rwu.easydrop.service.mapping;
 
+/**
+ * Maps between Product, ProductDAO and ProductDTO.
+ *
+ * @since 0.1.0
+ * @see Product
+ * @see ProductDTO
+ * @see ProductDAO
+ */
 public class ProductMapper {
 
 }

src/main/java/de/rwu/easydrop/service/processing/OrderManager.java

@@ -1,5 +1,10 @@
 package de.rwu.easydrop.service.processing;
 
+/**
+ * Processes dropshipping orders
+ *
+ * @todo implement
+ */
 public class OrderManager {
 
 }

src/main/java/de/rwu/easydrop/service/validation/ProductValidator.java

@@ -1,5 +1,10 @@
 package de.rwu.easydrop.service.validation;
 
+/**
+ * Confirms validity of Product data
+ *
+ * @since 0.1.0
+ */
 public class ProductValidator {
 
 }