org.orekit.files.ccsds.utils.parsing

Class AbstractMessageParser<T>

java.lang.Object

org.orekit.files.ccsds.utils.parsing.AbstractMessageParser<T>

Type Parameters:

T - type of the file

All Implemented Interfaces:

MessageParser<T>

Direct Known Subclasses:

AbstractConstituentParser, NdmParser

public abstract class AbstractMessageParser<T>
extends Object
implements MessageParser<T>

CCSDS消息的解析器。

从Orekit 11.0开始，CCSDS消息解析器是可变对象，它们收集被解析的数据，直到消息完整并且parseMessage方法已经返回。这意味着解析器不应该在多线程环境中使用。推荐使用解析器的方式要么为每个消息专门分配一个解析器并在完成后丢弃它，要么使用单线程循环。

Since:

11.0

Author:

Luc Maisonobe

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractMessageParser(String root, String formatVersionKey, Function<ParseToken,List<ParseToken>>[] filters) 简单构造函数。

Method Summary

Modifier and Type	Method and Description
void	anticipateNext(ProcessingState anticipated) 预期下一个处理状态应该是什么。
ProcessingState	getCurrent() 获取当前处理状态。
FileFormat	getFileFormat() 获取上次解析的消息的文件格式。
String	getFormatVersionKey() 获取格式版本的键。
Map<String,XmlTokenBuilder>	getSpecialXmlElementsBuilders() 获取特殊XML元素的非默认标记构建器。
T	parseMessage(DataSource source) 解析数据源。
void	process(ParseToken token) 处理解析标记。
protected void	reset(FileFormat fileFormat, ProcessingState initialState) 在解析之前将解析器重置为初始状态。
void	setEndTagSeen(boolean endTagSeen) 设置XML结束标记的标志。
void	setFallback(ProcessingState fallback) 设置备用处理状态。
boolean	wasEndTagSeen() 检查是否已看到XML结束标记。

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.orekit.files.ccsds.utils.lexical.MessageParser

build, reset

Constructor Detail

AbstractMessageParser

protected AbstractMessageParser(String root,
                                String formatVersionKey,
                                Function<ParseToken,List<ParseToken>>[] filters)

简单构造函数。

参数：

root - XML文件的根元素

formatVersionKey - 格式版本的键

filters - 要应用于解析标记的过滤器

自版本：

12.0

Method Detail

setFallback

public void setFallback(ProcessingState fallback)

设置备用处理状态。

如果预期状态无法解析标记，则使用备用处理状态。

参数：

fallback - 如果预期状态无法工作，则使用的处理状态

reset

protected void reset(FileFormat fileFormat,
                     ProcessingState initialState)

在解析之前将解析器重置为初始状态。

参数：

fileFormat - 准备解析的文件格式

initialState - 初始处理状态

setEndTagSeen

public void setEndTagSeen(boolean endTagSeen)

设置XML结束标记的标志。

参数：

endTagSeen - 如果为true，则已看到XML结束标记

wasEndTagSeen

public boolean wasEndTagSeen()

检查是否已看到XML结束标记。

返回：

如果已看到XML结束标记，则为true

getCurrent

public ProcessingState getCurrent()

获取当前处理状态。

返回：

当前处理状态

getFileFormat

public FileFormat getFileFormat()

获取上次解析的消息的文件格式。

由以下指定：

getFileFormat 在接口 MessageParser<T>

返回：

上次解析的消息的文件格式

parseMessage

public T parseMessage(DataSource source)

解析数据源。

由以下指定：

parseMessage 在接口 MessageParser<T>

参数：

source - 要解析的数据源

返回：

解析的文件

getFormatVersionKey

public String getFormatVersionKey()

获取格式版本的键。

由以下指定：

getFormatVersionKey 在接口 MessageParser<T>

返回：

格式版本的键

getSpecialXmlElementsBuilders

public Map<String,XmlTokenBuilder> getSpecialXmlElementsBuilders()

获取特殊XML元素的非默认标记构建器。

由以下指定：

getSpecialXmlElementsBuilders 在接口 MessageParser<T>

返回：

特殊XML元素的标记构建器映射（按XML元素名称键入）

anticipateNext

public void anticipateNext(ProcessingState anticipated)

预期下一个处理状态应该是什么。

参数：

anticipated - 预期的下一个处理状态

process

public void process(ParseToken token)

处理解析标记。

由以下指定：

process 在接口 MessageParser<T>

参数：

token - 要处理的标记