Class UnZipScenarioService

java.lang.Object

it.uniupo.simnova.service.scenario.operations.UnZipScenarioService

@Service
public class UnZipScenarioService
extends Object

Servizio per la decompressione di un file ZIP contenente uno scenario. Si occupa di estrarre il file scenario.json e tutti i file multimediali presenti nella cartella designata (attualmente esami/).

Version:

1.0

Author:

Alessandro Zappatore

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	UnZipScenarioService.UnzippedScenarioData	Record immutabile che incapsula i dati estratti da un file ZIP di uno scenario.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	MEDIA_FOLDER_PREFIX	Il prefisso della cartella all'interno dell'archivio ZIP dove si prevede siano archiviati i file multimediali.
static final String	SCENARIO_JSON_FILENAME	Il nome standard del file JSON che contiene tutti i dati dello scenario all'interno dell'archivio ZIP.

Method Summary

Modifier and Type	Method	Description
UnZipScenarioService.UnzippedScenarioData	unzipScenario(InputStream zipInputStream)	Decomprime un InputStream che rappresenta un file ZIP di uno scenario.

Methods inherited from class java.lang.Object

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

Field Details

SCENARIO_JSON_FILENAME

public static final String SCENARIO_JSON_FILENAME

Il nome standard del file JSON che contiene tutti i dati dello scenario all'interno dell'archivio ZIP.

See Also:

• Constant Field Values

MEDIA_FOLDER_PREFIX

public static final String MEDIA_FOLDER_PREFIX

Il prefisso della cartella all'interno dell'archivio ZIP dove si prevede siano archiviati i file multimediali. Attualmente impostato su "esami/".

See Also:

• Constant Field Values

Method Details

unzipScenario

public UnZipScenarioService.UnzippedScenarioData unzipScenario(InputStream zipInputStream)
                                                        throws IOException

Decomprime un InputStream che rappresenta un file ZIP di uno scenario. Estrae il file scenario.json e tutti i file contenuti nella cartella "esami/".

Parameters:

zipInputStream - L'InputStream del file ZIP da decomprimere. Non deve essere null.

Returns:

Un oggetto UnZipScenarioService.UnzippedScenarioData che incapsula il contenuto del file scenario.json come array di byte e una mappa dei nomi dei file multimediali con i loro rispettivi contenuti come array di byte.

Throws:

IOException - Se si verifica un errore di I/O durante la lettura dello ZIP.

IllegalArgumentException - Se il file scenario.json non viene trovato all'interno dell'archivio ZIP, o se il zipInputStream è null.