org.orekit.utils

Class ImmutableTimeStampedCache<T extends TimeStamped>

java.lang.Object

org.orekit.utils.ImmutableTimeStampedCache<T>

Type Parameters:

T - the type of data

All Implemented Interfaces:

TimeStampedCache<T>

public class ImmutableTimeStampedCache<T extends TimeStamped>
extends Object
implements TimeStampedCache<T>

通过不可变性提供并发性的TimeStamped数据缓存。当所有缓存数据都存储在内存中时，此策略是合适的。（例如，UTCScale）然后，该类提供了方便的方法来访问数据。

Author:

Evan Ward

Constructor Summary

Constructors

Constructor and Description
ImmutableTimeStampedCache(int maxNeighborsSize, Collection<? extends T> data) 使用给定的邻居大小和数据创建一个新的缓存。

Method Summary

Modifier and Type	Method and Description
static <TS extends TimeStamped> ImmutableTimeStampedCache<TS>	emptyCache() 获取一个空的不可变缓存，并转换为正确的类型。
List<T>	getAll() 获取此缓存中的所有数据。
T	getEarliest() 获取此缓存中最早的条目。
T	getLatest() 获取此缓存中最新的条目。
int	getMaxNeighborsSize() 获取由TimeStampedCache.getNeighbors(AbsoluteDate, int)返回的列表的最大大小。
Stream<T>	getNeighbors(AbsoluteDate central, int n) 获取围绕中心日期的条目。
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.orekit.utils.TimeStampedCache

getNeighbors

Constructor Detail

ImmutableTimeStampedCache

public ImmutableTimeStampedCache(int maxNeighborsSize,
                                 Collection<? extends T> data)

使用给定的邻居大小和数据创建一个新的缓存。

参数：

maxNeighborsSize - 从getNeighbors(AbsoluteDate, int)返回的列表的最大大小。必须小于或等于data.size()。

data - 此缓存的后备数据。列表将被复制以确保不可变性。为了保证不可变性，data中的条目本身必须是不可变的。数据必须比maxNeighborsSize多。

抛出：

IllegalArgumentException - 如果neightborsSize > data.size()或者neighborsSize为负

Method Detail

getNeighbors

public Stream<T> getNeighbors(AbsoluteDate central,
                              int n)

获取围绕中心日期的条目。

如果中心日期在覆盖范围内，返回的数组将平衡，中心日期之前的点和中心日期之后的点各占一半（当然取决于n的奇偶性）。如果中心日期接近边界，则返回的数组将不平衡，并且将仅包含n个最早（或最晚）的条目。后一种情况的典型示例是闰秒缓存，因为闰秒的数量不能任意增加。

此方法对多个线程同时执行是安全的。

指定者：

getNeighbors 在接口 TimeStampedCache<T extends TimeStamped>

参数：

central - 中心日期

n - 邻居数（不能超过TimeStampedCache.getMaxNeighborsSize()）

返回：

围绕指定日期的缓存条目流。

getMaxNeighborsSize

public int getMaxNeighborsSize()

获取由TimeStampedCache.getNeighbors(AbsoluteDate, int)返回的列表的最大大小。

指定者：

getMaxNeighborsSize 在接口 TimeStampedCache<T extends TimeStamped>

返回：

列表的大小

getEarliest

public T getEarliest()

获取此缓存中最早的条目。

指定者：

getEarliest 在接口 TimeStampedCache<T extends TimeStamped>

返回：

最早的缓存条目

getLatest

public T getLatest()

获取此缓存中最新的条目。

指定者：

getLatest 在接口 TimeStampedCache<T extends TimeStamped>

返回：

最新的缓存条目

getAll

public List<T> getAll()

获取此缓存中的所有数据。

返回：

所有传递给constructor的数据的排序集合。

toString

public String toString()

覆盖：

toString 在类 Object

emptyCache

public static final <TS extends TimeStamped> ImmutableTimeStampedCache<TS> emptyCache()

获取一个空的不可变缓存，并转换为正确的类型。

类型参数：

TS - 数据的类型

返回：

一个空的ImmutableTimeStampedCache。