New Connector on The Block: Drop Your Box on The Mule

motif

Dropbox LogoIt’s a pleasure for me to introduce the Mule Dropbox Connector. I’m sure you have heard of Dropbox and many of you have been delighted by its simple features, and now you can take advantage of them in your Mule applications.

Getting the Dropbox Connector

It’s really easy to start using this connector thanks to Mule Studio update site. To install it:

  • Go to the menu Help -> Install new software
  • Enter the connectors releases repository: http://repository.mulesoft.org/connectors/releases
  • Select the Dropbox Cloud Connector available in the Community group

Once you have followed the process and downloaded the Studio plugin the component will be visible on the Cloud Connectors toolbar.

If you’re not using Mule Studio you can use it with Apache Maven using this guide.

Authorizing

Dropbox connector uses OAuth 1.0 to authorize your mule app with your service account. We have shown many connectors with this authentication mechanism, I would recommend to have a look at the connector documentation and the Studio demo in order to have a better idea about the process.

What Can I Do With This?

Ok, now the fun part. What operations does the connector provide you? Let’s have a quick look at some of them.

Upload a File

Imagine you want to upload the photos from your last vacation or the video of your cat dancing Gangnam Style. No problem, you can do it with the following example:

<!-- FileInputStream payload -->
<dropbox:upload-file filename="myPic.jpg" path="pictures" 
  overwrite="true" config-ref="Dropbox Connector"/>

An InputStream as payload, a file name with path and that’s all. Your file will be available in the folder “pictures” of your Dropbox account.

Download a File

OF course, downloading a file with this connector is pretty straightforward:

<dropbox:download-file path="pictures/myPic.jpg" 
  config-ref="Dropbox Connector"/>

The Rest

The other available operations are:

  • Create folders
  • Copy, move and delete files and folders
  • List folder content
  • Get links to files or folders

To Learn More

You can access the source code on our GitHub repository where you can also find the documentation pages and a Mule Studio demo.

Hope you enjoy this cloud connector and please don’t hesitate to leave your comments and questions. See you next time!

Follow us @MuleSoft