TransportImpl.java

package org.oclc.oomRef;

import info.openurl.oom.OpenURLException;
import info.openurl.oom.OpenURLRequest;
import info.openurl.oom.OpenURLRequestProcessor;
import info.openurl.oom.Service;
import info.openurl.oom.Transport;
import info.openurl.oom.config.ClassConfig;
import info.openurl.oom.config.OpenURLConfig;

import java.net.URI;

import javax.servlet.http.HttpServletRequest;

/**
 * This class is obsolete and will be removed in a future version.
 * 
 * @author Jeffrey A. Young
 * @deprecated Don't extend this class. It's not necessary, and doing
 * so tightly couples your Transports with the OOMRef-J implementation.
 */
public abstract class TransportImpl implements Transport {
	protected OpenURLConfig openURLConfig;
    protected ClassConfig classConfig; 
	private URI transportID;
	
	/**
	 * @param openURLConfig
	 * @param classConfig 
	 * @param transportID 
	 * @deprecated Don't extend this class. It's not necessary, and doing
     * so tightly couples your Transports with the OOMRef-J implementation.
	 */
	public TransportImpl(OpenURLConfig openURLConfig,
            ClassConfig classConfig,
            URI transportID) {
		this.openURLConfig = openURLConfig;
        this.classConfig = classConfig;
		this.transportID = transportID;
	}
	
	/**
	 * @deprecated Don't extend this class. It's not necessary, and doing
     * so tightly couples your Transports with the OOMRef-J implementation.
	 */
	public TransportImpl() {
    }

    /**
     * @deprecated Don't extend this class. It's not necessary, and doing
     * so tightly couples your Transports with the OOMRef-J implementation.
     * You should remove the extends clause and implement
     * info.openurl.oom.Transport directly.
     */
    public URI getTransportID() {
        return transportID;
    }
	
	/**
	 * @param className
	 * @return a Service instantiation
	 * @throws OpenURLException
     * @deprecated Don't extend this class. It's not necessary, and doing
     * so tightly couples your Transports with the OOMRef-J implementation.
     * You should remove the extends clause and implement
     * info.openurl.oom.Transport directly.
	 */
	public Service getService(String className)
	throws OpenURLException {
		try {
			return openURLConfig.getService(className);
		} catch (Exception e) {
			e.printStackTrace();
			throw new OpenURLException(e.getMessage(), e);
		}
	}

	/**
	 * @param processor - this is required because
	 * different OpenURL implementations can implement
	 * the ContextObject interface in proprietary ways.
	 * @param req
	 * @return an OpenURLRequest representation of the
	 * incoming HttpServletRequest
	 * @throws OpenURLException 
     * @deprecated Don't extend this class. It's not necessary, and doing
     * so tightly couples your Transports with the OOMRef-J implementation.
     * You should remove the extends clause and implement
     * info.openurl.oom.Transport directly.
	 */
	public abstract OpenURLRequest toOpenURLRequest(
			OpenURLRequestProcessor processor,
			HttpServletRequest req) throws OpenURLException;
}