net.java.sip.communicator.service.protocol
Interface OperationSetExtendedAuthorizations

All Superinterfaces:

OperationSet

All Known Implementing Classes:

OperationSetExtendedAuthorizationsIcqImpl, OperationSetExtendedAuthorizationsJabberImpl

public interface OperationSetExtendedAuthorizations
extends OperationSet

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

Nested Class Summary

static class

OperationSetExtendedAuthorizations.SubscriptionStatus The available subscription of the contact.

Method Summary

void	explicitAuthorize(Contact contact) Send a positive authorization to contact thus allowing them to add us to their contact list without needing to first request an authorization.
OperationSetExtendedAuthorizations.SubscriptionStatus	getSubscriptionStatus(Contact contact) Returns the subscription status for the contact or if not available returns null.
void	reRequestAuthorization(AuthorizationRequest request, Contact contact) Send an authorization request, requesting contact to add them to our contact list?

Method Detail

explicitAuthorize

void explicitAuthorize(Contact contact)
                       throws OperationFailedException

Send a positive authorization to contact thus allowing them to add us to their contact list without needing to first request an authorization.

Parameters:

contact - the Contact whom we're granting authorization prior to receiving a request.

Throws:

OperationFailedException - if we fail sending the authorization.

reRequestAuthorization

void reRequestAuthorization(AuthorizationRequest request,
                            Contact contact)
                            throws OperationFailedException

Send an authorization request, requesting contact to add them to our contact list?

Parameters:

request - the AuthorizationRequest that we'd like the protocol provider to send to contact.

contact - the Contact who we'd be asking for an authorization.

Throws:

OperationFailedException - if we fail sending the authorization request.

getSubscriptionStatus

OperationSetExtendedAuthorizations.SubscriptionStatus getSubscriptionStatus(Contact contact)

Returns the subscription status for the contact or if not available returns null.

Parameters:

contact - the contact to query for subscription status.

Returns:

the subscription status for the contact or if not available returns null.