com.omertron.themoviedbapi.methods

Class TmdbPeople

java.lang.Object

com.omertron.themoviedbapi.methods.AbstractMethod

com.omertron.themoviedbapi.methods.TmdbPeople

public class TmdbPeople
extends AbstractMethod

Class to hold the People Methods

Author:

stuart.boston

Field Summary

Fields inherited from class com.omertron.themoviedbapi.methods.AbstractMethod

apiKey, httpTools, MAPPER

Constructor Summary

Constructors

Constructor and Description
TmdbPeople(String apiKey, HttpTools httpTools) Constructor

Method Summary

Modifier and Type	Method and Description
ResultList<ChangeKeyItem>	getPersonChanges(int personId, String startDate, String endDate) Get the changes for a specific person id.
PersonCreditList<CreditBasic>	getPersonCombinedCredits(int personId, String language) Get the combined (movie and TV) credits for a specific person id.
ExternalID	getPersonExternalIds(int personId) Get the external ids for a specific person id.
ResultList<Artwork>	getPersonImages(int personId) Get the images for a specific person id.
PersonInfo	getPersonInfo(int personId, String... appendToResponse) Get the general person information for a specific id.
PersonInfo	getPersonLatest() Get the latest person id.
PersonCreditList<CreditMovieBasic>	getPersonMovieCredits(int personId, String language) Get the movie credits for a specific person id.
ResultList<PersonFind>	getPersonPopular(Integer page) Get the list of popular people on The Movie Database.
ResultList<ArtworkMedia>	getPersonTaggedImages(int personId, Integer page, String language) Get the images that have been tagged with a specific person id.
PersonCreditList<CreditTVBasic>	getPersonTVCredits(int personId, String language) Get the TV credits for a specific person id.

Methods inherited from class com.omertron.themoviedbapi.methods.AbstractMethod

getMediaChanges, getTypeReference, processWrapper, processWrapperList

Methods inherited from class java.lang.Object

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

Constructor Detail

TmdbPeople

public TmdbPeople(String apiKey,
                  HttpTools httpTools)

Constructor

Parameters:

apiKey -

httpTools -

Method Detail

getPersonInfo

public PersonInfo getPersonInfo(int personId,
                                String... appendToResponse)
                         throws MovieDbException

Get the general person information for a specific id.

Parameters:

personId -

appendToResponse -

Returns:

Throws:

MovieDbException

getPersonMovieCredits

public PersonCreditList<CreditMovieBasic> getPersonMovieCredits(int personId,
                                                                String language)
                                                         throws MovieDbException

Get the movie credits for a specific person id.

Parameters:

personId -

language -

Returns:

Throws:

MovieDbException

getPersonTVCredits

public PersonCreditList<CreditTVBasic> getPersonTVCredits(int personId,
                                                          String language)
                                                   throws MovieDbException

Get the TV credits for a specific person id. To get the expanded details for each record, call the /credit method with the provided credit_id. This will provide details about which episode and/or season the credit is for.

Parameters:

personId -

language -

Returns:

Throws:

MovieDbException

getPersonCombinedCredits

public PersonCreditList<CreditBasic> getPersonCombinedCredits(int personId,
                                                              String language)
                                                       throws MovieDbException

Get the combined (movie and TV) credits for a specific person id. To get the expanded details for each TV record, call the /credit method with the provided credit_id. This will provide details about which episode and/or season the credit is for.

Parameters:

personId -

language -

Returns:

Throws:

MovieDbException

getPersonExternalIds

public ExternalID getPersonExternalIds(int personId)
                                throws MovieDbException

Get the external ids for a specific person id.

Parameters:

personId -

Returns:

Throws:

MovieDbException

getPersonImages

public ResultList<Artwork> getPersonImages(int personId)
                                    throws MovieDbException

Get the images for a specific person id.

Parameters:

personId -

Returns:

Throws:

MovieDbException

getPersonTaggedImages

public ResultList<ArtworkMedia> getPersonTaggedImages(int personId,
                                                      Integer page,
                                                      String language)
                                               throws MovieDbException

Get the images that have been tagged with a specific person id. We return all of the image results with a media object mapped for each image.

Parameters:

personId -

page -

language -

Returns:

Throws:

MovieDbException

getPersonChanges

public ResultList<ChangeKeyItem> getPersonChanges(int personId,
                                                  String startDate,
                                                  String endDate)
                                           throws MovieDbException

Get the changes for a specific person id. Changes are grouped by key, and ordered by date in descending order. By default, only the last 24 hours of changes are returned. The maximum number of days that can be returned in a single request is 14. The language is present on fields that are translatable.

Parameters:

personId -

startDate -

endDate -

Returns:

Throws:

MovieDbException

getPersonPopular

public ResultList<PersonFind> getPersonPopular(Integer page)
                                        throws MovieDbException

Get the list of popular people on The Movie Database. This list refreshes every day.

Parameters:

page -

Returns:

Throws:

MovieDbException

getPersonLatest

public PersonInfo getPersonLatest()
                           throws MovieDbException

Get the latest person id.

Returns:

Throws:

MovieDbException