All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.protempa.proposition.interval.IntervalFactory Maven / Gradle / Ivy

Go to download

Protempa Framework is the core of Protempa.

There is a newer version: 5.2-Alpha-2
Show newest version
/*
 * #%L
 * Protempa Framework
 * %%
 * Copyright (C) 2012 - 2013 Emory University
 * %%
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 *      http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 * #L%
 */
package org.protempa.proposition.interval;

import org.apache.commons.collections4.map.ReferenceMap;
import org.protempa.proposition.value.AbsoluteTimeGranularity;
import org.protempa.proposition.value.Granularity;

import java.util.Arrays;
import java.util.List;
import java.util.Map;

/**
 * A factory for creating {@link Interval} objects. A subclass of
 * {@link Interval} will be returned that is optimized for the arguments that
 * are provided to this factory's getInstance methods.
 *
 * @author Andrew Post
 */
public final class IntervalFactory {

    private static class DefaultIntervalContainer {

        private static Interval defaultInterval = new DefaultInterval();
    }

    private static final Map, Interval> cache = new ReferenceMap<>();

    /**
     * Returns an interval specified by the given minimum start, maximum start,
     * minimum finish and maximum finish and corresponding granularities. The
     * interpretation of the starts and finishes depends on the
     * {@link Granularity} implementations specifiied by the
     * startGran and finishGran arguments. For
     * example, if startGran is an instance of
     * {@link AbsoluteTimeGranularity}, minStart and
     * maxStart are interpreted as date/times.
     *
     * @param minStart the earliest start of the interval, represented as a
     * {@link Long}. If null, the earliest start will be unbounded.
     * @param maxStart the latest start of the interval, represented as a
     * {@link Long}. if null, the latest start will be unbounded.
     * @param startGran the {@link Granularity} of the minStart and
     * maxStart.
     * @param minFinish the earliest finish of the interval, represented as a
     * {@link Long}. If null, the earliest finish will be
     * unbounded.
     * @param maxFinish the latest finish of the interval, represented as a
     * {@link Long}. If null, the latest finish will be unbounded.
     * @param finishGran the {@link Granularity} of the minFinish
     * and maxFinish.
     * @return an {@link Interval}.
     */
    public Interval getInstance(Long minStart, Long maxStart,
            Granularity startGran, Long minFinish, Long maxFinish,
            Granularity finishGran) {
        List key = Arrays.asList(new Object[]{minStart, maxStart,
            startGran, minFinish, maxFinish, finishGran});
        Interval result;
        synchronized (cache) {
            result = cache.get(key);
            if (result == null) {
                if (minStart == null || maxStart == null || minFinish == null
                        || maxFinish == null) {
                    result = new DefaultInterval(minStart, maxStart, startGran,
                            minFinish, maxFinish, finishGran, null, null, null);
                } else {
                    result = new SimpleInterval(minStart, maxStart,
                            startGran, minFinish, maxFinish, finishGran);
                }
                cache.put(key, result);
            }
        }
        return result;
    }

    /**
     * Returns at interval specified by the given start and finish and
     * granularities.
     *
     * @param start a {@link Long} representing the start of the interval. If
     * null, the start will be unbounded.
     * @param startGran the {@link Granularity} of the start of the interval.
     * The start parameter's interpretation depends on the
     * {@link Granularity} implementation provided.
     * @param finish a {@link Long} representing the finish of the interval. If
     * null, the finish will be unbounded.
     * @param finishGran the {@link Granularity} of the finish of the interval.
     * The start parameter's interpretation depends on the
     * {@link Granularity} implementation provided.
     * @return an {@link Interval}.
     */
    public Interval getInstance(Long start, Granularity startGran,
            Long finish, Granularity finishGran) {
        List key = Arrays.asList(new Object[]{start, startGran,
            finish, finishGran});
        Interval result;
        synchronized (cache) {
            result = cache.get(key);
            if (result == null) {
                if (start == null || finish == null) {
                    result = new DefaultInterval(start, startGran, finish, finishGran);
                } else {
                    result = new SimpleInterval(start, startGran, finish, finishGran);
                }
                cache.put(key, result);
            }
        }
        return result;
    }

    /**
     * Returns an interval representing a position on the timeline or other axis
     * at a specified granularity. The interpretation of the
     * position parameter depends on what implementation of
     * {@link Granularity} is provided. For example, if the granularity
     * implementation is {@link AbsoluteTimeGranularity}, the
     * position is intepreted as a timestamp.
     *
     * @param position a {
     * @ling Long} representing a single position on the timeline or other axis.
     * If null, the interval will be unbounded.
     * @param gran a {@link Granularity}.
     * @return an {@link Interval}.
     */
    public Interval getInstance(Long position, Granularity gran) {
        List key = Arrays.asList(new Object[]{position, gran});
        Interval result;
        synchronized (cache) {
            result = cache.get(key);
            if (result == null) {
                if (position == null) {
                    result = new DefaultInterval(position, gran, position, gran);
                } else {
                    result = new SimpleInterval(position, gran);
                }
                cache.put(key, result);
            }
        }
        return result;
    }

    /**
     * Returns an unbounded interval.
     *
     * @return an {@link Interval}.
     */
    public Interval getInstance() {
        return DefaultIntervalContainer.defaultInterval;
    }
}
    

    

    

            

    

            



    
    






    
© 2015 - 2024 Weber Informatics LLC | Privacy Policy