org.apache.solr.response

Class SolrQueryResponse

java.lang.Object

org.apache.solr.response.SolrQueryResponse

public class SolrQueryResponse
extends Object

SolrQueryResponse is used by a query handler to return the response to a query request.

Note On Returnable Data...
A SolrQueryResponse may contain the following types of Objects generated by the SolrRequestHandler that processed the request.

• String
• Integer
• Long
• Float
• Double
• Boolean
• Date
• DocList
• SolrDocument (since 1.3)
• SolrDocumentList (since 1.3)
• Map containing any of the items in this list
• NamedList containing any of the items in this list
• Collection containing any of the items in this list
• Array containing any of the items in this list
• null

Other data types may be added to the SolrQueryResponse, but there is no guarantee that QueryResponseWriters will be able to deal with unexpected types.

Since:

solr 0.9

Field Summary

Fields

Modifier and Type	Field and Description
protected long	endtime The endtime of the request in milliseconds.
protected Exception	err
protected boolean	httpCaching Should this response be tagged with HTTP caching headers?
protected ReturnFields	returnFields
protected NamedList<Object>	toLog Container for storing information that should be logged by Solr before returning.
protected NamedList<Object>	values Container for user defined values

Constructor Summary

Constructors

Constructor and Description
SolrQueryResponse() // another way of returning an error int errCode; String errMsg;

Method Summary

Methods

Modifier and Type	Method and Description
void	add(String name, Object val) Appends a named value to the list of named values to be returned.
void	addToLog(String name, Object val) Add a value to be logged.
long	getEndTime() Get the time in milliseconds when the response officially finished.
Exception	getException() Returns an Exception if there was a fatal error in processing the request.
NamedList<Object>	getResponseHeader() Repsonse header to be logged
ReturnFields	getReturnFields() Gets the document field names of fields to return by default when returning DocLists
NamedList<Object>	getToLog() Get loggable items.
String	getToLogAsString(String logid) Returns a string of the form "logid name1=value1 name2=value2 ..."
NamedList	getValues() Gets data to be returned in this response
boolean	isHttpCaching() Should this response emit HTTP caching headers?
void	setAllValues(NamedList<Object> nameValuePairs) Sets data to be returned in this response
long	setEndTime() Stop the timer for how long this query took.
long	setEndTime(long endtime) Set the in milliseconds when the response officially finished.
void	setException(Exception e) Causes an error to be returned instead of the results.
void	setHttpCaching(boolean httpCaching) Enables or disables the emission of HTTP caching headers for this response.
void	setReturnFields(ReturnFields fields) Sets the document field names of fields to return by default when returning DocLists

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

values

protected NamedList<Object> values

Container for user defined values

See Also:

getValues(), add(java.lang.String, java.lang.Object), setAllValues(org.apache.solr.common.util.NamedList), Note on Returnable Data

toLog

protected NamedList<Object> toLog

Container for storing information that should be logged by Solr before returning.

returnFields

protected ReturnFields returnFields

err

protected Exception err

httpCaching

protected boolean httpCaching

Should this response be tagged with HTTP caching headers?

endtime

protected long endtime

The endtime of the request in milliseconds. Used to calculate query time.

See Also:

setEndTime(long), getEndTime()

Constructor Detail

SolrQueryResponse

public SolrQueryResponse()

// another way of returning an error int errCode; String errMsg;

Method Detail

getValues

public NamedList getValues()

Gets data to be returned in this response

See Also:

Note on Returnable Data

setAllValues

public void setAllValues(NamedList<Object> nameValuePairs)

Sets data to be returned in this response

See Also:

Note on Returnable Data

setReturnFields

public void setReturnFields(ReturnFields fields)

Sets the document field names of fields to return by default when returning DocLists

getReturnFields

public ReturnFields getReturnFields()

Gets the document field names of fields to return by default when returning DocLists

add

public void add(String name,
       Object val)

Appends a named value to the list of named values to be returned.

Parameters:

name - the name of the value - may be null if unnamed

val - the value to add - also may be null since null is a legal value

See Also:

Note on Returnable Data

setException

public void setException(Exception e)

Causes an error to be returned instead of the results.

getException

public Exception getException()

Returns an Exception if there was a fatal error in processing the request. Returns null if the request succeeded.

getEndTime

public long getEndTime()

Get the time in milliseconds when the response officially finished.

setEndTime

public long setEndTime()

Stop the timer for how long this query took.

See Also:

setEndTime(long)

setEndTime

public long setEndTime(long endtime)

Set the in milliseconds when the response officially finished.

See Also:

setEndTime()

getResponseHeader

public NamedList<Object> getResponseHeader()

Repsonse header to be logged

addToLog

public void addToLog(String name,
            Object val)

Add a value to be logged.

Parameters:

name - name of the thing to log

val - value of the thing to log

getToLog

public NamedList<Object> getToLog()

Get loggable items.

Returns:

things to log

getToLogAsString

public String getToLogAsString(String logid)

Returns a string of the form "logid name1=value1 name2=value2 ..."

setHttpCaching

public void setHttpCaching(boolean httpCaching)

Enables or disables the emission of HTTP caching headers for this response.

Parameters:

httpCaching - true=emit caching headers, false otherwise

isHttpCaching

public boolean isHttpCaching()

Should this response emit HTTP caching headers?

Returns:

true=yes emit headers, false otherwise