package org.apidesign.samples;

 // BEGIN: xmms.java.api.ext

 // BEGIN: xmms.java.api

 public final class XMMS {

     public void play() { doPlay(); }

     public void pause() { doPause(); }

     public void addToPlaylist(String file) { doAddToPlaylist(file); }

 // FINISH: xmms.java.api

     /** @since 2.0 we can also control volume */

     public void setVolume(int volume) { doTuneVolume(volume); }

 // FINISH: xmms.java.api.ext

     // BEGIN: xmms.java.spi.ext

     // BEGIN: xmms.java.spi

     interface Playback {

         public void playback(byte[] data);

     // FINISH: xmms.java.spi

         /** @since 2.0 we can also control volume */

         interface Volume extends Playback {

             public void setVolume(int volume);

         }

     }

     // END: xmms.java.spi.ext

     public void registerPlayback(Playback callback) {

         this.callback = callback;

     }

     private Playback callback;

     private void doAddToPlaylist(String file) {

     }

     private void doPause() {

     }

     private void doPlay() {

         callback.playback("Play!".getBytes());

     }

     // BEGIN: xmms.java.spi.instanceof

     private void doTuneVolume(int volume) {

         if (callback instanceof Playback.Volume) {

             Playback.Volume pv = (Playback.Volume) callback;

             pv.setVolume(volume);

         }

     }

     // END: xmms.java.spi.instanceof

     //

     // Usage

     // 

     public static void main(String[] args) {

         XMMS xmms = new XMMS();

         // BEGIN: xmms.java.use

         class MyCallbackPrints implements XMMS.Playback {

             public void playback(byte[] data) {

                 System.out.println(new String(data));

             }

         }

         xmms.registerPlayback(new MyCallbackPrints());

         // END: xmms.java.use

     }

 }