Package: AudioExplorerPresentationControlSpi

AudioExplorerPresentationControlSpi

Coverage

1: /*
2: * *********************************************************************************************************************
3: *
4: * blueMarine II: Semantic Media Centre
5: * http://tidalwave.it/projects/bluemarine2
6: *
7: * Copyright (C) 2015 - 2021 by Tidalwave s.a.s. (http://tidalwave.it)
8: *
9: * *********************************************************************************************************************
10: *
11: * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
12: * the License. You may obtain a copy of the License at
13: *
14: * http://www.apache.org/licenses/LICENSE-2.0
15: *
16: * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
17: * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
18: * specific language governing permissions and limitations under the License.
19: *
20: * *********************************************************************************************************************
21: *
22: * git clone https://bitbucket.org/tidalwave/bluemarine2-src
23: * git clone https://github.com/tidalwave-it/bluemarine2-src
24: *
25: * *********************************************************************************************************************
26: */
27: package it.tidalwave.bluemarine2.ui.audio.explorer.impl;
28:
29: import javax.annotation.Nonnull;
30: import java.util.List;
31: import java.util.Optional;
32: import java.net.URL;
33: import it.tidalwave.bluemarine2.model.role.EntityBrowser;
34: import it.tidalwave.bluemarine2.model.spi.Entity;
35:
36: /***********************************************************************************************************************
37: *
38: * A SPI interface to {@link DefaultAudioExplorerPresentationControl} which is only exposed to local roles.
39: *
40: * @author Fabrizio Giudici
41: *
42: **********************************************************************************************************************/
43: public interface AudioExplorerPresentationControlSpi
44: {
45: /*******************************************************************************************************************
46: *
47: * Selects a browser.
48: *
49: * @param entityBrowser the browser
50: *
51: ******************************************************************************************************************/
52: public void selectBrowser (@Nonnull EntityBrowser entityBrowser);
53:
54: /*******************************************************************************************************************
55: *
56: * Navigates to a new folder, saving the current folder to the stack.
57: *
58: * @param mediaFolder the new folder
59: *
60: ******************************************************************************************************************/
61: public void navigateTo (@Nonnull Entity mediaFolder);
62:
63: /*******************************************************************************************************************
64: *
65: * Clears the details area.
66: *
67: ******************************************************************************************************************/
68: public void clearDetails();
69:
70: /*******************************************************************************************************************
71: *
72: * Renders a text in the details area.
73: *
74: ******************************************************************************************************************/
75: public void renderDetails (@Nonnull String details);
76:
77: /*******************************************************************************************************************
78: *
79: * Requests to download some cover art.
80: *
81: ******************************************************************************************************************/
82: public void requestCoverArt (@Nonnull Optional<URL> optionalCoverArtUri);
83:
84: /*******************************************************************************************************************
85: *
86: * Returns the list of media items in the current folder.
87: *
88: * FIXME: should be List<MediaItem>
89: *
90: ******************************************************************************************************************/
91: @Nonnull
92: public List<Entity> getMediaItems();
93: }