/** * * Copyright 2003-2007 Jive Software. * * 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.smack.filter; import org.jivesoftware.smack.packet.Packet; import org.jivesoftware.smack.util.StringUtils; /** * Filter for packets where the "from" field exactly matches a specified JID. If the specified * address is a bare JID then the filter will match any address whose bare JID matches the * specified JID. But if the specified address is a full JID then the filter will only match * if the sender of the packet matches the specified resource. * * @author Gaston Dombiak */ public class FromMatchesFilter implements PacketFilter { private String address; /** * Flag that indicates if the checking will be done against bare JID addresses or full JIDs. */ private boolean matchBareJID = false; /** * @see FromMatchesFilter#create(String) */ @Deprecated public FromMatchesFilter(String address) { this(address, "".equals(StringUtils.parseResource(address))); } /** * Creates a filter matching on the "from" field. The from address must be the same as the * filter address. The second parameter specifies whether the full or the bare addresses are * compared. * * @param address The address to filter for. If null is given, the packet must not * have a from address. * @param matchBare */ public FromMatchesFilter(String address, boolean matchBare) { this.address = (address == null) ? null : address.toLowerCase(); matchBareJID = matchBare; } /** * Creates a filter matching on the "from" field. If the filter address is bare, compares * the filter address with the bare from address. Otherwise, compares the filter address * with the full from address. * * @param address The address to filter for. If null is given, the packet must not * have a from address. */ public static FromMatchesFilter create(String address) { return new FromMatchesFilter(address, "".equals(StringUtils.parseResource(address))) ; } /** * Creates a filter matching on the "from" field. Compares the bare version of from and filter * address. * * @param address The address to filter for. If null is given, the packet must not * have a from address. */ public static FromMatchesFilter createBare(String address) { address = (address == null) ? null : StringUtils.parseBareAddress(address); return new FromMatchesFilter(address, true); } /** * Creates a filter matching on the "from" field. Compares the full version of from and filter * address. * * @param address The address to filter for. If null is given, the packet must not * have a from address. */ public static FromMatchesFilter createFull(String address) { return new FromMatchesFilter(address, false); } public boolean accept(Packet packet) { String from = packet.getFrom(); if (from == null) { return address == null; } if (matchBareJID) { from = StringUtils.parseBareAddress(from).toLowerCase(); } return address.equals(from); } public String toString() { return "FromMatchesFilter: " + address; } }