Inside Macintosh: Cyberdog Programmer's Kit / Part 3 - Cyberdog Reference

Chapter 7 - Classes and Methods

CyberFormExtension

Superclasses

CyberExtension --> ODExtension --> ODRefCntObject --> ODObject

Subclasses

none

The CyberFormExtension class defines extra behaviors to allow a Cyberdog item to submit HTML forms.

Description

The CyberFormExtension class is an abstract class you can subclass to create an extension that allows a Cyberdog item to submit an HTML form. A Cyberdog HTTP item is extended using the CyberFormExtension subclass. If you develop your own Cyberdog item for referencing data using the HTTP protocol, you must define a subclass of CyberFormExtension and implement your class.

The CyberFormExtension methods allow you to specify form information for a Cyberdog item that can be submitted to the HTTP server. The action of a user clicking on a button to submit an HTML form is similar to clicking on a link in an HTML document to display another web page. However, the data specified in the form is treated as a request; the HTTP server can use the information specified in the form to dynamically construct the next web page to be displayed.

A form request has three parts:

• The body is the information specified by the user in the form.
• The content type specifies the encoding to be used in the form's body.
• The method specifies how the form is to be processed by the HTTP server. Cyberdog HTTP items support the two most common methods defined by the HTML 2.0 specification, GET and POST.

Methods

This section presents summary descriptions of the CyberFormExtension methods grouped according to purpose, followed by detailed descriptions.

Setting Up a Form

BeginSetup

Starts a new form.

EndSetup

Notifies the Cyberdog item that the form information is complete.

Specifying Form Data

SetBody

Sets the data to be included in a form request.

SetContentType

Sets the content type for a form request.

SetMethod

Sets the method for a form request.

---

Methods

BeginSetup

EndSetup

SetBody

SetContentType

SetMethod