/** * * Copyright 2015-2017 Ishan Khanna, Fernando Ramirez 2019 Florian Schmaus * * 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 org.jivesoftware.smackx.geoloc; import java.util.List; import java.util.Map; import java.util.Set; import java.util.WeakHashMap; import java.util.concurrent.CopyOnWriteArraySet; import org.jivesoftware.smack.AsyncButOrdered; import org.jivesoftware.smack.ConnectionCreationListener; import org.jivesoftware.smack.Manager; import org.jivesoftware.smack.SmackException.NoResponseException; import org.jivesoftware.smack.SmackException.NotConnectedException; import org.jivesoftware.smack.XMPPConnection; import org.jivesoftware.smack.XMPPConnectionRegistry; import org.jivesoftware.smack.XMPPException.XMPPErrorException; import org.jivesoftware.smack.packet.ExtensionElement; import org.jivesoftware.smack.packet.Message; import org.jivesoftware.smackx.disco.ServiceDiscoveryManager; import org.jivesoftware.smackx.geoloc.packet.GeoLocation; import org.jivesoftware.smackx.geoloc.provider.GeoLocationProvider; import org.jivesoftware.smackx.pep.PepListener; import org.jivesoftware.smackx.pep.PepManager; import org.jivesoftware.smackx.pubsub.EventElement; import org.jivesoftware.smackx.pubsub.ItemsExtension; import org.jivesoftware.smackx.pubsub.PayloadItem; import org.jivesoftware.smackx.pubsub.PubSubException.NotALeafNodeException; import org.jivesoftware.smackx.xdata.provider.FormFieldChildElementProviderManager; import org.jxmpp.jid.BareJid; import org.jxmpp.jid.EntityBareJid; import org.jxmpp.jid.Jid; /** * Entry point for Smacks API for XEP-0080: User Location. *
* To publish a UserLocation, please use {@link #sendGeolocation(GeoLocation)} method. This will publish the node. *
* To stop publishing a UserLocation, please use {@link #stopPublishingGeolocation()} method. This will send a disble publishing signal. *
* To add a {@link GeoLocationListener} in order to remain updated with other users GeoLocation, use {@link #addGeoLocationListener(GeoLocationListener)} method. *
* To link a GeoLocation with {@link Message}, use `message.addExtension(geoLocation)`. *
* An example for illustration is provided inside GeoLocationTest inside the test package. *
* @see * XEP-0080: User Location */ public final class GeoLocationManager extends Manager { public static final String GEOLOCATION_NODE = "http://jabber.org/protocol/geoloc"; public static final String GEOLOCATION_NOTIFY = GEOLOCATION_NODE + "+notify"; private static final Map INSTANCES = new WeakHashMap<>(); private static boolean ENABLE_USER_LOCATION_NOTIFICATIONS_BY_DEFAULT = true; private final Set geoLocationListeners = new CopyOnWriteArraySet<>(); private final AsyncButOrdered asyncButOrdered = new AsyncButOrdered(); private final ServiceDiscoveryManager serviceDiscoveryManager; private final PepManager pepManager; static { FormFieldChildElementProviderManager.addFormFieldChildElementProvider( GeoLocationProvider.GeoLocationFormFieldChildElementProvider.INSTANCE); XMPPConnectionRegistry.addConnectionCreationListener(new ConnectionCreationListener() { @Override public void connectionCreated(XMPPConnection connection) { getInstanceFor(connection); } }); } /** * Retrieves a {@link GeoLocationManager} for the specified {@link XMPPConnection}, creating one if it doesn't * already exist. * * @param connection The connection the manager is attached to. * @return The new or existing manager. */ public static synchronized GeoLocationManager getInstanceFor(XMPPConnection connection) { GeoLocationManager geoLocationManager = INSTANCES.get(connection); if (geoLocationManager == null) { geoLocationManager = new GeoLocationManager(connection); INSTANCES.put(connection, geoLocationManager); } return geoLocationManager; } private GeoLocationManager(XMPPConnection connection) { super(connection); pepManager = PepManager.getInstanceFor(connection); pepManager.addPepListener(new PepListener() { @Override public void eventReceived(EntityBareJid from, EventElement event, Message message) { if (!GEOLOCATION_NODE.equals(event.getEvent().getNode())) { return; } final BareJid contact = from.asBareJid(); asyncButOrdered.performAsyncButOrdered(contact, () -> { ItemsExtension itemsExtension = (ItemsExtension) event.getEvent(); List items = itemsExtension.getExtensions(); @SuppressWarnings("unchecked") PayloadItem payload = (PayloadItem) items.get(0); GeoLocation geoLocation = payload.getPayload(); for (GeoLocationListener listener : geoLocationListeners) { listener.onGeoLocationUpdated(contact, geoLocation, message); } }); } }); serviceDiscoveryManager = ServiceDiscoveryManager.getInstanceFor(connection); if (ENABLE_USER_LOCATION_NOTIFICATIONS_BY_DEFAULT) { enableUserLocationNotifications(); } } public void sendGeoLocationToJid(GeoLocation geoLocation, Jid jid) throws InterruptedException, NotConnectedException { final XMPPConnection connection = connection(); Message geoLocationMessage = connection.getStanzaFactory().buildMessageStanza() .to(jid) .addExtension(geoLocation) .build(); connection.sendStanza(geoLocationMessage); } /** * Returns true if the message contains a GeoLocation extension. * * @param message the message to check if contains a GeoLocation extension or not * @return a boolean indicating whether the message is a GeoLocation message */ public static boolean isGeoLocationMessage(Message message) { return GeoLocation.from(message) != null; } /** * Send geolocation through the PubSub node. * * @param geoLocation TODO javadoc me please * @throws InterruptedException if the calling thread was interrupted. * @throws NotConnectedException if the XMPP connection is not connected. * @throws XMPPErrorException if there was an XMPP error returned. * @throws NoResponseException if there was no response from the remote entity. * @throws NotALeafNodeException if a PubSub leaf node operation was attempted on a non-leaf node. */ public void sendGeolocation(GeoLocation geoLocation) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException, NotALeafNodeException { pepManager.publish(GeoLocation.NAMESPACE, new PayloadItem(geoLocation)); } /** * Send empty geolocation through the PubSub node. * * @throws InterruptedException if the calling thread was interrupted. * @throws NotConnectedException if the XMPP connection is not connected. * @throws XMPPErrorException if there was an XMPP error returned. * @throws NoResponseException if there was no response from the remote entity. * @throws NotALeafNodeException if a PubSub leaf node operation was attempted on a non-leaf node. */ public void stopPublishingGeolocation() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException, NotALeafNodeException { pepManager.publish(GeoLocation.NAMESPACE, new PayloadItem(GeoLocation.EMPTY_GEO_LOCATION)); } public void setGeoLocationNotificationsEnabledByDefault(boolean bool) { ENABLE_USER_LOCATION_NOTIFICATIONS_BY_DEFAULT = bool; } public void enableUserLocationNotifications() { serviceDiscoveryManager.addFeature(GEOLOCATION_NOTIFY); } public void disableGeoLocationNotifications() { serviceDiscoveryManager.removeFeature(GEOLOCATION_NOTIFY); } public boolean addGeoLocationListener(GeoLocationListener geoLocationListener) { return geoLocationListeners.add(geoLocationListener); } public boolean removeGeoLocationListener(GeoLocationListener geoLocationListener) { return geoLocationListeners.remove(geoLocationListener); } }