/// <summary>
/// Change the active list
/// </summary>
/// <param name="name"></param>
/// <param name="cb">Callback for the server result</param>
/// <param name="cbArg">Callback arguments for the result when needed</param>
public void ChangeActiveList(string name, IqCB cb, object cbArg)
{
/*
Example: Client requests change of active list:
<iq from='[email protected]/orchard' type='set' id='active1'>
<query xmlns='jabber:iq:privacy'>
<active name='special'/>
</query>
</iq>
The server MUST activate and apply the requested list before sending the result back to the client.
Example: Server acknowledges success of active list change:
<iq type='result' id='active1' to='[email protected]/orchard'/>
If the user attempts to set an active list but a list by that name does not exist, the server MUST return an <item-not-found/> stanza error to the user:
Example: Client attempts to set a non-existent list as active:
<iq to='[email protected]/orchard' type='error' id='active2'>
<query xmlns='jabber:iq:privacy'>
<active name='The Empty Set'/>
</query>
<error type='cancel'>
<item-not-found
xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/>
</error>
</iq>
*/
PrivacyIq pIq = new PrivacyIq();
pIq.Type = CSS.IM.XMPP.protocol.client.IqType.set;
pIq.Query.Active = new Active(name);
SendStanza(pIq, cb, cbArg);
}
/// <summary>
/// Update the list with the given name and rules.
/// </summary>
/// <remarks>
/// Specify the desired changes to the list by including all elements/rules in the list
/// (not the "delta")
/// </remarks>
/// <param name="name">name of this list</param>
/// <param name="rules">rules of this list</param>
/// <param name="cb">Callback for the server result</param>
/// <param name="cbArg">Callback arguments for the result when needed</param>
public void UpdateList(string name, Item[] rules, IqCB cb, object cbArg)
{
PrivacyIq pIq = new PrivacyIq();
pIq.Type = CSS.IM.XMPP.protocol.client.IqType.set;
// create a new list with the given name
List list = new List(name);
list.AddItems(rules);
// add the list to the query
pIq.Query.AddList(list);
SendStanza(pIq, cb, cbArg);
}
/// <summary>
/// Sends a PrivacyIq over the active connection
/// </summary>
/// <param name="pIq"></param>
/// <param name="cb"></param>
/// <param name="cbArg"></param>
private void SendStanza(PrivacyIq pIq, IqCB cb, object cbArg)
{
if (cb == null)
m_connection.Send(pIq);
else
m_connection.IqGrabber.SendIq(pIq, cb, cbArg);
}
/// <summary>
/// Remove a privacy list
/// </summary>
/// <param name="name">name of the privacy list to remove</param>
/// <param name="cb">Callback for the server result</param>
/// <param name="cbArg">Callback arguments for the result when needed</param>
public void RemoveList(string name, IqCB cb, object cbArg)
{
PrivacyIq pIq = new PrivacyIq();
pIq.Type = CSS.IM.XMPP.protocol.client.IqType.set;
pIq.Query.AddList(new List(name));
SendStanza(pIq, cb, cbArg);
}
/// <summary>
/// Retrieving all Privacy Lists
/// </summary>
/// <param name="cb">Callback for the server result</param>
/// <param name="cbArg">Callback arguments for the result when needed</param>
public void GetLists(IqCB cb, object cbArg)
{
/*
Example: Client requests names of privacy lists from server:
<iq from='[email protected]/orchard' type='get' id='getlist1'>
<query xmlns='jabber:iq:privacy'/>
</iq>
Example: Server sends names of privacy lists to client, preceded by active list and default list:
<iq type='result' id='getlist1' to='[email protected]/orchard'>
<query xmlns='jabber:iq:privacy'>
<active name='private'/>
<default name='public'/>
<list name='public'/>
<list name='private'/>
<list name='special'/>
</query>
</iq>
*/
PrivacyIq pIq = new PrivacyIq();
pIq.Type = CSS.IM.XMPP.protocol.client.IqType.get;
SendStanza(pIq, cb, cbArg);
}
/// <summary>
/// Requests a privacy list from the server by its name
/// </summary>
/// <param name="name">name of the privacy list to retrieve</param>
/// <param name="cb">Callback for the server result</param>
/// <param name="cbArg">Callback arguments for the result when needed</param>
public void GetList(string name, IqCB cb, object cbArg)
{
/*
Example: Client requests a privacy list from server:
<iq from='[email protected]/orchard' type='get' id='getlist2'>
<query xmlns='jabber:iq:privacy'>
<list name='public'/>
</query>
</iq>
Example: Server sends a privacy list to client:
<iq type='result' id='getlist2' to='[email protected]/orchard'>
<query xmlns='jabber:iq:privacy'>
<list name='public'>
<item type='jid'
value='*****@*****.**'
action='deny'
order='1'/>
<item action='allow' order='2'/>
</list>
</query>
</iq>
*/
PrivacyIq pIq = new PrivacyIq();
pIq.Type = CSS.IM.XMPP.protocol.client.IqType.get;
pIq.Query.AddList(new List(name));
SendStanza(pIq, cb, cbArg);
}
/// <summary>
/// Decline the use of the default list
/// </summary>
/// <param name="cb">Callback for the server result</param>
/// <param name="cbArg">Callback arguments for the result when needed</param>
public void DeclineDefaultList(IqCB cb, object cbArg)
{
PrivacyIq pIq = new PrivacyIq();
pIq.Type = CSS.IM.XMPP.protocol.client.IqType.set;
pIq.Query.Default = new Default();
SendStanza(pIq, cb, cbArg);
}
/// <summary>
/// Decline the use of any active list
/// </summary>
/// <param name="cb">Callback for the server result</param>
/// <param name="cbArg">Callback arguments for the result when needed</param>
public void DeclineActiveList(IqCB cb, object cbArg)
{
/*
In order to decline the use of any active list, the connected resource MUST send an empty <active/> element
with no 'name' attribute.
Example: Client declines the use of active lists:
<iq from='[email protected]/orchard' type='set' id='active3'>
<query xmlns='jabber:iq:privacy'>
<active/>
</query>
</iq>
Example: Server acknowledges success of declining any active list:
<iq type='result' id='active3' to='[email protected]/orchard'/>
*/
PrivacyIq pIq = new PrivacyIq();
pIq.Type = CSS.IM.XMPP.protocol.client.IqType.set;
pIq.Query.Active = new Active();
SendStanza(pIq, cb, cbArg);
}