org.apache.jackrabbit.webdav.search
Class SearchInfo

java.lang.Object
  extended byorg.apache.jackrabbit.webdav.search.SearchInfo
All Implemented Interfaces:
SearchConstants, XmlSerializable

public class SearchInfo
extends Object
implements SearchConstants, XmlSerializable

SearchInfo parses the 'searchrequest' element of a SEARCH request body and performs basic validation. Both query language and the query itself can be access from the resulting object.
NOTE: The query is expected to be represented by the text contained in the Xml element specifying the query language, thus the 'basicsearch' defined by the Webdav Search Internet Draft is not supported by this implementation.

Example of a valid 'searchrequest' body

 <d:searchrequest xmlns:d="DAV:" dcr:="http://www.day.com/jcr/webdav/1.0" >
    <dcr:xpath>//sv:node[@sv:name='myapp:paragraph'][1]</dcr:xpath>
 </d:searchrequest>
 
Would return the following values:
    getLanguageName() -> xpath
    getQuery()        -> //sv:node[@sv:name='myapp:paragraph'][1]
 


Field Summary
 
Fields inherited from interface org.apache.jackrabbit.webdav.search.SearchConstants
BASICSEARCH, HEADER_DASL, NAMESPACE, QUERY_GRAMMER_SET, XML_GRAMMER, XML_QUERY_GRAMMAR, XML_QUERY_SCHEMA_DISCOVERY, XML_SEARCHREQUEST
 
Constructor Summary
SearchInfo(String language, Namespace languageNamespace, String query)
          Create a new SearchInfo instance.
 
Method Summary
static SearchInfo createFromXml(Element searchRequest)
          Create a new SearchInfo from the specifying document retrieved from the request body.
 String getLanguageName()
          Returns the name of the query language to be used.
 Namespace getLanguageNameSpace()
          Returns the namespace of the language specified with the search request element.
 String getQuery()
          Return the query string.
 Element toXml(Document document)
          Return the xml representation of this SearchInfo instance.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SearchInfo

public SearchInfo(String language,
                  Namespace languageNamespace,
                  String query)
Create a new SearchInfo instance.

Parameters:
language -
languageNamespace -
query -
Method Detail

getLanguageName

public String getLanguageName()
Returns the name of the query language to be used.

Returns:
name of the query language

getLanguageNameSpace

public Namespace getLanguageNameSpace()
Returns the namespace of the language specified with the search request element.

Returns:
namespace of the requestes language.

getQuery

public String getQuery()
Return the query string.

Returns:
query string

toXml

public Element toXml(Document document)
Return the xml representation of this SearchInfo instance.

Specified by:
toXml in interface XmlSerializable
Parameters:
document -
Returns:
xml representation

createFromXml

public static SearchInfo createFromXml(Element searchRequest)
                                throws DavException
Create a new SearchInfo from the specifying document retrieved from the request body.

Parameters:
searchRequest -
Throws:
DavException - if the root element's name is other than 'searchrequest' or if it does not contain a single child element specifying the query language to be used.


Copyright © 2005-2006 . All Rights Reserved.