fedora.server.access
Class DescribeRepositoryServlet

java.lang.Object
  javax.servlet.GenericServlet
      javax.servlet.http.HttpServlet
          fedora.server.access.DescribeRepositoryServlet

All Implemented Interfaces:

java.io.Serializable, javax.servlet.Servlet, javax.servlet.ServletConfig

public class DescribeRepositoryServlet
extends javax.servlet.http.HttpServlet

Title: DescribeRepositoryServlet.java

Description: Implements the "describeRepository" functionality of the Fedora Access LITE (API-A-LITE) interface using a java servlet front end. The syntax defined by API-A-LITE has for getting a description of the repository has the following binding:

1. describeRepository URL syntax: protocol://hostname:port/fedora/describe[?xml=BOOLEAN] This syntax requests information about the repository. The xml parameter determines the type of output returned. If the parameter is omitted or has a value of "false", a MIME-typed stream consisting of an html table is returned providing a browser-savvy means of viewing the object profile. If the value specified is "true", then a MIME-typed stream consisting of XML is returned.
• protocol - either http or https.
• hostname - required hostname of the Fedora server.
• port - required port number on which the Fedora server is running.
• fedora - required name of the Fedora access service.
• describe - required verb of the Fedora service.
• xml - an optional parameter indicating the requested output format. A value of "true" indicates a return type of text/xml; the absence of the xml parameter or a value of "false" indicates format is to be text/html.

Version:

$Id: DescribeRepositoryServlet.java,v 1.27 2005/05/04 11:59:20 rlw Exp $

Author:

rlw@virginia.edu

See Also:

Serialized Form

Nested Class Summary

class

DescribeRepositoryServlet.ReposInfoSerializerThread A Thread to serialize an ObjectProfile object into XML.

Constructor Summary

DescribeRepositoryServlet()


Method Summary

void	describeRepository(Context context, boolean xml, javax.servlet.http.HttpServletResponse response)
void	destroy() Cleans up servlet resources.
void	doGet(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Process Fedora Access Request.
void	doPost(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) For now, treat a HTTP POST request just like a GET request.
void	init() Initialize servlet.

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, doHead, doOptions, doPut, doTrace, getLastModified, service, service

Methods inherited from class javax.servlet.GenericServlet

getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, log, log

Methods inherited from class java.lang.Object

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

Constructor Detail

DescribeRepositoryServlet

public DescribeRepositoryServlet()

Method Detail

doGet

public void doGet(javax.servlet.http.HttpServletRequest request,
                  javax.servlet.http.HttpServletResponse response)
           throws javax.servlet.ServletException,
                  java.io.IOException

Process Fedora Access Request. Parse and validate the servlet input parameters and then execute the specified request.

Overrides:

doGet in class javax.servlet.http.HttpServlet

Parameters:

request - The servlet request.

response - servlet The servlet response.

Throws:

javax.servlet.ServletException - If an error occurs that effects the servlet's basic operation.

java.io.IOException - If an error occurrs with an input or output operation.

describeRepository

public void describeRepository(Context context,
                               boolean xml,
                               javax.servlet.http.HttpServletResponse response)
                        throws ServerException

Throws:

ServerException

doPost

public void doPost(javax.servlet.http.HttpServletRequest request,
                   javax.servlet.http.HttpServletResponse response)
            throws javax.servlet.ServletException,
                   java.io.IOException

For now, treat a HTTP POST request just like a GET request.

Overrides:

doPost in class javax.servlet.http.HttpServlet

Parameters:

request - The servet request.

response - The servlet response.

Throws:

javax.servlet.ServletException - If thrown by doGet.

java.io.IOException - If thrown by doGet.

init

public void init()
          throws javax.servlet.ServletException

Initialize servlet.

Overrides:

init in class javax.servlet.GenericServlet

Throws:

javax.servlet.ServletException - If the servet cannot be initialized.

destroy

public void destroy()

Cleans up servlet resources.

Specified by:

destroy in interface javax.servlet.Servlet

Overrides:

destroy in class javax.servlet.GenericServlet