Internal (wflib-java 0.9.0 API)

java.lang.Object
- net.wildfyre.api.Internal

```
public class Internal
extends Object
```
This class represents the internals of the WildFyre Java Client Library. This class was written to give lower-level access to developers. When possible, prefer using the WildFyre class.
Note that you should call init() after any modification of the token, otherwise the behavior of this class is not defined.

Constructor Summary

Constructors
Constructor and Description

Internal()

Constructors
Constructor and Description
`Internal()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`clean()` Cleans the cache -- that is, removes every object that is not valid anymore from it (see `Descriptor.isValid()`).
`static void`	`clear()` Fully clears the cache, but keeps the token.
`static void`	`init()` Connects to the server & tries to access the logged-user's ID.
`static void`	`requestToken(String username, String password)` Requests a token using a username and a password.
`static void`	`reset()` Resets the API.
`static void`	`setCantConnectHandler(Consumer<net.wildfyre.http.Request.CantConnectException> consumer)` Registers a handler for the case where the API cannot connect to the server.
`static void`	`setNoSuchEntityHandler(Consumer<NoSuchEntityException> consumer)` Registers a handler for the case where an Entity that was queried for update does not exist.
`static void`	`setToken(String token)` Sets the token used by the API.
`static void`	`submit(Runnable task)` Submits a new task to be executed concurrently.
`static <D extends Descriptor> void`	`submitUpdate(D descriptor)` Submits a new task to be executed concurrently, that updates a Descriptor.
`static void`	`throwCantConnect(net.wildfyre.http.Request.CantConnectException e)` Call this method if you need to tell the client of this API that the server is unreachable at the moment, if you are in a concurrent context.
`static String`	`token()` Returns the token used for authentication.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Internal
```
public Internal()
```
- Method Detail
  - clear
```
public static void clear()
```
    Fully clears the cache, but keeps the token.
    
    See Also:
    
    Only remove the data that has expired
  - clean
```
public static void clean()
```
    Cleans the cache -- that is, removes every object that is not valid anymore from it (see Descriptor.isValid()).
    
    See Also:
    
    Remove all data, not only the expired data
  - reset
```
public static void reset()
```
    Resets the API.
    This means that the user's token is removed, and the cache is fully cleared.
  - token
```
public static String token()
```
    Returns the token used for authentication.
    
    Returns:
    
    The token.
  - setNoSuchEntityHandler
```
public static void setNoSuchEntityHandler(Consumer<NoSuchEntityException> consumer)
```
    Registers a handler for the case where an Entity that was queried for update does not exist.
    
    Parameters:
    
    consumer - the handler.
  - throwCantConnect
```
public static void throwCantConnect(net.wildfyre.http.Request.CantConnectException e)
```
    Call this method if you need to tell the client of this API that the server is unreachable at the moment, if you are in a concurrent context.
    
    Parameters:
    
    e - the exception that was thrown during the request.
  - setCantConnectHandler
```
public static void setCantConnectHandler(Consumer<net.wildfyre.http.Request.CantConnectException> consumer)
```
    Registers a handler for the case where the API cannot connect to the server.
    
    Parameters:
    
    consumer - the handler.
  - submit
```
public static void submit(Runnable task)
```
    Submits a new task to be executed concurrently.
    
    Parameters:
    
    task - the task to be executed concurrently.
  - submitUpdate
```
public static <D extends Descriptor> void submitUpdate(D descriptor)
```
    Submits a new task to be executed concurrently, that updates a Descriptor.
    
    Parameters:
    
    descriptor - the descriptor to be updated concurrently.
  - requestToken
```
public static void requestToken(String username,
                                String password)
                         throws net.wildfyre.http.Request.CantConnectException,
                                InvalidCredentialsException
```
    Requests a token using a username and a password. This request is NOT executed concurrently (since the client cannot do anything until connected).
    
    Parameters:
    
    username - the user's username
    
    password - the user's password
    
    Throws:
    
    Request.CantConnectException - if the API cannot connect to the server
    
    InvalidCredentialsException
  - setToken
```
public static void setToken(String token)
```
    Sets the token used by the API. Note that no verification regarding the token's validity is done by this method, use with init() for that purpose.
    
    Parameters:
    
    token - the new token
  - init
```
public static void init()
                 throws net.wildfyre.http.Request.CantConnectException
```
    Connects to the server & tries to access the logged-user's ID. This is needed so the API can identify whether a post is owned or not by the user.
    
    Throws:
    
    Request.CantConnectException - if the API cannot connect to the server

Class Internal

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Internal

Method Detail

clear

clean

reset

token

setNoSuchEntityHandler

throwCantConnect

setCantConnectHandler

submit

submitUpdate

requestToken

setToken

init