blob: 1c797a51a943f2531295071d1f2f85297f26cd06 (
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
/*
* Jitsi, the OpenSource Java VoIP and Instant Messaging client.
*
* Distributable under LGPL license.
* See terms of license at gnu.org.
*/
package net.java.sip.communicator.service.protocol;
/**
* Contains methods that would allow service users to re-request authorizations
* to add a contact to their contact list or, send them an authorization before
* having been asked.
*
* @author Emil Ivov
*/
public interface OperationSetExtendedAuthorizations
extends OperationSet
{
/**
* The available subscription of the contact.
*/
public enum SubscriptionStatus
{
/**
* Subscription state when we are not subscribed
* for the contacts presence statuses.
*/
NotSubscribed,
/**
* Subscription state when we are subscribed for the contact statuses.
*/
Subscribed,
/**
* When we have subscribed for contact statuses, but haven't
* received authorization yet.
*/
SubscriptionPending
}
/**
* Send a positive authorization to <tt>contact</tt> thus allowing them to
* add us to their contact list without needing to first request an
* authorization.
* @param contact the <tt>Contact</tt> whom we're granting authorization
* prior to receiving a request.
* @throws OperationFailedException if we fail sending the authorization.
*/
public void explicitAuthorize(Contact contact)
throws OperationFailedException;
/**
* Send an authorization request, requesting <tt>contact</tt> to add them
* to our contact list?
*
* @param request the <tt>AuthorizationRequest</tt> that we'd like the
* protocol provider to send to <tt>contact</tt>.
* @param contact the <tt>Contact</tt> who we'd be asking for an
* authorization.
* @throws OperationFailedException if we fail sending the authorization
* request.
*/
public void reRequestAuthorization(AuthorizationRequest request,
Contact contact)
throws OperationFailedException;
/**
* Returns the subscription status for the <tt>contact</tt> or
* if not available returns null.
* @param contact the contact to query for subscription status.
* @return the subscription status for the <tt>contact</tt> or
* if not available returns null.
*/
public SubscriptionStatus getSubscriptionStatus(Contact contact);
}
|
