a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * Copyright (c) 2006 Sun Microsystems Inc. All Rights Reserved
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * The contents of this file are subject to the terms
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * of the Common Development and Distribution License
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * (the License). You may not use this file except in
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * compliance with the License.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * You can obtain a copy of the License at
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * https://opensso.dev.java.net/public/CDDLv1.0.html or
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * See the License for the specific language governing
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * permission and limitations under the License.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * When distributing Covered Code, include this CDDL
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * Header Notice in each file and include the License file
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * If applicable, add the following below the CDDL Header,
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * with the fields enclosed by brackets [] replaced by
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * your own identifying information:
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * "Portions Copyrighted [year] [name of copyright owner]"
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * $Id: RequestedService.java,v 1.2 2008/06/25 05:47:11 qcheng Exp $
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport com.sun.identity.liberty.ws.disco.common.DiscoConstants;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport com.sun.identity.liberty.ws.disco.common.DiscoUtils;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * The class <code>RequestedService</code> enables the requester to specify
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * that all the resource offerings returned must be offered via a service
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * instance complying with one of the specified service type.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * <p>The following schema fragment specifies the expected content
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * within the <code>RequestedService</code> object.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * <complexType>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * <complexContent>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * <restriction base="{http://www.w3.org/2001/XMLSchema}anyType">
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * <sequence>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * <element ref="{urn:liberty:disco:2003-08}ServiceType"/>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * <element ref="{urn:liberty:disco:2003-08}Options" minOccurs="0"/>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * * </sequence>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * </restriction>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * </complexContent>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * </complexType>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * In this implementation, the value of Options has the following meanings:
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * When the List of options is null, no Options element will be created;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * When the List of options is an empty List, or is Collection.EMPTY_LIST,
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * empty Options element <Options></Options> will be created;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * When the List of options is not empty,
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * Options element with child Option element(s) will be created.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @supported.all.api
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * Constructor.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @param options List of String, each is a URI specifying an option the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * returned resource offering should support.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @param serviceType URI specifying the type of service to be returned
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster public RequestedService (java.util.List options,
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * Constructor.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @param elem <code>RequestedService</code> DOM element
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @exception DiscoveryException if error occurs
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster public RequestedService(Element elem) throws DiscoveryException {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster DiscoUtils.debug.message("RequestedService(Element): null input.");
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster if (((nodeName = elem.getLocalName()) == null) ||
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster ((nameSpaceURI = elem.getNamespaceURI()) == null) ||
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster (!nameSpaceURI.equals(DiscoConstants.DISCO_NS)))
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster DiscoUtils.debug.message("RequestedService(Element): wrong input");
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster for (int i = 0, length = contentnl.getLength(); i < length; i++) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster if ((nodeName = child.getLocalName()) != null) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster nameSpaceURI = ((Element) child).getNamespaceURI();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster (!nameSpaceURI.equals(DiscoConstants.DISCO_NS)))
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster DiscoUtils.debug.message("RequestedService(Element): "
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster DiscoUtils.debug.message("RequestedService(Element)"
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster + ": Included more than one ServiceType "
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster + "element.");
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster serviceType = XMLUtils.getElementValue((Element)child);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster if ((serviceType == null) || (serviceType.length() == 0)) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster DiscoUtils.debug.message("RequestedService(Element)"
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster + ": missing ServiceType element value.");
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster DiscoUtils.debug.message("RequestedService(Element)"
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster + ": Included more than one Options element.");
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster options = DiscoUtils.parseOptions((Element) child);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster DiscoUtils.debug.message("RequestedService(Element): "
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster DiscoUtils.debug.message("RequestedService(Element): missing "
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster + "ServiceType element.");
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster DiscoUtils.bundle.getString("missingServiceType"));
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * Gets list of options.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @return List of options
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @see #setOptions(List)
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * Sets options.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @param options List of option to be set
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @see #getOptions()
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * Gets service type.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @return service type String
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @see #setServiceType(String)
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * Sets service type.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @param serviceType String
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @see #getServiceType()
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster public void setServiceType(String serviceType) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * Returns string format of object <code>RequestedServiceType</code>.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * @return formatted string.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster append(DiscoConstants.DISCO_NS).append("\"><ServiceType>");
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster if ((option != null) && option.length() != 0) {