mirror of
https://github.com/Alfresco/alfresco-community-repo.git
synced 2025-08-07 17:49:17 +00:00
83e8cf83b8
2) Add Help to stand-alone Web Scripts test server 3) Add server-side JavaScript Debugger git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@5385 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
604 lines
23 KiB
Java
604 lines
23 KiB
Java
/*
|
|
* Copyright (C) 2005-2007 Alfresco Software Limited.
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation; either version 2
|
|
* of the License, or (at your option) any later version.
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
|
|
* As a special exception to the terms and conditions of version 2.0 of
|
|
* the GPL, you may redistribute this Program in connection with Free/Libre
|
|
* and Open Source Software ("FLOSS") applications as described in Alfresco's
|
|
* FLOSS exception. You should have recieved a copy of the text describing
|
|
* the FLOSS exception, and it is also available here:
|
|
* http://www.alfresco.com/legal/licensing"
|
|
*/
|
|
package org.alfresco.web.scripts;
|
|
|
|
import java.io.IOException;
|
|
import java.io.InputStream;
|
|
import java.util.ArrayList;
|
|
import java.util.Collection;
|
|
import java.util.Collections;
|
|
import java.util.Iterator;
|
|
import java.util.List;
|
|
import java.util.Map;
|
|
import java.util.TreeMap;
|
|
|
|
import javax.servlet.ServletContext;
|
|
|
|
import org.alfresco.service.cmr.repository.TemplateImageResolver;
|
|
import org.alfresco.web.scripts.WebScriptDescription.RequiredAuthentication;
|
|
import org.alfresco.web.scripts.WebScriptDescription.RequiredTransaction;
|
|
import org.alfresco.web.scripts.WebScriptDescription.URI;
|
|
import org.alfresco.web.ui.common.Utils;
|
|
import org.aopalliance.intercept.MethodInterceptor;
|
|
import org.apache.commons.logging.Log;
|
|
import org.apache.commons.logging.LogFactory;
|
|
import org.dom4j.Document;
|
|
import org.dom4j.DocumentException;
|
|
import org.dom4j.Element;
|
|
import org.dom4j.io.SAXReader;
|
|
import org.springframework.aop.framework.ProxyFactory;
|
|
import org.springframework.aop.support.RegexpMethodPointcutAdvisor;
|
|
import org.springframework.beans.BeansException;
|
|
import org.springframework.beans.factory.InitializingBean;
|
|
import org.springframework.context.ApplicationContext;
|
|
import org.springframework.context.ApplicationContextAware;
|
|
import org.springframework.web.context.ServletContextAware;
|
|
|
|
|
|
/**
|
|
* Registry of declarative (scripted/template driven) Web Scripts
|
|
*
|
|
* @author davidc
|
|
*/
|
|
public class DeclarativeWebScriptRegistry implements WebScriptRegistry, ApplicationContextAware, ServletContextAware, InitializingBean
|
|
{
|
|
// Logger
|
|
private static final Log logger = LogFactory.getLog(DeclarativeWebScriptRegistry.class);
|
|
|
|
private ApplicationContext applicationContext;
|
|
private ServletContext servletContext;
|
|
private String defaultWebScript;
|
|
private MethodInterceptor authenticator;
|
|
private MethodInterceptor serviceLogger;
|
|
private MethodInterceptor serviceTransaction;
|
|
private FormatRegistry formatRegistry;
|
|
private WebScriptStorage storage;
|
|
private TemplateImageResolver imageResolver;
|
|
|
|
|
|
// map of web scripts by id
|
|
// NOTE: The map is sorted by id (ascending order)
|
|
private Map<String, WebScript> webscriptsById = new TreeMap<String, WebScript>();
|
|
|
|
// map of web scripts by url
|
|
// NOTE: The map is sorted by url (descending order)
|
|
private Map<String, WebScript> webscriptsByURL = new TreeMap<String, WebScript>(Collections.reverseOrder());
|
|
|
|
|
|
//
|
|
// Initialisation
|
|
//
|
|
|
|
/**
|
|
* Sets the available Web Script Stores
|
|
*
|
|
* @param storage
|
|
*/
|
|
public void setStorage(WebScriptStorage storage)
|
|
{
|
|
this.storage = storage;
|
|
}
|
|
|
|
/**
|
|
* Sets the web script authenticator
|
|
*
|
|
* @param authenticator
|
|
*/
|
|
public void setAuthenticator(MethodInterceptor authenticator)
|
|
{
|
|
this.authenticator = authenticator;
|
|
}
|
|
|
|
/**
|
|
* Sets the web script logger
|
|
*
|
|
* @param serviceLogger
|
|
*/
|
|
public void setServiceLogger(MethodInterceptor serviceLogger)
|
|
{
|
|
this.serviceLogger = serviceLogger;
|
|
}
|
|
|
|
/**
|
|
* Sets the service transaction
|
|
*
|
|
* @param serviceTransaction
|
|
*/
|
|
public void setServiceTransaction(MethodInterceptor serviceTransaction)
|
|
{
|
|
this.serviceTransaction = serviceTransaction;
|
|
}
|
|
|
|
/**
|
|
* Sets the default service implementation bean
|
|
*
|
|
* @param defaultWebScript
|
|
*/
|
|
public void setDefaultWebScript(String defaultWebScript)
|
|
{
|
|
this.defaultWebScript = defaultWebScript;
|
|
}
|
|
|
|
/**
|
|
* Sets the response format registry
|
|
*
|
|
* @param formatRegistry
|
|
*/
|
|
public void setFormatRegistry(FormatRegistry formatRegistry)
|
|
{
|
|
this.formatRegistry = formatRegistry;
|
|
}
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.springframework.web.context.ServletContextAware#setServletContext(javax.servlet.ServletContext)
|
|
*/
|
|
public void setServletContext(ServletContext context)
|
|
{
|
|
this.servletContext = context;
|
|
}
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.springframework.context.ApplicationContextAware#setApplicationContext(org.springframework.context.ApplicationContext)
|
|
*/
|
|
public void setApplicationContext(ApplicationContext applicationContext) throws BeansException
|
|
{
|
|
this.applicationContext = applicationContext;
|
|
}
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.springframework.beans.factory.InitializingBean#afterPropertiesSet()
|
|
*/
|
|
public void afterPropertiesSet() throws Exception
|
|
{
|
|
this.imageResolver = new TemplateImageResolver()
|
|
{
|
|
public String resolveImagePathForName(String filename, boolean small)
|
|
{
|
|
return Utils.getFileTypeImage(getContext(), filename, small);
|
|
}
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Initialise Web Scripts
|
|
*
|
|
* Note: Each invocation of this method resets the list of the services
|
|
*/
|
|
public void initWebScripts()
|
|
{
|
|
if (logger.isDebugEnabled())
|
|
logger.debug("Initialising Web Scripts");
|
|
|
|
// clear currently registered services
|
|
webscriptsById.clear();
|
|
webscriptsByURL.clear();
|
|
|
|
// register services
|
|
for (WebScriptStore apiStore : storage.getStores())
|
|
{
|
|
if (logger.isDebugEnabled())
|
|
logger.debug("Locating Web Scripts within " + apiStore.getBasePath());
|
|
|
|
String[] serviceDescPaths = apiStore.getDescriptionDocumentPaths();
|
|
for (String serviceDescPath : serviceDescPaths)
|
|
{
|
|
// build service description
|
|
WebScriptDescription serviceDesc = null;
|
|
InputStream serviceDescIS = null;
|
|
try
|
|
{
|
|
serviceDescIS = apiStore.getDescriptionDocument(serviceDescPath);
|
|
serviceDesc = createDescription(apiStore, serviceDescPath, serviceDescIS);
|
|
}
|
|
catch(IOException e)
|
|
{
|
|
throw new WebScriptException("Failed to read Web Script description document " + apiStore.getBasePath() + serviceDescPath, e);
|
|
}
|
|
finally
|
|
{
|
|
try
|
|
{
|
|
if (serviceDescIS != null) serviceDescIS.close();
|
|
}
|
|
catch(IOException e)
|
|
{
|
|
// NOTE: ignore close exception
|
|
}
|
|
}
|
|
|
|
// determine if service description has been registered
|
|
String id = serviceDesc.getId();
|
|
if (webscriptsById.containsKey(id))
|
|
{
|
|
// move to next service
|
|
if (logger.isDebugEnabled())
|
|
{
|
|
WebScript existingService = webscriptsById.get(id);
|
|
WebScriptDescription existingDesc = existingService.getDescription();
|
|
String msg = "Web Script description document " + serviceDesc.getSourceStore() + "/" + serviceDesc.getSourceLocation();
|
|
msg += " overridden by " + existingDesc.getSourceStore() + "/" + existingDesc.getSourceLocation();
|
|
logger.debug(msg);
|
|
}
|
|
continue;
|
|
}
|
|
|
|
// construct service implementation
|
|
String serviceImplName = (applicationContext.containsBean("webscript." + id)) ? "webscript." + id : defaultWebScript;
|
|
AbstractWebScript serviceImpl = (AbstractWebScript)applicationContext.getBean(serviceImplName);
|
|
serviceImpl.setDescription(serviceDesc);
|
|
serviceImpl.init(this);
|
|
|
|
// wrap service implementation in appropriate interceptors (e.g. authentication)
|
|
WebScript serviceImplIF = (WebScript)serviceImpl;
|
|
if (serviceLogger != null && serviceTransaction != null && authenticator != null)
|
|
{
|
|
ProxyFactory authFactory = new ProxyFactory();
|
|
authFactory.addInterface(WebScript.class);
|
|
authFactory.setTarget(serviceImplIF);
|
|
|
|
// logging interceptor
|
|
if (serviceLogger != null)
|
|
{
|
|
RegexpMethodPointcutAdvisor advisor = new RegexpMethodPointcutAdvisor(".*execute", serviceLogger);
|
|
authFactory.addAdvisor(advisor);
|
|
}
|
|
|
|
// transaction interceptor
|
|
if (serviceDesc.getRequiredTransaction() != RequiredTransaction.none)
|
|
{
|
|
if (serviceTransaction == null)
|
|
{
|
|
throw new WebScriptException("Web Script Transaction not specified");
|
|
}
|
|
RegexpMethodPointcutAdvisor advisor = new RegexpMethodPointcutAdvisor(".*execute", serviceTransaction);
|
|
authFactory.addAdvisor(advisor);
|
|
}
|
|
|
|
// authentication interceptor
|
|
if (serviceDesc.getRequiredAuthentication() != RequiredAuthentication.none)
|
|
{
|
|
if (authenticator == null)
|
|
{
|
|
throw new WebScriptException("Web Script Authenticator not specified");
|
|
}
|
|
RegexpMethodPointcutAdvisor advisor = new RegexpMethodPointcutAdvisor(".*execute", authenticator);
|
|
authFactory.addAdvisor(advisor);
|
|
}
|
|
|
|
serviceImplIF = (WebScript)authFactory.getProxy();
|
|
}
|
|
|
|
if (logger.isDebugEnabled())
|
|
logger.debug("Found Web Script " + serviceDescPath + " (id: " + id + ", impl: " + serviceImplName + ", auth: " + serviceDesc.getRequiredAuthentication() + ", trx: " + serviceDesc.getRequiredTransaction() + ")");
|
|
|
|
// register service and its urls
|
|
webscriptsById.put(id, serviceImplIF);
|
|
for (URI uri : serviceDesc.getURIs())
|
|
{
|
|
// establish static part of url template
|
|
String uriTemplate = uri.getURI();
|
|
int queryArgIdx = uriTemplate.indexOf('?');
|
|
if (queryArgIdx != -1)
|
|
{
|
|
uriTemplate = uriTemplate.substring(0, queryArgIdx);
|
|
}
|
|
int tokenIdx = uriTemplate.indexOf('{');
|
|
if (tokenIdx != -1)
|
|
{
|
|
uriTemplate = uriTemplate.substring(0, tokenIdx);
|
|
}
|
|
|
|
// index service by static part of url (ensuring no other service has already claimed the url)
|
|
String uriIdx = serviceDesc.getMethod().toString() + ":" + uriTemplate;
|
|
if (webscriptsByURL.containsKey(uriIdx))
|
|
{
|
|
WebScript existingService = webscriptsByURL.get(uriIdx);
|
|
if (!existingService.getDescription().getId().equals(serviceDesc.getId()))
|
|
{
|
|
String msg = "Web Script document " + serviceDesc.getSourceLocation() + " is attempting to define the url '" + uriIdx + "' already defined by " + existingService.getDescription().getSourceLocation();
|
|
throw new WebScriptException(msg);
|
|
}
|
|
}
|
|
else
|
|
{
|
|
webscriptsByURL.put(uriIdx, serviceImplIF);
|
|
|
|
if (logger.isDebugEnabled())
|
|
logger.debug("Registered Web Script URL '" + uriIdx + "'");
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
if (logger.isDebugEnabled())
|
|
logger.debug("Registered " + webscriptsById.size() + " Web Scripts; " + webscriptsByURL.size() + " URLs");
|
|
}
|
|
|
|
/**
|
|
* Create an Web Script Description
|
|
*
|
|
* @param store
|
|
* @param serviceDescPath
|
|
* @param serviceDoc
|
|
*
|
|
* @return web script service description
|
|
*/
|
|
private WebScriptDescription createDescription(WebScriptStore store, String serviceDescPath, InputStream serviceDoc)
|
|
{
|
|
SAXReader reader = new SAXReader();
|
|
try
|
|
{
|
|
Document document = reader.read(serviceDoc);
|
|
Element rootElement = document.getRootElement();
|
|
if (!rootElement.getName().equals("webscript"))
|
|
{
|
|
throw new WebScriptException("Expected <webscript> root element - found <" + rootElement.getName() + ">");
|
|
}
|
|
|
|
// retrieve id
|
|
String id = serviceDescPath.substring(0, serviceDescPath.lastIndexOf("_desc.xml")).replace('/', '.');
|
|
|
|
// retrieve http method
|
|
int methodIdx = id.lastIndexOf('_');
|
|
if (methodIdx == id.length() - 1)
|
|
{
|
|
throw new WebScriptException("Unable to establish HTTP Method from web script description: naming convention must be <name>_<method>_desc.xml");
|
|
}
|
|
String method = id.substring(id.lastIndexOf('_') + 1).toUpperCase();
|
|
|
|
// retrieve short name
|
|
Element shortNameElement = rootElement.element("shortname");
|
|
if (shortNameElement == null || shortNameElement.getTextTrim() == null || shortNameElement.getTextTrim().length() == 0)
|
|
{
|
|
throw new WebScriptException("Expected <shortname> value");
|
|
}
|
|
String shortName = shortNameElement.getTextTrim();
|
|
|
|
// retrieve description
|
|
Element descriptionElement = rootElement.element("description");
|
|
String description = descriptionElement.getTextTrim();
|
|
|
|
// retrieve urls
|
|
List urlElements = rootElement.elements("url");
|
|
if (urlElements == null || urlElements.size() == 0)
|
|
{
|
|
throw new WebScriptException("Expected at one <url> element");
|
|
}
|
|
List<WebScriptDescription.URI> uris = new ArrayList<WebScriptDescription.URI>();
|
|
Iterator iterElements = urlElements.iterator();
|
|
while(iterElements.hasNext())
|
|
{
|
|
// retrieve url element
|
|
Element urlElement = (Element)iterElements.next();
|
|
|
|
// retrieve url mimetype
|
|
String format = urlElement.attributeValue("format");
|
|
if (format == null)
|
|
{
|
|
// default to unspecified format
|
|
format = "";
|
|
}
|
|
|
|
// retrieve url template
|
|
String template = urlElement.attributeValue("template");
|
|
if (template == null || template.length() == 0)
|
|
{
|
|
throw new WebScriptException("Expected template attribute on <url> element");
|
|
}
|
|
|
|
WebScriptDescriptionImpl.URIImpl uriImpl = new WebScriptDescriptionImpl.URIImpl();
|
|
uriImpl.setFormat(format);
|
|
uriImpl.setUri(template);
|
|
uris.add(uriImpl);
|
|
}
|
|
|
|
// retrieve authentication
|
|
RequiredAuthentication reqAuth = RequiredAuthentication.none;
|
|
Element authElement = rootElement.element("authentication");
|
|
if (authElement != null)
|
|
{
|
|
String reqAuthStr = authElement.getTextTrim();
|
|
if (reqAuthStr == null || reqAuthStr.length() == 0)
|
|
{
|
|
throw new WebScriptException("Expected <authentication> value");
|
|
}
|
|
reqAuth = RequiredAuthentication.valueOf(reqAuthStr);
|
|
if (reqAuth == null)
|
|
{
|
|
throw new WebScriptException("Authentication '" + reqAuthStr + "' is not a valid value");
|
|
}
|
|
}
|
|
|
|
// retrieve transaction
|
|
RequiredTransaction reqTrx = (reqAuth == RequiredAuthentication.none) ? RequiredTransaction.none : RequiredTransaction.required;
|
|
Element trxElement = rootElement.element("transaction");
|
|
if (trxElement != null)
|
|
{
|
|
String reqTrxStr = trxElement.getTextTrim();
|
|
if (reqTrxStr == null || reqTrxStr.length() == 0)
|
|
{
|
|
throw new WebScriptException("Expected <transaction> value");
|
|
}
|
|
reqTrx = RequiredTransaction.valueOf(reqTrxStr);
|
|
if (reqTrx == null)
|
|
{
|
|
throw new WebScriptException("Transaction '" + reqTrxStr + "' is not a valid value");
|
|
}
|
|
}
|
|
|
|
// construct service description
|
|
WebScriptDescriptionImpl serviceDesc = new WebScriptDescriptionImpl();
|
|
serviceDesc.setSourceStore(store);
|
|
serviceDesc.setSourceLocation(serviceDescPath);
|
|
serviceDesc.setId(id);
|
|
serviceDesc.setShortName(shortName);
|
|
serviceDesc.setDescription(description);
|
|
serviceDesc.setRequiredAuthentication(reqAuth);
|
|
serviceDesc.setRequiredTransaction(reqTrx);
|
|
serviceDesc.setMethod(method);
|
|
serviceDesc.setUris(uris.toArray(new WebScriptDescription.URI[uris.size()]));
|
|
serviceDesc.setDefaultFormat(uris.get(0).getFormat());
|
|
return serviceDesc;
|
|
}
|
|
catch(DocumentException e)
|
|
{
|
|
throw new WebScriptException("Failed to parse web script description document " + serviceDescPath, e);
|
|
}
|
|
catch(WebScriptException e)
|
|
{
|
|
throw new WebScriptException("Failed to parse web script description document " + serviceDescPath, e);
|
|
}
|
|
}
|
|
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.alfresco.web.scripts.WebScriptRegistry#getWebScripts()
|
|
*/
|
|
public Collection<WebScript> getWebScripts()
|
|
{
|
|
return webscriptsById.values();
|
|
}
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.alfresco.web.scripts.WebScriptRegistry#getWebScript(java.lang.String)
|
|
*/
|
|
public WebScript getWebScript(String id)
|
|
{
|
|
return webscriptsById.get(id);
|
|
}
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.alfresco.web.scripts.WebScriptRegistry#findWebScript(java.lang.String, java.lang.String)
|
|
*/
|
|
public WebScriptMatch findWebScript(String method, String uri)
|
|
{
|
|
// TODO: Replace with more efficient approach
|
|
DeclarativeWebScriptMatch apiServiceMatch = null;
|
|
String match = method.toString().toUpperCase() + ":" + uri;
|
|
for (Map.Entry<String, WebScript> service : webscriptsByURL.entrySet())
|
|
{
|
|
String indexedPath = service.getKey();
|
|
if (match.startsWith(indexedPath))
|
|
{
|
|
String matchPath = indexedPath.substring(indexedPath.indexOf(':') +1);
|
|
apiServiceMatch = new DeclarativeWebScriptMatch(matchPath, service.getValue());
|
|
break;
|
|
}
|
|
}
|
|
return apiServiceMatch;
|
|
}
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.alfresco.web.scripts.WebScriptRegistry#getContext()
|
|
*/
|
|
public ServletContext getContext()
|
|
{
|
|
return servletContext;
|
|
}
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.alfresco.web.scripts.WebScriptRegistry#getFormatRegistry()
|
|
*/
|
|
public FormatRegistry getFormatRegistry()
|
|
{
|
|
return this.formatRegistry;
|
|
}
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.alfresco.web.scripts.WebScriptRegistry#getTemplateProcessor()
|
|
*/
|
|
public TemplateProcessor getTemplateProcessor()
|
|
{
|
|
return this.storage.getTemplateProcessor();
|
|
}
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.alfresco.web.scripts.WebScriptRegistry#getTemplateImageResolver()
|
|
*/
|
|
public TemplateImageResolver getTemplateImageResolver()
|
|
{
|
|
return this.imageResolver;
|
|
}
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.alfresco.web.scripts.WebScriptRegistry#getScriptProcessor()
|
|
*/
|
|
public ScriptProcessor getScriptProcessor()
|
|
{
|
|
return this.storage.getScriptProcessor();
|
|
}
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.alfresco.web.scripts.WebScriptRegistry#reset()
|
|
*/
|
|
public void reset()
|
|
{
|
|
getTemplateProcessor().resetCache();
|
|
getScriptProcessor().resetCache();
|
|
initWebScripts();
|
|
}
|
|
|
|
|
|
/**
|
|
* Web Script Match
|
|
*
|
|
* @author davidc
|
|
*/
|
|
public static class DeclarativeWebScriptMatch implements WebScriptMatch
|
|
{
|
|
private String path;
|
|
private WebScript service;
|
|
|
|
/**
|
|
* Construct
|
|
*
|
|
* @param path
|
|
* @param service
|
|
*/
|
|
public DeclarativeWebScriptMatch(String path, WebScript service)
|
|
{
|
|
this.path = path;
|
|
this.service = service;
|
|
}
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.alfresco.web.scripts.WebScriptMatch#getPath()
|
|
*/
|
|
public String getPath()
|
|
{
|
|
return path;
|
|
}
|
|
|
|
/* (non-Javadoc)
|
|
* @see org.alfresco.web.scripts.WebScriptMatch#getWebScript()
|
|
*/
|
|
public WebScript getWebScript()
|
|
{
|
|
return service;
|
|
}
|
|
}
|
|
|
|
}
|