source: src/main/java/genius/core/Domain.java

package genius.core;

import java.util.List;
import java.util.Random;

import genius.core.issue.Issue;
import genius.core.issue.Objective;

/**
 * 
 * @author W.Pasman
 *
 */
public interface Domain {

        /**
         * @return all objectives (note, {@link Issue} is an {@link Objective}) in
         *         the domain.
         */
        List<Objective> getObjectives();

        /**
         * @return the highest level {@link Objective}.
         */
        Objective getObjectivesRoot();

        /**
         * 
         * @return All {@link Issue}s in the domain, sorted to preorder.This may be
         *         computationally expensive
         */
        List<Issue> getIssues();

        /**
         * @param r
         *            random variable. if null, a new {@link Random} will be used.
         * @return a random {@link Bid} in this domain.
         */
        Bid getRandomBid(Random r);

        /**
         * 
         * @return number of all possible bids in the domain. Does not care of
         *         constraints.
         */
        long getNumberOfPossibleBids();

        /**
         * @return name of this domain.
         */
        String getName();

}