GenericTimeStampedCache (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.utils.GenericTimeStampedCache<T>

Type Parameters:

T - Type of the cached data.

All Implemented Interfaces:

TimeStampedCache<T>
```
public class GenericTimeStampedCache<T extends TimeStamped>
extends Object
implements TimeStampedCache<T>
```
用于存储时间戳数据的通用线程安全缓存。

Author:

Luc Maisonobe

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`DEFAULT_CACHED_SLOTS_NUMBER` 独立缓存时间槽的默认数量。

Constructor Summary

Constructors
Constructor and Description
`GenericTimeStampedCache(int maxNeighborsSize, int maxSlots, double maxSpan, double newSlotInterval, TimeStampedGenerator<T> generator)` 简单构造函数。
`GenericTimeStampedCache(int maxNeighborsSize, int maxSlots, double maxSpan, double newSlotInterval, TimeStampedGenerator<T> generator, double overridingMeanStep)` 具有覆盖最小步长的简单构造函数。

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`T`	`getEarliest()` 获取此缓存中的最早条目。
`int`	`getEntries()` 获取缓存的总条目数。
`int`	`getGenerateCalls()` 获取调用生成方法的次数。
`TimeStampedGenerator<T>`	`getGenerator()` 获取生成器。
`int`	`getGetNeighborsCalls()` 获取调用`TimeStampedCache.getNeighbors(AbsoluteDate)`方法的次数。
`T`	`getLatest()` 获取此缓存中的最新条目。
`int`	`getMaxNeighborsSize()` 获取由`TimeStampedCache.getNeighbors(AbsoluteDate, int)`返回的列表的最大大小。
`int`	`getMaxSlots()` 获取独立缓存时间槽的最大数量。
`double`	`getMaxSpan()` 获取一个时间槽的最大持续时间跨度（以秒为单位）。
`Stream<T>`	`getNeighbors(AbsoluteDate central, int n)` 获取围绕中心日期的条目。
`double`	`getNewSlotQuantumGap()` 获取新建时间槽而不是扩展现有时间槽的量子间隙。
`int`	`getSlots()` 获取正在使用的时间槽数。
`int`	`getSlotsEvictions()` 获取时间槽驱逐次数。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.orekit.utils.TimeStampedCache
getNeighbors

- Field Detail
  - DEFAULT_CACHED_SLOTS_NUMBER
```
public static final int DEFAULT_CACHED_SLOTS_NUMBER
```
    独立缓存时间槽的默认数量。
    
    另请参阅：
    
    常量字段值
- Constructor Detail
  - GenericTimeStampedCache
```
public GenericTimeStampedCache(int maxNeighborsSize,
                               int maxSlots,
                               double maxSpan,
                               double newSlotInterval,
                               TimeStampedGenerator<T> generator)
```
    简单构造函数。
    
    参数：
    
    maxNeighborsSize - 要由getNeighbors(AbsoluteDate, int)返回的数组的最大大小，必须至少为2
    
    maxSlots - 独立缓存时间槽的最大数量
    
    maxSpan - 一个时间槽的最大持续时间跨度（以秒为单位）（如果需要，可以设置为Double.POSITIVE_INFINITY）
    
    newSlotInterval - 超过此时间间隔将创建一个新的时间槽，而不是扩展现有时间槽
    
    generator - 用于尚不存在数据的生成器
  - GenericTimeStampedCache
```
public GenericTimeStampedCache(int maxNeighborsSize,
                               int maxSlots,
                               double maxSpan,
                               double newSlotInterval,
                               TimeStampedGenerator<T> generator,
                               double overridingMeanStep)
```
    具有覆盖最小步长的简单构造函数。
    参数：
    
    maxNeighborsSize - 要由getNeighbors(AbsoluteDate, int)返回的数组的最大大小，必须至少为2
    
    maxSlots - 独立缓存时间槽的最大数量
    
    maxSpan - 一个时间槽的最大持续时间跨度（以秒为单位）（如果需要，可以设置为Double.POSITIVE_INFINITY）
    
    newSlotInterval - 超过此时间间隔将创建一个新的时间槽，而不是扩展现有时间槽
    
    generator - 用于尚不存在数据的生成器
    
    overridingMeanStep - 用于非均匀表格化值的覆盖平均步长。例如，在缓存月度表格化值时使用。否则使用Double.NaN。
    
    抛出：
    OrekitIllegalArgumentException - 如果：
    
    邻居大小 < 2
    
    允许的最大时间槽数量 < 1
    
    最小步长 ≤ 0
- Method Detail
  - getGenerator
```
public TimeStampedGenerator<T> getGenerator()
```
    获取生成器。
    
    返回：
    
    生成器
  - getMaxSlots
```
public int getMaxSlots()
```
    获取独立缓存时间槽的最大数量。
    
    返回：
    
    独立缓存时间槽的最大数量
  - getMaxSpan
```
public double getMaxSpan()
```
    获取一个时间槽的最大持续时间跨度（以秒为单位）。
    
    返回：
    
    一个时间槽的最大持续时间跨度（以秒为单位）
  - getNewSlotQuantumGap
```
public double getNewSlotQuantumGap()
```
    获取新建时间槽而不是扩展现有时间槽的量子间隙。
    量子间隙是在构造时提供的newSlotInterval值，四舍五入到缓存内部使用的最近量子步长。
    
    返回：
    
    量子间隙（以秒为单位）
  - getGetNeighborsCalls
```
public int getGetNeighborsCalls()
```
    获取调用TimeStampedCache.getNeighbors(AbsoluteDate)方法的次数。
    此调用次数用作解释getGenerateCalls()的参考。
    
    返回：
    
    调用TimeStampedCache.getNeighbors(AbsoluteDate)方法的次数
    
    另请参阅：
    
    getGenerateCalls()
  - getGenerateCalls
```
public int getGenerateCalls()
```
    获取调用生成方法的次数。
    此调用次数与缓存未命中的次数相关，并可用于调整缓存配置。每次缓存未命中都会执行至少一次调用，但如果新日期与现有缓存远偏移，则可能需要多次调用，具体取决于生成器返回的数组中的元素数量和步长之间的差异。
    
    返回：
    
    调用生成方法的次数
    
    另请参阅：
    
    getGetNeighborsCalls()
  - getSlotsEvictions
```
public int getSlotsEvictions()
```
    获取时间槽驱逐次数。
    当最大时间槽数量足够满足对缓存的并发请求时，此数字应保持较小。如果增加太多，则缓存配置可能不佳，缓存实际上并没有改善情况（在这种情况下，调用生成方法的次数可能会增加）。
    
    返回：
    
    时间槽驱逐次数
  - getSlots
```
public int getSlots()
```
    获取正在使用的时间槽数。
    
    返回：
    
    正在使用的时间槽数
  - getEntries
```
public int getEntries()
```
    获取缓存的总条目数。
    
    返回：
    
    缓存的总条目数
  - getEarliest
```
public T getEarliest()
              throws IllegalStateException
```
    获取此缓存中的最早条目。
    
    由以下接口指定：
    
    getEarliest 在接口 TimeStampedCache<T extends TimeStamped>中
    
    返回：
    
    最早缓存的条目
    
    抛出：
    
    IllegalStateException - 如果此缓存为空
  - getLatest
```
public T getLatest()
            throws IllegalStateException
```
    获取此缓存中的最新条目。
    
    由以下接口指定：
    
    getLatest 在接口 TimeStampedCache<T extends TimeStamped>中
    
    返回：
    
    最新缓存的条目
    
    抛出：
    
    IllegalStateException - 如果此缓存为空
  - getMaxNeighborsSize
```
public int getMaxNeighborsSize()
```
    获取由TimeStampedCache.getNeighbors(AbsoluteDate, int)返回的列表的最大大小。
    
    由以下接口指定：
    
    getMaxNeighborsSize 在接口 TimeStampedCache<T extends TimeStamped>中
    
    返回：
    
    列表的大小
  - getNeighbors
```
public Stream<T> getNeighbors(AbsoluteDate central,
                              int n)
```
    获取围绕中心日期的条目。
    如果中心日期在覆盖范围内，返回的数组将平衡，中心日期之前的点占一半，中心日期之后的点占一半（当然取决于n的奇偶性）。如果中心日期接近边界，则返回的数组将不平衡，并且将仅包含n个最早（或最新）的条目。典型的后一种情况是闰秒缓存，因为闰秒的数量不能任意增加。
    
    此方法可安全地供多个线程同时执行。
    
    指定者：
    
    getNeighbors 在接口 TimeStampedCache<T 扩展 TimeStamped>
    
    参数：
    
    central - 中心日期
    
    n - 邻居数量（不能超过TimeStampedCache.getMaxNeighborsSize()）
    
    返回：
    
    围绕指定日期的缓存条目流。

Class GenericTimeStampedCache<T extends TimeStamped>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.orekit.utils.TimeStampedCache

Field Detail

DEFAULT_CACHED_SLOTS_NUMBER

Constructor Detail

GenericTimeStampedCache

GenericTimeStampedCache

Method Detail

getGenerator

getMaxSlots

getMaxSpan

getNewSlotQuantumGap

getGetNeighborsCalls

getGenerateCalls

getSlotsEvictions

getSlots

getEntries

getEarliest

getLatest

getMaxNeighborsSize

getNeighbors