/* * Copyright 2015 Daniel Dittmar * * 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 dan.dit.whatsthat.achievement; import android.text.TextUtils; import java.util.LinkedList; import java.util.Queue; import dan.dit.whatsthat.util.compaction.Compactable; import dan.dit.whatsthat.util.general.RobustObserverController; /** * This class encapsulates data that is set and updated by the client and notifies * listeners like Achievements that are interested in the data changing to update their state. * The AchievementData can be compacted and restored. It is uniquely identified by a data name * and holds a list of listeners. * Created by daniel on 12.05.15. */ public abstract class AchievementData implements Compactable { protected final String mName; private Queue<AchievementDataEvent> mEventFactory = new LinkedList<>(); private RobustObserverController<AchievementDataEventListener, AchievementDataEvent> mObserverController; AchievementData(String dataName) { mName = dataName; mObserverController = new RobustObserverController<>(); if (TextUtils.isEmpty(mName)) { throw new IllegalArgumentException("Null name given for achievement data."); } } protected AchievementDataEvent obtainNewEvent() { if (mEventFactory == null || mEventFactory.isEmpty()) { return new AchievementDataEvent(); } else { return mEventFactory.poll(); } } @Override public int hashCode() { return mName.hashCode(); } @Override public boolean equals(Object other) { if (other instanceof AchievementData) { return mName.equals(((AchievementData) other).mName); } else { return super.equals(other); } } /** * Resets the data. Does not touch the listeners. */ protected abstract void resetData(); public boolean removeListener(AchievementDataEventListener listener) { return mObserverController.removeObserver(listener); } public void addListener(AchievementDataEventListener listener) { mObserverController.addObserver(listener); } public void notifyListeners(AchievementDataEvent event) { mObserverController.notifyObservers(event); mEventFactory.add(event); // free event } }