From 1126c99a5fdda4755c60766f51e207469b020a38 Mon Sep 17 00:00:00 2001
From: Emil Ivov <emcho@jitsi.org>
Date: Thu, 22 Feb 2007 12:35:48 +0000
Subject: [PATCH] Added multichat operation set definition and Gibberish
 protocol implementation. Related issues: Issue #241 , Issue #244, Issue #250

Defined an op set for explicit handling of authorizations.
---
 .../OperationSetExtendedAuthorizations.java   | 44 +++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 src/net/java/sip/communicator/service/protocol/OperationSetExtendedAuthorizations.java

diff --git a/src/net/java/sip/communicator/service/protocol/OperationSetExtendedAuthorizations.java b/src/net/java/sip/communicator/service/protocol/OperationSetExtendedAuthorizations.java
new file mode 100644
index 000000000..b6ec6bf58
--- /dev/null
+++ b/src/net/java/sip/communicator/service/protocol/OperationSetExtendedAuthorizations.java
@@ -0,0 +1,44 @@
+/*
+ * SIP Communicator, 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
+{
+    /**
+     * 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;
+}