net.wildfyre.api

Class WildFyre

java.lang.Object

net.wildfyre.api.WildFyre

public class WildFyre
extends Object

The primary means of interaction with the API.

Constructor Summary

Constructors

Constructor and Description
WildFyre()

Method Summary

Modifier and Type	Method and Description
static LoggedUser	connect(String token) Connects to the server with the specified token.
static LoggedUser	connect(String username, String password) Connects to the server with the specified user.
static void	disconnect() Disconnects the API from the currently-logged-in user.
static boolean	isConnected() Is the user connected?

Methods inherited from class java.lang.Object

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

Constructor Detail

WildFyre

public WildFyre()

Method Detail

connect

public static LoggedUser connect(String username,
                                 String password)
                          throws net.wildfyre.http.Request.CantConnectException,
                                 InvalidCredentialsException

Connects to the server with the specified user. This method is NOT executed concurrently, because no action can be taken by the client while the cache is empty anyway.

Parameters:

username - the user's username

password - the user's password

Returns:

Your own user. See also Users.me().

Throws:

net.wildfyre.http.Request.CantConnectException

InvalidCredentialsException

connect

public static LoggedUser connect(String token)
                          throws net.wildfyre.http.Request.CantConnectException

Connects to the server with the specified token. This method is NOT executed concurrently, because no action can be taken by the client while the cache is empty anyway.

Parameters:

token - the token

Returns:

Your own user. See also Users.me().

Throws:

net.wildfyre.http.Request.CantConnectException

disconnect

public static void disconnect()

Disconnects the API from the currently-logged-in user.

isConnected

public static boolean isConnected()

Is the user connected?

Note that this method does not specify whether the connection is still valid, it only specifies whether either methods connect(token) or connect(username, password) where successful.

Returns:

true if the user is registered.