org.orekit.utils

Interface TimeStampedCache<T extends TimeStamped>

Type Parameters:

T - the type of data

All Known Implementing Classes:

GenericTimeStampedCache, ImmutableTimeStampedCache

public interface TimeStampedCache<T extends TimeStamped>

用于提供围绕给定日期并发访问TimeStamped数据的数据结构的接口。

Author:

Luc Maisonobe, Evan Ward

See Also:

GenericTimeStampedCache, ImmutableTimeStampedCache

Method Summary

Modifier and Type	Method and Description
T	getEarliest() 获取此缓存中最早的条目。
T	getLatest() 获取此缓存中最新的条目。
int	getMaxNeighborsSize() 获取getNeighbors(AbsoluteDate, int)返回的列表的最大大小。
default Stream<T>	getNeighbors(AbsoluteDate central) 获取围绕中心日期的条目。
Stream<T>	getNeighbors(AbsoluteDate central, int n) 获取围绕中心日期的条目。

Method Detail

getNeighbors

default Stream<T> getNeighbors(AbsoluteDate central)

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

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

此方法可安全地供多个线程同时执行。

参数：

central - 中心日期

返回：

围绕指定日期缓存的条目列表。列表的大小保证为getMaxNeighborsSize()。

另请参阅：

getNeighbors(AbsoluteDate, int)

getNeighbors

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

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

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

此方法可安全地供多个线程同时执行。

参数：

central - 中心日期

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

返回：

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

自：

12.0

getMaxNeighborsSize

int getMaxNeighborsSize()

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

返回：

列表的大小

getEarliest

T getEarliest()
       throws IllegalStateException

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

返回：

最早的缓存条目

抛出：

IllegalStateException - 如果此缓存为空

getLatest

T getLatest()
     throws IllegalStateException

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

返回：

最新的缓存条目

抛出：

IllegalStateException - 如果此缓存为空