add SpotifyListenerAdapter, improve async api, version 1.0.2

Author: LabyStudio

README.md

@@ -14,7 +14,7 @@ repositories {
 }
 
 dependencies {
-    implementation 'com.github.LabyStudio:java-spotify-api:1.0.1:all'
+    implementation 'com.github.LabyStudio:java-spotify-api:1.0.2:all'
 }
 ```
 

build.gradle

@@ -4,7 +4,7 @@ plugins {
 }
 
 group 'de.labystudio'
-version '1.0.1'
+version '1.0.2'
 
 compileJava {
     sourceCompatibility = '1.8'

src/main/java/de/labystudio/spotifyapi/SpotifyAPI.java

@@ -2,6 +2,8 @@
 
 import de.labystudio.spotifyapi.model.Track;
 
+import java.util.concurrent.CompletableFuture;
+
 /**
  * This is the main interface for the SpotifyAPI.
  * It is used to get the current track and the current position of a song.
@@ -13,11 +15,21 @@ public interface SpotifyAPI {
 
     /**
      * Initialize the SpotifyAPI and connect to the Spotify process.
+     * Initializing the api will block the current thread until the connection is established.
      *
      * @return the initialized SpotifyAPI
      */
     SpotifyAPI initialize();
 
+    /**
+     * Initialize the SpotifyAPI and connect to the Spotify process asynchronously.
+     *
+     * @return a future that will contain the initialized SpotifyAPI
+     */
+    default CompletableFuture<SpotifyAPI> initializeAsync() {
+        return CompletableFuture.supplyAsync(this::initialize);
+    }
+
     /**
      * Returns the current track that is playing right now
      * It can be null if the api haven't received any playback changes yet.

src/main/java/de/labystudio/spotifyapi/SpotifyAPIFactory.java

@@ -26,23 +26,33 @@ public static SpotifyAPI create() {
         String os = System.getProperty("os.name").toLowerCase(Locale.ENGLISH);
 
         if (os.contains("win")) {
-            return new WinSpotifyAPI().initialize();
+            return new WinSpotifyAPI();
         }
         if (os.contains("mac")) {
-            return new OSXSpotifyApi().initialize();
+            return new OSXSpotifyApi();
         }
 
         throw new IllegalStateException("Unsupported OS: " + os);
     }
 
+    /**
+     * Create an initialized SpotifyAPI instance.
+     * Initializing will block the current thread until the SpotifyAPI instance is ready.
+     *
+     * @return A new SpotifyAPI instance.
+     */
+    public static SpotifyAPI createInitialized() {
+        return create().initialize();
+    }
+
     /**
      * Creates a new SpotifyAPI instance for the current platform asynchronously.
      * Currently, only Windows and OSX are supported.
      *
      * @return A future that will contain the SpotifyAPI instance.
      */
-    public static CompletableFuture<SpotifyAPI> createAsync() {
-        return CompletableFuture.supplyAsync(SpotifyAPIFactory::create);
+    public static CompletableFuture<SpotifyAPI> createInitializedAsync() {
+        return CompletableFuture.supplyAsync(SpotifyAPIFactory::createInitialized);
     }
 
 }

src/main/java/de/labystudio/spotifyapi/SpotifyListenerAdapter.java

@@ -0,0 +1,36 @@
+package de.labystudio.spotifyapi;
+
+import de.labystudio.spotifyapi.model.Track;
+
+public class SpotifyListenerAdapter implements SpotifyListener {
+
+    @Override
+    public void onConnect() {
+
+    }
+
+    @Override
+    public void onTrackChanged(Track track) {
+
+    }
+
+    @Override
+    public void onPositionChanged(int position) {
+
+    }
+
+    @Override
+    public void onPlayBackChanged(boolean isPlaying) {
+
+    }
+
+    @Override
+    public void onSync() {
+
+    }
+
+    @Override
+    public void onDisconnect(Exception exception) {
+
+    }
+}