2 * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
3 * Copyright (C) $$Year-Rel$$ The Jalview Authors
5 * This file is part of Jalview.
7 * Jalview is free software: you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation, either version 3
10 * of the License, or (at your option) any later version.
12 * Jalview is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty
14 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
15 * PURPOSE. See the GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with Jalview. If not, see <http://www.gnu.org/licenses/>.
19 * The Jalview Authors are detailed in the 'AUTHORS' file.
21 package jalview.datamodel.features;
23 import jalview.datamodel.SequenceFeature;
26 * An interface to describe a set of one or more feature matchers, where all
27 * matchers are combined with either AND or OR
32 public interface FeatureMatcherSetI
35 * Answers true if the feature provided passes this matcher's match condition
40 boolean matches(SequenceFeature feature);
43 * Adds (ANDs) match condition m to this object's matcher set
46 * @throws IllegalStateException
47 * if an attempt is made to AND to existing OR-ed conditions
49 void and(FeatureMatcherI m);
52 * Answers true if any second condition is AND-ed with this one, false if it
60 * Adds (ORs) the given condition to this object's match conditions
63 * @throws IllegalStateException
64 * if an attempt is made to OR to existing AND-ed conditions
66 void or(FeatureMatcherI m);
69 * Answers an iterator over the combined match conditions
73 Iterable<FeatureMatcherI> getMatchers();
76 * Answers true if this object contains no conditions
83 * Answers a string representation of this object suitable for use when
84 * persisting data, in a format that can be reliably read back. Any changes to
85 * the format should be backwards compatible.
87 String toStableString();