User API

ImageFile extends File

Other API in Package

Web

Internal Tunnel

Internal Web

Tunnel

File representing image content

This class also used in (click to expand):
Method Summary
String calcMD5()

Returns an MD5 checksum of the contents of this file.

  clip(int x, int y, int w, int h)

If file is an image type, clips the image

  closeReader()

Resets the capability to read lines to the beginning of the file.

File copy()

Returns a copy of the file

ImageFile copy()

Returns a copy of the file

FileBuffer createFileBuffer()

Reads this compressed file and returns a FileBuffer. Throws exception if this not a supported type (zip and jar).

File decrypt(String password, String filename)

Returns a new file. Assumes the content of this file is PGP encrypted.

File encrypt(String password)

Returns a new file with the content of this file PGP encrypted. The new file's filename will be existing filename+.txt

File encrypt(String password, String filename)

Returns a new file with the content of this file PGP encrypted having the specified file name. Extensions allowed: pgp, gpg, txt, asc. Extension is required.

String getContentType()

Returns the content type of this file

String getFailureMessage()

When isValid is false, contains failure message.

String getFileExtension()

Returns the file extension. 'Myfile.doc' returns 'doc'

int getFileLength()

Returns the size of the file in bytes.

int getFileSize()

Returns the size of the file in kilobytes.

String getFileType()

Returns the type of the file as specified by the upload tag or API. This may be null if the file was obtained by means other than an upload.

String getFilename()

Returns the name of the uploaded file (without the full path).

int getHeight()

Returns image height

Data getImageMetadata()

Returns metadata of this image file (not all of which might be present): longitude,latitude,date,camera,manufacturer,focalLength,fStop,exposureTime,isoSpeedRatings shutterSpeedValueAPEX,shutterSpeedExposureTime,apertureValueAPEX,subjectDistance,dateTimeOriginal,orientation,height,width,p0-p12. p0-p12 contains pixel colors for 13 points on the image in hex.

DataReader getReader()

Opens a data reader for this file. File type should be list compatible.

int getWidth()

Returns image width

XMLReader getXMLReader(boolean removeNamespaces)

Returns a ServicePayload for processing XML-based files. Returns null if the file is not XML.

boolean isAdHocConversionSupported()

Returns true if the content supports immediate conversion to adhoc. See Packet.createAdHocDocument(File,...)

boolean isCorrectType()

Returns true if the type of the file is within the specified restriction.

boolean isDataListSupported()

Returns true if this file content can be used as a DataList. See Attachment.toDataList

boolean isMacro()

Returns true if the content of the file contains macro.

boolean isPdfConversionSupported()

Returns true if the content supports conversion to PDF.

boolean isSizeExceeded()

Returns true if the size of the file exceeds the specified restriction.

boolean isValid()

Returns true if the content of the file is valid.

boolean isVirus()

Returns true if the content of the file contains a virus.

File pgpDecrypt(File keyFile, String password, String filename)

Returns a new file with the content of this PGP encrypted file decrypted using the provided private key. The content type is guessed from the file name extension

File pgpEncrypt(File keyFile)

Returns a new file with the content of this file PGP encrypted using the provided public key. The new file's filename will be existing filename+.txt

PacketDataList readDataList(String name)

Creates a non persistent PacketDataList from the contents of this file. The contents must support DataList conversion (currently .csv and .xls). If xls, this will execute formulas. This method also takes liberties with regard to column names. If it encounters any blank column name it assumes the first row is data and renames all the columns as col0 - colN. If xls, it will also attempt to find a matching tab by name and if that fails, it will return the first tab. Throws exception if invalid or unsupported file format.

Payload readDataLists()

Creates a Payload of PacketDataList from the contents of this file. The contents must support DataList conversion (currently .csv and .xls). If xls, this will execute formulas. This method also takes liberties with regard to column names. If it encounters any blank column name it assumes the first row is data and renames all the columns as col0 - colN. Throws exception if invalid or unsupported file format.

String readFile()

Reads all of the text-based file and returns the content as a string. Returns null if there is no content. Throws exception if this file is not a text-based file.

String readLine()

Reads one line (of the presumably text file) and returns it, advancing the reader to the next line for subsequent reads. Returns null if this file is not text based or there are no more lines to read. Best practice-call closeReader when finished.

File removeSignature()

Removes the digital signature, if any.

  resizeWidth(int maxWidth)

Transforms the size of the file (only works on images) by reducing the width to the specified with. If the width is already less than the specified width, this does nothing.

  rotate(int degrees)

Rotates this image by an angle provided in degrees. Image rotated clockwise if angle is a positive number and counter-clockwise if angle is a negative number

  setFilename(String newFileName)

Sets the name of the file to the specified name.

File sign()

Applies a digital signature to the file. Content must be well formed XML.

AudioFile toAudioFile()

Returns AudioFile created from this File. Method returns null if current file cannot be represented as an audio.

Data toData()

Returns the content of this file as a Data object with three properties: fileName, contentType, and base64. base64 will be a Base64 encoded string of the file contents.

PacketDataList toDataList(String name)

Creates a non persistent PacketDataList from the contents of this file. The contents must support DataList conversion (currently .csv and .xls)

ExcelFile toExcelFile()

Returns ExcelFile created from this File. Method returns null if current file cannot be represented as an excel file.

ImageFile toImage()

Returns ImageFile created from this File. Method returns null if current file cannot be represented as an image. The file must already be a supported image content type to use this method. If you are trying convert a PDF to an image you should just get a specified page or use toTIFF to get a multi-page TIFF file.

PdfFile toPdf(String filename)

Converts this file to PDF if possible. Call isPdfConversionSupported() to check if file can be converted to PDF. Returns PDF file or null if PDF conversion is not supported

PdfFile toPdf(String filename, String password)

This method expects the document to already be a PDF. Call isPdfConversionSupported() to check if file can be converted to PDF. Returns PDF file or null if PDF conversion is not supported

String toString()

Returns a description of this object.

UnknownFile toUnknownFile(String ext)

Converts this file to an UnknownFile (used for testing purposes).

VCardFile toVCardFile()

Returns VCard representation of this file. Returns invalid file if current file cannot be parsed as VCard

Method Detail


String calcMD5()

Returns an MD5 checksum of the contents of this file.

Returns:  String

Since: 11-23-2012

top

clip(int x, int y, int w, int h)

If file is an image type, clips the image

Parameters:

  • int   x
  • int   y
  • int   w
  • int   h

Since: 09-05-2008

top

closeReader()

Resets the capability to read lines to the beginning of the file.

Since: 08-13-2013

top

File copy()

Returns a copy of the file

Returns:  File

Since: 11-17-2011

top

ImageFile copy()

Returns a copy of the file

Returns:  ImageFile

Since: 11-17-2011

top

FileBuffer createFileBuffer()

Reads this compressed file and returns a FileBuffer. Throws exception if this not a supported type (zip and jar).

Returns:  FileBuffer

Since: 08-27-2013

top

File decrypt(String password, String filename)

Returns a new file. Assumes the content of this file is PGP encrypted.

Parameters:

  • String   password Required parameter.
  • String   filename Required parameter.

Returns:  File

Since: 03-17-2014

top

File encrypt(String password)

Returns a new file with the content of this file PGP encrypted. The new file's filename will be existing filename+.txt

Parameters:

  • String   password Required parameter.

Returns:  File

Since: 05-16-2011

top

File encrypt(String password, String filename)

Returns a new file with the content of this file PGP encrypted having the specified file name. Extensions allowed: pgp, gpg, txt, asc. Extension is required.

Parameters:

  • String   password Required parameter.
  • String   filename Required parameter.

Returns:  File

Since: 10-07-2016

top

String getContentType()

Returns the content type of this file

Returns:  String

Since: 02-03-2010

top

String getFailureMessage()

When isValid is false, contains failure message.

Returns:  String

Since: 04-01-2009

top

String getFileExtension()

Returns the file extension. 'Myfile.doc' returns 'doc'

Returns:  String

Since: 06-10-2010

top

int getFileLength()

Returns the size of the file in bytes.

Returns:  int

Since: 08-23-2018

top

int getFileSize()

Returns the size of the file in kilobytes.

Returns:  int

Since: 04-10-2007

top

String getFileType()

Returns the type of the file as specified by the upload tag or API. This may be null if the file was obtained by means other than an upload.

Returns:  String

Since: 04-10-2007

top

String getFilename()

Returns the name of the uploaded file (without the full path).

Returns:  String

Since: 11-07-2007

top

int getHeight()

Returns image height

Returns:  int

Since: 11-17-2011

top

Data getImageMetadata()

Returns metadata of this image file (not all of which might be present): longitude,latitude,date,camera,manufacturer,focalLength,fStop,exposureTime,isoSpeedRatings shutterSpeedValueAPEX,shutterSpeedExposureTime,apertureValueAPEX,subjectDistance,dateTimeOriginal,orientation,height,width,p0-p12. p0-p12 contains pixel colors for 13 points on the image in hex.

Returns:  Data

Since: 01-26-2017

top

DataReader getReader()

Opens a data reader for this file. File type should be list compatible.

Returns:  DataReader

Since: 11-20-2019

top

int getWidth()

Returns image width

Returns:  int

Since: 11-17-2011

top

XMLReader getXMLReader(boolean removeNamespaces)

Returns a ServicePayload for processing XML-based files. Returns null if the file is not XML.

Parameters:

  • boolean   removeNamespaces

Returns:  XMLReader

Since: 04-11-2023

top

boolean isAdHocConversionSupported()

Returns true if the content supports immediate conversion to adhoc. See Packet.createAdHocDocument(File,...)

Returns:  boolean

Since: 11-09-2009

top

boolean isCorrectType()

Returns true if the type of the file is within the specified restriction.

Returns:  boolean

Since: 04-10-2007

top

boolean isDataListSupported()

Returns true if this file content can be used as a DataList. See Attachment.toDataList

Returns:  boolean

Since: 02-03-2010

top

boolean isMacro()

Returns true if the content of the file contains macro.

Returns:  boolean

Since: 02-23-2010

top

boolean isPdfConversionSupported()

Returns true if the content supports conversion to PDF.

Returns:  boolean

Since: 03-10-2008

top

boolean isSizeExceeded()

Returns true if the size of the file exceeds the specified restriction.

Returns:  boolean

Since: 04-10-2007

top

boolean isValid()

Returns true if the content of the file is valid.

Returns:  boolean

Since: 04-10-2007

top

boolean isVirus()

Returns true if the content of the file contains a virus.

Returns:  boolean

Since: 04-10-2007

top

File pgpDecrypt(File keyFile, String password, String filename)

Returns a new file with the content of this PGP encrypted file decrypted using the provided private key. The content type is guessed from the file name extension

Parameters:

  • File   keyFile Required parameter.
  • String   password Required parameter.
  • String   filename Required parameter.

Returns:  File

Since: 08-03-2016

top

File pgpEncrypt(File keyFile)

Returns a new file with the content of this file PGP encrypted using the provided public key. The new file's filename will be existing filename+.txt

Parameters:

  • File   keyFile Required parameter.

Returns:  File

Since: 08-03-2016

top

PacketDataList readDataList(String name)

Creates a non persistent PacketDataList from the contents of this file. The contents must support DataList conversion (currently .csv and .xls). If xls, this will execute formulas. This method also takes liberties with regard to column names. If it encounters any blank column name it assumes the first row is data and renames all the columns as col0 - colN. If xls, it will also attempt to find a matching tab by name and if that fails, it will return the first tab. Throws exception if invalid or unsupported file format.

Parameters:

  • String   name Required parameter.

Returns:  PacketDataList

Since: 06-03-2020

top

Payload readDataLists()

Creates a Payload of PacketDataList from the contents of this file. The contents must support DataList conversion (currently .csv and .xls). If xls, this will execute formulas. This method also takes liberties with regard to column names. If it encounters any blank column name it assumes the first row is data and renames all the columns as col0 - colN. Throws exception if invalid or unsupported file format.

Returns:  Payload

Since: 05-11-2021

top

String readFile()

Reads all of the text-based file and returns the content as a string. Returns null if there is no content. Throws exception if this file is not a text-based file.

Returns:  String

Since: 01-20-2015

top

String readLine()

Reads one line (of the presumably text file) and returns it, advancing the reader to the next line for subsequent reads. Returns null if this file is not text based or there are no more lines to read. Best practice-call closeReader when finished.

Returns:  String

Since: 08-13-2013

top

File removeSignature()

Removes the digital signature, if any.

Returns:  File

Since: 02-26-2016

top

resizeWidth(int maxWidth)

Transforms the size of the file (only works on images) by reducing the width to the specified with. If the width is already less than the specified width, this does nothing.

Parameters:

  • int   maxWidth

Since: 04-10-2007

top

rotate(int degrees)

Rotates this image by an angle provided in degrees. Image rotated clockwise if angle is a positive number and counter-clockwise if angle is a negative number

Parameters:

  • int   degrees  - rotation angle in degrees.

Since: 10-19-2011

top

setFilename(String newFileName)

Sets the name of the file to the specified name.

Parameters:

  • String   newFileName  - New file name including extension, which must match existing extension. Required parameter.

Since: 06-04-2024

top

File sign()

Applies a digital signature to the file. Content must be well formed XML.

Returns:  File

Since: 02-26-2016

top

AudioFile toAudioFile()

Returns AudioFile created from this File. Method returns null if current file cannot be represented as an audio.

Returns:  AudioFile

Since: 03-09-2018

top

Data toData()

Returns the content of this file as a Data object with three properties: fileName, contentType, and base64. base64 will be a Base64 encoded string of the file contents.

Returns:  Data

Since: 05-16-2011

top

PacketDataList toDataList(String name)

Creates a non persistent PacketDataList from the contents of this file. The contents must support DataList conversion (currently .csv and .xls)

Parameters:

  • String   name

Returns:  PacketDataList

Since: 05-15-2010

top

ExcelFile toExcelFile()

Returns ExcelFile created from this File. Method returns null if current file cannot be represented as an excel file.

Returns:  ExcelFile

Since: 01-17-2022

top

ImageFile toImage()

Returns ImageFile created from this File. Method returns null if current file cannot be represented as an image. The file must already be a supported image content type to use this method. If you are trying convert a PDF to an image you should just get a specified page or use toTIFF to get a multi-page TIFF file.

Returns:  ImageFile

Since: 10-19-2011

top

PdfFile toPdf(String filename)

Converts this file to PDF if possible. Call isPdfConversionSupported() to check if file can be converted to PDF. Returns PDF file or null if PDF conversion is not supported

Parameters:

  • String   filename  - name of converted file. Required parameter.

Returns:  PdfFile

Since: 07-04-2011

top

PdfFile toPdf(String filename, String password)

This method expects the document to already be a PDF. Call isPdfConversionSupported() to check if file can be converted to PDF. Returns PDF file or null if PDF conversion is not supported

Parameters:

  • String   filename  - name of converted file. Required parameter.
  • String   password  - password if any. Required parameter.

Returns:  PdfFile

Since: 10-05-2017

top

String toString()

Returns a description of this object.

Returns:  String

Since: 06-14-2007

top

UnknownFile toUnknownFile(String ext)

Converts this file to an UnknownFile (used for testing purposes).

Parameters:

  • String   ext Required parameter.

Returns:  UnknownFile

Since: 08-23-2018

top

VCardFile toVCardFile()

Returns VCard representation of this file. Returns invalid file if current file cannot be parsed as VCard

Returns:  VCardFile

Since: 12-12-2011

top
Copyright © 2006 - 2024, ContractPal, Inc. All rights reserved. API Date: Dec 03, 2024 10:24 AM