git.aero2k.de Git - tmp/jakarta-migration.git/blob

   1 /**
   2  * This document is a part of the source code and related artifacts
   3  * for CollectionSpace, an open source collections management system
   4  * for museums and related institutions:
   5  *
   6  * http://www.collectionspace.org
   7  * http://wiki.collectionspace.org
   8  *
   9  * Copyright © 2009 Regents of the University of California
  10  *
  11  * Licensed under the Educational Community License (ECL), Version 2.0.
  12  * You may not use this file except in compliance with this License.
  13  *
  14  * You may obtain a copy of the ECL 2.0 License at
  15  * https://source.collectionspace.org/collection-space/LICENSE.txt
  16  *
  17  * Unless required by applicable law or agreed to in writing, software
  18  * distributed under the License is distributed on an "AS IS" BASIS,
  19  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  20  * See the License for the specific language governing permissions and
  21  * limitations under the License.
  22  */
  23 package org.collectionspace.services.authorization.client.test;
  24
  25 //import java.util.ArrayList;
  26 import java.util.List;
  27 import javax.ws.rs.core.Response;
  28 //import org.collectionspace.services.authorization.ActionType;
  29 import org.collectionspace.services.authorization.EffectType;
  30
  31 import org.collectionspace.services.client.CollectionSpaceClient;
  32 import org.collectionspace.services.client.PermissionClient;
  33 import org.collectionspace.services.authorization.Permission;
  34 import org.collectionspace.services.authorization.PermissionAction;
  35 import org.collectionspace.services.authorization.PermissionsList;
  36 import org.collectionspace.services.client.PermissionFactory;
  37 import org.collectionspace.services.client.test.AbstractServiceTestImpl;
  38 import org.collectionspace.services.client.test.ServiceRequestType;
  39 import org.collectionspace.services.jaxb.AbstractCommonList;
  40 import org.jboss.resteasy.client.ClientResponse;
  41
  42 import org.testng.Assert;
  43 import org.testng.annotations.Test;
  44
  45 import org.slf4j.Logger;
  46 import org.slf4j.LoggerFactory;
  47
  48 /**
  49  * PermissionServiceTest, carries out tests against a
  50  * deployed and running Permission Service.
  51  *
  52  * $LastChangedRevision: 917 $
  53  * $LastChangedDate: 2009-11-06 12:20:28 -0800 (Fri, 06 Nov 2009) $
  54  */
  55 public class PermissionServiceTest extends AbstractServiceTestImpl {
  56
  57     /** The Constant logger. */
  58     private final static String CLASS_NAME = PermissionServiceTest.class.getName();
  59     private final static Logger logger = LoggerFactory.getLogger(CLASS_NAME);
  60
  61     // Instance variables specific to this test.
  62     /** The known resource id. */
  63     private String knownResourceId = null;
  64     private String knownResource = "accounts-test";
  65     /*
  66      * This method is called only by the parent class, AbstractServiceTestImpl
  67      */
  68
  69     /* (non-Javadoc)
  70      * @see org.collectionspace.services.client.test.BaseServiceTest#getServicePathComponent()
  71      */
  72     @Override
  73     protected String getServicePathComponent() {
  74         return new PermissionClient().getServicePathComponent();
  75     }
  76
  77     /* (non-Javadoc)
  78      * @see org.collectionspace.services.client.test.BaseServiceTest#getClientInstance()
  79      */
  80     @Override
  81     protected CollectionSpaceClient getClientInstance() {
  82         return new PermissionClient();
  83     }
  84
  85     /* (non-Javadoc)
  86      * @see org.collectionspace.services.client.test.BaseServiceTest#getAbstractCommonList(org.jboss.resteasy.client.ClientResponse)
  87      */
  88     @Override
  89     protected AbstractCommonList getAbstractCommonList(
  90             ClientResponse<AbstractCommonList> response) {
  91         //FIXME: http://issues.collectionspace.org/browse/CSPACE-1697
  92         throw new UnsupportedOperationException();
  93     }
  94
  95     /* (non-Javadoc)
  96      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#readPaginatedList(java.lang.String)
  97      */
  98     @Test(dataProvider = "testName")
  99     @Override
 100     public void readPaginatedList(String testName) throws Exception {
 101         //FIXME: http://issues.collectionspace.org/browse/CSPACE-1697
 102     }
 103
 104     // ---------------------------------------------------------------
 105     // CRUD tests : CREATE tests
 106     // ---------------------------------------------------------------
 107     // Success outcomes
 108     /* (non-Javadoc)
 109      * @see org.collectionspace.services.client.test.ServiceTest#create(java.lang.String)
 110      */
 111     @Override
 112     @Test(dataProvider = "testName", dataProviderClass = AbstractServiceTestImpl.class)
 113     public void create(String testName) throws Exception {
 114
 115         if (logger.isDebugEnabled()) {
 116             logger.debug(testBanner(testName, CLASS_NAME));
 117         }
 118         // Perform setup, such as initializing the type of service request
 119         // (e.g. CREATE, DELETE), its valid and expected status codes, and
 120         // its associated HTTP method name (e.g. POST, DELETE).
 121         setupCreate();
 122
 123         // Submit the request to the service and store the response.
 124         List<PermissionAction> actions = PermissionFactory.createDefaultActions();
 125         Permission permission = createPermissionInstance(knownResource,
 126                 "default permissions for account",
 127                 actions,
 128                 EffectType.PERMIT,
 129                 true,
 130                 true,
 131                 true);
 132         PermissionClient client = new PermissionClient();
 133         ClientResponse<Response> res = client.create(permission);
 134         int statusCode = res.getStatus();
 135
 136         // Check the status code of the response: does it match
 137         // the expected response(s)?
 138         //
 139         // Specifically:
 140         // Does it fall within the set of valid status codes?
 141         // Does it exactly match the expected status code?
 142         if (logger.isDebugEnabled()) {
 143             logger.debug(testName + ": status = " + statusCode);
 144         }
 145         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 146                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 147         Assert.assertEquals(statusCode, EXPECTED_STATUS_CODE);
 148
 149         // Store the ID returned from this create operation
 150         // for additional tests below.
 151         knownResourceId = extractId(res);
 152         if (logger.isDebugEnabled()) {
 153             logger.debug(testName + ": knownResourceId=" + knownResourceId);
 154         }
 155     }
 156
 157     /**
 158      * Creates the without resource name.
 159      *
 160      * @param testName the test name
 161      * @throws Exception the exception
 162      */
 163     @Test(dataProvider = "testName", dataProviderClass = AbstractServiceTestImpl.class,
 164     dependsOnMethods = {"create"})
 165     public void createWithoutResourceName(String testName) throws Exception {
 166
 167         if (logger.isDebugEnabled()) {
 168             logger.debug(testBanner(testName, CLASS_NAME));
 169         }
 170         setupCreate();
 171
 172         // Submit the request to the service and store the response.
 173         List<PermissionAction> actions = PermissionFactory.createDefaultActions();
 174         Permission permission = createPermissionInstance(null,
 175                 "default permissions for account",
 176                 actions,
 177                 EffectType.PERMIT,
 178                 false,
 179                 true,
 180                 true);
 181         PermissionClient client = new PermissionClient();
 182         ClientResponse<Response> res = client.create(permission);
 183         int statusCode = res.getStatus();
 184         // Does it exactly match the expected status code?
 185         if (logger.isDebugEnabled()) {
 186             logger.debug(testName + ": status = " + statusCode);
 187         }
 188         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 189                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 190         Assert.assertEquals(statusCode, Response.Status.BAD_REQUEST.getStatusCode());
 191     }
 192
 193     //to not cause uniqueness violation for permission, createList is removed
 194     /* (non-Javadoc)
 195      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#createList(java.lang.String)
 196      */
 197     @Override
 198     @Test(dataProvider = "testName", dataProviderClass = AbstractServiceTestImpl.class,
 199     dependsOnMethods = {"create"})
 200     public void createList(String testName) throws Exception {
 201
 202         if (logger.isDebugEnabled()) {
 203             logger.debug(testBanner(testName, CLASS_NAME));
 204         }
 205         setupCreate();
 206         // Submit the request to the service and store the response.
 207         List<PermissionAction> actions = PermissionFactory.createDefaultActions();
 208         Permission permission1 = createPermissionInstance("test-objects",
 209                 "default permissions for test-objects",
 210                 actions,
 211                 EffectType.PERMIT,
 212                 true,
 213                 true,
 214                 true);
 215         PermissionClient client = new PermissionClient();
 216         ClientResponse<Response> res = client.create(permission1);
 217         int statusCode = res.getStatus();
 218         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 219                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 220         Assert.assertEquals(statusCode, EXPECTED_STATUS_CODE);
 221         allResourceIdsCreated.add(extractId(res));
 222
 223         Permission permission2 = createPermissionInstance("test-acquisitions",
 224                 "default permissions for test-acquisitions",
 225                 actions,
 226                 EffectType.PERMIT,
 227                 true,
 228                 true,
 229                 true);
 230         res = client.create(permission2);
 231         statusCode = res.getStatus();
 232         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 233                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 234         Assert.assertEquals(statusCode, EXPECTED_STATUS_CODE);
 235         allResourceIdsCreated.add(extractId(res));
 236
 237         Permission permission3 = createPermissionInstance("test-ids",
 238                 "default permissions for id service",
 239                 actions,
 240                 EffectType.PERMIT,
 241                 true,
 242                 true,
 243                 true);
 244         res = client.create(permission3);
 245         statusCode = res.getStatus();
 246         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 247                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 248         Assert.assertEquals(statusCode, EXPECTED_STATUS_CODE);
 249         allResourceIdsCreated.add(extractId(res));
 250     }
 251
 252     // Failure outcomes
 253     // Placeholders until the three tests below can be uncommented.
 254     // See Issue CSPACE-401.
 255     /* (non-Javadoc)
 256      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#createWithEmptyEntityBody(java.lang.String)
 257      */
 258     @Override
 259     public void createWithEmptyEntityBody(String testName) throws Exception {
 260         //FIXME: Should this test really be empty?  If so, please comment accordingly.
 261     }
 262
 263     /* (non-Javadoc)
 264      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#createWithMalformedXml(java.lang.String)
 265      */
 266     @Override
 267     public void createWithMalformedXml(String testName) throws Exception {
 268         //FIXME: Should this test really be empty?  If so, please comment accordingly.
 269     }
 270
 271     /* (non-Javadoc)
 272      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#createWithWrongXmlSchema(java.lang.String)
 273      */
 274     @Override
 275     public void createWithWrongXmlSchema(String testName) throws Exception {
 276         //FIXME: Should this test really be empty?  If so, please comment accordingly.
 277     }
 278
 279     // ---------------------------------------------------------------
 280     // CRUD tests : READ tests
 281     // ---------------------------------------------------------------
 282     // Success outcomes
 283     /* (non-Javadoc)
 284      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#read(java.lang.String)
 285      */
 286     @Override
 287     @Test(dataProvider = "testName", dataProviderClass = AbstractServiceTestImpl.class,
 288     dependsOnMethods = {"create"})
 289     public void read(String testName) throws Exception {
 290
 291         if (logger.isDebugEnabled()) {
 292             logger.debug(testBanner(testName, CLASS_NAME));
 293         }
 294         // Perform setup.
 295         setupRead();
 296
 297         // Submit the request to the service and store the response.
 298         PermissionClient client = new PermissionClient();
 299         ClientResponse<Permission> res = client.read(knownResourceId);
 300         int statusCode = res.getStatus();
 301
 302         // Check the status code of the response: does it match
 303         // the expected response(s)?
 304         if (logger.isDebugEnabled()) {
 305             logger.debug(testName + ": status = " + statusCode);
 306         }
 307         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 308                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 309         Assert.assertEquals(statusCode, EXPECTED_STATUS_CODE);
 310
 311         Permission output = (Permission) res.getEntity();
 312         Assert.assertNotNull(output);
 313     }
 314
 315     // Failure outcomes
 316     /* (non-Javadoc)
 317      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#readNonExistent(java.lang.String)
 318      */
 319     @Override
 320     @Test(dataProvider = "testName", dataProviderClass = AbstractServiceTestImpl.class,
 321     dependsOnMethods = {"read"})
 322     public void readNonExistent(String testName) throws Exception {
 323
 324         if (logger.isDebugEnabled()) {
 325             logger.debug(testBanner(testName, CLASS_NAME));
 326         }
 327         // Perform setup.
 328         setupReadNonExistent();
 329
 330         // Submit the request to the service and store the response.
 331         PermissionClient client = new PermissionClient();
 332         ClientResponse<Permission> res = client.read(NON_EXISTENT_ID);
 333         int statusCode = res.getStatus();
 334
 335         // Check the status code of the response: does it match
 336         // the expected response(s)?
 337         if (logger.isDebugEnabled()) {
 338             logger.debug(testName + ": status = " + statusCode);
 339         }
 340         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 341                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 342         Assert.assertEquals(statusCode, EXPECTED_STATUS_CODE);
 343     }
 344
 345     // ---------------------------------------------------------------
 346     // CRUD tests : READ_LIST tests
 347     // ---------------------------------------------------------------
 348     // Success outcomes
 349     /* (non-Javadoc)
 350      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#readList(java.lang.String)
 351      */
 352     @Override
 353     @Test(dataProvider = "testName", dataProviderClass = AbstractServiceTestImpl.class,
 354     dependsOnMethods = {"createList", "read"})
 355     public void readList(String testName) throws Exception {
 356
 357         if (logger.isDebugEnabled()) {
 358             logger.debug(testBanner(testName, CLASS_NAME));
 359         }
 360         // Perform setup.
 361         setupReadList();
 362
 363         // Submit the request to the service and store the response.
 364         PermissionClient client = new PermissionClient();
 365         ClientResponse<PermissionsList> res = client.readList();
 366         PermissionsList list = res.getEntity();
 367         int statusCode = res.getStatus();
 368
 369         // Check the status code of the response: does it match
 370         // the expected response(s)?
 371         if (logger.isDebugEnabled()) {
 372             logger.debug(testName + ": status = " + statusCode);
 373         }
 374         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 375                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 376         Assert.assertEquals(statusCode, EXPECTED_STATUS_CODE);
 377
 378         // Optionally output additional data about list members for debugging.
 379         boolean iterateThroughList = true;
 380         if (iterateThroughList && logger.isDebugEnabled()) {
 381             printList(testName, list);
 382         }
 383     }
 384
 385     /**
 386      * Search resource name.
 387      *
 388      * @param testName the test name
 389      * @throws Exception the exception
 390      */
 391     @Test(dataProvider = "testName", dataProviderClass = AbstractServiceTestImpl.class,
 392     dependsOnMethods = {"createList", "read"})
 393     public void searchResourceName(String testName) throws Exception {
 394
 395         if (logger.isDebugEnabled()) {
 396             logger.debug(testBanner(testName, CLASS_NAME));
 397         }
 398         // Perform setup.
 399         setupReadList();
 400
 401         // Submit the request to the service and store the response.
 402         PermissionClient client = new PermissionClient();
 403         ClientResponse<PermissionsList> res = client.readSearchList("acquisition");
 404         PermissionsList list = res.getEntity();
 405         int statusCode = res.getStatus();
 406         // Check the status code of the response: does it match
 407         // the expected response(s)?
 408         if (logger.isDebugEnabled()) {
 409             logger.debug(testName + ": status = " + statusCode);
 410         }
 411         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 412                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 413         Assert.assertEquals(statusCode, EXPECTED_STATUS_CODE);
 414         int EXPECTED_ITEMS = 3; //seeded permissions
 415         int actual = list.getPermissions().size();
 416         if (logger.isDebugEnabled()) {
 417             logger.debug(testName + ": received = " + actual
 418                     + " expected=" + EXPECTED_ITEMS);
 419         }
 420         // Optionally output additional data about list members for debugging.
 421         boolean iterateThroughList = true;
 422         if (iterateThroughList && logger.isDebugEnabled()) {
 423             printList(testName, list);
 424         }
 425         Assert.assertEquals(EXPECTED_ITEMS, list.getPermissions().size());
 426
 427     }
 428
 429     // Failure outcomes
 430     // None at present.
 431     // ---------------------------------------------------------------
 432     // CRUD tests : UPDATE tests
 433     // ---------------------------------------------------------------
 434     // Success outcomes
 435     /* (non-Javadoc)
 436      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#update(java.lang.String)
 437      */
 438     @Override
 439     @Test(dataProvider = "testName", dataProviderClass = AbstractServiceTestImpl.class,
 440     dependsOnMethods = {"read", "readList", "readNonExistent"})
 441     public void update(String testName) throws Exception {
 442
 443         if (logger.isDebugEnabled()) {
 444             logger.debug(testBanner(testName, CLASS_NAME));
 445         }
 446         // Perform setup.
 447         setupUpdate();
 448
 449         Permission permToUpdate = new Permission();
 450         permToUpdate.setCsid(knownResourceId);
 451         permToUpdate.setResourceName(knownResource);
 452         // Update the content of this resource.
 453         permToUpdate.setDescription("updated description");
 454         if (logger.isDebugEnabled()) {
 455             logger.debug("updated object");
 456             logger.debug(objectAsXmlString(permToUpdate,
 457                     Permission.class));
 458         }
 459         PermissionClient client = new PermissionClient();
 460         // Submit the request to the service and store the response.
 461         ClientResponse<Permission> res = client.update(knownResourceId, permToUpdate);
 462         int statusCode = res.getStatus();
 463         // Check the status code of the response: does it match the expected response(s)?
 464         if (logger.isDebugEnabled()) {
 465             logger.debug(testName + ": status = " + statusCode);
 466         }
 467         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 468                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 469         Assert.assertEquals(statusCode, EXPECTED_STATUS_CODE);
 470
 471
 472         Permission permUpdated = (Permission) res.getEntity();
 473         Assert.assertNotNull(permUpdated);
 474
 475         Assert.assertEquals(permUpdated.getDescription(),
 476                 permToUpdate.getDescription(),
 477                 "Data in updated object did not match submitted data.");
 478     }
 479
 480     @Test(dataProvider = "testName", dataProviderClass = AbstractServiceTestImpl.class,
 481     dependsOnMethods = {"read", "readList", "readNonExistent"})
 482     public void updateNotAllowed(String testName) throws Exception {
 483
 484         // Perform setup.
 485         setupUpdate();
 486
 487         Permission permToUpdate = new Permission();
 488         permToUpdate.setCsid(knownResourceId);
 489         // Update the content of this resource.
 490         permToUpdate.setResourceName("updated-resource");
 491         if (logger.isDebugEnabled()) {
 492             logger.debug("updated object");
 493             logger.debug(objectAsXmlString(permToUpdate,
 494                     Permission.class));
 495         }
 496         PermissionClient client = new PermissionClient();
 497         // Submit the request to the service and store the response.
 498         ClientResponse<Permission> res = client.update(knownResourceId, permToUpdate);
 499         int statusCode = res.getStatus();
 500         // Check the status code of the response: does it match the expected response(s)?
 501         if (logger.isDebugEnabled()) {
 502             logger.debug(testName + ": status = " + statusCode);
 503         }
 504         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 505                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 506         Assert.assertEquals(statusCode, Response.Status.BAD_REQUEST.getStatusCode());
 507
 508     }
 509
 510     /**
 511      * Update actions.
 512      *
 513      * @param testName the test name
 514      * @throws Exception the exception
 515      */
 516     @Test(dataProvider = "testName", dataProviderClass = AbstractServiceTestImpl.class,
 517     dependsOnMethods = {"updateNotAllowed"})
 518     public void updateActions(String testName) throws Exception {
 519
 520         if (logger.isDebugEnabled()) {
 521             logger.debug(testBanner(testName, CLASS_NAME));
 522         }
 523         // Perform setup.
 524         setupUpdate();
 525
 526         Permission permToUpdate = new Permission();
 527         permToUpdate.setCsid(knownResourceId);
 528         permToUpdate.setResourceName(knownResource);
 529         // Update the content of this resource.
 530         List<PermissionAction> actions = PermissionFactory.createDefaultActions();
 531         int default_actions = actions.size();
 532         actions.remove(0);
 533         actions.remove(0);
 534         int toUpdate_actions = actions.size();
 535         if (logger.isDebugEnabled()) {
 536             logger.debug(testName + " no. of actions default=" + default_actions
 537                     + " to update =" + toUpdate_actions);
 538         }
 539         permToUpdate.setActions(actions);
 540         if (logger.isDebugEnabled()) {
 541             logger.debug(testName + " updated object\n"
 542                     + objectAsXmlString(permToUpdate, Permission.class));
 543         }
 544         PermissionClient client = new PermissionClient();
 545         // Submit the request to the service and store the response.
 546         ClientResponse<Permission> res = client.update(knownResourceId, permToUpdate);
 547         int statusCode = res.getStatus();
 548         // Check the status code of the response: does it match the expected response(s)?
 549         if (logger.isDebugEnabled()) {
 550             logger.debug(testName + ": status = " + statusCode);
 551         }
 552         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 553                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 554         Assert.assertEquals(statusCode, EXPECTED_STATUS_CODE);
 555
 556         Permission permUpdated = (Permission) res.getEntity();
 557         Assert.assertNotNull(permUpdated);
 558         int updated_actions = permToUpdate.getActions().size();
 559         if (logger.isDebugEnabled()) {
 560             logger.debug(testName + " no. of actions to update=" + toUpdate_actions
 561                     + " updated =" + updated_actions);
 562         }
 563         Assert.assertEquals(toUpdate_actions,
 564                 updated_actions,
 565                 "Data in updated object did not match submitted data.");
 566     }
 567     // Failure outcomes
 568     // Placeholders until the three tests below can be uncommented.
 569     // See Issue CSPACE-401.
 570
 571     /* (non-Javadoc)
 572      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#updateWithEmptyEntityBody(java.lang.String)
 573      */
 574     @Override
 575     public void updateWithEmptyEntityBody(String testName) throws Exception {
 576         //FIXME: Should this test really be empty?  If so, please comment accordingly.
 577     }
 578
 579     /* (non-Javadoc)
 580      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#updateWithMalformedXml(java.lang.String)
 581      */
 582     @Override
 583     public void updateWithMalformedXml(String testName) throws Exception {
 584         //FIXME: Should this test really be empty?  If so, please comment accordingly.
 585     }
 586
 587     /* (non-Javadoc)
 588      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#updateWithWrongXmlSchema(java.lang.String)
 589      */
 590     @Override
 591     public void updateWithWrongXmlSchema(String testName) throws Exception {
 592         //FIXME: Should this test really be empty?  If so, please comment accordingly.
 593     }
 594
 595     /* (non-Javadoc)
 596      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#updateNonExistent(java.lang.String)
 597      */
 598     @Override
 599     @Test(dataProvider = "testName", dataProviderClass = AbstractServiceTestImpl.class,
 600     dependsOnMethods = {"readNonExistent", "testSubmitRequest"})
 601     public void updateNonExistent(String testName) throws Exception {
 602
 603         if (logger.isDebugEnabled()) {
 604             logger.debug(testBanner(testName, CLASS_NAME));
 605         }
 606         // Perform setup.
 607         setupUpdateNonExistent();
 608
 609         // Submit the request to the service and store the response.
 610         //
 611         // Note: The ID used in this 'create' call may be arbitrary.
 612         // The only relevant ID may be the one used in updatePermission(), below.
 613         PermissionClient client = new PermissionClient();
 614         List<PermissionAction> actions = PermissionFactory.createDefaultActions();
 615         Permission permission = createPermissionInstance("test-acquisitions",
 616                 "default permissions for test-acquisitions",
 617                 actions,
 618                 EffectType.PERMIT,
 619                 true,
 620                 true,
 621                 true);
 622         ClientResponse<Permission> res =
 623                 client.update(NON_EXISTENT_ID, permission);
 624         int statusCode = res.getStatus();
 625
 626         // Check the status code of the response: does it match
 627         // the expected response(s)?
 628         if (logger.isDebugEnabled()) {
 629             logger.debug(testName + ": status = " + statusCode);
 630         }
 631         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 632                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 633         Assert.assertEquals(statusCode, EXPECTED_STATUS_CODE);
 634     }
 635
 636     // ---------------------------------------------------------------
 637     // CRUD tests : DELETE tests
 638     // ---------------------------------------------------------------
 639     // Success outcomes
 640     /* (non-Javadoc)
 641      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#delete(java.lang.String)
 642      */
 643     @Override
 644     @Test(dataProvider = "testName", dataProviderClass = AbstractServiceTestImpl.class,
 645     dependsOnMethods = {"updateActions", "testSubmitRequest"})
 646     public void delete(String testName) throws Exception {
 647
 648         if (logger.isDebugEnabled()) {
 649             logger.debug(testBanner(testName, CLASS_NAME));
 650         }
 651         // Perform setup.
 652         setupDelete();
 653
 654         // Submit the request to the service and store the response.
 655         PermissionClient client = new PermissionClient();
 656         ClientResponse<Response> res = client.delete(knownResourceId);
 657         int statusCode = res.getStatus();
 658
 659         // Check the status code of the response: does it match
 660         // the expected response(s)?
 661         if (logger.isDebugEnabled()) {
 662             logger.debug(testName + ": status = " + statusCode);
 663         }
 664         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 665                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 666         Assert.assertEquals(statusCode, EXPECTED_STATUS_CODE);
 667     }
 668
 669     // Failure outcomes
 670     /* (non-Javadoc)
 671      * @see org.collectionspace.services.client.test.AbstractServiceTestImpl#deleteNonExistent(java.lang.String)
 672      */
 673     @Override
 674     @Test(dataProvider = "testName", dataProviderClass = AbstractServiceTestImpl.class,
 675     dependsOnMethods = {"delete"})
 676     public void deleteNonExistent(String testName) throws Exception {
 677
 678         if (logger.isDebugEnabled()) {
 679             logger.debug(testBanner(testName, CLASS_NAME));
 680         }
 681         // Perform setup.
 682         setupDeleteNonExistent();
 683
 684         // Submit the request to the service and store the response.
 685         PermissionClient client = new PermissionClient();
 686         ClientResponse<Response> res = client.delete(NON_EXISTENT_ID);
 687         int statusCode = res.getStatus();
 688
 689         // Check the status code of the response: does it match
 690         // the expected response(s)?
 691         if (logger.isDebugEnabled()) {
 692             logger.debug(testName + ": status = " + statusCode);
 693         }
 694         Assert.assertTrue(REQUEST_TYPE.isValidStatusCode(statusCode),
 695                 invalidStatusCodeMessage(REQUEST_TYPE, statusCode));
 696         Assert.assertEquals(statusCode, EXPECTED_STATUS_CODE);
 697     }
 698
 699     // ---------------------------------------------------------------
 700     // Utility tests : tests of code used in tests above
 701     // ---------------------------------------------------------------
 702     /**
 703      * Tests the code for manually submitting data that is used by several
 704      * of the methods above.
 705      * @throws Exception
 706      */
 707     @Test(dependsOnMethods = {"create"})
 708     public void testSubmitRequest() throws Exception {
 709
 710         // Expected status code: 200 OK
 711         final int EXPECTED_STATUS = Response.Status.OK.getStatusCode();
 712
 713         // Submit the request to the service and store the response.
 714         String method = ServiceRequestType.READ.httpMethodName();
 715         String url = getResourceURL(knownResourceId);
 716         int statusCode = submitRequest(method, url);
 717
 718         // Check the status code of the response: does it match
 719         // the expected response(s)?
 720         if (logger.isDebugEnabled()) {
 721             logger.debug("testSubmitRequest: url=" + url
 722                     + " status=" + statusCode);
 723         }
 724         Assert.assertEquals(statusCode, EXPECTED_STATUS);
 725
 726     }
 727
 728     // ---------------------------------------------------------------
 729     // Utility methods used by tests above
 730     // ---------------------------------------------------------------
 731     /**
 732      * create permission instance
 733      * @param resourceName
 734      * @param description
 735      * @param actionList list of actions for this permission
 736      * @param effect effect of the permission
 737      * @param useResourceName
 738      * @param useAction
 739      * @param useEffect
 740      * @return permission
 741      */
 742     public static Permission createPermissionInstance(String resourceName,
 743             String description,
 744             List<PermissionAction> actionList,
 745             EffectType effect,
 746             boolean useResourceName,
 747             boolean useAction,
 748             boolean useEffect) {
 749
 750         Permission permission = PermissionFactory.createPermissionInstance(resourceName,
 751                 description, actionList, effect,
 752                 useResourceName, useAction, useEffect);
 753
 754         if (logger.isDebugEnabled()) {
 755             logger.debug("to be created, permission");
 756             logger.debug(objectAsXmlString(permission, Permission.class));
 757         }
 758         return permission;
 759     }
 760
 761     /**
 762      * Prints the list.
 763      *
 764      * @param testName the test name
 765      * @param list the list
 766      * @return the int
 767      */
 768     private int printList(String testName, PermissionsList list) {
 769
 770         int i = 0;
 771
 772         for (Permission permission : list.getPermissions()) {
 773             logger.debug(testName + " permission csid=" + permission.getCsid()
 774                     + " name=" + permission.getResourceName()
 775                     + " desc=" + permission.getDescription());
 776             i++;
 777         }
 778         return i;
 779     }
 780 }