/* * Copyright 2000-2009 JetBrains s.r.o. * * 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 com.intellij.openapi.options; import com.intellij.openapi.Disposable; import com.intellij.openapi.util.Disposer; import com.intellij.openapi.util.Factory; import com.intellij.ui.UserActivityListener; import com.intellij.ui.UserActivityWatcher; import com.intellij.util.containers.ContainerUtil; import org.jetbrains.annotations.NotNull; import javax.swing.*; import java.util.List; /** * This class presents an abstraction of user interface transactional editor provider of some abstract data type. * {@link #getComponent()} should be called before {@link #resetFrom(Object)} */ public abstract class SettingsEditor implements Disposable { private final List> myListeners = ContainerUtil.createLockFreeCopyOnWriteList(); private UserActivityWatcher myWatcher; private boolean myIsInUpdate = false; private final Factory mySettingsFactory; private CompositeSettingsEditor myOwner; private JComponent myEditorComponent; protected abstract void resetEditorFrom(Settings s); protected abstract void applyEditorTo(Settings s) throws ConfigurationException; @NotNull protected abstract JComponent createEditor(); protected void disposeEditor() { } public SettingsEditor() { this(null); } public SettingsEditor(Factory settingsFactory) { mySettingsFactory = settingsFactory; Disposer.register(this, new Disposable() { @Override public void dispose() { disposeEditor(); uninstallWatcher(); } }); } public Settings getSnapshot() throws ConfigurationException { if (myOwner != null) return myOwner.getSnapshot(); Settings settings = mySettingsFactory.create(); applyTo(settings); return settings; } final void setOwner(CompositeSettingsEditor owner) { myOwner = owner; } public final CompositeSettingsEditor getOwner() { return myOwner; } public Factory getFactory() { return mySettingsFactory; } public final void resetFrom(Settings s) { myIsInUpdate = true; try { resetEditorFrom(s); } finally { myIsInUpdate = false; } } public final void applyTo(Settings s) throws ConfigurationException { applyEditorTo(s); } public final JComponent getComponent() { if (myEditorComponent == null) { myEditorComponent = createEditor(); installWatcher(myEditorComponent); } return myEditorComponent; } @Override public final void dispose() { } protected void uninstallWatcher() { myWatcher = null; } protected void installWatcher(JComponent c) { myWatcher = new UserActivityWatcher(); myWatcher.register(c); UserActivityListener userActivityListener = new UserActivityListener() { @Override public void stateChanged() { fireEditorStateChanged(); } }; myWatcher.addUserActivityListener(userActivityListener, this); } public final void addSettingsEditorListener(SettingsEditorListener listener) { myListeners.add(listener); } public final void removeSettingsEditorListener(SettingsEditorListener listener) { myListeners.remove(listener); } protected final void fireEditorStateChanged() { if (myIsInUpdate || myListeners == null) return; for (SettingsEditorListener listener : myListeners) { listener.stateChanged(this); } } }