Coverage Report - org.kuali.student.enrollment.lpr.service.adapter.LuiPersonRelationAdapter
 
Classes in this File Line Coverage Branch Coverage Complexity
LuiPersonRelationAdapter
29%
9/31
N/A
1
 
 1  
 /*
 2  
  * Copyright 2009 The Kuali Foundation
 3  
  *
 4  
  * Licensed under the Educational Community License, Version 1.0 (the
 5  
  * "License"); you may not use this file except in compliance with the
 6  
  * License.  You may obtain a copy of the License at
 7  
  *
 8  
  * http://www.opensource.org/licenses/ecl1.php
 9  
  *
 10  
  * Unless required by applicable law or agreed to in writing, software
 11  
  * distributed under the License is distributed on an "AS IS" BASIS,
 12  
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
 13  
  * implied.  See the License for the specific language governing
 14  
  * permissions and limitations under the License.
 15  
  */
 16  
 
 17  
 package org.kuali.student.enrollment.lpr.service.adapter;
 18  
 
 19  
 import org.kuali.student.enrollment.lpr.service.LuiPersonRelationServiceInfc;
 20  
 import org.kuali.student.common.infc.ContextInfc;
 21  
 import org.kuali.student.common.infc.StatusInfc;
 22  
 import org.kuali.student.common.infc.ValidationResultInfc;
 23  
 import org.kuali.student.core.exceptions.*;
 24  
 import org.kuali.student.enrollment.lpr.infc.*;
 25  
 
 26  
 import java.util.List;
 27  
 import org.kuali.student.common.infc.CriteriaInfc;
 28  
 import org.kuali.student.common.infc.HoldsLprServiceInfc;
 29  
 
 30  
 
 31  
 /**
 32  
  * A example of a generic adapter that does absolutely nothing.
 33  
  *
 34  
  * @Author Tom
 35  
  */
 36  
 
 37  62
 public class LuiPersonRelationAdapter
 38  
         implements LuiPersonRelationServiceInfc, HoldsLprServiceInfc {
 39  
 
 40  
     private LuiPersonRelationServiceInfc lprService;
 41  
 
 42  
         @Override
 43  
     public LuiPersonRelationServiceInfc getLprService() {
 44  92
         return this.lprService;
 45  
     }
 46  
 
 47  
 
 48  
 @Override
 49  
     public void setLprService(LuiPersonRelationServiceInfc lprService) {
 50  61
         this.lprService = lprService;
 51  61
     }
 52  
 
 53  
 
 54  
     /**
 55  
      * Retrieves the list of LUIPersonRelation types.
 56  
      *
 57  
      * @param context Context information containing the principalId
 58  
      *                and locale information about the caller of service
 59  
      *                operation
 60  
      * @return list of luiPersonRelationTypes
 61  
      * @throws OperationFailedException unable to complete request
 62  
      */
 63  
 
 64  
     @Override
 65  
     public List<LuiPersonRelationTypeInfc> findLuiPersonRelationTypes(ContextInfc context)
 66  
             throws OperationFailedException {
 67  
 
 68  0
         return (getLprService().findLuiPersonRelationTypes(context));
 69  
     }
 70  
 
 71  
 
 72  
     /**
 73  
      * Retrieves the list of LUI Person Relation States.
 74  
      *
 75  
      * @param context Context information containing the principalId
 76  
      *                and locale information about the caller of service
 77  
      *                operation
 78  
      * @return list of relation states
 79  
      * @throws OperationFailedException unable to complete request
 80  
      */
 81  
 
 82  
     @Override
 83  
     public List<LuiPersonRelationStateInfc> findLuiPersonRelationStates(ContextInfc context)
 84  
             throws OperationFailedException {
 85  
 
 86  0
         return (getLprService().findLuiPersonRelationStates(context));
 87  
     }
 88  
 
 89  
 
 90  
     /**
 91  
      * Retrieves the list of Allowed Relation States.
 92  
      *
 93  
      * @param luiPersonRelationType Type of LUI Person Relation
 94  
      * @param context               Context information containing the principalId
 95  
      *                              and locale information about the caller of service
 96  
      *                              operation
 97  
      * @return list of relationState
 98  
      * @throws DoesNotExistException     luiPersonRelationType not found
 99  
      * @throws InvalidParameterException invalid luiPersonRelationType
 100  
      * @throws MissingParameterException missing luiPersonRelationType
 101  
      * @throws OperationFailedException  unable to complete request
 102  
      */
 103  
 
 104  
     @Override
 105  
     public List<LuiPersonRelationStateInfc> findAllowedRelationStates(String luiPersonRelationType, ContextInfc context)
 106  
             throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException {
 107  
 
 108  0
         return (this.lprService.findAllowedRelationStates(luiPersonRelationType, context));
 109  
     }
 110  
 
 111  
 
 112  
     /**
 113  
      * Retrieves the Relation for the specified LUI Person Relation.
 114  
      *
 115  
      * @param luiPersonRelationId Identifier for the LUI Person Relation
 116  
      * @param context             Context information containing the principalId
 117  
      *                            and locale information about the caller of service
 118  
      *                            operation
 119  
      * @return LUI Person Relation information
 120  
      * @throws DoesNotExistException     luiPersonRelationId not found
 121  
      * @throws InvalidParameterException invalid luiPersonRelationId
 122  
      * @throws MissingParameterException missing luiPersonRelationId
 123  
      * @throws OperationFailedException  unable to complete request
 124  
      * @throws PermissionDeniedException authorization failure
 125  
      */
 126  
 
 127  
     @Override
 128  
     public LuiPersonRelationInfc fetchLUIPersonRelation(String luiPersonRelationId, ContextInfc context)
 129  
             throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 130  
 
 131  18
         return (getLprService().fetchLUIPersonRelation(luiPersonRelationId, context));
 132  
     }
 133  
 
 134  
 
 135  
     /**
 136  
      * Retrieves the Relation for the specified list of LUI Person
 137  
      * Relation Ids.
 138  
      *
 139  
      * @param luiPersonRelationIdList List of identifiers for LUI
 140  
      *                                Person Relations
 141  
      * @param context                 Context information containing the principalId
 142  
      *                                and locale information about the caller of service
 143  
      *                                operation
 144  
      * @return List of LUI Person Relation information
 145  
      * @throws DoesNotExistException     One or more luiPersonRelationIds not found
 146  
      * @throws InvalidParameterException One or more invalid
 147  
      *                                   luiPersonRelationIds
 148  
      * @throws MissingParameterException missing luiPersonRelationIdList
 149  
      * @throws OperationFailedException  unable to complete request
 150  
      * @throws PermissionDeniedException authorization failure
 151  
      */
 152  
 
 153  
     @Override
 154  
     public List<LuiPersonRelationInfc> findLuiPersonRelationsByIdList(List<String> luiPersonRelationIdList, ContextInfc context)
 155  
             throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 156  
 
 157  0
         return (getLprService().findLuiPersonRelationsByIdList(luiPersonRelationIdList, context));
 158  
     }
 159  
 
 160  
 
 161  
     /**
 162  
      * Retrieves the LUI Ids for Person related to LUI.
 163  
      *
 164  
      * @param personId              Identifier for the LUI Person Relation
 165  
      * @param luiPersonRelationType Type of LUI Person Relation
 166  
      * @param relationState         Relation State
 167  
      * @param context               Context information containing the principalId
 168  
      *                              and locale information about the caller of service
 169  
      *                              operation
 170  
      * @return Simple list of LUI Ids
 171  
      * @throws DoesNotExistException       personId, luiPersonRelationType,
 172  
      *                                     relationState, person to LUI relationship not found
 173  
      * @throws DisabledIdentifierException personId found, but has been
 174  
      *                                     retired
 175  
      * @throws InvalidParameterException   invalid personId,
 176  
      *                                     luiPersonRelationType, relationState
 177  
      * @throws MissingParameterException   missing personId,
 178  
      *                                     luiPersonRelationType, relationState
 179  
      * @throws OperationFailedException    unable to complete request
 180  
      * @throws PermissionDeniedException   authorization failure
 181  
      */
 182  
 
 183  
     @Override
 184  
     public List<String> findLuiIdsRelatedToPerson(String personId, String luiPersonRelationType, String relationState, ContextInfc context)
 185  
             throws DoesNotExistException, DisabledIdentifierException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 186  
 
 187  0
         return (getLprService().findLuiIdsRelatedToPerson(personId, luiPersonRelationType, relationState, context));
 188  
     }
 189  
 
 190  
 
 191  
     /**
 192  
      * Retrieves Person Ids related to the specified LUI.
 193  
      *
 194  
      * @param luiId                 Identifier for the LUI
 195  
      * @param luiPersonRelationType Type of LUI Person Relation
 196  
      * @param relationState         Relation State
 197  
      * @param context               Context information containing the principalId
 198  
      *                              and locale information about the caller of service
 199  
      *                              operation
 200  
      * @return Simple list of Person Ids
 201  
      * @throws DoesNotExistException     luiId, luiPersonRelationType,
 202  
      *                                   relationState, LUI to person relationship not found
 203  
      * @throws InvalidParameterException invalid luiId,
 204  
      *                                   luiPersonRelationType, relationState
 205  
      * @throws MissingParameterException missing luiId,
 206  
      *                                   luiPersonRelationType, relationState
 207  
      * @throws OperationFailedException  unable to complete request
 208  
      * @throws PermissionDeniedException authorization failure
 209  
      */
 210  
 
 211  
     @Override
 212  
     public List<String> findPersonIdsRelatedToLui(String luiId, String luiPersonRelationType, String relationState, ContextInfc context)
 213  
             throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 214  
 
 215  0
         return (getLprService().findPersonIdsRelatedToLui(luiId, luiPersonRelationType, relationState, context));
 216  
     }
 217  
 
 218  
 
 219  
     /**
 220  
      * Retrieves Person Relation Types for LUI.
 221  
      *
 222  
      * @param personId      Identifier for person
 223  
      * @param luiId         Identifier for LUI
 224  
      * @param relationState Relation State
 225  
      * @param context       Context information containing the principalId
 226  
      *                      and locale information about the caller of service
 227  
      *                      operation
 228  
      * @return Simple list of LUI Person Relation Types
 229  
      * @throws DoesNotExistException       personId, luiId, relationState not found
 230  
      * @throws DisabledIdentifierException personId found, but has been retired
 231  
      * @throws InvalidParameterException   invalid personId, luiId, relationState
 232  
      * @throws MissingParameterException   missing personId, luiId, relationState
 233  
      * @throws OperationFailedException    unable to complete request
 234  
      * @throws PermissionDeniedException   authorization failure
 235  
      */
 236  
 
 237  
     @Override
 238  
     public List<LuiPersonRelationTypeInfc> findLuiPersonRelationTypesForLuiPersonRelation(String personId, String luiId, String relationState, ContextInfc context)
 239  
             throws DoesNotExistException, DisabledIdentifierException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 240  
 
 241  0
         return (getLprService().findLuiPersonRelationTypesForLuiPersonRelation(personId, luiId, relationState, context));
 242  
     }
 243  
 
 244  
 
 245  
     /**
 246  
      * Retrieves Person Relation for LUI.
 247  
      *
 248  
      * @param personId Identifier for person
 249  
      * @param luiId    Identifier for LUI
 250  
      * @param context  Context information containing the principalId
 251  
      *                 and locale information about the caller of service
 252  
      *                 operation
 253  
      * @return List of LUI Person Relation info
 254  
      * @throws DoesNotExistException       personId, luiId not found
 255  
      * @throws DisabledIdentifierException personId found, but has been retired
 256  
      * @throws InvalidParameterException   invalid personId, luiId
 257  
      * @throws MissingParameterException   missing personId, luiId
 258  
      * @throws OperationFailedException    unable to complete request
 259  
      * @throws PermissionDeniedException   authorization failure
 260  
      */
 261  
 
 262  
     @Override
 263  
     public List<LuiPersonRelationInfc> findLuiPersonRelations(String personId, String luiId, ContextInfc context)
 264  
             throws DoesNotExistException, DisabledIdentifierException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 265  
 
 266  0
         return (getLprService().findLuiPersonRelations(personId, luiId, context));
 267  
     }
 268  
 
 269  
 
 270  
     /**
 271  
      * Retrieves LUI Person Relation Ids.
 272  
      *
 273  
      * @param personId Identifier for person
 274  
      * @param luiId    Identifier for LUI
 275  
      * @param context  Context information containing the principalId
 276  
      *                 and locale information about the caller of service
 277  
      *                 operation
 278  
      * @return List of LUI Person Relation display info
 279  
      * @throws DoesNotExistException       personId, luiId not found
 280  
      * @throws DisabledIdentifierException personId found, but has been retired
 281  
      * @throws InvalidParameterException   invalid personId, luiId
 282  
      * @throws MissingParameterException   missing personId, luiId
 283  
      * @throws OperationFailedException    unable to complete request
 284  
      * @throws PermissionDeniedException   authorization failure
 285  
      */
 286  
 
 287  
     @Override
 288  
     public List<String> findLuiPersonRelationIds(String personId, String luiId, ContextInfc context)
 289  
             throws DoesNotExistException, DisabledIdentifierException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 290  
 
 291  0
         return (getLprService().findLuiPersonRelationIds(personId, luiId, context));
 292  
     }
 293  
 
 294  
 
 295  
     /**
 296  
      * Retrieves LUI Person Relation for Person.
 297  
      *
 298  
      * @param personId Identifier for person
 299  
      * @param context  Context information containing the principalId
 300  
      *                 and locale information about the caller of service
 301  
      *                 operation
 302  
      * @return List of LUI Person Relation info
 303  
      * @throws DoesNotExistException       personId not found
 304  
      * @throws DisabledIdentifierException personId found, but has
 305  
      *                                     been retired
 306  
      * @throws InvalidParameterException   invalid personId
 307  
      * @throws MissingParameterException   missing personId
 308  
      * @throws OperationFailedException    unable to complete request
 309  
      * @throws PermissionDeniedException   authorization failure
 310  
      */
 311  
 
 312  
     @Override
 313  
     public List<LuiPersonRelationInfc> findLuiPersonRelationsForPerson(String personId, ContextInfc context)
 314  
             throws DoesNotExistException, DisabledIdentifierException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 315  
 
 316  0
         return (getLprService().findLuiPersonRelationsForPerson(personId, context));
 317  
     }
 318  
 
 319  
 
 320  
     /**
 321  
      * Retrieves LUI Person Relation Ids for Person.
 322  
      *
 323  
      * @param personId Identifier for person
 324  
      * @param context  Context information containing the principalId
 325  
      *                 and locale information about the caller of service
 326  
      *                 operation
 327  
      * @return Simple list of person relation identifiers
 328  
      * @throws DoesNotExistException       personId not found
 329  
      * @throws DisabledIdentifierException personId found, but has been retired
 330  
      * @throws InvalidParameterException   invalid personId
 331  
      * @throws MissingParameterException   missing personId
 332  
      * @throws OperationFailedException    unable to complete request
 333  
      * @throws PermissionDeniedException   authorization failure
 334  
      */
 335  
 
 336  
     @Override
 337  
     public List<String> findLuiPersonRelationIdsForPerson(String personId, ContextInfc context)
 338  
             throws DoesNotExistException, DisabledIdentifierException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 339  
 
 340  0
         return (getLprService().findLuiPersonRelationIdsForPerson(personId, context));
 341  
     }
 342  
 
 343  
 
 344  
     /**
 345  
      * Retrieves LUI Person Relation for a specified LUI.
 346  
      *
 347  
      * @param luiId   Identifier for LUI
 348  
      * @param context Context information containing the principalId
 349  
      *                and locale information about the caller of service
 350  
      *                operation
 351  
      * @return List of LUI Person Relation info
 352  
      * @throws DoesNotExistException     luiId not found
 353  
      * @throws InvalidParameterException invalid luiId
 354  
      * @throws MissingParameterException missing luiId
 355  
      * @throws OperationFailedException  unable to complete request
 356  
      * @throws PermissionDeniedException authorization failure
 357  
      */
 358  
 
 359  
     @Override
 360  
     public List<LuiPersonRelationInfc> findLuiPersonRelationsForLui(String luiId, ContextInfc context)
 361  
             throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 362  
 
 363  0
         return (getLprService().findLuiPersonRelationsForLui(luiId, context));
 364  
     }
 365  
 
 366  
 
 367  
     /**
 368  
      * Retrieves LUIPersonRelation for LUI.
 369  
      *
 370  
      * @param luiId   Identifier for LUI
 371  
      * @param context Context information containing the principalId
 372  
      *                and locale information about the caller of service
 373  
      *                operation
 374  
      * @return Simple list of LUI Person Relation identifiers
 375  
      * @throws DoesNotExistException     luiId not found
 376  
      * @throws InvalidParameterException invalid luiId
 377  
      * @throws MissingParameterException missing luiId
 378  
      * @throws OperationFailedException  unable to complete request
 379  
      * @throws PermissionDeniedException authorization failure
 380  
      */
 381  
 
 382  
     @Override
 383  
     public List<String> findLuiPersonRelationIdsForLui(String luiId, ContextInfc context)
 384  
             throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 385  
 
 386  0
         return (getLprService().findLuiPersonRelationIdsForLui(luiId, context));
 387  
     }
 388  
 
 389  
 
 390  
     /**
 391  
      * Retrieves valid Relation States for LUI Person relation.
 392  
      *
 393  
      * @param personId              Identifier for person
 394  
      * @param luiId                 Identifier for LUI
 395  
      * @param luiPersonRelationType Type of LUI Person Relation
 396  
      * @param context               Context information containing the principalId
 397  
      *                              and locale information about the caller of service
 398  
      *                              operation
 399  
      * @return list of valid relation states
 400  
      * @throws DoesNotExistException       personId, luiId,
 401  
      *                                     luiPersonRelationType not found
 402  
      * @throws DisabledIdentifierException personId found, but has
 403  
      *                                     been retired
 404  
      * @throws InvalidParameterException   invalid personId, luiId,
 405  
      *                                     luiPersonRelationType
 406  
      * @throws MissingParameterException   missing personId, luiId,
 407  
      *                                     luiPersonRelationType
 408  
      * @throws OperationFailedException    unable to complete request
 409  
      * @throws PermissionDeniedException   authorization failure
 410  
      */
 411  
 
 412  
     @Override
 413  
     public List<LuiPersonRelationStateInfc> findValidRelationStatesForLuiPersonRelation(String personId, String luiId, String luiPersonRelationType, ContextInfc context)
 414  
             throws DoesNotExistException, DisabledIdentifierException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 415  
 
 416  0
         return (getLprService().findValidRelationStatesForLuiPersonRelation(personId, luiId, luiPersonRelationType, context));
 417  
     }
 418  
 
 419  
 
 420  
     /**
 421  
      * Checks to see if it's ok to create a particular type and state
 422  
      * of a relation between Person and LUI.
 423  
      *
 424  
      * @param personId              Identifier for person
 425  
      * @param luiId                 Identifier for LUI
 426  
      * @param luiPersonRelationType Type of LUI Person relation
 427  
      * @param relationState         Relation state
 428  
      * @param context               Context information containing the principalId
 429  
      *                              and locale information about the caller of service
 430  
      *                              operation
 431  
      * @return true if relation of specified type and state is ok to
 432  
      *         create between person and lui
 433  
      * @throws DoesNotExistException       personId, luiId,
 434  
      *                                     luiPersonRelationType, relationState not found
 435  
      * @throws DisabledIdentifierException personId found, but has
 436  
      *                                     been retired
 437  
      * @throws InvalidParameterException   invalid personId, luiId,
 438  
      *                                     luiPersonRelationType, relationState
 439  
      * @throws MissingParameterException   missing personId, luiId,
 440  
      *                                     luiPersonRelationType, relationState
 441  
      * @throws OperationFailedException    unable to complete request
 442  
      * @throws PermissionDeniedException   authorization failure
 443  
      */
 444  
 
 445  
     @Override
 446  
     public Boolean isValidLuiPersonRelation(String personId, String luiId, String luiPersonRelationType, String relationState, ContextInfc context)
 447  
             throws DoesNotExistException, DisabledIdentifierException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 448  
 
 449  0
         return (getLprService().isValidLuiPersonRelation(personId, luiId, luiPersonRelationType, relationState, context));
 450  
     }
 451  
 
 452  
 
 453  
     /**
 454  
      * Checks if a Person and LUI have a particular relation in a
 455  
      * particular state.
 456  
      *
 457  
      * @param personId              Identifier for person
 458  
      * @param luiId                 Identifier for LUI
 459  
      * @param luiPersonRelationType Type of LUI Person Relation
 460  
      * @param relationState         Relation state
 461  
      * @param context               Context information containing the principalId
 462  
      *                              and locale information about the caller of service
 463  
      *                              operation
 464  
      * @return true if relation of specified type and state exists
 465  
      *         between person and lui
 466  
      * @throws DoesNotExistException       personId, luiId,
 467  
      *                                     luiPersonRelationType, relationState not found
 468  
      * @throws DisabledIdentifierException personId found, but has
 469  
      *                                     been retired
 470  
      * @throws InvalidParameterException   invalid personId, luiId,
 471  
      *                                     luiPersonRelationType, relationState
 472  
      * @throws MissingParameterException   missing personId, luiId,
 473  
      *                                     luiPersonRelationType, relationState
 474  
      * @throws OperationFailedException    unable to complete request
 475  
      * @throws PermissionDeniedException   authorization failure
 476  
      */
 477  
 
 478  
     @Override
 479  
     public Boolean isRelated(String personId, String luiId, String luiPersonRelationType, String relationState, ContextInfc context)
 480  
             throws DoesNotExistException, DisabledIdentifierException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 481  
 
 482  0
         return (getLprService().isRelated(personId, luiId, luiPersonRelationType, relationState, context));
 483  
     }
 484  
 
 485  
 
 486  
     /**
 487  
      * Validates the particular relation in a state for a Person and
 488  
      * LUI.
 489  
      *
 490  
      * @param personId              Identifier for person
 491  
      * @param luiId                 Identifier for LUI
 492  
      * @param luiPersonRelationType Type of luiPersonRelation
 493  
      * @param relationState         Relation State
 494  
      * @param context               Context information containing the principalId
 495  
      *                              and locale information about the caller of service
 496  
      *                              operation
 497  
      * @return result from validation operation not sure of specifics
 498  
      * @throws DoesNotExistException       personId, luiId,
 499  
      *                                     luiPersonRelationType, relationState not found
 500  
      * @throws DisabledIdentifierException personId found, but has
 501  
      *                                     been retired
 502  
      * @throws InvalidParameterException   invalid personId, luiId,
 503  
      *                                     luiPersonRelationType, relationState
 504  
      * @throws MissingParameterException   missing personId, luiId,
 505  
      *                                     luiPersonRelationType, relationState
 506  
      * @throws OperationFailedException    unable to complete request
 507  
      * @throws PermissionDeniedException   authorization failure
 508  
      */
 509  
 
 510  
     @Override
 511  
     public ValidationResultInfc validateLuiPersonRelation(String personId, String luiId, String luiPersonRelationType, String relationState, ContextInfc context)
 512  
             throws DoesNotExistException, DisabledIdentifierException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 513  
 
 514  0
         return (getLprService().validateLuiPersonRelation(personId, luiId, luiPersonRelationType, relationState, context));
 515  
     }
 516  
 
 517  
 
 518  
     /**
 519  
      * Retrieves LUIs for an academic time period where the specified
 520  
      * relation type and state would be valid for the specified
 521  
      * person.
 522  
      *
 523  
      * @param personId              Identifier for person
 524  
      * @param luiPersonRelationType Type of luiPersonRelationI
 525  
      * @param relationState         Relation State
 526  
      * @param atpId                 Identifier for academic time period
 527  
      * @param context               Context information containing the principalId
 528  
      *                              and locale information about the caller of service
 529  
      *                              operation
 530  
      * @return List of LUIs
 531  
      * @throws DoesNotExistException       personId, luiPersonRelationType,
 532  
      *                                     relationState, atpId not found
 533  
      * @throws DisabledIdentifierException personId found, but has
 534  
      *                                     been retired
 535  
      * @throws InvalidParameterException   invalid personId,
 536  
      *                                     luiPersonRelationType, relationState, atpId
 537  
      * @throws MissingParameterException   missing personId,
 538  
      *                                     luiPersonRelationType, relationState, atpId
 539  
      * @throws OperationFailedException    unable to complete request
 540  
      * @throws PermissionDeniedException   authorization failure
 541  
      */
 542  
 
 543  
     @Override
 544  
     public List<String> findAllValidLuisForPerson(String personId, String luiPersonRelationType, String relationState, String atpId, ContextInfc context)
 545  
             throws DoesNotExistException, DisabledIdentifierException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 546  
 
 547  0
         return (getLprService().findAllValidLuisForPerson(personId, luiPersonRelationType, relationState, atpId, context));
 548  
     }
 549  
 
 550  
 
 551  
     /**
 552  
      * Retrieves the list of people where the specified relation type
 553  
      * and state would be valid for the specified LUI.
 554  
      *
 555  
      * @param luiId                 Identifier for LUI
 556  
      * @param luiPersonRelationType Type of LUI Person Relation
 557  
      * @param relationState         Relation state
 558  
      * @param context               Context information containing the principalId
 559  
      *                              and locale information about the caller of service
 560  
      *                              operation
 561  
      * @return List of people that could have a particular relation
 562  
      *         with a LUI
 563  
      * @throws DoesNotExistException       personId, luiPersonRelationType,
 564  
      *                                     relationState, atpId not found
 565  
      * @throws DisabledIdentifierException personId found, but has
 566  
      *                                     been retired
 567  
      * @throws InvalidParameterException   invalid luiId,
 568  
      *                                     luiPersonRelationType, relationState, atpId
 569  
      * @throws MissingParameterException   missing luiId,
 570  
      *                                     luiPersonRelationType, relationState, atpId
 571  
      * @throws OperationFailedException    unable to complete request
 572  
      * @throws PermissionDeniedException   authorization failure
 573  
      */
 574  
 
 575  
     @Override
 576  
     public List<String> findAllValidPeopleForLui(String luiId, String luiPersonRelationType, String relationState, ContextInfc context)
 577  
             throws DoesNotExistException, DisabledIdentifierException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 578  
 
 579  0
         return (getLprService().findAllValidPeopleForLui(luiId, luiPersonRelationType, relationState, context));
 580  
     }
 581  
 
 582  
 
 583  
     /**
 584  
      * Retrieves an ordered list of the "history" of a particular LUI
 585  
      * Person Relation, including state and date of change.
 586  
      *
 587  
      * @param luiPersonRelationId Identifier for LUI Person Relation
 588  
      * @param context             Context information containing the principalId
 589  
      *                            and locale information about the caller of service
 590  
      *                            operation
 591  
      * @return List of LUI Person Relation info
 592  
      * @throws DoesNotExistException     luiPersonRelationId not found
 593  
      * @throws InvalidParameterException invalid luiPersonRelationId
 594  
      * @throws MissingParameterException missing luiPersonRelationId
 595  
      * @throws OperationFailedException  unable to complete request
 596  
      * @throws PermissionDeniedException authorization failure
 597  
      */
 598  
 
 599  
     @Override
 600  
     public List<LuiPersonRelationInfc> findOrderedRelationStatesForLuiPersonRelation(String luiPersonRelationId, ContextInfc context)
 601  
             throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 602  
 
 603  0
         return (getLprService().findOrderedRelationStatesForLuiPersonRelation(luiPersonRelationId, context));
 604  
     }
 605  
 
 606  
 
 607  
     /**
 608  
      * Retrieves detail of LUI Person Relation Ids.
 609  
      *
 610  
      * @param luiPersonRelationCriteria Criteria to be used for
 611  
      *                                  retrieval of multiple LUI Person Relation identifiers
 612  
      * @param context                   Context information containing the principalId
 613  
      *                                  and locale information about the caller of service
 614  
      *                                  operation
 615  
      * @return Simple list of LUI Person Relation identifiers
 616  
      * @throws InvalidParameterException invalid relation criteria
 617  
      * @throws MissingParameterException missing relation criteria
 618  
      * @throws OperationFailedException  unable to complete request
 619  
      * @throws PermissionDeniedException authorization failure
 620  
      */
 621  
 
 622  
     @Override
 623  
     public List<String> searchForLuiPersonRelationIds(List<CriteriaInfc> criteria, ContextInfc context)
 624  
             throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 625  
 
 626  0
         return (getLprService().searchForLuiPersonRelationIds(criteria, context));
 627  
     }
 628  
 
 629  
 
 630  
     /**
 631  
      * Creates relation between the specified Person and LUI.
 632  
      *
 633  
      * @param personId              Person Identifier
 634  
      * @param luiId                 LUI Identifier
 635  
      * @param luiPersonRelationType Type of LUI to Person Relation
 636  
      * @param luiPersonRelationInfo Information required to create the
 637  
      *                              LUI Person relation
 638  
      * @param context               Context information containing the principalId
 639  
      *                              and locale information about the caller of service
 640  
      *                              operation
 641  
      * @return Structure containing LUI Person relation identifiers
 642  
      * @throws AlreadyExistsException      relation already exists
 643  
      * @throws DoesNotExistException       personId, luiId, relationState,
 644  
      *                                     luiPersonRelationType does not exist
 645  
      * @throws DisabledIdentifierException personId found, but has
 646  
      *                                     been retired
 647  
      * @throws InvalidParameterException   invalid personId, luiId,
 648  
      *                                     relationState, luiPersonRelationType,
 649  
      *                                     luiPersonRelationInfo
 650  
      * @throws MissingParameterException   missing personId, luiId,
 651  
      *                                     relationState, luiPersonRelationType,
 652  
      *                                     luiPersonRelationInfo
 653  
      * @throws OperationFailedException    unable to complete request
 654  
      * @throws PermissionDeniedException   authorization failure
 655  
      */
 656  
 
 657  
     @Override
 658  
     public String createLuiPersonRelation(String personId, String luiId, String luiPersonRelationType, LuiPersonRelationInfc luiPersonRelationInfo, ContextInfc context)
 659  
             throws AlreadyExistsException, DoesNotExistException, DisabledIdentifierException, ReadOnlyException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 660  
 
 661  1
         return (getLprService().createLuiPersonRelation(personId, luiId, luiPersonRelationType, luiPersonRelationInfo, context));
 662  
     }
 663  
 
 664  
 
 665  
     /**
 666  
      * Creates bulk relationships for one specified person. This is an
 667  
      * all or nothing transaction - any error will invalidate the
 668  
      * entire transaction.
 669  
      *
 670  
      * @param personId              Identifier for Person
 671  
      * @param luiIdList             Simple list of LUI identifiers
 672  
      * @param relationState         Relation state
 673  
      * @param luiPersonRelationType Type of LUI Person relation
 674  
      * @param luiPersonRelationInfo Information required to create the
 675  
      *                              LUI Person relation
 676  
      * @param context               Context information containing the principalId
 677  
      *                              and locale information about the caller of service
 678  
      *                              operation
 679  
      * @return Structure containing LUI Person relation identifiers
 680  
      * @throws AlreadyExistsException      relation already exists
 681  
      * @throws DoesNotExistException       personId, luiId, relationState,
 682  
      *                                     luiPersonRelationType does not exist
 683  
      * @throws DisabledIdentifierException personId found, but has
 684  
      *                                     been retired
 685  
      * @throws InvalidParameterException   invalid personId, luiId,
 686  
      *                                     relationState, luiPersonRelationType,
 687  
      *                                     luiPersonRelationInfo
 688  
      * @throws MissingParameterException   missing personId, luiId,
 689  
      *                                     relationState, luiPersonRelationType,
 690  
      *                                     luiPersonRelationInfo
 691  
      * @throws OperationFailedException    unable to complete request
 692  
      * @throws PermissionDeniedException   authorization failure
 693  
      */
 694  
 
 695  
     @Override
 696  
     public List<String> createBulkRelationshipsForPerson(String personId, List<String> luiIdList, String relationState, String luiPersonRelationType, LuiPersonRelationInfc luiPersonRelationInfo, ContextInfc context)
 697  
             throws AlreadyExistsException, DoesNotExistException, DisabledIdentifierException, ReadOnlyException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 698  
 
 699  1
         return (getLprService().createBulkRelationshipsForPerson(personId, luiIdList, relationState, luiPersonRelationType, luiPersonRelationInfo, context));
 700  
     }
 701  
 
 702  
 
 703  
     /**
 704  
      * Update relation between Person and LUI.
 705  
      *
 706  
      * @param luiPersonRelationId   Identifier for the LUI Person
 707  
      *                              Relation
 708  
      * @param luiPersonRelationInfo Changed information about the LUI
 709  
      *                              Person Relation
 710  
      * @param context               Context information containing the principalId
 711  
      *                              and locale information about the caller of service
 712  
      *                              operation
 713  
      * @return Updated information about the LUI Person Relation
 714  
      * @throws DoesNotExistException     luiPersonRelationId does not
 715  
      *                                   exist
 716  
      * @throws InvalidParameterException invalid luiPersonRelationId,
 717  
      *                                   luiPersonRelationInfo
 718  
      * @throws MissingParameterException missing luiPersonRelationId,
 719  
      *                                   luiPersonRelationInfo
 720  
      * @throws ReadOnlyException         attempt to update a read only attribute
 721  
      * @throws OperationFailedException  unable to complete request
 722  
      * @throws PermissionDeniedException authorization failure
 723  
      */
 724  
 
 725  
     @Override
 726  
     public LuiPersonRelationInfc updateLuiPersonRelation(String luiPersonRelationId, LuiPersonRelationInfc luiPersonRelationInfo, ContextInfc context)
 727  
             throws DoesNotExistException, InvalidParameterException, MissingParameterException, ReadOnlyException, OperationFailedException, PermissionDeniedException, VersionMismatchException {
 728  
 
 729  1
         return (getLprService().updateLuiPersonRelation(luiPersonRelationId, luiPersonRelationInfo, context));
 730  
     }
 731  
 
 732  
 
 733  
     /**
 734  
      * Deletes relation between the specified Person and LUI.
 735  
      *
 736  
      * @param luiPersonRelationId Identifier for the LUI Person Relation
 737  
      * @param context             Context information containing the principalId
 738  
      *                            and locale information about the caller of service
 739  
      *                            operation
 740  
      * @return status of the operation (success, failed)
 741  
      * @throws DoesNotExistException     luiPersonRelationId does not exist
 742  
      * @throws InvalidParameterException invalid luiPersonRelationId
 743  
      * @throws MissingParameterException missing luiPersonRelationId
 744  
      * @throws OperationFailedException  unable to complete request
 745  
      * @throws PermissionDeniedException authorization failure
 746  
      */
 747  
 
 748  
     @Override
 749  
     public StatusInfc deleteLuiPersonRelation(String luiPersonRelationId, ContextInfc context) throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException {
 750  
 
 751  2
         return (getLprService().deleteLuiPersonRelation(luiPersonRelationId, context));
 752  
     }
 753  
 
 754  
 
 755  
     /**
 756  
      * Update relation state.
 757  
      *
 758  
      * @param luiPersonRelationId Identifier for the LUI Person Relation
 759  
      * @param relationState       Relation state
 760  
      * @param context             Context information containing the principalId
 761  
      *                            and locale information about the caller of service
 762  
      *                            operation
 763  
      * @return status of the operation (success or failure)
 764  
      * @throws DoesNotExistException     luiPersonRelationId,
 765  
      *                                   relationState does not exist
 766  
      * @throws InvalidParameterException invalid luiPersonRelationId,
 767  
      *                                   relationState
 768  
      * @throws MissingParameterException missing luiPersonRelationId,
 769  
      *                                   relationState
 770  
      * @throws OperationFailedException  unable to complete request
 771  
      * @throws PermissionDeniedException authorization failure
 772  
      */
 773  
 
 774  
     @Override
 775  
     public StatusInfc updateRelationState(String luiPersonRelationId, LuiPersonRelationStateInfc relationState, ContextInfc context)
 776  
             throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException, ReadOnlyException {
 777  
 
 778  0
         return (getLprService().updateRelationState(luiPersonRelationId, relationState, context));
 779  
     }
 780  
 }