/**

  * Copyright 2010 The Kuali Foundation

  *

  *  Licensed under the the Educational Community License, Version 1.0

  * (the "License"); you may not use this file except in compliance

  * with the License.  You may obtain a copy of the License at

  *

  * http://www.opensource.org/licenses/ecl1.php

  *

  * Unless required by applicable law or agreed to in writing, software

  * distributed under the License is distributed on an "AS IS" BASIS,

  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  * See the License for the specific language governing permissions and

  * limitations under the License.

  */

 package org.kuali.student.enrollment.lui.service;

 import java.util.List;

 import javax.jws.WebParam;

 import javax.jws.WebService;

 import javax.jws.soap.SOAPBinding;

 import org.kuali.rice.core.api.criteria.QueryByCriteria;

 import org.kuali.student.enrollment.lui.dto.LuiInfo;

 import org.kuali.student.enrollment.lui.dto.LuiLuiRelationInfo;

 import org.kuali.student.enrollment.lui.dto.LuiCapacityInfo;

 import org.kuali.student.r2.common.dto.ContextInfo;

 import org.kuali.student.r2.common.dto.StatusInfo;

 import org.kuali.student.r2.common.dto.ValidationResultInfo;

 import org.kuali.student.r2.common.exceptions.CircularRelationshipException;

 import org.kuali.student.r2.common.exceptions.DataValidationErrorException;

 import org.kuali.student.r2.common.exceptions.DependentObjectsExistException;

 import org.kuali.student.r2.common.exceptions.DoesNotExistException;

 import org.kuali.student.r2.common.exceptions.InvalidParameterException;

 import org.kuali.student.r2.common.exceptions.MissingParameterException;

 import org.kuali.student.r2.common.exceptions.OperationFailedException;

 import org.kuali.student.r2.common.exceptions.PermissionDeniedException;

 import org.kuali.student.r2.common.exceptions.ReadOnlyException;

 import org.kuali.student.r2.common.exceptions.VersionMismatchException;

 import org.kuali.student.r2.common.util.constants.LuiServiceConstants;

 /**

  * Learning Unit Instance (LUI) Service

  *

  * Manages the creation of Instances of the canonical Learning unit.

  * An instance is associated with a particular time period during

  * which is is offered.

  *

  * This includes course and section offerings as well as program

  * offerings

  * 

  * @version 1.0 (Dev)

  *

  * @author tom

  */

 @WebService(name = "LuiService", serviceName ="LuiService", portName = "LuiService", targetNamespace = LuiServiceConstants.NAMESPACE)

 @SOAPBinding(style = SOAPBinding.Style.DOCUMENT, use = SOAPBinding.Use.LITERAL, parameterStyle = SOAPBinding.ParameterStyle.WRAPPED)

 public interface LuiService {

     /**

      * Retrieves a single Lui by a Lui Id.

      *

      * @param luiId the identifier for the Lui to be retrieved

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return the Lui requested

      * @throws DoesNotExistException luiId not found

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiId or contextInfo is

      *         missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public LuiInfo getLui(@WebParam(name = "luiId") String luiId, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves a list of Luis from a list of Lui Ids. The

      * returned list may be in any order and if duplicates Ids are

      * supplied, a unique set may or may not be returned.

      *

      * @param luiIds a list of Lui identifiers

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return a list of Luis

      * @throws DoesNotExistException a luiId in the list was not found

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiIds, an Id in luiIds, or

      *         contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<LuiInfo> getLuisByIds(@WebParam(name = "luiIds") List<String> luiIds, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves a list of Lui Ids by Lui Type.

      *

      * @param luiTypeKey an identifier for a Lui Type

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return a list of Lui identifiers matching luiTypeKey or an

      *         empty list if none found

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiTypeKey or contextInfo is

      *         missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<String> getLuiIdsByType(@WebParam(name = "luiTypeKey") String luiTypeKey, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /** 

      * Retrieves a list of Lui Ids by Clu.

      * (the pattern says this should return the objects).

      *

      * @param cluId an identifier for the Clu

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return list of Lui Ids for the Clu

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException cluId or contextInfo is

      *         missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<String> getLuiIdsByClu(@WebParam(name = "cluId") String cluId, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves the list of Lui Ids for the specified atp and Lui

      * Type.

      *

      * @param atpId an identifier for the Atp

      * @param luiTypeKey an identifier for the Lui Type

      * @param contextInfo information containing the principalId and

      *       locale information about the caller of service operation

      * @return a list of identifiers of Luis offered in the given Atp

      *         of the specified luiType

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException atpId, luiTypeKey, or contextInfo

      *         is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<String> getLuiIdsByAtpAndType(@WebParam(name = "atpId") String atpId, @WebParam(name = "luiTypeKey") String luiTypeKey, @WebParam(name = "contextInfo") ContextInfo context ) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves the list of Lui Ids for the specified Clu and Time

      * period.

      *

      * @param cluId an identifier for the Clu

      * @param atpId an identifier for the Atp

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return a list of identifiers of Luis offered in atpId and

      *         related to cluId

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException cluId, atpId, or contextInfo

      *         is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<String> getLuiIdsByAtpAndClu(@WebParam(name = "cluId") String cluId, @WebParam(name = "atpId") String atpId, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves the list of Luis for the specified Clu and Atp.

      *

      * @param cluId an identifier for the Clu

      * @param atpId an identifier for the Atp

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return a list of Luis offered in atpId and related to cluId

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException cluId, atpId, or contextInfo

      *         is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<LuiInfo> getLuisByAtpAndClu(@WebParam(name = "cluId") String cluId, @WebParam(name = "atpId") String atpId, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Searches for Luis that meet the given search criteria and

      * returns a list of Lui identifiers that meet the criteria.

      * 

      * @param criteria the search criteria

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return a list of Lui Ids matching the criteria

      * @throws InvalidParameterException criteria or contextInfo is

      *         not valid

      * @throws MissingParameterException criteria or contextInfo is

      *         missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<String> searchForLuiIds(@WebParam(name = "criteria") QueryByCriteria criteria, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Searches for Luis that meet the given search criteria.

      * 

      * @param criteria the search criteria

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return a list of Luis matching the criteria

      * @throws InvalidParameterException criteria or contextInfo is

      *         not valid

      * @throws MissingParameterException criteria or contextInfo is

      *         missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<LuiInfo> searchForLuis(@WebParam(name = "criteria") QueryByCriteria criteria, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Validates a Lui. Depending on the value of validationType, this

      * validation could be limited to tests on just the current Lui

      * and its directly contained sub-objects or expanded to perform

      * all tests related to this Lui. If an identifier is present for

      * the Lui (and/or one of its contained sub-objects) and a record

      * is found for that identifier, the validation checks if the Lui

      * can be updated to the new values. If an identifier is not

      * present or a record does not exist, the validation checks if

      * the object with the given data can be created.

      *

      * @param validationTypeKet the identifier for the validation Type

      * @param cluId the identifier for the Clu to which the Lui is

      *        attached

      * @param atpId the identifier for the Atp to which the Lui if

      *        offered

      * @param luiTypeKey the identifier for the Lui Type

      * @param luiInfo the object to be validated

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return a list of validation results or an empty list if

      *         validation succeeded

      * @throws DoesNotExistException validationTypeKey, cluId, atpId,

      *         or luiTypeKey is not found

      * @throws InvalidParameterException luiInfo or contextInfo is not

      *         valid

      * @throws MissingParameterException validationTypeKey, cluId,

      *         atpId, luiTypeKey, luiInfo, or contextInfo is missing

      *         or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<ValidationResultInfo> validateLui(@WebParam(name = "validationTypeKey") String validationTypeKey, @WebParam(name = "cluId") String cluId, @WebParam(name="atpId") String atpId, @WebParam(name = "luiTypeKey") String luiTypeKey, @WebParam(name = "luiInfo") LuiInfo luiInfo, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;;

     /**

      * Creates a new LUI. The Lui Id, Type, Clu Id, Atp Id, and Meta

      * information may not be set in the supplied data.

      *

      * @param cluId the identifier for the Clu

      * @param atpId the identifier for the Atp

      * @param luiTypeKey an identifier for the Type of the new Lui

      * @param luiInfo the data with which to create the Lui

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return the new Lui

      * @throws DataValidationErrorException supplied data is invalid

      * @throws DoesNotExistException cluId, atpId, or luiTypeKey is

      *         not found

      * @throws InvalidParameterExceptionluiInfo or contextInfo is not valid

      * @throws MissingParameterException cluId, atpId, luiTypeKey,

      *         luiInfo, or contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      * @throws ReadOnlyException an attempt at supplying information

      *         designated as read only

      */

     public LuiInfo createLui(@WebParam(name = "cluId") String cluId, @WebParam(name = "atpId") String atpId, @WebParam(name = "luiTypeKey") String luiTypeKey, @WebParam(name = "luiInfo") LuiInfo luiInfo, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DataValidationErrorException, DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException, ReadOnlyException;

     /**

      * Updates an existing Lui. The Lui Id, Type, Clu Id, Atp Id, and

      * Meta information may not be changed.

      *

      * @param luiId the identifier for the LUI to be updated

      * @param luiInfo the new data for the Lui

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return the updated Lui

      * @throws DataValidationErrorException supplied data is invalid

      * @throws DoesNotExistException luiId not found

      * @throws InvalidParameterException luiInfo or contextInfo is not valid

      * @throws MissingParameterException luiId, luiInfo, or

      *         contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      * @throws ReadOnlyException an attempt at changing information

      *         designated as read only

      * @throws VersionMismatchException optimistic locking failure or

      *         the action was attempted on an out of date version

      */

     public LuiInfo updateLui(@WebParam(name = "luiId") String luiId, @WebParam(name = "luiInfo") LuiInfo luiInfo, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DataValidationErrorException, DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException, ReadOnlyException, VersionMismatchException;

     /**

      * Deletes an existing Lui.

      *

      * @param luiId the identifier for the LUI to be deleted

      * @param contextInfoinformation containing the principalId and

      *        locale information about the caller of service operation

      * @return the status of the delete operation. This must always be true.

      * @throws DependentObjectsExistException the delete operation

      *         would leave orphaned objects or violate integrity

      *         constraints

      * @throws DoesNotExistException luiId not found

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiId or contextInfo is

      *         missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public StatusInfo deleteLui(@WebParam(name = "luiId") String luiId, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DependentObjectsExistException, DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves a single LuiLuiRelation by a LuiLuiRelation Id.

      *

      * @param luiLuiRelationId a unique identifier for the

      *        LuiLuiRelation to be retrieved

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return the LuiLuiRelation requested

      * @throws DoesNotExistException luiLuiRelationId is not found

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiLuiRetaionId or

      *         contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public LuiLuiRelationInfo getLuiLuiRelation(@WebParam(name = "luiLuiRelationId") String luiLuiRelationId, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves a list of LuiLuiRelations from a list of

      * LuiLuiRelation Ids. The returned list may be in any order and

      * if duplicates Ids are supplied, a unique set may or may not be

      * returned.

      *

      * @param luiLuiRelationIds a list of LuiLuiRelation identifiers

      * @param context Context information containing the principalId

      *                and locale information about the caller of

      *                service operation

      * @return information about a list of LuiLuiRelations

      * @throws DoesNotExistException a luiLuiRelationId in the list

      *         was not found

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiLuiRelationIds, a

      *         luiLuiRelationId in luiLuiRelationIds, or contextInfo

      *         is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<LuiLuiRelationInfo> getLuiLuiRelationsByIds(@WebParam(name = "luiLuiRelationIds") List<String> luiLuiRelationIds, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves a list of LuiLuiRelation Ids by a LuiLuiRelation

      * Type.

      *

      * @param luiLuiRelationTypeKey an identifier for a LuiLuiRelation

      *                              Type

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return a list of LuiLuiRelation identifiers

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiLuiRelationTypeKey or

      *         contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<String> getLuiLuiRelationIdsByType(@WebParam(name = "luiLuiRelationTypeKey") String luiLuiRelationTypeKey, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves all LuiLuiRelations to the given Lui.

      *

      * @param luiId a unique identifier of the LUI

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return the LuiLuiRelations to the Lui

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiId or contextInfo is

      *         missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<LuiLuiRelationInfo> getLuiLuiRelationsByLui(@WebParam(name = "luiId") String luiId, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves all LuiLuiRelations between the given Luis.

      *

      * @param luiId a unique identifier of the LUI

      * @param relatedLuiId a unique identifier of another LUI

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return the LuiLuiRelations netween the given Luis

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiId, relatedLuiid, or

      *         contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<LuiLuiRelationInfo> getLuiLuiRelationsByLuis(@WebParam(name = "luiId") String luiId, @WebParam(name="relatedLuiId") String relatedLuiId, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves a list of LUI Ids for the specified related LUI Id

      * and LU to LU relation type (getRelatedLuiIdsByLuiId from the

      * other direction). 

      *

      * (??? this method seems unnecessary)

      *

      * @param relatedLuiId identifier of the LUI

      * @param luiLuiRelationTypeKey the LU to LU relation type

      * @param context Context information containing the principalId

      *        and locale information about the caller of service

      *        operation

      * @return list of LUI identifiers, empty list of none found

      * @throws InvalidParameterException invalid parameter

      * @throws MissingParameterException missing parameter

      * @throws OperationFailedException  unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<String> getLuiIdsByRelation(@WebParam(name = "relatedLuiId") String relatedLuiId, @WebParam(name = "luiLuiRelationTypeKey") String luiLuiRelationTypeKey, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /** TODO 

      * Retrieves the list of LUI information for the LUIs related to

      * the specified LUI Id with a certain LU to LU relation type.

      * (getRelatedLuisByLuiId from the other direction)

      *

      * @param relatedLuiId identifier of the LUI

      * @param luiLuiRelationTypeKey the LU to LU relation type

      * @param context Context information containing the principalId

      *        and locale information about the caller of service

      *        operation

      * @return list of LUI information, empty list if none

      * @throws InvalidParameterException invalid parameter

      * @throws MissingParameterException missing paremeter

      * @throws OperationFailedException  unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<LuiInfo> getLuisByRelatedLuiAndRelationType(@WebParam(name = "relatedLuiId") String relatedLuiId, @WebParam(name = "luiLuiRelationTypeKey") String luiLuiRelationTypeKey, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /** TODO ???

      * Retrieves the list of related LUI Ids for the specified LUI Id

      * and LU to LU relation type. (getLuiIdsByRelation from the other

      * direction).

      *

      * @param luiId identifier of the LUI

      * @param luiLuiRelationTypeKey the LU to LU relation type

      * @param context Context information containing the principalId

      *        and locale information about the caller of service

      *        operation

      * @return list of LUI identifier, empty list if none found

      * @throws InvalidParameterException invalid parameter

      * @throws MissingParameterException missing parameter

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<String> getLuiIdsByRelatedLuiAndRelationType(@WebParam(name = "luiId") String luiId, @WebParam(name = "luiLuiRelationTypeKey") String luiLuiRelationTypeKey, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /** TODO ???

      * Retrieves the list of related LUI information for the specified

      * LUI Id and LU to LU relation type (getLuisByRelatedLuiAndRelationType from the

      * other direction).

      *

      * @param luiId identifier of the LUI

      * @param luiLuiRelationTypeKey the LU to LU relation type

      * @param context Context information containing the principalId

      *        and locale information about the caller of service

      *        operation

      * @return list of LUI information, empty list if none found

      * @throws InvalidParameterException invalid luiId, luiLuiRelationTypeKey

      * @throws MissingParameterException missing luiId, luiLuiRelationTypeKey

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<LuiInfo> getRelatedLuisByLuiAndRelationType(@WebParam(name = "luiId") String luiId, @WebParam(name = "luiLuiRelationTypeKey") String luiLuiRelationTypeKey, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves all LuiLuiRelations between a Lui and Luis of the

      * given Lui Type.

      *

      * @param luiId a unique identifier for the Lui

      * @param relatedLuiTypeKey a unique identifier for a Lui Type

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return a list of LuiLuiRelations between luiId and Luis of

      *         relatedLuiTypeKey

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiId, relatedLuiTypeKey, or

      *         contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<LuiInfo> getLuiLuiRelationsByLuiAndLuiType(@WebParam(name = "luiId") String luiId, @WebParam(name = "relatedLuiTypeKey") String relatedLuiTypeKey, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Searches for LuiLuiRelations that meet the search criteria and

      * returns a list of LuiLuiRelation identifiers that meet the

      * criteria.

      * 

      * @param criteria the search criteria

      * @param contextInfoinformation containing the principalId and

      *        locale information about the caller of service operation

      * @return list of LuiLuiRelationIds

      * @throws InvalidParameterException criteria or contextInfo is

      *         not valid

      * @throws MissingParameterException criteria or contextInfo is

      *         missing os null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<String> searchForLuiLuiRelationIds(@WebParam(name = "criteria") QueryByCriteria criteria, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Searches for LuiLuiRelations that meet the search criteria and

      * returns a list of LuiLuiRelations that meet the criteria.

      * 

      * @param criteria the search criteria

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return list of LuiLuiRelations

      * @throws InvalidParameterException criteria or contextInfo is

      *         not valid

      * @throws MissingParameterException criteria or contextInfo is

      *         missing os null

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<LuiLuiRelationInfo> searchForLuiLuiRelations(@WebParam(name = "criteria") QueryByCriteria criteria, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Validates a LuiLuiRelations. Depending on the value of

      * validationType, this validation could be limited to tests on

      * just the current LuiLuiRelation and its directly contained

      * sub-objects or expanded to perform all tests related to this

      * LuiLuiRelation. If an identifier is present for the

      * LuiLuiRelation (and/or one of its contained sub-objects) and a

      * record is found for that identifier, the validation checks if

      * the LuiLuiRelation can be updated to the new values. If an

      * identifier is not present or a record does not exist, the

      * validation checks if the object with the given data can be

      * created.

      *

      * @param validationTypeKey the identifier for the validation Type

      * @param luiId the identifier for the Lui 

      * @param relatedLuiId the identifier for the related Lui 

      * @param luiLuiRelationTypeKey the identifier for LuiLuiRelation Type

      * @param luiLuiRelationInfo the LuiLuiRelation to ve validated

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return a list of validation results or an empty list if

      *         validation succeeded

      * @throws DoesNotExistException validationTypeKey, luiId,

      *         relatedLuiId, or luiLuiRelationTypeKey is not found

      * @throws InvalidParameterException luiLuiRelationInfo or

      *         contextInfo is missing or null

      * @throws MissingParameterException validationTypeKey, luiId,

      *         relatedLuiId, luiLuiRelationTypeKey,

      *         luiLuiRelationInfo, or contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<ValidationResultInfo> validateLuiLuiRelation(@WebParam(name = "validationTypeKey") String validationTypeKey, @WebParam(name = "luiId") String luiId, @WebParam(name = "relatedLuiId") String relatedLuiId, @WebParam(name = "luiLuiRelationTypeKey") String luiLuiRelationTypeKey, @WebParam(name = "luiLuiRelationInfo") LuiLuiRelationInfo luiLuiRelationInfo, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;;

     /**

      * Create new LuiLuiRelation. The LuiLuiRelation Id, Type, luiId,

      * relatedLuiId, and Meta information may not be set in the

      * supplied data.

      *

      * @param luiId identifier of the first LUI in the relationship

      * @param relatedLuiId identifier of the second LUI in the

      *        relationship to be related

      * @param luiLuiRelationTypeKey a unique key fo rthe Type or new

      *        LuiLuiRelation

      * @param luiLuiRelationInfo the data with which to create the

      *        LuiLuiRelation

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return the new LuiLuiRelation

      * @throws CircularRelationshipException luiId equals relatedLuiId 

      *         (why is this a contract failure?)

      * @throws DataValidationErrorException supplied data is invalid

      * @throws DoesNotExistException luiId, relatedLuiId, or

      *         luiLuiRelationTypeKey is not found

      * @throws InvalidParameterException luiLuiRelationInfo ro

      *         contextInfo is not valid

      * @throws MissingParameterException luiId, relatedLuiId,

      *         luiLuiRelationTypeKey, luiLuiRelationInfo, or

      *         contextInfo is missing or null

      * @throws OperationFailedException  unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      * @throws ReadOnlyException an attempt at supplying information

      *         designated as read only

      */

     public LuiLuiRelationInfo createLuiLuiRelation(@WebParam(name = "luiId") String luiId,  @WebParam(name = "relatedLuiId") String relatedLuiId, @WebParam(name = "luiLuiRelationTypeKey") String luiLuiRelationTypeKey, @WebParam(name = "luiLuiRelationInfo") LuiLuiRelationInfo luiLuiRelationInfo, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws CircularRelationshipException, DataValidationErrorException, DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException, ReadOnlyException;

     /**

      * Updates an existing LuiLuiRelation. The LuiLuiRelation Id,

      * luiId, relatedLuiId, and Meta information may not be changed.

      *

      * @param luiLuiRelationId the identifier for the LuiLuirelation

      *        to be updated

      * @param luiLuiRelationInfo the new data for the LuiLuiRelation

      * @param context information containing the principalId and

      *        locale information about the caller of service operation

      * @return the updated LuiLuiRelation

      * @throws DataValidationErrorException supplied data is invalid

      * @throws DoesNotExistException luiLuiRelationId is not found

      * @throws InvalidParameterException luiLuiRelationInfo or contextInfo

      *         is not valid

      * @throws MissingParameterExceptionluiLuiRelationId,

      *         luiLuiRelationInfo, or contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      * @throws ReadOnlyException an attempt at changing information

      *         designated as read only

      * @throws VersionMismatchException optimistic locking failure or

      *         the action was attempted on an out of date version

      */

     public LuiLuiRelationInfo updateLuiLuiRelation(@WebParam(name = "luiLuiRelationId") String luiLuiRelationId, @WebParam(name = "luiLuiRelationInfo") LuiLuiRelationInfo luiLuiRelationInfo, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DataValidationErrorException, DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException, ReadOnlyException, VersionMismatchException;

     /**

      * Deletes an existing LuiLuiRelation.

      *

      * @param luiLuiRelationId identifier or the LuiLuirelation to be

      *        deleted

      * @param context information containing the principalId and

      *        locale information about the caller of service operation

      * @return the status of the delete operation. This must always be true.

      * @throws DoesNotExistException luiLuiRelationId not found

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiLuiRelationId

      *         or contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public StatusInfo deleteLuiLuiRelation(@WebParam(name = "luiLuiRelationId") String luiLuiRelationId, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves a single LuiCapacity by a LuiCapacity Id.

      *

      * @param luiCapacityId the identifier for the LuiCapacity to be

      *        retrieved

      * @param contextInfo information containing the principalId and

      *        locale information about the caller of service operation

      * @return the LuiCapacity requested

      * @throws DoesNotExistException luiCapacityId not found

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiCapacityId or contextInfo

      *         is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public LuiCapacityInfo getLuiCapacity(@WebParam(name = "luiCapacityId") String luiCapacityId, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves a list of LuiCapacity from a list of LuiCapacity

      * Ids. The returned list may be in any order and if duplicate Ids

      * are supplied, a unique set may or may not be returned.

      *

      * @param luiCapacityIds a list of LuiCapacity identifiers

      * @param context information containing the principalId and

      *        locale information about the caller of service operation

      * @return a list of LuiCapacities

      * @throws DoesNotExistException a luiCapacityId in the list was

      *         not found

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiCapacityIds, an Id in

      *         luiCapacityIds, or contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<LuiCapacityInfo> getLuiCapacitiesByIds(@WebParam(name = "luiCapacityIds") List<String> luiCapacityIds, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves a list of LuiCapacity Ids by LuiCapacity Type.

      *

      * @param luiCapacityTypeKey a unique identifier for a LuiCapacity Type

      * @param context information containing the principalId and

      *        locale information about the caller of service operation

      * @return information about a list of Lui Capacities

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiCapacityTypeKey or

      *         contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<String> getLuiCapacityIdsByType(@WebParam(name = "luiCapacityTypeKey") String luiCapacityTypeKey, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Retrieves LuiCapacities associated with a Lui.

      *

      * @param luiId a unique identifier for a Lui

      * @param context information containing the principalId and

      *        locale information about the caller of service operation

      * @return a list of LuiCapacities associated with the given Lui

      * @throws InvalidParameterException contextInfo is not valid

      * @throws MissingParameterException luiId or contextInfo is

      *         missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<LuiCapacityInfo> getLuiCapacitiesByLui(@WebParam(name = "luiId") String luiId, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Searches for LuiCapacities that meet the search criteria and

      * returns a list of LuiCapacity identifiers that meet the

      * criteria.

      * 

      * @param criteria the search criteria

      * @param context information containing the principalId and

      *        locale information about the caller of service operation

      * @return list of LuiCapacity Ids

      * @throws InvalidParameterException criteria or contextInfo is

      *         not valid

      * @throws MissingParameterException criteria or contextInfo is

      *         missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<String> searchForLuiCapacityIds(@WebParam(name = "criteria") QueryByCriteria criteria, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Searches for LuiCapacities that meet the search criteria and

      * returns a list of LuiCapacities that meet the criteria.

      * 

      * @param criteria the search criteria

      * @param context information containing the principalId and

      *        locale information about the caller of service operation

      * @return list of LuiCapacitiess

      * @throws InvalidParameterException criteria or contextInfo is

      *         not valid

      * @throws MissingParameterException criteria or contextInfo is

      *         missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<LuiCapacityInfo> searchForLuiCapacities(@WebParam(name = "criteria") QueryByCriteria criteria, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      *  Validates a LuiCapacity. Depending on the value of

      *  validationType, this validation could be limited to tests on

      *  just the current LuiCapacity and its directly contained

      *  sub-objects or expanded to perform all tests related to this

      *  LuiCapacity. If an identifier is present for the LuiCapacity

      *  (and/or one of its contained sub-objects) and a record is

      *  found for that identifier, the validation checks if the

      *  LuiCpacity can be updated to the new values. If an identifier

      *  is not present or a record does not exist, the validation

      *  checks if the object with the given data can be created.

      *

      * @param validationTypeKey the identifier for the validation Type

      * @param luiCapacityInfo the LuiCapacity to be validated

      * @param context information containing the principalId and

      *        locale information about the caller of service operation

      * @return a list of validation results or an empty list if validation succeeded

      * @throws DoesNotExistException validationTypeKey or

      *        luiCapacityTypeKey not found

      * @throws InvalidParameterException luiInfo or contextInfo is not

      *         valid

      * @throws MissingParameterException validationTypeKey, luiInfo,

      *         or contextInfo is missing or null

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public List<ValidationResultInfo> validateLuiCapacity(@WebParam(name = "validationTypeKey") String validationTypeKey, @WebParam(name = "luiCapacityTypeKey") String luiCapacityTypeKey, @WebParam(name = "luiCapacityInfo") LuiCapacityInfo luiCapacityInfo, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

     /**

      * Creates a new LuiCapacity. The LuiCapacity Id, Type, and Meta

      * information may not be set in the supplied data.

      *

      * @param luiCapacityTypeKey an identifier for the Type of the new

      *        LuiCapacity

      * @param luiCapacityInfo the data with which to create the

      *        LuiCapacity

      * @param context information containing the principalId and

      *        locale information about the caller of service operation

      * @return the new LuiCapacity

      * @throws DataValidationErrorException supplied data is invalid

      * @throws DoesNotExistException luiCapacityTypeKey not found

      * @throws InvalidParameterException luiCapacityInfo or

      *         contextInfo is not valid

      * @throws MissingParameterException luiCapacityTypeKey,

      *         luiCapacityInfo, or contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      * @throws ReadOnlyException an attempt at supplying information

      *         designated as read only

      */

     public LuiCapacityInfo createLuiCapacity(@WebParam(name = "luiCapacityTypeKey") String luiCapacityTypeKey, @WebParam(name = "luiCapacityInfo") LuiCapacityInfo luiCapacityInfo, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DataValidationErrorException, DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException, ReadOnlyException;

     /**

      * Updates an existing LuiCapacity. The LuiCapacity Id, Type, and

      * Meta information may not be changed.

      *

      * @param luiCapacityId the identifier for the LuiCapacity to be

      *        updated

      * @param luiCapacityInfo the new data for the LuiCapacity

      * @param context information containing the principalId and

      *        locale information about the caller of service operation

      * @return the updated LuiCapacity

      * @throws DataValidationErrorException supplied data is invalid

      * @throws DoesNotExistException luiCapacityId not found

      * @throws InvalidParameterException luiCapacityInfo or contextInfo

      *         is not valid

      * @throws MissingParameterException luiCapacityId,

      *         luiCapacityInfo, or contextInfo is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      * @throws ReadOnlyException an attempt at changing information

      *         designated as read only

      * @throws VersionMismatchException optimistic locking failure or

      *         the action was attempted on an out of date version

      */

     public LuiCapacityInfo updateLuiCapacity(@WebParam(name = "luiCapacityId") String luiCapacityId, @WebParam(name = "luiCapacityInfo") LuiCapacityInfo luiCapacityInfo, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DataValidationErrorException, DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException, ReadOnlyException, VersionMismatchException;

     /**

      * Deletes an existing LuiCapacity.

      *

      * @param luiCapacityId the identifier for the LuiCapacity to be

      *        deleted

      * @param context information containing the principalId and

      *        locale information about the caller of service operation

      * @return the status of the delete operation. This must always be

      *         true.

      * @throws DoesNotExistException luiCapacityId not found

      * @throws InvalidParameterException contextInfo is invalid

      * @throws MissingParameterException luiCapacityId or contextInfo

      *         is missing or null

      * @throws OperationFailedException unable to complete request

      * @throws PermissionDeniedException an authorization failure occurred

      */

     public StatusInfo deleteLuiCapacity(@WebParam(name = "luiCapacityId") String luiCapacityId, @WebParam(name = "contextInfo") ContextInfo contextInfo) throws DoesNotExistException, InvalidParameterException, MissingParameterException, OperationFailedException, PermissionDeniedException;

 }