views:

9723

answers:

10

I feel like an idiot asking this. In fact, after typing the title, StackOverflow barks at me, "That's not a very good title. Can you add some more unique words to it?" No I can't, SO; sorry. Here we go:

We have this software that has a webservices component.

Now, the administrator of this system has come to me, wanting to import data into the system by using the webservices component.

So, I went to read the documentation to try to figure this thing out and I am seeing things like this:


Click here to see what I'm talking about (this looks best in firefox, chrome, & safari)

That documentation gives examples of interacting with the system using HTTP verbs such as GET, POST, PUT, DELETE. But in my limited experience, I have never had to send neither an HTTP PUT nor a DELETE.

How do you do it? I have built HTML forms that have method="post" or method="get" and the request is sent to whatever is specified in the action attribute (action="someResource"). But I don't really know what to do with this PUT thing.

If I had to guess, I would have to build an application that creates some sort of an HTTP Request object and set all the properties of it and somehow include the data I want to PUT to the RESOURCE (I am trying to use REST terminology, which is something else is very new to me). Then I would send the request using my programming language and blah blah blah. I am just speculating on this. Please offer up some assistance!

I thought that I was a web developer, since I know things like XHTML, CSS, JavaScript, etc. but it's starting to look like I don't know anything about the foundations of the web at all (HTTP).

Thanks.

Man hanging head in shame

EDIT

PS: I program mostly with .net. So, any examples in .net would be pretty awesome.

A: 

Just a headsup some network admins block puts for various reasons. So you may have to use a POST instead of PUT. Check with your operations.

CodeToGlory
This is all going to occur inside our LAN. I wont have to worry about it being blocked.
Ronnie Overby
Gotta love how network admins block legitimate HTTP. It's a wonder we can get them to allow Ajax at all!
runako
+4  A: 

Here is how to do it in CURL:

click here

Or...you can definitely use an HTML form. If the app is truly RESTful, it will understand the REST actions and only let you perform certain actions based on the method you use.

Tony
If using an HTML form (which I would like to try just for education/proof of concept) how do I send the XML back to the server?
Ronnie Overby
Get curl for windows here: http://curl.haxx.se/download.html (don't mind the intimidating haxx in the url!)
altCognito
Look at the comment by tvanfosson. It shows a good way to make a PUT request. And then XML should be returned...?
Tony
+1  A: 

Here is a tool that lets you drag and drop to PUT files

Yishai
I'm not interested in dragging and dropping files to upload to a server. I want to use the HTTP put method to send xml to a server.
Ronnie Overby
If the file were XML, then that's what it would do.
Yishai
Cool, I didn't realize. Thanks
Ronnie Overby
+5  A: 

You can't PUT using an HTML form (the spec defines only GET/POST for forms).

However any HTTP API should allow you to PUT, in the same way that it allows you to GET or POST. For example, here's the Java HTTPClient documentation, which details PUT alongside all the other HTTP verbs.

I don't know which language you're using, but I think it's going to be pretty trivial to write an app to perform an HTTP PUT.

Brian Agnew
+5  A: 

PUT and DELETE are likely to require that you use AJAX and make XMLHttpRequests since the FORM tag only supports GET and POST verbs and links only make GET requests.

With jQuery:

 $.ajax( {
       url: '/controller/action',
       type: 'PUT',
       data: function() { ...package some data as XML },
       dataType: 'xml',
       ... more options...
 );

The note on the jQuery ajax options page warns that some browsers don't support PUT and DELETE for the request type. FWIW, I've never used PUT but have used DELETE in IE and FF. Haven't tested in Safari or Opera.

tvanfosson
I will likely not write the code to solve this problem for use on a web server/web browser. Likely, I will write a console/windows app that reads data from a database/spreadsheet, then creates some xml to PUT/POST/FART or whatever back to the server in an HTTP request. The purpose of my question here is just to get some information on executing these unfamiliar verbs. HAHAHAHA
Ronnie Overby
You could always just have a hidden field that has a hidden "method" field when accessing your rest api through an html form
bananarepub
+1  A: 

"Now, the administrator of this system has come to me, wanting to import data into the system by using the webservices component."

Web services have little to do with HTML forms.

Web services requests are either done from Javascript (e.g., as Ajax) or they're done from your application programs.

You would write a C# or VB program that used HTTP to do a Put to the given web services URL with the given set of data.

Here, for instance, is some sample VB code: http://developer.yahoo.com/dotnet/howto-rest_vb.html#post

Replace the method string of "POST" with "PUT".

S.Lott
+7  A: 

Here's a C# example using HttpWebRequest:

using System;
using System.IO;
using System.Net;

class Test
{
        static void Main()
        {
                string xml = "<xml>...</xml>";
                byte[] arr = System.Text.Encoding.UTF8.GetBytes(xml);
                HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create("http://localhost/");
                request.Method = "PUT";
                request.ContentType = "text/xml";
                request.ContentLength = arr.Length;
                Stream dataStream = request.GetRequestStream();
                dataStream.Write(arr, 0, arr.Length);
                dataStream.Close();
                HttpWebResponse response = (HttpWebResponse)request.GetResponse();
                string returnString = response.StatusCode.ToString();
                Console.WriteLine(returnString);
        }
}
Jason DeFontes
This looks very promising. I will try this out. Thanks
Ronnie Overby
HttpWebRequest doesn't support verbs other than GET or POST. Setting Method to "PUT" will throw a NotSupportedException (sucks, I know!) - http://msdn.microsoft.com/en-us/library/system.net.httpwebrequest.method(VS.96).aspx
Luke Venediger
@Luke It's only on Silverlight that PUT is not supported (your link is to the Silverlight docs). The code above runs as written otherwise.
Jason DeFontes
@Jason thanks! I didn't realise this. I've since found the HttpClient class from the WCF Rest Toolkit which is fantastic.
Luke Venediger
+2  A: 

I found this really cool piece of free software called RESTClient.

It lets you interact with HTTP resources using various verbs, manually setting headers and the body, setting authentication info, ssl, running test scripts, etc.

This will help me to figure out how to interact with our "webservices" software which is really just a RESTful API to the software's database.

Ronnie Overby
A: 

PUT and DELETE are not part of HTML4, but are included in the HTML5 specifications. For this reason, most popular browsers don't have good support for them, since they focus on HTML4. However, they are definitely part of HTTP and always have been. You do a PUT using some non-browser client, or using a form in an HTML5-ready browser.

Wahnfrieden
A: 

How about giving libcurl.NET a try: http://sourceforge.net/projects/libcurl-net/

Luke Venediger