org.intellimate.izou.sdk.frameworks.music.player

Class TrackInfo

java.lang.Object

org.intellimate.izou.sdk.frameworks.music.player.TrackInfo

public class TrackInfo
extends Object

This class represents the Information about one track, this class is immutable

Version:

1.0

Author:

LeanderK

Field Summary

Fields

Modifier and Type	Field and Description
static String	albumCoverDescriptor
static String	albumCoverFormatDescriptor
static String	albumDescriptor
static String	artistDescriptor
static String	bmpDescriptor
static String	dataDescriptor
static String	durationDescriptor
static String	genreDescriptor
static String	nameDescriptor
static String	yearDescriptor

Constructor Summary

Constructors

Constructor and Description
TrackInfo(String name)
TrackInfo(String name, String artist, String album)
TrackInfo(String name, String artist, String album, byte[] albumCover, String albumCoverFormat)
TrackInfo(String name, String artist, String album, byte[] albumCover, String albumCoverFormat, String data)
TrackInfo(String name, String artist, String album, byte[] albumCover, String albumCoverFormat, String data, String year, String genre, String bmp, long duration)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
HashMap<String,Object>	export() exports the TrackInfo to a Hashmap
Optional<String>	getAlbum() returns a String containing the Name of the Album
Optional<byte[]>	getAlbumCover() returns the album cover as bytes, format specified by: getAlbumCoverFormat().
Optional<String>	getAlbumCoverFormat() returns the format of the album cover, which can be obtained by calling getAlbumCover().
Optional<String>	getArtist() returns a String containing the Name of the Artist
Optional<String>	getBmp() returns a String containing the BMP
Optional<String>	getData() returns the data of the TrackInfo.
Optional<Long>	getDuration() returns a long containing the Duration in milliseconds
Optional<String>	getGenre() returns a String containing the Genre
Optional<String>	getName() returns a String containing the Name of the Track
Optional<String>	getYear() returns a String containing the Year of the release
int	hashCode()
static Optional<TrackInfo>	importFromHashMap(HashMap<String,Object> hashMap) returns the optional TrackInfo if the HashMap contains no malformed data
static Optional<TrackInfo>	importFromResource(ResourceModel resourceModel) creates a TrackInfo from the resourceModel
boolean	isNew(String name, String artist, String album, byte[] albumCover, String albumCoverFormat, String id, String year, String genre, String bmp, long duration) retruns true if any of these arguments is already existing and would be overwritten, otherwise retruns false.
boolean	isNew(TrackInfo trackInfo) retruns true if any of these arguments is already existing and would be overwritten, otherwise retruns false.
Optional<TrackInfo>	update(String name, String artist, String album, byte[] albumCover, String coverFormat, String data, String year, String genre, String bmp, long duration) returns a trackinfo if some information was added and not overwritten (see isNew) AND a change occurred.
Optional<TrackInfo>	update(TrackInfo trackInfo) returns a trackinfo if some information was added and not overwritten

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

nameDescriptor

public static final String nameDescriptor

See Also:

Constant Field Values

artistDescriptor

public static final String artistDescriptor

See Also:

Constant Field Values

albumDescriptor

public static final String albumDescriptor

See Also:

Constant Field Values

albumCoverDescriptor

public static final String albumCoverDescriptor

See Also:

Constant Field Values

albumCoverFormatDescriptor

public static final String albumCoverFormatDescriptor

See Also:

Constant Field Values

dataDescriptor

public static final String dataDescriptor

See Also:

Constant Field Values

yearDescriptor

public static final String yearDescriptor

See Also:

Constant Field Values

genreDescriptor

public static final String genreDescriptor

See Also:

Constant Field Values

bmpDescriptor

public static final String bmpDescriptor

See Also:

Constant Field Values

durationDescriptor

public static final String durationDescriptor

See Also:

Constant Field Values

Constructor Detail

TrackInfo

public TrackInfo(String name)

TrackInfo

public TrackInfo(String name,
                 String artist,
                 String album)

TrackInfo

public TrackInfo(String name,
                 String artist,
                 String album,
                 byte[] albumCover,
                 String albumCoverFormat)

TrackInfo

public TrackInfo(String name,
                 String artist,
                 String album,
                 byte[] albumCover,
                 String albumCoverFormat,
                 String data)

TrackInfo

public TrackInfo(String name,
                 String artist,
                 String album,
                 byte[] albumCover,
                 String albumCoverFormat,
                 String data,
                 String year,
                 String genre,
                 String bmp,
                 long duration)

Method Detail

getName

public Optional<String> getName()

returns a String containing the Name of the Track

Returns:

the optional Name

getArtist

public Optional<String> getArtist()

returns a String containing the Name of the Artist

Returns:

the optional Artist

getAlbum

public Optional<String> getAlbum()

returns a String containing the Name of the Album

Returns:

the optional Artist

getAlbumCover

public Optional<byte[]> getAlbumCover()

returns the album cover as bytes, format specified by: getAlbumCoverFormat().

Returns:

the optional Album Cover

getAlbumCoverFormat

public Optional<String> getAlbumCoverFormat()

returns the format of the album cover, which can be obtained by calling getAlbumCover().

Returns:

the optional Format

getData

public Optional<String> getData()

returns the data of the TrackInfo.

this field is mostly internal, can be an url etc. should be used only if obtained from a player

Returns:

the optional data

getYear

public Optional<String> getYear()

returns a String containing the Year of the release

Returns:

the optional Year of the release

getGenre

public Optional<String> getGenre()

returns a String containing the Genre

Returns:

the optional Genre

getBmp

public Optional<String> getBmp()

returns a String containing the BMP

Returns:

the optional BMP

getDuration

public Optional<Long> getDuration()

returns a long containing the Duration in milliseconds

Returns:

the optional Duration

isNew

public boolean isNew(TrackInfo trackInfo)

retruns true if any of these arguments is already existing and would be overwritten, otherwise retruns false. The method also returns true if everything is null except the albumCover-Format (maybe known in advance).

Parameters:

trackInfo - the trackInfo to compare against

Returns:

true if new

isNew

public boolean isNew(String name,
                     String artist,
                     String album,
                     byte[] albumCover,
                     String albumCoverFormat,
                     String id,
                     String year,
                     String genre,
                     String bmp,
                     long duration)

retruns true if any of these arguments is already existing and would be overwritten, otherwise retruns false. The method also returns true if everything is null except the albumCover-Format (maybe known in advance).

Parameters:

name - the name

artist - the artist

album - the album

albumCover - the album cover

albumCoverFormat - the album cover format

id - the id of the track

year - the year

genre - the genre

duration - the duration

bmp - the bmp

Returns:

true if new

update

public Optional<TrackInfo> update(TrackInfo trackInfo)

returns a trackinfo if some information was added and not overwritten

Parameters:

trackInfo - the data to compare

Returns:

a trackinfo if some information was updated

update

public Optional<TrackInfo> update(String name,
                                  String artist,
                                  String album,
                                  byte[] albumCover,
                                  String coverFormat,
                                  String data,
                                  String year,
                                  String genre,
                                  String bmp,
                                  long duration)

returns a trackinfo if some information was added and not overwritten (see isNew) AND a change occurred.

Parameters:

name - the name

artist - the artist

album - the album

albumCover - the album cover

coverFormat - the album cover format

data - the data

year - the year

genre - the genre

duration - the duration

bmp - the bmp

Returns:

a trackInfo if some information was updated, and an empty optional if: 1. information would be ovewritten or 2. no change occured

export

public HashMap<String,Object> export()

exports the TrackInfo to a Hashmap

Returns:

a HashMap

importFromHashMap

public static Optional<TrackInfo> importFromHashMap(HashMap<String,Object> hashMap)

returns the optional TrackInfo if the HashMap contains no malformed data

Parameters:

hashMap - the data to import from

Returns:

an optional

importFromResource

public static Optional<TrackInfo> importFromResource(ResourceModel resourceModel)

creates a TrackInfo from the resourceModel

Parameters:

resourceModel - the resourceModel

Returns:

the optional TrackInfo

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object