List Info

Thread: Perl SimpleServer 1.01 supports SRU/SRW as well as Z39.50




Perl SimpleServer 1.01 supports SRU/SRW as well as Z39.50
user name
2006-03-24 16:33:24
[Apologies to those of you who get this more than once, but
it's
relevant to the Net-Z3950, YAZ and ZNG lists.]

We at Index Data are very pleased to announce a new release
of
SimpleServer, our toolkit for building Information Retrieval
servers:
	http://indexdata.c
om/simpleserver/

The new release, v1.01, is the first in the 1.x series,
reflecting not
only the maturity of the code, but also the addition of
important new
functionality: support for SRU/SRW as well as the Z39.50
protocol that
it has always supported.

It's free software, so go ahead and download it, try it
out:
	
http://search.cpan.org/~mirk/Net-Z3950-SimpleServer/

Those of you already familiar with SimpleServer will be most
interested in the new SRU/SRW support.  I attach an extract
from the
documentation describing how these new facilities can be
used:

--

In order to serve these protocols from a SimpleServer-based
application, it is necessary to launch the application with
a YAZ
Generic Frontend Server (GFS) configuration file, which can
be
specified using the command-line argument -f filename. A
minimal
configuration file looks like this:

  <yazgfs>
    <server>
      <cql2rpn>pqf.properties</cql2rpn>
    </server>
  </yazgfs>

This file specifies only that pqf.properties should be used
to
translate the CQL queries of SRU and SRW into corresponding
Z39.50
Type-1 queries. For more information about YAZ GFS
configuration,
including how to specify an Explain record, see the Virtual
Hosts
section of the YAZ manual at
http:/
/indexdata.com/yaz/doc/server.vhosts.tkl

The mapping of CQL queries into Z39.50 Type-1 queries is
specified by
a file that indicates which BIB-1 attributes should be
generated for
each CQL index, relation, modifiers, etc. A typical section
of this
file looks like this:

  index.dc.title                        = 1=4
  index.dc.subject                      = 1=21
  index.dc.creator                      = 1=1003
  relation.<                            = 2=1
  relation.le                           = 2=2

This file specifies the BIB-1 access points (type=1) for the
Dublin
Core indexes title, subject and creator, and the BIB-1
relations
(type=2) corresponding to the CQL relations < and <=.
For more
information about the format of this file, see the CQL
section of the
YAZ manual at http
://indexdata.com/yaz/doc/tools.tkl#tools.cql

The YAZ distribution include a sample CQL-to-PQF mapping
configuration
file called pqf.properties; this is sufficient for many
applications,
and a good base to work from for most others.

If a SimpleServer-based application is run without this
SRU-specific
configuration, it can still serve SRU; however, CQL queries
will not
be translated, but passed straight through to the
search-handler
function, as the CQL member of the parameters hash. It is
then the
responsibility of the back-end application to parse and
handle the CQL
query, which is most easily done using Ed Summers' fine
CQL::Parser
module, available from CPAN at
http://s
earch.cpan.org/~esummers/CQL-Parser/

 _/|_	
____________________________________________________________
_______
/o ) \/  Mike Taylor  <mikemiketaylor.org.uk>  http://www.miketaylor.or
g.uk
)_v__/\  "If our SUPERBABY hadn't ripped open that
safe, I'd never
	 know you're STILL in love with LANA, LORI and
LYLA!" -- Lois
	 Lane's line on the cover of _Superman's Girl Friend Lois
Lane_,
	 number 39.


_______________________________________________
Yazlist mailing list
Yazlistlists.indexdata.dk
http://lists.indexdata.dk/cgi-bin/mailman/listinfo/yaz
list
[1]

about | contact  Other archives ( Real Estate discussion Medical topics )