W3C home > Mailing lists > Public > public-web-http-desc@w3.org > June 2005

Re: Code generation or forms?

From: Leigh Dodds <leigh@ldodds.com>
Date: Tue, 14 Jun 2005 17:05:04 +0100
Message-ID: <42AF0030.3090900@ldodds.com>
To: hughw@wellstorm.com
CC: 'Mark Nottingham' <mark.nottingham@bea.com>, 'Paul Downey' <paul.downey@whatfettle.com>, public-web-http-desc@w3.org

Hugh Winkler wrote:

> Natural language instructions are OK when the intelligent agent is expected
> to be a human operating a browser or other user agent. If you had an XML
> form you could define a description tag or attribute that would do the trick
> -- just imagine WADL like <parameter name="appid" type="xsd:string"
> required="true" description="The application id" />. In a forms language
> this description is not a "nice to have"; it's essential so that a client
> program can display it to the user. In a code generation scenario, this
> description is optional, or need not be formalized, since it's only the
> programmer, reading the service documentation at design time, who needs to
> understand the meanings of the parameters.

Why is it optional for code generation? Knowledge of type and 
optionality of arguments are precisely the kind of data that I'd expect 
to have to generate useful code. E.g. so I could throw an exception if a 
request is sent without required parameters, or to generate type-safe
methods.

Cheers,

L.

-- 
Home: http://www.ldodds.com     | "Simplicity is the ultimate
Blog: http://www.ldodds.com/blog|   sophistication" -- Leonardo da Vinci
Received on Tuesday, 14 June 2005 16:05:29 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:19:11 GMT