Merge branch 'release/8.3.0'

spotify-web-api-java · Oct 5, 2023 · 4de925a · 4de925a
2 parents ddae558 + f36a2a9
commit 4de925a
Show file tree

Hide file tree

Showing 953 changed files with 3,780 additions and 2,909 deletions.
diff --git a/README.md b/README.md
@@ -35,7 +35,7 @@ Latest official release:
 <dependency>
   <groupId>se.michaelthelin.spotify</groupId>
   <artifactId>spotify-web-api-java</artifactId>
-  <version>8.2.1</version>
+  <version>8.3.0</version>
 </dependency>
 ```
 
@@ -52,7 +52,7 @@ Latest snapshot:
 
 Latest official release:
 ```Gradle
-implementation 'se.michaelthelin.spotify:spotify-web-api-java:8.2.1'
+implementation 'se.michaelthelin.spotify:spotify-web-api-java:8.3.0'
 ```
 
 Latest snapshot:

diff --git a/docs/allclasses-index.html b/docs/allclasses-index.html
diff --git a/docs/allpackages-index.html b/docs/allpackages-index.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-<!-- Generated by javadoc (21) on Thu Sep 28 02:10:13 CEST 2023 -->
-<title>All Packages (Spotify Web API Java Client 8.2.1 API)</title>
+<!-- Generated by javadoc (21) on Thu Oct 05 10:04:39 CEST 2023 -->
+<title>All Packages (Spotify Web API Java Client 8.3.0 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2023-09-28">
+<meta name="dc.created" content="2023-10-05">
 <meta name="description" content="package index">
 <meta name="generator" content="javadoc/AllPackagesIndexWriter">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">

diff --git a/docs/constant-values.html b/docs/constant-values.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-<!-- Generated by javadoc (21) on Thu Sep 28 02:10:13 CEST 2023 -->
-<title>Constant Field Values (Spotify Web API Java Client 8.2.1 API)</title>
+<!-- Generated by javadoc (21) on Thu Oct 05 10:04:39 CEST 2023 -->
+<title>Constant Field Values (Spotify Web API Java Client 8.3.0 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2023-09-28">
+<meta name="dc.created" content="2023-10-05">
 <meta name="description" content="summary of constants">
 <meta name="generator" content="javadoc/ConstantsSummaryWriterImpl">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">

diff --git a/docs/help-doc.html b/docs/help-doc.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-<!-- Generated by javadoc (21) on Thu Sep 28 02:10:13 CEST 2023 -->
-<title>API Help (Spotify Web API Java Client 8.2.1 API)</title>
+<!-- Generated by javadoc (21) on Thu Oct 05 10:04:39 CEST 2023 -->
+<title>API Help (Spotify Web API Java Client 8.3.0 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2023-09-28">
+<meta name="dc.created" content="2023-10-05">
 <meta name="description" content="help">
 <meta name="generator" content="javadoc/HelpWriter">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">

diff --git a/docs/index-all.html b/docs/index-all.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-<!-- Generated by javadoc (21) on Thu Sep 28 02:10:13 CEST 2023 -->
-<title>Index (Spotify Web API Java Client 8.2.1 API)</title>
+<!-- Generated by javadoc (21) on Thu Oct 05 10:04:39 CEST 2023 -->
+<title>Index (Spotify Web API Java Client 8.3.0 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2023-09-28">
+<meta name="dc.created" content="2023-10-05">
 <meta name="description" content="index">
 <meta name="generator" content="javadoc/IndexWriter">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
@@ -4532,6 +4532,8 @@ <h2 class="title" id="I:G">G</h2>
 </dd>
 <dt><a href="se/michaelthelin/spotify/exceptions/detailed/TooManyRequestsException.html#getRetryAfter()" class="member-name-link">getRetryAfter()</a> - Method in exception class se.michaelthelin.spotify.exceptions.detailed.<a href="se/michaelthelin/spotify/exceptions/detailed/TooManyRequestsException.html" title="class in se.michaelthelin.spotify.exceptions.detailed">TooManyRequestsException</a></dt>
 <dd>&nbsp;</dd>
+<dt><a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html#getRetryInterval(org.apache.hc.core5.http.HttpResponse,int,org.apache.hc.core5.http.protocol.HttpContext)" class="member-name-link">getRetryInterval(HttpResponse, int, HttpContext)</a> - Method in class se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html" title="class in se.michaelthelin.spotify">SpotifyHttpRequestRetryStrategy</a></dt>
+<dd>&nbsp;</dd>
 <dt><a href="se/michaelthelin/spotify/model_objects/miscellaneous/AudioAnalysisTrack.html#getRhythmString()" class="member-name-link">getRhythmString()</a> - Method in class se.michaelthelin.spotify.model_objects.miscellaneous.<a href="se/michaelthelin/spotify/model_objects/miscellaneous/AudioAnalysisTrack.html" title="class in se.michaelthelin.spotify.model_objects.miscellaneous">AudioAnalysisTrack</a></dt>
 <dd>
 <div class="block">Get the rhythm string of the track.</div>
@@ -5241,6 +5243,8 @@ <h2 class="title" id="I:G">G</h2>
 </dl>
 <h2 class="title" id="I:H">H</h2>
 <dl class="index">
+<dt><a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html#handleAsIdempotent(org.apache.hc.core5.http.HttpRequest)" class="member-name-link">handleAsIdempotent(HttpRequest)</a> - Method in class se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html" title="class in se.michaelthelin.spotify">SpotifyHttpRequestRetryStrategy</a></dt>
+<dd>&nbsp;</dd>
 <dt><a href="se/michaelthelin/spotify/model_objects/AbstractModelObject.JsonUtil.html#hasAndNotNull(com.google.gson.JsonObject,java.lang.String)" class="member-name-link">hasAndNotNull(JsonObject, String)</a> - Method in class se.michaelthelin.spotify.model_objects.<a href="se/michaelthelin/spotify/model_objects/AbstractModelObject.JsonUtil.html" title="class in se.michaelthelin.spotify.model_objects">AbstractModelObject.JsonUtil</a></dt>
 <dd>
 <div class="block">Check whether the supplied JSON object contains data in the given member, which is not <code>null</code>.</div>
@@ -6740,6 +6744,10 @@ <h2 class="title" id="I:R">R</h2>
 </dd>
 <dt><a href="se/michaelthelin/spotify/enums/Action.html#RESUMING" class="member-name-link">RESUMING</a> - Enum constant in enum class se.michaelthelin.spotify.enums.<a href="se/michaelthelin/spotify/enums/Action.html" title="enum class in se.michaelthelin.spotify.enums">Action</a></dt>
 <dd>&nbsp;</dd>
+<dt><a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html#retryRequest(org.apache.hc.core5.http.HttpRequest,java.io.IOException,int,org.apache.hc.core5.http.protocol.HttpContext)" class="member-name-link">retryRequest(HttpRequest, IOException, int, HttpContext)</a> - Method in class se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html" title="class in se.michaelthelin.spotify">SpotifyHttpRequestRetryStrategy</a></dt>
+<dd>&nbsp;</dd>
+<dt><a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html#retryRequest(org.apache.hc.core5.http.HttpResponse,int,org.apache.hc.core5.http.protocol.HttpContext)" class="member-name-link">retryRequest(HttpResponse, int, HttpContext)</a> - Method in class se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html" title="class in se.michaelthelin.spotify">SpotifyHttpRequestRetryStrategy</a></dt>
+<dd>&nbsp;</dd>
 </dl>
 <h2 class="title" id="I:S">S</h2>
 <dl class="index">
@@ -9108,6 +9116,38 @@ <h2 class="title" id="I:S">S</h2>
 </dd>
 <dt><a href="se/michaelthelin/spotify/SpotifyHttpManager.Builder.html" class="type-name-link" title="class in se.michaelthelin.spotify">SpotifyHttpManager.Builder</a> - Class in <a href="se/michaelthelin/spotify/package-summary.html">se.michaelthelin.spotify</a></dt>
 <dd>&nbsp;</dd>
+<dt><a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html" class="type-name-link" title="class in se.michaelthelin.spotify">SpotifyHttpRequestRetryStrategy</a> - Class in <a href="se/michaelthelin/spotify/package-summary.html">se.michaelthelin.spotify</a></dt>
+<dd>
+<div class="block">Default implementation of the <code>HttpRequestRetryStrategy</code> interface.</div>
+</dd>
+<dt><a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html#%3Cinit%3E()" class="member-name-link">SpotifyHttpRequestRetryStrategy()</a> - Constructor for class se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html" title="class in se.michaelthelin.spotify">SpotifyHttpRequestRetryStrategy</a></dt>
+<dd>
+<div class="block">Create the HTTP request retry strategy with a max retry count of 1,
+ default retry interval of 1 second, and using the following list of
+ non-retriable I/O exception classes:<br>
+
+ InterruptedIOException
+ UnknownHostException
+ ConnectException
+ ConnectionClosedException
+ SSLException
+ </div>
+</dd>
+<dt><a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html#%3Cinit%3E(int,org.apache.hc.core5.util.TimeValue)" class="member-name-link">SpotifyHttpRequestRetryStrategy(int, TimeValue)</a> - Constructor for class se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html" title="class in se.michaelthelin.spotify">SpotifyHttpRequestRetryStrategy</a></dt>
+<dd>
+<div class="block">Create the HTTP request retry strategy using the following list of
+ non-retriable I/O exception classes:<br>
+
+ InterruptedIOException
+ UnknownHostException
+ ConnectException
+ ConnectionClosedException
+ NoRouteToHostException
+ SSLException
+ </div>
+</dd>
+<dt><a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html#%3Cinit%3E(int,org.apache.hc.core5.util.TimeValue,java.util.Collection,java.util.Collection)" class="member-name-link">SpotifyHttpRequestRetryStrategy(int, TimeValue, Collection&lt;Class&lt;? extends IOException&gt;&gt;, Collection&lt;Integer&gt;)</a> - Constructor for class se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html" title="class in se.michaelthelin.spotify">SpotifyHttpRequestRetryStrategy</a></dt>
+<dd>&nbsp;</dd>
 <dt><a href="se/michaelthelin/spotify/exceptions/SpotifyWebApiException.html" class="type-name-link" title="class in se.michaelthelin.spotify.exceptions">SpotifyWebApiException</a> - Exception Class in <a href="se/michaelthelin/spotify/exceptions/package-summary.html">se.michaelthelin.spotify.exceptions</a></dt>
 <dd>
 <div class="block">An exception happened, eg.</div>
@@ -9203,7 +9243,7 @@ <h2 class="title" id="I:T">T</h2>
 <dd>
 <div class="block">The target valence setter.</div>
 </dd>
-<dt><a href="se/michaelthelin/spotify/SpotifyApiThreading.html#THREADPOOL" class="member-name-link">THREADPOOL</a> - Static variable in class se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/SpotifyApiThreading.html" title="class in se.michaelthelin.spotify">SpotifyApiThreading</a></dt>
+<dt><a href="se/michaelthelin/spotify/SpotifyApiThreading.html#THREAD_POOL" class="member-name-link">THREAD_POOL</a> - Static variable in class se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/SpotifyApiThreading.html" title="class in se.michaelthelin.spotify">SpotifyApiThreading</a></dt>
 <dd>&nbsp;</dd>
 <dt><a href="se/michaelthelin/spotify/requests/data/personalization/GetUsersTopArtistsAndTracksRequest.Builder.html#time_range(java.lang.String)" class="member-name-link">time_range(String)</a> - Method in class se.michaelthelin.spotify.requests.data.personalization.<a href="se/michaelthelin/spotify/requests/data/personalization/GetUsersTopArtistsAndTracksRequest.Builder.html" title="class in se.michaelthelin.spotify.requests.data.personalization">GetUsersTopArtistsAndTracksRequest.Builder</a></dt>
 <dd>

diff --git a/docs/index.html b/docs/index.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-<!-- Generated by javadoc (21) on Thu Sep 28 02:10:13 CEST 2023 -->
-<title>Overview (Spotify Web API Java Client 8.2.1 API)</title>
+<!-- Generated by javadoc (21) on Thu Oct 05 10:04:39 CEST 2023 -->
+<title>Overview (Spotify Web API Java Client 8.3.0 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2023-09-28">
+<meta name="dc.created" content="2023-10-05">
 <meta name="description" content="package index">
 <meta name="generator" content="javadoc/PackageIndexWriter">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
@@ -49,7 +49,7 @@
 <div class="flex-content">
 <main role="main">
 <div class="header">
-<h1 class="title">Spotify Web API Java Client 8.2.1 API</h1>
+<h1 class="title">Spotify Web API Java Client 8.3.0 API</h1>
 </div>
 <div id="all-packages-table">
 <div class="caption"><span>Packages</span></div>

diff --git a/docs/member-search-index.js b/docs/member-search-index.js
diff --git a/docs/overview-summary.html b/docs/overview-summary.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-<!-- Generated by javadoc (21) on Thu Sep 28 02:10:13 CEST 2023 -->
-<title>Spotify Web API Java Client 8.2.1 API</title>
+<!-- Generated by javadoc (21) on Thu Oct 05 10:04:39 CEST 2023 -->
+<title>Spotify Web API Java Client 8.3.0 API</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2023-09-28">
+<meta name="dc.created" content="2023-10-05">
 <meta name="description" content="index redirect">
 <meta name="generator" content="javadoc/IndexRedirectWriter">
 <link rel="canonical" href="index.html">

diff --git a/docs/overview-tree.html b/docs/overview-tree.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-<!-- Generated by javadoc (21) on Thu Sep 28 02:10:13 CEST 2023 -->
-<title>Class Hierarchy (Spotify Web API Java Client 8.2.1 API)</title>
+<!-- Generated by javadoc (21) on Thu Oct 05 10:04:39 CEST 2023 -->
+<title>Class Hierarchy (Spotify Web API Java Client 8.3.0 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2023-09-28">
+<meta name="dc.created" content="2023-10-05">
 <meta name="description" content="class tree">
 <meta name="generator" content="javadoc/TreeWriter">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
@@ -510,6 +510,7 @@ <h2 title="Class Hierarchy">Class Hierarchy</h2>
 <li class="circle">se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/SpotifyApiThreading.html" class="type-name-link" title="class in se.michaelthelin.spotify">SpotifyApiThreading</a></li>
 <li class="circle">se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/SpotifyHttpManager.html" class="type-name-link" title="class in se.michaelthelin.spotify">SpotifyHttpManager</a> (implements se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/IHttpManager.html" title="interface in se.michaelthelin.spotify">IHttpManager</a>)</li>
 <li class="circle">se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/SpotifyHttpManager.Builder.html" class="type-name-link" title="class in se.michaelthelin.spotify">SpotifyHttpManager.Builder</a></li>
+<li class="circle">se.michaelthelin.spotify.<a href="se/michaelthelin/spotify/SpotifyHttpRequestRetryStrategy.html" class="type-name-link" title="class in se.michaelthelin.spotify">SpotifyHttpRequestRetryStrategy</a> (implements org.apache.hc.client5.http.HttpRequestRetryStrategy)</li>
 <li class="circle">java.lang.<a href="https://docs.oracle.com/javase/9/docs/api/java/lang/Throwable.html" class="type-name-link external-link" title="class or interface in java.lang">Throwable</a> (implements java.io.<a href="https://docs.oracle.com/javase/9/docs/api/java/io/Serializable.html" title="class or interface in java.io" class="external-link">Serializable</a>)
 <ul>
 <li class="circle">java.lang.<a href="https://docs.oracle.com/javase/9/docs/api/java/lang/Exception.html" class="type-name-link external-link" title="class or interface in java.lang">Exception</a>

diff --git a/docs/se/michaelthelin/spotify/Base64.html b/docs/se/michaelthelin/spotify/Base64.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-<!-- Generated by javadoc (21) on Thu Sep 28 02:10:13 CEST 2023 -->
-<title>Base64 (Spotify Web API Java Client 8.2.1 API)</title>
+<!-- Generated by javadoc (21) on Thu Oct 05 10:04:39 CEST 2023 -->
+<title>Base64 (Spotify Web API Java Client 8.3.0 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2023-09-28">
+<meta name="dc.created" content="2023-10-05">
 <meta name="description" content="declaration: package: se.michaelthelin.spotify, class: Base64">
 <meta name="generator" content="javadoc/ClassWriterImpl">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">

diff --git a/docs/se/michaelthelin/spotify/IHttpManager.html b/docs/se/michaelthelin/spotify/IHttpManager.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-<!-- Generated by javadoc (21) on Thu Sep 28 02:10:13 CEST 2023 -->
-<title>IHttpManager (Spotify Web API Java Client 8.2.1 API)</title>
+<!-- Generated by javadoc (21) on Thu Oct 05 10:04:39 CEST 2023 -->
+<title>IHttpManager (Spotify Web API Java Client 8.3.0 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2023-09-28">
+<meta name="dc.created" content="2023-10-05">
 <meta name="description" content="declaration: package: se.michaelthelin.spotify, interface: IHttpManager">
 <meta name="generator" content="javadoc/ClassWriterImpl">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">

diff --git a/docs/se/michaelthelin/spotify/SpotifyApi.Builder.html b/docs/se/michaelthelin/spotify/SpotifyApi.Builder.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-<!-- Generated by javadoc (21) on Thu Sep 28 02:10:13 CEST 2023 -->
-<title>SpotifyApi.Builder (Spotify Web API Java Client 8.2.1 API)</title>
+<!-- Generated by javadoc (21) on Thu Oct 05 10:04:39 CEST 2023 -->
+<title>SpotifyApi.Builder (Spotify Web API Java Client 8.3.0 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2023-09-28">
+<meta name="dc.created" content="2023-10-05">
 <meta name="description" content="declaration: package: se.michaelthelin.spotify, class: SpotifyApi, class: Builder">
 <meta name="generator" content="javadoc/ClassWriterImpl">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">

diff --git a/docs/se/michaelthelin/spotify/SpotifyApi.html b/docs/se/michaelthelin/spotify/SpotifyApi.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-<!-- Generated by javadoc (21) on Thu Sep 28 02:10:13 CEST 2023 -->
-<title>SpotifyApi (Spotify Web API Java Client 8.2.1 API)</title>
+<!-- Generated by javadoc (21) on Thu Oct 05 10:04:39 CEST 2023 -->
+<title>SpotifyApi (Spotify Web API Java Client 8.3.0 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2023-09-28">
+<meta name="dc.created" content="2023-10-05">
 <meta name="description" content="declaration: package: se.michaelthelin.spotify, class: SpotifyApi">
 <meta name="generator" content="javadoc/ClassWriterImpl">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">