blob: 437eec8470616f717a3cc7fd6d020813839cc847 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
package cgeo.geocaching.connector.capability;
import cgeo.geocaching.connector.IConnector;
import android.content.Context;
import android.os.Handler;
public interface ILogin extends IConnector {
/**
* Contacts the server the connector belongs to and verifies/establishes authentication and retrieves information
* about the current user (Name, found caches) if applicable.
*
* @param handler
* Handler to receive status feedback
* @param fromActivity
* Calling activity context
* @return true in case of success, false in case of failure
*/
boolean login(Handler handler, Context fromActivity);
/**
* Log out of the connector if possible.
*/
void logout();
/**
* Returns the status of the last {@link #login(Handler, Context)} request.
*
*/
boolean isLoggedIn();
/**
* User-centered string describing the current login/connection status
*
*/
String getLoginStatusString();
/**
* Name the user has in this connector or empty string if not applicable.
* It might be necessary to execute {@link #login(Handler, Context)} before this information is valid.
*
*/
String getUserName();
/**
* Number of caches the user has found in this connector.
* Normally retrieved/updated with {@link #login(Handler, Context)}.
* Might be stale as changes on the connectors site are generally not notified.
*
*/
int getCachesFound();
}
|