Application: gvSIG desktop

<?xml version="1.0" encoding="ISO-8859-1"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>

    <groupId>org.gvsig</groupId>

    <artifactId>org.gvsig.timesupport</artifactId>

    <packaging>pom</packaging>

    <name>${project.artifactId}</name>

    <description>TimeSupport example project</description>

    <parent>

        <groupId>org.gvsig</groupId>

        <artifactId>org.gvsig.desktop.library</artifactId>

        <version>2.0.267</version>

    </parent>

    <build>

        <plugins>

            <plugin>

                <groupId>org.codehaus.mojo</groupId>

                <artifactId>animal-sniffer-maven-plugin</artifactId>

                <configuration>

                    <skip>true</skip>

                </configuration>

            </plugin>

        </plugins>

    </build>

    <dependencyManagement>

        <dependencies>

            <dependency>

                <groupId>org.swinglabs</groupId>

                <artifactId>swingx</artifactId>  	

                <version>1.6</version>

            </dependency>

            <dependency>

                <groupId>com.toedter</groupId>

                <artifactId>jcalendar</artifactId>

                <version>1.3.2</version>  				

            </dependency>	

        </dependencies>

    </dependencyManagement>

    <modules>

        <module>org.gvsig.timesupport.lib</module>

        <module>org.gvsig.timesupport.swing</module>	

    </modules>

</project>

org.gvsig.timesupport.TimeSupportLibrary

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; 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.

 *

 * This program 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 this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.timesupport.animation;

import org.gvsig.timesupport.Interval;

import org.gvsig.timesupport.RelativeInterval;

import org.gvsig.tools.observer.Observable;

public interface TimeAnimation extends Observable {

    public static final int YEAR = 0;

    public static final int MONTH = 1;

    public static final int WEEK = 2;

    public static final int DAY = 3;

    public static final int HOUR = 4;

    public static final int MINUTE = 5;

    public static final int SECOND = 6;

    public static final int MILLISECOND = 7;

    public static final int STOPED = 0;

    public static final int PLAYING = 1;

    public static final int PAUSED = 2;

    public interface TimeAnimationRenderer {

        public void begin();

        public void render(Interval time);

        public void end();

    }

    /**

     * Stops the animation

     */

    public void stop();

    /**

     * Pauses the animation

     */

    public void pause();

    /**

     * Play the animation

     */

    public void play();

    /**

     * Return is the animation is playing.

     *

     * @return

     */

    public boolean isPlaying();

    public int getStatus();

    public RelativeInterval getInterval();

    public void setInterval(RelativeInterval interval);

    public void inferStepScale();

    public void setPauseTime(long time);

    public long getPauseTime();

    public void setFramesPerSecond(double fps);

    public double getFramesPerSecond();

    public long getStep();

    public int getStepScale();

    public void setStep(long step);

    public long getStep(int scale);

    public void setStep(long step, int scale);

    public int getStepCount();

    public RelativeInterval getCurrentTime();

    public int getCurrentPosition();

    public void setCurrentPosition(int position);

    public int getIterations();

    public void setIterations(int iterations);

    public int getCurrentIteration();

    public String getStatusLabel(int status);   

    public String getScaleLabel(int scale);

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; 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.

 *

 * This program 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 this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.timesupport;

/**

 * Exception thrown when there is an error getting a TimeSupport message.

 * 

 * @author gvSIG team

 * @version $Id$

 */

public class AbsoluteInstantTypeNotRegisteredException extends TimeSupportException {

    private static final long serialVersionUID = -4051458353306878010L;

    private static final String MESSAGE =

        "An error has been produced " + "getting the AbsoluteInstantTypeNotRegisteredException";

    private static final String KEY = "_AbsoluteInstantTypeNotRegisteredException";

    /**

     * Creates a new {@link AbsoluteInstantTypeNotRegisteredException}.

     * 

     * @param cause

     *            the original cause

     */

    public AbsoluteInstantTypeNotRegisteredException(int dateTimeFieldTypeNotRegisteredException) {

        super(MESSAGE, null, KEY, serialVersionUID);

    }

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; 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.

 *

 * This program 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 this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.timesupport;

/**

 * Exception thrown when there is an error getting a TimeSupport message.

 * 

 * @author gvSIG team

 * @version $Id$

 */

public class AbsoluteIntervalTypeNotRegisteredException extends TimeSupportException {

    private static final long serialVersionUID = -4051458353306878010L;

    private static final String MESSAGE =

        "An error has been produced " + "getting the AbsoluteIntervalTypeNotRegisteredException";

    private static final String KEY = "_absoluteIntervalTypeNotRegisteredException";

    /**

     * Creates a new {@link AbsoluteIntervalTypeNotRegisteredException}.

     * 

     * @param cause

     *            the original cause

     */

    public AbsoluteIntervalTypeNotRegisteredException(int durationFieldTypeNotRegisteredException) {

        super(MESSAGE, null, KEY, serialVersionUID);

    }

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; 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.

 *

 * This program 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 this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.timesupport;

/**

 * <p>

 * The {@link RelativeInstant} ins inmutable, but sometimes is necessary to

 * edit it. This class is an editable copy of a realtive instant that

 * cab be edited.

 * </p>

 * <p>

 * A huge part of the documentation of this class has been retrieved

 * from the joda-time library.

 * </p>

 * 

 * @see http://joda-time.sourceforge.net

 * @see https://gvsig.org/web/projects/gvsig-desktop/docs/devel/org-gvsig-sensors/1-0.0/analysis-and-design/detailed-view/time-support/libraries/org-gvsig-timesupport-lib

 * 

 * @author gvSIG Team

 * @version $Id$

 *

 */

public interface EditableRelativeInstant extends RelativeInstant{

    /**

     * Set the time from fields. The date part of this object will be unaffected.

     *

     * @param hour

     *          the hour

     * @param minuteOfHour

     *          the minute of the hour

     * @param secondOfMinute

     *          the second of the minute

     * @param millisOfSecond

     *          the millisecond of the second

     * @throws IllegalArgumentException if the value is invalid

     * 

     */

    public void setTime(final int hour, final int minuteOfHour, final int secondOfMinute, final int millisOfSecond);

    /**

     * Set the date from fields. The time part of this object will be unaffected.

     *

     * @param year

     *          the year

     * @param monthOfYear

     *          the month of the year

     * @param dayOfMonth

     *          the day of the month

     * @throws IllegalArgumentException if the value is invalid

     */

    public void setDate(final int year, final int monthOfYear, final int dayOfMonth);

    /**

     * Add a number of years to the date.

     *

     * @param years  the years to add

     * @throws IllegalArgumentException if the value is invalid

     */

    public void addYears(final int years);

    /**

     * Add a number of days to the date.

     *

     * @param days

     *          the days to add

     * @throws IllegalArgumentException if the value is invalid

     */

    public void addDays(final int days);

    /**

     * Add a number of hours to the date.

     *

     * @param hours  

     *          the hours to add

     * @throws IllegalArgumentException if the value is invalid

     */

    public void addHours(final int hours);

    /**

     * Add a number of minutes to the date.

     *

     * @param minutes

     *          the minutes to add

     * @throws IllegalArgumentException if the value is invalid

     */

    public void addMinutes(final int minutes);

    /**

     * Add a number of seconds to the date.

     *

     * @param seconds

     *            the seconds to add

     * @throws IllegalArgumentException if the value is invalid

     */

    public void addSeconds(final int seconds);

    /**

     * Add a number of millis to the date.

     *

     * @param millis

     *          the millis to add

     * @throws IllegalArgumentException if the value is invalid

     */

    public void addMillis(final int millis);

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; 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.

 *

 * This program 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 this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.timesupport;

import org.gvsig.tools.exception.BaseException;

/**

 * Generic exception thrown in the TimeSupport API when the exception or error

 * may be dealt by the program or the user of the program which is a client of

 * the TimeSupport API.

 * 

 * @see {@link TimeFactoryService}

 * @see {@link TimeSupportManager}

 * @author gvSIG team.

 * @version $Id$

 */

public class TimeSupportException extends BaseException {

    private static final long serialVersionUID = 6756475060924237176L;

    private static final String MESSAGE =

        "An error has been produced in the TimeSupport library";

    private static final String KEY = "_TimeSupportException";

    /**

     * Constructor to be used in rare cases, usually you must create a new child

     * exception class for each case.

     * <strong>Don't use this constructor in child classes.</strong>

     */

    public TimeSupportException() {

        super(MESSAGE, KEY, serialVersionUID);

    }

    /**

     * Constructor to be used in rare cases, usually you must create a new child

     * exception class for each case.

     * <p>

     * <strong>Don't use this constructor in child classes.</strong>

     * </p>

     * 

     * @param cause

     *            the original cause of the exception

     */

    public TimeSupportException(Exception cause) {

        super(MESSAGE, cause, KEY, serialVersionUID);

    }

    /**

     * @see BaseException#BaseException(String, String, long).

     * @param message

     *            the default messageFormat to describe the exception

     * @param key

     *            the key to use to search a localized messageFormnata

     * @param code

     *            the unique code to identify the exception

     */

    protected TimeSupportException(String message, String key, long code) {

        super(message, key, code);

    }

    /**

     * @see BaseException#BaseException(String, Throwable, String, long).

     * @param message

     *            the default messageFormat to describe the exception

     * @param cause

     *            the original cause of the exception

     * @param key

     *            the key to use to search a localized messageFormnata

     * @param code

     *            the unique code to identify the exception

     */

    protected TimeSupportException(String message, Throwable cause,

        String key, long code) {

        super(message, cause, key, code);

    }

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; 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.

 *

 * This program 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 this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.timesupport;

import java.util.Date;

import org.gvsig.tools.lang.Cloneable;

/**

 * <p>

 * A relative instant is defined like an instant in the datetime continuum 

 * specified as a number of milliseconds from 1970-01-01T00:00Z. This definition 

 * of milliseconds is consistent with that of the JDK in Date or Calendar.

 * </p>

 * <p>It contains also a Chronology which determines how the millisecond 

 * instant value is converted into the date time fields. The default Chronology 

 * can be set using the {@link TimeSupportManager} class. (e.g: 1st January 2010)

 * </p>

 * <p>

 * A huge part of the documentation of this class has been retrieved

 * from the joda-time library.

 * </p>

 * 

 * @see http://joda-time.sourceforge.net

 * @see https://gvsig.org/web/projects/gvsig-desktop/docs/devel/org-gvsig-sensors/1-0.0/analysis-and-design/detailed-view/time-support/libraries/org-gvsig-timesupport-lib

 * 

 * @author gvSIG team

 * @version $Id$

 */

public interface RelativeInstant extends Instant, Cloneable{

    /**

     * Get the date time as a <code>java.util.Date</code>.

     * <p>

     * The <code>Date</code> object created has exactly the same millisecond

     * instant as this object.

     * </p>

     *

     * @return 

     *          a Date initialised with this relative instant

     */

    public Date toDate();

    /**

     * Compares this object with the specified object for ascending

     * millisecond instant order. This ordering is inconsistent with

     * equals, as it ignores the Chronology.

     *

     * @param instant

     *          a readable instant to check against

     * @return 

     *          negative value if this is less, 0 if equal, or positive 

     *          value if greater

     */

    public int compareTo(Instant instant);

    /**

     * Gets the milliseconds of the datetime instant from the Java epoch

     * of 1970-01-01T00:00:00Z.

     * 

     * @return 

     *          the number of milliseconds since 1970-01-01T00:00:00Z

     */

    public long toMillis();    

    /**

     * Get the year field value.

     * 

     * @return 

     *          the year

     */

    public int getYear();

    /**

     * Get the month of year field value.

     * 

     * @return 

     *          the month of year

     */

    public int getMonthOfYear();

    /**

     * Get the day of month field value.

     * 

     * @return 

     *          the day of month

     */

    public int getDayOfMonth();

    /**

     * Get the hour of day field value.

     * 

     * @return 

     *          the hour of month

     */

    public int getHourOfDay();

    /**

     * Get the minute of day field value.

     * 

     * @return 

     *          the minute of day

     */

    public int getMinuteOfDay();

    /**

     * Get the minute of hour field value.

     * 

     * @return 

     *          the minute of hour

     */

    public int getMinuteOfHour();   

    /**

     * Get the second of day field value.

     * 

     * @return 

     *          the second of day

     */

    public int getSecondOfDay();

    /**

     * Get the second of minute field value.

     * 

     * @return 

     *          the second of minute

     */

    public int getSecondOfMinute();

    /**

     * Get the millis of second field value.

     * 

     * @return 

     *          the millis of second

     */

    public int getMillisOfSecond();

    /**

     * Get an editable copy used to edit other instance of

     * a relative instant. The new copy is initialized with

     * the values of this intant.

     *    

     * @return

     *          a copy to edit the instant 

     */

    public EditableRelativeInstant getEditableCopy();

}

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

<title>org.gvsig.timesupport package documentation</title>

</head>

<body>

	<p>TimeSupport library API.</p>

	<p>

	It allows to get new TimeSupport and get their text.

	</p>

</body>

</html>

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; 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.

 *

 * This program 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 this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.timesupport;

import org.gvsig.tools.lang.Cloneable;

/**

 * <p>

 * It defines a partial time that does not support every datetime field,

 * and is thus a local time. It cannot be compared to a {@link RelativeInstant},

 * as it does not fully specify an instant in time. 

 * </p>

 * <p>

 * The time it does specify is a local time, and does not include a time zone. 

 * An AbsoluteInstant supports a subset of the fields on the chronology.

 * </p> 

 * <p>

 * A huge part of the documentation of this class has been retrieved

 * from the joda-time library.

 * </p>

 * 

 * @see http://joda-time.sourceforge.net

 * @see https://gvsig.org/web/projects/gvsig-desktop/docs/devel/org-gvsig-sensors/1-0.0/analysis-and-design/detailed-view/time-support/libraries/org-gvsig-timesupport-lib

 * 

 * @author gvSIG team

 * @version $Id$

 */

public interface AbsoluteInstant extends Instant, Cloneable{

    /**

     * Gets the number of fields in this absolute instant.     

     * @return 

     *          the field count

     */

    public int size();

    /**

     * Gets the field type at the specified index.

     * @param index 

     *          the index to retrieve

     * @return 

     *          the field at the specified index

     */

    public AbsoluteInstantType getFieldType(int index);

    /**

     * Gets the value of the field at the specifed index.

     * @param index 

     *          the index

     * @return the value

     * @throws IndexOutOfBoundsException if the index is invalid

     */

    public int getValue(int index);

    /**

     * Gets the number of years of this absolute instant. 

     * @return

     *          the number of years

     */

    public int getYears();

    /**

     * Gets the number of months of this absolute instant. 

     * @return

     *          the number of months

     */

    public int getMonths();

    /**

     * Gets the number of weeks of this absolute instant. 

     * @return

     *          the number of weeks

     */

    public int getWeeks();

    /**

     * Gets the number of days of this absolute instant. 

     * @return

     *          the number of days

     */

    public int getDays();

    /**

     * Gets the number of hours of this absolute instant. 

     * @return

     *          the number of hours

     */

    public int getHours();

    /**

     * Gets the number of minutes of this absolute instant. 

     * @return

     *          the number of minutes

     */

    public int getMinutes();

    /**

     * Gets the number of seconds of this absolute instant. 

     * @return

     *          the number of seconds

     */

    public int getSeconds();

    /**

     * Gets the number of millis of this absolute instant. 

     * @return

     *          the number of millis

     */

    public int getMillis();

    /**

     * Gets the duration of the instant. It returns a duration assuming a 365

     * days year, 12 months year, 30 days month, 7 day week, 24 hour day, 60 minute hour,

     * 60 second minute and 1000 millis second. 

     * @return

     *          a duration equivalent to this instant from the time 0

     */

    public Duration toStandardDuration();

    /**

     * Gets a copy of this instance with the specified period take away.

     * If the amount is zero or null, then <code>this</code> is returned.     *

     * @param period  

     *          the period to reduce this instant by

     * @return 

     *          a copy of this instance with the period taken away

     * @throws ArithmeticException if the new instant exceeds the capacity of a long

     */

    public AbsoluteInstant minus(AbsoluteInterval interval);

    /**

     * Gets a copy of this instance with the specified period added.

     * If the amount is zero or null, then <code>this</code> is returned.

     *

     * @param period

     *          the duration to add to this one, null means zero

     * @return

     *          a copy of this instance with the period added

     * @throws ArithmeticException if the new instant exceeds the capacity of a long

     */

    public AbsoluteInstant plus(AbsoluteInterval interval);     

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; 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.

 *

 * This program 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 this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.timesupport;

import org.gvsig.tools.locator.BaseLocator;

import org.gvsig.tools.locator.Locator;

import org.gvsig.tools.locator.LocatorException;

/**

 * This locator is the entry point for the TimeSupport library, providing

 * access to all TimeSupport services through the {@link TimeSupportManager}

 * .

 * 

 * @author gvSIG team

 * @version $Id$

 */

public class TimeSupportLocator extends BaseLocator {

    /**

     * TimeSupport manager name.

     */

    public static final String MANAGER_NAME = "TimeSupport.manager";

    /**

     * TimeSupport manager description.

     */

    public static final String MANAGER_DESCRIPTION = "TimeSupport Manager";

    private static final String LOCATOR_NAME = "TimeSupport.locator";

    /**

     * Unique instance.

     */

    private static final TimeSupportLocator INSTANCE =

        new TimeSupportLocator();

    /**

     * Return the singleton instance.

     * 

     * @return the singleton instance

     */

    public static TimeSupportLocator getInstance() {

        return INSTANCE;

    }

    /**

     * Return the Locator's name.

     * 

     * @return a String with the Locator's name

     */

    public final String getLocatorName() {

        return LOCATOR_NAME;

    }

    /**

     * Return a reference to the TimeSupportManager.

     * 

     * @return a reference to the TimeSupportManager

     * @throws LocatorException

     *             if there is no access to the class or the class cannot be

     *             instantiated

     * @see Locator#get(String)

     */

    public static TimeSupportManager getManager() throws LocatorException {

        return (TimeSupportManager) getInstance().get(MANAGER_NAME);

    }

    /**

     * Registers the Class implementing the TimeSupportManager interface.

     * 

     * @param clazz

     *            implementing the TimeSupportManager interface

     */

    public static void registerManager(

        Class<? extends TimeSupportManager> clazz) {

        getInstance().register(MANAGER_NAME, MANAGER_DESCRIPTION, clazz);

    }

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; 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.

 *

 * This program 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 this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.timesupport;

import org.gvsig.tools.lang.Cloneable;

/**

 * <p>

 * A RelativeInterval is defined like an interval between two {@link RelativeInstant}s.

 * </p>

 * <p>

 * A huge part of the documentation of this class has been retrieved

 * from the joda-time library.

 * </p>

 * 

 * @see http://joda-time.sourceforge.net

 * @see https://gvsig.org/web/projects/gvsig-desktop/docs/devel/org-gvsig-sensors/1-0.0/analysis-and-design/detailed-view/time-support/libraries/org-gvsig-timesupport-lib

 * 

 * @author gvSIG team

 * @version $Id$

 */

public interface RelativeInterval extends Interval, Cloneable{

    /**

     * Does this time interval contain the specified instant.     * 

     * @param instant

     *          the instant, null means now

     * @return 

     *          <code>true</code> if this time interval contains the instant

     */

    public boolean contains(RelativeInstant instant);

    /**

     * Does this time interval contain the specified interval.     * 

     * @param instant

     *          the time interval to compare to, null means a zero 

     *          duration interval now

     * @return 

     *          <code>true</code> if this time interval contains the interval

     */

    public boolean contains(RelativeInterval interval);

    /**

     * Does this time interval overlap the specified time interval.

     * @param interval

     *          the time interval to compare to, null means a zero 

     *          length interval now

     * @return

     *          <code>true</code> if the time intervals overlap

     */

    public boolean overlaps(RelativeInterval interval);

    /**

     * Is this time interval after the specified instant. Intervals are inclusive

     * of the start instant and exclusive of the end.

     * @param instant

     *          the instant to compare to, null means now

     * @return

     *          <code>true</code> if this time interval is after the instant

     */

    public boolean isAfter(RelativeInstant instant);

    /**

     * Is this time interval entirely after the specified interval.

     * Intervals are inclusive of the start instant and exclusive of the end.

     * Only the end time of the specified interval is used in the comparison.

     * @param interval

     *          the interval to compare to, null means now

     * @return 

     *          <code>true</code> if this time interval is after the interval specified

     */

    public boolean isAfter(RelativeInterval interval);

    /**

     * Is this time interval before the specified instant. Intervals are inclusive

     * of the start instant and exclusive of the end.

     * @param instant

     *          the instant to compare to, null means now

     * @return

     *          <code>true</code> if this time interval is before the instant

     */

    public boolean isBefore(RelativeInstant instant);

    /**

     * Is this time interval entirely before the specified interval.

     * Intervals are inclusive of the start instant and exclusive of the end.

     * Only the end time of the specified interval is used in the comparison.

     * @param interval

     *          the interval to compare to, null means now

     * @return 

     *          <code>true</code> if this time interval is before the interval specified

     */

    public boolean isBefore(RelativeInterval interval);

    /**

     * Gets the duration of this time interval.

     * @return

     *          the duration of the time interval

     */

    public Duration toDuration();

    /**

     * Gets the duration of this time interval in milliseconds. 

     * The duration is equal to the end millis minus the start millis.     

     * @return

     *          the duration of the time interval in milliseconds

     */

    public long toDurationMillis();

    /**

     * Gets the start of this time interval, which is inclusive, as an Instant. 

     * @return

     *          the start of the time interval

     */

    public RelativeInstant getStart();

    /**

     * Gets the end of this time interval, which is exclusive, as an Instant. 

     * @return

     *          the end of the time interval

     */

    public RelativeInstant getEnd();

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; 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.

 *

 * This program 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 this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.timesupport;

/**

 * <p>

 * An Instant represents a position in a time scale. In practice, 

 * an instant is an interval whose duration is less than the resolution

 * of the time scale.

 * </p>

 * <p>All the Instant subclasses have to be immutable and have to 

 * provide a Chronology as well. All standard Chronology classes are

 * also immutable.

 * </p>

 * <p>

 * A huge part of the documentation of this class has been retrieved

 * from the joda-time library.

 * </p>

 * 

 * @see http://joda-time.sourceforge.net

 * @see https://gvsig.org/web/projects/gvsig-desktop/docs/devel/org-gvsig-sensors/1-0.0/analysis-and-design/detailed-view/time-support/libraries/org-gvsig-timesupport-lib

 * 

 * @author gvSIG Team

 * @version $Id$

 * 

 */

public interface Instant extends Time{

    /**

     * Is this instant equal to the instant passed in comparing solely by millisecond. 

     * @param instant

     *          an instant to check against, null means now 

     * @return

     *          <code>true</code> if the instant is equal to the instant passed in

     */

    public boolean isEqual(Instant instant);

    /**

     * Is this instant after the instant passed in comparing solely by millisecond. 

     * @param instant

     *          an instant to check against, null means now 

     * @return

     *          <code>true</code> if the instant is after the instant passed in

     */

    public boolean isAfter(Instant instant);

    /**

     * Is this instant before the instant passed in comparing solely by millisecond. 

     * @param instant

     *          an instant to check against, null means now 

     * @return

     *          <code>true</code> if the instant is before the instant passed in

     */

    public boolean isBefore(Instant instant);

    /**

     * Output the instant using the specified format pattern.

     *

     * @param 

     *          pattern  the pattern specification, null means 

     *          use <code>toString</code>

     */

    public String toString(String pattern);   

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; 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.

 *

 * This program 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 this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.timesupport;

import org.gvsig.tools.ToolsLibrary;

import org.gvsig.tools.ToolsLocator;

import org.gvsig.tools.dataTypes.DataTypesManager;

import org.gvsig.tools.library.AbstractLibrary;

import org.gvsig.tools.library.LibraryException;

import org.gvsig.tools.locator.ReferenceNotRegisteredException;

/**

 * Library for API initialization and configuration.

 * 

 * @author gvSIG team

 * @version $Id$

 */

public class TimeSupportLibrary extends AbstractLibrary {

    @Override

    public void doRegistration() {

        registerAsAPI(TimeSupportLibrary.class);

        require(ToolsLibrary.class);

    }

    @Override

    protected void doInitialize() throws LibraryException {

        DataTypesManager dataTypesManager = ToolsLocator.getDataTypesManager();

        dataTypesManager.addtype(DataTypes.INSTANT, "Instant", "Instant", RelativeInstant.class, null);

        dataTypesManager.addtype(DataTypes.INTERVAL, "Interval","Interval", RelativeInterval.class, null);

    }

    @Override

    protected void doPostInitialize() throws LibraryException {

        // Validate there is any implementation registered.

        TimeSupportManager manager = TimeSupportLocator.getManager();

        if (manager == null) {

            throw new ReferenceNotRegisteredException(

                TimeSupportLocator.MANAGER_NAME, TimeSupportLocator

                    .getInstance());

        }       

    }

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; 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.

 *

 * This program 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 this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.timesupport;

/**

 * <p>

 * Identifies a field, such as year or minuteOfHour, in a chronology-neutral way.

 * </p>

 * <p>

 * Instances of this class are singletons and they can be compared using the

 * {@link AbsoluteInstantType}{@link #getType()} method and the <code>==</code>

 * operator.

 * </p>

 * <p>

 * A huge part of the documentation of this class has been retrieved

 * from the joda-time library.

 * </p>

 * 

 * @see http://joda-time.sourceforge.net

 * @see https://gvsig.org/web/projects/gvsig-desktop/docs/devel/org-gvsig-sensors/1-0.0/analysis-and-design/detailed-view/time-support/libraries/org-gvsig-timesupport-lib

 * 

 * @author gvSIG team

 * @version $Id$

 */

public interface AbsoluteInstantType {

	 public static final int ERA = 1;

	 public static final int YEAR_OF_ERA = 2;

	 public static final int CENTURY_OF_ERA = 3;

	 public static final int YEAR_OF_CENTURY = 4;

	 public static final int YEAR = 5;

	 public static final int DAY_OF_YEAR = 6;

	 public static final int MONTH_OF_YEAR = 7;

	 public static final int DAY_OF_MONTH = 8;

	 public static final int WEEKYEAR_OF_CENTURY = 9;

	 public static final int WEEKYEAR = 10;

	 public static final int WEEK_OF_WEEKYEAR = 11;

	 public static final int DAY_OF_WEEK = 12;

	 public static final int HALFDAY_OF_DAY = 13;

	 public static final int HOUR_OF_HALFDAY = 14;

	 public static final int CLOCKHOUR_OF_HALFDAY = 15;

	 public static final int CLOCKHOUR_OF_DAY = 16;

	 public static final int HOUR_OF_DAY = 17;

	 public static final int MINUTE_OF_DAY = 18;

	 public static final int MINUTE_OF_HOUR = 19;

	 public static final int SECOND_OF_DAY = 20;

	 public static final int SECOND_OF_MINUTE = 21;

	 public static final int MILLIS_OF_DAY = 22;

	 public static final int MILLIS_OF_SECOND = 23;

	 /**

	  * Gets the code of the type, that is one of the constants defined

	  * in the {@link AbsoluteInstantType} class.

	  * @return

	  *            the type code

	  */

	 public int getType();

	 /**

	  * Gets a description of the {@link AbsoluteInstantType}.

	  * @return

	  *            the name of the type

	  */

	 public String getName();

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; 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.

 *

 * This program 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 this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.timesupport;

import org.gvsig.tools.lang.Cloneable;

/**

 * <p>

 * Is defined like an interval between two absolute instants. 

 * </p>

 * <p>

 * A huge part of the documentation of this class has been retrieved

 * from the joda-time library.

 * </p>

 * 

 * @see http://joda-time.sourceforge.net

 * @see https://gvsig.org/web/projects/gvsig-desktop/docs/devel/org-gvsig-sensors/1-0.0/analysis-and-design/detailed-view/time-support/libraries/org-gvsig-timesupport-lib

 * 

 * @author gvSIG team

 * @version $Id$

 */

public interface AbsoluteInterval extends Interval, Cloneable{

    /**

     * Gets the start of this time interval, which is inclusive, as an Instant. 

     * @return

     *          the start of the time interval

     */

    public AbsoluteInstant getStart();

    /**

     * Gets the end of this time interval, which is exclusive, as an Instant. 

     * @return

     *          the end of the time interval

     */

    public AbsoluteInstant getEnd();

    /**

     * Gets the number of fields that this absolute interval supports.

     * @return 

     *          the number of fields supported

     */   

    public int size();

    /**

     * Gets the field type at the specified index.

     * @param index 

     *          the index to retrieve

     * @return 

     *          the field at the specified index

     */

    public AbsoluteIntervalType getFieldType(int index);

    /**

     * Gets the value at the specified index.

     *

     * @param index  

     *          the index to retrieve

     * @return

     *          the value of the field at the specified index

     * @throws IndexOutOfBoundsException if the index is invalid

     */

    public int getValue(int index);

    /**

     * Gets the number of years of this absolute instant. 

     * @return

     *          the number of years

     */

    public int getYears();

    /**

     * Gets the number of months of this absolute instant. 

     * @return

     *          the number of months

     */

    public int getMonths();

    /**

     * Gets the number of days of this absolute instant. 

     * @return

     *          the number of days

     */