Add files via upload

Author: XiaoPangxie732

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

@@ -24,6 +24,7 @@ public Status() {
 	 * @throws NullPointerException When the server is <code>null</code>.
 	 * @param server Which server needs to check the status.
 	 * @return The status of this server.
+	 * @since 0.0.1
 	 * @author XiaoPangxie732
 	 */
 	public StatusType getStatus(StatusServer server) throws NullPointerException {
@@ -42,6 +43,7 @@ public StatusType getStatus(StatusServer server) throws NullPointerException {
 	}
 	/**
 	 * To fresh Mojang's servers status.
+	 * @since 0.0.2
 	 * @author XiaoPangxie732
 	 */
 	public void fresh() {

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

@@ -17,7 +17,17 @@ public class UserName {
 	private static String url = "https://api.mojang.com/users/profiles/minecraft/";
 	private static Gson json = new Gson();
 
-	public static String UUIDAtTime(String username, long timestamp) {
+	/**
+	 * Get the UUID of this player name at a time.
+	 * @param username The playername needs to get UUID.
+	 * @param timestamp A UNIX timestamp (without milliseconds).
+	 * @return The UUID of the name at the timestamp provided.
+	 * @throws IllegalArgumentException When the timestamp is invalid.
+	 * @throws UsernameOrTimestampInvalidException When the username is invalid or the timestamp has some error(or playername wasn't change at least once).
+	 * @since 0.0.3
+	 * @author XiaoPangxie732
+	 */
+	public static String UUIDAtTime(String username, long timestamp) throws UsernameOrTimestampInvalidException, IllegalArgumentException {
 		String furl = url + username + "?at=" + timestamp;
 		String response = null;
 		try {
@@ -31,7 +41,15 @@ public static String UUIDAtTime(String username, long timestamp) {
 		return result.getProperty("id");
 	}
 
-	public static String UUIDAtNow(String username) {
+	/**
+	 * Get the UUID of this player name 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.
+	 * @since 0.0.3
+	 * @author XiaoPangxie732
+	 */
+	public static String UUIDAtNow(String username) throws UsernameOrTimestampInvalidException {
 		String furl = url + username;
 		String response;
 		try {
@@ -43,11 +61,19 @@ public static String UUIDAtNow(String username) {
 		return result.getProperty("id");
 	}
 
-	public static String UUIDAtOriginal(String username) {
+	/**
+	 * Get the UUID of this player name at original time (timestamp=0).
+	 * @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.
+	 * @since 0.0.3
+	 * @author XiaoPangxie732
+	 */
+	public static String UUIDAtOriginal(String username) throws UsernameOrTimestampInvalidException{
 		return UUIDAtTime(username, 0);
 	}
 
-	public static String UUIDOfNames(String... usernames) {
+	public static String UUIDOfNames(String... usernames) throws IllegalArgumentException {
 		if(usernames.length > 100) throw new IllegalArgumentException("Too more names! (" + usernames.length + "/100)");
 		String response = Net.postConnection("https://api.mojang.com/profiles/minecraft", "application/json", json.toJson(usernames));
 		Properties[] names = null;

src/main/java/cn/xiaopangxie732/mojang_api/exceptions/UsernameOrTimestampInvalidException.java

@@ -2,6 +2,7 @@
 
 /**
  * Throw when the user name on that timestamp has not changed, or the username is invalid.
+ * @since 0.0.3
  * @author XiaoPangxie732
  */
 public class UsernameOrTimestampInvalidException extends RuntimeException {

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

@@ -1,5 +1,6 @@
 /**
  * The exception package.
+ * @since 0.0.2
  * @author XiaoPangxie732
  */
 package cn.xiaopangxie732.mojang_api.exceptions;

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

@@ -1,5 +1,6 @@
 /**
  * The MojangAPI-in-Java main package
+ * @since 0.0.1
  * @author XiaoPangxie732
  */
 package cn.xiaopangxie732.mojang_api;

src/main/java/cn/xiaopangxie732/mojang_api/status/StatusServer.java

@@ -2,6 +2,7 @@
 
 /**
  * This class lists all the servers that can check the status.
+ * @since 0.0.1
  * @author XiaoPangxie732
  */
 public enum StatusServer {

src/main/java/cn/xiaopangxie732/mojang_api/status/StatusType.java

@@ -2,6 +2,7 @@
 
 /**
  * List all status type.
+ * @since 0.0.1
  * @author XiaoPangxie732
  */
 public enum StatusType {

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

@@ -1,5 +1,6 @@
 /**
  * The <code>Status</code> package.
+ * @since 0.0.2
  * @author XiaoPangxie732
  */
 package cn.xiaopangxie732.mojang_api.status;