Add files via upload

Author: XiaoPangxie732

UserName.java

@@ -0,0 +1,98 @@
+package cn.xiaopangxie732.mojang_api;
+
+import java.util.Properties;
+
+import com.google.gson.Gson;
+import com.google.gson.JsonSyntaxException;
+
+import cn.xiaopangxie732.mojang_api.exceptions.UsernameOrTimestampInvalidException;
+import cn.xiaopangxie732.mojang_api.util.Net;
+
+/**
+ * To get UUID of username(playername).
+ * @author XiaoPangxie732
+ */
+public class UserName {
+
+	private static String url = "https://api.mojang.com/users/profiles/minecraft/";
+	private static Gson json = new Gson();
+
+	/**
+	 * Get the UUID of this playername 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 {
+			response = Net.getConnection(furl);
+		} catch(IllegalArgumentException ex) {
+			throw new UsernameOrTimestampInvalidException("Username \"" + username + "\" is invalid or on timestamp \"" + Long.toString(timestamp).replace("0", "Original") + "\" the username wasn't change.");
+		}
+		Properties result = json.fromJson(response, Properties.class);
+		if(!result.getProperty("error", "noError").equals("noError"))
+			throw new IllegalArgumentException(result.getProperty("errorMessage"));
+		return result.getProperty("id");
+	}
+
+	/**
+	 * 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.
+	 * @since 0.0.3
+	 * @author XiaoPangxie732
+	 */
+	public static String UUIDAtNow(String username) throws UsernameOrTimestampInvalidException {
+		String furl = url + username;
+		String response;
+		try {
+			response = Net.getConnection(furl);
+		} catch (IllegalArgumentException e) {
+			throw new UsernameOrTimestampInvalidException("Username \"" + username + "\" is invalid");
+		}
+		Properties result = json.fromJson(response, Properties.class);
+		return result.getProperty("id");
+	}
+
+	/**
+	 * Get the UUID of this playername 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);
+	}
+
+	/**
+	 * Get the UUID of the playername(s).
+	 * @param usernames The playername(s) needs to get UUID.
+	 * @return The UUID(s) of the playername(s).
+	 * @throws IllegalArgumentException When the request names reached more than 100.
+	 * @throws IllegalArgumentException when any of the usernames is <code>null</code> or <code>""</code>.
+	 */
+	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;
+		try {
+			names = json.fromJson(response, Properties[].class);
+		} catch (JsonSyntaxException e) {
+			throw new IllegalArgumentException(json.fromJson(response, Properties.class).getProperty("errorMessage"));
+		}
+		String result = "";
+		for(Properties output : names) {
+			result += output.getProperty("name") + "=" + output.getProperty("id") + "\n";
+		}
+		return result;
+	}
+}