/******************************************************************************

  * PicManCommonFacade.java - Business Interface common to the PicMan apps

  * 

  * PicMan - The BuckoSoft Picture Manager in Java

  * Copyright(c) 2008 - Dick Balaska

  * 

  */

 package com.buckosoft.PicMan.business.common;

 import java.util.LinkedList;

 import java.util.List;

 import com.buckosoft.PicMan.business.SetChangedListener;

 import com.buckosoft.PicMan.domain.SetSize;

 import com.buckosoft.PicMan.domain.SyncLogEntry;

 /** Business Interface common to the PicMan apps.

  * @author Dick Balaska

  * @since 2008/11/10

  * @see <a href="http://cvs.buckosoft.com/Projects/java/PicMan/PicManService/src/com/buckosoft/PicMan/business/common/PicManCommonFacade.java">PicManCommonFacade.java</a>

  */

 public interface PicManCommonFacade {

         ///////////////////////////////////////////////////////////////////////////

         /* Error Manager */

         /** Add an entry to the Error Log.

          * @param t The Throwable to be logged.

          */

         void addError(Throwable t);

         /** Get a Reference to the Error Log

          * @return The Error Log

          */

         List<Throwable>        getErrorLog();

         /** Fetch an error from our table

          * @param index The table index

          * @return The Exception

          */

         Throwable                getError(int index);

         /** Delete any entries in the Error Log

          */

         void        emptyErrorLog();

         /** Return a reference to the sync log

          * @return the syncLog 

          */

         LinkedList<SyncLogEntry> getSyncLog();

         /** Add a sync entry to the log

          * @param sle The SyncLogEntry to add

          */

         void addSyncToLog(SyncLogEntry sle);

         /** Get the maximum displayed sync log lines in the status page.

          * @return the Count

          */

         int        getSyncLogMaxCount();

         /** Add this SetChangedListener to the global notification list.

          * @param setChangedListener The Object who wishes to be notified when a set changes

          */

         void        addSetChangedListener(SetChangedListener setChangedListener);

         /** Remove this SetChangedListener from the global notification list.

          * @param setChangedListener The Object who no longer wishes to be notified of changes.

          */

         void        removeSetChangedListener(SetChangedListener setChangedListener);

         /** A set, or the contents of a set, has changed

          * @param setSize The set and size that has changed

          */

         void        fireSetSizeChanged(SetSize setSize);

 }