npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

heliosplus

v0.0.1

Published

SOLR client for Nodejs

Downloads

6

Readme

helios - a nodejs-solr client Build Status

Well, this is a little neater version of the already available nodejs-solr clients. I figured out that a lot of problems lies in creating queries and documents. The powerful thing of this library would be the queryBuilder & document class.

Download

Releases are available for download from GitHub. Alternatively, you can install using Node Package Manager (npm) as helios:

npm install helios

Simple Execution

var helios = require('helios')
var solr_client = new helios.client({
  host : 'localhost', // Insert your client host
  port : 8989,
  path : '/solr', // Insert your client solr path
  timeout : 1000  // Optional request timeout
});

var queryBuilder = new helios.queryBuilder();

solr_client.select(queryBuilder.simpleQuery({
  op : 'OR',
  df : 'field_name',
  q : 'keyword1 keyword2'
}), function(err, res) {
  if (err) console.log(err);
  console.log(JSON.parse(res)); // yes, it returns in raw format, you need to JSON.parse it
});

Documentation


helios.queryBuilder

helios.client

helios.document


simpleQuery

queryBuilder.simpleQuery({
  op : 'OR',
  df : 'field_name',
  q : 'keyword1 keyword2'
})

facetQuery

queryBuilder.facetQuery({
  'facet' : 'true',
  'facet.date' : 'timestamp',
  'facet.date.start' : 'NOW/DAY-5DAYS',
  'facet.date.end' : 'NOW/DAY+1DAY',
  'facet.date.gap' : '+1DAY'
});

toString

It just returns the query you have made as a string

methods

solr_client.select

It accepts two arguments:

  • query string OR query object OR an instance of helios.queryBuilder
  • callback (err, res)
solr_client.select({
  q : "field_name:value",
  rows : 25,
  start : 50
  // and so on
}, function(err, res) {
  if (err) console.log(err);
  var result = JSON.parse(res); // told you, you have to JSON.parse the res
});

solr_client.addDoc

It accepts 3 arguments:

  • solrdoc : an instance of helios.document
  • commit_flag : boolean
  • callback(err) : a callback which is given an error message upon failure
var solrdoc = new helios.document();
solrdoc.addField('field_name1', 'value1');
solrdoc.addField('field_name2', 'value2');

solr_client.addDoc(solrdoc, true, function(err) {
  if (err) console.log(err);
});

solr_client.updateDoc - For Solr 4.x

It accepts 3 arguments:

  • solrdoc : an instance of helios.document
  • commit_flag : boolean
  • callback(err) : a callback which is given an error message upon failure

NOTES: Use 'set' when you want to update a field value and use 'add' for add a value to multivalue fields.

var solrdoc = new helios.document();
// update the field_name2
solrdoc.setField('field_name2', 'value1updated', null, 'set');
// add the field_name3
solrdoc.setField('field_name3', 'value3', null, 'add');
// add the field_name4 with boost=1
solrdoc.setField('field_name4', 'value4', 1 /*boost*/, 'set');

solr_client.updateDoc(solrdoc, true, function(err) {
  if (err) console.log(err);
});

Or equivalent:

var solrdoc = new helios.document();
// update the field_name2
solrdoc.setField('field_name2', 'value1updated');
// add the field_name3
solrdoc.setField('field_name3', 'value3');
// add the field_name4 with boost=1
solrdoc.setField('field_name4', 'value4');

// setting the updates and boost
doc.setFieldUpdate('field_name2', 'set');
doc.setFieldUpdate('field_name3', 'add');
doc.setFieldUpdate('field_name4', 'set');
doc.setFieldBoost('field_name4', 1);

solr_client.updateDoc(solrdoc, true, function(err) {
  if (err) console.log(err);
});
var solrdoc = new helios.document();
// delete the field_name4
doc.setFieldDelete('field_name4');

solr_client.updateDoc(solrdoc, true, function(err) {
  if (err) console.log(err);
});

solr_client.deleteDoc - For Solr 4.x

It accepts 4 arguments:

  • id : The Solr document id. This is defined in the schema.
  • values : The list of documents to delete. This could be a string or an array of strings.
  • commit_flag : boolean
  • callback(err) : a callback which is given an error message upon failure
var solrdoc = new helios.document();

// delete the document with id=1
solr_client.deleteDoc('id', '1' true, function(err) {
  if (err) console.log(err);
});

// delete the documents with id=2, id=3 and id=4
solr_client.deleteDoc('id', ['2', '3', '4'], true, function(err) {
  if (err) console.log(err);
});

solr_client.deleteDocByQuery - For Solr 4.x

It accepts 4 arguments:

  • query : The "deleteDocByQuery" uses the Lucene query parser by default. Please refer to Solr documentation for more details.
  • commit_flag : boolean
  • maxAffected : Before to delete the docs deleteDocByQuery will check how many docs will be deleted. If this is greather than the the maxAffected value the method will stop. Set this value to 0 if you want to delete all the docs affected by the query.
  • callback(err) : a callback which is given an error message upon failure
var solrdoc = new helios.document();

// delete all the documents where name = 'Peter' and cancel the delete if there are are more than 18 documents.
solr_client.deleteDocByQuery('name:Peter', commit, 18, function(err) {
  if(err) {
    console.log('error: ', err);
  } else {
    console.log('Documents deleted!');
  }
});

// delete ALL the documents where name = 'Peter' (Be careful when setting maxAffected to 0, you could delete your whole database when query=*:*)
solr_client.deleteDocByQuery('name:Peter', commit, 0, function(err) {
  if(err) {
    console.log('error: ', err);
  } else {
    console.log('Documents deleted!');
  }
});

init

var solr_doc = new helios.document();

methods

getBoost()

This returns the document's boost

setBoost

This sets the document's boost to a given float

solr_doc.setBoost(2.112);

setMultiValue

It accepts the following arguments:

  • field_name
  • value the value of the field_name
  • boost the boost to be set for field_name

This method is helpful in adding values to a multi=true field

solr_doc.setMultiValue('field_name', 'value1', 2);
solr_doc.setMultiValue('field_name', 'value2', 1.5);

note that adding boost every time in the setMultiValue for the same field_name actually results in a compound value which is the multiplication of the boosts added eg. for the above case: 2 * 1.5 = 3

getField

This method returns the value set for field_name

solr_doc.getField('field_name');

setField

This methods adds field_name whose value is value and boost is boost.

solr_doc.setField('field_name1', 'value1', 1.21);
solr_doc.setField('field_name2', 2121);

getFieldBoost

This method returns the boost of field_name

solr_doc.getFieldBoost("field_name");

setFieldBoost

This method sets the boost for field name field_name

solr_doc.setFieldBoost('field_name', 2.121);

getFieldBoosts

Returns a key-value object of all the fields and their boosts

getFieldUpdate - For Solr 4.x

This method returns the update type ('set' or 'add') of field_name

solr_doc.getFieldUpdate("field_name");

setFieldUpdate - For Solr 4.x

This method sets the update type ('set' or 'add') for field name field_name

solr_doc.setFieldUpdate('field_name', 'set');

getFieldUpdates - For Solr 4.x

Returns a key-value object of all the fields and their update types

getFieldDelete - For Solr 4.x

This method returns the delete setup for a field_name

solr_doc.getFieldDelete("field_name");

setFieldDelete - For Solr 4.x

This method sets the field name field_name to delete from the Solr doc

solr_doc.setFieldDelete('field_name');

getFieldDeletes - For Solr 4.x

Returns a key-value object of all the fields to delete from the Solr doc

clear

This clears the all the fields, fieldBoosts as well as the documentBoost

toXML

This method converts the current helios.document into a solr readable XML

solr_doc.toXML();

Issues

I know there are a lot of pending tasks and modifications required in this library. If you find any bug or a feature that you want, please submit an issue. I will respond to it as soon as I can and make required changes to it.

If you like this module, please do star it :)

npm star helios