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 -->
<: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


We'd love to hear your opinion on this post


6 Responses to “New Connector on The Block: Drop Your Box on The Mule”

  1. Hi I managed to get the demo from github working. But is there a nice way to call the authorize flow from the html/js page and get back to the page beofr calling the methods to upload/delete etc?

  2. Hi!
    You can add a response builder to the “Authorize” flow redirecting the user to “Home” after OAuth dance.

    
    <http:response -builder status="302" doc:name="HTTP Response Builder">
       <http:location value="http://localhost:8081/home"/>
    </http:response>
    

    HTH
    José

  3. Hi all,
    http://www.mulesoft.org/schema/mule/dropbox returns Not Found

    The requested URL /schema/mule/dropbox was not found on this server.
    So please add dropbox xsd in http://www.mulesoft.org/schema/mule/dropbox.
    Regards,
    Arunava

  4. Hi José,
    I’ve a question concerning the dropbox connector.For me it seems like the complete documentation is for the old Adapter and does not work with the new one. So I was forced to use the old Version because I did not get the new one running. Is it possible that there is a missmatch between released connectors and the published documentation? Unfortunately i could not found any different Versions of documentation for the Adapter.

    Kind regards,

    Tobias

  5. Hi Tobias, could you please share the version of the connector you’re using?
    We pushed the latest docs to GitHub, unfortunately there is no previous version of the documentation. The latest connector version is available for 3.4 and 3.5 in Studio, and one of the most important improvements is support for OAuth2.

    HTH
    Regards,
    José

  6. I think this is among the most significant information for me.
    And i’m glad reading your article. But wanna remark on some general things, The web site style is
    ideal, the articles is really nice : D. Good job, cheers