Using the RefEntry Servlet and Client

This chapter provides procedures and examples showing how to use the servlet and client interface.

Using the Client

Once the servlet has been installed, you may be able to browse the content without instructions, entering keywords and clicking Search, as long as you are familiar with a web browser. Simply point the browser to the http://Container URL/refentry, such as http://localhost:8080/refentry, and begin searching.

You may consider as drawbacks of this version of the servlet that it supports only keyword searches, and that it returns every page it finds without ranking the pages. When refining a search, keep in mind that all words shorter than 3 letters, such as to, an, ID and so forth, are ignored. Furthermore, a configurable set of default words are also ignored. By default this includes the, and, you, that, for, was, are, with, his, they, this, from, have, one, had, not, but, what, all, were, when, there, can, your, and which.

For example, if the URL to the servlet is http://localhost:8080/refentry, you enter this in your browser address bar. To find all documents containing the word refentry, you type refentry into the search bar and click Search. It does not help to type the refentry for you in the default servlet, as the first, third, and fourth words in the search string are ignored. If you want to extend the results to include all documents containing refentry or element, notice that after you search for refentry, the servlet returns a page with refentry in the search bar. You do not have to type the word again.