Merge pull request #23 from dec4234/22-throwing

22 throwing

Author: dec4234

pom.xml

@@ -1,10 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-  ~ Copyright (c) dec4234 2021. Access is granted, without any express warranties or guarentees of
-  ~ any kind,  to all wishing to use this software for their benefit. No one may specifically claim credit, or
-  ~ ownership of this software without the explicit permission of the author.
+  ~ Copyright (c) 2024. dec4234
+  ~ A standard open MIT license applies. Modififcation and usage permitted with credit. No warranties or express guarentees are given in any way.
   ~
-  ~ GitHub -> https://github.com/dec4234/JavaDestinyAPI
+  ~ Github -> https://github.com/dec4234/JavaDestinyAPI
   -->
 
 <project xmlns="http://maven.apache.org/POM/4.0.0"
@@ -18,7 +17,7 @@
     <packaging>jar</packaging>
 
     <name>JavaDestinyAPI</name>
-    <description>A Java wrapper for bungie.net platform api, allowing users to get data about the video games Destiny and Destiny 2</description>
+    <description>A Java wrapper for bungie.net platform API, allowing users to get data about the video games Destiny and Destiny 2</description>
     <url>https://github.com/dec4234/JavaDestinyAPI</url>
 
     <licenses>
@@ -51,7 +50,7 @@
         <dependency>
             <groupId>com.google.code.gson</groupId>
             <artifactId>gson</artifactId>
-            <version>2.8.6</version>
+            <version>2.8.9</version>
         </dependency>
         <dependency>
             <groupId>org.jetbrains</groupId>
@@ -62,7 +61,7 @@
         <dependency>
             <groupId>org.apache.maven.plugins</groupId>
             <artifactId>maven-compiler-plugin</artifactId>
-            <version>3.8.1</version>
+            <version>3.11.0</version>
         </dependency>
     </dependencies>
 

src/main/java/net/dec4234/javadestinyapi/exceptions/APIException.java

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2024. dec4234
+ * A standard open MIT license applies. Modififcation and usage permitted with credit. No warranties or express guarentees are given in any way.
+ *
+ * Github -> https://github.com/dec4234/JavaDestinyAPI
+ */
+
+package net.dec4234.javadestinyapi.exceptions;
+
+/**
+ * Base class for all exceptions generated when an issue occurs in the request pipeline to Bungie.
+ * This most common reason for this error would be when the API is offline, and all objects are misparsed.
+ */
+public abstract class APIException extends Exception {
+
+    public APIException() {
+
+    }
+
+    public APIException(String errorMessage) {
+        super(errorMessage);
+    }
+
+    public APIException(Exception e) {
+        super(e);
+    }
+}

src/main/java/net/dec4234/javadestinyapi/exceptions/APIOfflineException.java

@@ -1,17 +1,16 @@
 /*
- * Copyright (c) dec4234 2021. Access is granted, without any express warranties or guarantees of
- * any kind,  to all wishing to use this software for their benefit. No one may specifically claim credit, or
- * ownership of this software without the explicit permission of the author.
+ * Copyright (c) 2024. dec4234
+ * A standard open MIT license applies. Modififcation and usage permitted with credit. No warranties or express guarentees are given in any way.
  *
- * GitHub -> https://github.com/dec4234/JavaDestinyAPI
+ * Github -> https://github.com/dec4234/JavaDestinyAPI
  */
 
 package net.dec4234.javadestinyapi.exceptions;
 
 /**
  * Indicates that the request returned error code 5  (The API has been disabled by Bungie)
  */
-public class APIOfflineException extends Exception {
+public class APIOfflineException extends APIException {
 
 	public APIOfflineException(String returnMessage) {
 		super("The Bungie API returned this message: " + returnMessage);

src/main/java/net/dec4234/javadestinyapi/exceptions/AccessTokenExpiredException.java

@@ -0,0 +1,14 @@
+/*
+ * Copyright (c) 2024. dec4234
+ * A standard open MIT license applies. Modififcation and usage permitted with credit. No warranties or express guarentees are given in any way.
+ *
+ * Github -> https://github.com/dec4234/JavaDestinyAPI
+ */
+
+package net.dec4234.javadestinyapi.exceptions;
+
+/**
+ * Self explanatory. The access token needs to be regenerated using the refresh token.
+ */
+public class AccessTokenExpiredException extends APIException{
+}

src/main/java/net/dec4234/javadestinyapi/exceptions/AccessTokenInvalidException.java

@@ -0,0 +1,15 @@
+/*
+ * Copyright (c) 2024. dec4234
+ * A standard open MIT license applies. Modififcation and usage permitted with credit. No warranties or express guarentees are given in any way.
+ *
+ * Github -> https://github.com/dec4234/JavaDestinyAPI
+ */
+
+package net.dec4234.javadestinyapi.exceptions;
+
+public class ConnectionException extends APIException {
+
+    public ConnectionException(Exception exception) {
+        super(exception);
+    }
+}

src/main/java/net/dec4234/javadestinyapi/exceptions/ConnectionException.java

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2024. dec4234
+ * A standard open MIT license applies. Modififcation and usage permitted with credit. No warranties or express guarentees are given in any way.
+ *
+ * Github -> https://github.com/dec4234/JavaDestinyAPI
+ */
+
+package net.dec4234.javadestinyapi.exceptions;
+
+/**
+ * When a token is missing or wrong, or some other pre-condition was not met that was needed to execute a request.
+ * This is a generic error, check the associated error message for more information.
+ */
+public class InvalidConditionException extends APIException {
+
+    public InvalidConditionException(String message) {
+        super(message);
+    }
+}

src/main/java/net/dec4234/javadestinyapi/exceptions/InvalidConditionException.java

@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) 2024. dec4234
+ * A standard open MIT license applies. Modififcation and usage permitted with credit. No warranties or express guarentees are given in any way.
+ *
+ * Github -> https://github.com/dec4234/JavaDestinyAPI
+ */
+
+package net.dec4234.javadestinyapi.exceptions;
+
+import com.google.gson.JsonSyntaxException;
+
+/**
+ * Malformed or non-json content found where JSON was expected. Usually at an API endpoint.
+ */
+public class JsonParsingError extends APIException {
+
+    public JsonParsingError(String message) {
+        super(message);
+    }
+
+    public JsonParsingError(JsonSyntaxException exception) {
+        super(exception);
+    }
+}

src/main/java/net/dec4234/javadestinyapi/exceptions/JsonParsingError.java

@@ -0,0 +1,20 @@
+/*
+ * Copyright (c) 2024. dec4234
+ * A standard open MIT license applies. Modififcation and usage permitted with credit. No warranties or express guarentees are given in any way.
+ *
+ * Github -> https://github.com/dec4234/JavaDestinyAPI
+ */
+
+package net.dec4234.javadestinyapi.exceptions;
+
+/**
+ * You either have insufficient permission to attempt this OAuth action, or you forgot to authorize yourself.
+ * Alternatively, the access and/or refresh token has expired
+ * See {@link net.dec4234.javadestinyapi.utils.framework.OAuthFlow}
+ */
+public class OAuthUnauthorizedException extends APIException {
+
+    public OAuthUnauthorizedException(String message) {
+        super(message);
+    }
+}

src/main/java/net/dec4234/javadestinyapi/exceptions/OAuthUnauthorizedException.java

@@ -0,0 +1,17 @@
+/*
+ * Copyright (c) 2024. dec4234
+ * A standard open MIT license applies. Modififcation and usage permitted with credit. No warranties or express guarentees are given in any way.
+ *
+ * Github -> https://github.com/dec4234/JavaDestinyAPI
+ */
+
+package net.dec4234.javadestinyapi.exceptions;
+
+/**
+ * The name is self-expanatory. The refresh token normally used to generate a new access token has expired since it
+ * hasn't been refreshed in the past 90 days or it has been 1 year since the last oauth.
+ * See {@link net.dec4234.javadestinyapi.utils.framework.OAuthFlow} to generate a new one.
+ */
+public class RefreshTokenExpiredException extends APIException {
+
+}