org.orekit.utils

Class ImmutableFieldTimeStampedCache<T extends FieldTimeStamped<KK>,KK extends org.hipparchus.CalculusFieldElement<KK>>

java.lang.Object

org.orekit.utils.ImmutableFieldTimeStampedCache<T,KK>

Type Parameters:

T - the type of data

KK - the type the field element

All Implemented Interfaces:

FieldTimeStampedCache<T,KK>

public class ImmutableFieldTimeStampedCache<T extends FieldTimeStamped<KK>,KK extends org.hipparchus.CalculusFieldElement<KK>>
extends Object
implements FieldTimeStampedCache<T,KK>

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

Author:

Evan Ward, Vincent Cucchietti

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
static <TS extends FieldTimeStamped<CFE>,CFE extends org.hipparchus.CalculusFieldElement<CFE>> ImmutableFieldTimeStampedCache<TS,CFE>	emptyCache(org.hipparchus.Field<CFE> field) 获取一个空的不可变缓存，并转换为正确的类型。
List<T>	getAll() 获取此缓存中的所有数据。
T	getEarliest() 获取此缓存中最早的条目。
T	getLatest() 获取此缓存中最新的条目。
Stream<T>	getNeighbors(FieldAbsoluteDate<KK> central) 获取围绕中心日期的条目。
int	getNeighborsSize() 获取由FieldTimeStampedCache.getNeighbors(FieldAbsoluteDate)返回的列表的固定大小。
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ImmutableFieldTimeStampedCache

public ImmutableFieldTimeStampedCache(int neighborsSize,
                                      Collection<? extends T> data)

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

参数：

neighborsSize - 从getNeighbors(FieldAbsoluteDate)返回的列表的大小。必须小于或等于data.size()。

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

抛出：

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

Method Detail

emptyCache

public static <TS extends FieldTimeStamped<CFE>,CFE extends org.hipparchus.CalculusFieldElement<CFE>> ImmutableFieldTimeStampedCache<TS,CFE> emptyCache(org.hipparchus.Field<CFE> field)

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

类型参数：

TS - 数据的类型

CFE - 微积分字段元素的类型

参数：

field - 元素所属的字段

返回：

一个空的ImmutableTimeStampedCache。

getNeighbors

public Stream<T> getNeighbors(FieldAbsoluteDate<KK> central)

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

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

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

接口中指定：

getNeighbors 在接口 FieldTimeStampedCache<T extends FieldTimeStamped<KK>,KK extends org.hipparchus.CalculusFieldElement<KK>>

参数：

central - 中心日期

返回：

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

getNeighborsSize

public int getNeighborsSize()

获取由FieldTimeStampedCache.getNeighbors(FieldAbsoluteDate)返回的列表的固定大小。

接口中指定：

getNeighborsSize 在接口 FieldTimeStampedCache<T extends FieldTimeStamped<KK>,KK extends org.hipparchus.CalculusFieldElement<KK>>

返回：

列表的大小

getEarliest

public T getEarliest()

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

接口中指定：

getEarliest 在接口 FieldTimeStampedCache<T extends FieldTimeStamped<KK>,KK extends org.hipparchus.CalculusFieldElement<KK>>

返回：

最早的缓存条目

getLatest

public T getLatest()

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

接口中指定：

getLatest 在接口 FieldTimeStampedCache<T extends FieldTimeStamped<KK>,KK extends org.hipparchus.CalculusFieldElement<KK>>

返回：

最新的缓存条目

getAll

public List<T> getAll()

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

返回：

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

toString

public String toString()

重写：

toString 在类 Object