Query image libraries
The examples below show you how to query all of the available albums or how to query only a specific album by its ID.
Query a single album
To query a specific album by its ID, you must perform the following:
- Get the album.
First, get an instance of the album that corresponds to the specified ID.
- Return the album.
The following code samples query an album by its ID:
Native API
First, you get an instance of the LibrariesManager class. To get the specified album, you query all albums and filter the collection by the ID argument. If the specified album does not exist, the query will return null. Finally, you return the album.
You can also use the following code to retrieve the album:
NOTE: If the album does not exist, an exception of type ItemNotFoundException is thrown.
Fluent API
First, you get the singular facade of the album with the specified ID. To get an instance of the album, you call the Get method of the facade. Note that when the album does not exist, an exception of type ItemNotFoundException is thrown.
You can also use the following code to retrieve the album:
Query all albums
When querying all albums, you must perform the following:
- Query all albums.
First, get a query of all available albums.
- Return a list of albums.
The following code samples query all albums:
Native API
First, you get an instance of the LibrariesManager class. Then, you query all available albums. Finally, you return the albums as a list. If no albums exist, the list will be empty.
Fluent API
First, you get an instance of the plural albums facade. Then, you get all available albums. Finally, you return the albums as a list. If no albums exist, the list will be empty.