inteligr8/alfresco-community-repo
1
0
Fork 0
mirror of https://github.com/Alfresco/alfresco-community-repo.git synced 2025-08-14 17:58:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Removed existing Rule REST implementation since it is incomplete and may confuse upcomming development.

Browse Source 
git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@17983 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
This commit is contained in:
Roy Wetherall
2010-01-12 16:38:43 +00:00
parent a3afb37010
commit ec2827fa28
44 changed files with 0 additions and 4139 deletions
Download Patch File Download Diff File Expand all files Collapse all files

93
source/java/org/alfresco/repo/web/scripts/rule/ActionDefGet.java
View File

@@ -1,93 +0,0 @@
/*
* 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 received a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.web.scripts.rule;
import java.util.HashMap;
import java.util.Map;
import org.alfresco.service.cmr.action.ActionDefinition;
import org.alfresco.service.cmr.action.ActionService;
import org.springframework.extensions.webscripts.DeclarativeWebScript;
import org.springframework.extensions.webscripts.Status;
import org.springframework.extensions.webscripts.WebScriptException;
import org.springframework.extensions.webscripts.WebScriptRequest;
/**
* Web Script to GET an action definition given its name
*
* @author glen johnson at alfresco dot com
*/
public class ActionDefGet extends DeclarativeWebScript
{
// model property keys
private static final String MODEL_PROP_KEY_ACTION_DEF = "actiondef";
// private constants
private static final String REQ_PARAM_ACTION_DEF_NAME = "actionDefinitionName";
// properties for services
private ActionService actionService;
/**
* Set the actionService property.
*
* @param actionService The action service instance to set
*/
public void setActionService(ActionService actionService)
{
this.actionService = actionService;
}
/*
* (non-Javadoc)
*
* @see org.alfresco.web.scripts.DeclarativeWebScript#executeImpl(
* org.alfresco.web.scripts.WebScriptRequest,
* org.alfresco.web.scripts.WebScriptResponse)
*/
@Override
protected Map<String, Object> executeImpl(WebScriptRequest req,
Status status)
{
// initialise model to pass on for template to render
Map<String, Object> model = new HashMap<String, Object>();
// get actionDefinitionName URL template variable
String actionDefName = req.getServiceMatch().getTemplateVars().get(REQ_PARAM_ACTION_DEF_NAME);
if ((actionDefName == null) || (actionDefName.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'actionDefinitionName' URL parameter has not been provided in URL");
}
// get an action definition with the given action definition name
ActionDefinition actionDef = this.actionService.getActionDefinition(actionDefName);
// add objects to model for the template to render
model.put(MODEL_PROP_KEY_ACTION_DEF, actionDef);
return model;
}
}

129
source/java/org/alfresco/repo/web/scripts/rule/ActionDefsGet.java
View File

@@ -1,129 +0,0 @@
/*
* 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 received a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.web.scripts.rule;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import org.alfresco.service.cmr.action.ActionDefinition;
import org.alfresco.service.cmr.action.ActionService;
import org.alfresco.service.cmr.repository.NodeRef;
import org.springframework.extensions.webscripts.DeclarativeWebScript;
import org.springframework.extensions.webscripts.Status;
import org.springframework.extensions.webscripts.WebScriptRequest;
/**
* Web Script to GET the action definition collection
* This can optionally be scoped by by either
* - a node reference in the form /api/node/{store_type}/{store_id}/{id} on the URL
* - a node path in the form /api/path/{store_type}/{store_id}/{id} on the URL
*
* @author glen johnson at alfresco dot com
*/
public class ActionDefsGet extends DeclarativeWebScript
{
// private constants
private static final String REQ_URL_TEMPL_VAR_STORE_TYPE = "store_type";
private static final String REQ_URL_TEMPL_VAR_STORE_ID = "store_id";
private static final String REQ_URL_TEMPL_VAR_ID = "id";
// model property keys
private static final String MODEL_PROP_KEY_ACTION_DEFS = "actiondefs";
// properties for services & dependencies
private ActionService actionService;
private RulesHelper rulesHelper;
/**
* Set the actionService property.
*
* @param actionService The action service instance to set
*/
public void setActionService(ActionService actionService)
{
this.actionService = actionService;
}
/**
* Set the rules helper
*
* @param rulesHelper the rulesHelper to set
*/
public void setRulesHelper(RulesHelper rulesHelper)
{
this.rulesHelper = rulesHelper;
}
/*
* (non-Javadoc)
*
* @see org.alfresco.web.scripts.DeclarativeWebScript#executeImpl(
* org.alfresco.web.scripts.WebScriptRequest,
* org.alfresco.web.scripts.WebScriptResponse)
*/
@Override
protected Map<String, Object> executeImpl(WebScriptRequest req,
Status status)
{
// initialise model to pass on for template to render
Map<String, Object> model = new HashMap<String, Object>();
// get the template variables for store_type, store_id and id
String storeType = req.getServiceMatch().getTemplateVars().get(REQ_URL_TEMPL_VAR_STORE_TYPE);
String storeId = req.getServiceMatch().getTemplateVars().get(REQ_URL_TEMPL_VAR_STORE_ID);
String id = req.getServiceMatch().getTemplateVars().get(REQ_URL_TEMPL_VAR_ID);
// work out which of storeType, storeId, id template variables have been given
boolean storeTypeGiven = (storeType != null) && (storeType.length() > 0);
boolean storeIdGiven = (storeId != null) && (storeId.length() > 0);
boolean idGiven = (id != null) && (id.length() > 0);
List<ActionDefinition> actionDefs = null;
//
// if either a node reference or path are provided to scope the action
// definition collection by, then obtain a reference to that node
//
if ((storeTypeGiven && storeIdGiven && idGiven))
{
// get the node reference to scope the action definitions by
NodeRef scopeByNodeRef = this.rulesHelper.getNodeRefFromWebScriptUrl(req, storeType, storeId, id);
// get all the action definitions that are applicable for the node reference
actionDefs = this.actionService.getActionDefinitions(scopeByNodeRef);
}
// else not scoped by noderef, so get all the condition definitions
else
{
actionDefs = this.actionService.getActionDefinitions();
}
// add objects to model for the template to render
model.put(MODEL_PROP_KEY_ACTION_DEFS, actionDefs);
return model;
}
}

113
source/java/org/alfresco/repo/web/scripts/rule/ActionQueueItemStatus.java
View File

@@ -1,113 +0,0 @@
/*
* 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 received a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.web.scripts.rule;
/**
* This class defines a bean that encapsulates the
* properties present in ActionQueueItemStatus Details
* returned from the Action Queue resource
*
* @author glen johnson at alfresco com
*/
public class ActionQueueItemStatus
{
// bean property member variables
/**
* ID allocated to the action queue item when it is added to the action queue resource
*/
private String actionQueueItemId;
/**
* Execution status for the respective action queue item
* Value is one of "PENDING", "COMPLETE"
*/
private String status = null;
/**
* ID of the action (associated with this status) which is part of the action queue item
*/
private String actionId;
/**
* Return the ID of the action queue item
*
* @return the action queue item ID
*/
public String getActionQueueItemId()
{
return actionQueueItemId;
}
/**
* Sets the ID of the action queue item
*
* @param actionQueueItemId the action queue item id to set
*/
public void setActionQueueItemId(String actionQueueItemId)
{
this.actionQueueItemId = actionQueueItemId;
}
/**
* Get the status
*
* @return the status
*/
public String getStatus()
{
return status;
}
/**
* Set the status
*
* @param status the status to set
*/
public void setStatus(String status)
{
this.status = status;
}
/**
* Get the action id
*
* @return the actionId
*/
public String getActionId()
{
return actionId;
}
/**
* Set the action ID
*
* @param actionId the actionId to set
*/
public void setActionId(String actionId)
{
this.actionId = actionId;
}
}

162
source/java/org/alfresco/repo/web/scripts/rule/ActionQueuePost.java
View File

@@ -1,162 +0,0 @@
/*
* 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 received a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.web.scripts.rule;
import java.util.HashMap;
import java.util.Map;
import org.alfresco.service.cmr.action.Action;
import org.alfresco.service.cmr.action.ActionService;
import org.alfresco.service.cmr.repository.NodeRef;
import org.springframework.extensions.webscripts.DeclarativeWebScript;
import org.springframework.extensions.webscripts.Status;
import org.springframework.extensions.webscripts.WebScriptException;
import org.springframework.extensions.webscripts.WebScriptRequest;
import org.json.JSONException;
import org.json.JSONObject;
/**
* Web Script to POST an Action Queue Item onto the Action Queue
*
* @author glen johnson at alfresco dot com
*/
public class ActionQueuePost extends DeclarativeWebScript
{
// model property keys
private static final String MODEL_PROP_KEY_ACTION_Q_ITEM_STATUS = "actionQItemStatus";
// properties for services
private ActionService actionService;
// properties for dependencies
private RulesHelper rulesHelper;
/**
* @param actionService the actionService to set
*/
public void setActionService(ActionService actionService)
{
this.actionService = actionService;
}
/**
* Set the rules helper property
*
* @param rulesHelper the rulesHelper to set
*/
public void setRulesHelper(RulesHelper rulesHelper)
{
this.rulesHelper = rulesHelper;
}
/*
* (non-Javadoc)
*
* @see org.alfresco.web.scripts.DeclarativeWebScript#executeImpl(
* org.alfresco.web.scripts.WebScriptRequest,
* org.alfresco.web.scripts.WebScriptResponse)
*/
@SuppressWarnings("unchecked")
@Override
protected Map<String, Object> executeImpl(WebScriptRequest req,
Status status)
{
// initialise model to pass on to template for rendering
Map<String, Object> model = new HashMap<String, Object>();
// get the posted action queue item JSON object by parsing request content
Object contentObj = req.parseContent();
if (contentObj == null || !(contentObj instanceof JSONObject))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "Web Script request content must be a JSON Object. "
+ "Request content is either a JSON Array or not of MIME-type application/json");
}
JSONObject actionJson = null;
Action action = null;
boolean checkConditions = true;
boolean executeAsynchronously = false;
NodeRef actionedUponNodeRef = null;
try
{
// get action queue item JSON object cast from contentObj
JSONObject actionQueueItemJson = (JSONObject)contentObj;
// get action JSON object from actionQueueItem JSON
actionJson = actionQueueItemJson.getJSONObject("action");
// get the action from the action JSON object
action = this.rulesHelper.getActionFromJson(actionJson, null);
// Get 'checkConditions' and 'executeAsynchronously' properties off action queue item
checkConditions = actionQueueItemJson.optBoolean("checkConditions", true);
executeAsynchronously = actionQueueItemJson.optBoolean(
"executeAsync", action.getExecuteAsychronously());
// get the actioned-upon node reference
String nodeRefStr = actionQueueItemJson.getString("nodeRef");
actionedUponNodeRef = new NodeRef(nodeRefStr);
}
catch (JSONException je)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"Problem retrieving properties from ActionQueueItem Details sent in the request content.", je);
}
// apply rule to actionable node
this.actionService.executeAction(action, actionedUponNodeRef, checkConditions, executeAsynchronously);
// create the action queue item status bean
// to be rendered by the template
ActionQueueItemStatus actionQItemStatus = new ActionQueueItemStatus();
//
// set the action queue item id on the action queue item status bean
//
String actionedUponNodeId = actionedUponNodeRef.getId();
String actionId = action.getId();
String actionQItemId = actionId + ":" + actionedUponNodeId;
actionQItemStatus.setActionQueueItemId(actionQItemId);
// set the action id on the action queue item status bean
actionQItemStatus.setActionId(actionId);
// set the status on the action queue item status bean
if (executeAsynchronously == true)
{
actionQItemStatus.setStatus(RulesHelper.ACTION_QUEUE_ITEM_STATUS_PENDING);
}
else
{
actionQItemStatus.setStatus(RulesHelper.ACTION_QUEUE_ITEM_STATUS_COMPLETE);
}
// add objects to model for the template to render
model.put(MODEL_PROP_KEY_ACTION_Q_ITEM_STATUS, actionQItemStatus);
return model;
}
}

93
source/java/org/alfresco/repo/web/scripts/rule/ConditionDefGet.java
View File

@@ -1,93 +0,0 @@
/*
* 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 received a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.web.scripts.rule;
import java.util.HashMap;
import java.util.Map;
import org.alfresco.service.cmr.action.ActionConditionDefinition;
import org.alfresco.service.cmr.action.ActionService;
import org.springframework.extensions.webscripts.DeclarativeWebScript;
import org.springframework.extensions.webscripts.Status;
import org.springframework.extensions.webscripts.WebScriptException;
import org.springframework.extensions.webscripts.WebScriptRequest;
/**
* Web Script to GET a condition definition given its name
*
* @author glen johnson at alfresco dot com
*/
public class ConditionDefGet extends DeclarativeWebScript
{
// model property keys
private static final String MODEL_PROP_KEY_CONDITION_DEF = "conditiondef";
// private constants
private static final String REQ_PARAM_CONDITION_DEF_NAME = "conditionDefinitionName";
// properties for services
private ActionService actionService;
/**
* Set the actionService property.
*
* @param actionService The action service instance to set
*/
public void setActionService(ActionService actionService)
{
this.actionService = actionService;
}
/*
* (non-Javadoc)
*
* @see org.alfresco.web.scripts.DeclarativeWebScript#executeImpl(
* org.alfresco.web.scripts.WebScriptRequest,
* org.alfresco.web.scripts.WebScriptResponse)
*/
@Override
protected Map<String, Object> executeImpl(WebScriptRequest req,
Status status)
{
// initialise model to pass on for template to render
Map<String, Object> model = new HashMap<String, Object>();
// get conditionDefinitionName URL template variable
String conditionDefName = req.getServiceMatch().getTemplateVars().get(REQ_PARAM_CONDITION_DEF_NAME);
if ((conditionDefName == null) || (conditionDefName.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'conditionDefinitionName' URL parameter has not been provided in URL");
}
// get a condition definition with the given condition definition name
ActionConditionDefinition conditionDef = this.actionService.getActionConditionDefinition(conditionDefName);
// add objects to model for the template to render
model.put(MODEL_PROP_KEY_CONDITION_DEF, conditionDef);
return model;
}
}

82
source/java/org/alfresco/repo/web/scripts/rule/ConditionDefsGet.java
View File

@@ -1,82 +0,0 @@
/*
* 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 received a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.web.scripts.rule;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import org.alfresco.service.cmr.action.ActionConditionDefinition;
import org.alfresco.service.cmr.action.ActionService;
import org.springframework.extensions.webscripts.DeclarativeWebScript;
import org.springframework.extensions.webscripts.Status;
import org.springframework.extensions.webscripts.WebScriptRequest;
/**
* Web Script to GET the condition definition collection
*
* @author glen johnson at alfresco dot com
*/
public class ConditionDefsGet extends DeclarativeWebScript
{
// model property keys
private static final String MODEL_PROP_KEY_CONDITION_DEFS = "conditiondefs";
// properties for services
private ActionService actionService;
/**
* Set the actionService property.
*
* @param actionService The action service instance to set
*/
public void setActionService(ActionService actionService)
{
this.actionService = actionService;
}
/*
* (non-Javadoc)
*
* @see org.alfresco.web.scripts.DeclarativeWebScript#executeImpl(
* org.alfresco.web.scripts.WebScriptRequest,
* org.alfresco.web.scripts.WebScriptResponse)
*/
@Override
protected Map<String, Object> executeImpl(WebScriptRequest req,
Status status)
{
// initialise model to pass on for template to render
Map<String, Object> model = new HashMap<String, Object>();
// get all the condition definitions
List<ActionConditionDefinition> conditionDefs = this.actionService.getActionConditionDefinitions();
// add objects to model for the template to render
model.put(MODEL_PROP_KEY_CONDITION_DEFS, conditionDefs);
return model;
}
}

140
source/java/org/alfresco/repo/web/scripts/rule/RuleDelete.java
View File

@@ -1,140 +0,0 @@
/*
* 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 received a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.web.scripts.rule;
import java.util.Map;
import org.alfresco.service.cmr.repository.NodeRef;
import org.alfresco.service.cmr.rule.Rule;
import org.alfresco.service.cmr.rule.RuleService;
import org.springframework.extensions.webscripts.DeclarativeWebScript;
import org.springframework.extensions.webscripts.Status;
import org.springframework.extensions.webscripts.WebScriptException;
import org.springframework.extensions.webscripts.WebScriptRequest;
/**
* Web Script to DELETE the rule identified by the given rule node id.
*
* NOTE -
* that if a value is provided for the 'id' URL template variable {id},
* i.e. either of the following URL patterns have been used
* <url>/api/node/{store_type}/{store_id}/{id}/rules/{rule_id}</url> or
* <url>/api/path/{store_type}/{store_id}/{id}/rules/{rule_id}</url>
* then the rule owning node ref supplied therein will be ignored,
* as these URL templates are just provided for convenience and the
* rule owning node ref is retrieved by using the rule's identifying node
* ref (supplied in {rule_id})
*
* @author glen johnson at alfresco dot com
*/
public class RuleDelete extends DeclarativeWebScript
{
// private constants
private static final String REQ_TEMPL_VAR_STORE_TYPE = "store_type";
private static final String REQ_TEMPL_VAR_STORE_ID = "store_id";
private static final String REQ_TEMPL_VAR_RULE_NODE_ID = "rule_id";
// properties for services
private RuleService ruleService;
// dependencies
private RulesHelper rulesHelper;
/**
* Set the ruleService property.
*
* @param ruleService The rule service instance to set
*/
public void setRuleService(RuleService ruleService)
{
this.ruleService = ruleService;
}
/**
* Set the rules helper property
*
* @param rulesHelper the rulesHelper to set
*/
public void setRulesHelper(RulesHelper rulesHelper)
{
this.rulesHelper = rulesHelper;
}
/*
* (non-Javadoc)
*
* @see org.alfresco.web.scripts.DeclarativeWebScript#executeImpl(
* org.alfresco.web.scripts.WebScriptRequest,
* org.alfresco.web.scripts.WebScriptResponse)
*/
@Override
protected Map<String, Object> executeImpl(WebScriptRequest req,
Status status)
{
String storeType = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_STORE_TYPE);
// Handle if 'store_type' URL template token not provided
if ((storeType == null) || (storeType.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'store_type' URL template token has not been provided in URL");
}
String storeId = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_STORE_ID);
// Handle if 'storeId' URL template token not provided
if ((storeId == null) || (storeId.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'storeId' URL template token has not been provided in URL");
}
String ruleNodeId = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_RULE_NODE_ID);
// Handle if 'rule_id' URL template token not provided
if ((ruleNodeId == null) || (ruleNodeId.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'rule_id' URL template token has not been provided in URL");
}
// create the rule's identifying node reference from the given
// URL template tokens
NodeRef ruleNodeRef = this.rulesHelper.getNodeRefFromWebScriptUrl(req, storeType, storeId, ruleNodeId);
// if ruleNodeRef referred to by {store_type} {store_id} {rule_id} is 'null' then the rule identified by that
// given node id or node path no longer exists
if (ruleNodeRef == null)
{
throw new WebScriptException(Status.STATUS_NOT_FOUND, "Rule identified by rule node/path - 'store_type': "
+ storeType + " 'store_id': " + storeId + " and 'rule_id': " + ruleNodeId + " could not be found");
}
Rule rule = this.ruleService.getRule(ruleNodeRef);
NodeRef ruleOwningNodeRef = this.ruleService.getOwningNodeRef(rule);
// delete rule
this.ruleService.removeRule(ruleOwningNodeRef, rule);
return null;
}
}

152
source/java/org/alfresco/repo/web/scripts/rule/RuleGet.java
View File

@@ -1,152 +0,0 @@
/*
* 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 received a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.web.scripts.rule;
import java.util.HashMap;
import java.util.Map;
import org.alfresco.service.cmr.repository.NodeRef;
import org.alfresco.service.cmr.rule.Rule;
import org.alfresco.service.cmr.rule.RuleService;
import org.springframework.extensions.webscripts.DeclarativeWebScript;
import org.springframework.extensions.webscripts.Status;
import org.springframework.extensions.webscripts.WebScriptException;
import org.springframework.extensions.webscripts.WebScriptRequest;
/**
* Web Script to GET the rule identified by the given rule node reference.
*
* NOTE -
* that if a value is provided for the 'id' URL template variable {id},
* i.e. either of the following URL patterns have been used
* <url>/api/node/{store_type}/{store_id}/{id}/rules/{rule_id}</url> or
* <url>/api/path/{store_type}/{store_id}/{id}/rules/{rule_id}</url>
* then the rule owning node ref supplied therein will be ignored,
* as these URL templates are just provided for convenience and the
* rule owning node ref is retrieved by using the rule's identifying node
* ref (supplied in {rule_id})
*
* @author glen johnson at alfresco dot com
*/
public class RuleGet extends DeclarativeWebScript
{
// private constants
private static final String REQ_TEMPL_VAR_STORE_TYPE = "store_type";
private static final String REQ_TEMPL_VAR_STORE_ID = "store_id";
private static final String REQ_TEMPL_VAR_RULE_NODE_ID = "rule_id";
// model property keys
private static final String MODEL_PROP_KEY_RULE = "rule";
private static final String MODEL_PROP_KEY_OWNING_NODE_REF = "owningNodeRef";
// properties for services
private RuleService ruleService;
// dependencies
private RulesHelper rulesHelper;
/**
* Set the ruleService property.
*
* @param ruleService The rule service instance to set
*/
public void setRuleService(RuleService ruleService)
{
this.ruleService = ruleService;
}
/**
* Set the rules helper property
*
* @param rulesHelper the rulesHelper to set
*/
public void setRulesHelper(RulesHelper rulesHelper)
{
this.rulesHelper = rulesHelper;
}
/*
* (non-Javadoc)
*
* @see org.alfresco.web.scripts.DeclarativeWebScript#executeImpl(
* org.alfresco.web.scripts.WebScriptRequest,
* org.alfresco.web.scripts.WebScriptResponse)
*/
@Override
protected Map<String, Object> executeImpl(WebScriptRequest req,
Status status)
{
// initialise model to pass on for template to render
Map<String, Object> model = new HashMap<String, Object>();
String storeType = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_STORE_TYPE);
// Handle if 'store_type' URL template token not provided
if ((storeType == null) || (storeType.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'store_type' URL template token has not been provided in URL");
}
String storeId = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_STORE_ID);
// Handle if 'storeId' URL template token not provided
if ((storeId == null) || (storeId.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'storeId' URL template token has not been provided in URL");
}
String ruleNodeId = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_RULE_NODE_ID);
// Handle if 'ruleNodeId' URL template token not provided
if ((ruleNodeId == null) || (ruleNodeId.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'ruleNodeId' URL template token has not been provided in URL");
}
// create the rule node reference from the given
// URL template tokens
NodeRef ruleNodeRef = this.rulesHelper.getNodeRefFromWebScriptUrl(req, storeType, storeId, ruleNodeId);
// if ruleNodeRef referred to by {store_type} {store_id} {rule_id} is 'null' then the rule identified by that
// given node id or node path no longer exists
if (ruleNodeRef == null)
{
throw new WebScriptException(Status.STATUS_NOT_FOUND, "Rule identified by rule node/path - 'store_type': "
+ storeType + " 'store_id': " + storeId + " and 'rule_id': " + ruleNodeId + " could not be found");
}
// get rule identified by the given rule node reference
Rule rule = this.ruleService.getRule(ruleNodeRef);
// get rule's owning node
NodeRef ruleOwningNodeRef = this.ruleService.getOwningNodeRef(rule);
// add objects to model for the template to render
model.put(MODEL_PROP_KEY_RULE, rule);
model.put(MODEL_PROP_KEY_OWNING_NODE_REF, ruleOwningNodeRef.toString());
return model;
}
}

168
source/java/org/alfresco/repo/web/scripts/rule/RulePut.java
View File

@@ -1,168 +0,0 @@
/*
* 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 received a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.web.scripts.rule;
import java.util.HashMap;
import java.util.Map;
import org.alfresco.service.cmr.repository.NodeRef;
import org.alfresco.service.cmr.rule.Rule;
import org.alfresco.service.cmr.rule.RuleService;
import org.springframework.extensions.webscripts.DeclarativeWebScript;
import org.springframework.extensions.webscripts.Status;
import org.springframework.extensions.webscripts.WebScriptException;
import org.springframework.extensions.webscripts.WebScriptRequest;
import org.json.JSONObject;
/**
* Web Script to PUT (update) the rule identified by the given rule node reference.
*
* NOTE -
* that if a value is provided for the 'id' URL template variable {id},
* i.e. either of the following URL patterns have been used
* <url>/api/node/{store_type}/{store_id}/{id}/rules/{rule_id}</url> or
* <url>/api/path/{store_type}/{store_id}/{id}/rules/{rule_id}</url>
* then the rule owning node ref supplied therein will be ignored,
* as these URL templates are just provided for convenience and the
* rule owning node ref is retrieved by using the rule's identifying node
* ref (supplied in {rule_id})
*
* @author glen johnson at alfresco dot com
*/
public class RulePut extends DeclarativeWebScript
{
// private constants
private static final String REQ_TEMPL_VAR_STORE_TYPE = "store_type";
private static final String REQ_TEMPL_VAR_STORE_ID = "store_id";
private static final String REQ_TEMPL_VAR_RULE_NODE_ID = "rule_id";
// model property keys
private static final String MODEL_PROP_KEY_RULE = "rule";
private static final String MODEL_PROP_KEY_OWNING_NODE_REF = "owningNodeRef";
// properties for services
private RuleService ruleService;
// dependencies
private RulesHelper rulesHelper;
/**
* Set the ruleService property.
*
* @param ruleService The rule service instance to set
*/
public void setRuleService(RuleService ruleService)
{
this.ruleService = ruleService;
}
/**
* Set the rules helper
*
* @param rulesHelper the rulesHelper to set
*/
public void setRulesHelper(RulesHelper rulesHelper)
{
this.rulesHelper = rulesHelper;
}
/*
* (non-Javadoc)
*
* @see org.alfresco.web.scripts.DeclarativeWebScript#executeImpl(
* org.alfresco.web.scripts.WebScriptRequest,
* org.alfresco.web.scripts.WebScriptResponse)
*/
@SuppressWarnings("unchecked")
@Override
protected Map<String, Object> executeImpl(WebScriptRequest req,
Status status)
{
// initialise model to pass on for template to render
Map<String, Object> model = new HashMap<String, Object>();
String storeType = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_STORE_TYPE);
// Handle if 'store_type' URL template token not provided
if ((storeType == null) || (storeType.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'store_type' URL template token has not been provided in URL");
}
String storeId = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_STORE_ID);
// Handle if 'storeId' URL template token not provided
if ((storeId == null) || (storeId.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'storeId' URL template token has not been provided in URL");
}
String ruleNodeId = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_RULE_NODE_ID);
// Handle if 'ruleNodeId' URL template token not provided
if ((ruleNodeId == null) || (ruleNodeId.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'ruleNodeId' URL template token has not been provided in URL");
}
// create the rule node reference from the given
// URL template tokens
NodeRef ruleNodeRef = this.rulesHelper.getNodeRefFromWebScriptUrl(req, storeType, storeId, ruleNodeId);
// if ruleNodeRef referred to by {store_type} {store_id} {rule_id} is 'null' then the rule identified by that
// given node id or node path no longer exists
if (ruleNodeRef == null)
{
throw new WebScriptException(Status.STATUS_NOT_FOUND, "Rule identified by rule node/path - 'store_type': "
+ storeType + " 'store_id': " + storeId + " and 'rule_id': " + ruleNodeId + " could not be found");
}
// get the rule JSON object sent in the request content (when PUTting the Rule)
Object contentObj = req.parseContent();
if (contentObj == null || !(contentObj instanceof JSONObject))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "Web Script request content must be a JSON Object. "
+ "Request content is either a JSON Array or not of MIME-type application/json");
}
JSONObject ruleJson = (JSONObject)contentObj;
// update the rule object identified by the given rule node reference
// with the details in the rule JSON
Rule rule = this.rulesHelper.getRuleFromJson(ruleJson, ruleNodeRef);
// get owning node ref that rule was
// previous applied to
NodeRef ruleOwningNodeRef = this.ruleService.getOwningNodeRef(rule);
// re-apply rule to owning node
this.ruleService.saveRule(ruleOwningNodeRef, rule);
// add objects to model for the template to render
model.put(MODEL_PROP_KEY_RULE, rule);
model.put(MODEL_PROP_KEY_OWNING_NODE_REF, ruleOwningNodeRef.toString());
return model;
}
}

1180
source/java/org/alfresco/repo/web/scripts/rule/RuleServiceTest.java
View File

File diff suppressed because it is too large Load Diff

116
source/java/org/alfresco/repo/web/scripts/rule/RulesDelete.java
View File

@@ -1,116 +0,0 @@
/*
* 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 received a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.web.scripts.rule;
import java.util.Map;
import org.alfresco.service.cmr.repository.NodeRef;
import org.alfresco.service.cmr.rule.RuleService;
import org.springframework.extensions.webscripts.DeclarativeWebScript;
import org.springframework.extensions.webscripts.Status;
import org.springframework.extensions.webscripts.WebScriptException;
import org.springframework.extensions.webscripts.WebScriptRequest;
/**
* Web Script to DELETE the rule collection associated with the given rule owning node.
*
* @author glen johnson at alfresco dot com
*/
public class RulesDelete extends DeclarativeWebScript
{
// private constants
private static final String REQ_TEMPL_VAR_STORE_TYPE = "store_type";
private static final String REQ_TEMPL_VAR_STORE_ID = "store_id";
private static final String REQ_TEMPL_VAR_NODE_ID = "id";
// properties for services
private RuleService ruleService;
// properties for dependencies
private RulesHelper rulesHelper;
/**
* Set the ruleService property.
*
* @param ruleService The rule service instance to set
*/
public void setRuleService(RuleService ruleService)
{
this.ruleService = ruleService;
}
/**
* @param rulesHelper the rulesHelper to set
*/
public void setRulesHelper(RulesHelper rulesHelper)
{
this.rulesHelper = rulesHelper;
}
/*
* (non-Javadoc)
*
* @see org.alfresco.web.scripts.DeclarativeWebScript#executeImpl(
* org.alfresco.web.scripts.WebScriptRequest,
* org.alfresco.web.scripts.WebScriptResponse)
*/
@Override
protected Map<String, Object> executeImpl(WebScriptRequest req,
Status status)
{
String storeType = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_STORE_TYPE);
// Handle if 'store_type' URL template token not provided
if ((storeType == null) || (storeType.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'store_type' URL template token has not been provided in URL");
}
String storeId = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_STORE_ID);
// Handle if 'storeId' URL template token not provided
if ((storeId == null) || (storeId.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'storeId' URL template token has not been provided in URL");
}
String nodeId = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_NODE_ID);
// Handle if 'nodeId' URL template token not provided
if ((nodeId == null) || (nodeId.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'nodeId' URL template token has not been provided in URL");
}
// create the rule owning node reference from the given
// URL template tokens
NodeRef ruleOwningNodeRef = this.rulesHelper.getNodeRefFromWebScriptUrl(req, storeType, storeId, nodeId);
// delete rule collection associated with the rule owning node
this.ruleService.removeAllRules(ruleOwningNodeRef);
return null;
}
}

162
source/java/org/alfresco/repo/web/scripts/rule/RulesGet.java
View File

@@ -1,162 +0,0 @@
/*
* 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 received a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.web.scripts.rule;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import org.alfresco.service.cmr.repository.NodeRef;
import org.alfresco.service.cmr.rule.Rule;
import org.alfresco.service.cmr.rule.RuleService;
import org.springframework.extensions.webscripts.DeclarativeWebScript;
import org.springframework.extensions.webscripts.Status;
import org.springframework.extensions.webscripts.WebScriptException;
import org.springframework.extensions.webscripts.WebScriptRequest;
/**
* Web Script to GET the rule collection associated with the given rule owning node.
* The following optional parameters can be provided:
*
* - includeInherited: if provided, then this parameter indicates whether or not to include rules
* inherited from the owning node's parents. If this parameter is not provided , then rules
* inherited from the node's parents are included by default.
*
* - ruleTypeName: if this parameter is provided, then only rules of this given rule type are returned.
* If this parameter is not provided then rules of all types will be returned.
*
* @author glen johnson at alfresco dot com
*/
public class RulesGet extends DeclarativeWebScript
{
// private constants
private static final String REQ_TEMPL_VAR_STORE_TYPE = "store_type";
private static final String REQ_TEMPL_VAR_STORE_ID = "store_id";
private static final String REQ_TEMPL_VAR_NODE_ID = "id";
private static final String REQ_PARAM_INCLUDE_INHERITED = "includeInherited";
private static final String REQ_PARAM_RULE_TYPE_NAME = "ruleTypeName";
// model property keys
private static final String MODEL_PROP_KEY_RULES = "rules";
private static final String MODEL_PROP_KEY_OWNING_NODE_REF = "owningNodeRef";
// properties for services
private RuleService ruleService;
// properties for dependencies
private RulesHelper rulesHelper;
/**
* Set the ruleService property.
*
* @param ruleService The rule service instance to set
*/
public void setRuleService(RuleService ruleService)
{
this.ruleService = ruleService;
}
/**
* @param rulesHelper the rulesHelper to set
*/
public void setRulesHelper(RulesHelper rulesHelper)
{
this.rulesHelper = rulesHelper;
}
/*
* (non-Javadoc)
*
* @see org.alfresco.web.scripts.DeclarativeWebScript#executeImpl(
* org.alfresco.web.scripts.WebScriptRequest,
* org.alfresco.web.scripts.WebScriptResponse)
*/
@Override
protected Map<String, Object> executeImpl(WebScriptRequest req,
Status status)
{
// initialise model to pass on for template to render
Map<String, Object> model = new HashMap<String, Object>();
String storeType = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_STORE_TYPE);
// Handle if 'store_type' URL template token not provided
if ((storeType == null) || (storeType.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'store_type' URL template token has not been provided in URL");
}
String storeId = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_STORE_ID);
// Handle if 'storeId' URL template token not provided
if ((storeId == null) || (storeId.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'storeId' URL template token has not been provided in URL");
}
String nodeId = req.getServiceMatch().getTemplateVars().get(REQ_TEMPL_VAR_NODE_ID);
// Handle if 'nodeId' URL template token not provided
if ((nodeId == null) || (nodeId.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'nodeId' URL template token has not been provided in URL");
}
//
// get URL parameters
//
// get the 'includeInherited' parameter. The value defaults to 'true' if
// the parameter has not been provided
boolean includeInherited = true;
String includeInheritedParam = req.getParameter(REQ_PARAM_INCLUDE_INHERITED);
if ((includeInheritedParam != null) && (includeInheritedParam.length() > 0))
{
includeInherited = Boolean.parseBoolean(includeInheritedParam);
}
// get the 'ruleTypeName' parameter. The value defaults to 'null' if
// the parameter has not been provided
String ruleTypeName = null;
String ruleTypeNameParam = req.getParameter(REQ_PARAM_RULE_TYPE_NAME);
if ((ruleTypeNameParam != null) && (ruleTypeNameParam.length() > 0))
{
ruleTypeName = ruleTypeNameParam;
}
// create the rule owning node reference from the given URL template tokens
NodeRef owningNodeRef = this.rulesHelper.getNodeRefFromWebScriptUrl(req, storeType, storeId, nodeId);
// get rule collection associated with the rule owning node
List<Rule> rules = this.ruleService.getRules(owningNodeRef, includeInherited, ruleTypeName);
// add objects to model for the template to render
model.put(MODEL_PROP_KEY_RULES, rules);
model.put(MODEL_PROP_KEY_OWNING_NODE_REF, owningNodeRef.toString());
return model;
}
}

987
source/java/org/alfresco/repo/web/scripts/rule/RulesHelper.java
View File

@@ -1,987 +0,0 @@
/*
* 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 received a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.web.scripts.rule;
import java.io.Serializable;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import org.alfresco.repo.model.Repository;
import org.alfresco.service.ServiceRegistry;
import org.alfresco.service.cmr.action.Action;
import org.alfresco.service.cmr.action.ActionCondition;
import org.alfresco.service.cmr.action.ActionService;
import org.alfresco.service.cmr.action.CompositeAction;
import org.alfresco.service.cmr.action.ParameterDefinition;
import org.alfresco.service.cmr.action.ParameterizedItem;
import org.alfresco.service.cmr.action.ParameterizedItemDefinition;
import org.alfresco.service.cmr.dictionary.DataTypeDefinition;
import org.alfresco.service.cmr.dictionary.DictionaryService;
import org.alfresco.service.cmr.repository.NodeRef;
import org.alfresco.service.cmr.repository.datatype.DefaultTypeConverter;
import org.alfresco.service.cmr.rule.Rule;
import org.alfresco.service.cmr.rule.RuleService;
import org.alfresco.service.cmr.rule.RuleType;
import org.alfresco.service.namespace.QName;
import org.springframework.extensions.webscripts.Status;
import org.springframework.extensions.webscripts.WebScriptException;
import org.springframework.extensions.webscripts.WebScriptRequest;
import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;
/**
* Class to hold helper methods for the Rules / Actions
* REST API
*
* @author glen johnson at alfresco com
*/
public class RulesHelper
{
// public constants for ActionQueueItem Statuses
public static final String ACTION_QUEUE_ITEM_STATUS_PENDING = "PENDING";
public static final String ACTION_QUEUE_ITEM_STATUS_COMPLETE = "COMPLETE";
// private constants
private static final String COMPOSITE_ACTION_DEF_NAME = "composite-action";
private static final String REQ_URL_PART_NODE_REF = "/api/node";
private static final String REQ_URL_PART_NODE_PATH = "/api/path";
private static final String REQ_URL_PART_RULE_NODE_REF = "/api/rules";
// service dependencies
private ServiceRegistry serviceRegistry;
// dependencies
private Repository repositoryContext = null;
// list of valid rule type names
List<String> validRuleTypeNames = null;
/**
* Set the service registry
*
* @param serviceRegistry the service registry
*/
public void setServiceRegistry(ServiceRegistry serviceRegistry)
{
this.serviceRegistry = serviceRegistry;
}
/**
* Set the repository context
*
* @param repositoryContext the repositoryContext to set
*/
public void setRepositoryContext(Repository repositoryContext)
{
this.repositoryContext = repositoryContext;
}
/**
* Init method.
*/
public void init()
{
// Register a list of valid rule type names
RuleService ruleService = this.serviceRegistry.getRuleService();
validRuleTypeNames = new ArrayList<String>();
List<RuleType> validRuleTypes = ruleService.getRuleTypes();
for (RuleType ruleType : validRuleTypes)
{
validRuleTypeNames.add(ruleType.getName());
}
}
/**
* Return if the given rule type name is a valid rule type
*
* @param ruleTypeName The rule type for which we want to test validity
*
* @return Whether or not the given rule type name is valid
*/
public boolean isValidRuleTypeName(String ruleTypeName)
{
return validRuleTypeNames.contains(ruleTypeName);
}
/**
* Return a Rule object created/updated from a given rule JSON object (Rule Details sent).
*
* If a node reference is passed into the <pre>ruleNodeRefToUpdate</pre> parameter,
* then this indicates that an existing rule (identified by that node
* reference) is to be updated from the given rule JSON object. If a 'null'
* node reference is passed in, then this indicates that a new rule is to
* be created from scratch.
*
* @param ruleJson the rule JSON object to create/update the rule from
* @param ruleNodeRefToUpdate The node reference of the rule to update.
* Set to <pre>null</pre> if a new rule is to be created from scratch.
*
* @return The rule created from the given rule JSON object
*/
public Rule getRuleFromJson(JSONObject ruleJson, NodeRef ruleNodeRefToUpdate)
{
// get a reference to the rule service
RuleService ruleService = this.serviceRegistry.getRuleService();
// set a boolean flag indicating whether or not to update an existing rule
boolean update = (ruleNodeRefToUpdate != null);
//
// update/create a rule object from the given rule JSON object
//
Rule rule = null;
if (update == true)
{
// we are doing an update of an existing rule so get
// the rule identified by the given rule node reference
// so that it can be updated with the rule details
// in the given rule JSON object
rule = ruleService.getRule(ruleNodeRefToUpdate);
}
else
{
// we are not doing an update, so create a new rule from scratch
rule = new Rule();
}
//
// set rule properties
//
try
{
if ((ruleJson.isNull("title") == true) && (update == false))
{
// the "title" field is missing in the rule details,
// and we are creating a new rule,
// but the "title" field is mandatory, so throw an exception
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "A new rule is being created but the 'title' "
+ "field, which is mandatory, has not been included in the rule details");
}
// otherwise just go ahead and set the value if the field is present
// to over both creating and updating scenarios
else if (ruleJson.isNull("title") == false)
{
String ruleTitle = ruleJson.getString("title");
rule.setTitle(ruleTitle);
}
}
catch (JSONException je)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "There was a problem reading the 'title' property "
+ "in the received Rule JSON. It may contain invalid characters", je);
}
try
{
if (ruleJson.isNull("description") == false)
{
rule.setDescription(ruleJson.getString("description"));
}
}
catch (JSONException je)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "There was a problem reading the 'description' property "
+ "in the received Rule JSON. It may contain invalid characters. The title of the offending rule is '"
+ ruleJson.optString("title") + "'", je);
}
// set values from the respective Boolean fields below, but if the
// if the value given for a field does not equate to either
// 'true' or 'false', then set it to a default value of false
if (ruleJson.isNull("executeAsync") == false)
{
rule.setExecuteAsynchronously(ruleJson.optBoolean("executeAsync", false));
}
if (ruleJson.isNull("ruleDisabled") == false)
{
rule.setRuleDisabled(ruleJson.optBoolean("ruleDisabled", false));
}
if (ruleJson.isNull("appliedToChildren") == false)
{
rule.applyToChildren(ruleJson.optBoolean("appliedToChildren", false));
}
//
// set rule types present in the rule details onto the rule
//
try
{
if ((ruleJson.isNull("ruleTypes") == true) && (update == false))
{
// the "ruleTypes" field is mandatory for rule creation. it is missing in the rule details
// from which we are creating a new rule, so throw an exception
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "A new rule is being created but the 'ruleTypes' "
+ "property, which is mandatory, has not been included in the rule details. The title of the "
+ "offending rule is '" + ruleJson.optString("title") + "'");
}
else if (ruleJson.isNull("ruleTypes") == false)
{
List<String> ruleTypes = new ArrayList<String>();
JSONArray ruleTypesJson = ruleJson.getJSONArray("ruleTypes");
int numRuleTypes = ruleTypesJson.length();
// make sure that at least one rule type has been sent in the rule details
if (numRuleTypes < 1)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "At least one rule type needs to be present in "
+ "in the rule details sent in the request content. The title of the "
+ "offending rule is '" + ruleJson.optString("title") + "'");
}
// add to the rule the rule type names sent in the rule details
for (int i=0; i < numRuleTypes; i++)
{
String ruleTypeNameJson = ruleTypesJson.getString(i);
if (isValidRuleTypeName(ruleTypeNameJson))
{
ruleTypes.add(ruleTypeNameJson);
}
else
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "An invalid rule type name was given in the "
+ "rule details sent in the request content. Invalid rule type name given is: '"
+ ruleTypeNameJson + "'. The title of the offending rule containing the invalid rule type "
+ "is '" + ruleJson.optString("title") + "'");
}
}
rule.setRuleTypes(ruleTypes);
}
}
catch (JSONException je)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "There was a problem reading the 'ruleTypes' "
+ "property in the received Rule JSON. It may not be a JSON Array or one of the rule types "
+ "therein may contain invalid characters. The title of the offending rule is '"
+ ruleJson.optString("title") + "'", je);
}
if ((ruleJson.isNull("action") == true) && (update == false))
{
// the "action" field is mandatory, it is missing in the rule details,
// and we are creating a new rule so throw an exception
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "A new rule is being created but the 'action' "
+ "field, which is mandatory, has not been included in the rule details. The title of the "
+ "offending rule is '" + ruleJson.optString("title") + "'");
}
else
{
// set the action supplied in the rule details onto the rule
JSONObject ruleActionJson;
try
{
ruleActionJson = ruleJson.getJSONObject("action");
}
catch (JSONException je)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "There was a problem reading the 'action' "
+ "property in the received rule JSON. It is mandatory and may be missing from the "
+ "rule JSON. The title of the offending rule is '" + ruleJson.optString("title") + "'", je);
}
// if we're doing an update then the rule should already have
// this action set on it, so get the action object already on
// the rule
Action ruleActionToUpdate = null;
if (update == true)
{
String ruleActionJsonId;
try
{
ruleActionJsonId = ruleActionJson.getString("id");
}
catch (JSONException je)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "There was a problem reading the 'id' "
+ "property in the rule's root action from the received rule JSON. It is mandatory when "
+ "updating a rule and may be missing from the received rule JSON. The title of the "
+ "offending rule is '" + ruleJson.optString("title") + "'", je);
}
ruleActionToUpdate = rule.getAction();
// throw a web script exception if the ID of the rule's action,
// already persisted to the repository, is not the same as the one
// given for the rule action's ID in the rule details that we
// wish to perform the rule update with
if (ruleActionToUpdate.getId().equals(ruleActionJsonId) == false)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "The ID sent in the rule details "
+ "of the action directly associated with the rule we wish to update does not match "
+ " the rule's action already persisted in the repository. The rule's nodeRef is: '"
+ ruleNodeRefToUpdate + "', the action ID provided in the rule details is '"
+ ruleActionJsonId + "', and the ID for the rule's action already persisted in the"
+ " repository is '" + ruleActionToUpdate.getId() + "'");
}
}
Action action = getActionFromJson(ruleActionJson, ruleActionToUpdate);
rule.setAction(action);
}
return rule;
}
/**
* Return an Action object created/updated from a given action JSON object (Action Details sent).
*
* If an action object is passed into the <pre>actionToUpdate</pre> parameter,
* then this indicates that this action is to be updated from the action details
* provided in the given JSON object and then returned.
* If a 'null' is passed into this parameter, then this indicates that a new action is to
* be created from scratch, populated with the action details provided in the given JSON object
* and then returned.
*
* @param actionJson the action JSON object used to create/update the action with
* @param actionToUpdate The action to be updated.
* Set to <pre>null</pre> if a new action is to be created from scratch.
*
* @return The action created/updated from the given action JSON object
*/
public Action getActionFromJson(JSONObject actionJson, Action actionToUpdate)
{
ActionService actionService = this.serviceRegistry.getActionService();
//
// if we are doing an update then set the action, to be returned, to
// the given actionToUpdate (which will then be updated by the action
// details provided in the action JSON - containing the action details sent)
//
Action action = null;
boolean updateAction = false;
// if an action has been given to update with fields present in the given action
// JSON object, then set that action to the current action, and set the updateAction
// indicator to true
if (actionToUpdate != null)
{
action = actionToUpdate;
updateAction = true;
}
//
// create an action object from an "action" JSON object
//
String actionDefinitionName;
try
{
actionDefinitionName = actionJson.getString("actionDefinitionName");
}
catch (JSONException je)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "There was a problem reading the "
+ "'actionDefinitionName' property from the the received action JSON. It is mandatory "
+ "and may be missing from the received action JSON. The 'title' of the offending action is '"
+ actionJson.optString("title") + "'", je);
}
JSONArray nestedActionsJson = actionJson.optJSONArray("actions");
// if action's definition name denotes that it is a composite action and the
// action JSON object has nested actions, then treat it as a composite action
if ((actionDefinitionName.equals(COMPOSITE_ACTION_DEF_NAME)) == true && (nestedActionsJson != null))
{
// if we are updating an action which is a composite action,
// but the action definition name in the action JSON is not 'composite-action'
// throw a web script exception
if ((updateAction == true) && ((action instanceof CompositeAction) == false))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "The action you wish to update "
+ "is not a composite action object, but the action definition name in the action JSON is "
+ "'composite-action'. Thus this action could not be updated with the action JSON sent");
}
// TODO remove this look-up map when the back-end provides an easy way to lookup actions
// on a composite action by ID
// if we are updating an existing composite action then create a map to easily look up the
// nested action objects for each nested action details provided in the action JSON object
Map<String, Action> nestedActionsMap = new HashMap<String, Action>();
if ((updateAction == true) && ((action instanceof CompositeAction) == true))
{
List<Action> nestedActions = ((CompositeAction)action).getActions();
for (Action nestedAction: nestedActions)
{
nestedActionsMap.put(nestedAction.getId(), nestedAction);
}
}
// else if we are not updating then create composite action object
// for scratch
else if (updateAction == false)
{
action = actionService.createCompositeAction();
}
// recursively add nested actions to this composite action
// as some of those nested actions could also be composite actions
int numNestedActionsJson = nestedActionsJson.length();
for (int i=0; i < numNestedActionsJson; i++)
{
JSONObject nestedActionJson = nestedActionsJson.optJSONObject(i);
if (nestedActionJson != null)
{
Action nestedAction = null;
// if we are doing an action update, then update the nested actions from
// the nested action JSON
if (updateAction == true)
{
String nestedActionJsonID;
try
{
nestedActionJsonID = nestedActionJson.getString("id");
}
catch (JSONException je)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "There was a problem reading the "
+ "'id' property from the received action JSON. It is mandatory when updating an action"
+ "and may be missing from the received action JSON. The 'title' of the offending action is '"
+ nestedActionJson.optString("title") + "'", je);
}
// lookup to see if nested action from nested action JSON
// already exists on composite action, in which case, update
// the nested action with the nested action details provided in the
// nested action JSON
Action nestedActionToUpdate = nestedActionsMap.get(nestedActionJsonID);
if (nestedActionToUpdate != null)
{
// first remove the nested action to be updated from the parent
// composite action
((CompositeAction)action).removeAction(nestedActionToUpdate);
// update that nested action with the details in the nested action JSON
nestedAction = getActionFromJson(nestedActionJson, nestedActionToUpdate);
}
}
// else we are not doing an action update so just pass in the
// actionToUpdate as 'null'
else
{
nestedAction = getActionFromJson(nestedActionJson, null);
}
// add the nested action (newly created or just updated) to
// the composite action
((CompositeAction)action).addAction(nestedAction);
}
}
}
// else if the action definition name denotes that this is not a composite action,
// but nested actions have been provided in the action JSON Object
// then throw a Web Script Exception
else if ((actionDefinitionName.equals(COMPOSITE_ACTION_DEF_NAME) == false) && (nestedActionsJson != null))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "Nested actions were sent in the action details "
+ "having Title: '" + actionJson.optString("title") + "', but the action definition "
+ "name thereof is not '" + COMPOSITE_ACTION_DEF_NAME + "' as expected. Instead, the action's "
+ "definition name is '" + actionDefinitionName + "'.");
}
// if we are not updating an existing action and there are no nested actions in the action JSON,
// just create a new action from the action definition without any recursive nested action handling
if ((updateAction == false) && (nestedActionsJson == null))
{
action = actionService.createAction(actionDefinitionName);
}
//
// set action properties
//
try
{
if ((actionJson.isNull("title") == true) && (updateAction == false))
{
// the "title" field is missing in the action details,
// and we are creating a new rule,
// but the "title" field is mandatory, so throw an exception
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "A new rule is being created but the 'title' "
+ "field, which is mandatory, has not been included in the rule details");
}
// otherwise go ahead and set the value if the field is present
// to cover both create and update scenarios
else if (actionJson.isNull("title") == false)
{
action.setTitle(actionJson.getString("title"));
}
}
catch (JSONException je)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "There was a problem reading the "
+ "'title' property from the received action JSON. It is mandatory and may be "
+ "missing from the received action JSON, or else it may contain invalid characters.", je);
}
if (actionJson.isNull("description") == false)
{
action.setDescription(actionJson.optString("description"));
}
// If a value has been provided in the action details for the "executeAsync" field
// then set it to the action object.
// If the value given for a field does not equate to either
// 'true' or 'false', then set it to a default value of false
if (actionJson.isNull("executeAsync") == false)
{
action.setExecuteAsynchronously(actionJson.optBoolean("executeAsync", false));
}
// set compensating action on current action if a compensating action is present
// in the action JSON Object
try
{
if (actionJson.isNull("compensatingAction") == false)
{
JSONObject compActionJson = actionJson.getJSONObject("compensatingAction");
Action compActionToUpdate = null;
if (updateAction)
{
compActionToUpdate = action.getCompensatingAction();
}
Action compAction = getActionFromJson(compActionJson, compActionToUpdate);
action.setCompensatingAction(compAction);
}
}
catch (JSONException je)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "There was a problem reading the "
+ "'compensatingAction' property from the received action JSON. The value of the property "
+ "may not be a JSON Object or something may be wrong with one of the properties in the JSON "
+ "Object for the compensating action itself. The 'title' of the offending action is '"
+ actionJson.optString("title") + "'", je);
}
// get the action's definition
ParameterizedItemDefinition actionDef = actionService.getActionDefinition(actionDefinitionName);
// if there are parameter values in the action JSON object then
// set them onto the action object
//
JSONObject actionParamValuesJson = actionJson.optJSONObject("parameterValues");
if (actionParamValuesJson != null)
{
setParameterValuesOnParameterizedItemFromJson(action, actionDef, actionParamValuesJson);
}
//
// set conditions on the current action
//
// if action JSON "conditions" property has a value
// then populate the current action's conditions with the
// conditions' details from within the action JSON
if (actionJson.isNull("conditions") == false)
{
JSONArray conditionsJson = actionJson.optJSONArray("conditions");
// if conditionsJson is 'null' then throw a web script exception, because this means that
// the conditions property does not contain a JSON Array. The conditions property of an incoming
// action JSON object should be a JSON Array
if (conditionsJson == null)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "The 'conditions' property of the incoming "
+ "action JSON titled '" + actionJson.optString("title") + "' is not a JSON Array");
}
// If we are updating an existing action, then build up a map
// (keyed by condition ID) of conditions associated with that existing action.
// So for each condition JSON object (inside the incoming action JSON object),
// if the condition ID thereof is found in the map, then update the existing condition
// with the details sent in the JSON
Map<String, ActionCondition> conditionsMap = new HashMap<String, ActionCondition>();
if (updateAction == true)
{
List<ActionCondition> actionConditions = action.getActionConditions();
for (ActionCondition actionCondition : actionConditions)
{
conditionsMap.put(actionCondition.getId(), actionCondition);
}
}
//
// for each condition JSON object (associated with the incoming action JSON object):
// - if we are doing an update then update the corresponding condition object (if one exists)
// with the fields provided in the condition JSON object
// - if we are doing a create then create a new condition from the details provided
// in the condition JSON
int numConditionsJson = conditionsJson.length();
for (int conditionJsonIndex = 0; conditionJsonIndex < numConditionsJson; conditionJsonIndex++)
{
ActionCondition condition = null;
JSONObject conditionJson;
try
{
conditionJson = conditionsJson.getJSONObject(conditionJsonIndex);
}
catch (JSONException je)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "There was a problem reading the "
+ "condition held at index " + conditionJsonIndex + " in the JSON Array held in the "
+ "'conditions' property from the received action JSON. The value held at that "
+ "index may not be a JSON Object. The 'title' of the action with the offending "
+ "'conditions' property is '" + actionJson.optString("title") + "'", je);
}
String conditionDefName = null;
// if we are doing an update, the current condition JSON has an ID,
// and a condition already exists matching that ID, then set the current
// condition to that existing condition and retrieve its definition name
if ((updateAction == true) && (conditionJson.isNull("id") == false))
{
String conditionJsonId;
try
{
conditionJsonId = conditionJson.getString("id");
}
catch (JSONException je)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "There was a problem reading the "
+ "'id' property from a condition in the received action JSON. When doing an update "
+ "this condition property is mandatory and may be missing from this condition in the "
+ "action JSON sent or else the property may contain invalid parameters. "
+ "The 'conditionDefinitionName' of the offending condition is '"
+ conditionJson.optString("conditionDefinitionName") + "'", je);
}
// set the current condition being processed to the existing conditions
condition = conditionsMap.get(conditionJsonId);
// get the condition definition name
if (condition != null)
{
conditionDefName = condition.getActionConditionDefinitionName();
}
// remove the condition to be updated from its parent action
// The updated condition is added to the action at the end of the
// loop
action.removeActionCondition(condition);
}
// if the current condition is still 'null' (we are not updating an existing condition),
// and if the conditionDefinitionName has not been provided in the condition JSON, then
// throw a web script exception because we need to create a new condition using the condition
// definition name provided in the condition JSON object
if ((condition == null) && (conditionJson.isNull("conditionDefinitionName")))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "A condition details at index: '"
+ conditionJsonIndex + "' for action ID '" + action.getId() + " could not be created "
+ "because the 'conditionDefinitionName' field is missing from the condition details sent");
}
// else condition def name has been provided in the condition details
if (condition == null)
{
try
{
conditionDefName = conditionJson.getString("conditionDefinitionName");
}
catch (JSONException je)
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "There was a problem reading the "
+ "'conditionDefinitionName' property from a condition in the received action JSON. "
+ "This condition property is mandatory and may be missing from this condition in the "
+ "action JSON sent. The 'conditionDefinitionName' of the offending condition is '"
+ conditionJson.optString("conditionDefinitionName") + "'", je);
}
condition = actionService.createActionCondition(conditionDefName);
}
// get the condition definition object
ParameterizedItemDefinition conditionDef = actionService.getActionConditionDefinition(conditionDefName);
//
// populate the condition (newly created, or one being updated)
// with fields given in the condition JSONs the condition's properties
//
// Set the value for the 'invertCondition' field if that field is sent
// in the condition JSON. If the value is sent, but it does not equate to
// either 'true' or 'false', then set it to a default value of false
if (conditionJson.isNull("invertCondition") == false)
{
condition.setInvertCondition(conditionJson.optBoolean("invertCondition"));
}
//
// if there are parameter values on the condition JSON object
// then apply them to the condition object
//
JSONObject condParamValuesJson = conditionJson.optJSONObject("parameterValues");
if (condParamValuesJson != null)
{
setParameterValuesOnParameterizedItemFromJson(condition, conditionDef, condParamValuesJson);
}
// add condition to action object
action.addActionCondition(condition);
}
}
return action;
}
/**
* Create and return a multi-valued parameter value from the given JSON object and
* parameter content type (QName)
*
* @param jsonObject The JSON object we want to convert to a multi-valued parameter value
* @param paramName The parameter name
* @param paramDataTypeDef The parameter's content type definition
* @return
*/
@SuppressWarnings("unchecked")
public Serializable getMultiValuedParameterValueFromJsonObject(JSONObject jsonObject, String paramName,
DataTypeDefinition paramDataTypeDef)
{
ArrayList multiParamValue = new ArrayList<Serializable>(jsonObject.length());
//
// convert each parameter item String value from the given JSON object to a value
// corresponding to the given parameter content type and add that converted value
// to the multi-parameter array list
//
Iterator<String> keysIterator = jsonObject.keys();
while (keysIterator.hasNext())
{
String key = keysIterator.next();
String paramValueItem = jsonObject.optString(key);
// if this keyed object from the given JSON object
// is present and can be represented as a String,
// then convert the string to the given parameter content
// type and add it to the multi-parameter array list
if (paramValueItem != null)
{
Object paramValueItemObj = DefaultTypeConverter.INSTANCE.convert(paramDataTypeDef, paramValueItem);
// if the parameter value object, converted using the parameter's data type, is of type Serializable
// then we can go ahead and add it as one of the parameter's values
if (paramValueItemObj instanceof Serializable)
{
multiParamValue.add(paramValueItemObj);
}
else
// otherwise the converted parameter value can't be added
{
throw new WebScriptException(Status.STATUS_INTERNAL_SERVER_ERROR,
"Whilst building up the multi-valued parameter with name: '"
+ paramName + "' and type: '" + paramDataTypeDef.getName() + "' an object was encountered "
+ "that doesn't implement Serializable. Object value is: '" + paramValueItemObj
+ "' and is of class name '" + paramValueItemObj.getClass().getName() +"'");
}
}
}
return multiParamValue;
}
/**
* Sets the parameter values from the given parameter values JSON object onto the given parameterized item object
*
* @param parameterizedItem The parameterized item object onto which we want to set the parameter values from
* the given parameter values JSON object
* @param parameterizedItemDef The definition for the given parameterized item
* @param paramValuesJson The JSON object containing the parameter values to set into the parameterized item object
*/
@SuppressWarnings("unchecked")
public void setParameterValuesOnParameterizedItemFromJson(ParameterizedItem parameterizedItem,
ParameterizedItemDefinition parameterizedItemDef, JSONObject paramValuesJson)
{
// get a reference to the dictionary service
DictionaryService dictionaryService = this.serviceRegistry.getDictionaryService();
Iterator<String> paramIterator = paramValuesJson.keys();
while (paramIterator.hasNext())
{
String paramName = paramIterator.next();
ParameterDefinition paramDef = parameterizedItemDef.getParameterDefintion(paramName);
QName paramType = paramDef.getType();
DataTypeDefinition paramDataTypeDef = dictionaryService.getDataType(paramType);
boolean isMultiValued = paramDef.isMultiValued();
boolean isMandatory = paramDef.isMandatory();
// throw web script exception if mandatory parameter value not provided
if (paramValuesJson.isNull(paramName) && (isMandatory == true))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "Mandatory parameter with name: '"
+ paramName + "' expected in sent content, but it was not present. Parameter belongs to "
+ "parameterized item with ID: '" + parameterizedItem.getId() + "' and definition name: '"
+ parameterizedItemDef.getName() + "'");
}
// else if a parameter value has been provided then handle this case
else if (paramValuesJson.isNull(paramName) == false)
{
// Try and get the parameter value as a JSON object (multi-valued parameter value).
JSONObject paramValueJsonObj = paramValuesJson.optJSONObject(paramName);
// throw web script exception if parameter value is not a JSONObject (optJSONObject() returned 'null')
// and parameter's definition says that it should be multi-valued
if ((paramValueJsonObj == null) && (isMultiValued == true))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "Multi-valued parameter with name: '"
+ paramName + "' expected in sent content, but value provided was not multi-valued."
+ "Parameter value given is: " + paramValuesJson.opt(paramName) + ". "
+ "Parameter belongs to parameterized item with ID: '" + parameterizedItem.getId()
+ "' and definition name: '" + parameterizedItemDef.getName() + "'");
}
// else throw web script exception if value given is a JSON object
// (optJSONObject(paramName) didn't return 'null'), but parameter's definition says that it shouldn't
// be multi-valued
else if ((paramValueJsonObj != null) && (isMultiValued == false))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "Multi-valued parameter with name: '"
+ paramName + "' was sent in content, but parameter's definition says that it should not "
+ "be multi-valued. Parameter value given is: " + paramValuesJson.opt(paramName) + ". "
+ "Parameter belongs to parameterized item with ID: '" + parameterizedItem.getId()
+ "' and definition name: '" + parameterizedItemDef.getName() + "'");
}
// else if value given is a JSON object (optJSONObject(paramName) didn't return 'null'),
// and the parameter's definition says that it should be multi-valued
// then go ahead and add the multi-valued parameter value to the parameterized item
else if ((paramValueJsonObj != null) && (isMultiValued == true))
{
Serializable multiParamValue = getMultiValuedParameterValueFromJsonObject(paramValueJsonObj,
paramName, paramDataTypeDef);
parameterizedItem.setParameterValue(paramName, multiParamValue);
}
// else if parameter value provided is not a JSON Object (optJSONObject(paramName) returned 'null')
// and the parameter's definition says that the parameter value should not be multi-valued, try and
// retrieve the parameter value as a String instead
else if ((paramValueJsonObj == null) && (isMultiValued == false))
{
String paramValueStr = paramValuesJson.optString(paramName);
// if parameter value can be retrieved as a String, then add that String parameter
// value to the parameterized item
if (paramValueStr != null)
{
Object paramValueObj = DefaultTypeConverter.INSTANCE.convert(paramDataTypeDef, paramValueStr);
if (paramValueObj instanceof Serializable)
{
parameterizedItem.setParameterValue(paramName, (Serializable)paramValueObj);
}
else
{
throw new WebScriptException(Status.STATUS_INTERNAL_SERVER_ERROR,
"Whilst adding parameters to a parameterized item (action or condition) "
+ "with ID '" + parameterizedItem.getId() + "' the parameter with name: '"
+ paramName + "' and type: '" + paramType + "' has a value that doesn't "
+ "implement Serializable. Object value is: '" + paramValueObj
+ "' and is of class name '" + paramValueObj.getClass().getName() +"'");
}
}
// else parameter value could not be retrieved as a String value (optString(paramName) returned 'null')
// so give up with trying to process it and throw a web script exception
else
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "Parameter with name: '"
+ paramName + "' was sent in the request content, but it could not be retrieved and "
+ "added to the parameterized item. Parameter value given is: " + paramValuesJson.opt(paramName) + ". "
+ "Parameter belongs to parameterized item with ID: '" + parameterizedItem.getId()
+ "' and definition name: '" + parameterizedItemDef.getName() + "'");
}
}
}
}
}
/**
* Return a node reference to the node represented on a Web Script URL
* by the given store type, store id and id (which is either a node id or node path)
*
* @param request The Web Script request object
* @param storeType The store type associated with the node
* @param storeId The store id associated with the node
* @param id The id (or path) associated with the node
*
* @return The node reference associated with the given store type, store id and id
*/
NodeRef getNodeRefFromWebScriptUrl(WebScriptRequest req, String storeType, String storeId, String id)
{
// work out which of storeType, storeId, id have been passed in
boolean storeTypeGiven = (storeType != null) && (storeType.length() > 0);
boolean storeIdGiven = (storeId != null) && (storeId.length() > 0);
boolean idGiven = (id != null) && (id.length() > 0);
NodeRef nodeRef = null;
// get the node reference from the storeType, storeId, id
if ((storeTypeGiven && storeIdGiven && idGiven))
{
// see if given ID is part of either a node reference or a node path
String urlTemplateMatch = req.getServiceMatch().getPath();
boolean nodeRefGiven = urlTemplateMatch.startsWith(REQ_URL_PART_NODE_REF) ||
urlTemplateMatch.startsWith(REQ_URL_PART_RULE_NODE_REF);
boolean nodePathGiven = urlTemplateMatch.startsWith(REQ_URL_PART_NODE_PATH);
String referenceType = null;
if (nodeRefGiven)
{
referenceType = "node";
}
else if (nodePathGiven)
{
referenceType = "path";
}
else
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"{store_type}/{store_id}/{id} in URL is not preceded by either "
+ "'" + REQ_URL_PART_NODE_REF + "' or '" + REQ_URL_PART_NODE_PATH + "'");
}
String[] reference = new String[3];
reference[0] = storeType;
reference[1] = storeId;
reference[2] = id;
nodeRef = this.repositoryContext.findNodeRef(referenceType, reference);
}
return nodeRef;
}
}

145
source/java/org/alfresco/repo/web/scripts/rule/RulesPost.java
View File

@@ -1,145 +0,0 @@
/*
* 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 received a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.web.scripts.rule;
import java.util.HashMap;
import java.util.Map;
import org.alfresco.service.cmr.repository.NodeRef;
import org.alfresco.service.cmr.rule.Rule;
import org.alfresco.service.cmr.rule.RuleService;
import org.springframework.extensions.webscripts.DeclarativeWebScript;
import org.springframework.extensions.webscripts.Status;
import org.springframework.extensions.webscripts.WebScriptException;
import org.springframework.extensions.webscripts.WebScriptRequest;
import org.json.JSONObject;
/**
* Web Script to POST a Rule to the rule collection associated with the given actionable node.
*
* @author glen johnson at alfresco dot com
*/
public class RulesPost extends DeclarativeWebScript
{
// private constants
private static final String URL_TEMPL_VAR_STORE_TYPE = "store_type";
private static final String URL_TEMPL_VAR_STORE_ID = "store_id";
private static final String URL_TEMPL_VAR_ID = "id";
// model property keys
private static final String MODEL_PROP_KEY_RULE = "rule";
private static final String MODEL_PROP_KEY_OWNING_NODE_REF = "owningNodeRef";
// properties for services
private RuleService ruleService;
// properties for dependencies
private RulesHelper rulesHelper;
/**
* Set the ruleService property.
*
* @param ruleService The rule service instance to set
*/
public void setRuleService(RuleService ruleService)
{
this.ruleService = ruleService;
}
/**
* Set the rules helper property
*
* @param rulesHelper the rulesHelper to set
*/
public void setRulesHelper(RulesHelper rulesHelper)
{
this.rulesHelper = rulesHelper;
}
/*
* (non-Javadoc)
*
* @see org.alfresco.web.scripts.DeclarativeWebScript#executeImpl(
* org.alfresco.web.scripts.WebScriptRequest,
* org.alfresco.web.scripts.WebScriptResponse)
*/
@SuppressWarnings("unchecked")
@Override
protected Map<String, Object> executeImpl(WebScriptRequest req,
Status status)
{
// initialise model to pass on for template to render
Map<String, Object> model = new HashMap<String, Object>();
String storeType = req.getServiceMatch().getTemplateVars().get(URL_TEMPL_VAR_STORE_TYPE);
// Handle if 'store_type' URL template token not provided
if ((storeType == null) || (storeType.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'store_type' URL template token has not been provided in URL");
}
String storeId = req.getServiceMatch().getTemplateVars().get(URL_TEMPL_VAR_STORE_ID);
// Handle if 'storeId' URL template token not provided
if ((storeId == null) || (storeId.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'storeId' URL template token has not been provided in URL");
}
String id = req.getServiceMatch().getTemplateVars().get(URL_TEMPL_VAR_ID);
// Handle if 'id' URL template token not provided
if ((id == null) || (id.length() == 0))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST,
"The 'id' URL template token has not been provided in URL");
}
// get the posted rule JSON object by parsing request content
Object contentObj = req.parseContent();
if (contentObj == null || !(contentObj instanceof JSONObject))
{
throw new WebScriptException(Status.STATUS_BAD_REQUEST, "Web Script request content must be a JSON Object. "
+ "Request content is either a JSON Array or not of MIME-type application/json");
}
JSONObject ruleJson = (JSONObject)contentObj;
// get the rule from the rule JSON object
Rule rule = this.rulesHelper.getRuleFromJson(ruleJson, null);
// create the actionable node reference from the given
// URL template tokens
NodeRef owningNodeRef = this.rulesHelper.getNodeRefFromWebScriptUrl(req, storeType, storeId, id);
// apply rule to rule owning node
this.ruleService.saveRule(owningNodeRef, rule);
// add objects to model for the template to render
model.put(MODEL_PROP_KEY_RULE, rule);
model.put(MODEL_PROP_KEY_OWNING_NODE_REF, owningNodeRef.toString());
return model;
}
}