Application: gvSIG desktop » gvSIG projections

import java.util.Set;

import org.gvsig.proj.catalog.CRSDefinition;

import org.gvsig.proj.catalog.TransformationDefinition;

import org.gvsig.tools.dynobject.DynObject;

    /**

     * Gets the list of recently used CoordinateReferenceSystems.

     * 

     * @return A <code>RecentHistory</code> object, which can be used to add new

     * elements to the history or to iterate on history elements.

     */

    RecentHistory<CRSDefinition> getCoordinateReferenceSystemHistory();

    /**

     * Gets the list of recently used CoordinateTransformations.

     * 

     * @return A <code>RecentHistory</code> object, which can be used to add new

     * elements to the history or to iterate on history elements.

     */

    RecentHistory<TransformationDefinition> getTransformationHistory();

    /**

     * Gets the list of recently used strings in the CRS search UI.

     * 

     * @return A <code>RecentHistory</code> object, which can be used to add new

     * elements to the history or to iterate on history elements.

     */

    /**

     * Gets the list of recently used strings in the CoordinateTransformation search UI.

     * 

     * @return A <code>RecentHistory</code> object, which can be used to add new

     * elements to the history or to iterate on history elements.

     */

    /**

     * Gets the list of favorite CoordinateReferenceSystems.

     * 

     * @return A <code>List</code> object, which can be used to add new favorites

     * or to iterate on existing favorites.

     */

    Set<CRSDefinition> getCoordinateReferenceSystemFavorites();

    /**

     * Gets the list of favorite CoordinateTransformations.

     * 

     * @return A <code>List</code> object, which can be used to add new favorites

     * or to iterate on existing favorites.

     */

    Set<TransformationDefinition> getTransformationFavorites();

    /**

     * <p>Gets the preferences of the manager, as a DynObject. Don't store an instance of

     * this object, use this method to retrieve it when needed, since it is only updated

     * when retrieved.</p>

     * 

     * <p>The object contains the following fields:

     * <ul>

     * <li><code>crsHistory</code> of type List (containing {@code CRSDefinition}s)</li>

     * <li><code>crsHistorySize</code> of type Integer, which defines the maximum number of elements to store on

     * the CRS history</li>

     * <li><code>transformationHistory</code> of type List (containing {@code TransformationDefinition}s)</li>

     * <li><code>transformationHistorySize</code> of type Integer, which defines the maximum number of elements to store on

     * the transformation history</li>

     * <li><code>crsTextFilterHistory</code> of type List (containing {@code String}s)</li>

     * <li><code>crsTextFilterHistorySize</code> of type Integer, which defines the maximum number of elements to store on

     * the CRS text filter history</li>

     * <li><code>transformationTextFilterHistory</code> of type List (containing {@code String}s)</li>

     * <li><code>transformationTextFilterHistorySize</code> of type Integer, which defines the maximum number of elements to store on

     * the transformation text filter history</li>

     * <li><code>crsFavorites</code> of type List (containing {@code CRSDefinition}s)</li>

     * <li><code>transformationFavorites</code> of type List (containing {@code TransformationDefinition}s)</li>

     * </ul>

     * </p>

     * 

     * @return

     */

    public DynObject getPreferences();

    /**

     * Sets the preferences of the plugin, as a DynObject. The favorite and history lists

     * will be updated according to the provided DynObject values.

     * 

     * Check {@link #getPreferences()}

     * documentation to see the expected structure of the DynObject.

     */

    public void setPreferences(DynObject preferences);