<!ENTITY % common SYSTEM "common/common.ent">
%common;
]>
-<!-- $Id: z3950_client.xml,v 1.5 2007-01-18 11:32:42 marc Exp $ -->
+<!-- $Id: z3950_client.xml,v 1.6 2007-01-26 14:49:21 adam Exp $ -->
<refentry>
<refmeta>
<refentrytitle>z3950_client</refentrytitle>
<refsect1><title>DESCRIPTION</title>
<para>
- This backend filter is a Z39.50 client.
+ This backend filter is a Z39.50 client. This modules
+ proxies all Z39.50 packages to a target. HTTP packages are ignored.
+ The address of the backend target (host) can be given as part of the
+ Initialize Request (Virtual host) or the default target may be specified
+ in the configuration.
+ </para>
+ <para>
+ <variablelist>
+ <varlistentry><term>timeout</term>
+ <listitem>
+ <para>
+ Specifies how long the client will wait for any request
+ before giving up. Default value is 30 seconds.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>default_target</term>
+ <listitem>
+ <para>
+ Specifies the target (host) for the Z39.50 server to be used
+ if the Init Request does not indicate otherwise.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>force_target</term>
+ <listitem>
+ <para>
+ Specifies the target (host) for the Z39.50 server to be used
+ always (regardless of Init Request vhost).
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
</refsect1>
<screen><![CDATA[
<filter type="z3950_client">
<timeout>30</timeout>
+ <default_target>z3950.indexdata.dk</default_target>
</filter>
]]>
</screen>
-/* $Id: filter_z3950_client.cpp,v 1.29 2007-01-25 14:05:54 adam Exp $
+/* $Id: filter_z3950_client.cpp,v 1.30 2007-01-26 14:49:22 adam Exp $
Copyright (c) 2005-2007, Index Data.
See the LICENSE file for details
public:
// number of seconds to wait before we give up request
int m_timeout_sec;
+ std::string m_default_target;
+ std::string m_force_target;
boost::mutex m_mutex;
boost::condition m_cond_session_ready;
std::map<mp::Session,Z3950Client::Assoc *> m_clients;
package.session().close();
return 0;
}
- std::list<std::string> vhosts;
- mp::util::remove_vhost_otherinfo(&apdu->u.initRequest->otherInfo, vhosts);
- size_t no_vhosts = vhosts.size();
- if (no_vhosts == 0)
+ std::string target = m_force_target;
+ if (!target.length())
{
- mp::odr odr;
- package.response() = odr.create_initResponse(
- apdu,
- YAZ_BIB1_INIT_NEGOTIATION_OPTION_REQUIRED,
- "z3950_client: No virtal host given");
-
- package.session().close();
- return 0;
- }
- if (no_vhosts > 1)
- {
- mp::odr odr;
- package.response() = odr.create_initResponse(
- apdu,
- YAZ_BIB1_COMBI_OF_SPECIFIED_DATABASES_UNSUPP,
- "z3950_client: Can not cope with multiple vhosts");
- package.session().close();
- return 0;
+ target = m_default_target;
+ std::list<std::string> vhosts;
+ mp::util::remove_vhost_otherinfo(&apdu->u.initRequest->otherInfo,
+ vhosts);
+ size_t no_vhosts = vhosts.size();
+ if (no_vhosts == 1)
+ {
+ std::list<std::string>::const_iterator v_it = vhosts.begin();
+ target = *v_it;
+ }
+ else if (no_vhosts == 0)
+ {
+ if (!target.length())
+ {
+ // no default target. So we don't know where to connect
+ mp::odr odr;
+ package.response() = odr.create_initResponse(
+ apdu,
+ YAZ_BIB1_INIT_NEGOTIATION_OPTION_REQUIRED,
+ "z3950_client: No virtal host given");
+
+ package.session().close();
+ return 0;
+ }
+ }
+ else if (no_vhosts > 1)
+ {
+ mp::odr odr;
+ package.response() = odr.create_initResponse(
+ apdu,
+ YAZ_BIB1_COMBI_OF_SPECIFIED_DATABASES_UNSUPP,
+ "z3950_client: Can not cope with multiple vhosts");
+ package.session().close();
+ return 0;
+ }
}
- std::list<std::string>::const_iterator v_it = vhosts.begin();
std::list<std::string> dblist;
std::string host;
- mp::util::split_zurl(*v_it, host, dblist);
+ mp::util::split_zurl(target, host, dblist);
if (dblist.size())
{
{
m_p->m_timeout_sec = mp::xml::get_int(ptr->children, 30);
}
+ else if (!strcmp((const char *) ptr->name, "default_target"))
+ {
+ m_p->m_default_target = mp::xml::get_text(ptr);
+ }
+ else if (!strcmp((const char *) ptr->name, "force_target"))
+ {
+ m_p->m_force_target = mp::xml::get_text(ptr);
+ }
else
{
throw mp::filter::FilterException("Bad element "
# Metaproxy XML config file schemas
-# $Id: metaproxy.rnc,v 1.17 2007-01-25 11:21:56 adam Exp $
+# $Id: metaproxy.rnc,v 1.18 2007-01-26 14:49:23 adam Exp $
#
-# Copyright (c) 2005-2006, Index Data.
+# Copyright (c) 2005-2007, Index Data.
#
# See the LICENSE file for details
#
attribute type { "z3950_client" },
attribute id { xsd:NCName }?,
attribute name { xsd:NCName }?,
- element mp:timeout { xsd:integer }?
+ element mp:timeout { xsd:integer }?,
+ element mp:default_target { xsd:string }?,
+ element mp:force_target { xsd:string }?
#filter_zeerex_explain =
# attribute type { "zeerex_explain" },