bvstone

Calculating the Size of a File Before Base64 Encoding

Posted:

Calculating the Size of a File Before Base64 Encoding

Working with a lot of RESTful APIs and interfaces that perform functions, such as working with Calendars to delivering email (with Google, Office 365, etc), I have found that a lot of data needs to be Base64 Encoded or decoded. 

But, along with this need, there are also some size limits to objects that can be used with these interfaces.  For example, email attachments or entire MIME messages have size limits in place and can differ from API to API.  And that limit normally applies to the data after it has been Base64 encoded, not before.

So, in these cases we can use a very easy function to figure out what the size of a file, or group of data, will be once it is Base64 encoded.

 /COPY QCOPYSRC,APR_B64_H
D stmfSize        S             10i 0
D maxMIMESize     S             10i 0

stmfSize = #getStmfSize(in_sendMailMimeFile);
b64StmfSize = apr_base64_encode_len(stmfSize);

if (b64StmfSize > MAX_SIZE);
  //error
endif;

In this example we first get the size of a stream file that will need to be Base64 Encoded (easily done with the stat() or stat64() APIs available on the IBM i).

Next, we use the apr_base64_encode_len() API, simply passing in the size of the file to be encoded and returned to us will be the size of the file if it were to be Base64 encoded (without actually doing the encoding).  With this information we can then test the size against the maximum size available BEFORE we actually encode it, possibly saving a lot of processing time.

These Base64 functions are available to us from the IBM port of the Apache Base64 Runtime environment.

The /copy member for APR_B64_H can be found online in a few places, like the RPG Next Gen website, but I have also included it here:

 /if defined(APR_BASE64_H)
 /eof
 /endif
 /define APR_BASE64_H
 
  // APR_B64_H --  Include file with definitions for the Base64 routines
  //               included with the Apache Portable Runtime (APR)
  //
  //               On IBM i, this is shipped in the QSYSDIR/QAXIS10HT
  //               service program, which is part of 57xx-SS1 option 3
  //               (57xx-SS1, opt3 = Extended Base Directory Support)
 
  //  APU_DECLARE(int) apr_base64_encode_len(int len);
  //  APU_DECLARE(int) apr_base64_encode(char * coded_dst, const char *plain_src,
  //                                   int len_plain_src);
  //  APU_DECLARE(int) apr_base64_encode_binary(char * coded_dst,
  //                                          const unsigned char *plain_src,
  //                                          int len_plain_src);
  //  APU_DECLARE(int) apr_base64_decode_len(const char * coded_src);
  //  APU_DECLARE(int) apr_base64_decode(char * plain_dst, const char *coded_src);
  //  APU_DECLARE(int) apr_base64_decode_binary(unsigned char * plain_dst,
  //                                         const char *coded_src);
 
D apr_base64_encode_len...
D                 pr            10i 0 extproc('apr_base64_encode_len')
D  len                          10i 0 value
 
D apr_base64_encode...
D                 pr            10i 0 extproc('apr_base64_encode')
D  encoded_dst               65535a   options(*varsize)
D  plain_src                      *   value options(*string)
D  source_len                   10i 0 value
 
D apr_base64_encode_binary...
D                 pr            10i 0 extproc('apr_base64_encode_binary')
D  coded_dst                 65535a   options(*varsize)
D  plain_src                 65535a   options(*varsize) const
D  source_len                   10i 0 value
 
D apr_base64_encode_binary_ptr...
D                 pr            10i 0 extproc('apr_base64_encode_binary')
D  coded_dst                      *
D  plain_src                      *   const
D  source_len                   10i 0 value
 
D apr_base64_decode_len...
D                 pr            10i 0 extproc('apr_base64_decode_len')
D  source_plain                   *   value options(*string)
 
D apr_base64_decode...
D                 pr            10i 0 extproc('apr_base64_decode')
D  plain_dst                 65535a   options(*varsize)
D  coded_src                      *   value options(*string)
 
D apr_base64_decode_ptr...
D                 pr            10i 0 extproc('apr_base64_decode')
D  plain_dst                      *
D  coded_src                      *   const
 
D apr_base64_decode_binary...
D                 pr            10i 0 extproc('apr_base64_decode_binary')
D  plain_dst                 65535a   options(*varsize)
D  coded_src                      *   value options(*string)
 
D apr_base64_decode_binary_ptr...
D                 pr            10i 0 extproc('apr_base64_decode_binary')
D  plain_dst                      *
D  coded_src                      *   const

 




Latest Posts:

Calculating the Size of a File Before Base64 Encoding Calculating the Size of a File Before Base64 Encoding
Posted by August 13, 2022
Programming >> RPG Programming
GreenTools for Microsoft Apps (G4MS) v9.12 Now Includes Function to Send Emails using MIME File GreenTools for Microsoft Apps (G4MS) v9.12 Now Includes Function to Send Emails using MIME File
Posted by August 11, 2022
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
GreenTools for Google Apps (G4G) v15.20 Now Supports Shortcuts GreenTools for Google Apps (G4G) v15.20 Now Supports Shortcuts
Posted by August 6, 2022
BVSTools >> BVSTools Announcements >> GreenTools for G Suite (Google Apps) (G4G) Specific Announcements
GreenTools for Microsoft Apps (G4MS) Groups Admin Authority Instructions GreenTools for Microsoft Apps (G4MS) Groups Admin Authority Instructions
Posted by July 26, 2022
BVSTools >> BVSTools Software Discussion >> GreenTools for Microsoft Apps (G4MS) Specific Discussion
GreenTools for Microsoft Apps (G4MS) v9.10 Now Includes OneDrive Functions that Work With Groups/Shared Drives GreenTools for Microsoft Apps (G4MS) v9.10 Now Includes OneDrive Functions that Work With Groups/Shared Drives
Posted by July 19, 2022
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
GreenTools for Google Apps (G4G) v15.10 Now Includes Drive Functions that Work With Shared Drives GreenTools for Google Apps (G4G) v15.10 Now Includes Drive Functions that Work With Shared Drives
Posted by July 15, 2022
BVSTools >> BVSTools Announcements >> GreenTools for G Suite (Google Apps) (G4G) Specific Announcements
GreenTools for Microsoft Apps (G4MS) v9.00 Now Offers Functions to Bypass Registration Command and BVSTools Landing Page GreenTools for Microsoft Apps (G4MS) v9.00 Now Offers Functions to Bypass Registration Command and BVSTools Landing Page
Posted by July 4, 2022
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
What Objects Should I Omit from Replication to Ensure My License Keys Work on my HA/DR System? What Objects Should I Omit from Replication to Ensure My License Keys Work on my HA/DR System?
Posted by June 27, 2022
BVSTools >> BVSTools Software Discussion
GreenTools for Google Apps (G4G) v15.00 Now Offers Functions to Bypass Registration Command and BVSTools Landing Page GreenTools for Google Apps (G4G) v15.00 Now Offers Functions to Bypass Registration Command and BVSTools Landing Page
Posted by May 3, 2022
BVSTools >> BVSTools Announcements >> GreenTools for G Suite (Google Apps) (G4G) Specific Announcements
How Do I Switch From MAILTOOL Plus to GreenTools for Google or Microsoft Office 365? How Do I Switch From MAILTOOL Plus to GreenTools for Google or Microsoft Office 365?
Posted by April 18, 2022
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
PTFs Issued for SSL/TLS Issues PTFs Issued for SSL/TLS Issues
Posted by March 12, 2022
IBM Power Systems >> PTF Watch
Google Dropping Support for Google Dropping Support for "Less Secure Apps" May 30th, 2022. What Does This Mean for Your IBM i Email?
Posted by March 4, 2022
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
Have You Installed a New Version of MAILTOOL and Now Things Are Acting Different?  Check the Command Defaults! Have You Installed a New Version of MAILTOOL and Now Things Are Acting Different? Check the Command Defaults!
Posted by February 28, 2022
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
Using MAILTOOL Plus on V7R1, or Any OS Using TLS 1.1 or Older Using MAILTOOL Plus on V7R1, or Any OS Using TLS 1.1 or Older
Posted by January 27, 2022
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
BVSTools ILE Functions Being Updated to Remove Hashtag (#) from Function Names BVSTools ILE Functions Being Updated to Remove Hashtag (#) from Function Names
Posted by December 30, 2021
BVSTools >> BVSTools Announcements

Reply




Copyright 1983-2020 BVSTools
GreenBoard(v3) Powered by the eRPG SDK, MAILTOOL Plus!, GreenTools for Google Apps, jQuery, jQuery UI, BlockUI, CKEditor and running on the IBM i (AKA AS/400, iSeries, System i).