The Miser Project  
privacy 
 
 
 

Collaborative articulation of how abstraction and language is employed in the computational manifestation of numbers -- including analysis of the role of syntax, semantics, and meaning in the specification and use of software interfaces.



Click for Blog Feed
Blog Feed

Recent Items
 
Compiling Num.java 0.1x
 
Deja Double Vu
 
Blog Restored
 
Unorganized set of references: to be evaluated
 
Document-centric integration; perils of API's
 
Libraries and Platform Independence
 
"External" Interface Contracts
 
Interfaces, Protocol Extensibility, and Versioning...
 
A Fine Kettle of Fish, indeed.
 
What Is a Model?

This page is powered by Blogger. Isn't yours?
  


visits to Miser Project pages

The nfoCentrale Blog Conclave
 
Millennia Antica: The Kiln Sitter's Diary
 
nfoWorks: Pursuing Harmony
 
Numbering Peano
 
Orcmid's Lair
 
Orcmid's Live Hideout
 
Prof. von Clueless in the Blunder Dome
 
Spanner Wingnut's Muddleware Lab (experimental)

nfoCentrale Associated Sites
 
DMA: The Document Management Alliance
 
DMware: Document Management Interoperability Exchange
 
Millennia Antica Pottery
 
The Miser Project
 
nfoCentrale: the Anchor Site
 
nfoWare: Information Processing Technology
 
nfoWorks: Tools for Document Interoperability
 
NuovoDoc: Design for Document System Interoperability
 
ODMA Interoperability Exchange
 
Orcmid's Lair
 
TROST: Open-System Trustworthiness

2004-12-09

 

Service interface experiences

Jacques Distler has an informative post about his experience in using the newly available National Weather Service XML data service. What's interesting in this post for the Numbering Peano exercise is the story of how Distler comes to actually get it to work. What's interesting is how expectations are set by what the NWS says it's interface is, and how the errors returned don't make it easy to fix the code. Distler summarizes two lessons:
1. Well-formed, valid, input should produce well-formed output. The format parameter is declared to be of type xsd:string. If the string I send you isn’t one of the ones you were expecting, send me an error-response. Don’t let your application blow up in my face. 2. As Sam Ruby notes below, it would be better to send the response as XML, rather than as an escaped string.
Something to consider as we work through how sense is made from interface specifications.

 
Construction Structure (Hard Hat Area) You are navigating The Miser Project.

template created 2004-05-31-22:34 -0700 (pdt) by orcmid
$$Author: Orcmid $
$$Date: 10-04-30 21:00 $
$$Revision: 22 $