java.fedora.server.utilities.AxisUtility Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of fcrepo-client Show documentation
The Fedora Client is a Java Library that allows API access to a Fedora Repository. The client is typically one part of a full Fedora installation.
The newest version!
/*
 * -----------------------------------------------------------------------------
 *
 * License and Copyright: The contents of this file are subject to the
 * Apache License, Version 2.0 (the "License"); you may not use 
 * this file except in compliance with the License. You may obtain a copy of 
 * the License at 
 * http://www.fedora-commons.org/licenses.
 *
 * Software distributed under the License is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for
 * the specific language governing rights and limitations under the License.
 *
 * The entire file consists of original code.
 * Copyright © 2008 Fedora Commons, Inc.

 * 
Copyright © 2002-2007 The Rector and Visitors of the University of 
 * Virginia and Cornell University
 
 * All rights reserved.
 *
 * -----------------------------------------------------------------------------
 */
package fedora.server.utilities;

import javax.xml.namespace.QName;

import org.apache.axis.AxisFault;

import fedora.server.errors.ServerException;
import fedora.server.errors.authorization.AuthzDeniedException;
import fedora.server.errors.authorization.AuthzException;
import fedora.server.errors.authorization.AuthzOperationalException;
import fedora.server.errors.authorization.AuthzPermittedException;

/**
 *
 * Title: AxisUtility.java
 * Description: 
 *
 * @author [email protected]
 * @version $Id: AxisUtility.java 5218 2006-11-20 05:10:11Z cwilper $
 */
public abstract class AxisUtility {

    /**
     * The (SOAP[version-specific] spec-dictated) namespace for fault codes.
     * See http://www.w3.org/TR/SOAP/#_Toc478383510 for SOAPv1.1
     * and http://www.w3.org/TR/soap12-part1/#faultcodeelement for SOAPv1.2
     * SOAP v1.2 here.
     */
    public static String SOAP_FAULT_CODE_NAMESPACE="http://www.w3.org/2003/05/soap-envelope";

    /**
     * Similar to above, this is "actor" in soap1_1 and "role"  in 1_2.
     * Soap 1.1 provides (see http://www.w3.org/TR/SOAP/#_Toc478383499) a special
     * URI for intermediaries, http://schemas.xmlsoap.org/soap/actor/next,
     * and leaves other URIs up to the application.  Soap 1.2 provides
     * (see http://www.w3.org/TR/soap12-part1/#soaproles) three special URIs --
     * one of which is for ultimate recievers, which is the category Fedora
     * falls into.  http://www.w3.org/2002/06/soap-envelope/role/ultimateReceiver
     * is the URI v1.2 provides.
     */
    public static String SOAP_ULTIMATE_RECEIVER="http://www.w3.org/2003/05/soap-envelope/role/ultimateReceiver";

    public static void throwFault(ServerException se)
            throws AxisFault {
        throw getFault(se);
    }

    public static AxisFault getFault(ServerException se) {    	
    	AxisFault fault =  AxisFault.makeFault(se);
    	String[] details=se.getDetails();
    	
    	if (details.length > 0) {
	        StringBuffer buf = new StringBuffer();
	        for (int i = 0; i < details.length; i++) {
	            buf.append("");
	            buf.append(details[i]);
	            buf.append("\n");
	        }
	    	fault.setFaultDetailString(buf.toString());
    	}
    	return fault;
    }
    
    public static AxisFault getFault(AuthzException e) {
        AxisFault fault=AxisFault.makeFault(e);
    	String reason = "";
    	if (e instanceof AuthzOperationalException) {
    		reason = AuthzOperationalException.BRIEF_DESC;
    	} else if (e instanceof AuthzDeniedException) {
    		reason = AuthzDeniedException.BRIEF_DESC;
    	} else if (e instanceof AuthzPermittedException) {
    		reason = AuthzPermittedException.BRIEF_DESC;   		
    	}
    	fault.addFaultDetail(new QName("Authz"), reason);
        return fault;
    }

    public static AxisFault getFault(Throwable th) {
        if (th instanceof ServerException) {
            if (th instanceof AuthzException) {
                return getFault((AuthzException) th);
            } else {
                return getFault((ServerException) th);
            }
        } else {
    	    return AxisFault.makeFault(
    	            new Exception("Uncaught exception from Fedora Server", th));
        }
    }

}