1 package org.collectionspace.services.IntegrationTests.xmlreplay;
3 import org.apache.commons.cli.*;
5 import org.apache.commons.io.FileUtils;
6 import org.apache.commons.jexl2.JexlEngine;
7 import org.collectionspace.services.common.api.Tools;
9 import org.dom4j.io.SAXReader;
14 /** This class is used to replay a request to the Services layer, by sending the XML payload
15 * in an appropriate Multipart request.
16 * See example usage in calling class XmlReplayTest in services/IntegrationTests, and also in main() in this class.
17 * @author Laramie Crocker
19 @SuppressWarnings("unchecked")
20 public class XmlReplay {
22 public XmlReplay(String basedir, String reportsDir){
23 this.basedir = basedir;
24 this.serviceResultsMap = createResultsMap();
25 this.reportsList = new ArrayList<String>();
26 this.reportsDir = reportsDir;
29 public static final String DEFAULT_CONTROL = "xml-replay-control.xml";
30 public static final String DEFAULT_MASTER_CONTROL = "xml-replay-master.xml";
31 public static final String DEFAULT_DEV_MASTER_CONTROL = "dev-master.xml";
32 private static final int MAX_REATTEMPTS = 10;
33 private static final String REATTEMPT_KEY = "REATTEMPT_KEY";
35 private String reportsDir = "";
36 public String getReportsDir(){
39 private String basedir = "."; //set from constructor.
40 public String getBaseDir(){
44 private String controlFileName = DEFAULT_CONTROL;
45 public String getControlFileName() {
46 return controlFileName;
48 public void setControlFileName(String controlFileName) {
49 this.controlFileName = controlFileName;
52 private String protoHostPort = "";
53 public String getProtoHostPort() {
56 public void setProtoHostPort(String protoHostPort) {
57 this.protoHostPort = protoHostPort;
60 private boolean autoDeletePOSTS = true;
61 public boolean isAutoDeletePOSTS() {
62 return autoDeletePOSTS;
64 public void setAutoDeletePOSTS(boolean autoDeletePOSTS) {
65 this.autoDeletePOSTS = autoDeletePOSTS;
69 public Dump getDump() {
72 public void setDump(Dump dump) {
76 AuthsMap defaultAuthsMap;
77 public AuthsMap getDefaultAuthsMap(){
78 return defaultAuthsMap;
80 public void setDefaultAuthsMap(AuthsMap authsMap){
81 defaultAuthsMap = authsMap;
84 private Map<String, ServiceResult> serviceResultsMap;
85 public Map<String, ServiceResult> getServiceResultsMap(){
86 return serviceResultsMap;
88 public static Map<String, ServiceResult> createResultsMap(){
89 return new HashMap<String, ServiceResult>();
92 private List<String> reportsList;
93 public List<String> getReportsList(){
98 public String toString(){
99 return "XmlReplay{"+this.basedir+", "+this.defaultAuthsMap+", "+this.dump+", "+this.reportsDir+'}';
102 // ============== METHODS ===========================================================
104 /** Optional information method: call this method after instantiating this class using the constructor XmlReplay(String), which sets the basedir. Then you
105 * pass in your relative masterFilename to that basedir to this method, which will return true if the file is readable, valid xml, etc.
106 * Do this in preference to just seeing if File.exists(), because there are rules to finding the file relative to the maven test dir, yada, yada.
107 * This method makes it easy to have a development test file that you don't check in, so that dev tests can be missing gracefully, etc.
109 public boolean masterConfigFileExists(String masterFilename){
111 org.dom4j.Document doc = openMasterConfigFile(masterFilename);
116 } catch (Throwable t){
121 public org.dom4j.Document openMasterConfigFile(String masterFilename) throws FileNotFoundException {
122 String fullPath = Tools.glue(basedir, "/", masterFilename);
123 File f = new File(fullPath);
127 org.dom4j.Document document = getDocument(fullPath); //will check full path first, then checks relative to PWD.
128 if (document == null){
129 throw new FileNotFoundException("XmlReplay master control file ("+masterFilename+") not found in basedir: "+basedir+". Exiting test.");
134 /** specify the master config file, relative to getBaseDir(), but ignore any tests or testGroups in the master.
135 * @return a Document object, which you don't need to use: all options will be stored in XmlReplay instance.
137 public org.dom4j.Document readOptionsFromMasterConfigFile(String masterFilename) throws FileNotFoundException {
138 org.dom4j.Document document = openMasterConfigFile(masterFilename);
139 if (document == null){
140 throw new FileNotFoundException(masterFilename);
142 protoHostPort = document.selectSingleNode("/xmlReplayMaster/protoHostPort").getText().trim();
143 AuthsMap authsMap = readAuths(document);
144 setDefaultAuthsMap(authsMap);
145 Dump dump = XmlReplay.readDumpOptions(document);
150 public List<List<ServiceResult>> runMaster(String masterFilename) throws Exception {
151 return runMaster(masterFilename, true);
154 /** Creates new instances of XmlReplay, one for each controlFile specified in the master,
155 * and setting defaults from this instance, but not sharing ServiceResult objects or maps. */
156 public List<List<ServiceResult>> runMaster(String masterFilename, boolean readOptionsFromMaster) throws Exception {
157 List<List<ServiceResult>> list = new ArrayList<List<ServiceResult>>();
158 org.dom4j.Document document;
159 if (readOptionsFromMaster){
160 document = readOptionsFromMasterConfigFile(masterFilename);
162 document = openMasterConfigFile(masterFilename);
165 throw new FileNotFoundException(masterFilename);
167 String controlFile, testGroup, test;
169 runNodes = document.selectNodes("/xmlReplayMaster/run");
170 for (Node runNode : runNodes) {
171 controlFile = runNode.valueOf("@controlFile");
172 testGroup = runNode.valueOf("@testGroup");
173 test = runNode.valueOf("@test"); //may be empty
175 //Create a new instance and clone only config values, not any results maps.
176 XmlReplay replay = new XmlReplay(basedir, this.reportsDir);
177 replay.setControlFileName(controlFile);
178 replay.setProtoHostPort(protoHostPort);
179 replay.setAutoDeletePOSTS(isAutoDeletePOSTS());
180 replay.setDump(dump);
181 replay.setDefaultAuthsMap(getDefaultAuthsMap());
183 //Now run *that* instance.
184 List<ServiceResult> results = replay.runTests(testGroup, test);
186 this.reportsList.addAll(replay.getReportsList()); //Add all the reports from the inner replay, to our master replay's reportsList, to generate the index.html file.
188 XmlReplayReport.saveIndexForMaster(basedir, reportsDir, masterFilename, this.reportsList);
192 /** Use this if you wish to run named tests within a testGroup, otherwise call runTestGroup(). */
193 public List<ServiceResult> runTests(String testGroupID, String testID) throws Exception {
194 List<ServiceResult> result = runXmlReplayFile(this.basedir,
195 this.controlFileName,
198 this.serviceResultsMap,
199 this.autoDeletePOSTS,
202 this.defaultAuthsMap,
208 /** Use this if you wish to specify just ONE test to run within a testGroup, otherwise call runTestGroup(). */
209 public ServiceResult runTest(String testGroupID, String testID) throws Exception {
210 List<ServiceResult> result = runXmlReplayFile(this.basedir,
211 this.controlFileName,
214 this.serviceResultsMap,
215 this.autoDeletePOSTS,
218 this.defaultAuthsMap,
221 if (result.size()>1){
222 throw new IndexOutOfBoundsException("Multiple ("+result.size()+") tests with ID='"+testID+"' were found within test group '"+testGroupID+"', but there should only be one test per ID attribute.");
224 return result.get(0);
227 /** Use this if you wish to run all tests within a testGroup.*/
228 public List<ServiceResult> runTestGroup(String testGroupID) throws Exception {
229 //NOTE: calling runTest with empty testID runs all tests in a test group, but don't expose this fact.
230 // Expose this method (runTestGroup) instead.
231 return runTests(testGroupID, "");
234 public List<ServiceResult> autoDelete(String logName){
235 return autoDelete(this.defaultAuthsMap, this.serviceResultsMap, logName, 0);
238 /** Use this method to clean up resources created on the server that returned CSIDs, if you have
239 * specified autoDeletePOSTS==false, which means you are managing the cleanup yourself.
240 * @param serviceResultsMap a Map of ServiceResult objects, which will contain ServiceResult.deleteURL.
241 * @return a List<String> of debug info about which URLs could not be deleted.
243 private static List<ServiceResult> autoDelete(AuthsMap defaultAuths, Map<String, ServiceResult> serviceResultsMap, String logName, int reattempt) {
244 List<ServiceResult> results = new ArrayList<ServiceResult>();
245 HashMap<String, ServiceResult> reattemptList = new HashMap<String, ServiceResult>();
246 int deleteFailures = 0;
247 for (ServiceResult pr : serviceResultsMap.values()) {
249 if (pr.autoDelete == true && Tools.notEmpty(pr.deleteURL)){
250 ServiceResult deleteResult = XmlReplayTransport.doDELETE(pr.deleteURL, defaultAuths.getDefaultAuth(), pr.testID, "[autodelete:"+logName+"]");
251 if (deleteResult.gotExpectedResult() == false || deleteResult.responseCode != 200) {
252 reattemptList.put(REATTEMPT_KEY + deleteFailures++, pr); // We need to try again after our dependents have been deleted. cow()
254 results.add(deleteResult);
256 ServiceResult errorResult = new ServiceResult();
257 errorResult.fullURL = pr.fullURL;
258 errorResult.testGroupID = pr.testGroupID;
259 errorResult.fromTestID = pr.fromTestID;
260 errorResult.overrideGotExpectedResult();
261 results.add(errorResult);
263 } catch (Throwable t){
264 String s = (pr!=null) ? "ERROR while cleaning up ServiceResult map: "+pr+" for "+pr.deleteURL+" :: "+t
265 : "ERROR while cleaning up ServiceResult map (null ServiceResult): "+t;
266 System.err.println(s);
267 ServiceResult errorResult = new ServiceResult();
268 errorResult.fullURL = pr.fullURL;
269 errorResult.testGroupID = pr.testGroupID;
270 errorResult.fromTestID = pr.fromTestID;
271 errorResult.error = s;
272 results.add(errorResult);
276 // If there were things we had trouble deleting, it might have been because they had dependents that
277 // needed to be deleted first. Therefore, we're going to try again and again (recursively) up until we reach
278 // our MAX_REATTEMPTS limit.
280 if (reattemptList.size() > 0 && reattempt < MAX_REATTEMPTS) {
281 return autoDelete(defaultAuths, reattemptList, logName, ++reattempt); // recursive call
287 public static class AuthsMap {
288 Map<String,String> map;
290 public String getDefaultAuth(){
291 return map.get(defaultID);
294 public String toString(){
295 return "AuthsMap: {default='"+defaultID+"'; "+map.keySet()+'}';
299 public static AuthsMap readAuths(org.dom4j.Document document){
300 Map<String, String> map = new HashMap<String, String>();
301 List<Node> authNodes = document.selectNodes("//auths/auth");
302 for (Node auth : authNodes) {
303 map.put(auth.valueOf("@ID"), auth.getStringValue());
305 AuthsMap authsMap = new AuthsMap();
306 Node auths = document.selectSingleNode("//auths");
307 String defaultID = "";
309 defaultID = auths.valueOf("@default");
312 authsMap.defaultID = defaultID;
316 public static class Dump {
317 public boolean payloads = false;
318 //public static final ServiceResult.DUMP_OPTIONS dumpServiceResultOptions = ServiceResult.DUMP_OPTIONS;
319 public ServiceResult.DUMP_OPTIONS dumpServiceResult = ServiceResult.DUMP_OPTIONS.minimal;
321 public String toString(){
322 return "payloads: "+payloads+" dumpServiceResult: "+dumpServiceResult;
326 public static Dump getDumpConfig(){
330 public static Dump readDumpOptions(org.dom4j.Document document){
331 Dump dump = getDumpConfig();
332 Node dumpNode = document.selectSingleNode("//dump");
333 if (dumpNode != null){
334 dump.payloads = Tools.isTrue(dumpNode.valueOf("@payloads"));
335 String dumpServiceResultStr = dumpNode.valueOf("@dumpServiceResult");
336 if (Tools.notEmpty(dumpServiceResultStr)){
337 dump.dumpServiceResult = ServiceResult.DUMP_OPTIONS.valueOf(dumpServiceResultStr);
343 private static class PartsStruct {
344 public List<Map<String,String>> varsList = new ArrayList<Map<String,String>>();
345 String responseFilename = "";
346 String overrideTestID = "";
347 String startElement = "";
350 public static PartsStruct readParts(Node testNode, final String testID, String xmlReplayBaseDir){
351 PartsStruct resultPartsStruct = new PartsStruct();
352 resultPartsStruct.responseFilename = testNode.valueOf("filename");
353 resultPartsStruct.startElement = testNode.valueOf("startElement");
354 resultPartsStruct.label = testNode.valueOf("label");
355 String responseFilename = testNode.valueOf("filename");
356 if (Tools.notEmpty(responseFilename)){
357 resultPartsStruct.responseFilename = xmlReplayBaseDir + '/' + responseFilename;
358 List<Node> varNodes = testNode.selectNodes("vars/var");
359 readVars(testNode, varNodes, resultPartsStruct);
361 return resultPartsStruct;
364 private static void readVars(Node testNode, List<Node> varNodes, PartsStruct resultPartsStruct){
365 Map<String,String> vars = new HashMap<String,String>();
366 resultPartsStruct.varsList.add(vars);
367 //System.out.println("### vars: "+vars.size()+" ########");
368 for (Node var: varNodes){
369 String ID = var.valueOf("@ID");
370 String value = var.getText();
371 //System.out.println("ID: "+ID+" value: "+value);
372 vars.put(ID, value); //vars is already part of resultPartsStruct.varsList
374 //System.out.println("### end-vars ########");
380 private static String fixupFullURL(String fullURL, String protoHostPort, String uri){
381 if ( ! uri.startsWith(protoHostPort)){
382 fullURL = Tools.glue(protoHostPort, "/", uri);
389 private static String fromTestID(String fullURL, Node testNode, Map<String, ServiceResult> serviceResultsMap){
390 String fromTestID = testNode.valueOf("fromTestID");
391 if (Tools.notEmpty(fromTestID)){
392 ServiceResult getPR = serviceResultsMap.get(fromTestID);
394 fullURL = Tools.glue(fullURL, "/", getPR.location);
400 private static String CSIDfromTestID(Node testNode, Map<String, ServiceResult> serviceResultsMap){
402 String fromTestID = testNode.valueOf("fromTestID");
403 if (Tools.notEmpty(fromTestID)){
404 ServiceResult getPR = serviceResultsMap.get(fromTestID);
406 result = getPR.location;
412 public static org.dom4j.Document getDocument(String xmlFileName) {
413 org.dom4j.Document document = null;
414 SAXReader reader = new SAXReader();
416 document = reader.read(xmlFileName);
417 } catch (DocumentException e) {
418 System.out.println("ERROR reading document: "+e);
419 //e.printStackTrace();
424 protected static String validateResponseSinglePayload(ServiceResult serviceResult,
425 Map<String, ServiceResult> serviceResultsMap,
426 PartsStruct expectedResponseParts,
427 XmlReplayEval evalStruct)
430 byte[] b = FileUtils.readFileToByteArray(new File(expectedResponseParts.responseFilename));
431 String expectedPartContent = new String(b);
432 Map<String,String> vars = expectedResponseParts.varsList.get(0); //just one part, so just one varsList. Must be there, even if empty.
433 expectedPartContent = XmlReplayEval.eval(expectedPartContent, serviceResultsMap, vars, evalStruct.jexl, evalStruct.jc);
434 serviceResult.expectedContentExpanded = expectedPartContent;
435 String label = "NOLABEL";
436 String leftID = "{from expected part, label:"+label+" filename: "+expectedResponseParts.responseFilename+"}";
437 String rightID = "{from server, label:"+label
438 +" fromTestID: "+serviceResult.fromTestID
439 +" URL: "+serviceResult.fullURL
441 String startElement = expectedResponseParts.startElement;
442 String partLabel = expectedResponseParts.label;
443 if (Tools.isBlank(startElement)){
444 if (Tools.notBlank(partLabel))
445 startElement = "/document/*[local-name()='"+partLabel+"']";
447 TreeWalkResults.MatchSpec matchSpec = TreeWalkResults.MatchSpec.createDefault();
448 TreeWalkResults list =
449 XmlCompareJdom.compareParts(expectedPartContent,
451 serviceResult.result,
455 serviceResult.addPartSummary(label, list);
459 protected static String validateResponse(ServiceResult serviceResult,
460 Map<String, ServiceResult> serviceResultsMap,
461 PartsStruct expectedResponseParts,
462 XmlReplayEval evalStruct){
464 if (expectedResponseParts == null) return OK;
465 if (serviceResult == null) return OK;
466 if (serviceResult.result.length() == 0) return OK;
468 return validateResponseSinglePayload(serviceResult, serviceResultsMap, expectedResponseParts, evalStruct);
469 } catch (Exception e){
470 String err = "ERROR in XmlReplay.validateResponse() : "+e;
475 //================= runXmlReplayFile ======================================================
477 public static List<ServiceResult> runXmlReplayFile(String xmlReplayBaseDir,
478 String controlFileName,
481 Map<String, ServiceResult> serviceResultsMap,
482 boolean param_autoDeletePOSTS,
484 String protoHostPortParam,
485 AuthsMap defaultAuths,
486 List<String> reportsList,
489 //Internally, we maintain two collections of ServiceResult:
490 // the first is the return value of this method.
491 // the second is the serviceResultsMap, which is used for keeping track of CSIDs created by POSTs, for later reference by DELETE, etc.
492 List<ServiceResult> results = new ArrayList<ServiceResult>();
494 XmlReplayReport report = new XmlReplayReport(reportsDir);
496 String controlFile = Tools.glue(xmlReplayBaseDir, "/", controlFileName);
497 org.dom4j.Document document;
498 document = getDocument(controlFile); //will check full path first, then checks relative to PWD.
500 throw new FileNotFoundException("XmlReplay control file ("+controlFileName+") not found in basedir: "+xmlReplayBaseDir+" Exiting test.");
502 String protoHostPort;
503 if (Tools.isEmpty(protoHostPortParam)){
504 protoHostPort = document.selectSingleNode("/xmlReplay/protoHostPort").getText().trim();
505 System.out.println("DEPRECATED: Using protoHostPort ('"+protoHostPort+"') from xmlReplay file ('"+controlFile+"'), not master.");
507 protoHostPort = protoHostPortParam;
509 if (Tools.isEmpty(protoHostPort)){
510 throw new Exception("XmlReplay control file must have a protoHostPort element");
514 AuthsMap authsMap = readAuths(document);
515 if (authsMap.map.size()==0){
516 authsMap = defaultAuths;
517 authsMapINFO = "Using defaultAuths from master file: "+defaultAuths;
519 authsMapINFO = "Using AuthsMap from control file: "+authsMap;
522 report.addTestGroup(testGroupID, controlFileName); //controlFileName is just the short name, without the full path.
523 String xmlReplayHeader = "========================================================================"
524 +"\r\nXmlReplay running:"
525 +"\r\n controlFile: "+ (new File(controlFile).getCanonicalPath())
526 +"\r\n protoHostPort: "+protoHostPort
527 +"\r\n testGroup: "+testGroupID
528 + (Tools.notEmpty(oneTestID) ? "\r\n oneTestID: "+oneTestID : "")
529 +"\r\n AuthsMap: "+authsMapINFO
530 +"\r\n param_autoDeletePOSTS: "+param_autoDeletePOSTS
531 +"\r\n Dump info: "+dump
532 +"\r\n========================================================================"
534 report.addRunInfo(xmlReplayHeader);
536 System.out.println(xmlReplayHeader);
538 String autoDeletePOSTS = "";
539 List<Node> testgroupNodes;
540 if (Tools.notEmpty(testGroupID)){
541 testgroupNodes = document.selectNodes("//testGroup[@ID='"+testGroupID+"']");
543 testgroupNodes = document.selectNodes("//testGroup");
546 JexlEngine jexl = new JexlEngine(); // Used for expression language expansion from uri field.
547 XmlReplayEval evalStruct = new XmlReplayEval();
548 evalStruct.serviceResultsMap = serviceResultsMap;
549 evalStruct.jexl = jexl;
551 for (Node testgroup : testgroupNodes) {
553 XmlReplayEval.MapContextWKeys jc = new XmlReplayEval.MapContextWKeys();//MapContext(); //Get a new JexlContext for each test group.
556 autoDeletePOSTS = testgroup.valueOf("@autoDeletePOSTS");
558 if (Tools.notEmpty(oneTestID)){
559 tests = testgroup.selectNodes("test[@ID='"+oneTestID+"']");
561 tests = testgroup.selectNodes("test");
563 String authForTest = ""; // reset auth for each test group
564 int testElementIndex = -1;
566 for (Node testNode : tests) {
567 long startTime = System.currentTimeMillis();
570 String testID = testNode.valueOf("@ID");
572 // Figure out if we will auto delete resources
573 boolean autoDelete = param_autoDeletePOSTS;
574 String autoDeleteValue = testNode.valueOf("@autoDeletePOSTS");
575 if (autoDeleteValue != null && !autoDeleteValue.trim().isEmpty()) {
576 autoDelete = Boolean.valueOf(autoDeleteValue).booleanValue();
579 String testIDLabel = Tools.notEmpty(testID) ? (testGroupID+'.'+testID) : (testGroupID+'.'+testElementIndex);
580 String method = testNode.valueOf("method");
581 String contentType = testNode.valueOf("contentType");
582 String uri = testNode.valueOf("uri");
583 String fullURL = Tools.glue(protoHostPort, "/", uri);
585 if (contentType == null || contentType.equals("")) {
586 contentType = XmlReplayTransport.APPLICATION_XML;
589 String currentAuthForTest = null;
590 String authIDForTest = testNode.valueOf("@auth");
592 if (Tools.notEmpty(authIDForTest)){
593 currentAuthForTest = authsMap.map.get(authIDForTest);
595 String tokenAuthExpression = testNode.valueOf("@tokenauth");
596 if (Tools.notEmpty(tokenAuthExpression)){
597 currentAuthForTest = "Bearer " + XmlReplayEval.eval(tokenAuthExpression, serviceResultsMap, null, jexl, jc);
601 if (Tools.notEmpty(currentAuthForTest)){
602 authForTest = currentAuthForTest; //else just run with current from last loop;
604 if (Tools.isEmpty(authForTest)){
605 authForTest = defaultAuths.getDefaultAuth();
608 if (uri.indexOf("$")>-1){
609 uri = XmlReplayEval.eval(uri, serviceResultsMap, null, jexl, jc);
611 fullURL = fixupFullURL(fullURL, protoHostPort, uri);
613 List<Integer> expectedCodes = new ArrayList<Integer>();
614 String expectedCodesStr = testNode.valueOf("expectedCodes");
615 if (Tools.notEmpty(expectedCodesStr)){
616 String[] codesArray = expectedCodesStr.split(",");
617 for (String code : codesArray){
618 expectedCodes.add(new Integer(code.trim()));
622 Node responseNode = testNode.selectSingleNode("response");
623 PartsStruct expectedResponseParts = null;
624 if (responseNode!=null){
625 expectedResponseParts = PartsStruct.readParts(responseNode, testID, xmlReplayBaseDir);
626 //System.out.println("reponse parts: >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>"+expectedResponseParts);
629 ServiceResult serviceResult;
630 boolean isPOST = method.equalsIgnoreCase("POST");
631 boolean isPUT = method.equalsIgnoreCase("PUT");
632 if ( isPOST || isPUT ) {
633 PartsStruct parts = PartsStruct.readParts(testNode, testID, xmlReplayBaseDir);
634 if (Tools.notEmpty(parts.overrideTestID)) {
635 testID = parts.overrideTestID;
638 String csid = CSIDfromTestID(testNode, serviceResultsMap);
639 if (Tools.notEmpty(csid)) uri = Tools.glue(uri, "/", csid+"/items/");
641 uri = fromTestID(uri, testNode, serviceResultsMap);
643 //vars only make sense in two contexts: POST/PUT, because you are submitting another file with internal expressions,
644 // and in <response> nodes. For GET, DELETE, there is no payload, so all the URLs with potential expressions are right there in the testNode.
645 Map<String,String> vars = null;
646 if (parts.varsList.size()>0){
647 vars = parts.varsList.get(0);
649 serviceResult = XmlReplayTransport.doPOST_PUTFromXML(parts.responseFilename, vars, protoHostPort, uri, method, contentType, evalStruct, authForTest, testIDLabel);
650 serviceResult.autoDelete = autoDelete;
652 serviceResult.addVars(vars);
654 results.add(serviceResult);
656 serviceResultsMap.put(testID, serviceResult); //PUTs do not return a Location, so don't add PUTs to serviceResultsMap.
658 fullURL = fixupFullURL(fullURL, protoHostPort, uri);
659 } else if (method.equalsIgnoreCase("DELETE")){
660 String fromTestID = testNode.valueOf("fromTestID");
661 ServiceResult pr = Tools.notBlank(fromTestID) ? serviceResultsMap.get(fromTestID) : null;
663 serviceResult = XmlReplayTransport.doDELETE(pr.deleteURL, authForTest, testIDLabel, fromTestID);
664 serviceResult.fromTestID = fromTestID;
665 if (expectedCodes.size()>0){
666 serviceResult.expectedCodes = expectedCodes;
668 results.add(serviceResult);
669 if (serviceResult.codeInSuccessRange(serviceResult.responseCode)){ //gotExpectedResult depends on serviceResult.expectedCodes.
670 serviceResultsMap.remove(fromTestID);
673 if (Tools.notEmpty(fromTestID)){
674 serviceResult = new ServiceResult();
675 serviceResult.responseCode = 0;
676 serviceResult.error = "ID not found in element fromTestID: "+fromTestID;
677 System.err.println("****\r\nServiceResult: "+serviceResult.error+". SKIPPING TEST. Full URL: "+fullURL);
679 serviceResult = XmlReplayTransport.doDELETE(fullURL, authForTest, testID, fromTestID);
681 serviceResult.fromTestID = fromTestID;
682 results.add(serviceResult);
684 } else if (method.equalsIgnoreCase("GET")){
685 fullURL = fromTestID(fullURL, testNode, serviceResultsMap);
686 serviceResult = XmlReplayTransport.doGET(fullURL, authForTest, testIDLabel);
687 results.add(serviceResult);
688 serviceResultsMap.put(testID, serviceResult);
689 } else if (method.equalsIgnoreCase("LIST")){
690 fullURL = fixupFullURL(fullURL, protoHostPort, uri);
691 String listQueryParams = ""; //TODO: empty for now, later may pick up from XML control file.
692 serviceResult = XmlReplayTransport.doLIST(fullURL, listQueryParams, authForTest, testIDLabel);
693 results.add(serviceResult);
694 serviceResultsMap.put(testID, serviceResult);
696 throw new Exception("HTTP method not supported by XmlReplay: "+method);
699 serviceResult.testID = testID;
700 serviceResult.fullURL = fullURL;
701 serviceResult.auth = authForTest;
702 serviceResult.method = method;
703 if (expectedCodes.size()>0){
704 serviceResult.expectedCodes = expectedCodes;
706 if (Tools.isEmpty(serviceResult.testID)) serviceResult.testID = testIDLabel;
707 if (Tools.isEmpty(serviceResult.testGroupID)) serviceResult.testGroupID = testGroupID;
709 Node expectedLevel = testNode.selectSingleNode("response/expected");
710 if (expectedLevel!=null){
711 String level = expectedLevel.valueOf("@level");
712 serviceResult.payloadStrictness = level;
714 //=====================================================
715 // ALL VALIDATION FOR ALL REQUESTS IS DONE HERE:
716 //=====================================================
717 boolean hasError = false;
718 String vError = validateResponse(serviceResult, serviceResultsMap, expectedResponseParts, evalStruct);
719 if (Tools.notEmpty(vError)){
720 serviceResult.error = vError;
721 serviceResult.failureReason = " : VALIDATION ERROR; ";
724 if (hasError == false){
725 hasError = ! serviceResult.gotExpectedResult();
728 report.addTestResult(serviceResult);
730 if ((dump.dumpServiceResult == ServiceResult.DUMP_OPTIONS.detailed) || (dump.dumpServiceResult == ServiceResult.DUMP_OPTIONS.full)) {
731 System.out.println("\r\n#---------------------#");
734 String leader = (dump.dumpServiceResult == ServiceResult.DUMP_OPTIONS.detailed) ? "XmlReplay:" + testIDLabel +": ": "";
735 String serviceResultRow = serviceResult.dump(dump.dumpServiceResult, hasError) + "; time:" + (System.currentTimeMillis()-startTime);
736 //System.out.println(timeString() + "\n" + leader + serviceResultRow + "\r\n");
737 System.out.println(String.format("Time: %s\nLeader: %s\nAuth: %s\nResult: %s\r\n",
738 timeString(), testIDLabel, Tools.notEmpty(authIDForTest) ? authIDForTest : "<inferred>", serviceResultRow));
740 boolean doingAuto = (dump.dumpServiceResult == ServiceResult.DUMP_OPTIONS.auto);
741 if (dump.payloads || (doingAuto&&hasError) ) {
742 if (Tools.notBlank(serviceResult.requestPayload)){
743 System.out.println("\r\n========== request payload ===============");
744 System.out.println(serviceResult.requestPayload);
745 System.out.println("==========================================\r\n");
748 if (dump.payloads || (doingAuto&&hasError)) {
749 if (Tools.notBlank(serviceResult.result)){
750 System.out.println("\r\n========== response payload ==============");
751 System.out.println(serviceResult.result);
752 System.out.println("==========================================\r\n");
755 } catch (Throwable t) {
756 String msg = "ERROR: XmlReplay experienced an error in a test node: "+testNode+" Throwable: "+t;
757 System.out.println(msg);
758 System.out.println(Tools.getStackTrace(t));
759 ServiceResult serviceResult = new ServiceResult();
760 serviceResult.error = msg;
761 serviceResult.failureReason = " : SYSTEM ERROR; ";
762 results.add(serviceResult);
765 if (Tools.isTrue(autoDeletePOSTS) && param_autoDeletePOSTS){
766 autoDelete(defaultAuths, serviceResultsMap, "default", 0);
770 //=== Now spit out the HTML report file ===
771 File m = new File(controlFileName);
772 String localName = m.getName();//don't instantiate, just use File to extract file name without directory.
773 String reportName = localName+'-'+testGroupID+".html";
775 File resultFile = report.saveReport(xmlReplayBaseDir, reportsDir, reportName);
776 if (resultFile!=null) {
777 String toc = report.getTOC(reportName);
778 reportsList.add(toc);
780 //================================
785 private static String timeString() {
786 java.util.Date date= new java.util.Date();
787 java.sql.Timestamp ts = new java.sql.Timestamp(date.getTime());
788 return ts.toString();
792 //======================== MAIN ===================================================================
794 private static Options createOptions() {
795 Options options = new Options();
796 options.addOption("xmlReplayBaseDir", true, "default/basedir");
800 public static String usage(){
801 String result = "org.collectionspace.services.IntegrationTests.xmlreplay.XmlReplay {args}\r\n"
802 +" -xmlReplayBaseDir <dir> \r\n"
803 +" You may also override these with system args, e.g.: \r\n"
804 +" -DxmlReplayBaseDir=/path/to/dir \r\n"
805 +" These may also be passed in via the POM.\r\n"
806 +" You can also set these system args, e.g.: \r\n"
807 +" -DtestGroupID=<oneID> \r\n"
808 +" -DtestID=<one TestGroup ID>"
809 +" -DautoDeletePOSTS=<true|false> \r\n"
810 +" (note: -DautoDeletePOSTS won't force deletion if set to false in control file.";
814 private static String opt(CommandLine line, String option){
816 String fromProps = System.getProperty(option);
817 if (Tools.notEmpty(fromProps)){
823 result = line.getOptionValue(option);
830 public static void main(String[]args) throws Exception {
831 Options options = createOptions();
832 //System.out.println("System CLASSPATH: "+prop.getProperty("java.class.path", null));
833 CommandLineParser parser = new GnuParser();
835 // parse the command line arguments
836 CommandLine line = parser.parse(options, args);
838 String xmlReplayBaseDir = opt(line, "xmlReplayBaseDir");
839 String reportsDir = opt(line, "reportsDir");
840 String testGroupID = opt(line, "testGroupID");
841 String testID = opt(line, "testID");
842 String autoDeletePOSTS = opt(line, "autoDeletePOSTS");
843 String dumpResults = opt(line, "dumpResults");
844 String controlFilename = opt(line, "controlFilename");
845 String xmlReplayMaster = opt(line, "xmlReplayMaster");
847 if (Tools.isBlank(reportsDir)){
848 reportsDir = xmlReplayBaseDir + XmlReplayTest.REPORTS_DIRNAME;
850 reportsDir = Tools.fixFilename(reportsDir);
851 xmlReplayBaseDir = Tools.fixFilename(xmlReplayBaseDir);
852 controlFilename = Tools.fixFilename(controlFilename);
854 boolean bAutoDeletePOSTS = true;
855 if (Tools.notEmpty(autoDeletePOSTS)) {
856 bAutoDeletePOSTS = Tools.isTrue(autoDeletePOSTS);
858 boolean bDumpResults = false;
859 if (Tools.notEmpty(dumpResults)) {
860 bDumpResults = Tools.isTrue(autoDeletePOSTS);
862 if (Tools.isEmpty(xmlReplayBaseDir)){
863 System.err.println("ERROR: xmlReplayBaseDir was not specified.");
866 File f = new File(Tools.glue(xmlReplayBaseDir, "/", controlFilename));
867 if (Tools.isEmpty(xmlReplayMaster) && !f.exists()){
868 System.err.println("Control file not found: "+f.getCanonicalPath());
871 File fMaster = new File(Tools.glue(xmlReplayBaseDir, "/", xmlReplayMaster));
872 if (Tools.notEmpty(xmlReplayMaster) && !fMaster.exists()){
873 System.err.println("Master file not found: "+fMaster.getCanonicalPath());
877 String xmlReplayBaseDirResolved = (new File(xmlReplayBaseDir)).getCanonicalPath();
878 System.out.println("XmlReplay ::"
879 + "\r\n xmlReplayBaseDir: "+xmlReplayBaseDir
880 + "\r\n xmlReplayBaseDir(resolved): "+xmlReplayBaseDirResolved
881 + "\r\n controlFilename: "+controlFilename
882 + "\r\n xmlReplayMaster: "+xmlReplayMaster
883 + "\r\n testGroupID: "+testGroupID
884 + "\r\n testID: "+testID
885 + "\r\n autoDeletePOSTS: "+bAutoDeletePOSTS
886 + (Tools.notEmpty(xmlReplayMaster)
887 ? ("\r\n will use master file: "+fMaster.getCanonicalPath())
888 : ("\r\n will use control file: "+f.getCanonicalPath()) )
891 if (Tools.notEmpty(xmlReplayMaster)){
892 if (Tools.notEmpty(controlFilename)){
893 System.out.println("WARN: controlFilename: "+controlFilename+" will not be used because master was specified. Running master: "+xmlReplayMaster);
895 XmlReplay replay = new XmlReplay(xmlReplayBaseDirResolved, reportsDir);
896 replay.readOptionsFromMasterConfigFile(xmlReplayMaster);
897 replay.setAutoDeletePOSTS(bAutoDeletePOSTS);
898 Dump dumpFromMaster = replay.getDump();
899 dumpFromMaster.payloads = Tools.isTrue(dumpResults);
900 replay.setDump(dumpFromMaster);
901 replay.runMaster(xmlReplayMaster, false); //false, because we already just read the options, and override a few.
903 Dump dump = getDumpConfig();
904 dump.payloads = Tools.isTrue(dumpResults);
905 List<String> reportsList = new ArrayList<String>();
906 runXmlReplayFile(xmlReplayBaseDirResolved, controlFilename, testGroupID, testID, createResultsMap(), bAutoDeletePOSTS, dump, "", null, reportsList, reportsDir);
907 System.out.println("DEPRECATED: reportsList is generated, but not dumped: "+reportsList.toString());
909 } catch (ParseException exp) {
910 // oops, something went wrong
911 System.err.println("Cmd-line parsing failed. Reason: " + exp.getMessage());
912 System.err.println(usage());
913 } catch (Exception e) {
914 System.out.println("Error : " + e.getMessage());