blob: 45b81025b48a3f676d50efdbf6534cf8f0d63a8b (
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
|
/*
* 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;
/**
* This class is used to represent both incoming and outgoing
* AuthorizationRequests-s
* <p>
* An outgoing Authorization Request is to be created by the user interface
* when an authorization error/challenge has been received by the underlying
* protocol. The user interface or any other bundle responsible of handling
* such requests is to implement the AuthoizationHandler interface and register
* itself as an authorization handler of a protocol provider. Whenever a request
* needs to be sent the protocol provider would ask the the AuthorizationHandler
* to create one through the createAuthorizationRequest() method.
* <p>
* Incoming Authorization requests are delivered to the ProtocolProviderService
* implementation through the AuthorizationHandler.processAuthorizationRequest()
* method.
*
* @author Emil Ivov
*/
public class AuthorizationRequest
{
/**
* The reason phrase that should be sent to the user we're demanding for
* authorization.
*/
private String reason = "";
/**
* Creates an empty authorization request with no reason or any other
* properties.
*/
public AuthorizationRequest()
{
}
/**
* Sets the reason phrase that should be sent to the user we're demanding
* for authorization.
* @param reason a human readable text to be set by the user.
*/
public void setReason(String reason)
{
this.reason = reason;
}
/**
* Returns the reason that should be sent to the remote user when asking
* for authorization.
*
* @return a String containing a reason phrase that should be sent to the
* remote user when asking them for authorization.
*/
public String getReason()
{
return reason;
}
}
|
