This page last changed on Oct 14, 2009 by michael.

OpenSearch Overview

OpenSearch is a collection of simple formats for the sharing of search results.
The OpenSearch description document format is used to describe a search engine that can be used by search client applications.

The OpenSearch response elements can be used to extend existing syndication formats, such as RSS and Atom, with the extra metadata needed to return search results. The OpenSearch document is associated with the "application/opensearchdescription+xml" mime type.

For more detailed information about Open Search, refers to the Open Search home page at

Data Model

Apache Wink provides an Open Search data model for producing Open Search Documents. of the model classes are located under the org.apache.wink.common.model.opensearch package. OpenSearchDescription class is used by an application to build Open Search Description documents.

OpenSearch Support

The following table shows the OpenSearch data model and representation in which it can be serialized and de-serialized.

  Supported Media Types
Data Model
Provider registration
Yes application/
Not required. Registered by default

Producing an OpenSearch Document Example

The following example demonstrates the creation of an OpenSearch document.

    public OpenSearchDescription getOpenSearch(@Context UriInfo info) {
        String baseUri = info.getAbsolutePath().toString();
        OpenSearchDescription openSearchDescription = new OpenSearchDescription();
        openSearchDescription.setShortName("Example search engine");
        return openSearchDescription;
Document generated by Confluence on Nov 11, 2009 06:57