Skip to content
Star

Java SDK File Reference

Upload Delete

Upload (request, fileRoute, options)

Returns: Map<Object, Object>

Method used to upload file to the specified location on disk.

Parameters:


  • request

    All the HTTP specific information for the HTTP request.

    Type: HttpServletRequest

  • fileRoute

    The server route where the file will be uploaded. This route must be public to be accessed by the editor.

    Type: String

  • options

    This parameter is optional. It can be used to pass custom options for the file upload. All available options are described below. Short example: 

    FileOptions options = new FileOptions();
options.setResize(width, height, keepAspectRatio);

    Type: FileOptions


options parameter:

  • fieldname

    Tag name that points to the file. Use getter/setter to access it. 

    option.('my-custom-fieldname');
option.getFieldname();

    Type: String
    Default: 
    "file"

  • validation

    Specified the allowed file extensions and mimetypes. Use getter/setter to access it. 

    options.setValidation(new FileValidation());

options.setValidation(new FileValidation(new String[] { "txt" }, new String[] { "text/plain" }));

options.setValidation(new FileValidation(new CustomValidation() {

  @Override
  public boolean validate(String filePath, String mimeType) {

  }
}));

options.getValidation();

    Type: FileValidation
    Default: 
    /// Allowed file validation default extensions.
public static final String[] allowedFileExtsDefault = new String[] { "txt", "pdf", "doc" };

/// Allowed file validation default mimetypes.
public static final String[] allowedFileMimeTypesDefault = new String[] { "text/plain", "application/msword", "application/x-pdf", "application/pdf" };

Response

If the upload is completed successfully, the method returns an object with the absolute path to the uploaded file. If an error occurs, the method throws an exception. 

Map<Object, Object> responseData;
try {
  responseData = File.upload(request, fileRoute, options);
} catch (Exception e) {
  e.printStackTrace();
  responseData = new HashMap();
  responseData.put("error", e.toString());
}
String jsonResponseData = new Gson().toJson(responseData);
response.setContentType("application/json");
response.setCharacterEncoding("UTF-8");
response.getWriter().write(jsonResponseData);

Delete (request, filePath)

Method used to delete an file from disk. Throws an exception if an error occurs.

Parameters:


  • request

    All the HTTP specific information for the HTTP request.

    Type: HttpServletRequest

  • filePath

    The server file path.

    Type: String

File: 2053