jbfaden / hapi Goto Github PK

One of the exceptions that server can throw is when no data is found in the interval. Ideally, the server should respond with an empty (no-record) response, but this requires that a proper response could be formed, which might be impossible. (Consider that the server might be adapting another server, so it doesn't know what to expect unless the request contains data.) Therefore a special exception type is needed for this case. CDAWeb is returning a 503 with the message "No data...", for example. Also there may be a specific error code that could be reserved for the purpose.

When there is no data available in the requested interval, what should the behavior be?
I'd suggest an empty response, but others might prefer an error code with a message.

When a parameter is sent to a HAPI server, and it does not recognize a parameter, then it should throw an error.

The Java J2EE hapi demo should use compression. Here is a resource on how to filter:

http://www.onjava.com/pub/a/onjava/2003/11/19/filters.html

There was a tiny bit of discussion about why the parameters need a type if a CSV is used to communicate the data. This is simply because it informs the parser. For example, 'isotime' means you get out the ISO8601 parser, and integer means you can store these data as ints.

It's not clear what the restrictions on the id parameter are. For now I'm coding to include anything, but I think this should be restricted to Java identifiers.

I see a couple of issues with the current version of the document at:
https://github.com/hapi-server/specification ,
and this should be used to enumerate them.

1. CSV responses have a first row with the labels for each column. This should not be there.
2. one of the json responses has a closing double quote, instead of a double quote, under #data.
3. just prior to #catalog, capabilities is a misformatted array.