• Overview
• Usage
• Detailed Servlet Configuration
  • Simple Connection Factory
  • Session Connection Factory
• Files

Overview

Usage

Detailed Servlet Configuration

Simple Connection Factory

srb_mcat

SRB Mcat to connect to

srb_user

srb username to connect as

srb_pass

password for the username

srb_domain

domain of the username

srb_zone

home zone of the username

srb_path

(Optional) home directory, defaults to '/'

srb_port

(Optional) port to use on the mcat host, defaults to 5544

srb_resource

(Optional) resource to use when uploading items, default 'null'

Session Connection Factory

First, add the following to your web.xml. This will configure the filter and register the SrbLoginServlet. You can use your own login method to fill out the session. The session connection factory just looks for the srb configuration items listed above in the session.

    <!-- Filter to bridge a clients session to the factory -->
    <filter>
        <filter-name>SessionFilter</filter-name>
        <filter-class>edu.umiacs.srb.servlet.ThreadLocalSessionFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>SessionFilter</filter-name>
        <url-pattern>/*</url-pattern>
        </filter-mapping>
    <!-- Configure the login servlet -->
    <servlet>
        <servlet-name>SrbLoginServlet</servlet-name>
        <servlet-class>edu.umiacs.srb.servlet.SrbLoginServlet</servlet-class>
        <!-- This determines where successfully logged in clients get redirected to -->
        <init-param>
            <param-name>edu.umiacs.srb.successPage</param-name>
            <param-value>Browse2</param-value>
        </init-param>
        <!-- This determines where failes clientc get redirected to -->
        <init-param>
            <param-name>edu.umiacs.srb.failurePage</param-name>
            <param-value>login.jsp</param-value>
        </init-param>
        </servlet>
    <!-- Configure browse servlet with the SessionConnectionFactory -->
    <servlet>
        <servlet-name>Browse2</servlet-name>
        <servlet-class>edu.umiacs.srb.servlet.Browse</servlet-class>
        <init-param>
            <param-name>edu.umiacs.srb.connectionfactory</param-name>
            <param-value>edu.umiacs.srb.servlet.SessionConnectionFactory</param-value>
        </init-param>
    </servlet>
    <servlet-mapping>
        <servlet-name>SrbLoginServlet</servlet-name>
        <url-pattern>/SrbLoginServlet</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>Browse2</servlet-name>
        <url-pattern>/Browse2/*</url-pattern>
    </servlet-mapping>

Second, If you're using the login servlet, you will need to create a simple login page. The following shows a sample jsp file that will ask for a username/password and redirect users to the browse servlet if they are successfully in logging in. You can download the jsp file here

Files

edu.umiacs.srb.connectionfactory

full name of class that implements edu.umiacs.srb.servlet.ConnectionFactory

edu.umiacs.srb.fileNotFound

(Optional) Message to display if a file/directory does not exist

edu.umiacs.srb.directoryForbidden

(Optional) Message displayed if a directory listing is forbidden

edu.umiacs.srb.fileForbidden

(Optional) Message displayed if a file is forbidden

edu.umiacs.srb.mimeLookup

(Optional) true/false, if true use the mime information in the srb to determine mime type, otherwise use java's built-in functions. This may slow down retrievals

edu.umiacs.srb.showDirectories

(Optional) true/false, allow srb directory listings, return 403 if false, default true

srb.mcat

SRB Mcat to connect to

srb.user

srb username to connect as

srb.pass

password for the username

srb.domain

domain of the username

srb.zone

home zone of the username

srb.path

(Optional) home directory, defaults to '/'

srb.port

(Optional) port to use on the mcat host, defaults to 5544

srb.resource

(Optional) resource to use when uploading items, default 'null'

SRB Servlet

Overview

The servlet provides url-based access to items in the SRB. This will allow you to access the srb as follows:

http://server.com/SrbServlet/zoneA/home/user.domain/file_or_directory

The SrbServlet is the location of the servlet in your webapp and /zoneA/home/user.domain/file_or_directory is the full path to a file in the SRB.

Usage

Setup tomcat or your webapp container of choice and create a new web app. Drop the jargon.jar and adapt-srb.jar files listed below into your webapp's WEB-INF/lib directory. In the WEB-INF/web.xml for your web app, add the following lines.

    <servlet>
        <servlet-name>Browse</servlet-name>
        <servlet-class>edu.umiacs.srb.servlet.Browse</servlet-class>
        <init-param>
            <param-name>edu.umiacs.srb.connectionfactory</param-name>
            <param-value>edu.umiacs.srb.servlet.SimpleConnectionFactory</param-value>
        </init-param>
        <init-param>
            <param-name>srb.user</param-name>
            <param-value>username</param-value>
        </init-param>
        <init-param>
            <param-name>srb.mcat</param-name>
            <param-value>mcat.host.com</param-value>
        </init-param>
        <!-- srb.port is optional -->
        <init-param>
            <param-name>srb.port</param-name>
            <param-value>7618</param-value>
        </init-param>
        <init-param>
            <param-name>srb.pass</param-name>
            <param-value>password</param-value>
        </init-param>
        <init-param>
            <param-name>srb.zone</param-name>
            <param-value>zoneA</param-value>
        </init-param>
        <init-param>
            <param-name>srb.domain</param-name>
            <param-value>domain</param-value>
        </init-param>
    </servlet>
    <servlet-mapping>
        <servlet-name>Browse</servlet-name>
        <url-pattern>/Browse/*</url-pattern>
    </servlet-mapping>

You will now be able to go to http://your_site.com/Browse/ (ie http://localhost:8080/Browse) and see the same directories listed as if you would have done a 'Sls /'

Additional Configuration

The webapp is composed of two parts, first is the servlet queries the srb and returns files or directory listings. The second is a factory that creates an actual connection to the srb. The factory can be switched out at any time by editing the edu.umiacs.srb.connectionfactory parameter in your web.xml and specifying your own implementation of edu.umiacs.srb.servlet.ConnectionFactory.

Parameters to configure the servlet:

• edu.umiacs.srb.connectionfactory - full name of class that implements edu.umiacs.srb.servlet.ConnectionFactory
• edu.umiacs.srb.fileNotFound - (Optional) Message to display if a file/directory does not exist
• edu.umiacs.srb.directoryForbidden - (Optional) Message displayed if a directory listing is forbidden
• edu.umiacs.srb.fileForbidden - (Optional) Message displayed if a file is forbidden
• edu.umiacs.srb.mimeLookup - (Optional) true/false, if true use the mime information in the srb to determine mime type, otherwise use java's built-in functions. This may slow down retrievals
• edu.umiacs.srb.showDirectories - (Optional) true/false, allow srb directory listings, return 403 if false, default true

The simple connection factory uses the same parameters to create connections to the srb. These parameters are passed by the servlet from the init-param list above. To use this, you would set the following in your web.xml

        <init-param>
            <param-name>edu.umiacs.srb.connectionfactory</param-name>
            <param-value>edu.umiacs.srb.servlet.SimpleConnectionFactory</param-value>
        </init-param>

Parameters to configure the default factory:

• srb.mcat - SRB Mcat to connect to
• srb.user - srb username to connect as
• srb.pass - password for the username
• srb.domain - domain of the username
• srb.zone - home zone of the username

• srb.path - (Optional) home directory, defaults to '/'
• srb.port - (Optional) port to use on the mcat host, defaults to 5544
• srb.resource - (Optional) resource to use when uploading items, default 'null'

Files

• adapt-srb.jar: Servlet library, requires tomcat or other servlet container and the srb software
• Jargon: Jargon srb software, required for the servlet

-- MikeSmorul - 16 Nov 2006