Package sk.iway.iwcm.admin.upload

Class FileArchiveUploadService

java.lang.Object

sk.iway.iwcm.admin.upload.FileArchiveUploadService

public class FileArchiveUploadService
extends Object

Shared service for file archive upload operations used by both AdminUploadServlet and AdminUploadController. Centralizes archive permission checks, new file creation, and overwrite logic.

Method Summary

Modifier and Type	Method	Description
static String	normalizeArchiveFolder(String destinationFolder)	Returns the normalized archive folder path.
static void	overwriteArchiveFile(Identity user, Prop prop, String archiveFolder, String fileName, String fileKey, org.json.JSONObject output)	Overwrites an existing archive file with a new upload.
static void	saveNewArchiveFile(Identity user, Prop prop, String destinationFolder, String fileName, String originalName, String fileKey, org.json.JSONObject output)	Saves a new file into the archive (non-existing file).
static void	uploadNewArchiveFileVersion(Identity user, Prop prop, String archiveFolder, String fileName, String fileKey, org.json.JSONObject output)	Uploads a new version of an existing archive file.
static String	validateArchiveUploadPermission(Identity user, String destinationFolder, String referer)	Validates that the user has permission to upload to the given archive folder.

Methods inherited from class java.lang.Object

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

Method Details

validateArchiveUploadPermission

public static String validateArchiveUploadPermission(Identity user,
 String destinationFolder,
 String referer)

Validates that the user has permission to upload to the given archive folder.

Parameters:

user - - current user

destinationFolder - - raw destination folder from the request

referer - - HTTP referer header

Returns:

error key if validation fails, null if OK

normalizeArchiveFolder

public static String normalizeArchiveFolder(String destinationFolder)

Returns the normalized archive folder path.

Parameters:

destinationFolder - - raw destination folder

Returns:

normalized path

saveNewArchiveFile

public static void saveNewArchiveFile(Identity user,
 Prop prop,
 String destinationFolder,
 String fileName,
 String originalName,
 String fileKey,
 org.json.JSONObject output)

Saves a new file into the archive (non-existing file). Called after chunk assembly in AdminUploadServlet.

Parameters:

user - - current user

prop - - localization instance

destinationFolder - - normalized archive folder

fileName - - sanitized file name

originalName - - original file name (used for virtualFileName)

fileKey - - temp file key (random string)

output - - JSON output to populate with result

overwriteArchiveFile

public static void overwriteArchiveFile(Identity user,
 Prop prop,
 String archiveFolder,
 String fileName,
 String fileKey,
 org.json.JSONObject output)

Overwrites an existing archive file with a new upload. Called from AdminUploadController.

Parameters:

user - - current user

prop - - localization instance

archiveFolder - - normalized archive folder

fileName - - file name to overwrite

fileKey - - temp file key

output - - JSON output to populate with result

uploadNewArchiveFileVersion

public static void uploadNewArchiveFileVersion(Identity user,
 Prop prop,
 String archiveFolder,
 String fileName,
 String fileKey,
 org.json.JSONObject output)

Uploads a new version of an existing archive file. Called from AdminUploadController.

Parameters:

user - - current user

prop - - localization instance

archiveFolder - - normalized archive folder

fileName - - file name whose new version is uploaded

fileKey - - temp file key

output - - JSON output to populate with result