Package dev.jcputney.elearning.parser.parsers

Class AiccParser

java.lang.Object

dev.jcputney.elearning.parser.parsers.BaseParser<AiccMetadata,AiccManifest>

dev.jcputney.elearning.parser.parsers.AiccParser

All Implemented Interfaces:

ModuleParser<AiccManifest>

public final class AiccParser
extends BaseParser<AiccMetadata,AiccManifest>

Parses AICC (Aviation Industry CBT Committee) eLearning modules by handling both INI-style and CSV-style files with specific extensions such as .crs, .des, .au, .cst, .ort, and .pre.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	AU_EXTENSION	The file extension for the AICC assignable unit file.
static final String	CRS_EXTENSION	The file extension for the AICC course file.
static final String	CST_EXTENSION	The file extension for the AICC course structure file.
static final String	DES_EXTENSION	The file extension for the AICC descriptor file.
static final String	ORT_EXTENSION	The file extension for the AICC objectives relation table file.
static final String	PRE_EXTENSION	The file extension for the AICC prerequisites file.

Fields inherited from class dev.jcputney.elearning.parser.parsers.BaseParser

moduleFileProvider, options, XAPI_JS_FILE, XAPI_SEND_STATEMENT_FILE

Constructor Summary

Constructors

Constructor	Description
AiccParser(FileAccess fileAccess)	Default constructor for the AiccParser class.
AiccParser(FileAccess fileAccess, ParserOptions options)	Constructs an AiccParser with the specified FileAccess instance and parser options.
AiccParser(ModuleFileProvider moduleFileProvider)	Constructs an AiccParser with the specified ModuleFileProvider instance.

Method Summary

Modifier and Type	Method	Description
protected AiccMetadata	extractMetadata(AiccManifest manifest, ValidationResult validation)	Extracts metadata from a parsed and validated manifest.
protected Class<AiccManifest>	getManifestClass()	Returns the class type representing the AICC manifest.
protected String	getManifestFileName()	Abstract method to return the filename of the manifest for the specific parser.
AiccManifest	parseManifest()	Parses the AICC manifest and returns an instance of AiccManifest.
AiccManifest	parseManifest(String manifestPath)	Overrides base class parseManifest to ignore the filename parameter since AICC parsing requires multiple files (.crs, .des, .au, .cst).
protected ValidationResult	validateManifest(AiccManifest manifest)	Validates a parsed manifest and returns validation results.

Methods inherited from class dev.jcputney.elearning.parser.parsers.BaseParser

checkForXapi, getModuleType, getOptions, loadExternalMetadataIntoMetadata, parseAndValidate, parseOnly, parseXmlToObject

Methods inherited from class java.lang.Object

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

Field Details

CRS_EXTENSION

public static final String CRS_EXTENSION

The file extension for the AICC course file.

See Also:

• Constant Field Values

DES_EXTENSION

public static final String DES_EXTENSION

The file extension for the AICC descriptor file.

See Also:

• Constant Field Values

AU_EXTENSION

public static final String AU_EXTENSION

The file extension for the AICC assignable unit file.

See Also:

• Constant Field Values

CST_EXTENSION

public static final String CST_EXTENSION

The file extension for the AICC course structure file.

See Also:

• Constant Field Values

ORT_EXTENSION

public static final String ORT_EXTENSION

The file extension for the AICC objectives relation table file.

See Also:

• Constant Field Values

PRE_EXTENSION

public static final String PRE_EXTENSION

The file extension for the AICC prerequisites file.

See Also:

• Constant Field Values

Constructor Details

AiccParser

public AiccParser(FileAccess fileAccess)

Default constructor for the AiccParser class.

Parameters:

fileAccess - An instance of FileAccess for reading files.

AiccParser

public AiccParser(FileAccess fileAccess,
 ParserOptions options)

Constructs an AiccParser with the specified FileAccess instance and parser options.

Parameters:

fileAccess - An instance of FileAccess for reading files.

options - The parser options to control validation and calculation behavior.

AiccParser

public AiccParser(ModuleFileProvider moduleFileProvider)

Constructs an AiccParser with the specified ModuleFileProvider instance.

Parameters:

moduleFileProvider - An instance of ModuleFileProvider for reading files in the module package.

Method Details

parseManifest

public AiccManifest parseManifest(String manifestPath)
                           throws IOException,
XMLStreamException,
ManifestParseException

Overrides base class parseManifest to ignore the filename parameter since AICC parsing requires multiple files (.crs, .des, .au, .cst).

Overrides:

parseManifest in class BaseParser<AiccMetadata,AiccManifest>

Parameters:

manifestPath - Ignored for AICC (uses multiple files)

Returns:

An instance of AiccManifest containing parsed data

Throws:

IOException - If an error occurs while reading files

XMLStreamException - Not thrown by AICC parser

ManifestParseException - If an error occurs while parsing the manifest

parseManifest

public AiccManifest parseManifest()
                           throws IOException,
ModuleParsingException,
ManifestParseException

Parses the AICC manifest and returns an instance of AiccManifest.

Returns:

An instance of AiccManifest containing parsed data.

Throws:

IOException - If an error occurs while reading files.

ModuleParsingException - If an error occurs during parsing.

ManifestParseException - If an error occurs while parsing the manifest.

validateManifest

protected ValidationResult validateManifest(AiccManifest manifest)

Description copied from class: BaseParser

Validates a parsed manifest and returns validation results. Subclasses implement this to use their parser-specific validators.

Specified by:

validateManifest in class BaseParser<AiccMetadata,AiccManifest>

Parameters:

manifest - The parsed manifest to validate

Returns:

ValidationResult containing any errors or warnings

extractMetadata

protected AiccMetadata extractMetadata(AiccManifest manifest,
 ValidationResult validation)
                                throws ModuleException

Description copied from class: BaseParser

Extracts metadata from a parsed and validated manifest.

Specified by:

extractMetadata in class BaseParser<AiccMetadata,AiccManifest>

Parameters:

manifest - The parsed manifest

validation - The validation result (for reference during extraction)

Returns:

Module-specific metadata

Throws:

ModuleException - if metadata extraction fails

getManifestFileName

protected String getManifestFileName()

Description copied from class: BaseParser

Abstract method to return the filename of the manifest for the specific parser.

Specified by:

getManifestFileName in class BaseParser<AiccMetadata,AiccManifest>

Returns:

The manifest filename (e.g., "imsmanifest.xml", "cmi5.xml")

getManifestClass

protected Class<AiccManifest> getManifestClass()

Returns the class type representing the AICC manifest.

Specified by:

getManifestClass in class BaseParser<AiccMetadata,AiccManifest>

Returns:

The class type AiccManifest.class.