Changes

   1 Revision history for Perl extension Net::Z3950::SimpleServer
   2
   3 1.15  IN PROGRESS
   4
   5 1.14  Thu Aug 18 08:47:13 UTC 2011
   6         - Support for facets in search handler
   7         - Corrections to manual, kindly supplied by Ben Webb
   8           <bjwebb67@googlemail.com>
   9         - Resolve contradictory licence terms: SimpleServer is now
  10           definitely distrbuted under the Revised BSD licence, whereas
  11           earlier versions claimed in the source code to be Revised
  12           BSD but in the README to be under the same terms as Perl.
  13
  14 1.13  Wed Mar 16 17:07:10 GMT 2011
  15         - The SimpleServer test-script now uses a Unix-domain socket,
  16           with a filename generated from the process-ID, rather than
  17           the default Inet-document socket on port 9999.  Hopefully
  18           this should resolve the race-condition problems that have
  19           been affecting the "make test" part of the build cycle when
  20           building packages for four systems simultaneously under
  21           id-pbuild.sh
  22
  23 1.12  Thu Feb  4 16:33:19 GMT 2010
  24         - Remove handling of "hits" parameter in the present handler.
  25           That should never have been there (and was probably sloppy
  26           copy), and prevents compilation under YAZ 4, which has
  27           removed the member from the bend_present_rr structure.
  28
  29 1.11  Wed Mar  4 15:12:53 GMT 2009
  30         - Add explicit statement of license (same terms as Perl).
  31           No functional changes.
  32
  33 1.10  Tue Mar  3 22:47:16 GMT 2009
  34         - Document the init-handler's PEER_NAME argument.
  35         - Update URL into YAZ documentation.
  36         - bend_delete() no longer returns without value.
  37         - Route around ActivePerl's damage to the "open" symbol.
  38
  39 1.09  Mon Sep 10 15:54:38 BST 2007
  40         - *Argh*  Another mixed statement/declaration.
  41
  42 1.08  Mon Sep 10 12:15:29 BST 2007
  43         - *Sigh*  Fix mixed statement/declaration.
  44
  45 1.07  Sat Sep  1 10:31:26 BST 2007
  46         - When the scan-handler callback returns, do not attempt to
  47           copy the terms from Perl structures if the error-code is
  48           non-zero (i.e. if an error has occurred).  This protects
  49           against a segmentation fault when the Perl callback does not
  50           explicitly set $args->{NUMBER} = 0 on error.
  51         - Correct transcription of string-valued attributes in
  52           $args->{RPN}.
  53         - Scan handler is now passed RPN as well as TERM, a tree of
  54           Perl structures representing the entire scan clause
  55           including access-points and other attributes (which are
  56           discarded from TERM).
  57         - The various classes used to represent nodes in the RPN query
  58           tree (Net::Z3950::APDU::Query, Net::Z3950::RPN::And,
  59           Net::Z3950::RPN::Or, Net::Z3950::RPN::AndNot,
  60           Net::Z3950::RPN::Term and Net::Z3950::RPN::RSID) now all
  61           share a newly introduced superclass Net::Z3950::RPN::Node,
  62           making it possible to write methods that apply to all node
  63           types.
  64         - A utility method toPQF() is provided for
  65           Net::Z3950::RPN::Node, enabling the RPN tree to be converted
  66           back into a flat PQF query.
  67         - Add support for the Delete Result Set service.
  68         - Add documentation for the Sort service.
  69         - Some clarifications to documentation.
  70
  71 1.06  Fri Aug 10 23:30:00 BST 2007
  72         - New global-handle element can be specified when creating a
  73           simple-server object and will be passed to all callback
  74           functions.  This allows global state to be eliminated from
  75           SimpleServer applications ... finally!
  76         - Search handler now deals correctly with undefined addinfo:
  77           previously a (harmless) error message was emitted.
  78         - Add Perl API to yaz_diag_srw_to_bib1(), which SimpleServer
  79           applications will need if they access SRU/SRW back-end
  80           databases and need to report errors.
  81         - Add Perl API to yaz_diag_bib1_to_srw(), because it would
  82           seem churlish not to.
  83
  84 1.05  Wed Dec 27 13:19:13 CET 2006
  85         - Taking new naming convention for YAZ constants into account.
  86
  87 1.04  Fri Dec  1 10:48:32 CET 2006
  88         - Build such that SimpleServer links to new yaz shared object.
  89
  90 1.03  Tue Aug  8 17:27:16 BST 2006
  91         - Rely on version 2.1.14 or later of YAZ; this is the first
  92           version that reliably passes through the additional
  93           information associated with errors generated while serving
  94           SRU/W requests.  No functional differences since 1.02.
  95
  96 1.02  Wed Jul 26 12:09:50 BST 2006
  97         - Better support for Open and User/Password authentication.
  98         - SimpleServer.xs's rpn2pquery() is now discarded, and YAZ's
  99           yaz_rpnquery_to_wrbuf() used instead.  This is more robust
 100           in dealing with unusual cases such as string-valued
 101           attributes.
 102         - Support for SCHEMA element when fetching records.
 103
 104 1.01  Fri Mar 24 12:09:32 GMT 2006
 105         - Documentation of release 1.00's SRU/SRW facilities.
 106         - Makefile.PL now fails if YAZ version is earlier than 2.0.0,
 107           which was the first with SRU/SRW support.
 108
 109 1.00  Fri Mar 24 01:20:24 GMT 2006
 110         - Support for SRU and SRW.  Mostly this is provided by the YAZ
 111           GFS, but changes are needed to allow for the case where
 112           there is no RPN query (due to absent on invalid <cql2rpn>
 113           element in GFS configuration) so that CQL is passed through
 114           natively; and also to fake up an {REQ_FORM} and {REP_FORM}
 115           parameters set to the "text/xml" OID when this information
 116           is not specified by the GFS.
 117           (The jump in version number is due to the SRU/W support.)
 118         - Include "logging-server.pl" in the distribution: the
 119           simplest possible SimpleServer application, which merely
 120           logs the client-request data structures.
 121         - Makefile.PL is more helpful if yaz-config isn't found.
 122         - Explicitly disable prototypes in SimpleServer.xs: makes no
 123           difference but suppresses an error message for a cleaner
 124           build.
 125
 126 0.08  Mon Jun 14 14:51:01 2004
 127         - SimpleServer is now perl 5.8 thread proof
 128         - Support for IMP_ID parameter in Init responses.  This was
 129           actually written a long time ago, but left commented out as
 130           the underlying YAZ back-end server didn't support
 131           implementation-ID setting.  Now that it does (and has done
 132           for eighteen months -- since YAZ release 1.8.6 of
 133           2002/03/25!), I've finally removed the comments.
 134         - Init handler now understands the setting of {ERR_CODE} as
 135           more than a boolean success indicator, and also {ERR_STR}.
 136           They are now passed back to the client (thanks to recent
 137           changes to the YAZ generic front-end server) in accordance
 138           with Z39.50 Implementor Agreement 5, found at
 139                 http://lcweb.loc.gov/z3950/agency/agree/initdiag.html
 140
 141 0.07  Fri Jan 03 10:12:15 2003
 142         - Applied Dave Mitchell's (davem@fdgroup.com) GRS-1 parsing patch.
 143           Thanks Dave, and sorry it didn't find its way to release 0.06,
 144           completely my fault.
 145
 146 0.06  Thu Jan 02 11:15:01 2003
 147         - Added support for authentication
 148         - Add documentation for the object tree passed as the RPN
 149           member of the search-handler's argument hash.
 150         - We actually removed the vacuous Changelog and TODO files
 151           back in 0.05.  They should never have been here :-)
 152
 153 0.05  Tue Feb 05 21:54:30 2002
 154         - Add brief documentation of the new handling
 155           of RPN.
 156
 157 0.04  Tue Feb 05 21:49:56 2002
 158         - Add Changelog (Why?  We already have this file!)
 159         - Add TODO file (although it's empty!)
 160         - Change interface to constructor, and fix test.pl script to
 161           use the new interface.
 162         - Add support for Scan.
 163         - Add support for building GRS-1 records.
 164         - Add grs_test.pl test suite for new GRS-1 code.
 165         - Add RPN structure to search-handler argument hash.
 166         - Add PID element to init, search, fetch and present-handler
 167           argument hashes (but not the sort, scan and close-handlers,
 168           for some reason.)
 169         - Fix typos in documentation.
 170
 171 0.03  Thu Nov 09 16:22:00 2000
 172         - Add the INSTALL file.
 173         - Add support for a present-handler (distinct from fetch).
 174         - Remove `$args->{LEN} = length($record)' from the example
 175           fetch-handler in the documentation.
 176         - Minor corrections to documentation, e.g. add commas after
 177           elements in anonymous hash of arguments.
 178         - Record syntaxes (formats) are now specified as ASCII OIDs
 179           (e.g. "1.2.840.10003.5.10") rather than human-readable
 180           strings (e.g. "usmarc")
 181         - Add some XS code to support sorting, though it doesn't seem
 182           to be finished yet, and is not wired out.
 183         - Use symbolic constants (e.g. Z_ElementSetNames_generic
 184           instead of hard-wired magic number 1).
 185         - Add PEER_NAME element to init-handler argument hash.
 186         - Minor changes to ztest.pl.
 187
 188 0.02  Mon Sep 11 12:32:00 2000
 189         - First released versions
 190
 191 0.01  Wed Aug 30 14:54:01 2000
 192         - original version; created by h2xs 1.19
 193
 194 ### To do
 195         - When invoking Init callback, set initial values of IMP_ID,
 196           IMP_NAME and IMP_VER from the client's Init request.
 197