| commit | a55bbb6a3a3721f8c49037de03f2967dd86e7df5 | [log] [tgz] |
|---|---|---|
| author | dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> | Mon Nov 04 00:05:34 2024 +0000 |
| committer | margaretha <margaretha@ids-mannheim.de> | Fri Nov 08 12:18:08 2024 +0100 |
| tree | 7982a2f8e41f84dd1a07e9f5fd65c483d58715ab | |
| parent | 129d1c128d5406b5f76ee3debf6b0e73799d2c3f [diff] |
Bump org.apache.maven.plugins:maven-surefire-plugin from 3.0.0 to 3.5.2 Bumps [org.apache.maven.plugins:maven-surefire-plugin](https://github.com/apache/maven-surefire) from 3.0.0 to 3.5.2. - [Release notes](https://github.com/apache/maven-surefire/releases) - [Commits](https://github.com/apache/maven-surefire/compare/surefire-3.0.0...surefire-3.5.2) --- updated-dependencies: - dependency-name: org.apache.maven.plugins:maven-surefire-plugin dependency-type: direct:production update-type: version-update:semver-minor ... Change-Id: I20803dceb4917d21007199ffb7fcbe1b1ed78d6d
KorapSRU is the CLARIN Federated Content Search (FCS) endpoint for KorAP. It implements FCS specifications and connects the CLARIN FCS client Aggregator and KorAP. Thus, public resources in KorAP are accessible from Aggregator through KorapSRU.
CLARIN defines FCS specifications to allow distributed search across multiple heterogenous search engines in a uniform way. FCS specifications are built on the SRU/CQL protocol for communications between its client and endpoint. FCS 1.0 specification supports SRU (Search Retrieve via URL) 1.2 and FCS 2.0 specification supports SRU 2.0.
KorapSRU 1.0.1 release implements FCS 1.0 specification and supports basic search using simple CQL (Contextual Query Language) for term query, phrase query and boolean query. FCS 2.0 specification has been implemented in the newer versions. It supports extended search (e.g. annotation search) that can be formulated using FCS Query Language (FCSQL) developed based on Corpus Query Processor (CQP). FCSQL is only available with SRU version 2.0, whilst CQL is available with SRU version 1.1, 1.2 and 2.0.
Usually CQL and FCSQL queries are translated into the native language of a search engine in an FCS endpoint. Since KorAP supports multiple query languages and has its own query translator Koral, the translation is implemented in Koral, not in KorapSRU. Therefore, KorAP users will also be able to use CQL and FCSQL.
gives general information about KorapSRU and some default search settings, for instance the number of records it retrieves per page. See:
To obtain more information such as supported annotation layers needed for requesting an extended search,
x-fcs-endpoint-description=true
must be added as an extra request parameter. See:
https://clarin.ids-mannheim.de/korapsru?operation=explain&x-fcs-endpoint-description=true
contains a CQL or FCSQL query. KorapSRU forwards the CQL or FCSQL query in an SRU search retrieve request URL to Kustvakt, the API provider of KorAP managing the communications among all KorAP components. Moreover, KorapSRU transforms the query results from Kustvakt into an SRU response.
Examples:
Searching for all occurrences of term Buch (means book in German)
https://clarin.ids-mannheim.de/korapsru?operation=searchRetrieve&query=Buch&version=1.2
Searching for all lemmas from Tree tagger annotations containing heit, in FCS query: [tt:lemma=".*heit"]
Java 8 (JDK 1.8 or OpenJDK 8)
Tomcat 7
Kustvakt
Configure the service URI in /src/main/webapp/WEB-INF/web.xml to KorAP API provider:
<context-param> <param-name>korap.service.uri</param-name> <param-value>https://korap.ids-mannheim.de/api/v1.0/</param-value> </context-param>
To install a war file of KorapSRU, go to the root directory of the project and run
$ mvn install -Dhttps.protocols=TLS1.2
in a terminal.
KorapSRU is published under the BSD-2 License. It is developed as part of CLARIN and KorAP, the Corpus Analysis Platform at the Leibniz Institute for the German Language (IDS), member of the Leibniz Association.