updated version 0.0.5

Author: XiaoPangxie732

README.md

@@ -14,7 +14,7 @@ Maven:
 <dependency>
   <groupId>cn.xiaopangxie732</groupId>
   <artifactId>mojang-api</artifactId>
-  <version>0.0.4</version>
+  <version>0.0.5</version>
 </dependency>
 ```
 

pom.xml

@@ -2,7 +2,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>cn.xiaopangxie732</groupId>
   <artifactId>mojang-api</artifactId>
-  <version>0.0.4</version>
+  <version>0.0.5</version>
   <name>Mojang Public API in Java</name>
   <description>Mojang Public API Java implementation</description>
   <url>https://github.com/XiaoPangxie732/MojangAPI-in-Java</url>

src/main/java/cn/xiaopangxie732/mojang_api/Servers.java

@@ -0,0 +1,20 @@
+package cn.xiaopangxie732.mojang_api;
+
+import cn.xiaopangxie732.mojang_api.util.Net;
+
+/**
+ * The class to get all blocked servers.
+ * @author XiaoPangxie732
+ * @since 0.0.5
+ */
+public class Servers {
+	/**
+	 * Get all blocked servers.
+	 * @return String array of all SHA1 hashes.
+	 * @since 0.0.5
+	 */
+	public String[] getBlockedServers() {
+		return Net.getConnection("https://sessionserver.mojang.com/blockedservers")
+				.split("\n");
+	}
+}

src/main/java/cn/xiaopangxie732/mojang_api/Skin.java

@@ -17,7 +17,6 @@
  */
 package cn.xiaopangxie732.mojang_api;
 
-import java.awt.image.BufferedImage;
 import java.io.ByteArrayOutputStream;
 import java.io.File;
 import java.io.IOException;
@@ -35,26 +34,42 @@
 
 import cn.xiaopangxie732.mojang_api.util.Auth;
 
+/**
+ * The class for operating the skin.
+ * @author XiaoPangxie732
+ * @since 0.0.5
+ */
 public class Skin {
 	/**
 	 * To change skin.
-	 * @param access_token The access token of UUID's account.
+	 * @param access_token The access token of UUID's account. can be get by using {@link Auth#getAccessToken(String, String)}
 	 * @param isSlim Skin is slim or not.
-	 * @param uuid UUID of player. can be get be using {@link UserName#UUIDAtNow(String)}
+	 * @param uuid UUID of the player. can be get by using {@link UserName#UUIDAtNow(String)}
 	 * @param uri The skin image path. if it is a local file, it needs add a prefix "file:///" and replace "\\" to "/"(Windows).
+	 * @throws IllegalStateException Throw when change skin failed.
+	 * @since 0.0.5
 	 */
 	public static void changeSkin(String access_token, boolean isSlim, String uuid, URI uri) {
 		try {
 			String response = Auth.postConnection("https://api.mojang.com/user/profile/" + uuid 
 					+"/skin", "model=" + (isSlim ? "slim" : "") + "&url=" + 
 			URLEncoder.encode(uri.toURL().toString(), "UTF-8"), access_token);
 			if(response != null)
-				throw new IllegalArgumentException("Failed to change skin");
+				throw new IllegalStateException("Failed to change skin");
 		} catch (UnsupportedEncodingException | MalformedURLException e) {
 			e.printStackTrace();
 		}
 	}
-	public static void changeSkinAndUpload(String access_token, boolean isSlim, String uuid, URI uri) {
+	/**
+	 * To change skin and upload.
+	 * @param access_token The access token of UUID's account. can be get by using {@link Auth#getAccessToken(String, String)}
+	 * @param isSlim Skin is slim or not.
+	 * @param uuid UUID of the player. can be get be using {@link UserName#UUIDAtNow(String)}
+	 * @param uri The skin image path. if it is a local file, it needs add a prefix "file:///" and replace "\\" to "/"(Windows).
+	 * @throws IllegalStateException Throw when change skin failed.
+	 * @since 0.0.5
+	 */
+	public static void changeSkinAndUpload(String access_token, boolean isSlim, String uuid, URI uri) throws IllegalStateException{
 		StringBuffer response = new StringBuffer();
 		HttpURLConnection connection = null;
 		try {
@@ -88,6 +103,8 @@ public static void changeSkinAndUpload(String access_token, boolean isSlim, Stri
 			while((i = in.read())!= -1) {
 				response.append((char)i);
 			}
+			if(response != null)
+				throw new IllegalStateException("Failed to change skin");
 		} catch(IOException ioe) {
 			InputStream err = connection.getErrorStream();
 			int i;
@@ -105,6 +122,13 @@ public static void changeSkinAndUpload(String access_token, boolean isSlim, Stri
 			connection.disconnect();
 		}
 	}
+	/**
+	 * Reset the skin.
+	 * @param access_token The access token of UUID's account. can be get by using {@link Auth#getAccessToken(String, String)}
+	 * @param uuid UUID of the player. can be get be using {@link UserName#UUIDAtNow(String)}
+	 * @throws IllegalStateException Throw when change skin failed.
+	 * @since 0.0.5
+	 */
 	public static void resetSkin(String access_token, String uuid) {
 		StringBuffer response = new StringBuffer();
 		HttpURLConnection connection = null;

src/main/java/cn/xiaopangxie732/mojang_api/Statistics.java

@@ -0,0 +1,77 @@
+package cn.xiaopangxie732.mojang_api;
+
+import com.google.gson.JsonArray;
+import com.google.gson.JsonObject;
+import com.google.gson.JsonParser;
+
+import cn.xiaopangxie732.mojang_api.util.Net;
+
+/**
+ * Get statistics on the sales.
+ * @author XiaoPangxie732
+ * @since 0.0.5
+ */
+public class Statistics {
+	private String response;
+	private JsonObject request = new JsonObject();
+	/**
+	 * All valid items.
+	 * @author XiaoPangxie732
+	 * @since 0.0.5
+	 */
+	public enum Items {
+		ITEM_SOLD_MINECRAFT,
+		PREPAID_CARD_REDEEMED_MINECRAFT, 
+		ITEM_SOLD_COBALT, 
+		ITEM_SOLD_SCROLLS;
+		@Override
+		public String toString() {
+			return name().toLowerCase();
+		}
+	}
+	/**
+	 * Construct a {@code Statistics} class.
+	 * @param items All items need to get sale statistics.
+	 * @since 0.0.5
+	 */
+	public Statistics(Items... items) {
+		JsonArray arr = new JsonArray();
+		for(Items i : items) {
+			arr.add(i.toString());
+		}
+		request.add("metricKeys", arr);
+	}
+	/**
+	 * Get sale statistics
+	 * @return this object that got sale statistics.
+	 * @since 0.0.5
+	 */
+	public Statistics get() {
+		response = Net.postConnection("https://api.mojang.com/orders/statistics", "application/json", request.toString());
+		return this;
+	}
+	/**
+	 * Get total sale number
+	 * @return The total sale number.
+	 * @since 0.0.5
+	 */
+	public int getTotalSales() {
+		return new JsonParser().parse(response).getAsJsonObject().get("total").getAsInt();
+	}
+	/**
+	 * Get last 24h sale number
+	 * @return The last 24h sale number.
+	 * @since 0.0.5
+	 */
+	public int getLast24hSales() {
+		return new JsonParser().parse(response).getAsJsonObject().get("last24h").getAsInt();
+	}
+	/**
+	 * Get sale velocity per seconds.
+	 * @return The sale velocity per seconds.
+	 * @since 0.0.5
+	 */
+	public float getSaleVelocityPerSeconds() {
+		return new JsonParser().parse(response).getAsJsonObject().get("saleVelocityPerSeconds").getAsFloat();
+	}
+}

src/main/java/cn/xiaopangxie732/mojang_api/Status.java

@@ -28,7 +28,7 @@
 import java.util.Properties;
 
 /**
- * To check the status of servers.
+ * Check the status of servers.
  * @author XiaoPangxie732
  * @since 0.0.1
  */

src/main/java/cn/xiaopangxie732/mojang_api/UUIDName.java

@@ -30,15 +30,17 @@
 import javax.imageio.ImageIO;
 
 /**
- * Used for UUID operating.
+ * The class for operating UUID.
  * @author XiaoPangxie732
+ * @since 0.0.4
  */
 public class UUIDName {
 
     /**
-     * To get UUID's name history.
+     * Get name history.
      * @param uuid The player's UUID. can be get be using {@link UserName#UUIDAtNow(String)}
      * @return The name history of the UUID.
+     * @since 0.0.4
      */
     public static String nameHistory(String uuid) {
         String url = "https://api.mojang.com/user/profiles/" + uuid + "/names";
@@ -51,9 +53,10 @@ public static String nameHistory(String uuid) {
         return result.toString();
     }
     /**
-     * To get this UUID's skin URL.
+     * Get skin URL.
      * @param uuid The UUID of player. can be get be using {@link UserName#UUIDAtNow(String)}
      * @return The skin URL of given UUID.
+     * @since 0.0.5
      */
     public static String getSkinURL(String uuid) {
     	return new JsonParser().parse(new String(Base64.getDecoder().decode(new JsonParser()
@@ -62,7 +65,7 @@ public static String getSkinURL(String uuid) {
     			.get("textures").getAsJsonObject().get("SKIN").getAsJsonObject().get("url").getAsString();
     }
     /**
-     * Store this UUID's skin png to desktop.
+     * Store skin image to desktop.
      * @param uuid The UUID of player. can be get be using {@link UserName#UUIDAtNow(String)}
      */
     public static void storeSkinImageToDesktop(String uuid) {

src/main/java/cn/xiaopangxie732/mojang_api/UserName.java

@@ -30,8 +30,9 @@
 import com.google.gson.JsonParser;
 
 /**
- * Used for username(playername) operating.
+ * The class for operating username(playername).
  * @author XiaoPangxie732
+ * @since 0.0.3
  */
 public class UserName {
 
@@ -66,7 +67,7 @@ public static String UUIDAtTime(String username, long timestamp) throws IllegalA
 	 * Get the UUID of this playername at now.
 	 * @param username The playername needs to get UUID.
 	 * @return The UUID of the name at now.
-	 * @throws UsernameOrTimestampInvalidException When the username is invalid.
+	 * @throws IllegalArgumentException When the username is invalid.
 	 * @since 0.0.3
 	 * @author XiaoPangxie732
 	 */
@@ -86,7 +87,7 @@ public static String UUIDAtNow(String username) throws IllegalArgumentException
 	 * This requires playername change at least once.
 	 * @param username The playername needs to get UUID.
 	 * @return The UUID of the name at the original.
-	 * @throws UsernameOrTimestampInvalidException When the username is invalid or playername wasn't change at least once.
+	 * @throws IllegalArgumentException When the username is invalid or playername wasn't change at least once.
 	 * @since 0.0.3
 	 * @author XiaoPangxie732
 	 */

src/main/java/cn/xiaopangxie732/mojang_api/util/Auth.java

@@ -27,7 +27,14 @@
 import com.google.gson.JsonParser;
 
 public class Auth {
-	public static String getAccessToken(String email, String password) {
+	/**
+	 * Get the access token of the account.
+	 * @param email email of the account.
+	 * @param password password of the account.
+	 * @throws IllegalStateException Throw when authentication error happened.
+	 * @return Access token of the account
+	 */
+	public static String getAccessToken(String email, String password) throws IllegalStateException{
 		return new JsonParser().parse(authConnection(email, password)).getAsJsonObject().get("accessToken").getAsString();
 	}
 	public static String postConnection(String url, String RequestParameters, String accessToken) {

src/main/java/cn/xiaopangxie732/mojang_api/util/package-info.java

@@ -17,5 +17,6 @@
  */
 /**
  * The utilities package of MojangAPI-in-Java.
+ * @since 0.0.2
  */
 package cn.xiaopangxie732.mojang_api.util;