Skip to content
/ HTTPForm Public

Actionscript 3 library to emulate a multipart/form-data HTML form submission request, including file upload.

License

Notifications You must be signed in to change notification settings

dv/HTTPForm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Crowdway.http Actionscript 3 Library
------------------------------------

This little library helps you create HTTP requests which a server would interpret as true HTML form submissions. It is possible to set the encoding for each field, please check out the source code for specifics.

Put these files in subdirectories ./crowdway/http/ under the root folder of your project, so that the actionscript compiler will be able to reach them.

Example code:

	httpForm = new HTTPForm("http://www.google.com");
	httpForm.addEventListener(flash.events.Event.COMPLETE, eventCompleteHandler);

	httpForm.addField(MimeString.fromString("name", "David Verhasselt"));		// Add field named "name"
	httpForm.addField(MimeString.fromString("email", "david@crowdway.com"));	// Add field named "email"
	httpForm.addField(MimeFile.fromByteArray("avatar", "david_at_the_beach_07.jpg", filedata));	// Add filefield named "avatar"
	httpForm.send();

	function eventCompleteHandler(event:Event):void
	{
		var loader:URLLoader = URLLoader(event.target);
		trace(loader.data);
	}

The code above emulates a form with 3 inputfields:

	- an inputbox named "name" with value "David Verhasselt"
	- an inputbox named "email" with value "david@crowdway.com"
	- a fileinput named "avatar" in which the user selected a file named "david_at_the_beach_07.jpg"
	  with contents the ByteArray filedata

It is sent to http://www.google.com. The server at google.com will think it is receiving a form submission with an attached image. The result will be trace()d.

2009 Addendum: The code above works perfectly with Flash 9. However, starting with Flash 10, Adobe has issued some really constrictive security policies which don't really increase security in my opinion. One of them, explained in [1], pertains to any networking call that contains a file upload. Practically, starting with Flash 10, you can send file uploads using httpForm or an alternative only when it is instigated by a user action. For example, only in an onClick eventhandler or a function called by that eventhandler will httpForm.send() work. If you haven't attached a MimeFile with a filename then this restriction doesn't apply.

If you are willing to forgo the server recognizing the file as a fileupload, you can still send the form with the file added as a regular, raw binary inputfield by dismissing the filename:

	httpForm.addField(MimeFile.fromByteArray("avatar", null, filedata));

The server won't recognize it as a file anymore, but the POST-field named "avatar" will still contain the binary filedata.

[1] http://www.adobe.com/devnet/flashplayer/articles/fplayer10_security_changes_print.html#head34

(c) 2006-2012 David Verhasselt <david@crowdway.com>
Licensed under the MIT license

About

Actionscript 3 library to emulate a multipart/form-data HTML form submission request, including file upload.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published