- From: Robin Berjon via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 05 Jul 2011 14:06:38 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/design-patterns
In directory hutz:/tmp/cvs-serv24400
Modified Files:
Overview.html
Log Message:
obsolete
Index: Overview.html
===================================================================
RCS file: /sources/public/2009/dap/design-patterns/Overview.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- Overview.html 2 Nov 2009 09:38:43 -0000 1.1
+++ Overview.html 5 Jul 2011 14:06:36 -0000 1.2
@@ -16,67 +16,11 @@
</script>
<script src='../common/configPolicy.js' class='remove'></script>
</head>
-<body>
+ <body>
<section id='abstract'>
- These are the requirements for the API Design Patterns work undertaken by the
- DAP WG.
- </section>
-
- <section class='informative'>
- <h2>Introduction</h2>
- <p>
- This document is an editors' draft and currently does not
- reflect consensus of the WG but rather is a starting point for
- further work. It is based on input documents and list
- discussion.
- </p>
- </section>
-
- <section>
- <h2>Design Patterns</h2>
- <section>
- <h3>Requirements</h3>
- <p>
- At present the below items list both patterns and naming conventions.
- </p>
- <ul>
- <li>Naming of WebIDL modules, interfaces, attributes and methods MUST follow the camelCase form.
- </li>
- <li>WebIDL constant defined by DAP APIs MUST be capitalized.
- </li>
- <li>There MUST be a common pattern
- </li>
- <li>All APIs MUST follow the same convention when handling callback functions
- (e.g. XHR / FileAPI style with onreadystatechange, or ProgressEvent with EventTarget).
- </li>
- <h3>Issues</h3>
- <p class="issue">
- Maybe it would be possible to define the API in such an abstract way that both models: XHR and ProgressEvent could handle the architecture
- and vendors could differentiate?
- </p>
- <li>Large data collections MUST be handled uniformly through all the APIs.
- </li>
- <li>There MUST be a common pattern for handling asynchronous operations (e.g. through events, callbacks or mixed)
- </li>
- <li>There MUST be a host object representing the asynchronous operation.
- </li>
- <li>The asynchronous operation MUST be cancellable with a commonly defined operation on the asynchronous object.
- </li>
- <li>There MUST be a common pattern for handling the information passed by the host objects (e.g. events, callbacks, mixed events and callbacks).
- </li>
- <li>There MUST be a common naming scheme for the methods handling basic record manipulation operations (e.g. "Create" for record/item creation, "Delete" for destruction,
- "Update" or "Save" for updating, "Read" or direct object retrieval for access to the properties, "Remove" for removal from the collection [no destruction]).
- </li>
- </ul>
- </section>
+ This is an obsolete document that was never formally accepted by the DAP WG and on which work has been discontinued.
+ Previous content is available in CVS. Please do not refer to this document in any way other than as a proposed
+ work item now abandoned.
</section>
-
- <section class='appendix'>
- <h2>Acknowledgements</h2>
- <p>
- The editors would like to extend special thanks to ACCESS Co., Ltd., OMTP
- BONDI and Nokia for providing the foundation of the working group's requirements discussion.
- </p>
- </section>
-</body>
+ </body>
</html>
Received on Tuesday, 5 July 2011 14:06:40 UTC