org.opensocial.services.myspace

Class StatusMoodsService

java.lang.Object

org.opensocial.services.Service

org.opensocial.services.myspace.StatusMoodsService

public class StatusMoodsService
extends Service

OpenSocial API class for MySpace status and mood requests; contains static methods for fetching and updating MySpace statuses and for fetching supported moods and mood history.

Author:

Jason Cooper

Field Summary

Fields inherited from class org.opensocial.services.Service

APP, FRIENDS, ME, SELF, VIEWER

Constructor Summary

Constructors

Constructor and Description
StatusMoodsService()

Method Summary

Methods

Modifier and Type	Method and Description
static Request	getFriendStatuses(String guid) Returns a new Request instance which, when submitted, fetches the status and mood of all of the specified user's friends and makes this data available as a List of StatusMood objects.
static Request	getFriendStatusHistories() Returns a new Request instance which, when submitted, fetches the previous statuses and moods for all of the current viewer's friends and makes this data available as a List of StatusMood objects.
static Request	getFriendStatusHistory(String friendId) Returns a new Request instance which, when submitted, fetches the previous statuses and moods for the specified friend and makes this data available as a List of StatusMood objects.
static Request	getStatus() Returns a new Request instance which, when submitted, fetches the current viewer's status and mood and makes this data available as a StatusMood object.
static Request	getStatus(String guid) Returns a new Request instance which, when submitted, fetches the specified user's status and mood and makes this data available as a StatusMood object.
static Request	getStatusHistory() Returns a new Request instance which, when submitted, fetches the current viewer's previous statuses and moods and makes this data available as a List of StatusMood objects.
static Request	getSupportedMood(long moodId) Returns a new Request instance which, when submitted, fetches the specified mood and makes this data available as a StatusMood object.
static Request	getSupportedMoods() Returns a new Request instance which, when submitted, fetches all moods supported by and available on MySpace and makes this data available as a List of StatusMood objects.
static Request	updateStatus(StatusMood statusMood) Returns a new Request instance which, when submitted, updates the current viewer's status and/or mood.

Methods inherited from class java.lang.Object

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

Constructor Detail

StatusMoodsService

public StatusMoodsService()

Method Detail

getStatus

public static Request getStatus()

Returns a new Request instance which, when submitted, fetches the current viewer's status and mood and makes this data available as a StatusMood object. Equivalent to getStatus("@me").

Returns:

new Request object to fetch the current viewer's status/mood

See Also:

StatusMood

getStatus

public static Request getStatus(String guid)

Returns a new Request instance which, when submitted, fetches the specified user's status and mood and makes this data available as a StatusMood object.

Parameters:

guid - OpenSocial ID of the user whose status is to be fetched

Returns:

new Request object to fetch the specified user's status/mood

See Also:

StatusMood

getFriendStatuses

public static Request getFriendStatuses(String guid)

Returns a new Request instance which, when submitted, fetches the status and mood of all of the specified user's friends and makes this data available as a List of StatusMood objects. Pass "@me" to fetch the statuses and moods for all friends of the current viewer.

Parameters:

guid - OpenSocial ID of the user whose friends' statuses and moods are to be fetched

Returns:

new Request object to fetch the specified user's friends' statuses/moods

See Also:

StatusMood

getStatusHistory

public static Request getStatusHistory()

Returns a new Request instance which, when submitted, fetches the current viewer's previous statuses and moods and makes this data available as a List of StatusMood objects.

Returns:

new Request object to fetch the current viewer's previous statuses/moods

See Also:

StatusMood

getFriendStatusHistories

public static Request getFriendStatusHistories()

Returns a new Request instance which, when submitted, fetches the previous statuses and moods for all of the current viewer's friends and makes this data available as a List of StatusMood objects.

Returns:

new Request object to fetch the current viewer's friends' previous statuses/moods

See Also:

StatusMood

getFriendStatusHistory

public static Request getFriendStatusHistory(String friendId)

Returns a new Request instance which, when submitted, fetches the previous statuses and moods for the specified friend and makes this data available as a List of StatusMood objects.

Parameters:

friendId - OpenSocial ID of the current viewer's friend whose previous statuses/moods are to be fetched

Returns:

new Request object to fetch the specified friend's previous statuses/moods

See Also:

StatusMood

getSupportedMoods

public static Request getSupportedMoods()

Returns a new Request instance which, when submitted, fetches all moods supported by and available on MySpace and makes this data available as a List of StatusMood objects.

Returns:

new Request object to fetch all available MySpace moods

See Also:

StatusMood

getSupportedMood

public static Request getSupportedMood(long moodId)

Returns a new Request instance which, when submitted, fetches the specified mood and makes this data available as a StatusMood object.

Parameters:

moodId - ID of mood to fetch

Returns:

new Request object to fetch the specified mood

See Also:

StatusMood

updateStatus

public static Request updateStatus(StatusMood statusMood)

Returns a new Request instance which, when submitted, updates the current viewer's status and/or mood.

Parameters:

statusMood - StatusMood object specifying the status and/or mood parameters to pass into the request; typically, status and moodId are set

Returns:

new Request object to update the current viewer's status and/or mood