DrutNet - Drupal .NET API
DrutNet is a .NET API to create client applications that connects to a Drupal site, and allow file upload, node save/load, view get and more.
Introduction
I've created this simple API to connect Drupal with .NET applications easily and quickly, this API was based on an API that I wrote for one of our projects, for this project we had to create a few client application to upload files, connect to desktop application and update the content. I used two different interfaces to cover all my needs, cURL - to upload files; and Services module - to create/ update nodes.
Features Snapshot
DrutNet API has a Services class:
- Services.Login - Login to Drupal
- Services.NodeGet - Load a node
- Services.UserGet - Load a user
- Services.NodeSave - Save a node
To upload files using the API use the CURL class:
- Curl.Login - Login to Drupal with cURL, which is required in order to uplaod a file. This login is not the same as the Services login
- Curl.UploadFile - Upload a file to a CCK file/ image field. The "File form" module provided in the
/Drupal Modulefolder must be enabled on the Drupal site
Source
The source code is stored under GitHub (we didn't publish it in Drupal as apparently it against some the CVS guidelines).
Example
In the source there is a sample project, that demonstrates the use of the API to load/ save a node, and to upload a file.
To test the API follow the instructions bellow (no programing or compiling required when using the):
- Place both Drupal modules under '/Drupal Module' in your Drupal installation (e.g. under
sites/all/modules):
- DrutNet sample module - The module creates aDrutNet smaplecontent type to test the system with the DrutNETSample
- File form - This module is required for file upload with cURL - Download and enable the required modules
drush dl cck views features filefield services - Compile the sample project Or use the already compiled program in
/Dlls/DrutNETSample.exe - Insert your username password to Drupal and the Drupal site URL
- Click on "Login to services", and then click "Login to cURL".
- Update an existing node by indicating the node ID, loading it, changing the text and "Save" it.
- To test file upload, switch to the Upload tab, choose a file and fill the node ID, CCK field name to attach the file to (in our example we use
field_file), and hit the Upload Button
For features or bug report use GitHub project page
Comments
File upload
It is actually possible, and quite easy, to do file uploads and associate them with imagefields using the file.save service, and attaching the resulting fid to your node's imagefield. You need to do it in that order but it is really simple.
Indeed, there's file.save,
Indeed, there's file.save, that uses base64_encode. Also the PHP docs mention: "Base64-encoded data takes about 33% more space than the original data."
It seems that for bigger files cURL is a better and faster solution, and we don't need to bother we encoding.
But you are right, we should probably implement also Services.Upload - to save the login to cURL.
Implementation of file.save
I've added this function to the API and will release a blog post once it's ready, this will remove the dependency for cURL when uploading files. cURL still give some additional options, like the ability to get the upload progress and better performance.
Post new comment