com.atakmap.android.contact

Class ContactConnectorManager

java.lang.Object

com.atakmap.android.contact.ContactConnectorManager

public class ContactConnectorManager
extends java.lang.Object

Searches for components to handle communications for contacts Including, but not limited to: XMPP, VOIP, EMAIL, PHONE, SMS Provides a default implementation for several connectors

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ContactConnectorManager.ConnectorFeature Optional features supported by ContactConnectorHandler implementations Profile provided as ActionBroadcastData, e.g.
static class	ContactConnectorManager.ContactConnectorHandler Handler to filter and process connectors

Constructor Summary

Constructors

Constructor and Description
ContactConnectorManager(android.content.Context context, android.content.SharedPreferences preferences)

Method Summary

Modifier and Type	Method and Description
void	addContactHandler(ContactConnectorManager.ContactConnectorHandler handler)
java.util.Collection<Connector>	getConnectors(IndividualContact contact, ContactConnectorManager.ConnectorFeature feature) Get list of connectors which have at least one handler which supports the specified feature, for the given contact e.g.
static java.lang.String	getDefaultConnectorType(android.content.SharedPreferences prefs, java.lang.String contactUID)
java.lang.Object	getFeature(IndividualContact contact, Connector connector, ContactConnectorManager.ConnectorFeature feature) Get feature for the specified contact's connector
java.util.List<java.lang.Object>	getFeatures(IndividualContact contact, ContactConnectorManager.ConnectorFeature feature, int max) Get features for the specified contact
ContactConnectorManager.ContactConnectorHandler	getHandler(java.lang.String connectorType) Find a handler for the specified connector type First searches for registered components that support the specified type Then falls back on default implementation if none is found or none is successful in initiating contact
ContactConnectorManager.ContactConnectorHandler	getHandlerByName(java.lang.String connectorName) Find a handler by its name or title
java.util.List<ContactConnectorManager.ContactConnectorHandler>	getHandlers() Return all registered connector handlers Handlers are uniquely keyed by name, where registered handlers take priority over the defaults
static long	getLastUsed(android.content.SharedPreferences prefs, java.lang.String contactUID, java.lang.String connectorType)
boolean	initiateContact(IndividualContact contact, Connector connector) Attempt to initiate contact with the specified address First searches for registered components that support the specified type Then falls back on default implementation if none is found or none is successful in initiating contact
boolean	initiateContact(java.lang.String connectorType, java.lang.String contactUID, java.lang.String connectorAddress) Attempt to initiate contact with the specified address First searches for registered components that support the specified type Then falls back on default implementation if none is found or none is successful in initiating contact
void	removeContactHandler(ContactConnectorManager.ContactConnectorHandler handler) Remove a contact handler that has been registered with the ContactConnectorManager.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ContactConnectorManager

public ContactConnectorManager(android.content.Context context,
                               android.content.SharedPreferences preferences)

Method Detail

addContactHandler

public void addContactHandler(ContactConnectorManager.ContactConnectorHandler handler)

removeContactHandler

public void removeContactHandler(ContactConnectorManager.ContactConnectorHandler handler)

Remove a contact handler that has been registered with the ContactConnectorManager.

Parameters:

handler - the registered contact handler.

initiateContact

public boolean initiateContact(IndividualContact contact,
                               Connector connector)

Attempt to initiate contact with the specified address First searches for registered components that support the specified type Then falls back on default implementation if none is found or none is successful in initiating contact

Parameters:

contact - the contact to initate contact with

connector - the connector to use

Returns:

true if the initiation was sucessful otherwise false

initiateContact

public boolean initiateContact(java.lang.String connectorType,
                               java.lang.String contactUID,
                               java.lang.String connectorAddress)

Attempt to initiate contact with the specified address First searches for registered components that support the specified type Then falls back on default implementation if none is found or none is successful in initiating contact

Parameters:

connectorType - required

contactUID - UID or address is required

connectorAddress - UID or address is required

Returns:

true if initiation was successful otherwise false

getHandler

public ContactConnectorManager.ContactConnectorHandler getHandler(java.lang.String connectorType)

Find a handler for the specified connector type First searches for registered components that support the specified type Then falls back on default implementation if none is found or none is successful in initiating contact

Parameters:

connectorType - required

Returns:

the handler

getHandlerByName

public ContactConnectorManager.ContactConnectorHandler getHandlerByName(java.lang.String connectorName)

Find a handler by its name or title

Parameters:

connectorName - Connector name

Returns:

Handler with connector name or null if not found

getHandlers

public java.util.List<ContactConnectorManager.ContactConnectorHandler> getHandlers()

Return all registered connector handlers Handlers are uniquely keyed by name, where registered handlers take priority over the defaults

Returns:

List of connector handlers

getConnectors

public java.util.Collection<Connector> getConnectors(IndividualContact contact,
                                                     ContactConnectorManager.ConnectorFeature feature)

Get list of connectors which have at least one handler which supports the specified feature, for the given contact e.g. is an avatar available for the contact

Parameters:

contact -

feature -

Returns:

getFeatures

public java.util.List<java.lang.Object> getFeatures(IndividualContact contact,
                                                    ContactConnectorManager.ConnectorFeature feature,
                                                    int max)

Get features for the specified contact

Parameters:

contact -

feature -

max - limit number of features

Returns:

getFeature

public java.lang.Object getFeature(IndividualContact contact,
                                   Connector connector,
                                   ContactConnectorManager.ConnectorFeature feature)

Get feature for the specified contact's connector

Parameters:

contact - the contact to be used

connector - the connector

feature - the feature desired

Returns:

the feature for the specified contact/connector

getLastUsed

public static long getLastUsed(android.content.SharedPreferences prefs,
                               java.lang.String contactUID,
                               java.lang.String connectorType)

getDefaultConnectorType

public static java.lang.String getDefaultConnectorType(android.content.SharedPreferences prefs,
                                                       java.lang.String contactUID)