Download pdf from s3 js

Introduction

Much of the software and web apps we build today requires some kind of hosting for files - images, invoices, audio files, etc. The traditional way to store files was just to just save them on the server's HDD. However, saving files onto the HDD of the server comes with limitations such as not being able to scale up, being required to allocate space before using and much higher/non-flexible prices. Not to mention, requesting a huge amount of (potentially large) images can really put a strain on the server.

To offload the servers, developers started hosting files with could storage providers such as AWS S3, Google Cloud Storage, etc.

In this article we will show you how to write www.cronistalascolonias.com.ar code to upload files to S3.

What is S3?

S3, or Simple Storage Service, is a cloud storage service provided by Amazon Web Services (AWS). Using S3, you can host any number of files while paying for only what you use.

S3 also provides multi-regional hosting to customers by their region and thus are able to really quickly serve the requested files with minimum delay.

Setting up the Environment

AWS Credentials

To get started, you need to generate the AWS Security Key Access Credentials first. To do so, login to your AWS Management Console.

Click on your username:

Then select Access Keys -> Create New Access Key:

After that you can either copy the Access Key ID and Secret Access Key from this window or you can download it as a file:

Creating an S3 Bucket

Now let's create a AWS S3 Bucket with proper access. We can do this using the AWS management console or by using www.cronistalascolonias.com.ar

To create an S3 bucket using the management console, go to the S3 service by selecting it from the service menu:

Select "Create Bucket" and enter the name of your bucket and the region that you want to host your bucket. If you already know from which region the majority of your users will come from, it's wise to select a region as close to their's as possible. This will ensure that the files from the server will be served in a more optimal timeframe.

The name you select for your bucket should be a unique name among all AWS users, so try a new one if the name is not available:

Follow through the wizard and configure permissions and other setting per your requirements.

To create the bucket using www.cronistalascolonias.com.ar, we'll first have to set up our development environment.

Development Environment

So now let's get started with our example by configuring a new www.cronistalascolonias.com.ar project:

To start using any AWS Cloud Services in www.cronistalascolonias.com.ar, we have to install the AWS SDK (System Development Kit).

Install it using your preferred package manager - we'll use :

Implementation

Creating an S3 Bucket

If you have already created a bucket manually, you may skip this part. But if not, let's create a file, say, in your project directory.

Import the library to access your S3 bucket:

Now, let's define three constants to store , , and . These are used to identify and access our bucket:

Now, we need to initialize the S3 interface by passing our access keys:

With the S3 interface successfully initialized, we can go ahead and create the bucket:

At this point we can run the code and test if the bucket is created on the cloud:

If the code execution is successful you should see the success message, followed by the bucket address in the output:

You can visit your S3 dashboard and make sure the bucket is created:

To see a complete list of regions and other parameters, please take a look at the official documentation.

Uploading Files

At this point, let's implement the file upload functionality. In a new file, e.g. , import the library to access your S3 bucket and the module to read files from your computer:

We need to define three constants to store , , and and initialize the S3 client as we did before.

Now, let's create a function that accepts a parameter, representing the file we want to upload:

Before we upload the file, we need to read its contents as a buffer. After reading it, we can define the needed parameters for the file upload, such as , , and .

Besides these three parameters, there's a long list of other optional parameters. To get an idea of the things you can define for a file while uploading, here are a few useful ones:

• : Define the class you want to store the object. S3 is intended to provide fast file serving. But in case files are not accessed frequently you can use a different storage class. For an example, if you have files which are hardly touched you can store in "S3 Glacier Storage" where the price is very low compared to "S3 Standard Storage". But it will take more time to access those files in case you need it and is covered with a different service level agreement.
• : Sets the image MIME type. The default type will be "binary/octet-stream". Adding a MIME type like "image/jpeg" will help browsers and other HTTP clients to identify the type of the file.
• : Sets the size of the body in bytes, which comes in handy if body size cannot be determined automatically.
• : Set this parameter to define which language the contents is in. This will also help HTTP clients to identify or translate the content.

For the parameter, we'll use our bucket name, whereas for the parameter we'll add the file name we want to save as, and for the parameter, we'll use .

With that done, we can upload any file by passing the file name to the function:

You can replace "www.cronistalascolonias.com.ar" with a file name that exists in the same directory as the code, a relative file path, or an absolute file path.

At this point, we can run the code and test out if it works:

If every thing is fine, you should see output like what is shown below with a link to your file, which is stored in :

If there is any error it should be displayed on the console as well.

Additionally, you can go to your bucket in the AWS Management Console and make sure the file is uploaded.

Conclusion

To offload our application servers, a popular choice of developers is to host files using storage providers such as AWS S3, Google Cloud Storage, etc. We've made a very simple www.cronistalascolonias.com.ar app that handles file uploads to S3 using its interface via the module.

Depending on your requirements you can also configure public access to your bucket or the files using the console.

If you'd like to play around with the code, as always, you can find it on GitHub in this Gist.