org.xins.server.FunctionRequest Maven / Gradle / Ivy
/*
* $Id: FunctionRequest.java,v 1.21 2007/09/18 08:45:05 agoubard Exp $
*
* Copyright 2003-2007 Orange Nederland Breedband B.V.
* See the COPYRIGHT file for redistribution and use restrictions.
*/
package org.xins.server;
import org.xins.common.MandatoryArgumentChecker;
import org.xins.common.collections.PropertyReader;
import org.xins.common.collections.PropertyReaderUtils;
import org.xins.common.xml.Element;
/**
* Function request. Consists of a function name, a set of parameters and a
* data section. The function name is mandatory, while there may not be any
* parameters nor data section.
*
* @version $Revision: 1.21 $ $Date: 2007/09/18 08:45:05 $
* @author Anthony Goubard
* @author Ernst de Haan
*
* @since XINS 1.2.0
*/
public class FunctionRequest {
/**
* The name of the function. This field is never null.
*/
private final String _functionName;
/**
* The parameters of the function. This field is never null
*/
private final PropertyReader _parameters;
/**
* The data section of the function. If there is none, then this field is
* null.
*/
private final Element _dataElement;
/**
* Flag indicating whether the function should be skipped or not.
*/
private final boolean _skipFunctionCall;
/**
* Creates a new FunctionRequest. The function name must be
* specified.
*
* @param functionName
* the name of the function, cannot be null.
*
* @param parameters
* the parameters of the function requested, cannot be
* null.
*
* @param dataElement
* the data section of the input request, can be null.
*
* @throws IllegalArgumentException
* if functionName == null.
*/
public FunctionRequest(String functionName,
PropertyReader parameters,
Element dataElement)
throws IllegalArgumentException {
this(functionName, parameters, dataElement, false);
}
/**
* Creates a new FunctionRequest. The function name must be
* specified.
*
* @param functionName
* the name of the function, cannot be null.
*
* @param parameters
* the parameters of the function requested, cannot be
* null.
*
* @param dataElement
* the data section of the input request, can be null.
*
* @param skipFunctionCall
* true if the function shouldn't be executed, false otherwise.
*
* @throws IllegalArgumentException
* if functionName == null.
*
* @since XINS 2.0
*/
public FunctionRequest(String functionName,
PropertyReader parameters,
Element dataElement,
boolean skipFunctionCall)
throws IllegalArgumentException {
// Check preconditions
MandatoryArgumentChecker.check("functionName", functionName);
// Store the function name (never null)
_functionName = functionName;
// Store the parameters, make sure this is never null
if (parameters == null) {
_parameters = PropertyReaderUtils.EMPTY_PROPERTY_READER;
} else {
_parameters = parameters;
}
// Store the data section, or null if there is none
_dataElement = dataElement;
_skipFunctionCall = skipFunctionCall;
}
/**
* Gets the name of the function.
*
* @return
* the name of the function, never null.
*
* @since XINS 2.0
*/
public String getFunctionName() {
return _functionName;
}
/**
* Gets the parameters of the function. The returned
* {@link PropertyReader} instance is unmodifiable.
*
* @return
* the parameters of the function, never null.
*
* @since XINS 2.0
*/
public PropertyReader getParameters() {
return _parameters;
}
/**
* Gets the data section of the request.
*
* @return
* the data section, or null if there is none.
*
* @since XINS 2.0
*/
public Element getDataElement() {
return _dataElement;
}
/**
* Gets whether the function should be executed or not.
*
* @return
* true if the function shouldn't be executed, false otherwise.
*
* @since XINS 2.0
*/
public boolean shouldSkipFunctionCall() {
return _skipFunctionCall;
}
}