/*
* Jitsi, the OpenSource Java VoIP and Instant Messaging client.
*
* Copyright @ 2015 Atlassian Pty Ltd
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.java.sip.communicator.service.protocol;
import java.util.*;
import net.java.sip.communicator.service.protocol.event.*;
/**
* An abstract base implementation of the {@link Contact} interface which is to
* aid implementers.
*
* @author Lyubomir Marinov
*/
public abstract class AbstractContact
implements Contact
{
/**
* The list of <tt>ContactResourceListener</tt>-s registered in this
* contact.
*/
private Collection<ContactResourceListener> resourceListeners;
@Override
public boolean equals(Object obj)
{
if (obj == null)
return false;
else if (obj == this)
return true;
else if (!obj.getClass().equals(getClass()))
return false;
else
{
Contact contact = (Contact) obj;
ProtocolProviderService protocolProvider
= contact.getProtocolProvider();
ProtocolProviderService thisProtocolProvider
= getProtocolProvider();
if ((protocolProvider == null)
? (thisProtocolProvider == null)
: protocolProvider.equals(thisProtocolProvider))
{
String address = contact.getAddress();
String thisAddress = getAddress();
return
(address == null)
? (thisAddress == null)
: address.equals(thisAddress);
}
else
return false;
}
}
@Override
public int hashCode()
{
int hashCode = 0;
ProtocolProviderService protocolProvider = getProtocolProvider();
if (protocolProvider != null)
hashCode += protocolProvider.hashCode();
String address = getAddress();
if (address != null)
hashCode += address.hashCode();
return hashCode;
}
/**
* Indicates if this contact supports resources.
* <p>
* This default implementation indicates no support for contact resources.
*
* @return <tt>true</tt> if this contact supports resources, <tt>false</tt>
* otherwise
*/
public boolean supportResources()
{
return false;
}
/**
* Returns a collection of resources supported by this contact or null
* if it doesn't support resources.
* <p>
* This default implementation indicates no support for contact resources.
*
* @return a collection of resources supported by this contact or null
* if it doesn't support resources
*/
public Collection<ContactResource> getResources()
{
return null;
}
/**
* Adds the given <tt>ContactResourceListener</tt> to listen for events
* related to contact resources changes.
*
* @param l the <tt>ContactResourceListener</tt> to add
*/
public void addResourceListener(ContactResourceListener l)
{
if (resourceListeners == null)
resourceListeners = new ArrayList<ContactResourceListener>();
synchronized (resourceListeners)
{
resourceListeners.add(l);
}
}
/**
* Removes the given <tt>ContactResourceListener</tt> listening for events
* related to contact resources changes.
*
* @param l the <tt>ContactResourceListener</tt> to remove
*/
public void removeResourceListener(ContactResourceListener l)
{
if (resourceListeners == null)
return;
synchronized (resourceListeners)
{
resourceListeners.remove(l);
}
}
/**
* Notifies all registered <tt>ContactResourceListener</tt>s that an event
* has occurred.
*
* @param event the <tt>ContactResourceEvent</tt> to fire notification for
*/
protected void fireContactResourceEvent(ContactResourceEvent event)
{
if (resourceListeners == null)
return;
Collection<ContactResourceListener> listeners;
synchronized (resourceListeners)
{
listeners
= new ArrayList<ContactResourceListener>(resourceListeners);
}
Iterator<ContactResourceListener> listenersIter = listeners.iterator();
while (listenersIter.hasNext())
{
if (event.getEventType() == ContactResourceEvent.RESOURCE_ADDED)
listenersIter.next().contactResourceAdded(event);
else if (event.getEventType()
== ContactResourceEvent.RESOURCE_REMOVED)
listenersIter.next().contactResourceRemoved(event);
else if (event.getEventType()
== ContactResourceEvent.RESOURCE_MODIFIED)
listenersIter.next().contactResourceModified(event);
}
}
/**
* Returns the same as <tt>getAddress</tt> function.
*
* @return the address of the contact.
*/
public String getPersistableAddress()
{
return getAddress();
}
/**
* Whether contact is mobile one. Logged in only from mobile device.
* @return whether contact is mobile one.
*/
public boolean isMobile()
{
return false;
}
}