Indoqa Solr Spring Server
This project offers a Spring based implementation of a FactoryBean for communicating with Apache Solr servers.
The SolrServerFactory allows to communicate with Solr either embedded, via http or Apache ZooKeeper for SolrCloud installations.
The desired behavior is configured with the supplied url:
- file:// - uses the EmbeddedSolrServer
- http:// - uses the HttpSolrServer
- cloud:// - uses the CloudSolrServer
Installation
Requirements
- Apache Solr 4.10+
- Spring Beans 3.1+
- Java 6+
Build
- Download the latest release via maven
<dependency>
<groupId>com.indoqa.solr</groupId>
<artifactId>spring-server</artifactId>
</dependency>
- Download source
- run "maven clean install"
Configuration
Initialize the SolrServerFactory for tests with this snippet
SolrServerFactory solrServerFactory = new SolrServerFactory();
solrServerFactory.setUrl("file:///tmp/solr-spring-server/embedded-test-core");
solrServerFactory.setEmbeddedSolrConfigurationDir("./src/test/resources/solr/test-core");
solrServerFactory.initialize();
SolrServer solrServer = solrServerFactory.getObject();
QueryResponse response = solrServer.query(new SolrQuery("*:*"));
...
solrServer.shutdown();
solrServerFactory.destroy();
The url can either be a relative or absolute directory, the embeddedSolrConfigurationDir must include the usual Solr configuration files:
- schema.xml
- solrconfig.xml
To communicate with a single Solr server use this snippet
SolrServerFactory solrServerFactory = new SolrServerFactory();
solrServerFactory.setUrl("http://localhost:8983/test-core");
solrServerFactory.initialize();
To communicate with a SolrCloud cluster use this snippet
SolrServerFactory solrServerFactory = new SolrServerFactory();
solrServerFactory.setUrl("cloud://zkHost1:2181,zkHost2:2182?collection=test-collection");
solrServerFactory.initialize();
The syntax uses zkHost1:2181,zkHost2:2182 for the ZooKeeper instances in your ZooKeeper ensemble, followed by the collection to be used. This ensures that the communication for update requests will be established against the leader of the collection to minimize communication overhead.
Solr Spring server integration based on xml configuration
<bean name="solrServerFactory" class="com.indoqa.solr.server.factory.SolrServerFactory">
<property name="url" value="file://./target/solr/embedded-test-core" />
<property name="embeddedSolrConfigurationDir" value="./src/test/resources/solr/test-core" />
</bean>