{"id":39497279,"url":"https://github.com/clarin-eric/fcs-sru-cqi-bridge","last_synced_at":"2026-01-18T05:43:57.845Z","repository":{"id":142945219,"uuid":"513115623","full_name":"clarin-eric/fcs-sru-cqi-bridge","owner":"clarin-eric","description":null,"archived":false,"fork":false,"pushed_at":"2023-06-12T10:03:52.000Z","size":50,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-09-10T03:14:54.637Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/clarin-eric.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-07-12T11:30:46.000Z","updated_at":"2023-07-12T14:18:57.000Z","dependencies_parsed_at":"2025-09-10T01:54:59.983Z","dependency_job_id":"da4b681a-6bf2-4ab7-956d-aaa3ce38affc","html_url":"https://github.com/clarin-eric/fcs-sru-cqi-bridge","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/clarin-eric/fcs-sru-cqi-bridge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clarin-eric%2Ffcs-sru-cqi-bridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clarin-eric%2Ffcs-sru-cqi-bridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clarin-eric%2Ffcs-sru-cqi-bridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clarin-eric%2Ffcs-sru-cqi-bridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clarin-eric","download_url":"https://codeload.github.com/clarin-eric/fcs-sru-cqi-bridge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clarin-eric%2Ffcs-sru-cqi-bridge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28531368,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-18T05:43:28.324Z","updated_at":"2026-01-18T05:43:57.839Z","avatar_url":"https://github.com/clarin-eric.png","language":"Java","funding_links":[],"categories":["Endpoint Implementations"],"sub_categories":[],"readme":"# FCS SRU CQI Bridge\n\nThis package implements an FCS 2.0 SRU endpoint front end for a CQI Server. CQL queries are translated into CQP and sent to the CQI server, then the result is written in an SRU/FCS specific format.\n\nIf you previously deployed the CQI-Bridge in version `1.2`, take a look at [`UPGRADING.md`](UPGRADING.md) for migrating to FCS 2.0 (version `2.0`).\n\nLimitations:\n- Currently only one corpus is supported! _For multiple corpora take a look at the [fcs-korp-endpoint](https://github.com/clarin-eric/fcs-korp-endpoint) example implementation._\n- only supports BASIC search (Hits DataView) via CQL _(basically full-text search)_\n\nMore Information about\n- CQI: http://cwb.sourceforge.net/cqi.php\n- CWB: http://cwb.sourceforge.net/\n- FCS: https://www.clarin.eu/content/content-search\n\n## Configuration\n\nModify [`sru-server-config.xml`](src/main/webapp/WEB-INF/sru-server-config.xml) and [`endpoint-description.xml`](src/main/webapp/WEB-INF/endpoint-description.xml) to have information about your corpora.\n\nIn addition you'll have to modify [`web.xml`](src/main/webapp/WEB-INF/web.xml) to contain the configuration of your CQI server, in particular the following params must be present:\n- `cqi.serverHost` - the host name of your CQI server\n- `cqi.serverPort` - the port of your CQI server\n- `cqi.serverUsername` - the user name on your CQI server\n- `cqi.serverPassword` - the password for the above user\n- `cqi.defaultCorpus` - a corpus which will be used for all the queries\n- `cqi.defaultCorpusPID` - the PID of the corpus above\n- `cqi.defaultCorpusRef` - the Ref of the corpus above\n\nYou may need to change the CQI [`CONTEXT_STRUCTURAL_ATTRIBUTE = \"s\"`](src/main/java/eu/clarin/sru/cqibridge/CqiSRUSearchEngine.java) if your corpus is structured differently.\n\n### Legacy Support\n\nBy default, this endpoint will wrap results with the FCS _Hits_ Data View. If you need to support the legacy FCS _KWIC_ Data View (which is deprecated) but was the only Data View supported by the previous version of the endpoint implementation, you can re-enable it by setting the `eu.clarin.sru.cqibridge.supportLegacyKWIC` parameter in the [`web.xml`](src/main/webapp/WEB-INF/web.xml) to `true`. Both the Hits and KWIC Data Views will then be sent.\n_Note, however, that in some cases clients will aggregate results from both Data Views (to support legacy endpoints) so that results may appear twice._\n\n## Building \u0026 Deployment\n\nTo build the application run:\n\n```bash\nmvn clean package\n```\n\nThe application war file (`sru-cqibridge-2.0.war`) can be found in the folder [`target/`](target/).\nPlace and link it into the webapps folder of your Jetty or Tomcat ... server for deployment.\n\n### Requirements\n\n- Java 8+\n- Some `war` webapps deployment server like Jetty or Tomcat\n- a locally reachable CQI/CQP-Server to connect and send queries to\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclarin-eric%2Ffcs-sru-cqi-bridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclarin-eric%2Ffcs-sru-cqi-bridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclarin-eric%2Ffcs-sru-cqi-bridge/lists"}