Node.js GSA (Google Search Appliance) Proxy

Installation

The proxy should be available on the npm repository. So you should simply install it using: npm install node-gsaproxy

Usage

The proxy supports multiple instances, so you can create threaded applications using multiple proxy instances.

Instantiate

First create an instance using:

var GSAProxy = require('gsaproxy');  
var gsaProxy = new GSAProxy();

Constructors

var gsaProxy = new GSAProxy(basepath, parameters);

The basepath specifies protocol, path and port of your gsa.
For Example:

http://mygsa.de/search?

The parameters object defines the parameters.
For Example:

{  
	q: 'mysearchstring',  
	site: 'mycollection',  
	[...]  
}

Getter/Setter

You have the opportunity to change the parameters after you have created the GSAProxy instance.

Basepath

If you want to query multiple gsas with the same GSAProxy instance you have can change the basepath afterwards.

var gsaProxy = new GSAProxy('http://gsa1.de/');
[...]
gsaProxy.setBasepath('http://gsa2.de/');

Parameters

The parameters you set are extended with the default parameters. So you do not have to specifiy all parameters yourself.

var gsaProxy = new GSAProxy('http://gsa1.de/', {
	site: 'collection1'
});
console.log(gsaProxy.getParameters());

gsaProxy.setParameters({
	client: 'collection1'
});
console.log(gsaProxy.getParameters());

console.log(gsaProxy.getParameter('q'));
gsaProxy.setParameter('q', 'mysearchstring');
console.log(gsaProxy.getParameter('q'));

Querying

XML

gsaProxy.execute(function(err, res) {
	if (err) throw err;
	console.log(res);
});

JSON

gsaProxy.executeJson(function(err, res) {
	if (err) throw err;
	console.log(JSON.stringify(res));
});

XSLT

gsaProxy.executeXslt(XSL_FILE_PATH_OR_XSL_AS_STRING, function(err, res) {
	if (err) throw err;
	console.log(res);
}, PARAMETERS);

Using the PARAMETERS parameter, you can pass some arguments to the xslt processor for usage in the xsl stylesheet.
The format of should be like this:

var PARAMETERS = [
	'key1', 'value1',
	'key2', 'value2'
];