/*
 * ECatalog is a database front-end, with two main features:
 * 1. Use of preferences
 *  A preference-based approach, where the user is allowed to define the importance of each criterion.
 *  Then the items are ranked accordingly to his criteria.
 * 2. Trade-off analysis
 *  A cooperative database approach, where the system "argues" with the user about his criteria.
 *  When there are no matching items, the system explains the minimal conflicting set and
 *  give some possible strong and weak relaxations about his criteria.
 * This package also containts the software and the set-up details used for our User Study,
 * comparing the use or not of the two previous features mentioned above.
 *
 * Copyright (C) 2006 David Portabella Clotet, Artificial Intelligence Laboratory, EPFL
 * 
 * This file is part of ecatalog-1.0.zip
 * 
 * ECatalog is free software and a free user study set-up;
 * you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 * 
 * ECatalog is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with ECatalog; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 * 
 * @version 1.0
 * @author David Portabella
 * To contact the author:
 * email: david@portabella.name and david.portabella@epfl.ch
 * 
 * More information about ECatalog:
 *  http://sourceforge.net/projects/ecatalog/
 *  http://icwww.epfl.ch/~portabel/ecatalogs/
 */

package ecatalog.gui.criteriaSelection;

import ecatalog.gui.MainGui;
import ecatalog.ECatalog;
import ecatalog.db.*;

import javax.swing.JPanel;
import java.sql.SQLException;
import org.w3c.dom.Element;
import javax.xml.bind.JAXBException;

/* A GUI to let the user define a constraint */
public abstract class ConstraintGui {
    MainGui mainGui;
    Database db;
    ECatalog ecatalog;
    WeightSelector weightSelector;
    JPanel mainPanel;

    /* configure the constraint gui */
    abstract public void configure(Element config) throws Exception;

    /* This class must be overloaded. Create the db.Constraint, init the weightSelector and init the gui*/
    public void attach(MainGui mainGui, Database db, ECatalog ecatalog, WeightSelector weightSelector) {
	this.mainGui = mainGui;
	this.db = db;
	this.ecatalog = ecatalog;
	this.weightSelector = weightSelector;

	if (weightSelector != null)
	    weightSelector.setConstraintGui(this);
    }

    /* Remove the constraint */
    public abstract void detach();  

    public abstract void setEnabled(boolean enabled);

    public abstract String getConstraintTypeLabel();
    
    public abstract void reset();

    public abstract void update() throws SQLException;

    public abstract void requestFocus();
    
    public abstract Constraint getConstraint();
}